Rumah Marion Rotinsulu

Artikel ini saya tulis untuk membatu para developer yang akan mengimplementasikan interoperabilitas (kemampuan dua sistem atau lebih untuk bekerja sama secara harmonis) web service yang dibuat dengan java programming languages yang menggunakan library Jax-WS dan PHP yang kebanyakan orang menggunakan Nusoap. ketika anda mencari artikel untuk interoperabilitas antara jax-ws dan php di paman google anda akan di refer ke blog salah seorang pakar web service yaitu Dionysios G. Synodinos. pada tulisan Synodinos dia membuat skenario Nusoap yang bekerja sebagai web service server dan jax-ws sebagai clientnya. Namun, bagaimana jika kita membalikkan jax-ws sebagai web service server dan nusoap sebagai clientnya??

Ternyata tidak semudah Nusoap sebagai web server dan jax-ws sebagai client. saya membaca sebuah buku yang berjudul XML Web Service dan artikel yang berjudul Developing Web Service Using JAX-WS untuk menemukan jawabannya.  Sebelum memulai penulisan artikel di sini saya menggunakan Nusoap versi 0.7.3 yang dapat anda download di sini dan Jax-WS versi 2.1.

Untuk menginteroperabilitas antara jax-ws dan Nusoap ada 3 Hal yang perlu diperhatikan disisi jax-ws yaitu harus terdapat : targetNamespace, action, dan service name. ketiga hal ini untuk interoperabilitas client yang menggunakan java atau .Net tidak terlalu berpengaruh, namun berbeda halnya dengan PHP. 3 hal ini sangat dibutuhkan oleh Nusoap untuk menangani pertukaran pesan.

saya akan jelaskan satu persatu fungsinya. targetNamespace berfungsi untuk mendefinisikan secara global apa nama umum dari service ini(web service mana yang jadi target untuk di panggil). Untuk mendefinisikan targetNamespace ditulis dengan pola sebagai berikut : urn:nama_yang_diinginkan. Untuk kolom action berfungsi untuk mendefinisikan tanda apa yang harus kita panggil untuk menandakan bahwa service ini yang kita akan gunakan. pola untuk menuliskan action sebuah SOAP sebagai berikut : urn:nama_yang_diinginkan#nama_soap_action. Terakhir adalah service name, service name digunakan untuk memberikan nama service (tidak wajib hanya sebagai idetifier tapi amat dibutuhkan oleh Nusoap).  ketiga-tiganya ini bertipe string sehingga dalam menuliskannya, harus diapit tandan “(double quotes).

Web Service yang saya buat sebagai sample di bawah ini adalah untuk menunjukkan nama yang mengakses aplikasi tersebut.  web service berikut saya namakanya projectnya TestingWS. saya menggunakan netbeans sebagai tools dalam membuat web service ini.

langkah-langkah membangun web service dengan netbeans:

1. Nyalakan Netbeans

2. Bikin Project baru dan namakan TestingWS. caranya File -> New Project.

3. Pilih di Categories Java Web kemudian di bagian projects Web Application. kemudian tekan tombol next.

4. Berikan nama terhadap project tersebut sebagai contoh TestingWS. Kemudian Next.

5. Lakukan Next hingga tombol finish bisa di klik.

6. Klik kanan di nama project TestingWS kemudian pilih New->Web Service.

7. Masukkan nama Web Service yang kita inginkan di kolom Web Service Name(saya menamakan Web Service ini adalah testWS).

8. dikolom package ketikkan org.testing.ws. setelah itu klik finish.

9. setelah itu akan terbuka halaman web service ketikkan hal-hal yang gak ada di halaman tersebut(telah di bold di kutipan script dibawah ini) :

package org.testing.ws;

import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebService;

@WebService(name = “Test”, serviceName=”testWS”, targetNamespace=”urn:testWSService”)
public class TestWS {
@WebMethod(operationName = “testWS”, action=”urn:testWSService#testWS”)
public String testWS(@WebParam(name = “nama”) String nama) {
String names = nama;
return names;
}
}

10. Kemudian klik kanan pada project yang kitabuat kemudian deploy lah project tersebut.

11. testing web service dapat dilakukan dengan klik kanan pada web service yang kita buat kemudian pilih Test a Web Service.

Key Value :masukkan sebuah string atau nama anda. dan lihatlah jika di melakukan return result yang sama dengan yang anda inputkan berarti benar.

Langkah berikutnya adalah membuat php file yang menggunakan nusoap yang berfungsi sebagai soap client.

1. bikin satu folder dan tempatkan di folder htdocs (buat yang menggunakan XAMPP) atau di folder public_html buat yang menggunakan linux/unix. namakan saja sesuai keinginan anda.

2. Nusoap yang anda telah download tadi di extract kedalam folder yang telah diberi nama lib. folder tersebut kemudian anda cut and paste ke dalam folder yang anda telah buat di bawah folder htdocs.

3. Ketikkan script seperti dibawah ini

<?php
require(“lib/nusoap.php”);
$url = “http://localhost:8080/TestingWS/testWS”;
$parameter = array(‘nama’=>’Marion’);
$namespace=”urn:testWSService”;
$client = new nusoap_client($url);
$result = $client->call(“testWS”,$parameter, $namespace);
$er = $client->getError();
if($er){
echo ‘<h2>Error with soapclient creation : </h2><pre>’.$er.’</pre>’;
} else{
echo $result;
}
?>

4. untuk melihat jalan atau tidaknya, silahkan anda panggil file client.php melalui web browser. contoh http://localhost/ws/client.php. Jika menampilkan nama ‘Marion’ maka web service client anda jalan dan tutorial ini selesai.

Sekian tutorial singkatnya. untuk menambah pemahaman anda tentang web service, anda bisa put comment di tulisan ini. sehingga tutorial in akan semakin lengkap. tak ada gading yang tak retak, jika masih ada kekurangan dalam tulisan ini mohon dimaafkan untuk kesempurnaan tutorial dikemudian hari.