ggregory 2003/08/21 08:52:55
Modified: lang/src/java/org/apache/commons/lang RandomStringUtils.java
ObjectUtils.java SystemUtils.java
lang/src/java/org/apache/commons/lang/builder
ToStringStyle.java StandardToStringStyle.java
HashCodeBuilder.java EqualsBuilder.java
ToStringBuilder.java
lang/src/java/org/apache/commons/lang/enum Enum.java
lang/src/java/org/apache/commons/lang/exception
ExceptionUtils.java
Log:
Add @since 2.0 tags based on
http://www.apache.org/~bayard/commons-lang-2.0/Commons-Lang-1.0.1-to-2.0/missingSinces.txt
Revision Changes Path
1.23 +2 -1
jakarta-commons/lang/src/java/org/apache/commons/lang/RandomStringUtils.java
Index: RandomStringUtils.java
===================================================================
RCS file:
/home/cvs/jakarta-commons/lang/src/java/org/apache/commons/lang/RandomStringUtils.java,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- RandomStringUtils.java 18 Aug 2003 02:22:23 -0000 1.22
+++ RandomStringUtils.java 21 Aug 2003 15:52:54 -0000 1.23
@@ -250,6 +250,7 @@
* @throws ArrayIndexOutOfBoundsException if there are not
* <code>(end - start) + 1</code> characters in the set array.
* @throws IllegalArgumentException if <code>count</code> < 0.
+ * @since 2.0
*/
public static String random(int count, int start, int end, boolean letters,
boolean numbers, char[] chars, Random random) {
if (count == 0) {
1.20 +4 -1
jakarta-commons/lang/src/java/org/apache/commons/lang/ObjectUtils.java
Index: ObjectUtils.java
===================================================================
RCS file:
/home/cvs/jakarta-commons/lang/src/java/org/apache/commons/lang/ObjectUtils.java,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- ObjectUtils.java 18 Aug 2003 02:22:23 -0000 1.19
+++ ObjectUtils.java 21 Aug 2003 15:52:54 -0000 1.20
@@ -193,6 +193,7 @@
* @param object the object to create a toString for, may be <code>null</code>
* @return the default toString text, or <code>null</code> if
* <code>null</code> passed in
+ * @since 2.0
*/
public static StringBuffer appendIdentityToString(StringBuffer buffer, Object
object) {
if (object == null) {
@@ -224,6 +225,7 @@
* @see String#valueOf(Object)
* @param obj the Object to <code>toString</code>, may be null
* @return the passed in Object's toString, or nullStr if <code>null</code>
input
+ * @since 2.0
*/
public static String toString(Object obj) {
return (obj == null ? "" : obj.toString());
@@ -246,6 +248,7 @@
* @param obj the Object to <code>toString</code>, may be null
* @param nullStr the String to return if <code>null</code> input, may be null
* @return the passed in Object's toString, or nullStr if <code>null</code>
input
+ * @since 2.0
*/
public static String toString(Object obj, String nullStr) {
return (obj == null ? nullStr : obj.toString());
1.21 +45 -6
jakarta-commons/lang/src/java/org/apache/commons/lang/SystemUtils.java
Index: SystemUtils.java
===================================================================
RCS file:
/home/cvs/jakarta-commons/lang/src/java/org/apache/commons/lang/SystemUtils.java,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- SystemUtils.java 18 Aug 2003 02:22:23 -0000 1.20
+++ SystemUtils.java 21 Aug 2003 15:52:54 -0000 1.21
@@ -83,7 +83,8 @@
* <p>Defaults to <code>null</code> if the runtime does not have
* security access to read this property or the property does not exist.</p>
*
- * @since Java version 1.2.
+ * @since 2.0
+ * @since Java 1.2.
*/
public static final String FILE_ENCODING = getSystemProperty("file.encoding");
@@ -94,7 +95,7 @@
* <p>Defaults to <code>null</code> if the runtime does not have
* security access to read this property or the property does not exist.</p>
*
- * @since Java version 1.1.
+ * @since Java 1.1.
*/
public static final String FILE_SEPARATOR = getSystemProperty("file.separator");
@@ -104,7 +105,7 @@
* <p>Defaults to <code>null</code> if the runtime does not have
* security access to read this property or the property does not exist.</p>
*
- * @since Java version 1.1.
+ * @since Java 1.1.
*/
public static final String JAVA_CLASS_PATH =
getSystemProperty("java.class.path");
@@ -115,7 +116,7 @@
* <p>Defaults to <code>null</code> if the runtime does not have
* security access to read this property or the property does not exist.</p>
*
- * @since Java version 1.1.
+ * @since Java 1.1.
*/
public static final String JAVA_CLASS_VERSION =
getSystemProperty("java.class.version");
@@ -126,7 +127,7 @@
* <p>Defaults to <code>null</code> if the runtime does not have
* security access to read this property or the property does not exist.</p>
*
- * @since Java version 1.2. Not used in Sun versions after 1.2.
+ * @since Java 1.2. Not used in Sun versions after 1.2.
*/
public static final String JAVA_COMPILER = getSystemProperty("java.compiler");
@@ -179,6 +180,7 @@
* <p>Defaults to <code>null</code> if the runtime does not have
* security access to read this property or the property does not exist.</p>
*
+ * @since 2.0
* @since Java 1.3
*/
public static final String JAVA_RUNTIME_NAME =
getSystemProperty("java.runtime.name");
@@ -190,6 +192,7 @@
* <p>Defaults to <code>null</code> if the runtime does not have
* security access to read this property or the property does not exist.</p>
*
+ * @since 2.0
* @since Java 1.3
*/
public static final String JAVA_RUNTIME_VERSION =
getSystemProperty("java.runtime.version");
@@ -264,6 +267,7 @@
* <p>Defaults to <code>null</code> if the runtime does not have
* security access to read this property or the property does not exist.</p>
*
+ * @since 2.0
* @since Java 1.2
*/
public static final String JAVA_VM_INFO = getSystemProperty("java.vm.info");
@@ -394,6 +398,7 @@
* <p>Defaults to <code>null</code> if the runtime does not have
* security access to read this property or the property does not exist.</p>
*
+ * @since 2.0
* @since Java 1.2
*/
public static final String USER_COUNTRY =
@@ -428,6 +433,7 @@
* <p>Defaults to <code>null</code> if the runtime does not have
* security access to read this property or the property does not exist.</p>
*
+ * @since 2.0
* @since Java 1.2
*/
public static final String USER_LANGUAGE = getSystemProperty("user.language");
@@ -531,6 +537,8 @@
*
* <p>The field will return <code>false</code> if <code>OS_NAME</code> is
* <code>null</code>.</p>
+ *
+ * @since 2.0
*/
public static final boolean IS_OS_AIX = getOSMatches("AIX");
@@ -539,6 +547,8 @@
*
* <p>The field will return <code>false</code> if <code>OS_NAME</code> is
* <code>null</code>.</p>
+ *
+ * @since 2.0
*/
public static final boolean IS_OS_HP_UX = getOSMatches("HP-UX");
@@ -547,6 +557,8 @@
*
* <p>The field will return <code>false</code> if <code>OS_NAME</code> is
* <code>null</code>.</p>
+ *
+ * @since 2.0
*/
public static final boolean IS_OS_IRIX = getOSMatches("Irix");
@@ -555,6 +567,8 @@
*
* <p>The field will return <code>false</code> if <code>OS_NAME</code> is
* <code>null</code>.</p>
+ *
+ * @since 2.0
*/
public static final boolean IS_OS_LINUX = getOSMatches("Linux") ||
getOSMatches("LINUX");
@@ -563,6 +577,8 @@
*
* <p>The field will return <code>false</code> if <code>OS_NAME</code> is
* <code>null</code>.</p>
+ *
+ * @since 2.0
*/
public static final boolean IS_OS_MAC = getOSMatches("Mac");
@@ -571,6 +587,8 @@
*
* <p>The field will return <code>false</code> if <code>OS_NAME</code> is
* <code>null</code>.</p>
+ *
+ * @since 2.0
*/
public static final boolean IS_OS_MAC_OSX = getOSMatches("Mac OS X");
@@ -579,6 +597,8 @@
*
* <p>The field will return <code>false</code> if <code>OS_NAME</code> is
* <code>null</code>.</p>
+ *
+ * @since 2.0
*/
public static final boolean IS_OS_OS2 = getOSMatches("OS/2");
@@ -587,6 +607,8 @@
*
* <p>The field will return <code>false</code> if <code>OS_NAME</code> is
* <code>null</code>.</p>
+ *
+ * @since 2.0
*/
public static final boolean IS_OS_SOLARIS = getOSMatches("Solaris");
@@ -595,6 +617,8 @@
*
* <p>The field will return <code>false</code> if <code>OS_NAME</code> is
* <code>null</code>.</p>
+ *
+ * @since 2.0
*/
public static final boolean IS_OS_SUN_OS = getOSMatches("SunOS");
@@ -603,6 +627,8 @@
*
* <p>The field will return <code>false</code> if <code>OS_NAME</code> is
* <code>null</code>.</p>
+ *
+ * @since 2.0
*/
public static final boolean IS_OS_WINDOWS = getOSMatches("Windows");
@@ -611,6 +637,8 @@
*
* <p>The field will return <code>false</code> if <code>OS_NAME</code> is
* <code>null</code>.</p>
+ *
+ * @since 2.0
*/
public static final boolean IS_OS_WINDOWS_2000 = getOSMatches("Windows", "5.0");
@@ -619,6 +647,8 @@
*
* <p>The field will return <code>false</code> if <code>OS_NAME</code> is
* <code>null</code>.</p>
+ *
+ * @since 2.0
*/
public static final boolean IS_OS_WINDOWS_95 = getOSMatches("Windows 9", "4.0");
// JDK 1.2 running on Windows98 returns 'Windows 95', hence the above
@@ -628,6 +658,8 @@
*
* <p>The field will return <code>false</code> if <code>OS_NAME</code> is
* <code>null</code>.</p>
+ *
+ * @since 2.0
*/
public static final boolean IS_OS_WINDOWS_98 = getOSMatches("Windows 9", "4.1");
// JDK 1.2 running on Windows98 returns 'Windows 95', hence the above
@@ -637,6 +669,8 @@
*
* <p>The field will return <code>false</code> if <code>OS_NAME</code> is
* <code>null</code>.</p>
+ *
+ * @since 2.0
*/
public static final boolean IS_OS_WINDOWS_ME = getOSMatches("Windows", "4.9");
// JDK 1.2 running on WindowsME may return 'Windows 95', hence the above
@@ -646,6 +680,8 @@
*
* <p>The field will return <code>false</code> if <code>OS_NAME</code> is
* <code>null</code>.</p>
+ *
+ * @since 2.0
*/
public static final boolean IS_OS_WINDOWS_NT = getOSMatches("Windows NT");
// Windows 2000 returns 'Windows 2000' but may suffer from same JDK1.2 problem
@@ -655,6 +691,8 @@
*
* <p>The field will return <code>false</code> if <code>OS_NAME</code> is
* <code>null</code>.</p>
+ *
+ * @since 2.0
*/
public static final boolean IS_OS_WINDOWS_XP = getOSMatches("Windows", "5.1");
// Windows XP returns 'Windows 2000' just for fun...
@@ -835,6 +873,7 @@
* @param requiredVersion the required version, for example 131
* @return <code>true</code> if the actual version is equal or greater
* than the required version
+ * @since 2.0
*/
public static boolean isJavaVersionAtLeast(int requiredVersion) {
return (JAVA_VERSION_INT >= requiredVersion);
1.25 +10 -1
jakarta-commons/lang/src/java/org/apache/commons/lang/builder/ToStringStyle.java
Index: ToStringStyle.java
===================================================================
RCS file:
/home/cvs/jakarta-commons/lang/src/java/org/apache/commons/lang/builder/ToStringStyle.java,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- ToStringStyle.java 18 Aug 2003 02:22:24 -0000 1.24
+++ ToStringStyle.java 21 Aug 2003 15:52:54 -0000 1.25
@@ -221,6 +221,7 @@
*
* @param buffer the <code>StringBuffer</code> to populate
* @param toString the additional <code>toString</code>
+ * @since 2.0
*/
public void appendToString(StringBuffer buffer, String toString) {
if (toString != null) {
@@ -271,6 +272,7 @@
* <p>Remove the last field separator from the buffer.</p>
*
* @param buffer the <code>StringBuffer</code> to populate
+ * @since 2.0
*/
protected void removeLastFieldSeparator(StringBuffer buffer) {
int len = buffer.length();
@@ -762,6 +764,7 @@
* @param fieldName the field name, typically not used as already appended
* @param array the array to add to the <code>toString</code>,
* not <code>null</code>
+ * @since 2.0
*/
protected void reflectionAppendArrayDetail(StringBuffer buffer, String
fieldName, Object array) {
buffer.append(arrayStart);
@@ -1459,6 +1462,7 @@
* <p>Gets whether to output short or long class names.</p>
*
* @return the current useShortClassName flag
+ * @since 2.0
*/
protected boolean isUseShortClassName() {
return useShortClassName;
@@ -1479,6 +1483,7 @@
* <p>Sets whether to output short or long class names.</p>
*
* @param useShortClassName the new useShortClassName flag
+ * @since 2.0
*/
protected void setUseShortClassName(boolean useShortClassName) {
this.useShortClassName = useShortClassName;
@@ -1766,6 +1771,7 @@
* of each buffer.</p>
*
* @return the fieldSeparatorAtStart flag
+ * @since 2.0
*/
protected boolean isFieldSeparatorAtStart() {
return fieldSeparatorAtStart;
@@ -1776,6 +1782,7 @@
* of each buffer.</p>
*
* @param fieldSeparatorAtStart the fieldSeparatorAtStart flag
+ * @since 2.0
*/
protected void setFieldSeparatorAtStart(boolean fieldSeparatorAtStart) {
this.fieldSeparatorAtStart = fieldSeparatorAtStart;
@@ -1788,6 +1795,7 @@
* of each buffer.</p>
*
* @return fieldSeparatorAtEnd flag
+ * @since 2.0
*/
protected boolean isFieldSeparatorAtEnd() {
return fieldSeparatorAtEnd;
@@ -1798,6 +1806,7 @@
* of each buffer.</p>
*
* @param fieldSeparatorAtEnd the fieldSeparatorAtEnd flag
+ * @since 2.0
*/
protected void setFieldSeparatorAtEnd(boolean fieldSeparatorAtEnd) {
this.fieldSeparatorAtEnd = fieldSeparatorAtEnd;
1.14 +6 -1
jakarta-commons/lang/src/java/org/apache/commons/lang/builder/StandardToStringStyle.java
Index: StandardToStringStyle.java
===================================================================
RCS file:
/home/cvs/jakarta-commons/lang/src/java/org/apache/commons/lang/builder/StandardToStringStyle.java,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- StandardToStringStyle.java 18 Aug 2003 02:22:24 -0000 1.13
+++ StandardToStringStyle.java 21 Aug 2003 15:52:54 -0000 1.14
@@ -103,6 +103,7 @@
* <p>Gets whether to output short or long class names.</p>
*
* @return the current useShortClassName flag
+ * @since 2.0
*/
public boolean isUseShortClassName() {
return super.isUseShortClassName();
@@ -123,6 +124,7 @@
* <p>Sets whether to output short or long class names.</p>
*
* @param useShortClassName the new useShortClassName flag
+ * @since 2.0
*/
public void setUseShortClassName(boolean useShortClassName) {
super.setUseShortClassName(useShortClassName);
@@ -398,6 +400,7 @@
* of each buffer.</p>
*
* @param fieldSeparatorAtStart the fieldSeparatorAtStart flag
+ * @since 2.0
*/
public void setFieldSeparatorAtStart(boolean fieldSeparatorAtStart) {
super.setFieldSeparatorAtStart(fieldSeparatorAtStart);
@@ -410,6 +413,7 @@
* of each buffer.</p>
*
* @return fieldSeparatorAtEnd flag
+ * @since 2.0
*/
public boolean isFieldSeparatorAtEnd() {
return super.isFieldSeparatorAtEnd();
@@ -420,6 +424,7 @@
* of each buffer.</p>
*
* @param fieldSeparatorAtEnd the fieldSeparatorAtEnd flag
+ * @since 2.0
*/
public void setFieldSeparatorAtEnd(boolean fieldSeparatorAtEnd) {
super.setFieldSeparatorAtEnd(fieldSeparatorAtEnd);
1.19 +3 -1
jakarta-commons/lang/src/java/org/apache/commons/lang/builder/HashCodeBuilder.java
Index: HashCodeBuilder.java
===================================================================
RCS file:
/home/cvs/jakarta-commons/lang/src/java/org/apache/commons/lang/builder/HashCodeBuilder.java,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- HashCodeBuilder.java 18 Aug 2003 02:22:24 -0000 1.18
+++ HashCodeBuilder.java 21 Aug 2003 15:52:54 -0000 1.19
@@ -310,6 +310,7 @@
* @return int hash code
* @throws IllegalArgumentException if the Object is <code>null</code>
* @throws IllegalArgumentException if the number is zero or even
+ * @since 2.0
*/
public static int reflectionHashCode(
int initialNonZeroOddNumber,
@@ -366,6 +367,7 @@
*
* @param superHashCode the result of calling <code>super.hashCode()</code>
* @return this HashCodeBuilder, used to chain calls.
+ * @since 2.0
*/
public HashCodeBuilder appendSuper(int superHashCode) {
iTotal = iTotal * iConstant + superHashCode;
1.19 +3 -1
jakarta-commons/lang/src/java/org/apache/commons/lang/builder/EqualsBuilder.java
Index: EqualsBuilder.java
===================================================================
RCS file:
/home/cvs/jakarta-commons/lang/src/java/org/apache/commons/lang/builder/EqualsBuilder.java,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- EqualsBuilder.java 18 Aug 2003 02:22:24 -0000 1.18
+++ EqualsBuilder.java 21 Aug 2003 15:52:54 -0000 1.19
@@ -201,6 +201,7 @@
* @param reflectUpToClass the superclass to reflect up to (inclusive),
* may be <code>null</code>
* @return <code>true</code> if the two Objects have tested equals.
+ * @since 2.0
*/
public static boolean reflectionEquals(Object lhs, Object rhs, boolean
testTransients, Class reflectUpToClass) {
if (lhs == rhs) {
@@ -291,6 +292,7 @@
*
* @param superEquals the result of calling <code>super.equals()</code>
* @return EqualsBuilder - used to chain calls.
+ * @since 2.0
*/
public EqualsBuilder appendSuper(boolean superEquals) {
if (isEquals == false) {
1.28 +7 -1
jakarta-commons/lang/src/java/org/apache/commons/lang/builder/ToStringBuilder.java
Index: ToStringBuilder.java
===================================================================
RCS file:
/home/cvs/jakarta-commons/lang/src/java/org/apache/commons/lang/builder/ToStringBuilder.java,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- ToStringBuilder.java 18 Aug 2003 02:22:24 -0000 1.27
+++ ToStringBuilder.java 21 Aug 2003 15:52:54 -0000 1.28
@@ -183,6 +183,7 @@
* <p>Forwards to <code>ReflectionToStringBuilder</code>.</p>
*
* @see ReflectionToStringBuilder#toString(Object,ToStringStyle,boolean,Class)
+ * @since 2.0
*/
public static String reflectionToString(
Object object,
@@ -972,6 +973,7 @@
* [EMAIL PROTECTED] System#identityHashCode(java.lang.Object)}.</p>
*
* @param object the <code>Object</code> whose class name and id to output
+ * @since 2.0
*/
public ToStringBuilder appendAsObjectToString(Object object) {
ObjectUtils.appendIdentityToString(this.getStringBuffer(), object);
@@ -990,6 +992,7 @@
*
* @param superToString the result of <code>super.toString()</code>
* @return this
+ * @since 2.0
*/
public ToStringBuilder appendSuper(String superToString) {
if (superToString != null) {
@@ -1023,6 +1026,7 @@
*
* @param toString the result of <code>toString()</code> on another object
* @return this
+ * @since 2.0
*/
public ToStringBuilder appendToString(String toString) {
if (toString != null) {
@@ -1046,6 +1050,7 @@
* <p>Gets the <code>ToStringStyle</code> being used.</p>
*
* @return the <code>ToStringStyle</code> being used
+ * @since 2.0
*/
public ToStringStyle getStyle() {
return style;
@@ -1068,6 +1073,7 @@
* <p>Returns the <code>Object</code> being output.</p>
*
* @return The object being output.
+ * @since 2.0
*/
public Object getObject() {
return object;
1.21 +7 -1
jakarta-commons/lang/src/java/org/apache/commons/lang/enum/Enum.java
Index: Enum.java
===================================================================
RCS file:
/home/cvs/jakarta-commons/lang/src/java/org/apache/commons/lang/enum/Enum.java,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- Enum.java 18 Aug 2003 02:22:24 -0000 1.20
+++ Enum.java 21 Aug 2003 15:52:55 -0000 1.21
@@ -233,20 +233,25 @@
* An empty <code>Map</code>, as JDK1.2 didn't have an empty map.
*/
private static final Map EMPTY_MAP = Collections.unmodifiableMap(new
HashMap(0));
+
/**
* <code>Map</code>, key of class name, value of <code>Entry</code>.
*/
private static final Map cEnumClasses = new HashMap();
+
/**
* The string representation of the Enum.
*/
private final String iName;
+
/**
* The hashcode representation of the Enum.
*/
private transient final int iHashCode;
+
/**
* The toString representation of the Enum.
+ * @since 2.0
*/
protected transient String iToString = null;
@@ -493,6 +498,7 @@
* constant value.</p>
*
* @return the <code>Class</code> of the enum
+ * @since 2.0
*/
public Class getEnumClass() {
return getClass();
1.34 +10 -1
jakarta-commons/lang/src/java/org/apache/commons/lang/exception/ExceptionUtils.java
Index: ExceptionUtils.java
===================================================================
RCS file:
/home/cvs/jakarta-commons/lang/src/java/org/apache/commons/lang/exception/ExceptionUtils.java,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -r1.33 -r1.34
--- ExceptionUtils.java 18 Aug 2003 02:22:24 -0000 1.33
+++ ExceptionUtils.java 21 Aug 2003 15:52:55 -0000 1.34
@@ -134,6 +134,7 @@
*
* @param methodName the methodName to add to the list, <code>null</code>
* and empty strings are ignored
+ * @since 2.0
*/
public static void addCauseMethodName(String methodName) {
if (StringUtils.isNotEmpty(methodName)) {
@@ -322,6 +323,7 @@
* <p>This is true for JDK 1.4 and above.</p>
*
* @return true if Throwable is nestable
+ * @since 2.0
*/
public static boolean isThrowableNested() {
return (THROWABLE_CAUSE_METHOD != null);
@@ -334,6 +336,7 @@
*
* @param throwable the <code>Throwable</code> to examine, may be null
* @return boolean <code>true</code> if nested otherwise <code>false</code>
+ * @since 2.0
*/
public static boolean isNestedThrowable(Throwable throwable) {
if (throwable == null) {
@@ -484,6 +487,7 @@
* that don't have nested causes.</p>
*
* @param throwable the throwable to output
+ * @since 2.0
*/
public static void printRootCauseStackTrace(Throwable throwable) {
printRootCauseStackTrace(throwable, System.err);
@@ -503,6 +507,7 @@
* @param throwable the throwable to output, may be null
* @param stream the stream to output to, may not be null
* @throws IllegalArgumentException if the stream is <code>null</code>
+ * @since 2.0
*/
public static void printRootCauseStackTrace(Throwable throwable, PrintStream
stream) {
if (throwable == null) {
@@ -532,6 +537,7 @@
* @param throwable the throwable to output, may be null
* @param writer the writer to output to, may not be null
* @throws IllegalArgumentException if the writer is <code>null</code>
+ * @since 2.0
*/
public static void printRootCauseStackTrace(Throwable throwable, PrintWriter
writer) {
if (throwable == null) {
@@ -554,6 +560,7 @@
*
* @param throwable the throwable to examine, may be null
* @return an array of stack trace frames, never null
+ * @since 2.0
*/
public static String[] getRootCauseStackTrace(Throwable throwable) {
if (throwable == null) {
@@ -587,6 +594,7 @@
* @param causeFrames stack trace of a cause throwable
* @param wrapperFrames stack trace of a wrapper throwable
* @throws IllegalArgumentException if either argument is null
+ * @since 2.0
*/
public static void removeCommonFrames(List causeFrames, List wrapperFrames) {
if (causeFrames == null || wrapperFrames == null) {
@@ -627,6 +635,7 @@
*
* @param throwable the <code>Throwable</code> to be examined
* @return the nested stack trace, with the root cause first
+ * @since 2.0
*/
public static String getFullStackTrace(Throwable throwable) {
StringWriter sw = new StringWriter();
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
