java.lang.Object
org.apache.xalan.extensions.ExtensionHandler
org.apache.xalan.extensions.ExtensionHandlerJava
org.apache.xalan.extensions.ExtensionHandlerJavaPackage
- public class ExtensionHandlerJavaPackage
- extends ExtensionHandlerJava
Represents an extension namespace for XPath that handles java packages
that may be fully or partially specified.
It is recommended that the class URI be of one of the following forms:
xalan://partial.class.name
xalan://
http://xml.apache.org/xalan/java (which is the same as xalan://)
However, we do not enforce this. If the class name contains a
a /, we only use the part to the right of the rightmost slash.
In addition, we ignore any "class:" prefix.
Provides functions to test a function's existence and call a function.
Also provides functions to test an element's existence and call an
element.
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
ExtensionHandlerJavaPackage
public ExtensionHandlerJavaPackage(java.lang.String namespaceUri,
java.lang.String scriptLang,
java.lang.String className)
- Construct a new extension namespace handler given all the information
needed.
isFunctionAvailable
public boolean isFunctionAvailable(java.lang.String function)
- Tests whether a certain function name is known within this namespace.
Since this is for a package, we concatenate the package name used when
this handler was created and the function name specified in the argument.
There is
no information regarding the arguments to the function call or
whether the method implementing the function is a static method or
an instance method.
- Specified by:
isFunctionAvailable in class ExtensionHandler
isElementAvailable
public boolean isElementAvailable(java.lang.String element)
- Tests whether a certain element name is known within this namespace.
Looks for a method with the appropriate name and signature.
This method examines both static and instance methods.
- Specified by:
isElementAvailable in class ExtensionHandler
callFunction
public java.lang.Object callFunction(java.lang.String funcName,
java.util.Vector args,
java.lang.Object methodKey,
ExpressionContext exprContext)
throws javax.xml.transform.TransformerException
- Process a call to a function in the package java namespace.
There are three possible types of calls:
Constructor:
packagens:class.name.new(arg1, arg2, ...)
Static method:
packagens:class.name.method(arg1, arg2, ...)
Instance method:
packagens:method(obj, arg1, arg2, ...)
We use the following rules to determine the type of call made:
- If the function name ends with a ".new", call the best constructor for
class whose name is formed by concatenating the value specified on
the namespace with the value specified in the function invocation
before ".new".
- If the function name contains a period, call the best static method "method"
in the class whose name is formed by concatenating the value specified on
the namespace with the value specified in the function invocation.
- Otherwise, call the best instance method "method"
in the class whose name is formed by concatenating the value specified on
the namespace with the value specified in the function invocation.
Note that a static method of the same
name will not be called in the current implementation. This
module does not verify that the obj argument is a member of the
package namespace.
- Specified by:
callFunction in class ExtensionHandler
callFunction
public java.lang.Object callFunction(org.apache.xpath.functions.FuncExtFunction extFunction,
java.util.Vector args,
ExpressionContext exprContext)
throws javax.xml.transform.TransformerException
- Process a call to an XPath extension function
- Specified by:
callFunction in class ExtensionHandler
processElement
public void processElement(java.lang.String localPart,
org.apache.xalan.templates.ElemTemplateElement element,
org.apache.xalan.transformer.TransformerImpl transformer,
org.apache.xalan.templates.Stylesheet stylesheetTree,
java.lang.Object methodKey)
throws javax.xml.transform.TransformerException,
java.io.IOException
- Process a call to this extension namespace via an element. As a side
effect, the results are sent to the TransformerImpl's result tree.
For this namespace, only static element methods are currently supported.
If instance methods are needed, please let us know your requirements.
- Specified by:
processElement in class ExtensionHandler