Membuat Java Project Maven
[T]ulisan ini meneruskan tulisan yang sudah lama sekali saya tulis
di sini mengenai sebuah tools yang bernama Maven. Pada blog post ini pembaca akan belajar bagaimana membuat sebuah Java Project menggunakan Maven kemudian membukanya pada Netbeans dan mem-package-nya menjadi sebuah jar.
Tool yang Digunakan
Tool yang saya gunakan adalah sebagai berikut:
1. Maven 3.0.5
2. JDK 1.6
3. Netbeans IDE 7.3
Tentu pembaca bisa menyesuaikannya, beda versi gak masalah.
Membuat Java 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-quickstart -DinteractiveMode=false
Perintah di atas akan men-generate sebuah Java Project menggunakan template “maven-archetype-quickstart“. Ada banyak pilihan template, silahkan hilangkan parameter “archetypeArtifactId” untuk melihat sodoran bermacan-macam template yang ada.
Contoh :
C:\Users\blinkawan\Documents\NetBeansProjects>mvn archetype:generate
-DgroupId=com.agungsetiawan
-DartifactId=belajar-maven
-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] No archetype defined. Using maven-archetype-quickstart (org.apache.maven.archetypes:mave n-archetype-quickstart:1.0) [INFO] ---------------------------------------------------------------------------- [INFO] Using following parameters for creating project from Old (1.x) Archetype: maven-archetyp e-quickstart: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 [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 [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 13.968s [INFO] Finished at: Thu Jan 23 22:04:32 ICT 2014 [INFO] Final Memory: 7M/25M [INFO] ------------------------------------------------------------------------
Dari perintah di atas maka nama project adalah “belajar-maven” sedangkan package-nya adalah “com.agungsetiawan“. Perintah tadi otomatis men-generate beberapa folder dan file yang bisa dilihat pada bagian selanjutnya.
Struktur Folder Maven
Maven memiliki struktur folder sendiri yang bersifat standar, artinya ya harus seperti itu susunannya. Berikut merupakan struktur project Maven yang baru saja di-generate.
belajar-maven
|-src
|—main
|—–java
|——-com
|———agungsetiawan
|———–App.java
|—test
|—–java
|——-com
|———agungsetiawan
|———–AppTest.java
|-pom.xml
File source code diletakkan pada
src/main/java/com/agungsetiawan sedangkan
src/test/java/com/agungsetiawan digunakan untuk meletakkan kode unit test. Lebih lengkap mengenai stuktur folder silahkan baca
di sini.
Selain men-generate folder dan file java, Maven juga membuat sebuah file “pom.xml” yang berisi informasi project serta plugin dan dependency yang digunakan.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
<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</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>
<name>belajar-maven</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>
</project>
|
File pom.xml di atas masih sangat minimalis. Nanti kita tambahkan sesuatu padanya.
Bekerja dengan Netbeans
Ngoding menjadi jauh lebih mudah dengan bantuan IDE daripada sekadar menggunakan text editor. Project Java 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
File pom.xml yang di-generate masih sangat sederhana. Kita perlu menambahkan satu plugin compiler untuk membuat Maven mengerti JDK versi berapa yang digunakan sebagai compiler.
|
|
<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>
|
Selain itu, versi JUnit yang default adalah 3.8.1. Ubah menjadi versi terbaru saat ini yaitu 4.11
|
|
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</scope>
</dependency>
|
Kode Xml di atas disebut “Maven Coordinate“. Misal kita ingin menambahkan jar library MySql Connector pada project yang sedang kita kerjakan, maka kita harus menambahkan Maven Coordinate yang sesuai pada pom.xml bukan dengan menambahkan file jar langsung ke dalam folder project seperti pada project yang dibuat menggunakan Netbeans.
Terus bagaimana cara mengetahui Maven Coordinate dari tiap library?. Gunakan
mvnrepository.com/
File pom.xml lengkap setelah diubah menjadi seperti ini
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
|
<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</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>
<name>belajar-maven</name>
<url>http://maven.apache.org</url>
<build>
<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>
</plugins>
</build>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</scope>
</dependency>
</dependencies>
</project>
|
Update Kode Java
Kode java dan unit test yang di-generate pun sangat sederhana. Mari kita ubah.
Ubah kode Java menjadi seperti ini
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
package com.agungsetiawan;
public class App{
public static void main( String[] args ){
App app=new App();
String input="Selamat Belajar Maven";
System.out.println("Panjang dari "+input+" adalah "+app.stringLength(input));
}
public int stringLength(String input){
return input.length();
}
}
|
Dan kode unit test menjadi seperti ini
1
2
3
4
5
6
7
8
9
10
11
12
13
|
package com.agungsetiawan;
import org.junit.Assert;
import org.junit.Test;
public class AppTest{
@Test
public void testLengthOfCharacter(){
App app=new App();
Assert.assertEquals(5, app.stringLength("Agung"));
}
}
|
Jika ingin mengeksekusi kode unit test ketik perintah berikut pada root folder project
mvn test
Maven Packaging
Selanjutnya kita akan membuat project java menjadi sebuah file jar menggunakan Maven. Perhatikan pada file pom.xml bahwa di sana terdapat setingan untuk mengatur format packaging yang diinginkan.
|
|
<modelVersion>4.0.0</modelVersion>
<groupId>com.agungsetiawan</groupId>
<artifactId>belajar-maven</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>
<name>belajar-maven</name>
<url>http://maven.apache.org</url>
|
Pada terminal ketikkan perintah
mvn package
Perintah di atas melakukan proses compile, menjalankan unit test serta membuat file jar dari project. Cek pada folder project maka sekarang didalamnya terdapat folder “target” yang berisi file jar project.
[T]ulisan ini meneruskan tulisan yang sudah lama sekali saya tulis
di sini mengenai sebuah tools yang bernama Maven. Pada blog post ini pembaca akan belajar bagaimana membuat sebuah Java Project menggunakan Maven kemudian membukanya pada Netbeans dan mem-package-nya menjadi sebuah jar.
Tool yang Digunakan
Tool yang saya gunakan adalah sebagai berikut:1. Maven 3.0.52. JDK 1.63. Netbeans IDE 7.3
Tentu pembaca bisa menyesuaikannya, beda versi gak masalah.
Membuat Java 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-quickstart -DinteractiveMode=false
Perintah di atas akan men-generate sebuah Java Project menggunakan template “maven-archetype-quickstart“. Ada banyak pilihan template, silahkan hilangkan parameter “archetypeArtifactId” untuk melihat sodoran bermacan-macam template yang ada.
Contoh :
C:\Users\blinkawan\Documents\NetBeansProjects>mvn archetype:generate
-DgroupId=com.agungsetiawan
-DartifactId=belajar-maven
-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] No archetype defined. Using maven-archetype-quickstart (org.apache.maven.archetypes:mave n-archetype-quickstart:1.0) [INFO] ---------------------------------------------------------------------------- [INFO] Using following parameters for creating project from Old (1.x) Archetype: maven-archetyp e-quickstart: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 [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 [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 13.968s [INFO] Finished at: Thu Jan 23 22:04:32 ICT 2014 [INFO] Final Memory: 7M/25M [INFO] ------------------------------------------------------------------------
Dari perintah di atas maka nama project adalah “belajar-maven” sedangkan package-nya adalah “com.agungsetiawan“. Perintah tadi otomatis men-generate beberapa folder dan file yang bisa dilihat pada bagian selanjutnya.
Struktur Folder Maven
Maven memiliki struktur folder sendiri yang bersifat standar, artinya ya harus seperti itu susunannya. Berikut merupakan struktur project Maven yang baru saja di-generate.
belajar-maven
|-src
|—main
|—–java
|——-com
|———agungsetiawan
|———–App.java
|—test
|—–java
|——-com
|———agungsetiawan
|———–AppTest.java
|-pom.xml
File source code diletakkan pada
src/main/java/com/agungsetiawan sedangkan
src/test/java/com/agungsetiawan digunakan untuk meletakkan kode unit test. Lebih lengkap mengenai stuktur folder silahkan baca
di sini.
Selain men-generate folder dan file java, Maven juga membuat sebuah file “pom.xml” yang berisi informasi project serta plugin dan dependency yang digunakan.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
<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</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>
<name>belajar-maven</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>
</project>
|
File pom.xml di atas masih sangat minimalis. Nanti kita tambahkan sesuatu padanya.
Bekerja dengan Netbeans
Ngoding menjadi jauh lebih mudah dengan bantuan IDE daripada sekadar menggunakan text editor. Project Java 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
File pom.xml yang di-generate masih sangat sederhana. Kita perlu menambahkan satu plugin compiler untuk membuat Maven mengerti JDK versi berapa yang digunakan sebagai compiler.
|
|
<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>
|
Selain itu, versi JUnit yang default adalah 3.8.1. Ubah menjadi versi terbaru saat ini yaitu 4.11
|
|
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</scope>
</dependency>
|
Kode Xml di atas disebut “Maven Coordinate“. Misal kita ingin menambahkan jar library MySql Connector pada project yang sedang kita kerjakan, maka kita harus menambahkan Maven Coordinate yang sesuai pada pom.xml bukan dengan menambahkan file jar langsung ke dalam folder project seperti pada project yang dibuat menggunakan Netbeans.
Terus bagaimana cara mengetahui Maven Coordinate dari tiap library?. Gunakan
mvnrepository.com/
File pom.xml lengkap setelah diubah menjadi seperti ini
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
|
<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</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>
<name>belajar-maven</name>
<url>http://maven.apache.org</url>
<build>
<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>
</plugins>
</build>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</scope>
</dependency>
</dependencies>
</project>
|
Update Kode Java
Kode java dan unit test yang di-generate pun sangat sederhana. Mari kita ubah.
Ubah kode Java menjadi seperti ini
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
package com.agungsetiawan;
public class App{
public static void main( String[] args ){
App app=new App();
String input="Selamat Belajar Maven";
System.out.println("Panjang dari "+input+" adalah "+app.stringLength(input));
}
public int stringLength(String input){
return input.length();
}
}
|
Dan kode unit test menjadi seperti ini
1
2
3
4
5
6
7
8
9
10
11
12
13
|
package com.agungsetiawan;
import org.junit.Assert;
import org.junit.Test;
public class AppTest{
@Test
public void testLengthOfCharacter(){
App app=new App();
Assert.assertEquals(5, app.stringLength("Agung"));
}
}
|
Jika ingin mengeksekusi kode unit test ketik perintah berikut pada root folder project
mvn test
Maven Packaging
Selanjutnya kita akan membuat project java menjadi sebuah file jar menggunakan Maven. Perhatikan pada file pom.xml bahwa di sana terdapat setingan untuk mengatur format packaging yang diinginkan.
|
|
<modelVersion>4.0.0</modelVersion>
<groupId>com.agungsetiawan</groupId>
<artifactId>belajar-maven</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>
<name>belajar-maven</name>
<url>http://maven.apache.org</url>
|
Pada terminal ketikkan perintah
mvn package
Perintah di atas melakukan proses compile, menjalankan unit test serta membuat file jar dari project. Cek pada folder project maka sekarang didalamnya terdapat folder “target” yang berisi file jar project.
