Tutorial Axis |
1. Pengantar
Axis adalah Project Open Source dalam lingkungan Apache.org yang dikembangkan untuk menyediakan wahana bagi web service dengan Java.
2. Bagaimana Menginstal Axis
Untuk menggunakan Axis, hal-hal yang perlu Anda persiapan & butuhkan adalah sebagai berikut:
A. Proses Installation
Proses installasi Axis mencakup :
Download installation file >> Extract >> Deploy ke web application server/container, seperti Tomcat.
Jika anda belum mempunyai programnya, anda bisa mengunggahnya DISINI.
B. Extract
Jika Anda menggunakan OS Linux, installation file yang Anda download bernama “xml-axis-beta2.tar.gz” Tentukan di mana Anda akan meng-install. Misalkan Anda akan meng-install ke directory /home/lab. Pindahkan file xml-axis-beta2.tar.gz ke directory pilihan Anda tersebut, selanjutnya jalankan unzip melalui console dari directory tersebut.
$ gunzip xml-axis-beta2.tar.gz $ tar -xvf xml-axis-beta2.tar
Maka installation file akan di-extract :
xml-axis-beta2/ xml-axis-beta2/LICENSE xml-axis-beta2/README xml-axis-beta2/release-notes.html xml-axis-beta2/docs/ xml-axis-beta2/docs/architecture-guide.html
Sehingga akan berakhir (menciptakan directory) sebagai berikut :
xml-axis-beta2/webapps/axis/WEB-INF/lib/ xml-axis-beta2/webapps/axis/WEB-INF/lib/axis.jar xml-axis-beta2/webapps/axis/WEB-INF/lib/commons-logging.jar xml-axis-beta2/webapps/axis/WEB-INF/lib/jaxrpc.jar xml-axis-beta2/webapps/axis/WEB-INF/lib/log4j-core.jar xml-axis-beta2/webapps/axis/WEB-INF/lib/tt-bytecode.jar xml-axis-beta2/webapps/axis/WEB-INF/lib/wsdl4j.jar
Anda akan mendapatkan sebuah sub directory xml-axis-beta2 di bawah directory /home/lab.
3. Struktur Directory Di Bawah AXIS_HOME
Di dalam directory AXIS_HOME terdapat beberapa sub directory, di antaranya adalah:
4. Buat Keputusan Tentang Nama WebApp
Axis dapat dipandang sebagai sebuah aplikasi web dan untuk menghidupkannya dibutuhkan web application server/container seperti Tomcat. Sebelum men-deploy Axis, Anda perlu menetapkan nama webapp dimana Axis akan dideploy.
5. Deployment ke atas Tomcat
Untuk menjadikan Axis sebagai webapp yang hidup dalam Tomcat, Anda hanya meng-copy directory AXIS_HOME/webapps/axis ke TOMCAT_HOME/webapps dengan mengubah nama directory axis menjadi nama directory pilihan Anda.
Contoh :
$ cp -R /home/lab/xml-axis-beta2/webapps/axis /home/lab/jakarta-tomcat-3.2.1 /webapps/mahakam
6. Mengeksekusi (Menjalankan) Tomcat.
$ export JAVA_HOME=/home/lab/jdk1.3.1_01 $ /home/lab/jakarta-tomcat-4.0.4/bin/startup.sh Using CATALINA_BASE: /home/lab/jakarta-tomcat-4.0.4 Using CATALINA_HOME: /home/lab/jakarta-tomcat-4.0.4 Using CATALINA_TMPDIR: /home/lab/jakarta-tomcat-4.0.4/temp Using JAVA_HOME: /home/lab/jdk1.3.1_01
7. Menguji Hasil Instalasi Axis
Untuk menguji apakah proses instalasi yang Anda lakukan berhasil, Anda dapat mencoba sample yang disediakan Axis.
Sebelum memulai, persiapkan dulu PATH dan CLASSPATH
Contoh :
$ export PATH=/home/lab/jdk1.3.1_01/bin:$PATH $ export CLASSPATH=/home/lab/xerces-2_0_2/xmlParserAPIs.jar:/home/lab/xerces-2_0_2 /xercesImpl.jar:/home/lab/xml-axis-beta2/lib/axis.jar:/home/lab/xml-axis-beta2/lib /jaxrpc.jar:/home/lab/xml-axis-beta2/lib/log4j-core.jar:/home/lab/xml-axis-beta2/lib /commons-logging.jar:/home/lab/xml-axis-beta2
Selanjutnya, lakukan deployment sebuah webservice :
Contoh :
$ java org.apache.axis.client.AdminClient -lhttp://localhost:8080/mahakam/services /AdminService /home/lab/xml-axis-beta2/samples/stock/deploy.wsdd
Jika berjalan sukses, akan muncul log berikut :
- Processing file /home/lab/xml-axis-beta2/samples/stock/deploy.wsdd <Admin>Done processing</Admin>
Kemudian, lakukan pemanggilan web service tersebut melalui client.
$ java samples.stock.GetQuote -lhttp://localhost:8080/mahakam/servlet /AxisServlet -uuser1 -wpass1 XXX
Jika berjalan sukses, akan muncul log berikut :
XXX: 55.25
|