04.发布WebService

使用JDK的Endpoint发布

JAX-WS介绍

在JDK1.6中JAX-WS规范定义了如何发布一个webService服务(JAX-WS是指Java Api for XML – WebService)。与Web服务相关的类，都位于javax.xml.ws.*包中

核心类：

• @WebService
  • 它是一个注解，用在类上指定将此类发布成一个webservice服务.
• Endpoint
  • 此类为端点服务类，它的方法publish用于将一个已经添加了@WebService注解对象绑定到一个地址的端口上。Endpoint是jdk提供的一个专门用于发布服务的类，它的publish方法接收两个参数，一个是本地的服务地址，二是提供服务的类。它位于javax.xml.ws.*包中。static Endpoint.publish(String address, Object implementor)在给定地址处针对指定的实现者对象创建并发布端点。stop方法用于停止服务。

其他注意事项：

1. 给类添加上@WebService注解后，类中所有的非静态方法都将会对外公布。不支持静态方法，final方法。
2. 如果希望某个方法(非static,非final)不对外公开，可以在方法上添加@WebMethod(exclude=true)，阻止对外公开。
3. 如果一个类上，被添加了@WebService注解，则必须此类至少有一个可以公开的方法，否则将会启动失败。
4. 服务类中不能没有方法

注解详解

自动生成的文档的名字有时不规范，可以手动进行修改。

@WebService(
   portName="myHelloService",修改端口名字
   serviceName="HelloServices",修改服务访问点集合名字
   name="HelloService",修改服务类的名字
   targetNamespace="hello.rl.com" 修改命名空间名字
)
@WebResult(name="sirHello")修改返回值的元素的父标签名字
@WebParam(name="sir")修改传入参数的元素的父标签名字

使用CFX框架发布

详见CFX笔记