Release notes for Lang 1.0.
git-svn-id: https://svn.apache.org/repos/asf/jakarta/commons/proper/lang/trunk@137058 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
parent
0e07b8e599
commit
e1e9aa56fe
|
@ -1,34 +1,146 @@
|
|||
$Id: RELEASE-NOTES.txt,v 1.2 2002/07/25 22:44:29 bayard Exp $
|
||||
$Id: RELEASE-NOTES.txt,v 1.3 2002/09/25 01:33:06 bayard Exp $
|
||||
|
||||
Commons Lang Package
|
||||
Version 1.0-b1
|
||||
Version 1.0
|
||||
Release Notes
|
||||
|
||||
|
||||
INTRODUCTION:
|
||||
|
||||
This document contains the release notes for this version of the Commons
|
||||
Lang package.
|
||||
|
||||
There is a high demand for the functionality found in Commons Lang in other
|
||||
Jakarta projects. Some are already using it, often because they submitted
|
||||
the original code, other times because they find the functionality useful,
|
||||
and other times because they want to release and don't want to depend upon a
|
||||
nightly build of Commons Lang.
|
||||
|
||||
Therefore this is a beta release of a stable api for these projects and any
|
||||
other interested project to depend upon.
|
||||
|
||||
It is important to note that this is not a traditional beta, a piece of
|
||||
code thrown out with many bugs remaining. It is a beta because additional
|
||||
classes are expected to be added before a full release, but the classes
|
||||
contained in this release are not expected to change.
|
||||
|
||||
Lang package. Commons Lang is a set of utility functions and reusable
|
||||
components that should be a help in any Java environment.
|
||||
|
||||
NEW FEATURES:
|
||||
|
||||
It's all a new feature.
|
||||
Since the release of the b1 package the following have been added:
|
||||
|
||||
lang.
|
||||
SystemUtils:
|
||||
Brings together many system specific variables under one easy component.
|
||||
|
||||
exception.
|
||||
ExceptionUtils:
|
||||
Provides helpful static functions for dealing with Exceptions.
|
||||
NestableError :
|
||||
Adds nesting ability to Errors.
|
||||
|
||||
enum sub-package:
|
||||
A solid version of the typical Java translation of a C struct.
|
||||
|
||||
builder sub-package:
|
||||
A series of helpers for handling standard Object methods such as equals,
|
||||
toString, compareTo and hashCode in a professional manner.
|
||||
|
||||
|
||||
BUG FIXES:
|
||||
|
||||
StringUtils.stripStart and stripEnd were improved to match their Javadoc.
|
||||
StringUtils.convertUnicodeToNative and convertNativeToUnicode both removed.
|
||||
Both methods did not work properly.
|
||||
|
||||
|
||||
DEPRECATIONS:
|
||||
|
||||
Much of the exception subpackage was reworked betwen 1.0-b1 and 1.0. Apart
|
||||
from this the API should have a high level of backward compatibility.
|
||||
|
||||
|
||||
CHANGES: [In 'diff' format]
|
||||
|
||||
Jar changes
|
||||
===========
|
||||
> org.apache.commons.lang.exception.ExceptionUtils
|
||||
> org.apache.commons.lang.exception.NestableError
|
||||
> org.apache.commons.lang.ObjectUtils$Null
|
||||
> org.apache.commons.lang.ObjectUtils$1
|
||||
> org.apache.commons.lang.enum.Enum$Entry
|
||||
> org.apache.commons.lang.enum.Enum$1
|
||||
> org.apache.commons.lang.enum.Enum
|
||||
> org.apache.commons.lang.enum.EnumUtils
|
||||
> org.apache.commons.lang.enum.ValuedEnum
|
||||
> org.apache.commons.lang.builder.CompareToBuilder
|
||||
> org.apache.commons.lang.builder.EqualsBuilder
|
||||
> org.apache.commons.lang.builder.HashCodeBuilder
|
||||
> org.apache.commons.lang.builder.StandardToStringStyle
|
||||
> org.apache.commons.lang.builder.ToStringStyle$DefaultToStringStyle
|
||||
> org.apache.commons.lang.builder.ToStringStyle$NoFieldNameToStringStyle
|
||||
> org.apache.commons.lang.builder.ToStringStyle$SimpleToStringStyle
|
||||
> org.apache.commons.lang.builder.ToStringStyle$MultiLineToStringStyle
|
||||
> org.apache.commons.lang.builder.ToStringStyle$1
|
||||
> org.apache.commons.lang.builder.ToStringStyle
|
||||
> org.apache.commons.lang.builder.ToStringBuilder
|
||||
> org.apache.commons.lang.SystemUtils
|
||||
|
||||
|
||||
Class changes
|
||||
=============
|
||||
org.apache.commons.lang.exception.Nestable
|
||||
--------------------
|
||||
< public abstract int getLength();
|
||||
> public abstract int getThrowableCount();
|
||||
< public abstract int indexOfThrowable(int, java.lang.Class);
|
||||
---
|
||||
> public abstract int indexOfThrowable(java.lang.Class, int);
|
||||
> public abstract void printStackTrace(java.io.PrintStream);
|
||||
|
||||
org.apache.commons.lang.exception.NestableDelegate
|
||||
--------------------
|
||||
< int getLength();
|
||||
< java.lang.String getMessage(java.lang.String);
|
||||
> java.lang.String getMessage(java.lang.String);
|
||||
> java.lang.String getMessages()[];
|
||||
> int getThrowableCount();
|
||||
< java.lang.String getMessages()[];
|
||||
< int indexOfThrowable(int, java.lang.Class);
|
||||
---
|
||||
> int indexOfThrowable(java.lang.Class, int);
|
||||
|
||||
org.apache.commons.lang.exception.NestableException
|
||||
--------------------
|
||||
< public int getLength();
|
||||
> public java.lang.String getMessage(int);
|
||||
> public int getThrowableCount();
|
||||
< public java.lang.String getMessage(int);
|
||||
< public int indexOfThrowable(int, java.lang.Class);
|
||||
---
|
||||
> public int indexOfThrowable(java.lang.Class, int);
|
||||
|
||||
org.apache.commons.lang.exception.NestableRuntimeException
|
||||
--------------------
|
||||
< public int getLength();
|
||||
> public java.lang.String getMessage(int);
|
||||
> public int getThrowableCount();
|
||||
< public java.lang.String getMessage(int);
|
||||
< public int indexOfThrowable(int, java.lang.Class);
|
||||
---
|
||||
> public int indexOfThrowable(java.lang.Class, int);
|
||||
|
||||
org.apache.commons.lang.NumberUtils
|
||||
--------------------
|
||||
> public static long minimum(long, long, long);
|
||||
> public static long maximum(long, long, long);
|
||||
> public static int compare(double, double);
|
||||
> public static int compare(float, float);
|
||||
|
||||
org.apache.commons.lang.ObjectUtils
|
||||
--------------------
|
||||
> public static final org.apache.commons.lang.ObjectUtils.Null NULL;
|
||||
> public org.apache.commons.lang.ObjectUtils();
|
||||
> public static java.lang.String identityToString(java.lang.Object);
|
||||
> static {};
|
||||
> public static class org.apache.commons.lang.ObjectUtils. Null extends java.lang.Object implements java.io.Serializable
|
||||
|
||||
org.apache.commons.lang.RandomStringUtils
|
||||
--------------------
|
||||
> public org.apache.commons.lang.RandomStringUtils();
|
||||
|
||||
org.apache.commons.lang.StringUtils
|
||||
--------------------
|
||||
> public org.apache.commons.lang.StringUtils();
|
||||
< public static java.lang.String stackTrace(java.lang.Throwable);
|
||||
< public static java.lang.String convertUnicodeToNative(java.lang.String, java.lang.String) throws java.io.IOException;
|
||||
< public static java.lang.String convertNativeToUnicode(java.lang.String, java.lang.String) throws java.io.IOException;
|
||||
---
|
||||
> public static boolean containsOnly(java.lang.String, char[]);
|
||||
|
||||
|
|
Loading…
Reference in New Issue