WebService与RESTful WebService

JAX-WS & JAX-RS

Date: 2018/01/12

1. Summary....................................................................................................................... 1

2. JAX-WS.......................................................................................................................... 1

2.1 The common interface..................................................................................... 1

2.2 The functions.................................................................................................. 1

2.3 To call common JAX-WS.................................................................................... 4

2.4 To call private JAX-WS which released by ourself................................................. 7

2.5 Other common JAX-WS.................................................................................. 10

3. JAX-RS......................................................................................................................... 12

3.1 The common interface................................................................................... 12

3.2 The functions................................................................................................ 12

3.3 To call common JAX-RS................................................................................... 15

3.4 To call private JAX-RS which released by ourself................................................. 18

3.5 Other common JAX-RS................................................................................... 18

1. Summary

There are twotypes of Web Service.

JAX-WS, java apifor xml-based webservice.

JAX-RS, java apifor RESTful webservice.

2. JAX-WS

2.1 Thecommon interface

Jar name

WsClient.jar

Interface

package com.cn;

publicinterface WsClient {

public String getResult(StringapplyKey, Stringtype, String...message);

}

Parameters

Type	Name	Description
String	applyKey	User's Key, user's verification
String	type	The provided Web Service type name
String...	message	The input parameters

Return

Type	Description
String	The Web Service calling result

2.2The functions

2.2.1 Validations

2.2.1.2 CheckapplyKey

ToDo

2.2.1.2 Checktype

Check resource/resource.properties which key = support.type to verify if theincoming type is support or not.

2.2.2 Prepare Web ServiceRequest

Use the SOAP 1.2 templates in "/com/cn/resource/request/template/"to prepare the request message.

For example:

2.2.3 Get Web Service Response

To call the related WSDL(Web Services DescriptionLanguage) URL, get the response.

For example:

2.2.4 Parse the response

Use the related key word to get result node.

For example:

2.3 Tocall common JAX-WS

2.3.1 Validations

Pass.

2.3.2 To call the interface

Use below code to call 2.1 common method, to get"苏州"weather.

WsClientwsClient =new WsClientImpl();

System.out.println(wsClient.getResult("","weather","苏州",""));

2.3.3 Send the request SOAP 1.2request

<?xmlversion="1.0"encoding="utf-8"?>

<soap12:Envelopexmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:xsd="http://www.w3.org/2001/XMLSchema"xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">

<soap12:Body>

<getWeatherxmlns="http://WebXml.com.cn/">

</getWeather>

</soap12:Body>

</soap12:Envelope>

2.3.4 Get the response

<?xmlversion="1.0"encoding="utf-8"?>

<soap:Envelopexmlns:soap="http://www.w3.org/2003/05/soap-envelope"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<soap:Body>

<getWeatherResponsexmlns="http://WebXml.com.cn/">

<string>今日天气实况：气温：0℃；风向/风力：北风 2级；湿度：31%</string>

<string>紫外线强度：中等。空气质量：中。</string>

<string>紫外线指数：中等，涂擦SPF大于15、PA+防晒护肤品。健臻·血糖指数：易波动，血糖易波动，注意监测。感冒指数：较易发，天凉温差大，适当增减衣服。穿衣指数：冷，建议着棉衣加羊毛衫等冬季服装。洗车指数：较适宜，无雨且风力较小，易保持清洁度。空气污染指数：中，易感人群应适当减少室外活动。</string>

<string>西北风转东南风小于3级</string>

<string>1月13日晴转多云</string>

</getWeatherResult>

</getWeatherResponse>

</soap:Body>

</soap:Envelope>

2.3.5 Parse the response

江苏苏州

苏州

2004

2018/01/12 10:26:03

今日天气实况：气温：0℃；风向/风力：北风 2级；湿度：31%

紫外线强度：中等。空气质量：中。

紫外线指数：中等，涂擦SPF大于15、PA+防晒护肤品。健臻·血糖指数：易波动，血糖易波动，注意监测。感冒指数：较易发，天凉温差大，适当增减衣服。穿衣指数：冷，建议着棉衣加羊毛衫等冬季服装。洗车指数：较适宜，无雨且风力较小，易保持清洁度。空气污染指数：中，易感人群应适当减少室外活动。

