WebService学习笔记（一）
1、WebService简介
WebService是一种面向服务的架构的技术，通过标准的Web协议提供服务，目的是保证不同平台的应用服务可以互操作。
根据W3C的定义，Web服务（Web service）应当是一个软件系统，用以支持网络间不同机器的互动操作。网络服务通常是许多应用程序接口（API）所组成的，它们透过网络，例如国际互联网（Internet）的远程服务器端，执行客户所提交服务的请求。
尽管W3C的定义涵盖诸多相异且无法介分的系统，不过通常我们指有关于主从式架构（Client-server）之间根据SOAP协议进行传递XML格式消息。无论定义还是实现，WEB服务过程会由服务器提供一个机器可读的描述（通常基于WSDL）以辨别服务器所提供的WEB服務。另外，虽然WSDL不是SOAP服务端点的必要条件，但目前基于Java的主流WEB服务开发框架往往需要WSDL实现客户端的源代码生成。一些工业标准化组织，比如WS-I，就在WEB服务定义中强制包含SOAP和WSDL。
2、WebService相关注解
根据JSR 181规范，WebService 常用到的注解包括@WebService, @WebMethod, @WebParam, @WebResult, @HandlerChain等。
@WebService 用来标注PortType实现类或PortType接口。常用属性如下：
- name: 标注的PortType类型；
- serviceName: 生成的Service名称；
- portName: 调用port的名称
- endpointInterface: 使用portType接口定义时使用。
@WebMethod 用来标注服务提供的方法。
- operationName: 定义WSDL里描述的方法的名称；
- action: 定义action的名称
- exclude: 定义该方法是否加入到web service对外提供的接口中。
@WebParam 用来标注提供服务的具体方法的参数。
- name: 生成WSDL时用来描述方法参数的名称。
- mode: 参数的类型，有IN、OUT、INOUT；
- header:定义参数是否位于header中传输；
@WebResult 用来标注服务提供方法的返回值；
- name: 生成WSDL时描述方法的返回名称；
- header: 返回的值是否放在SOAP Header中传输。
@HandlerChain 用来标注WebService服务器端使用到的handler。
- file: 定义handler链的文件；
- name: handler链的名称；
此处只是简要的总结下，具体的详情请参看：
JAX-WS 注释 http://pic.dhe.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=%2Fcom.ibm.websphere.wsfep.multiplatform.doc%2Finfo%2Fae%2Fae%2Frwbs_jaxwsannotations.html
3、WebService开发步骤
下面以JDK6.0自带的JWX-WS为例，讲述开发一个HelloWorld的示例；
A） 服务器端程序
i）生成WebService注释类。
package org.study.service;
import javax.jws.WebParam;
import javax.jws.WebService;
@WebService
public class HelloWorld {
/**
* 输入用户名称，返回对用户的问候。
*
* @param name 用户名称
* @return 问候语句
*/
public String sayHello(@WebParam(name="name")String name){
return "welcome "+name+", to web-service world!";
}
}
生成WebService实现类。
ii）发布WebService接口。
package org.study.service.publisher;
import javax.xml.ws.Endpoint;
import org.study.service.HelloWorld;
public class ServicePublisher {
/**
* @param args
*/
public static void main(String[] args) {
System.out.println("====正在启动Service服务器程序====");
Endpoint.publish("http://localhost/service/helloWorld", new HelloWorld());
System.out.println("====Service服务器启动完成=====");
System.out.println("可以通过地址 [http://localhost/service/helloWorld?wsdl]访问服务相关描述信息!");
}
}
运行这个Publisher程序，发布WebService，可以访问 http://localhost/service/helloWorld?wsdl访问服务描述信息。
B）客户端程序
i) 根据WSDL描述信息生成WebService访问接口
新建Java工程helloWorldServiceClient, 在源文件夹src下，新建importWs.bat内容如下：
# 根据wsdl生成相关的service文件 wsimport -s . -d ../bin http://localhost/service/helloWorld?wsdl
然后运行： 生成相关的service java文件和class文件。
注意： 运行importWs.bat之前，需已经运行Service服务端程序。 即http://localhost/service/helloWorld?wsdl可访问。
ii) 编写客户端代码：
package org.study.service.client;
import org.study.service.HelloWorld;
import org.study.service.HelloWorldService;
public class HelloWorldClient {
public static void main(String[] args){
HelloWorldService service = new HelloWorldService();
HelloWorld portType = service.getHelloWorldPort();
// invoke service method
String welcomeStr = portType.sayHello("Walker Jong");
System.out.println(welcomeStr);
}
}
执行客户端代码，即可访问service；
源代码：
helloWorldServiceServer.rar
helloWorldServiceClient.rar
参考文献：
1、 Web服务中文wiki http://zh.wikipedia.org/zh/Web%E6%9C%8D%E5%8A%A1
2、JAX-WS 注释 http://pic.dhe.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=%2Fcom.ibm.websphere.wsfep.multiplatform.doc%2Finfo%2Fae%2Fae%2Frwbs_jaxwsannotations.html