[prev in list] [next in list] [prev in thread] [next in thread]
List: jakarta-commons-dev
Subject: svn commit: r1040818 - in /commons/proper/math/trunk/src:
From: erans () apache ! org
Date: 2010-11-30 22:57:15
Message-ID: 20101130225715.2852F23889ED () eris ! apache ! org
[Download RAW message or body]
Author: erans
Date: Tue Nov 30 22:57:14 2010
New Revision: 1040818
URL: http://svn.apache.org/viewvc?rev=1040818&view=rev
Log:
MATH-447
New "MathRuntimeException" base class.
"MathUserException" shares the same functionality (and thus is made a subclass
of the former).
Added:
commons/proper/math/trunk/src/main/java/org/apache/commons/math/exception/MathRuntimeException.java \
(with props) Modified:
commons/proper/math/trunk/src/main/java/org/apache/commons/math/exception/MathUserException.java
commons/proper/math/trunk/src/site/xdoc/changes.xml
Added: commons/proper/math/trunk/src/main/java/org/apache/commons/math/exception/MathRuntimeException.java
URL: http://svn.apache.org/viewvc/commons/proper/math/trunk/src/main/java/org/apache/commons/math/exception/MathRuntimeException.java?rev=1040818&view=auto
==============================================================================
--- commons/proper/math/trunk/src/main/java/org/apache/commons/math/exception/MathRuntimeException.java \
(added)
+++ commons/proper/math/trunk/src/main/java/org/apache/commons/math/exception/MathRuntimeException.java \
Tue Nov 30 22:57:14 2010 @@ -0,0 +1,106 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.math.exception;
+
+import java.util.Locale;
+
+import org.apache.commons.math.exception.util.ArgUtils;
+import org.apache.commons.math.exception.util.Localizable;
+import org.apache.commons.math.exception.util.MessageFactory;
+
+/**
+ * This class is intended as a base class for exceptions that must wrap
+ * low-level exceptions in order to propagate an exception that better
+ * corresponds to the high-level action that triggered the problem.
+ *
+ * @since 3.0
+ * @version $Revision$ $Date$
+ */
+public class MathRuntimeException extends RuntimeException
+ implements MathThrowable {
+ /** Serializable version Id. */
+ private static final long serialVersionUID = -6024911025449780478L;
+ /**
+ * Pattern used to build the specific part of the message (problem description).
+ */
+ private final Localizable specific;
+ /**
+ * Pattern used to build the general part of the message (problem description).
+ */
+ private final Localizable general;
+ /**
+ * Arguments used to build the message.
+ */
+ private final Object[] arguments;
+
+ /**
+ * Builds an exception from two patterns (specific and general) and
+ * an argument list.
+ *
+ * @param cause Cause of the error (may be null).
+ * @param specific Format specifier for the specific part (may be null).
+ * @param general Format specifier for the general part (may be null).
+ * @param arguments Format arguments. They will be substituted in
+ * <em>both</em> the {@code general} and {@code specific} format specifiers.
+ */
+ protected MathRuntimeException(final Throwable cause,
+ final Localizable specific,
+ final Localizable general,
+ final Object ... arguments) {
+ super(cause);
+ this.specific = specific;
+ this.general = general;
+ this.arguments = ArgUtils.flatten(arguments);
+ }
+
+ /** {@inheritDoc} */
+ public Localizable getSpecificPattern() {
+ return specific;
+ }
+
+ /** {@inheritDoc} */
+ public Localizable getGeneralPattern() {
+ return general;
+ }
+
+ /** {@inheritDoc} */
+ public Object[] getArguments() {
+ return arguments.clone();
+ }
+
+ /**
+ * Get the message in a specified locale.
+ *
+ * @param locale Locale in which the message should be translated.
+ * @return the localized message.
+ */
+ public String getMessage(final Locale locale) {
+ return MessageFactory.buildMessage(locale, specific, general, arguments);
+ }
+
+ /** {@inheritDoc} */
+ @Override
+ public String getMessage() {
+ return getMessage(Locale.US);
+ }
+
+ /** {@inheritDoc} */
+ @Override
+ public String getLocalizedMessage() {
+ return getMessage(Locale.getDefault());
+ }
+}
Propchange: commons/proper/math/trunk/src/main/java/org/apache/commons/math/exception/MathRuntimeException.java
------------------------------------------------------------------------------
svn:eol-style = native
Modified: commons/proper/math/trunk/src/main/java/org/apache/commons/math/exception/MathUserException.java
URL: http://svn.apache.org/viewvc/commons/proper/math/trunk/src/main/java/org/apache/c \
ommons/math/exception/MathUserException.java?rev=1040818&r1=1040817&r2=1040818&view=diff
==============================================================================
--- commons/proper/math/trunk/src/main/java/org/apache/commons/math/exception/MathUserException.java \
(original)
+++ commons/proper/math/trunk/src/main/java/org/apache/commons/math/exception/MathUserException.java \
Tue Nov 30 22:57:14 2010 @@ -18,10 +18,8 @@ package org.apache.commons.math.exceptio
import java.util.Locale;
-import org.apache.commons.math.exception.util.ArgUtils;
import org.apache.commons.math.exception.util.Localizable;
import org.apache.commons.math.exception.util.LocalizedFormats;
-import org.apache.commons.math.exception.util.MessageFactory;
/**
* This class is intended as a sort of communication channel between
@@ -32,21 +30,9 @@ import org.apache.commons.math.exception
* @since 2.2
* @version $Revision$ $Date$
*/
-public class MathUserException extends RuntimeException implements MathThrowable {
+public class MathUserException extends MathRuntimeException {
/** Serializable version Id. */
private static final long serialVersionUID = -6024911025449780478L;
- /**
- * Pattern used to build the specific part of the message (problem description).
- */
- private final Localizable specific;
- /**
- * Pattern used to build the general part of the message (problem description).
- */
- private final Localizable general;
- /**
- * Arguments used to build the message.
- */
- private final Object[] arguments;
/**
* Build an exception with a default message.
@@ -110,46 +96,6 @@ public class MathUserException extends R
public MathUserException(final Throwable cause,
final Localizable specific, final Localizable general,
final Object ... arguments) {
- super(cause);
- this.specific = specific;
- this.general = general;
- this.arguments = ArgUtils.flatten(arguments);
- }
-
- /** {@inheritDoc} */
- public Localizable getSpecificPattern() {
- return specific;
- }
-
- /** {@inheritDoc} */
- public Localizable getGeneralPattern() {
- return general;
- }
-
- /** {@inheritDoc} */
- public Object[] getArguments() {
- return arguments.clone();
- }
-
- /**
- * Get the message in a specified locale.
- *
- * @param locale Locale in which the message should be translated.
- * @return the localized message.
- */
- public String getMessage(final Locale locale) {
- return MessageFactory.buildMessage(locale, specific, general, arguments);
- }
-
- /** {@inheritDoc} */
- @Override
- public String getMessage() {
- return getMessage(Locale.US);
- }
-
- /** {@inheritDoc} */
- @Override
- public String getLocalizedMessage() {
- return getMessage(Locale.getDefault());
+ super(cause, specific, general, arguments);
}
}
Modified: commons/proper/math/trunk/src/site/xdoc/changes.xml
URL: http://svn.apache.org/viewvc/commons/proper/math/trunk/src/site/xdoc/changes.xml?rev=1040818&r1=1040817&r2=1040818&view=diff
==============================================================================
--- commons/proper/math/trunk/src/site/xdoc/changes.xml (original)
+++ commons/proper/math/trunk/src/site/xdoc/changes.xml Tue Nov 30 22:57:14 2010
@@ -52,6 +52,10 @@ The <action> type attribute can be add,u
If the output is not quite correct, check for invisible trailing spaces!
-->
<release version="3.0" date="TBD" description="TBD">
+ <action dev="erans" type="fix" issue="MATH-447">
+ Created a "MathRuntimeException" to serve as a base class for exception
+ types that need to wrap another (lower-level) exception.
+ </action>
<action dev="erans" type="update" issue="MATH-430">
Replaced "ComposableFunction" and "BinaryFunction" (in package "analysis")
by a set of utilities in the new class "FunctionUtils" together with
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic