commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ggreg...@apache.org
Subject cvs commit: jakarta-commons/lang/src/java/org/apache/commons/lang/exception ExceptionUtils.java
Date Thu, 21 Aug 2003 15:52:55 GMT
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> &lt; 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 @@
        * {@link 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();
  
  
  

Mime
View raw message