Tutorial Cara Instal Glassfish, Jersey, Eclipse WTP Untuk Membuat Web API

Nampaknya, saya mesti kembali ke lingkungan J2EE sementara ini. Mungkin untuk menengok-nengok barang sebentar. Terakhir kali saya lewat lingkungan J2EE, saya masih bingung dengan Spring dan Struts 2. Kali ini saya datang kembali dengan niat yang berbeda. Kali ini saya mencoba membangun Web API server dengan J2EE, sesuai request dari boss. Sebenarnya saya sudah mengembangkan Web API dengan CodeIgniter untuk kebutuhan pribadi, dan selama ini masih berjalan dengan baik. Tetapi untuk kebutuhan kantor, boss menyarankan menggunakan Java supaya servernya bisa scallable. Saya masih awam dengan konsep ini, tapi kita coba dulu lah.
Berdasarkan beberapa sumber, untuk mengembangkan Web API dengan Java, ada beberapa pilihan framework seperti RESTlet, Grails atau Jersey. Setelah ditimbang-timbang, saya putuskan untuk mencoba dulu menggunakan Jersey, karena RESTlet dibilang bloated (padahal seharusnya lightweight) dan Grails dibilang buggy (tapi ada yg berpendapat bahwa layer yang dibawahnya yang buggy).

1. Installasi Application Server GlassFish

  1. Download GlassFish server 3.1.1 dari http://download.java.net/glassfish/3.1.1/release/glassfish-3.1.1-windows.exe. Tentunya dependency-nya harus dipenuhi, yaitu JDK dan Ant (optional)
  2. Double click
  3. Installation type, pilih Typical installation
  4. Pilih install directory, saya letakkan di D:\glassfish3. Masukkan alamat proxy jika jaringan Anda menggunakan Proxy. Tanpa melakukannya, installasi UpdateTool akan gagal.
  5. Install dan enable Update Tool untuk mendapatkan informasi jika ada update untuk GlassFish
  6. Tekan tombol Allow access jika muncul Windows Security Alert, ini untuk mengijinkan Java terhubung ke jaringan Anda
  7. GlassFish akan di install dan di akhir installasi, installer akan menyalakan server GlassFish
  8. Cek hasil installasi dengan membuka http://<ip-anda-atau-gunakan-localhost>:8080/ melalui browser
  9. Untuk mencoba Admin Console, buka browser ke alamat yang sama dengan port 4848,  http://<ip-anda-atau-gunakan-localhost>:4848/. Pertama-tama, GlassFish akan menghidupkan service ini terlebih dahulu.
  10. Sampai tahap ini, installasi sudah selesai. Saya sudah mendapatkan Jersey yang di bundle ke dalam GlassFish 3.1.

2. Konfigurasi Eclipse WTE untuk menggunakan GlassFish

Sampai di sini GlassFish dan Jersey sudah kita dapatkan. Berikutnya, kita akan mempersiapkan Eclipse WTP sebagai IDE kita. Berikut ini langkah-langkah yang dibutuhkan:
  1. Download Eclipse WTP
  2. Ekstrak
  3. Jalankan Eclipse
  4. Pilih menu Window | Preferences
  5. Dalam dialog Preferences pilih Server (di sebelah kiri) | Runtime Environments
  6. Tekan tombol Add
  7. Perhatikan bahwa Anda tidak mendapati GlassFish di dalam pilihan
  8. Klik link Download additional server adapters
  9. Pilih Oracle GlassFish Server Tools
  10. Restart jika sudah selesai
  11. Pilih menu Window | Preferences
  12. Pilih Server | Runtime Environments
  13. Tekan tombol Add, perhatikan bahwa sekarang Anda sudah mendapatkan GlassFish
  14. Pilih GlassFish Server Open Source Edition (JavaEE 6)
  15. Dalam dialog New Server Runtime Environment pilih Application Server Directory, ini adalah direktori di mana Anda menginstall GlassFish. Dalam kasus saya adalah D:/glassfish3/glassfish

3. Membuat Profile Server

Selesai. Sampai tahap ini Eclipse WTP Anda sudah terintegrasi dengan server GlassFish. Saat ini, jika Anda mulai bersama saya, maka Anda belum memiliki profile server. Berikutnya kita akan membuat profile server.
  1. Window | Show View | Servers
  2. Klik kanan, pilih New | Server
  3. Pilih GlassFish Server Open Source Edition (JavaEE 6)
  4. Masukkan server’s host name. By default ini akan menunjukkan localhost. Gunakan setting ini. Menggunakan IP address atau nama komputer akan menyebabkan error karena Anda dianggap mengakses komputer lain secara remote. Password default untuk account admin adalah adminadmin. Jika Anda mengalami error, itu kemungkinan karena Anda menggunakan Runtime JRE ketika menghubungkan Eclipse ke Server. GlassFish membutuhkan JDK. Untuk mengatasinya cukup buka Window | Preferences. Pilih Java | Installed JREs. Tambahkan direktori JDK. Masih di Preferences, pilih Server | Runtime Environments. Pilih nama server yang kita buat tadi, tekan tombol Edit. Ubah JRE menjadi JDK (yang baru kita tambahkan).
  5. Jika profile sercer sudah terbentuk, Anda bisa klik kanan kemudian pilih Start

