(4-4) إنشاء Declaratively-Driven POJO Web Service

* إنشاء Class تحتوي Method لكي ننشرها كـ Web Service .
* اختبار الـ Web Service باستخدام الـ Server المدمج .

إنشاء Class تحتوي Method لكي ننشرها كـ Web Service 

في هذا الجزء سوف ننشئ مشروع جديد و Java class كما قمنا من قبل ، في إنشاء الـ web service لن نسنتخدم الـ annotaion ولكن نستخدم الـ wizard .
الـ wizard ينشئ كل الملفات المطلوبة و المدخلات لكي تجعل الـ class كـ web service .
بمجرد أن تنهي خطوات الـ wizard ، نختبر الـ web service باستخدام HTTP Analyzer عن طريق الـ Server المدمج كما قمنا به من قبل .

1- أنشئ مشروع جديد فارغ . اضغط بزر الماوس الأيمن على مشروع الـ Annotation ثم اختر New وفي الـ New Gallery اختر Generic Project . ثم اضغط Ok .

t20101a

وفي المربع الحواري Create Project أعط المشروع الاسم Wizard .

t20101

اضغط Finish .

2- في مستكشف التطبيق ، اضغط بزر الماوس الأيمن على المشروع ، ثم اختر New .

t20102

في المربع الحواري New Gallery اختر Java Class لإنشاء Java Class جديدة وسمّها HelloService .
تلقائياُ يكون اسم الـ package نفس اسم المشروع ، تأكد أن يكون اسم الـ package هو wizard ، اترك باقي القيم على حالتها الافتراضية ، ثم اضغط OK لاستدعاء محرر الكود .

t20102b

3- في الـ class أضف نفس الـ method المسماة sayHello كما كانت في طريقة الـ Annotation ، احفظ عملك .

public String sayHello (String s) {
return "Hello " + s;
}

t20103

في هذه النقطة انت تملك class ترجع الكلمة Hello متبوعة بالقيمة المدخلة كـ parameter .

4- في مستكشف التطبيق اضغط بزر الماوس الأيمن على HelloService.java ثم اختر Create Web Service . بهذا يبدأ الـ wizard لإنشاء الـ class كـ web service .

t20104

5- في المربع الحواري Create Java Web Service وفي الخطوة Select Deployment Platform تأكد من تحديد الخيار
Java EE 1.5, with support for JAX-WS Annotations .

t20105

ثم اختر Next .

6- وفي الخطوة Generation Options اكتب MyWebService1 في الحقل Web Service Name واجعل الـ Port Name بالقيمة MyWebService1Port .

t20106

ثم اضغط Next .

7- وفي الخطوة Message Format حدد الخيار SOAP 1.2 Binding .

t20107

ثم اضغط Next .

8- وفي الخطوة Methods كل الـ methods التي يمكن استخدامها تكون معروضة و بإمكانك اختيار أيهم شئت . ولكن لأن هناك method واحدة وقد تم تحديدها تلقائياً ، اضغط Next .

t20108
الصفحات التالية تكون لأي classes إضافية يمكن إضافتها والتي ربما تكون الـ service في حاجة لها و تعريف الصلاحيات للـ service .
لن يتم تغيير تلك القيم لذلك اضغط Finish عند أي شاشة لإنشاء الـ web service .

9- تعريف الـ class قد تم تحديثه بالـ annotation المطلوب لنشر الـ web service . تأكد من أن اسم الـ port هو MyWebService1Port أو عدّله إلى ذلك الاسم يا ستخدام المحرر .

t20109
10-  اضغط الأيقونة لحفظ عملك .

اختبار الـ Web Service باستخدام الـ Server المدمج

في هذا الجزء سوف نقوم بعمل compile -تجميع- و deployed -نشر-  و اختبار للـ web service .
عند اختبارك للـ web services باستخدام الـ analyzer ، يتم عمل compile و deployd للـ service إلى الـ server المدمج . ثم يتم استدعاء الـ analyzer ليتيح لك إرسال و استقبال القيم من الـ web service .

1- في مستكشف التطبيق اضغط بزر الماوس الأيمن على HelloService.java في المشروع Wizard ثم اختر Test Web Service من القائمة .

هذا الاختيار يستدعي الـ server المدمج و يعمل deploy للـ service ثم يبدأ الـ analyzer . هذا يمكن ان يأخد القليل من الثواني لبدء الـ server المدمج إذا كان يعمل لأول مرة .

t20201

2- في الجزء العلوي لمحرر HTTP Analyzer يعرض الـ URL الخاص بالـ web service و الـ URL الخاص بـ WSDL و اسم الـ Service و الـ exposed Operations .

t20202

3- في منطقة الـ Request أدخل اسمك في الحقل arg0 ثم اضغط Send Request .

t20203

4- الـ analyzer يرسل الطلب إلى الـ service وبعدد ثواني قليلة يعيد النتيجة .

t20204

5- في الإعداد لإنشاء الـ Web Service من ملف WSDL ، احفظ ملف الـ WDSL .
اضغط بزر الماوس الأيمن على الـ class المسماة HelloService.java الموجودة في مستكشف التطبيق ثم اختر من القائمة Show WSDL for Web Service Annotations .

t20205

6- مولّد ملف الـ wsdl يبدأ . ثم بعد ذلك يتم عرض الـ MyWebService1.wsdl محرر التصميم .

t20206

اضغط التبويب Source أسفل المحرر لعرض كود الـ xml .

t20206b

7- من شريط القوائم اختر File ثم ... Save As .

t20207

ثم احفظ هذا الملف في المكان الذي تريد .

t20207b

الملف الذي تم تخزينه يعبر عن ما تم عمل deploye له في الـ server المدمج .

8- حدد المسار الذي تم تخزين ملف الـ MyWebService1.wsdl فيه وافتحه في برنامج الـ WordPad .
t20208 بعد التأكد من الملف أغلق الـ WordPad .

9- أغلق كل التبويبات في المحرر .
t20209

ليست هناك تعليقات:

إرسال تعليق

---- أتشرف بتعليقاتكم ----