GenericHandler (Java EE 5)

GenericHandler 类是一个帮助简化 Handler 编写过程的便捷抽象类。此类提供生命周期方法 init 和 destroy 的默认实现，还提供各种处理方法。Handler 开发人员应该重写需要限定为派生 Handler 实现类的一部分的方法。

The javax.xml.rpc.handler.GenericHandler class implements the Handler interface. SOAP Message Handler developers should typically subclass GenericHandler class unless the Handler class needs another class as a superclass.

The GenericHandler class is a convenience abstract class that makes writing Handlers easy. This class provides default implementations of the lifecycle methods init and destroy and also different handle methods. A Handler developer should only override methods that it needs to specialize as part of the derived Handler implementation class.

Version:

1.0

Author:

Rahul Sharma

protected GenericHandler()
默认构造方法。

英文文档：

GenericHandler

protected GenericHandler()

Default constructor

public boolean handleRequest(MessageContext context)
handleRequest 方法可处理请求 SOAP 消息。此方法的默认实现返回 true。这指示处理程序链应该继续处理请求 SOAP 消息。如果派生的 Handler 类需要限定此方法的实现，则应该重写此方法。

See also

handleRequest

英文文档：

handleRequest

public boolean handleRequest(MessageContext context)

The handleRequest method processes the request SOAP message. The default implementation of this method returns true. This indicates that the handler chain should continue processing of the request SOAP message. This method should be overridden if the derived Handler class needs to specialize implementation of this method.

Specified by:

handleRequest in interface Handler

Parameters:

context - MessageContext parameter provides access to the request message.

Returns:

boolean Indicates the processing mode

• Return true to indicate continued processing of the request handler chain. The HandlerChain takes the responsibility of invoking the next entity. The next entity may be the next handler in the HandlerChain or if this handler is the last handler in the chain, the next entity is the service endpoint object.
• Return false to indicate blocking of the request handler chain. In this case, further processing of the request handler chain is blocked and the target service endpoint is not dispatched. The JAX-RPC runtime system takes the responsibility of invoking the response handler chain next with the SOAPMessageContext. The Handler implementation class has the the responsibility of setting the appropriate response SOAP message in either handleRequest and/or handleResponse method. In the default processing model, the response handler chain starts processing from the same Handler instance (that returned false) and goes backward in the execution sequence.

See Also:

Handler.handleRequest(javax.xml.rpc.handler.MessageContext)

public boolean handleResponse(MessageContext context)
handleResponse 方法可处理响应消息。此方法的默认实现返回 true。这指示处理程序链应该继续处理响应 SOAP 消息。如果派生的 Handler 类需要限定此方法的实现，则应该重写此方法。

See also

handleResponse

英文文档：

handleResponse

public boolean handleResponse(MessageContext context)

The handleResponse method processes the response message. The default implementation of this method returns true. This indicates that the handler chain should continue processing of the response SOAP message. This method should be overridden if the derived Handler class needs to specialize implementation of this method.

Specified by:

handleResponse in interface Handler

Parameters:

context - MessageContext parameter provides access to the response SOAP message

Returns:

boolean Indicates the processing mode

• Return true to indicate continued processing ofthe response handler chain. The HandlerChain invokes the handleResponse method on the next Handler in the handler chain.
• Return false to indicate blocking of the response handler chain. In this case, no other response handlers in the handler chain are invoked.

See Also:

Handler.handleResponse(javax.xml.rpc.handler.MessageContext)

public boolean handleFault(MessageContext context)
handleFault 方法根据 SOAP 消息处理模型处理 SOAP 错误。此方法的默认实现返回 true。这指示处理程序链应该继续处理 SOAP 错误。如果派生的 Handler 类需要限定此方法的实现，则应该重写此方法。

See also

handleFault

英文文档：

handleFault

public boolean handleFault(MessageContext context)

The handleFault method processes the SOAP faults based on the SOAP message processing model. The default implementation of this method returns true. This indicates that the handler chain should continue processing of the SOAP fault. This method should be overridden if the derived Handler class needs to specialize implementation of this method.

Specified by:

handleFault in interface Handler

Parameters:

context - MessageContext parameter provides access to the SOAP message

Returns:

boolean Indicates the processing mode

• Return true to indicate continued processing of SOAP Fault. The HandlerChain invokes the handleFault method on the next Handler in the handler chain.
• Return false to indicate end of the SOAP fault processing. In this case, no other handlers in the handler chain are invoked.

See Also:

Handler.handleFault(javax.xml.rpc.handler.MessageContext)

public void init(HandlerInfo config)
init 方法使 Handler 实例能够初始化自身。如果派生的 Handler 类需要限定此方法的实现，则应该重写此方法。

See also

init

英文文档：

init

public void init(HandlerInfo config)

The init method to enable the Handler instance to initialize itself. This method should be overridden if the derived Handler class needs to specialize implementation of this method.

Specified by:

init in interface Handler

See Also:

Handler.init(javax.xml.rpc.handler.HandlerInfo)

public void destroy()
destroy 方法指示 Handler 实例的生命周期结束。如果派生的 Handler 类需要限定此方法的实现，则应该重写此方法。

See also

destroy

英文文档：

destroy

public void destroy()

The destroy method indicates the end of lifecycle for a Handler instance. This method should be overridden if the derived Handler class needs to specialize implementation of this method.

Specified by:

destroy in interface Handler

See Also:

Handler.destroy()

abstract public javax.xml.namespace.QName[] getHeaders()
获取此 Handler 实例处理的头块 (header block)。

return

此处理程序实例处理的头块的 QName 所组成的数组。QName 是头块最外面的元素的限定名称。

英文文档：

getHeaders

public abstract QName[] getHeaders()

Gets the header blocks processed by this Handler instance.

Specified by:

getHeaders in interface Handler

Returns:

Array of QNames of header blocks processed by this handler instance. QName is the qualified name of the outermost element of the Header block.

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.