This is an automated email from the ASF dual-hosted git repository.
garydgregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-jexl.git
The following commit(s) were added to refs/heads/master by this push:
new 60cbb544 Javadoc
60cbb544 is described below
commit 60cbb54456bd26175eb210f901d1474707340e3e
Author: Gary Gregory <[email protected]>
AuthorDate: Sun Aug 2 15:55:12 2026 -0400
Javadoc
---
src/main/java/org/apache/commons/jexl3/JexlConfigLoader.java | 6 +++---
src/main/java/org/apache/commons/jexl3/JexlContext.java | 2 +-
src/main/java/org/apache/commons/jexl3/JxltEngine.java | 8 ++++----
src/main/java/org/apache/commons/jexl3/internal/Interpreter.java | 2 +-
src/main/java/org/apache/commons/jexl3/internal/Operator.java | 2 +-
.../apache/commons/jexl3/internal/introspection/IndexedType.java | 8 ++++----
src/main/java/org/apache/commons/jexl3/scripting/Main.java | 4 ++--
src/test/java/org/apache/commons/jexl3/CachePerformanceTest.java | 2 +-
src/test/java/org/apache/commons/jexl3/CacheTest.java | 2 +-
src/test/java/org/apache/commons/jexl3/ScriptCallableTest.java | 2 +-
src/test/java/org/apache/commons/jexl3/junit/Asserter.java | 4 ++--
11 files changed, 21 insertions(+), 21 deletions(-)
diff --git a/src/main/java/org/apache/commons/jexl3/JexlConfigLoader.java
b/src/main/java/org/apache/commons/jexl3/JexlConfigLoader.java
index 868e2b60..ac8bcb3d 100644
--- a/src/main/java/org/apache/commons/jexl3/JexlConfigLoader.java
+++ b/src/main/java/org/apache/commons/jexl3/JexlConfigLoader.java
@@ -234,7 +234,7 @@ public final class JexlConfigLoader {
*
* @param in YAML input; the caller is responsible for closing it
* @return A configured JexlBuilder
- * @throws IOException if the stream cannot be read
+ * @throws IOException Thrown if the stream cannot be read
*/
public static JexlBuilder load(final InputStream in) throws IOException {
return load(new InputStreamReader(in, StandardCharsets.UTF_8));
@@ -245,7 +245,7 @@ public final class JexlConfigLoader {
*
* @param reader YAML input; the caller is responsible for closing it
* @return A configured JexlBuilder
- * @throws IOException if the reader cannot be read
+ * @throws IOException Thrown if the reader cannot be read
*/
public static JexlBuilder load(final Reader reader) throws IOException {
final JexlBuilder builder = new JexlBuilder();
@@ -260,7 +260,7 @@ public final class JexlConfigLoader {
*
* @param in YAML input; the caller is responsible for closing it
* @return A new JexlEngine configured from the YAML
- * @throws IOException if the stream cannot be read
+ * @throws IOException Thrown if the stream cannot be read
*/
public static JexlEngine engine(final InputStream in) throws IOException {
return load(in).create();
diff --git a/src/main/java/org/apache/commons/jexl3/JexlContext.java
b/src/main/java/org/apache/commons/jexl3/JexlContext.java
index deb010ba..30c41115 100644
--- a/src/main/java/org/apache/commons/jexl3/JexlContext.java
+++ b/src/main/java/org/apache/commons/jexl3/JexlContext.java
@@ -68,7 +68,7 @@ public interface JexlContext {
* @param args The arguments of the annotation, evaluated as arguments
of this call
* @param statement The statement that was annotated; the processor
should invoke this statement 'call' method
* @return The result of statement.call()
- * @throws Exception if annotation processing fails
+ * @throws Exception Thrown if annotation processing fails
*/
Object processAnnotation(String name, Object[] args, Callable<Object>
statement) throws Exception;
}
diff --git a/src/main/java/org/apache/commons/jexl3/JxltEngine.java
b/src/main/java/org/apache/commons/jexl3/JxltEngine.java
index ac41cf0f..cc559c46 100644
--- a/src/main/java/org/apache/commons/jexl3/JxltEngine.java
+++ b/src/main/java/org/apache/commons/jexl3/JxltEngine.java
@@ -135,7 +135,7 @@ public abstract class JxltEngine {
* @param context The variable context
* @return The result of this expression evaluation or null if an
error occurs and the {@link JexlEngine} is
* running in silent mode
- * @throws Exception if an error occurs and the {@link JexlEngine}
+ * @throws Exception Thrown if an error occurs and the {@link
JexlEngine}
* is not silent
*/
Object evaluate(JexlContext context);
@@ -192,7 +192,7 @@ public abstract class JxltEngine {
* @param context The context to use for immediate expression
evaluations
* @return An {@link Expression} or null if an error occurs and the
{@link JexlEngine} is running
* in silent mode
- * @throws Exception if an error occurs and the {@link JexlEngine} is
not in silent mode
+ * @throws Exception Thrown if an error occurs and the {@link
JexlEngine} is not in silent mode
*/
Expression prepare(JexlContext context);
@@ -342,7 +342,7 @@ public abstract class JxltEngine {
* @param info The {@link JexlInfo} source information
* @param expression The {@link Template} string expression
* @return The {@link Expression}, null if silent and an error occurred
- * @throws Exception if an error occurs and the {@link JexlEngine} is not
silent
+ * @throws Exception Thrown if an error occurs and the {@link JexlEngine}
is not silent
*/
public abstract Expression createExpression(JexlInfo info, String
expression);
@@ -354,7 +354,7 @@ public abstract class JxltEngine {
*
* @param expression The {@link Template} string expression
* @return The {@link Expression}, null if silent and an error occurred
- * @throws Exception if an error occurs and the {@link JexlEngine} is not
silent
+ * @throws Exception Thrown if an error occurs and the {@link JexlEngine}
is not silent
*/
public Expression createExpression(final String expression) {
return createExpression(null, expression);
diff --git a/src/main/java/org/apache/commons/jexl3/internal/Interpreter.java
b/src/main/java/org/apache/commons/jexl3/internal/Interpreter.java
index 23803cbc..569b2fbf 100644
--- a/src/main/java/org/apache/commons/jexl3/internal/Interpreter.java
+++ b/src/main/java/org/apache/commons/jexl3/internal/Interpreter.java
@@ -910,7 +910,7 @@ public class Interpreter extends InterpreterBase {
* @param args The annotation arguments
* @param stmt The statement / block that was annotated
* @return The result of statement.call()
- * @throws Exception if anything goes wrong
+ * @throws Exception Thrown if anything goes wrong
*/
protected Object processAnnotation(final String annotation, final Object[]
args, final Callable<Object> stmt) throws Exception {
return context instanceof JexlContext.AnnotationProcessor
diff --git a/src/main/java/org/apache/commons/jexl3/internal/Operator.java
b/src/main/java/org/apache/commons/jexl3/internal/Operator.java
index 4b4ea769..41810ee4 100644
--- a/src/main/java/org/apache/commons/jexl3/internal/Operator.java
+++ b/src/main/java/org/apache/commons/jexl3/internal/Operator.java
@@ -173,7 +173,7 @@ public final class Operator implements
JexlOperator.Uberspect {
* @param right The left argument in the operator
* @param left The right argument in the operator
* @return A boolean is call was possible, null otherwise
- * @throws Exception if invocation fails
+ * @throws Exception Thrown if invocation fails
*/
private Boolean booleanDuckCall(final String methodName, final Object
left, final Object right) throws Exception {
JexlMethod vm = uberspect.getMethod(left, methodName, right);
diff --git
a/src/main/java/org/apache/commons/jexl3/internal/introspection/IndexedType.java
b/src/main/java/org/apache/commons/jexl3/internal/introspection/IndexedType.java
index bef26bd0..ad838af0 100644
---
a/src/main/java/org/apache/commons/jexl3/internal/introspection/IndexedType.java
+++
b/src/main/java/org/apache/commons/jexl3/internal/introspection/IndexedType.java
@@ -59,7 +59,7 @@ public final class IndexedType implements JexlPropertyGet {
*
* @param key The property key
* @return The property value
- * @throws Exception if inner invocation fails
+ * @throws Exception Thrown if inner invocation fails
*/
public Object get(final Object key) throws Exception {
return type.invokeGet(container, key);
@@ -89,7 +89,7 @@ public final class IndexedType implements JexlPropertyGet {
* @param key The property key
* @param value The property value
* @return The invocation result (frequently null)
- * @throws Exception if inner invocation fails
+ * @throws Exception Thrown if inner invocation fails
*/
public Object set(final Object key, final Object value) throws
Exception {
return type.invokeSet(container, key, value);
@@ -167,7 +167,7 @@ public final class IndexedType implements JexlPropertyGet {
* @param object The container instance (not null)
* @param key The property key (not null)
* @return The property value
- * @throws Exception if invocation failed;
+ * @throws Exception Thrown if invocation failed;
* IntrospectionException if a property getter could not be found
*/
Object invokeGet(final Object object, final Object key) throws Exception {
@@ -200,7 +200,7 @@ public final class IndexedType implements JexlPropertyGet {
* @param key The property key (not null)
* @param value The property value (not null)
* @return The result of the method invocation (frequently null)
- * @throws Exception if invocation failed;
+ * @throws Exception Thrown if invocation failed;
* IntrospectionException if a property setter could not be found
*/
Object invokeSet(final Object object, final Object key, final Object
value) throws Exception {
diff --git a/src/main/java/org/apache/commons/jexl3/scripting/Main.java
b/src/main/java/org/apache/commons/jexl3/scripting/Main.java
index 7e8abfef..f39c44af 100644
--- a/src/main/java/org/apache/commons/jexl3/scripting/Main.java
+++ b/src/main/java/org/apache/commons/jexl3/scripting/Main.java
@@ -52,7 +52,7 @@ public class Main {
* The line //q! ends the loop.
*
* @param args (optional) file name to evaluate. Stored in the args
variable.
- * @throws Exception if parsing or IO fail
+ * @throws Exception Thrown if parsing or IO fail
*/
public static void main(final String[] args) throws Exception {
try(BufferedReader in = args.length == 1? read(Paths.get(args[0])) :
read(null);
@@ -92,7 +92,7 @@ public class Main {
*
* @param path The file path or null for stdin
* @return The reader
- * @throws IOException if anything goes wrong
+ * @throws IOException Thrown if anything goes wrong
*/
static BufferedReader read(final Path path) throws IOException {
return new BufferedReader(new InputStreamReader(path == null
diff --git a/src/test/java/org/apache/commons/jexl3/CachePerformanceTest.java
b/src/test/java/org/apache/commons/jexl3/CachePerformanceTest.java
index 178c9cb3..be3df556 100644
--- a/src/test/java/org/apache/commons/jexl3/CachePerformanceTest.java
+++ b/src/test/java/org/apache/commons/jexl3/CachePerformanceTest.java
@@ -130,7 +130,7 @@ class CachePerformanceTest {
* Launches the tasks in parallel.
*
* @param jexl The jexl engine
- * @throws Exception if something goes wrong
+ * @throws Exception Thrown if something goes wrong
*/
protected void runTest(final String name, final JexlEngine jexl) throws
Exception {
final ExecutorService exec = Executors.newFixedThreadPool(THREADS);
diff --git a/src/test/java/org/apache/commons/jexl3/CacheTest.java
b/src/test/java/org/apache/commons/jexl3/CacheTest.java
index d44c6d90..47918ed2 100644
--- a/src/test/java/org/apache/commons/jexl3/CacheTest.java
+++ b/src/test/java/org/apache/commons/jexl3/CacheTest.java
@@ -598,7 +598,7 @@ class CacheTest extends JexlTestCase {
* @param ctask The task / test
* @param loops number of loops to perform
* @param cache whether jexl cache is used or not
- * @throws Exception if anything goes wrong
+ * @throws Exception Thrown if anything goes wrong
*/
@SuppressWarnings("boxing")
void runThreaded(final Class<? extends Task> ctask, int loops, final
boolean cache) throws Exception {
diff --git a/src/test/java/org/apache/commons/jexl3/ScriptCallableTest.java
b/src/test/java/org/apache/commons/jexl3/ScriptCallableTest.java
index 3a6810cc..9e0b9785 100644
--- a/src/test/java/org/apache/commons/jexl3/ScriptCallableTest.java
+++ b/src/test/java/org/apache/commons/jexl3/ScriptCallableTest.java
@@ -140,7 +140,7 @@ class ScriptCallableTest extends JexlTestCase {
/**
* Redundant test with previous ones but impervious to JEXL engine
configuration.
*
- * @throws Exception if there is a regression
+ * @throws Exception Thrown if there is a regression
*/
private void runInterrupt(final JexlEngine jexl) throws Exception {
List<Runnable> lr = null;
diff --git a/src/test/java/org/apache/commons/jexl3/junit/Asserter.java
b/src/test/java/org/apache/commons/jexl3/junit/Asserter.java
index 5d4ff563..80565d76 100644
--- a/src/test/java/org/apache/commons/jexl3/junit/Asserter.java
+++ b/src/test/java/org/apache/commons/jexl3/junit/Asserter.java
@@ -67,7 +67,7 @@ public class Asserter {
*
* @param expression is the JEXL expression to evaluate
* @param expected is the expected value of the expression
- * @throws Exception if the expression could not be evaluationed or an
assertion
+ * @throws Exception Thrown if the expression could not be evaluationed or
an assertion
* fails
*/
public void assertExpression(final String expression, final Object
expected, final Object... args) throws Exception {
@@ -103,7 +103,7 @@ public class Asserter {
* The engine is temporarily switched to strict * verbose to maximize
error detection abilities.
* @param expression The expression that should fail
* @param matchException The exception message pattern
- * @throws Exception if the expression did not fail or the exception did
not match the expected pattern
+ * @throws Exception Thrown if the expression did not fail or the
exception did not match the expected pattern
*/
public void failExpression(final String expression, final String
matchException) throws Exception {
failExpression(expression, matchException, String::matches);
