Living life and Make it Better

life, learn, contribute

Endy Muhardin

Software Developer berdomisili di Jabodetabek, berkutat di lingkungan open source, terutama Java dan Linux.

Apache Maven

Membuat kandang ayam berbeda dengan membuat rumah. Demikian pula membuat rumah berbeda dengan membangun mall. Jumlah pekerja yang terlibat jauh berbeda. Keragaman bahan baku dan peralatannya tidak sama. Kita cuma membutuhkan beberapa papan kayu, paku, dan palu dalam membuat kandang ayam. Tapi tentunya kita tidak bisa menggunakan bahan, alat, dan cara kerja yang sama dalam pembangunan gedung.

Hal yang sama berlaku di pembuatan software. Untuk tugas kuliah, cukup install Netbeans atau Eclipse, kita bisa kerjakan aplikasi sampai selesai. Akan tetapi, untuk membangun aplikasi besar, dibutuhkan persenjataan yang lebih lengkap, diantaranya:

  • version control
  • build tools
  • automated testing
  • continuous integration
  • issue tracker
  • dan lain sebagainya

Dalam artikel ini, kita akan membahas tentang apa itu build tools, mengapa kita gunakan, dan bagaimana cara menggunakannya.

Pada dasarnya, build tools adalah aplikasi untuk melakukan proses build. Salah satu langkah dalam proses build yang paling kita kenal adalah kompilasi source code. Akan tetapi, bahasa pemrograman jaman sekarang tidak cukup hanya dicompile. Kita membutuhkan fitur lain, diantaranya:

  • Dependency Management : menyediakan library, framework, tools yang dibuat orang lain
  • Compile : mengugbah source code menjadi executable
  • Test : menjaankan test secara otomatis
  • Run : menjalankan aplikasi
  • Package : membuat paket instalasi aplikasi

Konsep build tools ini tidak hanya ada di dunia Java saja. Berikut beberapa aplikasi build tools di berbagai bahasa pemrograman

  • Java

    • Ant + Ivy
    • Maven
    • Gradle
  • Ruby

    • Rake
  • JavaScript

    • Grunt

Mengapa menggunakan Maven

Bila kita bekerja dalam tim, ada banyak hal yang harus kita seragamkan supaya masing-masing orang bisa bekerja dengan baik. Diantaranya adalah:

  • struktur folder : Di mana meletakkan source code Java, HTML, CSS, JavaScript. Di mana meletakkan image icon dan logo.
  • penggunaan library : Di mana jar disimpan, bagaimana cara mengenalinya dari kode program kita, bagaimana bila upgrade versi
  • workflow : bagaimana menjalankan tes, bagaimana menginisialisasi database

Semua keseragaman di atas harus kita tentukan dan berlakukan di semua project. Bila semua project seragam, maka programmer tidak akan kesulitan pada saat ditugaskan di project manapun, karena bentuk dan aturannya sama. Demikian juga bila sebagai programmer, kita berpindah kantor. Selama kantor baru juga menggunakan aturan yang sama, kita akan bisa cepat beradaptasi.

Dengan Maven, kita tidak perlu lagi membuat aturan kita sendiri. Kita cukup mempelajari dan mengikuti aturan yang sudah dia tetapkan. Selama kita mengikuti aturan Maven, apapun jenis aplikasi yang kita buat (desktop, web, mobile), strukturnya sama.

Maven merupakan tools yang populer dan banyak penggunanya. Dengan demikian, dia didukung oleh semua editor yang beredar di pasaran seperti Netbeans, Eclipse, IDEA, dan lainnya. Didukung di sini artinya mereka bisa mengenali struktur folder dan aturan-aturan dalam Maven.

Ada beberapa aturan dalam Maven yang perlu kita ketahui:

  • konfigurasi project
  • struktur folder
  • cara menjalankan

Konfigurasi Project

Konfigurasi project dalam Maven ditulis dalam file pom.xml.

Isi pom.xml

Isi pom.xml:

  • Identifier project

    • groupId : nama organisasi / perusahaan pembuat
    • artifactId : nama modul / project
    • version : versi project
  • Contoh identifier library mysql

    • groupId : mysql
    • artifactId : mysql-connector-java
    • version : 5.1.25
  • Dependensi project. Pilihan scope dependency:

    • compile : digunakan (diimport) dalam main source dan akan di-include dalam produk akhir. Ini adalah pilihan default, kalau scope dikosongkan, artinya compile
    • runtime : tidak digunakan dalam source code (tidak diimport), tapi disertakan dalam produk akhir. Contoh: library MySQL.
    • test : digunakan (diimport) dalam test source, tapi tidak digunakan di main source. Tidak diinclude dalam produk akhir. Contoh: library JUnit.
    • provided : digunakan (diimport) dalam main source, tapi tidak disertakan dalam produk akhir. Biasanya karena sudah disediakan oleh container tempat aplikasi dijalankan. Contoh: library javax.servlet.

Untuk memulai, kita bisa copy paste pom.xml minimalis berikut

<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/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.muhardin.endy.belajar</groupId>
  <artifactId>belajar-maven</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>jar</packaging>

  <properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>

</project>

Jangan lupa mengganti:

  • groupId
  • artifactId

sesuai dengan project kita.

Untuk Java 9 ke atas, maka setting maven.compiler.source dan maven.compiler.target seperti ini

<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/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.muhardin.endy.belajar</groupId>
  <artifactId>belajar-maven</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>jar</packaging>

  <properties>
    <maven.compiler.source>11</maven.compiler.source>
    <maven.compiler.target>11</maven.compiler.target>
  </properties>

</project>

Struktur Folder Project Maven