1月12日晴

-3℃/5℃

西北风转东南风小于3级

0.gif

1月13日晴转多云

-1℃/7℃

东南风3-4级

0.gif

1.gif

1月14日多云

3℃/11℃

东南风3-4级

1.gif

1月15日阴

9℃/15℃

东南风3-4级

2.gif

1月16日小雨

7℃/16℃

西北风3-4级

7.gif

2.4 Tocall private JAX-WS which released by ourself

2.4.1 Validations

Pass.

2.4.2 Release private JAX-WS

2.4.2.1 New project HelloFriend

1. New java projectHelloFriend, New class MyService.java

package service;

publicclass MyService {

public String getGreeting(Stringname)

{

return"您好 "+name;

}

2. New META-INF folder and services.xml

services.xml

Service name is "myService", useRPC method

<servicename="myService">

WebService例子

</description>

<parametername="ServiceClass">

service.MyService

</parameter>

<operationname="getGreeting">

</operation>

</service>

3. Export the project to jar

jar cvf ws.aar .

2.4.2.2 Use axis2 to releaseit to tomcat

1. Move 2.4.1.1 step 3 jar apache-tomcat-9.0.2webappsaxis2WEB-INFservices

2. Startup tomcat

3. Visit the private wsdl

2.4.3 To call the interface

WsClientwsClient =new WsClientImpl();

System.out.println(wsClient.getResult("","myservice","刘大人"));

2.4.4 Send the request SOAP 1.2request

<?xmlversion="1.0"encoding="utf-8"?>

<soap12:Envelopexmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:xsd="http://www.w3.org/2001/XMLSchema"xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">

<soap12:Body>

<getGreetingxmlns="http://service">

</getGreeting>

</soap12:Body>

</soap12:Envelope>

2.4.5 Get the response

<?xmlversion="1.0"encoding="utf-8"?>

<soapenv:Envelopexmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">

<soapenv:Header/>

<soapenv:Body>

<ns:getGreetingResponsexmlns:ns="http://service">

<ns:return>您好刘大人</ns:return>

</ns:getGreetingResponse>

</soapenv:Body>

</soapenv:Envelope>

2.4.6 Parse the response

您好刘大人

2.5 Othercommon JAX-WS

2.5.1 Attribution of mobilephones

WsClientwsClient =new WsClientImpl();

wsClient.getResult("","mobile","18662638888","");

==>

18662638888：江苏苏州江苏联通GSM卡

2.5.2 Flight inquiries

WsClientwsClient =new WsClientImpl();

wsClient.getResult("","airline","上海","北京","2018-01-12","");

==>

2.5.3 Chinese/Englishtranslations

WsClientwsClient =new WsClientImpl();

wsClient.getResult("","englishswpchinese","airline","");

==>

airline

'e?lain

adj. (飞机)航线的；n. (飞机的)航线,航空公司

65562.mp3

However short the journey is, you always get something to eat on thisairline.

不管航程多麽短,这一班机上都有些吃的.

That was the worst airline disaster in history.

那是历史上最严重的空难。

The timetable is obtainable post-free from the airline office.

航班时刻表可以向航空公司免费索取。

WsClientwsClient =new WsClientImpl();

wsClient.getResult("","englishswpchinese","苏州","");

==>

苏州

Suzhou (city)

soochow pladj.

Suchou

Soochow

对不起，打扰了，请问坐火车去苏州该乘什么车？

Excuse me, how can I go to suzhou by train?

一个孕妇把他从苏州河救了起来。

A pregnant lady rescued him from the Suzhou River.

这是从这里去苏州的直达列车吗？

Be this a through carriage for Suzhou from here?

3. JAX-RS

3.1The common interface

Jar name

RsClient.jar

Interface

package com.cn;

import java.util.Map;

public interface RsClient {

public <K, V> String getResult(String applyKey, String httpType, String type, Map<K,V> parameters, String... message);

}

Parameters

Type	Name	Description
String	applyKey	User's Key, user's verification
String	httpType	Http calling type, GET/POST/PUT/DELETE
String	type	The provided Web Service type name
Map<K,V>	parameters	httpType is POST, the related parameters
String…	message	The input parameters