例子：java实现web服务

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

服务端点接口（SEI）和服务实现Bean（SIB）

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

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

服务端点接口定义：

package ch01.ts;
import javax.jws.WebMethod;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.jws.soap.SOAPBinding.Style;
/**
 * 服务端点接口定义（SEI）
 * @author fuhd
 */
@WebService
@SOAPBinding(style = Style.RPC)
public interface TimeServer {
 @WebMethod String getTimeAsString();
 @WebMethod long getTimeAsElased();
}

服务实现Bean：

package ch01.ts;
import java.util.Date;
import javax.jws.WebService;
/**
 * 服务实现Bean（SIB）
 * @author fuhd
 */
@WebService(endpointInterface = "ch01.ts.TimeServer")
public class TimeServerImpl implements TimeServer {
 @Override
 public String getTimeAsString() {
  return new Date().toString();
 }
 @Override
 public long getTimeAsElased() {
  return new Date().getTime();
 }
}

发布为java web服务：

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

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

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

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