Struktur Folder Maven

  • src/main/java : Tempat meletakkan source code java
  • src/main/resources : Tempat meletakkan file konfigurasi, icon image, dan lain-lain
  • src/main/webapp : Khusus aplikasi web, untuk meletakkan file html, img, js, css, dsb
  • target : file dan folder hasil compile. Folder target ini jangan di-commit ke Git repo.

Menggunakan Maven

Instalasi

  • Unduh versi terbaru di http://maven.apache.org
  • Extract. Untuk Linux biasanya saya taruh di /opt. Untuk Windows, saya letakkan di Program Files
  • Set M2_HOME dan PATH, caranya bisa dibaca di sini

Cara Pakai Maven

  • Membuat project baru
mvn archetype:generate -DgroupId=belajar -DartifactId=belajar-maven -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
  • Menambahkan dependensi. Tambahkan blok dependensi di pom.xml dalam tag <dependencies>
<dependency>
  <groupId>junit</groupId>
  <artifactId>junit</artifactId>
  <version>4.9</version>
  <scope>test</scope>
</dependency>
  • Dependensi akan diunduh dari internet (repo.maven.org) dan diletakkan di folder .m2 dalam home user.

  • Compile. Jalankan mvn clean install

[INFO] Scanning for projects...
[INFO]                                                                         
[INFO] ------------------------------------------------------------------------
[INFO] Building belajar-maven 1.0.0
[INFO] ------------------------------------------------------------------------
[INFO] 
[INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ belajar-maven ---
[INFO] Deleting /home/endy/tmp/belajar-maven/target
[INFO] 
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ belajar-maven ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] skip non existing resourceDirectory /home/endy/tmp/belajar-maven/src/main/resources
[INFO] 
[INFO] --- maven-compiler-plugin:2.5.1:compile (default-compile) @ belajar-maven ---
[INFO] Compiling 1 source file to /home/endy/tmp/belajar-maven/target/classes
[INFO] 
[INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ belajar-maven ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] skip non existing resourceDirectory /home/endy/tmp/belajar-maven/src/test/resources
[INFO] 
[INFO] --- maven-compiler-plugin:2.5.1:testCompile (default-testCompile) @ belajar-maven ---
[INFO] Compiling 1 source file to /home/endy/tmp/belajar-maven/target/test-classes
[INFO] 
[INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ belajar-maven ---
[INFO] Surefire report directory: /home/endy/tmp/belajar-maven/target/surefire-reports

-------------------------------------------------------
 T E S T S
-------------------------------------------------------
Running belajar.AppTest
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.037 sec

Results :

Tests run: 1, Failures: 0, Errors: 0, Skipped: 0

[INFO] 
[INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ belajar-maven ---
[INFO] Building jar: /home/endy/tmp/belajar-maven/target/belajar-maven-1.0.0.jar
[INFO] 
[INFO] --- maven-install-plugin:2.4:install (default-install) @ belajar-maven ---
[INFO] Installing /home/endy/tmp/belajar-maven/target/belajar-maven-1.0.0.jar to /home/endy/.m2/repository/belajar/belajar-maven/1.0.0/belajar-maven-1.0.0.jar
[INFO] Installing /home/endy/tmp/belajar-maven/pom.xml to /home/endy/.m2/repository/belajar/belajar-maven/1.0.0/belajar-maven-1.0.0.pom
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 2.501s
[INFO] Finished at: Fri Mar 07 10:40:38 WIB 2014
[INFO] Final Memory: 14M/150M
[INFO] ------------------------------------------------------------------------
  • Run. Jalankan mvn exec:java -Dexec.mainClass=belajar.App
[INFO] Scanning for projects...
[INFO]                                                                         
[INFO] ------------------------------------------------------------------------
[INFO] Building belajar-maven 1.0.0
[INFO] ------------------------------------------------------------------------
[INFO] 
[INFO] >>> exec-maven-plugin:1.2.1:java (default-cli) @ belajar-maven >>>
[INFO] 
[INFO] <<< exec-maven-plugin:1.2.1:java (default-cli) @ belajar-maven <<<
[INFO] 
[INFO] --- exec-maven-plugin:1.2.1:java (default-cli) @ belajar-maven ---
Hello World!
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 0.917s
[INFO] Finished at: Fri Mar 07 10:39:50 WIB 2014
[INFO] Final Memory: 8M/150M
[INFO] ------------------------------------------------------------------------

Konfigurasi Tambahan

Adakalanya kita membutuhkan setting tambahan untuk menyesuaikan penggunaan Maven, misalnya bila kita ada di belakang proxy ataupun ingin memindahkan lokasi download ke tempat lain. Untuk melakukan konfigurasi, buat file settings.xml di dalam folder .m2.

Proxy

Berikut isi filenya bila kita menjalankan Maven di belakang proxy.

<settings>
  <proxies>
    <proxy>
      <protocol>http</protocol>
      <host>proxy.host.net</host>
      <port>80</port>
      <nonProxyHosts>local.net|some.host.com</nonProxyHosts>
      <username>proxyuser</username>
      <password>proxypass</password>
    </proxy>
  </proxies>
</settings>

Lokasi Download Folder

Setting ini saya gunakan karena komputer saya menggunakan harddisk SSD yang berkapasitas kecil, sehingga lokasi downloadnya perlu dipindah ke external harddisk.

<settings>
    <localRepository>/Volumes/SDUF128G/m2/repository</localRepository>
</settings>

Penutup

Demikianlah sekilas penggunaan Maven. Untuk lebih lengkapnya, kita bisa baca buku referensi Maven yang sudah disediakan gratis oleh Sonatype. Anda juga bisa tonton video Youtube saya yang membahas lebih lanjut tentang Apache Maven ini