Overview  Package   Class  Use  Deprecated  Index
Home >> All >> org >> apache >> axis >> [ handlers overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

org.apache.axis.handlers
Class BasicHandler  

java.lang.Object
  org.apache.axis.handlers.BasicHandler

All Implemented Interfaces:

org.apache.axis.Handler, java.io.Serializable

Direct Known Subclasses:

DebugHandler, EchoHandler, ErrorHandler, JAXRPCHandler, JWSHandler, LogHandler, LogMessage, MD5AttachHandler, SimpleAuthenticationHandler, SimpleAuthorizationHandler, SimpleSessionHandler, SOAPMonitorHandler

---

public abstract class BasicHandler

extends java.lang.Object

implements org.apache.axis.Handler

BasicHandler is a utility class which implements simple property setting/getting behavior, and stubs out a lot of the Handler methods. Extend this class to make writing your Handlers easier, and then override what you need to.

---

Field Summary
private static org.apache.commons.logging.Log	log
protected  boolean	makeLockable
protected  java.lang.String	name
protected  java.util.Hashtable	options

 

Constructor Summary

BasicHandler()

 

Method Summary
boolean	canHandleBlock(javax.xml.namespace.QName qname)           Indicate if this handler can process qname.
void	cleanup()           Cleanup is called when the chain containing this Handler object is done processing the chain.
void	generateWSDL(org.apache.axis.MessageContext msgContext)           Obtain WSDL information.
org.w3c.dom.Element	getDeploymentData(org.w3c.dom.Document doc)           This will return the root element of an XML doc that describes the deployment information about this handler.
java.lang.String	getName()           Return the name (i.e.
java.lang.Object	getOption(java.lang.String name)           Returns the option corresponding to the 'name' given
java.util.Hashtable	getOptions()           Return the entire list of options
java.util.List	getUnderstoodHeaders()           Return a list of QNames which this Handler understands.
void	init()           Stubbed-out methods.
protected  void	initHashtable()
void	onFault(org.apache.axis.MessageContext msgContext)           Called when a subsequent handler throws a fault.
void	setName(java.lang.String name)           Set the name (i.e.
void	setOption(java.lang.String name, java.lang.Object value)           Set the given option (name/value) in this handler's bag of options
boolean	setOptionDefault(java.lang.String name, java.lang.Object value)           Set a default value for the given option: if the option is not already set, then set it.
void	setOptions(java.util.Hashtable opts)           Sets a whole list of options.
protected  void	setOptionsLockable(boolean makeLockable)           Should this Handler use a LockableHashtable for options? Default is 'false'.

 

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

Methods inherited from interface org.apache.axis.Handler

invoke

 

Field Detail

log

private static org.apache.commons.logging.Log log

---

makeLockable

protected boolean makeLockable

---

options

protected java.util.Hashtable options

---

name

protected java.lang.String name

Constructor Detail

BasicHandler

public BasicHandler()

Method Detail

setOptionsLockable

protected void setOptionsLockable(boolean makeLockable)

Should this Handler use a LockableHashtable for options? Default is 'false'.

---

initHashtable

protected void initHashtable()

---

init

public void init()

Stubbed-out methods. Override in your child class to implement any real behavior. Note that there is NOT a stub for invoke(), since we require any Handler derivative to implement that.

Specified by:

init in interface org.apache.axis.Handler

---

cleanup

public void cleanup()

Description copied from interface: org.apache.axis.Handler

Cleanup is called when the chain containing this Handler object is done processing the chain.

Specified by:

cleanup in interface org.apache.axis.Handler

---

canHandleBlock

public boolean canHandleBlock(javax.xml.namespace.QName qname)

Description copied from interface: org.apache.axis.Handler

Indicate if this handler can process qname.

Specified by:

canHandleBlock in interface org.apache.axis.Handler

---

onFault

public void onFault(org.apache.axis.MessageContext msgContext)

Description copied from interface: org.apache.axis.Handler

Called when a subsequent handler throws a fault.

Specified by:

onFault in interface org.apache.axis.Handler

---

setOption

public void setOption(java.lang.String name,
                      java.lang.Object value)

Set the given option (name/value) in this handler's bag of options

Specified by:

setOption in interface org.apache.axis.Handler

---

setOptionDefault

public boolean setOptionDefault(java.lang.String name,
                                java.lang.Object value)

Set a default value for the given option: if the option is not already set, then set it. if the option is already set, then do not set it.

If this is called multiple times, the first with a non-null value if 'value' will set the default, remaining calls will be ignored.

Returns true if value set (by this call), otherwise false;

---

getOption

public java.lang.Object getOption(java.lang.String name)

Returns the option corresponding to the 'name' given

Specified by:

getOption in interface org.apache.axis.Handler

---

getOptions

public java.util.Hashtable getOptions()

Return the entire list of options

Specified by:

getOptions in interface org.apache.axis.Handler

---

setOptions

public void setOptions(java.util.Hashtable opts)

Description copied from interface: org.apache.axis.Handler

Sets a whole list of options.

Specified by:

setOptions in interface org.apache.axis.Handler

---

setName

public void setName(java.lang.String name)

Set the name (i.e. registry key) of this Handler

Specified by:

setName in interface org.apache.axis.Handler

---

getName

public java.lang.String getName()

Return the name (i.e. registry key) for this Handler

Specified by:

getName in interface org.apache.axis.Handler

---

getDeploymentData

public org.w3c.dom.Element getDeploymentData(org.w3c.dom.Document doc)

Description copied from interface: org.apache.axis.Handler

This will return the root element of an XML doc that describes the deployment information about this handler. This is NOT the WSDL, this is all of the static internal data use by Axis - WSDL takes into account run-time information (like which service we're talking about) this is just the data that's stored in the registry. Used by the 'list' Admin function.

Specified by:

getDeploymentData in interface org.apache.axis.Handler

---

generateWSDL

public void generateWSDL(org.apache.axis.MessageContext msgContext)
                  throws org.apache.axis.AxisFault

Description copied from interface: org.apache.axis.Handler

Obtain WSDL information. Some Handlers will implement this by merely setting properties in the MessageContext, others (providers) will take responsibility for doing the "real work" of generating WSDL for a given service.

Specified by:

generateWSDL in interface org.apache.axis.Handler

---

getUnderstoodHeaders

public java.util.List getUnderstoodHeaders()

Return a list of QNames which this Handler understands. By returning a particular QName here, we are committing to fulfilling any contracts defined in the specification of the SOAP header with that QName.

Specified by:

getUnderstoodHeaders in interface org.apache.axis.Handler

---

Overview  Package   Class  Use  Deprecated  Index
Home >> All >> org >> apache >> axis >> [ handlers overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---