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:
Henri Yandell 2002-09-25 01:33:06 +00:00
parent 0e07b8e599
commit e1e9aa56fe
1 changed files with 131 additions and 19 deletions

View File

@ -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[]);