« Refactoring | صÙ?ØÙ‡ اصلی | استÙ?اده از Web Service در برنامه »
ايجاد web service در JavaEE 5 توسط NetBeans 5.5
September 24, 2007 10:55 AM
در JavaEE 5 از تكنولوژي JAX-WS براي ساخت و است�?اده از Web Service هاي XML اي است�?اده مي شود. JAX-WS مخ�?�? Java API for XML Web Services مي باشد.
همانگونه كه مي دانيد برقراري ارتباط در Web service ها با پروتوكل SOAP انجام مي شود. اين پروتوكل تبادل اطلاعات را به �?رمت XML بر بستر پروتوكل HTTP �?راهم مي سازد.
ساخت يك Web Service ساده در يك Web Application:
1- ايجاد يك Web Application در NetBeans IDE:
پس از اجراي NetBeans IDE از منوي File منوي New Project را انتخاب نماييد. با اين كار �?رم ديگري باز مي شود. در �?رم مذكور از قسمت Web گزينه Web Application را انتخاب كرده، دكمه Next را ب�?شاريد. در مرØÙ„Ù‡ بعدي، نام پروژه Ùˆ مسير آن را مشخص كنيد Ùˆ دكمه Finish را بزنيد. بدين ترتيب يك Web Application خالي ساخته ايد.
2- ايجاد يك Package:
در تب هاي سمت Ú†Ù¾ NetBeans تب Projects را انتخاب نماييد Ùˆ داخل آن روي پروژه اي كه در مرØÙ„Ù‡ قبل ايجاد كرده ايد راست كليك كنيد. از منوي New گزينه Java Packageرا انتخاب كنيد. �?رمي باز مي شود كه در آن نام Package خود را وارد كنيد. در اين مثال نام آن را TesWebServicePac وارد كنيد. همچنين �?يلد location را Source Package قرار دهيد. در انتها دكمه Finish را �?شار دهيد.
3- ا�?زودن يك Web Service:
از همان منوي مرØÙ„Ù‡ قبل يعني راست كليك روي پروژه Ùˆ انتخاب New وارد شويد اما اين بار گزينه Web Service را انتخاب نماييد. نام Web Service را TestWebService وارد كنيد Ùˆ TestWebServicePac را بعنوان package آن انتخاب نماييد. سپس دكمه Finish را بزنيد.
با اين كار در �?ولدر Web Services پروژه، آيكوني به نام TestWebService ايجاد مي گردد. روي آن كليك نماييد تا �?ايل TestWebService.java براي ويرايش باز شود.
4-نوشتن كدهاي لازم:
خود NetBeans بخش هايي از كد را مي سازد. اما بدنه كلاس Ùˆ متدهاي آن را شما بايد خود كدنويسي كنيد. به هر ØØ§Ù„ در نهايت داخل TestWebService.java اين كدها بايد نوشته شوند:
همانگونه كه مي دانيد برقراري ارتباط در Web service ها با پروتوكل SOAP انجام مي شود. اين پروتوكل تبادل اطلاعات را به �?رمت XML بر بستر پروتوكل HTTP �?راهم مي سازد.
ساخت يك Web Service ساده در يك Web Application:
1- ايجاد يك Web Application در NetBeans IDE:
پس از اجراي NetBeans IDE از منوي File منوي New Project را انتخاب نماييد. با اين كار �?رم ديگري باز مي شود. در �?رم مذكور از قسمت Web گزينه Web Application را انتخاب كرده، دكمه Next را ب�?شاريد. در مرØÙ„Ù‡ بعدي، نام پروژه Ùˆ مسير آن را مشخص كنيد Ùˆ دكمه Finish را بزنيد. بدين ترتيب يك Web Application خالي ساخته ايد.
2- ايجاد يك Package:
در تب هاي سمت Ú†Ù¾ NetBeans تب Projects را انتخاب نماييد Ùˆ داخل آن روي پروژه اي كه در مرØÙ„Ù‡ قبل ايجاد كرده ايد راست كليك كنيد. از منوي New گزينه Java Packageرا انتخاب كنيد. �?رمي باز مي شود كه در آن نام Package خود را وارد كنيد. در اين مثال نام آن را TesWebServicePac وارد كنيد. همچنين �?يلد location را Source Package قرار دهيد. در انتها دكمه Finish را �?شار دهيد.
3- ا�?زودن يك Web Service:
از همان منوي مرØÙ„Ù‡ قبل يعني راست كليك روي پروژه Ùˆ انتخاب New وارد شويد اما اين بار گزينه Web Service را انتخاب نماييد. نام Web Service را TestWebService وارد كنيد Ùˆ TestWebServicePac را بعنوان package آن انتخاب نماييد. سپس دكمه Finish را بزنيد.
با اين كار در �?ولدر Web Services پروژه، آيكوني به نام TestWebService ايجاد مي گردد. روي آن كليك نماييد تا �?ايل TestWebService.java براي ويرايش باز شود.
4-نوشتن كدهاي لازم:
خود NetBeans بخش هايي از كد را مي سازد. اما بدنه كلاس Ùˆ متدهاي آن را شما بايد خود كدنويسي كنيد. به هر ØØ§Ù„ در نهايت داخل TestWebService.java اين كدها بايد نوشته شوند:
package TesWebServicePac;
import javax.jws.WebMethod;
import javax.jws.WebService;
import javax.jws.WebService;
@WebService()
public class TestWebService {
private String message = new String("Hello, ");
public void TestWebService(){}
@WebMethod()
public String SayHello(String name) {
return message+name+".";
}
}
public class TestWebService {
private String message = new String("Hello, ");
public void TestWebService(){}
@WebMethod()
public String SayHello(String name) {
return message+name+".";
}
}
عبارت WebService@ مشخص مي كند كه كلاس مربوطه يك Web Service است. عبارت WebMethod@ قبل از متد مشخص مي كند كه اين متد از Operation هاي Web Service است و توسط Web Application هاي ديگر قابل �?راخواني است.
متد SayHello كاركردي بسيار ساده دارد. يك اسم را بعنوان پارامتر ورودي مي گيرد و همان اسم را به علاوه عبارت Hello"" بر مي گرداند.
5- Deploy كردن پروژه:
قبل از تست Web Service لازم است كه Application را Deploy نماييد. به اين منظور Application را انتخاب و روي آن راست كليك كنيد. سپس گزينه Deploy Project را انتخاب نماييد. صبر كنيد تا عمليات Deploy خاتمه يابد.
6- Ù†ØÙˆÙ‡ تست Web Service:
Web Service ها براي تست نياز به يك Web Service Client دارند. اما NetBeans IDE خود، ابزار تست آنها را در اختيار برنامه نويس گذارده است. كا�?ÙŠ است، آن Web Service را انتخاب كرده Ùˆ روي آن راست كليك كنيد. سپس گزينه Test Web Service را انتخاب نماييد. با اين كار در Browser شما ص�?ØÙ‡ اي باز مي شود كه از شما پارامتر مورد نظر را مي گيرد Ùˆ پس از submit كردن، خروجي متد مربوطه را به همراه ساختار SOAP Request Ùˆ SOAP Response به �?رمت XML نمايش مي دهد.
متد SayHello كاركردي بسيار ساده دارد. يك اسم را بعنوان پارامتر ورودي مي گيرد و همان اسم را به علاوه عبارت Hello"" بر مي گرداند.
5- Deploy كردن پروژه:
قبل از تست Web Service لازم است كه Application را Deploy نماييد. به اين منظور Application را انتخاب و روي آن راست كليك كنيد. سپس گزينه Deploy Project را انتخاب نماييد. صبر كنيد تا عمليات Deploy خاتمه يابد.
6- Ù†ØÙˆÙ‡ تست Web Service:
Web Service ها براي تست نياز به يك Web Service Client دارند. اما NetBeans IDE خود، ابزار تست آنها را در اختيار برنامه نويس گذارده است. كا�?ÙŠ است، آن Web Service را انتخاب كرده Ùˆ روي آن راست كليك كنيد. سپس گزينه Test Web Service را انتخاب نماييد. با اين كار در Browser شما ص�?ØÙ‡ اي باز مي شود كه از شما پارامتر مورد نظر را مي گيرد Ùˆ پس از submit كردن، خروجي متد مربوطه را به همراه ساختار SOAP Request Ùˆ SOAP Response به �?رمت XML نمايش مي دهد.
نظرخواهی