Cah Ndalem: Web Project Menggunakan Maven

Tool yang digunakan

Beberapa tool yang diperlukan untuk mengikuti tutorial ini :
1. Maven 3.0.5
2. JDK 1.6
3. Netbeans 7.3

Membuat Web Project

Buka terminal (linux) atau command prompt (windows) dan arahkan ke folder tempat Anda ingin menyimpan folder project Maven. Kalau saya , saya letakkan pada folder “Netbeans Project” yang khusus berisi project-project Java, biar tidak tercecer. Setelah itu ketikkan perintah berikut dalam satu baris

mvn archetype:generate -DgroupId={nama-package} -DartifactId={nama-project}
-DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false

Perintah di atas akan men-generate sebuah Java Project menggunakan template “maven-archetype-webapp“. Ada banyak pilihan template, silahkan hilangkan parameter “archetypeArtifactId” untuk melihat sodoran bermacan-macam template yang ada.
Contoh :

C:\….\NetBeansProjects>mvn archetype:generate
-DgroupId=com.agungsetiawan -DartifactId=belajar-maven-webapp
-DarchetypeArtifactId=maven-archetype-webapp
-DinteractiveMode=false
[INFO] Scanning for projects…
[INFO]
[INFO] ————————————————————————
[INFO] Building Maven Stub Project (No POM) 1
[INFO] ————————————————————————
[INFO]
[INFO] >>> maven-archetype-plugin:2.2:generate (default-cli) @ standalone-pom >>>
[INFO]
[INFO] <<< maven-archetype-plugin:2.2:generate (default-cli) @ standalone-pom <<< [INFO] [INFO] --- maven-archetype-plugin:2.2:generate (default-cli) @ standalone-pom --- [INFO] Generating project in Batch mode [INFO] ---------------------------------------------------------------------------- [INFO] Using following parameters for creating project from Old (1.x) Archetype: maven-archetyp e-webapp:1.0 [INFO] ---------------------------------------------------------------------------- [INFO] Parameter: groupId, Value: com.agungsetiawan [INFO] Parameter: packageName, Value: com.agungsetiawan [INFO] Parameter: package, Value: com.agungsetiawan [INFO] Parameter: artifactId, Value: belajar-maven-webapp [INFO] Parameter: basedir, Value: C:\Users\blinkawan\Documents\NetBeansProjects [INFO] Parameter: version, Value: 1.0-SNAPSHOT [INFO] project created from Old (1.x) Archetype in dir: C:\Users\blinkawan\Documents\NetBeansPr ojects\belajar-maven-webapp [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 20.750s [INFO] Finished at: Fri Jan 24 18:08:34 ICT 2014 [INFO] Final Memory: 7M/24M [INFO] ------------------------------------------------------------------------

Dari perintah di atas maka nama project adalah “belajar-maven-webapp” sedangkan package-nya adalah “com.agungsetiawan“. Perintah tadi otomatis men-generate beberapa folder dan file yang bisa dilihat pada bagian selanjutnya.

Struktur Folder Web Maven

Maven memiliki struktur folder sendiri yang bersifat standar, artinya ya harus seperti itu susunannya. Berikut merupakan struktur project web Maven yang baru saja di-generate.

Selain men-generate folder dan file jsp, Maven juga membuat sebuah file “pom.xml” yang berisi informasi project serta plugin dan dependency yang digunakan.
file : belajar-maven-webapp/pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelversion>4.0.0</modelVersion>
  <groupid>com.agungsetiawan</groupId>
  <artifactid>belajar-maven-webapp</artifactId>
  <packaging>war</packaging>
  <version>1.0-SNAPSHOT</version>
  <name>belajar-maven-webapp Maven Webapp</name>
  <url>http://maven.apache.org</url>
  
  <dependencies>
    <dependency>
      <groupid>junit</groupId>
      <artifactid>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
  <build>
    <finalname>belajar-maven-webapp</finalName>
  </build>
</project>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

<groupId>com.agungsetiawan</groupId>

<artifactId>belajar-maven-webapp</artifactId>

<version>1.0-SNAPSHOT</version>

<name>belajar-maven-webapp Maven Webapp</name>

<url>http://maven.apache.org</url>

<groupId>junit</groupId>

<artifactId>junit</artifactId>

</dependency>

</dependencies>

<build>

<finalName>belajar-maven-webapp</finalName>

</build>

</project>

File pom.xml di atas masih sangat minimalis. Nanti kita ubah.
file : src/main/webapp/WEB-INF/web.xml
File “web.xml” juga di-generate

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >

<web-app>
  <display-name>Archetype Created Web Application</display-name>
</web-app>

<!DOCTYPE web-app PUBLIC

"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"

"http://java.sun.com/dtd/web-app_2_3.dtd" >

<web-app>

<display-name>Archetype Created Web Application</display-name>

</web-app>

File diatas masih mendeklarasikan penggunaan Servlet 2.3. Nanti kita ubah menjadi Servlet 3
file : src/main/webapp/index.jsp
File “index.jsp” hasil generate

<html>
<body>
<h2>
Hello World!</h2>
</body>
</html>

<html>

<body>

<h2>Hello World!</h2>

</body>

</html>

Bekerja dengan Netbeans

Ngoding menjadi jauh lebih mudah dengan bantuan IDE daripada sekadar menggunakan text editor. Project Java Web yang tadi dibuat menggunakan Maven perlu dibuka pada IDE untuk bisa dikerjakan. Dalam kasus ini saya menggunakan Netbeans (Eclipse tidak terlalu jauh caranya). Netbeans memiliki dukungan yang sangat baik terhadap Maven. Untuk membuka project Maven pada Netbeans langsung saja “File->Open Project” dan arahkan ke tempat Anda menaruh folder project Maven.

Update POM

Ada 4 perubahan yang dilakukan pada file pom xml yang kita miliki, yaitu
1. Menambahkan plugin compiler
2. Menambahkan plugin Jetty
3. Mengubah versi JUnit
4. Menambah dependency Servlet file : belajar-maven-webapp/pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelversion>4.0.0</modelVersion>
  <groupid>com.agungsetiawan</groupId>
  <artifactid>belajar-maven-webapp</artifactId>
  <packaging>war</packaging>
  <version>1.0-SNAPSHOT</version>
  <name>belajar-maven-webapp Maven Webapp</name>
  <url>http://maven.apache.org</url>
  
  <build>
      <finalname>belajar-maven-webapp</finalName>
      <plugins>
          <plugin>
              <groupid>org.apache.maven.plugins</groupId>
              <artifactid>maven-compiler-plugin</artifactId>
              <version>3.1</version>
              <configuration>
                  <source>1.6</source>
                  <target>1.6</target>
              </configuration>
          </plugin>
          <plugin>
                <groupid>org.mortbay.jetty</groupId>
                <artifactid>jetty-maven-plugin</artifactId>
                <version>8.1.5.v20120716</version>
           </plugin>
      </plugins>
  </build>
  
  <dependencies>
    <dependency>
      <groupid>junit</groupId>
      <artifactid>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
    <dependency>
        <groupid>javax.servlet</groupId>
        <artifactid>javax.servlet-api</artifactId>
        <version>3.1.0</version>
    </dependency>
  </dependencies>
    <properties></properties>
</project>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

<groupId>com.agungsetiawan</groupId>

<artifactId>belajar-maven-webapp</artifactId>

<version>1.0-SNAPSHOT</version>

<name>belajar-maven-webapp Maven Webapp</name>

<url>http://maven.apache.org</url>

<build>

<finalName>belajar-maven-webapp</finalName>

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-compiler-plugin</artifactId>

</configuration>

</plugin>

<groupId>org.mortbay.jetty</groupId>

<artifactId>jetty-maven-plugin</artifactId>

</plugin>

</plugins>

</build>

<groupId>junit</groupId>

<artifactId>junit</artifactId>

</dependency>

<groupId>javax.servlet</groupId>

<artifactId>javax.servlet-api</artifactId>

</dependency>

</dependencies>

</project>

Mungkin ada yang bertanya apa gunanya Jetty? Silahkan baca artikel yang pernah saya tulis di sini

Servlet

Servlet adalah komponen dasar yang wajib dipahami jika ingin menguasai teknologi enterprise di Java. Servlet, secara ringkas berfungsi menangani request dari user untuk kemudian dikembalikan sebagai response. Mengenai servlet silahkan baca tulisan dari Pak Endy di sini Sebelumnya buat terlebih dahulu folder “java” di dalam folder “main“. Setelah itu melalui Netbeans buat sebuah package “com.agungsetiawan.servlet” dan buat sebuah kelas servlet dengan nama “HomeServlet“.
file : src/main/java/com/agungsetiawan/servlet/HomeServlet.java

package com.agungsetiawan.servlet;

import java.io.IOException;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
 *
 * @author blinkawan
 */
public class HomeServlet extends HttpServlet{
    
    @Override
    public void doGet(HttpServletRequest request,
    HttpServletResponse response) throws ServletException, IOException{
        
          request.getRequestDispatcher("/WEB-INF/index.jsp").forward(request, response);

    }
}

package com.agungsetiawan.servlet;

import java.io.IOException;

import javax.servlet.ServletException;

import javax.servlet.http.HttpServlet;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

/**

* @author blinkawan

public class HomeServlet extends HttpServlet{

@Override

public void doGet(HttpServletRequest request,

HttpServletResponse response) throws ServletException, IOException{

request.getRequestDispatcher("/WEB-INF/index.jsp").forward(request, response);

}

Supaya servlet di atas bisa dikenali saat pengguna mengakses suatu url maka perlu dibuatkan konfigurasinya pada “web.xml“. Ubah menjadi seperti di bawah. Perhatikan bahwa versi servlet yang digunakan sudah bukan lagi 2.5 tetapi 3.
file : src/main/webapp/WEB-INF/web.xml

<web-app xmlns="http://java.sun.com/xml/ns/javaee"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
        http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
        version="3.0">
    
  <display-name>Archetype Created Web Application</display-name>
  
  <servlet>
      <servlet-name>HomeServlet</servlet-name>
      <servlet-class>com.agungsetiawan.servlet.HomeServlet</servlet-class>
  </servlet>
  
  <servlet-mapping>
      <servlet-name>HomeServlet</servlet-name>
      <url-pattern>/index.php</url-pattern>
      <url-pattern>/default.aspx</url-pattern>
      <url-pattern>/index</url-pattern>
  </servlet-mapping>

</web-app>

<web-app xmlns="http://java.sun.com/xml/ns/javaee"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://java.sun.com/xml/ns/javaee

http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"

version="3.0">

<display-name>Archetype Created Web Application</display-name>

<servlet-name>HomeServlet</servlet-name>

<servlet-class>com.agungsetiawan.servlet.HomeServlet</servlet-class>

</servlet>

<servlet-mapping>

<servlet-name>HomeServlet</servlet-name>

<url-pattern>/index.php</url-pattern>

<url-pattern>/default.aspx</url-pattern>

<url-pattern>/index</url-pattern>

</servlet-mapping>

</web-app>

Satu lagi, ubah file “index.jsp” menjadi seperti di bawah.
file : src/main/webapp/WEB-INF/index.jsp

<html>
  <head>
      <title>Halo</title>
  </head>

  <body>
    <h3>
Halo!</h3>
<hr/>
    Belajar Maven untuk Web Application
  </body>
</html>

<html>

<head>

</head>

<body>

Belajar Maven untuk Web Application

</body>

</html>

Hampir ketinggalan. Pindah file “index.jsp” ke dalam folder “WEB-INF”

Maven Packaging

Selanjutnya kita akan membuat project java menjadi sebuah file war menggunakan Maven. Perhatikan pada file pom.xml bahwa di sana terdapat setingan untuk mengatur format packaging yang diinginkan. file : belajar-maven-webapp/pom.xml

<modelversion>4.0.0</modelVersion>
 <groupid>com.agungsetiawan</groupId>
 <artifactid>belajar-maven-webapp</artifactId>
 <packaging>war</packaging>
 <version>1.0-SNAPSHOT</version>
 <name>belajar-maven-webapp Maven Webapp</name>
 <url>http://maven.apache.org</url>

<groupId>com.agungsetiawan</groupId>

<artifactId>belajar-maven-webapp</artifactId>

<version>1.0-SNAPSHOT</version>

<name>belajar-maven-webapp Maven Webapp</name>

<url>http://maven.apache.org</url>

Pada terminal ketikkan perintah

mvn package

Pastikan saat mengetik perintah di atas pembaca berada pada root folder project yang bersangkutan.
Perintah di atas melakukan proses compile, menjalankan unit test serta membuat file war dari project. Cek pada folder project maka sekarang didalamnya terdapat folder “target” yang berisi file war project.

Demo

Untuk menjalankan project web dengan menggunakan Jetty, tulis perintah berikut

mvn clean install jetty:run

Kemudian akses url pada browser menggunakan salah satu dari berikut
localhost:8080/index
localhost:8080index.php
localhost:8080/default.aspx

Cah Ndalem

Laman

Minggu, 28 Februari 2016

Web Project Menggunakan Maven

Tool yang digunakan

Membuat Web Project

Struktur Folder Web Maven

Bekerja dengan Netbeans

Update POM

Servlet

Maven Packaging

Demo

Tidak ada komentar:

Posting Komentar

Popular Posts

Mengenai Saya

Arsip Blog