webservice(三) 使用JDK的EndPoint和cxf框架分别发布webservice服务

在JDK1.6中JAX-WS规范定义了如何发布一个webService服务。
JAX-WS是指Java Api for XML – WebService.
与web服务相关的是EndPoint类，此类为端点服务类，它提供一个publish方法用于将一个已经添加了@WebService注解对象绑定到一个地址的端口上。

使用jdk的EndPoint发布web服务

1.在要发布服务的类上添加@WebService注解。将要发布服务的方法设置为public。

2.调用EndPoint.publish(,)发布服务

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

使用CXF框架发布服务

发布服务

两种方式发布服务：ServerFactoryBean 和JaxWsServerFactoryBean

JaxWsServerFactoryBean是ServerFactoryBean 的子类，也是功能扩展类。

1.ServerFactoryBean 方式

public class ServerFactoryBeanDemo {
	public String sayHi(String name){
		String s="hello "+name;
		return s;
	}
	
	public static void main(String[] args) {
		ServerFactoryBean sf=new ServerFactoryBean();
		//服务实现类
		sf.setServiceClass(ServerFactoryBeanDemo.class);
		//服务的发布地址
		sf.setAddress("http://localhost:5678/hello");
		//服务的实例
        sf.setServiceBean(new ServerFactoryBeanDemo());
        //发布服务
		sf.create();
		System.out.println("server ready……");
	}
}

ServerFactoryBean 方式

①不需要提供@WebService注解，依旧可以发布

②不需要提供对外暴露的方法，依旧可以发布(当然这也没什么意义)

2.JaxWsServerFactoryBean方式（建议使用）

@WebService
public class JaxWsServiceDemo {
	public String sayHi(String name) {
		String s = "hello " + name;
		return s;
	}

	public static void main(String[] args) {
		JaxWsServerFactoryBean sf = new JaxWsServerFactoryBean();
		// 服务实现类
		sf.setServiceClass(JaxWsServiceDemo.class);
		// 服务的发布地址
		sf.setAddress("http://localhost:5678/hello");
		// 服务的实例
		sf.setServiceBean(new JaxWsServiceDemo());
		// 发布服务
		sf.create();
		System.out.println("server ready……");
	}
}

JaxWsServerFactoryBean方式

①需要提供@WebService注解

虽然不提供该注解也可以发布成功，但是暴露的方法依旧无法显示，所以通常也会提供注解来显示暴露的方法。

(可以通过查看wsdl文档来验证)

标准的做法
通常会提供一个服务接口，用以表明服务的类型。要加上@Webservice注解。这有点类似于Spring中的服务层的实现。

注意：不提供接口也行，但是在任何情况下都建议使用接口。

如果使用spring的配置文件发布，则必须提供接口。

@WebService
public interface IHelloService {
	public String sayHi(String name);
}

然后提供一个实现类

public class HelloServiceImpl implements IHelloService{
	@Override
	public String sayHi(String name) {
		String s = "hello " + name;
		return s;
	}
	
	public static void main(String[] args) {
		JaxWsServerFactoryBean sf = new JaxWsServerFactoryBean();
		// 服务的类型
		sf.setServiceClass(IHelloService.class);//注意：接口类型
		// 服务的发布地址
		sf.setAddress("http://localhost:5678/hello");
		// 服务的实现类实例
		sf.setServiceBean(new HelloServiceImpl());//注意：实现类实例
		// 发布服务
		sf.create();
		System.out.println("server ready……");
	}
}

wsdl2java工具

cxf也提供了一个用于生成客户端调用代码的工具wsdl2java.exe。它的功能同wsimport一样。它是可以支持SOAP1.1 和SOAP1.2的协议的。

此工具位于cxf_home/bin目录下。参数与wsimport有所不同。
它包含以下参数：
－d参数，指定代码生成的目录。
－p参数，指定生成的新的包结构。

注意：由于wsdl2java是根据jdk1.7生成的本地代码，所以，需要对生成的代码做一点点修改。

1、注意：由于使用的是apache-cxf-2.4.0版本,它是支持jdk1.7的。所以，对于生成的Service要进行稍微的修改。
在jdk1.6中的javax.xml.ws.Service的构造方法接收二个参数为：（String url,QName qname);
在jdk1.7中的javax.xml.ws.Service的构造方法中接收三个参数为：（String url,QName qname,features);


2、将生成的代码，拷贝到项目目录，然后使用以前相同方法调用。
注意：如果将@WebMethod设置了header=true参数，将会在调用时多传递一个参数。参数可以直接传null值。
对于这种情况，可以将header=true修改成header=false然后再重要获取客户端源代码。


3、可能发现，使用cxf生成的客户端代码与wsimport差不多，甚至是一样，那为什么还要使用cxf呢？
原因：它较好的发布方式、较容易的与其他服务器集成、及与Spring的完美结合都不得不让我们使用cxf。

对于上面标准实现中的代码执行该命令，会生成代码供客户端使用。(用法类似于wsimport)

给服务添加消息拦截器

作用：类似于使用TCP/IP Monitor，用来捕获SOAP消息的过程。

LoggingInInterceptor – 信息输入时的拦截器 –请求
LoggingOutInterceptor –信息输出时的拦截器 - 响应

server.getInInterceptors().add(new LoggingInInterceptor());
server.getOutInterceptors().add(new LoggingOutInterceptor());

public class Server {
	public static void main(String[] args) {
		JaxWsServerFactoryBean sf = new JaxWsServerFactoryBean();
		sf.setServiceClass(IHelloService.class);
		sf.setServiceBean(new HelloServiceImpl());
		sf.setAddress("http://localhost:5678/hello");

		// 加入请求的消息拦截器
		sf.getInInterceptors().add(new LoggingInInterceptor());
		// 加入响应的消息拦截器
		sf.getOutInterceptors().add(new LoggingOutInterceptor());
		sf.create();
		System.out.println("server ready……");
	}
}

可以在服务端控制台查看 拦截到的请求信息和发送给客户端的响应信息。