例子：java实现web服务

第一个web服务的例子基于SOAP。

服务端点接口&＃xff08;SEI&＃xff09;和服务实现Bean&＃xff08;SIB&＃xff09;

所有编译、执行和调用web服务的相关库文件均包括在支持JAX-WS的Java SE6中。JAX-WS同时支持基于SOAP协议和基于REST风格的web服务类型。基于SOAP的Java Web服务尽管可以只由单独的Java类来实现&＃xff0c;但是遵从最佳实践原则&＃xff0c;首先应该定义一个Java接口类&＃xff0c;在此接口内声明Web服务需要完成或实现的业务方法。通常这类接口被称为“SEI”&＃xff0c;即服务端点接口。而与之对应的实现类被称为“SIB”&＃xff0c;即服务实现Bean。注&＃xff1a;JAX-WS是随着Java标准版6.0一起被发布的&＃xff0c;目前JAX-WS已经相当成熟了。

我们来看看下面这个例子&＃xff0c;该服务以字符串的形式向调用者返回当前系统时间。如例&＃xff1a;

服务端点接口定义&＃xff1a;

package ch01.ts;
import javax.jws.WebMethod;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.jws.soap.SOAPBinding.Style;
/*** 服务端点接口定义&＃xff08;SEI&＃xff09;* &＃64;author fuhd*/
&＃64;WebService
&＃64;SOAPBinding(style &＃61; Style.RPC)
public interface TimeServer {&＃64;WebMethod String getTimeAsString();&＃64;WebMethod long getTimeAsElased();
}

服务实现Bean&＃xff1a;

package ch01.ts;
import java.util.Date;
import javax.jws.WebService;
/*** 服务实现Bean&＃xff08;SIB&＃xff09;* &＃64;author fuhd*/
&＃64;WebService(endpointInterface &＃61; "ch01.ts.TimeServer")
public class TimeServerImpl implements TimeServer {&＃64;Overridepublic String getTimeAsString() {return new Date().toString();}&＃64;Overridepublic long getTimeAsElased() {return new Date().getTime();}
}

发布为java web服务&＃xff1a;

package ch01.ts;
import javax.xml.ws.Endpoint;
/*** 服务发布程序* &＃64;author fuhd*/
public class TimeServerPublisher {public static void main(String[] args) {Endpoint.publish("http://localhost:9876/ts", new TimeServerImpl());}
}

运行发布程序后&＃xff0c;我们可以通过浏览器来测试刚才部署的Web服务&＃xff0c;此时将会看到由发布程序自动产生的服务契约&＃xff0c;即&＃xff1a;WSDL文档。浏览器中输入&＃xff1a;http://127.0.0.1:9876/ts?wsdl就可打开WSDL文档。

对于创建、执行Web服务的客户端程序来说&＃xff0c;WSDL文档可以提供很多帮助。不同的开发语言一般都会提供从WSDL文档直接生成客户端开发相关支持代码的工具包。Java提供的工具程序现在叫&＃xff1a;wsimport&＃xff0c;以前被分别称为&＃xff1a;wsdl2java和java2wsdl。在运行时&＃xff0c;客户端可以通过WSDL文档获取所调用服务操作关联的关键数据类型信息。比如&＃xff0c;一个客户端可以通过我们前面例子所产生的WSDL文档来判断getTimeAsElapsed所返回的数据类型是一个整数&＃xff0c;同时不需要参娄输入。

WSDL也可以通过其他工具程序访问&＃xff0c;比如在linux下使用curl。通过执行下面的命令&＃xff1a;% curl http://localhost:9876/ts?wsdl&＃xff0c;仍然可以显示生的WSDL文档。