diff --git a/RELEASE-NOTES-2.0.txt b/RELEASE-NOTES-2.0.txt deleted file mode 100644 index ee79199b4..000000000 --- a/RELEASE-NOTES-2.0.txt +++ /dev/null @@ -1,661 +0,0 @@ -$Id$ - - Commons Lang Package - Version 2.0 - Release Notes - - -INTRODUCTION: - -This document contains the release notes for this version of the Commons -Lang package. Commons Lang is a set of utility functions and reusable -components that should be a help in any Java environment. - -This release has involved a major clean and tidy exercise. -Javadoc and Tests are now much more thorough. -All methods should now be much clearer in what they do in unusual cases. - - -INCOMPATIBLE CHANGES: -Some StringUtils methods have changed functionality from 1.0: - isEmpty() - chomp(String) - chomp(String,String) - swapCase(String) -Numerous other methods have changed null handling to accept nulls gracefully. -As with all major version releases, check your code for incompatibilities. - - -NEW FEATURES: - -Since the release of the 1.0 package the following classes have been added: - -lang package: - ArrayUtils - BitField - BooleanUtils - CharRange (previously package scoped) - ClassUtils - StringEscapeUtils - WordUtils - IllegalClassException - IncompleteArgumentException - NotImplementedException - NullArgumentException - SerializationException - UnhandledException - Validate - - -math sub-package: - IntRange - LongRange - Range - DoubleRange - JVMRandom - NumberRange - FloatRange - NumberUtils - Fraction - RandomUtils - -time sub-package: - DateFormatUtils - FastDateFormat - DateUtils - StopWatch - -Since the release of the 1.0 package the following classes have been changed: - -lang: - CharSet: - Added factory method, equals and hashCode(). - Better defined and tested the set syntax. - CharSetUtils: - added keep method: keep any characters specified in the CharSet string - RandomStringUtils: - random method: overloaded to allow passing in of a Random class - SerializationUtils: - added empty constructor - StringUtils: - isEmpty() changed to not trim - chomp() changed to be more like Perl. - swapCase() no longer word based, but no difference if you pass in ASCII - Various methods changed in the handling of null (less exceptions). - Many new methods. - Various methods deprecated. - SystemUtils: - isJavaVersionAtLeast(int) added. getJavaVersion() deprecated. - host of new constants. - -enum: - Enum: - getEnumClass(Class) added - EnumUtils: - Removed irrelevant Comparable/Serializable interfaces. - -exception: - NestableDelegate: - Gained many new methods for dissecting an Exception. - ExceptionUtils: - Gained many new methods to improve handling of nested stack traces. - -builder: - ReflectionToStringBuilder: - Handy class added for creating default toStrings. - All other builder classes received a set of new methods. - - -BUG FIXES: - -ID Sev Pri Plt Owner State Result Summary -13367 [PATCH] StringUtil enhancement -13391 Javadoc nit -13771 Additional Lang Method Suggestions -14306 NullPointerException in CompareToBuilder -14357 static option for reversing the stacktrace -14447 ToStringBuilder doesn't work well in subclasses -14883 StringUtils.countMatches loops forever if substring empty -14884 NumberRange inaccurate for Long, etc. -14985 More flexibility for getRootCause in ExceptionUtils -15154 SystemUtils.IS_JAVA_1_5 Javadoc is wrong -15257 Hierarchy support in ToStringBuilder.reflectionToString() -15438 ArrayUtils.contains() -15439 Enum does not support inner sub-classes -15986 Infinite loop in ToStringBuilder.reflectionToString for inne -16076 Example in Javadoc for ToStringBuilder wrong for append. -16193 Hierarchy support in EqualsBuilder.reflectionEquals() -16202 typo in the javadoc example code -16204 Infinite loop in StringUtils.replace(text, repl, with) + FIX -16227 Added class hierachy support to CompareToBuilder.reflectionC -16228 Added class hierachy support to HashCodeBuilder.reflectionHa -16284 MethodUtils: Removed unused code/unused local vars. -16341 No Javadoc for NestableDelegate -16622 Removed compile warning in FastDateFormat -16669 JavaDoc Errata -16676 StackOverflow due to ToStringBuilder -16689 ExceptionUtils new methods. -16690 Specify initial size for Enum's HashMap. -16787 Removed compile warning in ObjectUtils -17250 [Lang] Should ToStringBuilder.reflectionToString handle arra -17654 EnumUtils nit: The import java.io.Serializable is never used -17882 Add join(..., char c) to StringUtils (and some performance f -18077 StringUtils.chomp does not match Perl -18723 RandomStringUtils infloops with length < 1 -18836 test.lang fails if compiled with non iso-8859-1 locales -18948 Resurrect the WordWrapUtils from commons-sandbox/utils -19296 [Lang] What to do with FastDateFormat unused private constru -19364 [Lang] time unit tests fail on Sundays -19756 [lang] java.lang.ExceptionInInitializerError thrown by JVMRa -19880 [lang] patch and test case fixing problem with RandomStringU -20165 [LANG] SystemUtils does not play nice in an Applet -20538 [lang] NumberUtils.isNumber allows illegal trailing characte -20592 [lang] RandomStringUtils.randomAlpha methods omit 'z' -20603 [lang] Make NestableDelegate methods public instead of packa -20632 Refactored reflection feature of ToStringBuilder into new Re -20652 StringUtils.chopNewLine - StringIndexOutOfBoundsException -21021 [PATCH] reduce object creation in ToStringBuilder -21068 [lang] [PATCH] NumberUtils min/max, BooleanUtils.xor, and Ar -21099 [lang][PATCH] Unused field 'startFinal' in DateIterator -21715 The javadoc says "Mac" instead of "OS/2" -21734 [PATCH] all NumberUtils.createXXX(String) methods handle null -21750 [lang] StringUtils javadoc and test enhancements -21758 [lang] lang.builder classes javadoc edits (mostly typo fixes) -21797 [lang] Add javadoc examples and tests for StringUtils -21809 [lang] maven-beta10 checkstyle problem -21904 NumberUtils.createBigDecimal("") NPE in Sun 1.3.1_08 -21952 [lang] Improved tests, javadoc for CharSetUtils, StringEscapeUtils -22091 Adding tolerance to double[] search methods in ArrayUtils -22094 A small, but important javadoc fix for Fraction proper whole/numerator -22095 [lang] Javadoc, tests improvements for CharSet, CharSetUtils -22098 [lang] Improve util.Validate tests -22245 [lang] test.time fails in Japanese (non-us) locale. -22286 [lang] Missing @since tags -22367 Typo in documentation -22386 [lang] Improve javadoc and overflow behavior of Fraction - - -DEPRECATIONS: - -lang: - NumberRange: - now deprecated, see math subpackage - NumberUtils: - now deprecated, see math subpackage - - -CHANGES: [In 'diff' format] - -Jar changes -=========== -> org.apache.commons.lang.math.Range -> org.apache.commons.lang.math.FloatRange -> org.apache.commons.lang.math.NumberUtils -> org.apache.commons.lang.math.JVMRandom -> org.apache.commons.lang.math.IntRange -> org.apache.commons.lang.math.LongRange -> org.apache.commons.lang.math.DoubleRange -> org.apache.commons.lang.math.NumberRange -> org.apache.commons.lang.math.Fraction -> org.apache.commons.lang.math.RandomUtils -> org.apache.commons.lang.time.FastDateFormat -> org.apache.commons.lang.time.DateUtils$DateIterator -> org.apache.commons.lang.time.DateUtils -> org.apache.commons.lang.time.FastDateFormat$UnpaddedMonthField -> org.apache.commons.lang.time.FastDateFormat$StringLiteral -> org.apache.commons.lang.time.FastDateFormat$TwelveHourField -> org.apache.commons.lang.time.FastDateFormat$NumberRule -> org.apache.commons.lang.time.FastDateFormat$CharacterLiteral -> org.apache.commons.lang.time.FastDateFormat$TimeZoneNumberRule -> org.apache.commons.lang.time.FastDateFormat$TimeZoneNameRule -> org.apache.commons.lang.time.DateFormatUtils -> org.apache.commons.lang.time.FastDateFormat$TwoDigitMonthField -> org.apache.commons.lang.time.DurationFormatUtils -> org.apache.commons.lang.time.FastDateFormat$TimeZoneDisplayKey -> org.apache.commons.lang.time.FastDateFormat$UnpaddedNumberField -> org.apache.commons.lang.time.FastDateFormat$PaddedNumberField -> org.apache.commons.lang.time.StopWatch -> org.apache.commons.lang.time.FastDateFormat$TwentyFourHourField -> org.apache.commons.lang.time.FastDateFormat$Rule -> org.apache.commons.lang.time.FastDateFormat$TwoDigitNumberField -> org.apache.commons.lang.time.FastDateFormat$TextField -> org.apache.commons.lang.time.FastDateFormat$Pair -> org.apache.commons.lang.time.FastDateFormat$TwoDigitYearField -> org.apache.commons.lang.util.IdentifierUtils$StringNumericIdentifierFactory -> org.apache.commons.lang.util.IdentifierUtils$StringSessionIdentifierFactory -> org.apache.commons.lang.util.IdentifierUtils$LongNumericIdentifierFactory -> org.apache.commons.lang.util.IdentifierUtils$StringAlphanumericIdentifierFactory -> org.apache.commons.lang.util.Validate -> org.apache.commons.lang.util.LongIdentifierFactory -> org.apache.commons.lang.util.IdentifierUtils$1 -> org.apache.commons.lang.util.StringIdentifierFactory -> org.apache.commons.lang.util.IdentifierUtils -> org.apache.commons.lang.util.IdentifierFactory -> org.apache.commons.lang.util.BitField -> org.apache.commons.lang.Entities -> org.apache.commons.lang.Entities$LookupEntityMap -> org.apache.commons.lang.NotImplementedException -> org.apache.commons.lang.NullArgumentException -< org.apache.commons.lang.ObjectUtils$1 ---- -> org.apache.commons.lang.StringPrintWriter -> org.apache.commons.lang.UnhandledException -> org.apache.commons.lang.Entities$HashEntityMap -> org.apache.commons.lang.Entities$ArrayEntityMap -> org.apache.commons.lang.Entities$EntityMap -> org.apache.commons.lang.IntHashMap -> org.apache.commons.lang.BooleanUtils -> org.apache.commons.lang.IncompleteArgumentException -> org.apache.commons.lang.Entities$PrimitiveEntityMap -> org.apache.commons.lang.Entities$TreeEntityMap -> org.apache.commons.lang.WordUtils -> org.apache.commons.lang.StringEscapeUtils -> org.apache.commons.lang.ArrayUtils -> org.apache.commons.lang.Entities$BinaryEntityMap -> org.apache.commons.lang.ClassUtils -> org.apache.commons.lang.IntHashMap$Entry -> org.apache.commons.lang.IllegalClassException -> org.apache.commons.lang.builder.ReflectionToStringBuilder$1 -> org.apache.commons.lang.builder.ReflectionToStringBuilder -> org.apache.commons.lang.Entities$MapIntMap - - -Class changes -============= -org.apache.commons.lang.enum.EnumUtils --------------------- -< public abstract class org.apache.commons.lang.enum.EnumUtils extends java.lang.Object implements java.lang.Comparable, java.io.Serializable { ---- -> public class org.apache.commons.lang.enum.EnumUtils extends java.lang.Object { -> public org.apache.commons.lang.enum.EnumUtils(); - -org.apache.commons.lang.enum.Enum$Entry --------------------- -> final java.util.Map unmodifiableMap; -> final java.util.List unmodifiableList; - -org.apache.commons.lang.enum.Enum --------------------- -> protected transient java.lang.String iToString; -> static java.lang.Class class$org$apache$commons$lang$enum$ValuedEnum; -> public java.lang.Class getEnumClass(); - -org.apache.commons.lang.enum.ValuedEnum --------------------- -> static {}; - -org.apache.commons.lang.StringUtils --------------------- -> public static final java.lang.String EMPTY; -> public static boolean isEmpty(java.lang.String); -> public static boolean isNotEmpty(java.lang.String); -> public static boolean isBlank(java.lang.String); -> public static boolean isNotBlank(java.lang.String); -< public static java.lang.String deleteSpaces(java.lang.String); -< public static java.lang.String deleteWhitespace(java.lang.String); -< public static boolean isNotEmpty(java.lang.String); -< public static boolean isEmpty(java.lang.String); ---- -> public static java.lang.String trimToNull(java.lang.String); -> public static java.lang.String trimToEmpty(java.lang.String); -> public static java.lang.String strip(java.lang.String); -> public static java.lang.String stripToNull(java.lang.String); -> public static java.lang.String stripToEmpty(java.lang.String); -> public static java.lang.String strip(java.lang.String, java.lang.String); -> public static java.lang.String stripStart(java.lang.String, java.lang.String); -> public static java.lang.String stripEnd(java.lang.String, java.lang.String); -> public static java.lang.String stripAll(java.lang.String[])[]; -> public static java.lang.String stripAll(java.lang.String[], java.lang.String)[]; -> public static int indexOf(java.lang.String, char); -> public static int indexOf(java.lang.String, char, int); -> public static int indexOf(java.lang.String, java.lang.String); -> public static int indexOf(java.lang.String, java.lang.String, int); -> public static int lastIndexOf(java.lang.String, char); -> public static int lastIndexOf(java.lang.String, char, int); -> public static int lastIndexOf(java.lang.String, java.lang.String); -> public static int lastIndexOf(java.lang.String, java.lang.String, int); -> public static boolean contains(java.lang.String, char); -> public static boolean contains(java.lang.String, java.lang.String); -> public static int indexOfAny(java.lang.String, char[]); -> public static int indexOfAny(java.lang.String, java.lang.String); -> public static int indexOfAnyBut(java.lang.String, char[]); -> public static int indexOfAnyBut(java.lang.String, java.lang.String); -> public static boolean containsOnly(java.lang.String, char[]); -> public static boolean containsOnly(java.lang.String, java.lang.String); -> public static boolean containsNone(java.lang.String, char[]); -> public static boolean containsNone(java.lang.String, java.lang.String); -> public static java.lang.String substringBefore(java.lang.String, java.lang.String); -> public static java.lang.String substringAfter(java.lang.String, java.lang.String); -> public static java.lang.String substringBeforeLast(java.lang.String, java.lang.String); -> public static java.lang.String substringAfterLast(java.lang.String, java.lang.String); -> public static java.lang.String substringBetween(java.lang.String, java.lang.String); -> public static java.lang.String substringBetween(java.lang.String, java.lang.String, java.lang.String); -> public static java.lang.String getNestedString(java.lang.String, java.lang.String); -> public static java.lang.String getNestedString(java.lang.String, java.lang.String, java.lang.String); -> public static java.lang.String split(java.lang.String, char)[]; -> public static java.lang.String join(java.lang.Object[]); -> public static java.lang.String join(java.lang.Object[], char); -> public static java.lang.String join(java.util.Iterator, char); -> public static java.lang.String deleteSpaces(java.lang.String); -> public static java.lang.String deleteWhitespace(java.lang.String); -> public static java.lang.String replaceChars(java.lang.String, char, char); -> public static java.lang.String replaceChars(java.lang.String, java.lang.String, java.lang.String); -< public static java.lang.String center(java.lang.String, int); -< public static java.lang.String center(java.lang.String, int, java.lang.String); ---- -> public static java.lang.String overlay(java.lang.String, java.lang.String, int, int); -> public static java.lang.String rightPad(java.lang.String, int, char); -> public static java.lang.String leftPad(java.lang.String, int, char); -< public static java.lang.String strip(java.lang.String); -< public static java.lang.String strip(java.lang.String, java.lang.String); -< public static java.lang.String stripAll(java.lang.String[])[]; -< public static java.lang.String stripAll(java.lang.String[], java.lang.String)[]; -< public static java.lang.String stripEnd(java.lang.String, java.lang.String); -< public static java.lang.String stripStart(java.lang.String, java.lang.String); ---- -> public static java.lang.String center(java.lang.String, int); -> public static java.lang.String center(java.lang.String, int, char); -> public static java.lang.String center(java.lang.String, int, java.lang.String); -< public static java.lang.String uncapitalise(java.lang.String); ---- -> public static java.lang.String capitalize(java.lang.String); -> public static java.lang.String uncapitalize(java.lang.String); -> public static java.lang.String uncapitalise(java.lang.String); -< public static java.lang.String getNestedString(java.lang.String, java.lang.String); -< public static java.lang.String getNestedString(java.lang.String, java.lang.String, java.lang.String); -> public static boolean isWhitespace(java.lang.String); -> public static java.lang.String reverseDelimited(java.lang.String, char); -> public static java.lang.String abbreviate(java.lang.String, int); -> public static java.lang.String abbreviate(java.lang.String, int, int); -> public static java.lang.String difference(java.lang.String, java.lang.String); -> public static int differenceAt(java.lang.String, java.lang.String); -< public static boolean containsOnly(java.lang.String, char[]); ---- -> static {}; - -org.apache.commons.lang.ObjectUtils --------------------- -> public static java.lang.StringBuffer appendIdentityToString(java.lang.StringBuffer, java.lang.Object); -> public static java.lang.String toString(java.lang.Object); -> public static java.lang.String toString(java.lang.Object, java.lang.String); -< org.apache.commons.lang.ObjectUtils.Null(org.apache.commons.lang.ObjectUtils$1); ---- -> org.apache.commons.lang.ObjectUtils.Null(); -> static {}; - -org.apache.commons.lang.exception.NestableDelegate --------------------- -> public static boolean topDown; -> public static boolean trimStackFrames; -< org.apache.commons.lang.exception.NestableDelegate(org.apache.commons.lang.exception.Nestable); -< java.lang.String getMessage(int); -< java.lang.String getMessage(java.lang.String); -< java.lang.String getMessages()[]; -< java.lang.Throwable getThrowable(int); -< int getThrowableCount(); -< java.lang.Throwable getThrowables()[]; -< int indexOfThrowable(java.lang.Class, int); ---- -> public org.apache.commons.lang.exception.NestableDelegate(org.apache.commons.lang.exception.Nestable); -> public java.lang.String getMessage(int); -> public java.lang.String getMessage(java.lang.String); -> public java.lang.String getMessages()[]; -> public java.lang.Throwable getThrowable(int); -> public int getThrowableCount(); -> public java.lang.Throwable getThrowables()[]; -> public int indexOfThrowable(java.lang.Class, int); -> protected java.lang.String getStackFrames(java.lang.Throwable)[]; -> protected void trimStackFrames(java.util.List); - -org.apache.commons.lang.exception.ExceptionUtils --------------------- -< protected static final java.lang.String CAUSE_METHOD_NAMES[]; -< protected static final java.lang.Object CAUSE_METHOD_PARAMS[]; ---- -> static final java.lang.String WRAPPED_MARKER; -< protected org.apache.commons.lang.exception.ExceptionUtils(); ---- -> public org.apache.commons.lang.exception.ExceptionUtils(); -> public static void addCauseMethodName(java.lang.String); -> public static boolean isThrowableNested(); -> public static boolean isNestedThrowable(java.lang.Throwable); -> public static void printRootCauseStackTrace(java.lang.Throwable); -> public static void printRootCauseStackTrace(java.lang.Throwable, java.io.PrintStream); -> public static void printRootCauseStackTrace(java.lang.Throwable, java.io.PrintWriter); -> public static java.lang.String getRootCauseStackTrace(java.lang.Throwable)[]; -> public static void removeCommonFrames(java.util.List, java.util.List); -> public static java.lang.String getFullStackTrace(java.lang.Throwable); -> static java.util.List getStackFrameList(java.lang.Throwable); - -org.apache.commons.lang.CharRange --------------------- -< class org.apache.commons.lang.CharRange extends java.lang.Object { ---- -> public final class org.apache.commons.lang.CharRange extends java.lang.Object implements java.io.Serializable { -> public org.apache.commons.lang.CharRange(char,boolean); -< public org.apache.commons.lang.CharRange(java.lang.String,java.lang.String); ---- -> public org.apache.commons.lang.CharRange(char,char,boolean); -< public void setStart(char); -< public void setEnd(char); -< public boolean isRange(); -< public boolean inRange(char); -< public void setNegated(boolean); ---- -> public boolean contains(char); -> public boolean contains(org.apache.commons.lang.CharRange); -> public boolean equals(java.lang.Object); -> public int hashCode(); -> static {}; - -org.apache.commons.lang.ObjectUtils$1 --------------------- -< Compiled from ObjectUtils.java -< class org.apache.commons.lang.ObjectUtils$1 extends java.lang.Object { -< } ---- -> Class 'org.apache.commons.lang.ObjectUtils$1' has been removed - -org.apache.commons.lang.ObjectUtils$Null --------------------- -< org.apache.commons.lang.ObjectUtils.Null(org.apache.commons.lang.ObjectUtils$1); ---- -> org.apache.commons.lang.ObjectUtils.Null(); -> static {}; - -org.apache.commons.lang.SystemUtils --------------------- -> public static final java.lang.String FILE_ENCODING; -> public static final java.lang.String JAVA_RUNTIME_NAME; -> public static final java.lang.String JAVA_RUNTIME_VERSION; -> public static final java.lang.String JAVA_VM_INFO; -> public static final java.lang.String USER_COUNTRY; -> public static final java.lang.String USER_LANGUAGE; -> public static final float JAVA_VERSION_FLOAT; -> public static final int JAVA_VERSION_INT; -> public static final boolean IS_OS_AIX; -> public static final boolean IS_OS_HP_UX; -> public static final boolean IS_OS_IRIX; -> public static final boolean IS_OS_LINUX; -> public static final boolean IS_OS_MAC; -> public static final boolean IS_OS_MAC_OSX; -> public static final boolean IS_OS_OS2; -> public static final boolean IS_OS_SOLARIS; -> public static final boolean IS_OS_SUN_OS; -> public static final boolean IS_OS_WINDOWS; -> public static final boolean IS_OS_WINDOWS_2000; -> public static final boolean IS_OS_WINDOWS_95; -> public static final boolean IS_OS_WINDOWS_98; -> public static final boolean IS_OS_WINDOWS_ME; -> public static final boolean IS_OS_WINDOWS_NT; -> public static final boolean IS_OS_WINDOWS_XP; -> public static boolean isJavaVersionAtLeast(int); - -org.apache.commons.lang.SerializationUtils --------------------- -> public org.apache.commons.lang.SerializationUtils(); - -org.apache.commons.lang.RandomStringUtils --------------------- -> public static java.lang.String random(int, int, int, boolean, boolean, char[], java.util.Random); - -org.apache.commons.lang.CharSet --------------------- -< public class org.apache.commons.lang.CharSet extends java.lang.Object { ---- -> public class org.apache.commons.lang.CharSet extends java.lang.Object implements java.io.Serializable { -> public static final org.apache.commons.lang.CharSet EMPTY; -> public static final org.apache.commons.lang.CharSet ASCII_ALPHA; -> public static final org.apache.commons.lang.CharSet ASCII_ALPHA_LOWER; -> public static final org.apache.commons.lang.CharSet ASCII_ALPHA_UPPER; -> public static final org.apache.commons.lang.CharSet ASCII_NUMERIC; -> protected static final java.util.Map COMMON; -> public static org.apache.commons.lang.CharSet getInstance(java.lang.String); -> protected org.apache.commons.lang.CharSet(java.lang.String); -< public boolean contains(char); -> public org.apache.commons.lang.CharRange getCharRanges()[]; -> public boolean contains(char); -> public boolean equals(java.lang.Object); -> public int hashCode(); -> static {}; - -org.apache.commons.lang.CharSetUtils --------------------- -> public static java.lang.String keep(java.lang.String, java.lang.String); -> public static java.lang.String keep(java.lang.String, java.lang.String[]); - -org.apache.commons.lang.builder.ToStringBuilder --------------------- -< public org.apache.commons.lang.builder.ToStringBuilder(java.lang.Object); -< public org.apache.commons.lang.builder.ToStringBuilder(java.lang.Object,org.apache.commons.lang.builder.ToStringStyle); -< public org.apache.commons.lang.builder.ToStringBuilder(java.lang.Object,org.apache.commons.lang.builder.ToStringStyle,java.lang.StringBuffer); -< public static void setDefaultStyle(org.apache.commons.lang.builder.ToStringStyle); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.Object); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, java.lang.Object); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, java.lang.Object, boolean); -< public org.apache.commons.lang.builder.ToStringBuilder append(long); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, long); -< public org.apache.commons.lang.builder.ToStringBuilder append(int); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, int); -< public org.apache.commons.lang.builder.ToStringBuilder append(short); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, short); -< public org.apache.commons.lang.builder.ToStringBuilder append(char); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, char); ---- -> public static java.lang.String reflectionToString(java.lang.Object, org.apache.commons.lang.builder.ToStringStyle, boolean, java.lang.Class); -> public static void setDefaultStyle(org.apache.commons.lang.builder.ToStringStyle); -> public org.apache.commons.lang.builder.ToStringBuilder(java.lang.Object); -> public org.apache.commons.lang.builder.ToStringBuilder(java.lang.Object,org.apache.commons.lang.builder.ToStringStyle); -> public org.apache.commons.lang.builder.ToStringBuilder(java.lang.Object,org.apache.commons.lang.builder.ToStringStyle,java.lang.StringBuffer); -> public org.apache.commons.lang.builder.ToStringBuilder append(boolean); -> public org.apache.commons.lang.builder.ToStringBuilder append(boolean[]); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, byte); ---- -> public org.apache.commons.lang.builder.ToStringBuilder append(byte[]); -> public org.apache.commons.lang.builder.ToStringBuilder append(char); -> public org.apache.commons.lang.builder.ToStringBuilder append(char[]); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, double); ---- -> public org.apache.commons.lang.builder.ToStringBuilder append(double[]); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, float); -< public org.apache.commons.lang.builder.ToStringBuilder append(boolean); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, boolean); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.Object[]); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, java.lang.Object[]); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, java.lang.Object[], boolean); -< public org.apache.commons.lang.builder.ToStringBuilder append(long[]); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, long[]); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, long[], boolean); ---- -> public org.apache.commons.lang.builder.ToStringBuilder append(float[]); -> public org.apache.commons.lang.builder.ToStringBuilder append(int); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, int[]); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, int[], boolean); ---- -> public org.apache.commons.lang.builder.ToStringBuilder append(long); -> public org.apache.commons.lang.builder.ToStringBuilder append(long[]); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.Object); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.Object[]); -> public org.apache.commons.lang.builder.ToStringBuilder append(short); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, short[]); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, short[], boolean); -< public org.apache.commons.lang.builder.ToStringBuilder append(char[]); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, char[]); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, char[], boolean); -< public org.apache.commons.lang.builder.ToStringBuilder append(byte[]); ---- -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, boolean); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, boolean[]); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, boolean[], boolean); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, byte); -< public org.apache.commons.lang.builder.ToStringBuilder append(double[]); ---- -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, char); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, char[]); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, char[], boolean); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, double); -< public org.apache.commons.lang.builder.ToStringBuilder append(float[]); ---- -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, float); -< public org.apache.commons.lang.builder.ToStringBuilder append(boolean[]); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, boolean[]); -< public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, boolean[], boolean); ---- -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, int); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, int[]); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, int[], boolean); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, long); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, long[]); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, long[], boolean); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, java.lang.Object); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, java.lang.Object, boolean); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, java.lang.Object[]); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, java.lang.Object[], boolean); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, short); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, short[]); -> public org.apache.commons.lang.builder.ToStringBuilder append(java.lang.String, short[], boolean); -> public org.apache.commons.lang.builder.ToStringBuilder appendAsObjectToString(java.lang.Object); -> public org.apache.commons.lang.builder.ToStringBuilder appendSuper(java.lang.String); -> public org.apache.commons.lang.builder.ToStringBuilder appendToString(java.lang.String); -> public org.apache.commons.lang.builder.ToStringStyle getStyle(); -> public java.lang.Object getObject(); - -org.apache.commons.lang.builder.StandardToStringStyle --------------------- -> public boolean isUseShortClassName(); -> public void setUseShortClassName(boolean); -> public boolean isFieldSeparatorAtStart(); -> public void setFieldSeparatorAtStart(boolean); -> public boolean isFieldSeparatorAtEnd(); -> public void setFieldSeparatorAtEnd(boolean); - -org.apache.commons.lang.builder.ToStringStyle --------------------- -> public void appendSuper(java.lang.StringBuffer, java.lang.String); -> public void appendToString(java.lang.StringBuffer, java.lang.String); -> protected void removeLastFieldSeparator(java.lang.StringBuffer); -> protected void reflectionAppendArrayDetail(java.lang.StringBuffer, java.lang.String, java.lang.Object); -> protected boolean isUseShortClassName(); -> protected void setUseShortClassName(boolean); -> protected boolean isFieldSeparatorAtStart(); -> protected void setFieldSeparatorAtStart(boolean); -> protected boolean isFieldSeparatorAtEnd(); -> protected void setFieldSeparatorAtEnd(boolean); - -org.apache.commons.lang.builder.HashCodeBuilder --------------------- -> public static int reflectionHashCode(int, int, java.lang.Object, boolean, java.lang.Class); -> public org.apache.commons.lang.builder.HashCodeBuilder appendSuper(int); - -org.apache.commons.lang.builder.CompareToBuilder --------------------- -> public static int reflectionCompare(java.lang.Object, java.lang.Object, boolean, java.lang.Class); -> public org.apache.commons.lang.builder.CompareToBuilder appendSuper(int); -> public org.apache.commons.lang.builder.CompareToBuilder append(java.lang.Object, java.lang.Object, java.util.Comparator); -> public org.apache.commons.lang.builder.CompareToBuilder append(java.lang.Object[], java.lang.Object[], java.util.Comparator); - -org.apache.commons.lang.builder.EqualsBuilder --------------------- -> public static boolean reflectionEquals(java.lang.Object, java.lang.Object, boolean, java.lang.Class); -> public org.apache.commons.lang.builder.EqualsBuilder appendSuper(boolean); - diff --git a/RELEASE-NOTES-2.1.txt b/RELEASE-NOTES-2.1.txt deleted file mode 100644 index 57db2ff6e..000000000 --- a/RELEASE-NOTES-2.1.txt +++ /dev/null @@ -1,135 +0,0 @@ -$Id$ - - Commons Lang Package - Version 2.1 - Release Notes - - -INTRODUCTION: - -This document contains the release notes for the 2.1 version of Apache Jakarta Commons Lang. -Commons Lang is a set of utility functions and reusable components that -should be of use in any Java environment. - - -INCOMPATIBLE CHANGES: - -- The Nestable interface defines the method indexOfThrowable(Class). -Previously the implementations checked only for a specific Class. -Now they check for subclasses of that Class as well. -For most situations this will be the expected behaviour (ie. its a bug fix). -If it causes problems, please use the ExceptionUtils.indexOfThrowable(Class) method instead. -Note that the ExceptionUtils method is available in v1.0 and v2.0 of commons-lang and has not been changed. -(An alternative to this is to change the public static matchSubclasses flag on NestableDelegate. -However, we don't recommend that as a long-term solution.) - -- The StopWatch class has had much extra validation added. -If your code previously relied on unusual aspects, it may no longer work. - -- Starting with version 2.1, Ant version 1.6.x is required to build. Copy -junit.jar to ANT_HOME/lib. You can get JUnit from http://www.junit.org. See the developer's guide -for more details. - - -DEPRECATIONS: - -- The enum package has been renamed to enums for JDK1.5 compilance. -All functionality is identical, just the package has changed. -This package will be removed in v3.0. - -- NumberUtils.stringToInt - renamed to toInt - -- DateUtils - four constants, MILLIS_IN_* have been deprecated as they were defined -as int not long. The replacements are MILLIS_PER_*. - - -NEW FEATURES: - -New: -- Mutable package - contains basic classes that hold an Object or primitive -and provide both get and set methods. -- DurationFormatUtils - provides various methods for formatting durations -- CharEncoding - definitions of constants for character encoding work -- CharUtils - utilities for working with characters - -Updated: -- ArrayUtils - many more methods, especially List-like methods -- BooleanUtils - isTrue and isFalse methods that handle null -- ClassUtils - primitive to wrapper class conversion methods -- ClassUtils - class name comparator -- IllegalClassException - extra constructor for common instanceof case -- NotImplementedException - supports nested exceptions -- ObjectUtils - hashcode method handling null -- StringUtils - isAsciiPrintable to check the contents of a string - -- ordinalIndexOf to find the nth index of a string - -- various remove methods to remove parts of a string - -- various split methods to provide more control over splitting a string - -- defaultIfEmpty to default a string if null or empty -- SystemUtils - methods to get system properties as File objects - -- extra constants representing system properties -- Validate - new methods to check whether all elements in a collection are of a specific type -- WordUtils - new methods to capitalize based on a set of specified delimiters - -- EqualsBuilder - now provides setter to internal state -- ToStringStyle - new style, short prefix style -- ReflectionToStringBuilder - more flags to control the output with regards to statics - -- ExceptionUtils - added indexOfType methods that check subclasses, thus leaving the existing -indexOfThrowable method untouched (see incompatible changes section) - -- NumberUtils - various string to number parsing methods added - -- DateUtils - methods added to compare dates in various ways - -- method to parse a date string using multiple patterns -- FastDateFormat - extra formatting methods that take in a millisecond long value - -- additional static factory methods -- StopWatch - new methods for split behaviour - - -BUG FIXES: - -19331 General case: infinite loop: ToStringBuilder.reflectionToString -23174 EqualsBuilder.append(Object[], Object[]) throws NPE -23356 Make DurationFormatUtils public! -23557 WordUtils.capitalizeFully(String str) should take a delimiters -23683 New method for converting a primitive Class to its corresponding wrapper -23430 Minor javadoc fixes for StringUtils.contains(String, String) -23590 make optional parameters in FastDateFormat really optional -24056 Documentation error in StringUtils.replace -25227 StringEscapeUtils.unescapeHtml() doesn't handle hex entities -25454 new StringUtils.replaceChars behaves differently from old Ch -25560 DateUtils.truncate() is off by one hour when using a date in DST switch 'zone' -25627 DateUtils constants should be long -25683 Add method that validates Collection elements are a correct -25849 Add SystemUtils methods for directory properties. -26616 ClassCastException in Enum.equals(Object) -26699 Tokenizer Enhancements: reset input string, static CSV -26734 NullPointerException in EqualsBuilder.append(Object[], Object[]) -26877 Add SystemUtils.AWT_TOOLKIT and others. -26922 public static boolean DateUtils.equals(Date dt1, Date dt2) -27592 WordUtils capitalize improvement -27876 ReflectionToStringBuilder.toString(null) throws exception by design -27877 Make ClassUtils methods null-safe and not throw an IAE. -28468 StringUtils.defaultString: Documentation error -28554 Add hashCode-support to class ObjectUtils -29082 Enhancement of ExceptionUtils.CAUSE_METHOD_NAMES -29149 StringEscapeUtils.unescapeHtml() doesn't handle an empty entity -29294 lang.math.Fraction class deficiencies -29673 ExceptionUtils: new getCause() methodname (for tomcat) -29794 Add convenience format(long) methods to FastDateForma -30328 HashCodeBuilder does not use the same values as Boolean (fixed as documentation) -30334 New class proposal: CharacterEncoding -30674 parseDate class from HttpClient's DateParser class -30815 ArrayUtils.isEquals() throws ClassCastException when array1 -30929 Nestable.indexOfThrowable(Class) uses Class.equals() to match -31395 DateUtils.truncate oddity at the far end of the Date spectrum -31478 Compile error with JDK 5 "enum" is a keyword -31572 o.a.c.lang.enum.ValuedEnum: 'enum'is a keyword in JDK1.5.0 -31933 ToStringStyle setArrayEnd handled null incorrectly -32133 SystemUtils fails init on HP-UX -32198 Error in JavaDoc for StringUtils.chomp(String, String) -32625 Can't subclass EqualsBuilder because isEquals is private -33067 EqualsBuilder.append(Object[], Object[]) crashes with a NullPointerException if an element of the first array is null -33069 EqualsBuilder.append(Object[], Object[]) incorrectly checks that rhs[i] is instance of lhs[i]'s class -33574 unbalanced ReflectionToStringBuilder -33737 ExceptionUtils.addCauseMethodName(String) does not check for duplicates.