commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r540288 - /jakarta/commons/proper/jxpath/trunk/xdocs/users-guide.xml
Date Mon, 21 May 2007 20:47:35 GMT
Author: mbenson
Date: Mon May 21 13:47:34 2007
New Revision: 540288

document some stuff and correct 2 misspellings


Modified: jakarta/commons/proper/jxpath/trunk/xdocs/users-guide.xml
--- jakarta/commons/proper/jxpath/trunk/xdocs/users-guide.xml (original)
+++ jakarta/commons/proper/jxpath/trunk/xdocs/users-guide.xml Mon May 21 13:47:34 2007
@@ -701,7 +701,7 @@
           the same as the "child::" axis.
-          The only two distinctions are the "xml:lang" and "name".
+          The only distinctions are "xml:lang", "xml:space", and "name".
           Attribute <code>xml:lang</code> refers to the name of the locale
@@ -711,6 +711,18 @@
           explicitly set it is the application's default locale.
+          Since version 1.3, the <code>xml:space</code> attribute can be used
+          in an XML model to direct JXPath's interpretation of embedded
+          whitespace among XML content and nested text. In previous versions
+          this data was trimmed, and this has been preserved as the default
+          behavior for reasons of backward compatibility. Specifying
+          <code>xml:space="preserve"</code> will cause JXPath to preserve
+          whitespace. Keep in mind that it is possible to specify default
+          attribute values using DTD or XML schema, so that there exists a
+          straightforward and standards-based way to enable whitespace
+          preservation by default at the document or element level.
+        </p>
+        <p>
           The <code>name</code> attribute is primarily used when
           working with Maps.  Often elements of a Map can be retrieved
           using the "child::" axis.  For example, if "foo" in <code>"foo/bar"</code>
@@ -1189,7 +1201,7 @@
           Collections of custom extension functions can be
           implemented as
           <a href="apidocs/org/apache/commons/jxpath/Functions.html"><code>Functions</code></a>
-          objects or as Java classes, whose methods become extenstion
+          objects or as Java classes, whose methods become extension
@@ -1254,7 +1266,7 @@
 <!--============================ + SOURCE + ============================-->
-public class MyExtenstionFunctions {
+public class MyExtensionFunctions {
    public static boolean isDate(ExpressionContext context){
       Pointer pointer = context.getContextNodePointer();
       if (pointer == null){
@@ -1295,13 +1307,13 @@
          NodeSet, in addition to providing access to the values, also provides access
          to pointers.
          Note that a collection is often passed to an extension function by value and
-         cannot be modified. 
+         cannot be modified.
 <!--============================ + SOURCE + ============================-->
-public class MyExtenstionFunctions {
+public class MyExtensionFunctions {
    public static boolean contains(NodeSet nodeSet, Object value){
       Iterator iter = nodeSet.getPointers().iterator();
@@ -1341,6 +1353,21 @@
 <!--============================ - SOURCE - ============================-->
+        <p>
+         In JXPath version 1.1, a function argument declared as Object would be
+         passed as a NodeSet. In version 1.2, this behavior was changed such
+         that a declared argument type of Object triggers the conversion of
+         the NodeSet to its list of values. The simplest way to avoid this
+         conversion, thereby receiving the untouched NodeSet as the function
+         argument, is to declare the argument as a NodeSet. For such times as
+         this may prove impractical, however, a version 1.1-compatible
+         TypeConverter implementation,
+         (org.apache.commons.jxpath.util.JXPath11CompatibleTypeConverter),
+         has been provided in version 1.3. To enable this:
+        </p>
+TypeUtils.setTypeConverter(new JXPath11CompatibleTypeConverter());
       <subsection name="Collection as the Return Value">
@@ -1736,4 +1763,4 @@
\ No newline at end of file

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message