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

Deprecate CharEncoding and direct users to Java 7 classes 

Java 7 introduced java.nio.charset.StandardCharsets, which negates the
need for our CharEncoding method. Additionally, the constants in the
class now point to the constants defined in Java 7.

Fixes: LANG-1334
This commit is contained in:
duncan 2017-05-22 13:16:29 +01:00
parent 53def50140
commit 7c19a1ff4c
3 changed files with 15 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
src/changes/changes.xml
View File

@ -46,6 +46,7 @@ The <action> type attribute can be add,update,fix,remove.
<body>
<release version="3.6" date="2017-MM-DD" description="TBD">
<action issue="LANG-1334" type="update" dev="djones">Deprecate CharEncoding in favour of java.nio.charset.StandardCharsets</action>
<action issue="LANG-1319" type="fix" dev="djones">MultilineRecursiveToStringStyle StackOverflowError when object is an array</action>
<action issue="LANG-1325" type="add" dev="kinow" due-to="Arshad Basha">Increase test coverage of ToStringBuilder class to 100%</action>
<action issue="LANG-1307" type="add" dev="pschumacher" due-to="Arshad Basha">Add a method in StringUtils to extract only digits out of input string</action>

19
src/main/java/org/apache/commons/lang3/CharEncoding.java
View File

@ -19,6 +19,7 @@ package org.apache.commons.lang3;
import java.nio.charset.Charset;
import java.nio.charset.IllegalCharsetNameException;
import java.nio.charset.StandardCharsets;
/**
* <p>Character encoding names required of every implementation of the Java platform.</p>
@ -32,7 +33,11 @@ import java.nio.charset.IllegalCharsetNameException;
*
* @see <a href="http://docs.oracle.com/javase/6/docs/technotes/guides/intl/encoding.doc.html">JRE character encoding names</a>
* @since 2.1
* @deprecated Java 7 introduced {@link StandardCharsets}, which defines these constants as
* {@link Charset} objects. Use {@link Charset#name()} to get the string values provided in this class.
* This class will be removed in a future release.
*/
@Deprecated
public class CharEncoding {
/**
@ -40,7 +45,7 @@ public class CharEncoding {
*
* <p>Every implementation of the Java platform is required to support this character encoding.</p>
*/
public static final String ISO_8859_1 = "ISO-8859-1";
public static final String ISO_8859_1 = StandardCharsets.ISO_8859_1.name();
/**
* <p>Seven-bit ASCII, also known as ISO646-US, also known as the Basic Latin block
@ -48,7 +53,7 @@ public class CharEncoding {
*
* <p>Every implementation of the Java platform is required to support this character encoding.</p>
*/
public static final String US_ASCII = "US-ASCII";
public static final String US_ASCII = StandardCharsets.US_ASCII.name();
/**
* <p>Sixteen-bit Unicode Transformation Format, byte order specified by a mandatory initial
@ -56,28 +61,28 @@ public class CharEncoding {
*
* <p>Every implementation of the Java platform is required to support this character encoding.</p>
*/
public static final String UTF_16 = "UTF-16";
public static final String UTF_16 = StandardCharsets.UTF_16.name();
/**
* <p>Sixteen-bit Unicode Transformation Format, big-endian byte order.</p>
*
* <p>Every implementation of the Java platform is required to support this character encoding.</p>
*/
public static final String UTF_16BE = "UTF-16BE";
public static final String UTF_16BE = StandardCharsets.UTF_16BE.name();
/**
* <p>Sixteen-bit Unicode Transformation Format, little-endian byte order.</p>
*
* <p>Every implementation of the Java platform is required to support this character encoding.</p>
*/
public static final String UTF_16LE = "UTF-16LE";
public static final String UTF_16LE = StandardCharsets.UTF_16LE.name();
/**
* <p>Eight-bit Unicode Transformation Format.</p>
*
* <p>Every implementation of the Java platform is required to support this character encoding.</p>
*/
public static final String UTF_8 = "UTF-8";
public static final String UTF_8 = StandardCharsets.UTF_8.name();
/**
* <p>Returns whether the named charset is supported.</p>
@ -88,6 +93,8 @@ public class CharEncoding {
*
* @param name the name of the requested charset; may be either a canonical name or an alias, null returns false
* @return {@code true} if the charset is available in the current Java virtual machine
* @deprecated Please use {@link Charset#isSupported(String)} instead, although be aware that {@code null}
* values are not accepted by that method and an {@link IllegalCharsetNameException} may be thrown.
*/
public static boolean isSupported(final String name) {
if (name == null) {

1
src/test/java/org/apache/commons/lang3/CharEncodingTest.java
View File

@ -27,6 +27,7 @@ import org.junit.Test;
*
* @see CharEncoding
*/
@SuppressWarnings("deprecation")
public class CharEncodingTest {
private void assertSupportedEncoding(final String name) {