4. Membuat Servlet Sederhana

Kita akan men-test hasil instalasi ini. Saya akan buat sebuah servlet sederhana.
  1. File | New | Other
  2. Pilih Web | Dynamic Web Project
  3. Beri nama proyek baru tersebut com.durianapp.helloservlet.
  4. Perhatikan Target Runtime-nya. Harus GlassFish Server Open Source Edition. Saya gunakan Dynamic web module version 3.0.
  5. Tekan tombol Finish
  6. Pilih project yang kita buat tadi, lalu buat package baru, File | New | Package. Beri nama com.durianapp.helloservlet.dao.
  7. Buat class Java baru di dalam package tersebut, beri nama FileDao.
    Isi class tersebut seperti berikut:
    
package com.durianapp.helloservlet.dao;
    

    


    

    
import java.io.BufferedReader;
    

    
import java.io.File;
    

    
import java.io.FileReader;
    

    
import java.io.FileWriter;
    

    
import java.io.IOException;
    

    
import java.io.PrintWriter;
    

    


    

    
public class FileDao {
    

    
 public int getCount() {
    

    
  int count = 0;
    

    


    

    
  FileReader fr = null;
    

    
  BufferedReader br = null;
    

    
  PrintWriter writer = null;
    

    


    

    
  try {
    

    
   File f = new File("FileCounter.initial");
    

    
   if (!f.exists()) {
    

    
    f.createNewFile();
    

    
    writer = new PrintWriter(new FileWriter(f));
    

    
    writer.print(0);
    

    
   }
    

    
   if (writer != null) writer.close();
    

    


    

    
   fr = new FileReader(f);
    

    
   br = new BufferedReader(fr);
    

    
   String initial = br.readLine();
    

    
   count = Integer.parseInt(initial);
    

    
  } catch (Exception e) {
    

    
   if (writer != null) writer.close();
    

    
  }
    

    


    

    
  if (br != null) {
    

    
   try {
    

    
    br.close();
    

    
   } catch (Exception e) {
    

    
   }
    

    
  }
    

    
  return count;
    

    
 }
    

    


    

    
 public void save(int count) throws IOException {
    

    
  FileWriter fw = null;
    

    
  PrintWriter pw = null;
    

    
  fw = new FileWriter("FileCounter.initial");
    

    
  pw = new PrintWriter(fw);
    

    
  pw.print(count);
    

    


    

    
  if (pw != null) pw.close();
    

    
 }
    

    
}
  8. Klik WebContent, klik kanan dan buat servlet baru File | New | Other. Pilih Web | Servlet. Gunakan package name com.durianapp.helloservlet. Berikan nama FileCounter.
    
package com.durianapp.helloservlet.servlets;
    

    


    

    
import java.io.IOException;
    

    
import java.io.PrintWriter;
    

    


    

    
import javax.servlet.ServletException;
    

    
import javax.servlet.annotation.WebServlet;
    

    
import javax.servlet.http.HttpServlet;
    

    
import javax.servlet.http.HttpServletRequest;
    

    
import javax.servlet.http.HttpServletResponse;
    

    
import javax.servlet.http.HttpSession;
    

    


    

    
import com.durianapp.helloservlet.dao.FileDao;
    

    


    

    
/**
    

    
 * Servlet implementation class FileCounter
    

    
 */
    

    
@WebServlet("/FileCounter")
    

    
public class FileCounter extends HttpServlet {
    

    
 private static final long serialVersionUID = 1L;
    

    
   
    

    
 private int count;
    

    
 private FileDao dao;
    

    


    

    
    public void init() throws ServletException {
    

    
    
    

    
        dao = new FileDao();
    

    
        try {
    

    
         count = dao.getCount();
    

    
        } catch (Exception e) {
    

    
   // TODO: handle exception
    

    
         getServletContext().log("Ada problem di FileCounter", e);
    

    
         throw new ServletException("Ada problem di FileCounter. "+e.getMessage());
    

    
  }
    

    
    }
    

    


    

    
 protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    

    
  HttpSession session = request.getSession(true);
    

    
  session.setMaxInactiveInterval(5);
    

    
  response.setContentType("text/plain");
    

    
  PrintWriter out = response.getWriter();
    

    
  if (session.isNew()) count++;
    

    
  out.println("Halaman ini sudah dibuka "+count+" kali.");
    

    
 }
    

    


    

    
 public void destroy() {
    

    
  super.destroy();
    

    
  try {
    

    
   dao.save(count);
    

    
  } catch (Exception e) {
    

    
   e.printStackTrace();
    

    
  }
    

    
 }
    

    
}
    view ra
  9. Klik kanan nama project | Run As | Run on Server. Ini akan memastikan server running emudian membuka browser di dalam Eclipse. Jika browser gagal memunculkan halaman yang diminta (misalnya karena ada proxy, Anda bisa ubah localhost menjadi IP address)
Sampai tahap ini, jika semua baik-baik saja maka server dan Eclipse kita sudah siap untuk membangun Web API.
Label: ,

Artikel Lainnya