This is an automated email from the ASF dual-hosted git repository. ggregory pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/commons-jxpath.git
commit 42745768e5dcb5fe98e9f2fb8ad4dbd049cd3c7e Author: Gary D. Gregory <[email protected]> AuthorDate: Sun Mar 16 18:52:12 2025 -0400 Javadoc --- .../org/apache/commons/jxpath/AbstractFactory.java | 10 ++- .../org/apache/commons/jxpath/BasicNodeSet.java | 7 ++ .../org/apache/commons/jxpath/BasicVariables.java | 8 ++ .../org/apache/commons/jxpath/ri/Compiler.java | 95 ++++++++++++++++++++++ .../jxpath/ri/model/beans/BeanPointerFactory.java | 7 ++ .../commons/jxpath/util/BasicTypeConverter.java | 8 ++ 6 files changed, 134 insertions(+), 1 deletion(-) diff --git a/src/main/java/org/apache/commons/jxpath/AbstractFactory.java b/src/main/java/org/apache/commons/jxpath/AbstractFactory.java index 945dbee..3e629c7 100644 --- a/src/main/java/org/apache/commons/jxpath/AbstractFactory.java +++ b/src/main/java/org/apache/commons/jxpath/AbstractFactory.java @@ -22,14 +22,22 @@ package org.apache.commons.jxpath; * AbstractFactory for that purpose. Install a factory on JXPathContext by calling {@link JXPathContext#setFactory JXPathContext. setFactory()}. * <p> * All methods of this class return false. Override any of them to return true to indicate that the factory has successfully created the described object. + * </p> */ public abstract class AbstractFactory { + + /** + * Constructs a new instance for subclasses. + */ + public AbstractFactory() { + // empty + } + /** * The parameters may describe a collection element or an individual object. It is up to the factory to infer which one it is. If it is a collection, the * factory should check if the collection exists. If not, it should create the collection. Then it should create the index'th element of the collection and * return true. - * <p> * * @param context can be used to evaluate other XPaths, get to variables etc. * @param pointer describes the location of the node to be created diff --git a/src/main/java/org/apache/commons/jxpath/BasicNodeSet.java b/src/main/java/org/apache/commons/jxpath/BasicNodeSet.java index 883c0bf..b205b87 100644 --- a/src/main/java/org/apache/commons/jxpath/BasicNodeSet.java +++ b/src/main/java/org/apache/commons/jxpath/BasicNodeSet.java @@ -31,6 +31,13 @@ public class BasicNodeSet implements NodeSet { private List<Pointer> readOnlyPointers; private List nodes; private List values; + + /** + * Constructs a new instance. + */ + public BasicNodeSet() { + // empty + } /** * Add the specified NodeSet to this NodeSet. diff --git a/src/main/java/org/apache/commons/jxpath/BasicVariables.java b/src/main/java/org/apache/commons/jxpath/BasicVariables.java index 981eb27..4358314 100644 --- a/src/main/java/org/apache/commons/jxpath/BasicVariables.java +++ b/src/main/java/org/apache/commons/jxpath/BasicVariables.java @@ -25,10 +25,18 @@ import java.util.HashMap; public class BasicVariables implements Variables { private static final long serialVersionUID = 2708263960832062725L; + /** * Contains the values of declared variables */ private final HashMap vars = new HashMap(); + + /** + * Constructs a new instance. + */ + public BasicVariables() { + // empty + } /** * Defines a new variable with the specified value or modifies the value of an existing variable. diff --git a/src/main/java/org/apache/commons/jxpath/ri/Compiler.java b/src/main/java/org/apache/commons/jxpath/ri/Compiler.java index 62bc8b9..caf8588 100644 --- a/src/main/java/org/apache/commons/jxpath/ri/Compiler.java +++ b/src/main/java/org/apache/commons/jxpath/ri/Compiler.java @@ -45,53 +45,148 @@ package org.apache.commons.jxpath.ri; */ public interface Compiler { + /** Constant {@value} */ int NODE_TYPE_NODE = 1; + + /** Constant {@value} */ int NODE_TYPE_TEXT = 2; + + /** Constant {@value} */ int NODE_TYPE_COMMENT = 3; + + /** Constant {@value} */ int NODE_TYPE_PI = 4; + + /** Constant {@value} */ int AXIS_SELF = 1; + + /** Constant {@value} */ int AXIS_CHILD = 2; + + /** Constant {@value} */ int AXIS_PARENT = 3; + + /** Constant {@value} */ int AXIS_ANCESTOR = 4; + + /** Constant {@value} */ int AXIS_ATTRIBUTE = 5; + + /** Constant {@value} */ int AXIS_NAMESPACE = 6; + + /** Constant {@value} */ int AXIS_PRECEDING = 7; + + /** Constant {@value} */ int AXIS_FOLLOWING = 8; + + /** Constant {@value} */ int AXIS_DESCENDANT = 9; + + /** Constant {@value} */ int AXIS_ANCESTOR_OR_SELF = 10; + + /** Constant {@value} */ int AXIS_FOLLOWING_SIBLING = 11; + + /** Constant {@value} */ int AXIS_PRECEDING_SIBLING = 12; + + /** Constant {@value} */ int AXIS_DESCENDANT_OR_SELF = 13; + + /** Constant {@value} */ int FUNCTION_LAST = 1; + + /** Constant {@value} */ int FUNCTION_POSITION = 2; + + /** Constant {@value} */ int FUNCTION_COUNT = 3; + + /** Constant {@value} */ int FUNCTION_ID = 4; + + /** Constant {@value} */ int FUNCTION_LOCAL_NAME = 5; + + /** Constant {@value} */ int FUNCTION_NAMESPACE_URI = 6; + + /** Constant {@value} */ int FUNCTION_NAME = 7; + + /** Constant {@value} */ int FUNCTION_STRING = 8; + + /** Constant {@value} */ int FUNCTION_CONCAT = 9; + + /** Constant {@value} */ int FUNCTION_STARTS_WITH = 10; + + /** Constant {@value} */ int FUNCTION_CONTAINS = 11; + + /** Constant {@value} */ int FUNCTION_SUBSTRING_BEFORE = 12; + + /** Constant {@value} */ int FUNCTION_SUBSTRING_AFTER = 13; + + /** Constant {@value} */ int FUNCTION_SUBSTRING = 14; + + /** Constant {@value} */ int FUNCTION_STRING_LENGTH = 15; + + /** Constant {@value} */ int FUNCTION_NORMALIZE_SPACE = 16; + + /** Constant {@value} */ int FUNCTION_TRANSLATE = 17; + + /** Constant {@value} */ int FUNCTION_BOOLEAN = 18; + + /** Constant {@value} */ int FUNCTION_NOT = 19; + + /** Constant {@value} */ int FUNCTION_TRUE = 20; + + /** Constant {@value} */ int FUNCTION_FALSE = 21; + + /** Constant {@value} */ int FUNCTION_LANG = 22; + + /** Constant {@value} */ int FUNCTION_NUMBER = 23; + + /** Constant {@value} */ int FUNCTION_SUM = 24; + + /** Constant {@value} */ int FUNCTION_FLOOR = 25; + + /** Constant {@value} */ int FUNCTION_CEILING = 26; + + /** Constant {@value} */ int FUNCTION_ROUND = 27; + + /** Constant {@value} */ int FUNCTION_NULL = 28; + + /** Constant {@value} */ int FUNCTION_KEY = 29; + + /** Constant {@value} */ int FUNCTION_FORMAT_NUMBER = 30; + + /** Constant {@value} */ int FUNCTION_ENDS_WITH = 31; /** diff --git a/src/main/java/org/apache/commons/jxpath/ri/model/beans/BeanPointerFactory.java b/src/main/java/org/apache/commons/jxpath/ri/model/beans/BeanPointerFactory.java index 1db116f..41c4516 100644 --- a/src/main/java/org/apache/commons/jxpath/ri/model/beans/BeanPointerFactory.java +++ b/src/main/java/org/apache/commons/jxpath/ri/model/beans/BeanPointerFactory.java @@ -32,6 +32,13 @@ public class BeanPointerFactory implements NodePointerFactory { /** Factory order constant */ public static final int BEAN_POINTER_FACTORY_ORDER = 900; + + /** + * Constructs a new instance. + */ + public BeanPointerFactory() { + // TODO Auto-generated constructor stub + } @Override public NodePointer createNodePointer(final NodePointer parent, final QName name, final Object bean) { diff --git a/src/main/java/org/apache/commons/jxpath/util/BasicTypeConverter.java b/src/main/java/org/apache/commons/jxpath/util/BasicTypeConverter.java index 1860212..40c6ea1 100644 --- a/src/main/java/org/apache/commons/jxpath/util/BasicTypeConverter.java +++ b/src/main/java/org/apache/commons/jxpath/util/BasicTypeConverter.java @@ -151,6 +151,14 @@ public class BasicTypeConverter implements TypeConverter { } } + + /** + * Constructs a new instance. + */ + public BasicTypeConverter() { + // empty + } + /** * Create a collection of a given type. *
