Apache
/
commons-lang
mirror of https://github.com/apache/commons-lang.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Lowering the bar for the article so a release isn't held up by talking about the release 

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/lang/trunk@1072856 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Henri Yandell 2011-02-21 06:36:57 +00:00
parent da545e3f6c
commit dafce5c30e
1 changed files with 26 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
src/site/xdoc/article3_0.xml
View File

@ -32,12 +32,14 @@ limitations under the License.
<p>Lang is now Java 5 based. We've generified the API, moved certain APIs to support <code>varargs</code> and thrown out any features
that are now supported by Java itself. We've removed the deprecated parts of the API and have also removed some features that
were deemed weak or unnecessary. All of this means that Lang 3.0 is not backwards compatible. </p>
<p>To that end we have changed the package name, allowing Lang 3.0 to sit side-by-side with your previous version of Lang without any bad side effects. The new package name is the exciting and original <code>org.apache.commons.lang3</code>. </p>
<p>To that end we have changed the package name, allowing Lang 3.0 to sit side-by-side with your previous version of Lang without any bad side effects. The new package name is the exciting and original <code>org.apache.commons.lang3</code>. This also forces you to recompile your code, making sure the compiler can let you know if a backwards incompatibility affects you. </p>
<p>As you'd expect, there are also new features, enhancements and bugs fixed. </p>
</section>
<!--
<section name="The build">
<p>We built 3.0 using Maven 2.2.1 and Java 1.5. <strong>Needs confirmation before release of actual build details</strong></p>
</section>
-->
<section name="Migrating from 2.x">
<h3>Java code</h3>
<p>Despite the label of backwards incompatibility, in the vast majority of cases the simple addition of a <code>'3'</code> to an import statement will suffice for your migration. </p><br/>
@ -46,6 +48,7 @@ were deemed weak or unnecessary. All of this means that Lang 3.0 is not backward
<p><code>groupId</code>: <code>commons-lang</code> -&gt; <code>org.apache.commons</code></p>
<p><code>artifactId</code>: <code>commons-lang</code> -&gt; <code>commons-lang3</code></p>
</section>
<section name="What's gone?">
<h3>Enum package</h3>
<p>Java 5 provided enums out of the box, therefore we dispensed with both the deprecated enum package,
@ -76,31 +79,31 @@ we will remove the related methods in Lang 4.0. </p>
<section name="New packages">
<p>Two new packages have shown up. org.apache.commons.lang3.concurrent, which unsurprisingly provides support classes for
multi-threaded programming, and org.apache.commons.lang3.text.translate, which provides a pluggable API for text transformation. </p>
TODO: Add examples
<!-- TODO: Add examples -->
</section>
<section name="New classes">
<p><code>CharSequenceUtils</code></p>
<p><code>EnumUtils</code></p>
<p><code>JavaVersion</code></p>
<p><code>Pair</code></p>
<p><code>Range</code></p>
<p><code>builder.Builder</code></p>
<p><code>exception.ContextedException</code></p>
<p><code>exception.CloneFailedException</code></p>
<p><code>reflect.ConstructorUtils</code></p>
<p><code>reflect.FieldUtils</code></p>
<p><code>reflect.MethodUtils</code></p>
<p><code>reflect.TypeUtils</code></p>
<p><code>text.WordUtils</code></p>
</section>
<section name="New methods">
<section name="New classes + methods">
<p>There are many new classes and methods in Lang 3.0 - the most complete way to see the changes is via this <a href="lang2-lang3-clirr-report.html">Lang2 to Lang3 Clirr report</a>. </p>
<p>Here is a summary of the new classes: </p>
<ul>
<li><code>AnnotationUtils</code></li>
<li><code>CharSequenceUtils</code></li>
<li><code>EnumUtils</code></li>
<li><code>JavaVersion</code> - used in SystemUtils</li>
<li><code>Pair</code></li>
<li><code>Range</code> - replaces the old math.*Range classes</li>
<li><code>builder.Builder</code></li>
<li><code>exception.ContextedException</code></li>
<li><code>exception.CloneFailedException</code></li>
<li><code>reflect.ConstructorUtils</code></li>
<li><code>reflect.FieldUtils</code></li>
<li><code>reflect.MethodUtils</code></li>
<li><code>reflect.TypeUtils</code></li>
<li><code>text.WordUtils</code></li>
</ul>
</section>
<section name="What's changed?">
<p>Add info about SystemUtils moving over to the JavaVersion enum and away from int/float. </p>
</section>
<section name="What's fixed?">
<section name="Bugfixes?">
<p>See the <a href="changes-report.html#3.0">3.0 changes report</a> for the list of fixed bugs and other enhancements. </p>
</section>
<!--