Menciptakan Web Service dengan Menggunakan Spring .NET

Web Service merupakan sebuah layanan yang diakses melalui protokol HTTP.  Penggunaan protokol HTTP ini memungkinkan layanan ini dapat diakses dari berbagi platform yang berbeda. Nah itu sedikit pengertian dari Web Service.

Untuk lebih jelasnya apa itu web service silakan kunjungi link berikut ini.

Apa saja tools yang dibutuhkan? Beberapa Tools yang dibutuhkan yaitu:

1. IIS 5.0
2. Visual Studio Web Developer Express Edition 2008.
3. Microsoft .NET Framework 3.5 SP 1
4. Framework Spring .NET

Langkah-langkah untuk membuatnya:

• Buka Visual Studio Web Developer ES 2008.
• Ciptakan sebuah project .NET Web Application beri namanya “Calculator.WebService”(File > New Project > Visual C# > Web > ASP.NET Web Application).
• Hapus File Default.aspx.
• Tambahkan empat buah folder pada project Calculator.WebService dengan nama, Config, Handler, Interface, Service.
• Tambahkan sebuah Interface pada folder Interface dan beri nama ICalculator“.
• Beri akses modifier public untuk interface ini.
• Tambahkan dua method untuk menjumlah dan mengali.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text; namespace CalculatorServiceHost.Interface
{
public interface ICalculator
{
int Tambah(int angkaPertama, int angkaKedua);
int Kali(int angkaPertama, int angkaKedua);
}
}

• Tambahkan sebuah class pada folder Handler dan beri nama “CalculatorHandler”.
• Berikan akses modifier public untuk class ini.
• Tambahkan dua buah method yaitu Tambah dan Kali yang kedua-duanya menerima dua buah parameter masukan.
• Pada method Tambah dan Kali inilah Anda memproses hasil keluaran apa untuk Service Tambah dan Kali yang Anda ciptakan. Mengapa bukan langsung pada class Service-nya saja diimplementasikan. Anda dapat membaca pendekatan “Tell, Don’t Ask” untuk lebih mudah memahaminya.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web; namespace CalculatorServiceHost.Handler
{
public class CalculatorHandler
{
public CalculatorHandler() { }
public int Tambah(int angkaPertama, int angkaKedua)
{
return (angkaPertama + angkaKedua);
}
public int Kali(int angkaPertama, int angkaKedua)
{
return (angkaPertama * angkaKedua);
}
}
}

• Tambahkan sebuah class pada folder Service dan beri nama “CalculatorService”.
• Berikan akses modifier public untuk class ini.
• Implement interface ICalculator yang telah diciptakan sebelumnya, jangan lupa untuk mengimport interface ICalculator.
• Override method yang dari interface ICalculator dan panggil class Handler untuk memberikan response dari hasil pemanggilan service ini. Jadi biarkan class Handler yang menangani urusan hasil keluaran.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using CalculatorServiceHost.Interface;
using CalculatorServiceHost.Handler;
namespace CalculatorServiceHost.Service
{
public class CalculatorService : ICalculator
{
public int Tambah(int angkaPertama, int angkaKedua)
{
return new CalculatorHandler().Tambah(angkaPertama, angkaKedua);
}
public int Kali(int angkaPertama, int angkaKedua)
{
return new CalculatorHandler().Kali(angkaPertama, angkaKedua);
}
}
}

• Nah sekarang kita akan menciptakan sebuah file xml yang berisi konfigurasi tentang apa nama service, nama web service, nama web method, dan apa aksi yang akan diberikan jika sebuah web method dipanggil.
• Tambahkan sebuah file XML pada direktori Config dan beri nama Services.spring.xml.
• Ubah isi file Services.spring.xml menjadi seperti dibawah ini,

<?xml version="1.0" encoding="utf-8" ?>
<objects xmlns="http://www.springframework.net">
<object name="CalculatorService" type="CalculatorServiceHost.Service.CalculatorService, CalculatorServiceHost"/>
<object id="CalculatorWebService" type="Spring.Web.Services.WebServiceExporter, Spring.Web">
<property name="TargetName" value="CalculatorService"/>
<property name="Namespace" value="http://aslingga.wordpress.com/services"/>
<property name="Description" value="Operation definition"/>
<property name="MemberAttributes">
<dictionary>
<entry key="Tambah">
<object type="System.Web.Services.WebMethodAttribute, System.Web.Services">
<property name="Description" value="Operasi Penjumlahan"/>
<property name="MessageName" value="Tambah"/>
</object>
</entry>
<entry key="Kali">
<object type="System.Web.Services.WebMethodAttribute, System.Web.Services">
<property name="Description" value="Operasi Perkalian"/>
<property name="MessageName" value="Kali"/>
</object>
</entry>
</dictionary>
</property>
</object>
</objects>

• Nah pada tag <object> atribut nama merupakan nama dari wevice Anda ini, saya berikan namanya CalculatorService. Atribut type menerima dua buah parameter, lokasi utuh dari class servicenya, nama assemblynya. Untuk melihat lokasi utuh class servicenya adalah nama namespace + nama class dari class itu. Untuk melihat nama assemblya silakan lihat dari porperties Project Anda.
• Nah sekarang buka file konfigurasi Web.Config dan ubah isi file tersebut seperti di bawah ini,

<?xml version="1.0"?>
<configuration>
<configSections>
<sectionGroup name="spring">
<section name="context" type="Spring.Context.Support.WebContextHandler, Spring.Web"/>
</sectionGroup>
</configSections>
<spring>
<context>
<resource uri="~/Config/Services.spring.xml"/>
</context>
</spring>
<appSettings/>
<connectionStrings/>
<system.web>
<httpHandlers>
<add verb="*" path="*.asmx" type="Spring.Web.Services.WebServiceHandlerFactory, Spring.Web"/>
</httpHandlers>
<httpModules>
<add name="Spring" type="Spring.Context.Support.WebSupportModule, Spring.Web"/>
</httpModules>
<compilation debug="true"/>
</system.web>
</configuration>

• Nah kalo cuma kode program dengan begitu banyak konfigurasi seperti diatas tanpa adanya framework dari Spring .NET sama aja dengan bohong kan ???
• Jadi tambahkan references pada project Anda ini dengan lima buah file dll yang berada pada direktori lib > Spring. Caranya Klik kanan pada project Anda, trus pilih Add References > Browse > Cari direktori lib > Select All files > OK.
• Nah setelah ditambahkan seluruh framework yang dibutuhkan, rebuild project Anda. Trus setelah rebuildnya berhasil, Debug project Anda (Klik kanan pada project > Debug > Start new instance).
• Pada web browser sudah muncul lokasi service Anda.
• Nah untuk melihat apakah web service Anda sudah benar-benar jalan silakan buka file asmx dengan cara mengetikkan url sebagai berikut pada web browser Anda. http://localhost…../CalculatorWebService.asmx, mudah-mudahan jalan ya …
• Trus coba deh kedua-dua web method yang telah Anda buat tadi, apakah hasilnya sama seperti yang Anda inginkan.
• Selamat mencoba ya …

Nah kalo Anda belum mengerti dengan jelas bagaimana cara untuk membuat web service dengan Spring .NET, Anda dapat bertanya langsung ama saya. Hehehe …

Oh ya disini udah ada contoh aplikasi web service yang udah jadinya. Kalo mau unduh silakan unduh disini.