基于Jax-ws的webservice

基于Jax--ws的webservice
在开发webservice的时候,我们需要加入自己的控制逻辑,自定义过滤器，对soap消息进行处理，或者是预先进行一些设置，等等。首先介绍一下如何自定义处理类逻辑。
基于JAS-WS有一个重要的文件,sun.jaxws.xml，这个文件是用来定义服务的处理类的，就好比web.xml一样，我们访问某个业务处理，是由哪一个servlet处理一样。
OK，先看文件。

<?xml version="1.0" encoding="UTF-8"?>
<endpoints xmlns='http://java.sun.com/xml/ns/jax-ws/ri/runtime' version='2.0'>
	<endpoint name="hotel" interface="com.xmlapi.shop.hotel.v1.HotelShopPortType" implementation="com.shopsvc.webservices.hotel.HotelShopSoapServiceImpl" binding="http://www.w3.org/2003/05/soap/bindings/HTTP/" url-pattern="/soap/hotel/v1/*" service="{urn:com:xmlapi:shop:hotel:v1}HotelShopService" port="{urn:com:xmlapi:shop:hotel:v1}HotelShopPort" wsdl="WEB-INF/wsdl/com.xmlapi.shop.hotel.v1.wsdl">
		<javaee:handler-chains xmlns:javaee="http://java.sun.com/xml/ns/javaee">
			<javaee:handler-chain>
				<javaee:handler>
					<javaee:handler-class>com.shopsvc.soap.InboundHandler</javaee:handler-class>
				</javaee:handler>
				<javaee:handler>
					<javaee:handler-class>com.shopsvc.soap.OutboundHandler</javaee:handler-class>
				</javaee:handler>
			</javaee:handler-chain>
		</javaee:handler-chains>
	</endpoint>

</endpoints>

从这个文件我们自定义了2个handle来处理我们的请求和响应。包括当前提供的服务，处理那些url。
接下来我们看看handle类的结构。

public abstract class BaseProtocolHandler implements SOAPHandler<SOAPMessageContext>
{
/**
	 * 
	 * @param smc context of SOAP request message
	 */
	abstract void handleRequest(SOAPMessageContext smc);

	/**
	 * 
	 * @param smc context of SOAP response message
	 */
	abstract void handleResponse(SOAPMessageContext smc);

	/**
	 * Passes message handling down to the EWS filter manager. 
	 */
	public boolean handleMessage(SOAPMessageContext smc) 
	{
		if (smc == null)
		{
               			
	             SoapUtils.createInternalErrorException();
		}
		
		Object objectOutbound = smc.get(MessageContext.MESSAGE_OUTBOUND_PROPERTY);
		
		if (objectOutbound == null || objectOutbound.getClass() != Boolean.class)
		{
           			
		 SoapUtils.createInternalErrorException();
		}
		
		boolean direction = (Boolean)objectOutbound;
		
		if (direction == FilterChain.INBOUND_DIRECTION)
		{
			this.handleRequest(smc);
		}
		else
		{
			this.handleResponse(smc);
		}
		
		// Returning true tells JAX-WS that it should not stop calling other handlers in
		// the chain. Returning false would stop calling the remaining handlers if any. 
		
		return true;
	}
/**
	 * Passes fault handling down to the filter manager. 
	 */
	public boolean handleFault(SOAPMessageContext smc)
	{
		smc.put(EwsSoapUtils.IS_FAULT_RESPONSE_KEY, true);
		this.handleResponse(smc);
		return true;
	}
	
	/**
	 * Informs JAX-WS what headers will understand.
	 * 
	 * This is necessary to be able to process Security header that comes
	 * with mustUnderstand="true" attribute.
	 * 
	 * @see javax.xml.ws.handler.soap.SOAPHandler#getHeaders()
	 */
	public Set<QName> getHeaders()
	{
		HashSet<QName> headers = new HashSet<QName>();
		
		headers.add(new QName(
				"http://schemas.xmlsoap.org/ws/2002/12/secext", 
				"Security", ""));
		
		// This is to support .NET WSE 3.0 security. 
		headers.add(new QName(
				"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd", 
				"Security", ""));
		
		return headers;
	}
	

这是大体的逻辑框架，当服务进入的时候，首先会进入我们的handleMessage,然后去调用handleRequest or response.
这只是父类的实现，接下来我们继续讲子类的实现，以及自定义过滤器的运用。