Minggu, 03 September 2017

Tutorial RESTFul Web Service pada Java Menggunakan Java Murni

By Berbagi Ilmu • September 03, 2017 • 0 Comments

Tutorial RESTFul Web Service pada Java Menggunakan Java Murni

REST merupakan suatu arsitektural metode komunikasi yang sering diterapkan dalam pengembangan layanan berbasis web. Arsitektur ini umumnya dijalankan pada HTTP (Hypertext Transfer Protocol), melibatkan proes pembacaan laman web tertentu yang memuat sebuah file XML atau JSON.
Kekhasan REST terletak pada interaksi antara klien dan server yang difasilitasi oleh sejumlah tipe operasional (verba) dan Universal Resource Identifiers (URIs) yang unik bagi tiap-tiap sumberdaya[1]. Dalam suatu arsitektur berbasis REST kita mempunyai suatu server REST (API Provider) yang mempunyai akses ke sumber daya dan menyediakan beberapa akses terbatas ke sumber daya untuk penggunanya, dan client REST (API Customer, pengguna dari server REST ) yang meminta akses dan perubahan terhadap sumber daya REST. REST memungkinkan bahwa sumber daya mempunyai representasi berbeda seperti text, XML, JSON, dan lainnya[2].
Metode HTTP yang digunakan dalam arsitektur berbasis REST adalah sebagai berikut:
·        GET digunakan untuk mendefinisikan suatu akses pembacaan sumber daya (resource) tanpa efek samping. Sumber daya tidak pernah diubah melalui request GET, misalnya request hanya meminta detail sumber daya nomor tertentu, tidak meminta perubahan satu baris record pun di provider.
·        PUT digunakan untuk menciptakan sumber daa baru.
·        DELETE digunakan untuk menghapus sumber daya tertentu.
POST digunakan untuk mengupdate sumber daya yang telah ada atau membuat sumber daya baru.

Tutorial berikut ini akan menjelaskan cara membangun RESTFul WebService pada Java menggunakan Java Murni.  Ada 2 contoh yang akan dibahas pada tutorial berikut, yaitu contoh sederhana (menampilkan tulisan “Hello World”) dan contoh program lainnya.

Pada tutorial ini kita akan membangun RESTFul Web Service sederhana pada Java menggunakan Java Murni. Adapun langkah-langkah yang harus dilakukan, sebagai berikut:

1.      Dalam hal ini, kami menggunakan tools Netbeans dengan server GalssFish Server 4.1
2.      Buka Netbenas IDE
3.      Pilih File > New Project
4.      Dalam kategori, pilih Java Web > Web Application
(Untuk Langkah ini, kita bisa menggunakan layanan web Maven dengan memilih Maven > Web Application Maven) 
5.      Isi nama project (misal : HelloWorld)
6.   Kemudian, pastikan Server yang akan kita gunakan adalah GlassFish Server 44.1 (atau versi lebih tinggi).

7.  Klik Next. Dan akan muncul pilihan Framework. Namun untuk tutorial ini, kita tidak menggunakan framework. Klik Finish.

8.   Pada project ini akan terbentuk secara otomatis File index.jsp, dan file tersebut akan ditampilkan.
9.      Klik Kanan nama_project dan Pilih New, lalu pilih RESTFul Web Service Patterns.

a.       Pilih Simple Root Resource. Klik Next.

b.      Masukkan nama paket resource, misalnya HelloWorld.
c.       Masukkan nama ‘helloworld’ di field Path. Dan masukkan HelloWorld di kolom nama class. Untuk MIME pilih text/html.

d.      Klik Finish.

10.  Kemudian akan terbentuk 2 file baru (ApplicationConfig.java dan HelloWorld.java).
11.  Dalam file HelloWorld.java, kita cari method getHtml(). Kemudian ganti komentar //TODO dengan kode berikut.

@GET
    @Produces("text/html")
    public String getHtml() {
        return "<title>Hello Wildan</title>"
                + "<html><body><H1>Hello World Wildan</body></h1></html> ";
    }

Sehingga kode program lengkapnya adalah :

/*
 * To change this license header, choose License Headers in Project Properties.
 * To change this template file, choose Tools | Templates
 * and open the template in the editor.
 */
package id.web.wildan.tutorial;

import javax.ws.rs.core.Context;
import javax.ws.rs.core.UriInfo;
import javax.ws.rs.Produces;
import javax.ws.rs.Consumes;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PUT;

/**
 * REST Web Service
 *
 * @author HP
 */
@Path("hello")
public class HelloWorld {

    @GET
    @Produces("text/html")
    public String getHtml() {
        return "<title>Hello Wildan</title>"
                + "<html><body><H1>Hello World Wildan</body></h1></html> ";
    }   
}

12.  Langkah selanjutnya, jika ingin menjalankan program tersebut adalah
                       Klik kanan pada nama_project. Pilih Properties, lalu pilih Categories Run

a.       Kemudian tetatpkan Relative URL (misal : rest/hello).
Jika kita tidak men-setting hal ini, maka ketika kita jalankan maka secara default yang ditampilkan adalah Path Context (http://localhost:8080/HelloWorld), dan sistem akan menjalankan file index.jsp (Hello World !!). Padahal hal tersebut adalah file yang salah. Kita akan menampilkan pesan Hello World Wildan.
b.      Klik Kanan peoject dan pilih Deploy. Atau pada hal lain, saat kita men-setting Run, lalu menyimpan perubahannya maka secara otomatis project kita akan di deploy.
c.       Selanjutnya jika proses deploy selesai, klik kanan project dan pilih Run.
d.   Jendela browser akan terbuka dan menampilkan Hello World Wildan.
Karya       : Wildan A Nasrullah
Referensi  : : https://docs.oracle.com/cd/E19226-01/820-7627/giqaa/

0 komentar:

Posting Komentar