<?xml version="1.0" encoding="iso-8859-1"?>
<?xml-stylesheet href="../../make-menu.xsl" type="text/xsl"?><html>
   <head>
      <this-is section="changes" page="intro92" subpage="extensibility92"/>
      <!--
           Generated at 2011-12-09T20:47:22.916Z--><title>Saxonica: XSLT and XQuery Processing: Extensibility</title>
      <meta name="coverage" content="Worldwide"/>
      <meta name="copyright" content="Copyright Saxonica Ltd"/>
      <meta name="title" content="Saxonica: XSLT and XQuery Processing: Extensibility"/>
      <meta name="robots" content="noindex,nofollow"/>
      <link rel="stylesheet" href="../../saxondocs.css" type="text/css"/>
   </head>
   <body class="main">
      <h1>Extensibility</h1>
      <p>A new way of implementing extension functions is available. These are known as
   <i>integrated</i> extension functions. Unlike traditional extension functions invoked
   as Java methods through reflexion, each integrated extension function is implemented as a separate class that extends the
   abstract class <code>net.sf.saxon.functions.ExtensionFunctionDefinition</code>, together with a class that extends
   <code>net.sf.saxon.functions.ExtensionFunctionCall</code>. The first class must implement a number of methods
   providing information about its argument types and result types, while the second provides the <code>call()</code> method which
   is invoked to call the function. A key advantage of this kind of extension function is that it can exercise
   compile-time behaviour, for example saving information about the static context in which it is called, or
   optimizing itself based on the expressions supplied in the function arguments. Another advantage is that you have
   complete control over the function name, for example you can choose any namespace you like.</p>
      <p>Integrated extension functions need to be registered in the Saxon Configuration. You can do this via the API, or 
   (in Saxon-PE and Saxon-EE) via
   the configuration file. This means that in Saxon Home Edition it is not possible to use integrated extension functions when 
   running from the standard command line interface.</p>
      <p>The old way of binding extension functions ("reflexive extension functions"), 
   by mapping the namespace URI of the function name to a Java class,
  is not available in Saxon Home Edition. Also, it has changed so that by default, it only recognizes namespaces using the
  recommended format <code>java:full.class.name</code>. If you need to recognize arbitrary namespaces ending in the Java class name (as
  allowed in previous releases on XSLT, but not XQuery), find the <code>JavaExtensionLibrary</code> by calling 
   <code>Configuration.getExtensionBinder("java")</code>, and on this object call <code>setStrictJavaUriFormat(false)</code>.</p>
      <p>The <code>ExtensionFunctionFactory</code> (which can be used to change the details of the calling mechanism for reflexive
   extension functions, for example to perform diagnostic tracing) is now set as a property of the 
   <code>JavaExtensionFunctionLibrary</code>
  or <code>DotNetExtensionFunctionLibrary</code>, rather than directly via the <code>Configuration</code>.</p>
      <p>Under .NET, if an extension function expects a value of type <code>XdmAtomicValue</code>, it is now possible
   for the calling XPath expression to supply a node; the node will be automatically atomized.</p>
      <p>The factory mechanism for handling XSLT extension instruction namespaces has changed. Previously it was required
   that the namespace URI should end in the Java class name of a class implementing the <code>ExtensionElementFactory</code>
   interface. It is now possible to use any namespace URI you like. The namespace you choose must be associated with
   the name of the <code>ExtensionElementFactory</code> class in the Configuration, which you can do programmatically
   by calling <code>Configuration.setExtensionElementNamespace()</code>, or from the configuration file.
   Element extensibility is not available in Saxon Home Edition, which also means that the SQL extensions are
   not available.</p>
      <table width="100%">
         <tr>
            <td>
               <p align="right"><a class="nav" href="extensions92.xml">Next</a></p>
            </td>
         </tr>
      </table>
   </body>
</html>