diff --git a/api/src/main/java/org/apache/commons/chain2/Chain.java b/api/src/main/java/org/apache/commons/chain2/Chain.java index 83d6d6ea..4ff3dd23 100644 --- a/api/src/main/java/org/apache/commons/chain2/Chain.java +++ b/api/src/main/java/org/apache/commons/chain2/Chain.java @@ -66,9 +66,9 @@ public interface Chain> extends Command { * @param the {@link Command} type to be added in the {@link Chain} * @param command The {@link Command} to be added * - * @exception IllegalArgumentException if command + * @throws IllegalArgumentException if command * is null - * @exception IllegalStateException if this {@link Chain} has already + * @throws IllegalStateException if this {@link Chain} has already * been executed at least once, so no further configuration is allowed */ > void addCommand(CMD command); @@ -103,7 +103,7 @@ public interface Chain> extends Command { * @param context The {@link Context} to be processed by this * {@link Chain} * - * @exception IllegalArgumentException if context + * @throws IllegalArgumentException if context * is null * * @return {@link Processing#FINISHED} if the processing of this context diff --git a/api/src/main/java/org/apache/commons/chain2/Command.java b/api/src/main/java/org/apache/commons/chain2/Command.java index fcfad55c..2932b86d 100644 --- a/api/src/main/java/org/apache/commons/chain2/Command.java +++ b/api/src/main/java/org/apache/commons/chain2/Command.java @@ -94,9 +94,9 @@ public interface Command> { * @param context The {@link Context} to be processed by this * {@link Command} * - * @exception ChainException general purpose exception return + * @throws ChainException general purpose exception return * to indicate abnormal termination - * @exception IllegalArgumentException if context + * @throws IllegalArgumentException if context * is null * * @return {@link Processing#FINISHED} if the processing of this contex diff --git a/api/src/main/java/org/apache/commons/chain2/Filter.java b/api/src/main/java/org/apache/commons/chain2/Filter.java index 848c47e8..6c13dc06 100644 --- a/api/src/main/java/org/apache/commons/chain2/Filter.java +++ b/api/src/main/java/org/apache/commons/chain2/Filter.java @@ -57,7 +57,7 @@ public interface Filter> extends Command { * by the last {@link Command} that was executed; otherwise * null * - * @exception IllegalArgumentException if context + * @throws IllegalArgumentException if context * is null * * @return If a non-null exception was "handled" by this diff --git a/apps/example2/src/main/java/org/apache/commons/chain2/apps/example/ExampleServlet.java b/apps/example2/src/main/java/org/apache/commons/chain2/apps/example/ExampleServlet.java index 1f693950..e114d305 100644 --- a/apps/example2/src/main/java/org/apache/commons/chain2/apps/example/ExampleServlet.java +++ b/apps/example2/src/main/java/org/apache/commons/chain2/apps/example/ExampleServlet.java @@ -49,7 +49,7 @@ public class ExampleServlet extends HttpServlet { /** *

Cache the name of the servlet.

* - * @exception ServletException if an initialization error occurs + * @throws ServletException if an initialization error occurs */ public void init() throws ServletException { super.init(); @@ -69,7 +69,7 @@ public void init() throws ServletException { * @param request The request we are processing * @param response The response we are creating * - * @exception IOException if an input/output error occurs + * @throws IOException if an input/output error occurs */ public void service(HttpServletRequest request, HttpServletResponse response) diff --git a/base/src/main/java/org/apache/commons/chain2/base/LookupCommand.java b/base/src/main/java/org/apache/commons/chain2/base/LookupCommand.java index d9d11902..b525558d 100644 --- a/base/src/main/java/org/apache/commons/chain2/base/LookupCommand.java +++ b/base/src/main/java/org/apache/commons/chain2/base/LookupCommand.java @@ -263,7 +263,7 @@ public void setIgnorePostprocessResult(boolean ignorePostprocessResult) { * * @param context The context for this request * - * @exception IllegalArgumentException if no such {@link Command} + * @throws IllegalArgumentException if no such {@link Command} * can be found and the optional property is set * to false * @return the result of executing the looked-up command, or @@ -316,7 +316,7 @@ public boolean postprocess(C context, Exception exception) { * * @param context {@link Context} for this request * @return The catalog. - * @exception IllegalArgumentException if no {@link Catalog} + * @throws IllegalArgumentException if no {@link Catalog} * can be found * * @since Chain 1.2 @@ -353,7 +353,7 @@ protected Catalog getCatalog(C context) { * * @param context {@link Context} for this request * @return The looked-up Command. - * @exception IllegalArgumentException if no such {@link Command} + * @throws IllegalArgumentException if no such {@link Command} * can be found and the optional property is set * to false */ diff --git a/base/src/main/java/org/apache/commons/chain2/impl/CatalogBase.java b/base/src/main/java/org/apache/commons/chain2/impl/CatalogBase.java index 990ed6ee..3941fe82 100644 --- a/base/src/main/java/org/apache/commons/chain2/impl/CatalogBase.java +++ b/base/src/main/java/org/apache/commons/chain2/impl/CatalogBase.java @@ -59,7 +59,7 @@ public CatalogBase() { } * * @param commands Map of Commands. * - * @exception IllegalArgumentException if commands + * @throws IllegalArgumentException if commands * is null * * @since Chain 1.1 diff --git a/base/src/main/java/org/apache/commons/chain2/impl/ChainBase.java b/base/src/main/java/org/apache/commons/chain2/impl/ChainBase.java index 4b8b8e42..77baf616 100644 --- a/base/src/main/java/org/apache/commons/chain2/impl/ChainBase.java +++ b/base/src/main/java/org/apache/commons/chain2/impl/ChainBase.java @@ -53,7 +53,7 @@ public ChainBase() { * * @param command The {@link Command} to be configured * - * @exception IllegalArgumentException if command + * @throws IllegalArgumentException if command * is null */ public ChainBase(Command command) { @@ -66,7 +66,7 @@ public ChainBase(Command command) { * * @param commands The {@link Command Commands} to be configured * - * @exception IllegalArgumentException if commands, + * @throws IllegalArgumentException if commands, * or one of the individual {@link Command} elements, * is null */ @@ -85,7 +85,7 @@ public ChainBase(Command... commands) { * * @param commands The {@link Command}s to be configured * - * @exception IllegalArgumentException if commands, + * @throws IllegalArgumentException if commands, * or one of the individual {@link Command} elements, * is null */ @@ -121,9 +121,9 @@ public ChainBase(Collection> commands) { * @param the {@link Command} type to be added in the {@link Chain} * @param command The {@link Command} to be added * - * @exception IllegalArgumentException if command + * @throws IllegalArgumentException if command * is null - * @exception IllegalStateException if no further configuration is allowed + * @throws IllegalStateException if no further configuration is allowed */ public > void addCommand(CMD command) { if (command == null) { diff --git a/base/src/main/java/org/apache/commons/chain2/impl/ContextBase.java b/base/src/main/java/org/apache/commons/chain2/impl/ContextBase.java index 4888ba87..9c01e070 100644 --- a/base/src/main/java/org/apache/commons/chain2/impl/ContextBase.java +++ b/base/src/main/java/org/apache/commons/chain2/impl/ContextBase.java @@ -72,9 +72,9 @@ public ContextBase() { * * @param map Map whose key-value pairs are added * - * @exception IllegalArgumentException if an exception is thrown + * @throws IllegalArgumentException if an exception is thrown * writing a local property value - * @exception UnsupportedOperationException if a local property does not + * @throws UnsupportedOperationException if a local property does not * have a write method. */ public ContextBase(Map map) { @@ -162,7 +162,7 @@ public void clear() { * @param value the value look for in the context. * @return true if found in this context otherwise * false. - * @exception IllegalArgumentException if a property getter + * @throws IllegalArgumentException if a property getter * throws an exception */ @Override @@ -219,9 +219,9 @@ public Set> entrySet() { * @param key Key of the value to be returned * @return The value for the specified key. * - * @exception IllegalArgumentException if an exception is thrown + * @throws IllegalArgumentException if an exception is thrown * reading this local property value - * @exception UnsupportedOperationException if this local property does not + * @throws UnsupportedOperationException if this local property does not * have a read method. */ @Override @@ -289,9 +289,9 @@ public Set keySet() { * @param value New value to be stored * @return The value added to the Context. * - * @exception IllegalArgumentException if an exception is thrown + * @throws IllegalArgumentException if an exception is thrown * reading or writing this local property value - * @exception UnsupportedOperationException if this local property does not + * @throws UnsupportedOperationException if this local property does not * have both a read method and a write method */ @Override @@ -338,9 +338,9 @@ public Object put(String key, Object value) { * @param map Map containing key-value pairs to store * (or replace) * - * @exception IllegalArgumentException if an exception is thrown + * @throws IllegalArgumentException if an exception is thrown * reading or writing a local property value - * @exception UnsupportedOperationException if a local property does not + * @throws UnsupportedOperationException if a local property does not * have both a read method and a write method */ @Override @@ -358,7 +358,7 @@ public void putAll(Map map) { * @param key Key to be removed * @return The value removed from the Context. * - * @exception UnsupportedOperationException if the specified + * @throws UnsupportedOperationException if the specified * key matches the name of a local property */ @Override @@ -424,9 +424,9 @@ private Map.Entry entry(String key) { * the {@link Context} implementation class.

* * - * @exception IllegalArgumentException if an exception is thrown + * @throws IllegalArgumentException if an exception is thrown * writing this local property value - * @exception UnsupportedOperationException if this local property does not + * @throws UnsupportedOperationException if this local property does not * have a write method. */ private void initialize() { @@ -459,9 +459,9 @@ private void initialize() { * @param descriptor PropertyDescriptor for the * specified property * - * @exception IllegalArgumentException if an exception is thrown + * @throws IllegalArgumentException if an exception is thrown * reading this local property value - * @exception UnsupportedOperationException if this local property does not + * @throws UnsupportedOperationException if this local property does not * have a read method. */ private Object readProperty(PropertyDescriptor descriptor) { @@ -487,7 +487,7 @@ private Object readProperty(PropertyDescriptor descriptor) { * * @param entry Key-value pair to be removed * - * @exception UnsupportedOperationException if the specified key + * @throws UnsupportedOperationException if the specified key * identifies a property instead of an attribute */ private boolean remove(Map.Entry entry) { @@ -518,9 +518,9 @@ private Iterator valuesIterator() { * @param value The new value for this property (must be of the * correct type) * - * @exception IllegalArgumentException if an exception is thrown + * @throws IllegalArgumentException if an exception is thrown * writing this local property value - * @exception UnsupportedOperationException if this local property does not + * @throws UnsupportedOperationException if this local property does not * have a write method. */ private void writeProperty(PropertyDescriptor descriptor, Object value) { diff --git a/configuration/api/src/main/java/org/apache/commons/chain2/config/ConfigParser.java b/configuration/api/src/main/java/org/apache/commons/chain2/config/ConfigParser.java index 748ebee0..66dc98b7 100644 --- a/configuration/api/src/main/java/org/apache/commons/chain2/config/ConfigParser.java +++ b/configuration/api/src/main/java/org/apache/commons/chain2/config/ConfigParser.java @@ -47,7 +47,7 @@ public interface ConfigParser { * @param Type of the context associated with this command * @param url URL of the configuration document to be parsed * @return a CatalogFactory instance parsed from the given location - * @exception ChainConfigurationException if a parsing error occurs + * @throws ChainConfigurationException if a parsing error occurs */ > CatalogFactory parse(URL url) throws ChainConfigurationException; diff --git a/configuration/xml/src/main/java/org/apache/commons/chain2/config/xml/XmlConfigParser.java b/configuration/xml/src/main/java/org/apache/commons/chain2/config/xml/XmlConfigParser.java index 71906181..28f652bf 100644 --- a/configuration/xml/src/main/java/org/apache/commons/chain2/config/xml/XmlConfigParser.java +++ b/configuration/xml/src/main/java/org/apache/commons/chain2/config/xml/XmlConfigParser.java @@ -145,7 +145,7 @@ public void setUseContextClassLoader(boolean useContextClassLoader) { * @param Type of the context associated with this command * @param url URL of the XML document to be parsed * @return a CatalogFactory instance parsed from the given location - * @exception ChainConfigurationException if a parsing error occurs + * @throws ChainConfigurationException if a parsing error occurs */ public > CatalogFactory parse(URL url) { // Prepare our Digester instance diff --git a/web/src/main/java/org/apache/commons/chain2/web/servlet/ChainProcessor.java b/web/src/main/java/org/apache/commons/chain2/web/servlet/ChainProcessor.java index 78e8387d..e62f367b 100644 --- a/web/src/main/java/org/apache/commons/chain2/web/servlet/ChainProcessor.java +++ b/web/src/main/java/org/apache/commons/chain2/web/servlet/ChainProcessor.java @@ -132,7 +132,7 @@ public void destroy() { /** *

Cache the name of the command we should execute for each request.

* - * @exception ServletException if an initialization error occurs + * @throws ServletException if an initialization error occurs */ @Override public void init() throws ServletException { @@ -153,8 +153,8 @@ public void init() throws ServletException { * @param request The request we are processing * @param response The response we are creating * - * @exception IOException if an input/output error occurs - * @exception ServletException if a servlet exception occurs + * @throws IOException if an input/output error occurs + * @throws ServletException if a servlet exception occurs */ @Override public void service(HttpServletRequest request, HttpServletResponse response) diff --git a/web/src/main/java/org/apache/commons/chain2/web/servlet/PathInfoMapper.java b/web/src/main/java/org/apache/commons/chain2/web/servlet/PathInfoMapper.java index f4f5e167..d20bf400 100644 --- a/web/src/main/java/org/apache/commons/chain2/web/servlet/PathInfoMapper.java +++ b/web/src/main/java/org/apache/commons/chain2/web/servlet/PathInfoMapper.java @@ -65,7 +65,7 @@ protected String getCommandName(ServletWebContext context) { * * @param context {@link Context} for this request * @return The catalog. - * @exception IllegalArgumentException if no {@link Catalog} + * @throws IllegalArgumentException if no {@link Catalog} * can be found * * @since Chain 1.2 diff --git a/web/src/main/java/org/apache/commons/chain2/web/servlet/RequestParameterMapper.java b/web/src/main/java/org/apache/commons/chain2/web/servlet/RequestParameterMapper.java index 5c62eec1..8991a209 100644 --- a/web/src/main/java/org/apache/commons/chain2/web/servlet/RequestParameterMapper.java +++ b/web/src/main/java/org/apache/commons/chain2/web/servlet/RequestParameterMapper.java @@ -90,7 +90,7 @@ protected String getCommandName(ServletWebContext context) { * * @param context {@link Context} for this request * @return The catalog. - * @exception IllegalArgumentException if no {@link Catalog} + * @throws IllegalArgumentException if no {@link Catalog} * can be found * * @since Chain 1.2 diff --git a/web/src/main/java/org/apache/commons/chain2/web/servlet/ServletPathMapper.java b/web/src/main/java/org/apache/commons/chain2/web/servlet/ServletPathMapper.java index cd65a4cb..cd5679d6 100644 --- a/web/src/main/java/org/apache/commons/chain2/web/servlet/ServletPathMapper.java +++ b/web/src/main/java/org/apache/commons/chain2/web/servlet/ServletPathMapper.java @@ -65,7 +65,7 @@ protected String getCommandName(ServletWebContext swcontext) { * * @param context {@link Context} for this request * @return The catalog. - * @exception IllegalArgumentException if no {@link Catalog} + * @throws IllegalArgumentException if no {@link Catalog} * can be found * * @since Chain 1.2