http://git-wip-us.apache.org/repos/asf/commons-text/blob/4d927351/src/main/java/org/apache/commons/text/beta/translate/EntityArrays.java
----------------------------------------------------------------------
diff --git 
a/src/main/java/org/apache/commons/text/beta/translate/EntityArrays.java 
b/src/main/java/org/apache/commons/text/beta/translate/EntityArrays.java
new file mode 100644
index 0000000..0c4e998
--- /dev/null
+++ b/src/main/java/org/apache/commons/text/beta/translate/EntityArrays.java
@@ -0,0 +1,442 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.text.beta.translate;
+
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * Class holding various entity data for HTML and XML - generally for use with
+ * the LookupTranslator.
+ * All Maps are generated using 
<code>java.util.Collections.unmodifiableMap()</code>.
+ *
+ * @since 1.0
+ */
+public class EntityArrays {
+
+   /**
+     * A Map&lt;CharSequence, CharSequence&gt; to to escape
+     * <a 
href="https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-1";>ISO-8859-1</a>
+     * characters to their named HTML 3.x equivalents.
+     */
+    public static final Map<CharSequence, CharSequence> ISO8859_1_ESCAPE;
+    static {
+        Map<CharSequence, CharSequence> initialMap = new HashMap<>();
+        initialMap.put("\u00A0", "&nbsp;"); // non-breaking space
+        initialMap.put("\u00A1", "&iexcl;"); // inverted exclamation mark
+        initialMap.put("\u00A2", "&cent;"); // cent sign
+        initialMap.put("\u00A3", "&pound;"); // pound sign
+        initialMap.put("\u00A4", "&curren;"); // currency sign
+        initialMap.put("\u00A5", "&yen;"); // yen sign = yuan sign
+        initialMap.put("\u00A6", "&brvbar;"); // broken bar = broken vertical 
bar
+        initialMap.put("\u00A7", "&sect;"); // section sign
+        initialMap.put("\u00A8", "&uml;"); // diaeresis = spacing diaeresis
+        initialMap.put("\u00A9", "&copy;"); // © - copyright sign
+        initialMap.put("\u00AA", "&ordf;"); // feminine ordinal indicator
+        initialMap.put("\u00AB", "&laquo;"); // left-pointing double angle 
quotation mark = left pointing guillemet
+        initialMap.put("\u00AC", "&not;"); // not sign
+        initialMap.put("\u00AD", "&shy;"); // soft hyphen = discretionary 
hyphen
+        initialMap.put("\u00AE", "&reg;"); // ® - registered trademark sign
+        initialMap.put("\u00AF", "&macr;"); // macron = spacing macron = 
overline = APL overbar
+        initialMap.put("\u00B0", "&deg;"); // degree sign
+        initialMap.put("\u00B1", "&plusmn;"); // plus-minus sign = 
plus-or-minus sign
+        initialMap.put("\u00B2", "&sup2;"); // superscript two = superscript 
digit two = squared
+        initialMap.put("\u00B3", "&sup3;"); // superscript three = superscript 
digit three = cubed
+        initialMap.put("\u00B4", "&acute;"); // acute accent = spacing acute
+        initialMap.put("\u00B5", "&micro;"); // micro sign
+        initialMap.put("\u00B6", "&para;"); // pilcrow sign = paragraph sign
+        initialMap.put("\u00B7", "&middot;"); // middle dot = Georgian comma = 
Greek middle dot
+        initialMap.put("\u00B8", "&cedil;"); // cedilla = spacing cedilla
+        initialMap.put("\u00B9", "&sup1;"); // superscript one = superscript 
digit one
+        initialMap.put("\u00BA", "&ordm;"); // masculine ordinal indicator
+        initialMap.put("\u00BB", "&raquo;"); // right-pointing double angle 
quotation mark = right pointing guillemet
+        initialMap.put("\u00BC", "&frac14;"); // vulgar fraction one quarter = 
fraction one quarter
+        initialMap.put("\u00BD", "&frac12;"); // vulgar fraction one half = 
fraction one half
+        initialMap.put("\u00BE", "&frac34;"); // vulgar fraction three 
quarters = fraction three quarters
+        initialMap.put("\u00BF", "&iquest;"); // inverted question mark = 
turned question mark
+        initialMap.put("\u00C0", "&Agrave;"); // À - uppercase A, grave accent
+        initialMap.put("\u00C1", "&Aacute;"); // Á - uppercase A, acute accent
+        initialMap.put("\u00C2", "&Acirc;"); // Â - uppercase A, circumflex 
accent
+        initialMap.put("\u00C3", "&Atilde;"); // Ã - uppercase A, tilde
+        initialMap.put("\u00C4", "&Auml;"); // Ä - uppercase A, umlaut
+        initialMap.put("\u00C5", "&Aring;"); // Å - uppercase A, ring
+        initialMap.put("\u00C6", "&AElig;"); // Æ - uppercase AE
+        initialMap.put("\u00C7", "&Ccedil;"); // Ç - uppercase C, cedilla
+        initialMap.put("\u00C8", "&Egrave;"); // È - uppercase E, grave accent
+        initialMap.put("\u00C9", "&Eacute;"); // É - uppercase E, acute accent
+        initialMap.put("\u00CA", "&Ecirc;"); // Ê - uppercase E, circumflex 
accent
+        initialMap.put("\u00CB", "&Euml;"); // Ë - uppercase E, umlaut
+        initialMap.put("\u00CC", "&Igrave;"); // Ì - uppercase I, grave accent
+        initialMap.put("\u00CD", "&Iacute;"); // Í - uppercase I, acute accent
+        initialMap.put("\u00CE", "&Icirc;"); // Î - uppercase I, circumflex 
accent
+        initialMap.put("\u00CF", "&Iuml;"); // Ï - uppercase I, umlaut
+        initialMap.put("\u00D0", "&ETH;"); // Ð - uppercase Eth, Icelandic
+        initialMap.put("\u00D1", "&Ntilde;"); // Ñ - uppercase N, tilde
+        initialMap.put("\u00D2", "&Ograve;"); // Ò - uppercase O, grave accent
+        initialMap.put("\u00D3", "&Oacute;"); // Ó - uppercase O, acute accent
+        initialMap.put("\u00D4", "&Ocirc;"); // Ô - uppercase O, circumflex 
accent
+        initialMap.put("\u00D5", "&Otilde;"); // Õ - uppercase O, tilde
+        initialMap.put("\u00D6", "&Ouml;"); // Ö - uppercase O, umlaut
+        initialMap.put("\u00D7", "&times;"); // multiplication sign
+        initialMap.put("\u00D8", "&Oslash;"); // Ø - uppercase O, slash
+        initialMap.put("\u00D9", "&Ugrave;"); // Ù - uppercase U, grave accent
+        initialMap.put("\u00DA", "&Uacute;"); // Ú - uppercase U, acute accent
+        initialMap.put("\u00DB", "&Ucirc;"); // Û - uppercase U, circumflex 
accent
+        initialMap.put("\u00DC", "&Uuml;"); // Ü - uppercase U, umlaut
+        initialMap.put("\u00DD", "&Yacute;"); // Ý - uppercase Y, acute accent
+        initialMap.put("\u00DE", "&THORN;"); // Þ - uppercase THORN, Icelandic
+        initialMap.put("\u00DF", "&szlig;"); // ß - lowercase sharps, German
+        initialMap.put("\u00E0", "&agrave;"); // à - lowercase a, grave accent
+        initialMap.put("\u00E1", "&aacute;"); // á - lowercase a, acute accent
+        initialMap.put("\u00E2", "&acirc;"); // â - lowercase a, circumflex 
accent
+        initialMap.put("\u00E3", "&atilde;"); // ã - lowercase a, tilde
+        initialMap.put("\u00E4", "&auml;"); // ä - lowercase a, umlaut
+        initialMap.put("\u00E5", "&aring;"); // å - lowercase a, ring
+        initialMap.put("\u00E6", "&aelig;"); // æ - lowercase ae
+        initialMap.put("\u00E7", "&ccedil;"); // ç - lowercase c, cedilla
+        initialMap.put("\u00E8", "&egrave;"); // è - lowercase e, grave accent
+        initialMap.put("\u00E9", "&eacute;"); // é - lowercase e, acute accent
+        initialMap.put("\u00EA", "&ecirc;"); // ê - lowercase e, circumflex 
accent
+        initialMap.put("\u00EB", "&euml;"); // ë - lowercase e, umlaut
+        initialMap.put("\u00EC", "&igrave;"); // ì - lowercase i, grave accent
+        initialMap.put("\u00ED", "&iacute;"); // í - lowercase i, acute accent
+        initialMap.put("\u00EE", "&icirc;"); // î - lowercase i, circumflex 
accent
+        initialMap.put("\u00EF", "&iuml;"); // ï - lowercase i, umlaut
+        initialMap.put("\u00F0", "&eth;"); // ð - lowercase eth, Icelandic
+        initialMap.put("\u00F1", "&ntilde;"); // ñ - lowercase n, tilde
+        initialMap.put("\u00F2", "&ograve;"); // ò - lowercase o, grave accent
+        initialMap.put("\u00F3", "&oacute;"); // ó - lowercase o, acute accent
+        initialMap.put("\u00F4", "&ocirc;"); // ô - lowercase o, circumflex 
accent
+        initialMap.put("\u00F5", "&otilde;"); // õ - lowercase o, tilde
+        initialMap.put("\u00F6", "&ouml;"); // ö - lowercase o, umlaut
+        initialMap.put("\u00F7", "&divide;"); // division sign
+        initialMap.put("\u00F8", "&oslash;"); // ø - lowercase o, slash
+        initialMap.put("\u00F9", "&ugrave;"); // ù - lowercase u, grave accent
+        initialMap.put("\u00FA", "&uacute;"); // ú - lowercase u, acute accent
+        initialMap.put("\u00FB", "&ucirc;"); // û - lowercase u, circumflex 
accent
+        initialMap.put("\u00FC", "&uuml;"); // ü - lowercase u, umlaut
+        initialMap.put("\u00FD", "&yacute;"); // ý - lowercase y, acute accent
+        initialMap.put("\u00FE", "&thorn;"); // þ - lowercase thorn, Icelandic
+        initialMap.put("\u00FF", "&yuml;"); // ÿ - lowercase y, umlaut
+        ISO8859_1_ESCAPE = Collections.unmodifiableMap(initialMap);
+    }
+
+    /**
+     * Reverse of {@link #ISO8859_1_ESCAPE} for unescaping purposes.
+     */
+    public static final Map<CharSequence, CharSequence> ISO8859_1_UNESCAPE;
+    static {
+        ISO8859_1_UNESCAPE = 
Collections.unmodifiableMap(invert(ISO8859_1_ESCAPE));
+    }
+
+    /**
+     * A Map&lt;CharSequence, CharSequence&gt; to escape additional
+     * <a href="http://www.w3.org/TR/REC-html40/sgml/entities.html";>character 
entity
+     * references</a>. Note that this must be used with {@link 
#ISO8859_1_ESCAPE} to get the full list of
+     * HTML 4.0 character entities.
+     */
+    public static final Map<CharSequence, CharSequence> HTML40_EXTENDED_ESCAPE;
+    static {
+        Map<CharSequence, CharSequence> initialMap = new HashMap<>();
+        // <!-- Latin Extended-B -->
+        initialMap.put("\u0192", "&fnof;"); // latin small f with hook = 
function= florin, U+0192 ISOtech -->
+        // <!-- Greek -->
+        initialMap.put("\u0391", "&Alpha;"); // greek capital letter alpha, 
U+0391 -->
+        initialMap.put("\u0392", "&Beta;"); // greek capital letter beta, 
U+0392 -->
+        initialMap.put("\u0393", "&Gamma;"); // greek capital letter 
gamma,U+0393 ISOgrk3 -->
+        initialMap.put("\u0394", "&Delta;"); // greek capital letter 
delta,U+0394 ISOgrk3 -->
+        initialMap.put("\u0395", "&Epsilon;"); // greek capital letter 
epsilon, U+0395 -->
+        initialMap.put("\u0396", "&Zeta;"); // greek capital letter zeta, 
U+0396 -->
+        initialMap.put("\u0397", "&Eta;"); // greek capital letter eta, U+0397 
-->
+        initialMap.put("\u0398", "&Theta;"); // greek capital letter 
theta,U+0398 ISOgrk3 -->
+        initialMap.put("\u0399", "&Iota;"); // greek capital letter iota, 
U+0399 -->
+        initialMap.put("\u039A", "&Kappa;"); // greek capital letter kappa, 
U+039A -->
+        initialMap.put("\u039B", "&Lambda;"); // greek capital letter 
lambda,U+039B ISOgrk3 -->
+        initialMap.put("\u039C", "&Mu;"); // greek capital letter mu, U+039C 
-->
+        initialMap.put("\u039D", "&Nu;"); // greek capital letter nu, U+039D 
-->
+        initialMap.put("\u039E", "&Xi;"); // greek capital letter xi, U+039E 
ISOgrk3 -->
+        initialMap.put("\u039F", "&Omicron;"); // greek capital letter 
omicron, U+039F -->
+        initialMap.put("\u03A0", "&Pi;"); // greek capital letter pi, U+03A0 
ISOgrk3 -->
+        initialMap.put("\u03A1", "&Rho;"); // greek capital letter rho, U+03A1 
-->
+        // <!-- there is no Sigmaf, and no U+03A2 character either -->
+        initialMap.put("\u03A3", "&Sigma;"); // greek capital letter 
sigma,U+03A3 ISOgrk3 -->
+        initialMap.put("\u03A4", "&Tau;"); // greek capital letter tau, U+03A4 
-->
+        initialMap.put("\u03A5", "&Upsilon;"); // greek capital letter 
upsilon,U+03A5 ISOgrk3 -->
+        initialMap.put("\u03A6", "&Phi;"); // greek capital letter phi,U+03A6 
ISOgrk3 -->
+        initialMap.put("\u03A7", "&Chi;"); // greek capital letter chi, U+03A7 
-->
+        initialMap.put("\u03A8", "&Psi;"); // greek capital letter psi,U+03A8 
ISOgrk3 -->
+        initialMap.put("\u03A9", "&Omega;"); // greek capital letter 
omega,U+03A9 ISOgrk3 -->
+        initialMap.put("\u03B1", "&alpha;"); // greek small letter 
alpha,U+03B1 ISOgrk3 -->
+        initialMap.put("\u03B2", "&beta;"); // greek small letter beta, U+03B2 
ISOgrk3 -->
+        initialMap.put("\u03B3", "&gamma;"); // greek small letter 
gamma,U+03B3 ISOgrk3 -->
+        initialMap.put("\u03B4", "&delta;"); // greek small letter 
delta,U+03B4 ISOgrk3 -->
+        initialMap.put("\u03B5", "&epsilon;"); // greek small letter 
epsilon,U+03B5 ISOgrk3 -->
+        initialMap.put("\u03B6", "&zeta;"); // greek small letter zeta, U+03B6 
ISOgrk3 -->
+        initialMap.put("\u03B7", "&eta;"); // greek small letter eta, U+03B7 
ISOgrk3 -->
+        initialMap.put("\u03B8", "&theta;"); // greek small letter 
theta,U+03B8 ISOgrk3 -->
+        initialMap.put("\u03B9", "&iota;"); // greek small letter iota, U+03B9 
ISOgrk3 -->
+        initialMap.put("\u03BA", "&kappa;"); // greek small letter 
kappa,U+03BA ISOgrk3 -->
+        initialMap.put("\u03BB", "&lambda;"); // greek small letter 
lambda,U+03BB ISOgrk3 -->
+        initialMap.put("\u03BC", "&mu;"); // greek small letter mu, U+03BC 
ISOgrk3 -->
+        initialMap.put("\u03BD", "&nu;"); // greek small letter nu, U+03BD 
ISOgrk3 -->
+        initialMap.put("\u03BE", "&xi;"); // greek small letter xi, U+03BE 
ISOgrk3 -->
+        initialMap.put("\u03BF", "&omicron;"); // greek small letter omicron, 
U+03BF NEW -->
+        initialMap.put("\u03C0", "&pi;"); // greek small letter pi, U+03C0 
ISOgrk3 -->
+        initialMap.put("\u03C1", "&rho;"); // greek small letter rho, U+03C1 
ISOgrk3 -->
+        initialMap.put("\u03C2", "&sigmaf;"); // greek small letter final 
sigma,U+03C2 ISOgrk3 -->
+        initialMap.put("\u03C3", "&sigma;"); // greek small letter 
sigma,U+03C3 ISOgrk3 -->
+        initialMap.put("\u03C4", "&tau;"); // greek small letter tau, U+03C4 
ISOgrk3 -->
+        initialMap.put("\u03C5", "&upsilon;"); // greek small letter 
upsilon,U+03C5 ISOgrk3 -->
+        initialMap.put("\u03C6", "&phi;"); // greek small letter phi, U+03C6 
ISOgrk3 -->
+        initialMap.put("\u03C7", "&chi;"); // greek small letter chi, U+03C7 
ISOgrk3 -->
+        initialMap.put("\u03C8", "&psi;"); // greek small letter psi, U+03C8 
ISOgrk3 -->
+        initialMap.put("\u03C9", "&omega;"); // greek small letter 
omega,U+03C9 ISOgrk3 -->
+        initialMap.put("\u03D1", "&thetasym;"); // greek small letter theta 
symbol,U+03D1 NEW -->
+        initialMap.put("\u03D2", "&upsih;"); // greek upsilon with hook 
symbol,U+03D2 NEW -->
+        initialMap.put("\u03D6", "&piv;"); // greek pi symbol, U+03D6 ISOgrk3 
-->
+        // <!-- General Punctuation -->
+        initialMap.put("\u2022", "&bull;"); // bullet = black small 
circle,U+2022 ISOpub -->
+        // <!-- bullet is NOT the same as bullet operator, U+2219 -->
+        initialMap.put("\u2026", "&hellip;"); // horizontal ellipsis = three 
dot leader,U+2026 ISOpub -->
+        initialMap.put("\u2032", "&prime;"); // prime = minutes = feet, U+2032 
ISOtech -->
+        initialMap.put("\u2033", "&Prime;"); // double prime = seconds = 
inches,U+2033 ISOtech -->
+        initialMap.put("\u203E", "&oline;"); // overline = spacing 
overscore,U+203E NEW -->
+        initialMap.put("\u2044", "&frasl;"); // fraction slash, U+2044 NEW -->
+        // <!-- Letterlike Symbols -->
+        initialMap.put("\u2118", "&weierp;"); // script capital P = power set= 
Weierstrass p, U+2118 ISOamso -->
+        initialMap.put("\u2111", "&image;"); // blackletter capital I = 
imaginary part,U+2111 ISOamso -->
+        initialMap.put("\u211C", "&real;"); // blackletter capital R = real 
part symbol,U+211C ISOamso -->
+        initialMap.put("\u2122", "&trade;"); // trade mark sign, U+2122 ISOnum 
-->
+        initialMap.put("\u2135", "&alefsym;"); // alef symbol = first 
transfinite cardinal,U+2135 NEW -->
+        // <!-- alef symbol is NOT the same as hebrew letter alef,U+05D0 
although the
+        // same glyph could be used to depict both characters -->
+        // <!-- Arrows -->
+        initialMap.put("\u2190", "&larr;"); // leftwards arrow, U+2190 ISOnum 
-->
+        initialMap.put("\u2191", "&uarr;"); // upwards arrow, U+2191 ISOnum-->
+        initialMap.put("\u2192", "&rarr;"); // rightwards arrow, U+2192 ISOnum 
-->
+        initialMap.put("\u2193", "&darr;"); // downwards arrow, U+2193 ISOnum 
-->
+        initialMap.put("\u2194", "&harr;"); // left right arrow, U+2194 
ISOamsa -->
+        initialMap.put("\u21B5", "&crarr;"); // downwards arrow with corner 
leftwards= carriage return, U+21B5 NEW -->
+        initialMap.put("\u21D0", "&lArr;"); // leftwards double arrow, U+21D0 
ISOtech -->
+        // <!-- ISO 10646 does not say that lArr is the same as the 'is 
implied by'
+        // arrow but also does not have any other character for that function.
+        // So ? lArr canbe used for 'is implied by' as ISOtech suggests -->
+        initialMap.put("\u21D1", "&uArr;"); // upwards double arrow, U+21D1 
ISOamsa -->
+        initialMap.put("\u21D2", "&rArr;"); // rightwards double arrow,U+21D2 
ISOtech -->
+        // <!-- ISO 10646 does not say this is the 'implies' character but 
does not
+        // have another character with this function so ?rArr can be used for
+        // 'implies' as ISOtech suggests -->
+        initialMap.put("\u21D3", "&dArr;"); // downwards double arrow, U+21D3 
ISOamsa -->
+        initialMap.put("\u21D4", "&hArr;"); // left right double arrow,U+21D4 
ISOamsa -->
+        // <!-- Mathematical Operators -->
+        initialMap.put("\u2200", "&forall;"); // for all, U+2200 ISOtech -->
+        initialMap.put("\u2202", "&part;"); // partial differential, U+2202 
ISOtech -->
+        initialMap.put("\u2203", "&exist;"); // there exists, U+2203 ISOtech 
-->
+        initialMap.put("\u2205", "&empty;"); // empty set = null set = 
diameter,U+2205 ISOamso -->
+        initialMap.put("\u2207", "&nabla;"); // nabla = backward 
difference,U+2207 ISOtech -->
+        initialMap.put("\u2208", "&isin;"); // element of, U+2208 ISOtech -->
+        initialMap.put("\u2209", "&notin;"); // not an element of, U+2209 
ISOtech -->
+        initialMap.put("\u220B", "&ni;"); // contains as member, U+220B 
ISOtech -->
+        // <!-- should there be a more memorable name than 'ni'? -->
+        initialMap.put("\u220F", "&prod;"); // n-ary product = product 
sign,U+220F ISOamsb -->
+        // <!-- prod is NOT the same character as U+03A0 'greek capital letter 
pi'
+        // though the same glyph might be used for both -->
+        initialMap.put("\u2211", "&sum;"); // n-ary summation, U+2211 ISOamsb 
-->
+        // <!-- sum is NOT the same character as U+03A3 'greek capital letter 
sigma'
+        // though the same glyph might be used for both -->
+        initialMap.put("\u2212", "&minus;"); // minus sign, U+2212 ISOtech -->
+        initialMap.put("\u2217", "&lowast;"); // asterisk operator, U+2217 
ISOtech -->
+        initialMap.put("\u221A", "&radic;"); // square root = radical 
sign,U+221A ISOtech -->
+        initialMap.put("\u221D", "&prop;"); // proportional to, U+221D ISOtech 
-->
+        initialMap.put("\u221E", "&infin;"); // infinity, U+221E ISOtech -->
+        initialMap.put("\u2220", "&ang;"); // angle, U+2220 ISOamso -->
+        initialMap.put("\u2227", "&and;"); // logical and = wedge, U+2227 
ISOtech -->
+        initialMap.put("\u2228", "&or;"); // logical or = vee, U+2228 ISOtech 
-->
+        initialMap.put("\u2229", "&cap;"); // intersection = cap, U+2229 
ISOtech -->
+        initialMap.put("\u222A", "&cup;"); // union = cup, U+222A ISOtech -->
+        initialMap.put("\u222B", "&int;"); // integral, U+222B ISOtech -->
+        initialMap.put("\u2234", "&there4;"); // therefore, U+2234 ISOtech -->
+        initialMap.put("\u223C", "&sim;"); // tilde operator = varies with = 
similar to,U+223C ISOtech -->
+        // <!-- tilde operator is NOT the same character as the tilde, 
U+007E,although
+        // the same glyph might be used to represent both -->
+        initialMap.put("\u2245", "&cong;"); // approximately equal to, U+2245 
ISOtech -->
+        initialMap.put("\u2248", "&asymp;"); // almost equal to = asymptotic 
to,U+2248 ISOamsr -->
+        initialMap.put("\u2260", "&ne;"); // not equal to, U+2260 ISOtech -->
+        initialMap.put("\u2261", "&equiv;"); // identical to, U+2261 ISOtech 
-->
+        initialMap.put("\u2264", "&le;"); // less-than or equal to, U+2264 
ISOtech -->
+        initialMap.put("\u2265", "&ge;"); // greater-than or equal to,U+2265 
ISOtech -->
+        initialMap.put("\u2282", "&sub;"); // subset of, U+2282 ISOtech -->
+        initialMap.put("\u2283", "&sup;"); // superset of, U+2283 ISOtech -->
+        // <!-- note that nsup, 'not a superset of, U+2283' is not covered by 
the
+        // Symbol font encoding and is not included. Should it be, for 
symmetry?
+        // It is in ISOamsn -->,
+        initialMap.put("\u2284", "&nsub;"); // not a subset of, U+2284 ISOamsn 
-->
+        initialMap.put("\u2286", "&sube;"); // subset of or equal to, U+2286 
ISOtech -->
+        initialMap.put("\u2287", "&supe;"); // superset of or equal to,U+2287 
ISOtech -->
+        initialMap.put("\u2295", "&oplus;"); // circled plus = direct 
sum,U+2295 ISOamsb -->
+        initialMap.put("\u2297", "&otimes;"); // circled times = vector 
product,U+2297 ISOamsb -->
+        initialMap.put("\u22A5", "&perp;"); // up tack = orthogonal to = 
perpendicular,U+22A5 ISOtech -->
+        initialMap.put("\u22C5", "&sdot;"); // dot operator, U+22C5 ISOamsb -->
+        // <!-- dot operator is NOT the same character as U+00B7 middle dot -->
+        // <!-- Miscellaneous Technical -->
+        initialMap.put("\u2308", "&lceil;"); // left ceiling = apl 
upstile,U+2308 ISOamsc -->
+        initialMap.put("\u2309", "&rceil;"); // right ceiling, U+2309 ISOamsc 
-->
+        initialMap.put("\u230A", "&lfloor;"); // left floor = apl 
downstile,U+230A ISOamsc -->
+        initialMap.put("\u230B", "&rfloor;"); // right floor, U+230B ISOamsc 
-->
+        initialMap.put("\u2329", "&lang;"); // left-pointing angle bracket = 
bra,U+2329 ISOtech -->
+        // <!-- lang is NOT the same character as U+003C 'less than' or U+2039 
'single left-pointing angle quotation
+        // mark' -->
+        initialMap.put("\u232A", "&rang;"); // right-pointing angle bracket = 
ket,U+232A ISOtech -->
+        // <!-- rang is NOT the same character as U+003E 'greater than' or 
U+203A
+        // 'single right-pointing angle quotation mark' -->
+        // <!-- Geometric Shapes -->
+        initialMap.put("\u25CA", "&loz;"); // lozenge, U+25CA ISOpub -->
+        // <!-- Miscellaneous Symbols -->
+        initialMap.put("\u2660", "&spades;"); // black spade suit, U+2660 
ISOpub -->
+        // <!-- black here seems to mean filled as opposed to hollow -->
+        initialMap.put("\u2663", "&clubs;"); // black club suit = 
shamrock,U+2663 ISOpub -->
+        initialMap.put("\u2665", "&hearts;"); // black heart suit = 
valentine,U+2665 ISOpub -->
+        initialMap.put("\u2666", "&diams;"); // black diamond suit, U+2666 
ISOpub -->
+
+        // <!-- Latin Extended-A -->
+        initialMap.put("\u0152", "&OElig;"); // -- latin capital ligature 
OE,U+0152 ISOlat2 -->
+        initialMap.put("\u0153", "&oelig;"); // -- latin small ligature oe, 
U+0153 ISOlat2 -->
+        // <!-- ligature is a misnomer, this is a separate character in some 
languages -->
+        initialMap.put("\u0160", "&Scaron;"); // -- latin capital letter S 
with caron,U+0160 ISOlat2 -->
+        initialMap.put("\u0161", "&scaron;"); // -- latin small letter s with 
caron,U+0161 ISOlat2 -->
+        initialMap.put("\u0178", "&Yuml;"); // -- latin capital letter Y with 
diaeresis,U+0178 ISOlat2 -->
+        // <!-- Spacing Modifier Letters -->
+        initialMap.put("\u02C6", "&circ;"); // -- modifier letter circumflex 
accent,U+02C6 ISOpub -->
+        initialMap.put("\u02DC", "&tilde;"); // small tilde, U+02DC ISOdia -->
+        // <!-- General Punctuation -->
+        initialMap.put("\u2002", "&ensp;"); // en space, U+2002 ISOpub -->
+        initialMap.put("\u2003", "&emsp;"); // em space, U+2003 ISOpub -->
+        initialMap.put("\u2009", "&thinsp;"); // thin space, U+2009 ISOpub -->
+        initialMap.put("\u200C", "&zwnj;"); // zero width non-joiner,U+200C 
NEW RFC 2070 -->
+        initialMap.put("\u200D", "&zwj;"); // zero width joiner, U+200D NEW 
RFC 2070 -->
+        initialMap.put("\u200E", "&lrm;"); // left-to-right mark, U+200E NEW 
RFC 2070 -->
+        initialMap.put("\u200F", "&rlm;"); // right-to-left mark, U+200F NEW 
RFC 2070 -->
+        initialMap.put("\u2013", "&ndash;"); // en dash, U+2013 ISOpub -->
+        initialMap.put("\u2014", "&mdash;"); // em dash, U+2014 ISOpub -->
+        initialMap.put("\u2018", "&lsquo;"); // left single quotation 
mark,U+2018 ISOnum -->
+        initialMap.put("\u2019", "&rsquo;"); // right single quotation 
mark,U+2019 ISOnum -->
+        initialMap.put("\u201A", "&sbquo;"); // single low-9 quotation mark, 
U+201A NEW -->
+        initialMap.put("\u201C", "&ldquo;"); // left double quotation 
mark,U+201C ISOnum -->
+        initialMap.put("\u201D", "&rdquo;"); // right double quotation 
mark,U+201D ISOnum -->
+        initialMap.put("\u201E", "&bdquo;"); // double low-9 quotation mark, 
U+201E NEW -->
+        initialMap.put("\u2020", "&dagger;"); // dagger, U+2020 ISOpub -->
+        initialMap.put("\u2021", "&Dagger;"); // double dagger, U+2021 ISOpub 
-->
+        initialMap.put("\u2030", "&permil;"); // per mille sign, U+2030 
ISOtech -->
+        initialMap.put("\u2039", "&lsaquo;"); // single left-pointing angle 
quotation mark,U+2039 ISO proposed -->
+        // <!-- lsaquo is proposed but not yet ISO standardized -->
+        initialMap.put("\u203A", "&rsaquo;"); // single right-pointing angle 
quotation mark,U+203A ISO proposed -->
+        // <!-- rsaquo is proposed but not yet ISO standardized -->
+        initialMap.put("\u20AC", "&euro;"); // -- euro sign, U+20AC NEW -->
+        HTML40_EXTENDED_ESCAPE = Collections.unmodifiableMap(initialMap);
+    }
+
+    /**
+     * Reverse of {@link #HTML40_EXTENDED_ESCAPE} for unescaping purposes.
+     */
+    public static final Map<CharSequence, CharSequence> 
HTML40_EXTENDED_UNESCAPE;
+    static {
+        HTML40_EXTENDED_UNESCAPE = 
Collections.unmodifiableMap(invert(HTML40_EXTENDED_ESCAPE));
+    }
+
+    /**
+     * A Map&lt;CharSequence, CharSequence&gt; to escape the basic XML and HTML
+     * character entities.
+     *
+     * Namely: {@code " & < >}
+     */
+    public static final Map<CharSequence, CharSequence> BASIC_ESCAPE;
+    static {
+        Map<CharSequence, CharSequence> initialMap = new HashMap<>();
+        initialMap.put("\"", "&quot;"); // " - double-quote
+        initialMap.put("&", "&amp;");   // & - ampersand
+        initialMap.put("<", "&lt;");    // < - less-than
+        initialMap.put(">", "&gt;");    // > - greater-than
+        BASIC_ESCAPE = Collections.unmodifiableMap(initialMap);
+    }
+
+    /**
+     * Reverse of {@link #BASIC_ESCAPE} for unescaping purposes.
+     */
+    public static final Map<CharSequence, CharSequence> BASIC_UNESCAPE;
+    static {
+        BASIC_UNESCAPE = Collections.unmodifiableMap(invert(BASIC_ESCAPE));
+    }
+
+    /**
+     * A Map&lt;CharSequence, CharSequence&gt; to escape the apostrophe 
character to
+     * its XML character entity.
+     */
+    public static final Map<CharSequence, CharSequence> APOS_ESCAPE;
+    static {
+        Map<CharSequence, CharSequence> initialMap = new HashMap<>();
+        initialMap.put("'","&apos;"); // XML apostrophe
+        APOS_ESCAPE = Collections.unmodifiableMap(initialMap);
+    }
+
+    /**
+     * Reverse of {@link #APOS_ESCAPE} for unescaping purposes.
+     */
+    public static final Map<CharSequence, CharSequence> APOS_UNESCAPE;
+    static {
+        APOS_UNESCAPE = Collections.unmodifiableMap(invert(APOS_ESCAPE));
+    }
+
+    /**
+     * A Map&lt;CharSequence, CharSequence&gt; to escape the Java
+     * control characters.
+     *
+     * Namely: {@code \b \n \t \f \r}
+     */
+    public static final Map<CharSequence, CharSequence> JAVA_CTRL_CHARS_ESCAPE;
+    static {
+        Map<CharSequence, CharSequence> initialMap = new HashMap<>();
+        initialMap.put("\b", "\\b");
+        initialMap.put("\n", "\\n");
+        initialMap.put("\t", "\\t");
+        initialMap.put("\f", "\\f");
+        initialMap.put("\r", "\\r");
+        JAVA_CTRL_CHARS_ESCAPE = Collections.unmodifiableMap(initialMap);
+    }
+
+    /**
+     * Reverse of {@link #JAVA_CTRL_CHARS_ESCAPE} for unescaping purposes.
+     */
+    public static final Map<CharSequence, CharSequence> 
JAVA_CTRL_CHARS_UNESCAPE;
+    static {
+        JAVA_CTRL_CHARS_UNESCAPE = 
Collections.unmodifiableMap(invert(JAVA_CTRL_CHARS_ESCAPE));
+    }
+
+    /**
+     * Used to invert an escape Map into an unescape Map
+     * @param map Map&lt;String, String&gt; to be inverted
+     * @return Map&lt;String, String&gt; inverted array
+     */
+    public static Map<CharSequence, CharSequence> invert(final 
Map<CharSequence, CharSequence> map) {
+        Map<CharSequence, CharSequence> newMap = new HashMap<>();
+        for(CharSequence key: map.keySet()){
+            newMap.put(map.get(key), key);
+        }
+        return newMap;
+    }
+
+}

http://git-wip-us.apache.org/repos/asf/commons-text/blob/4d927351/src/main/java/org/apache/commons/text/beta/translate/JavaUnicodeEscaper.java
----------------------------------------------------------------------
diff --git 
a/src/main/java/org/apache/commons/text/beta/translate/JavaUnicodeEscaper.java 
b/src/main/java/org/apache/commons/text/beta/translate/JavaUnicodeEscaper.java
new file mode 100644
index 0000000..c3a519c
--- /dev/null
+++ 
b/src/main/java/org/apache/commons/text/beta/translate/JavaUnicodeEscaper.java
@@ -0,0 +1,113 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.text.beta.translate;
+
+/**
+ * Translates codepoints to their Unicode escaped value suitable for Java 
source.
+ *
+ * @since 1.0
+ */
+public class JavaUnicodeEscaper extends UnicodeEscaper {
+
+    /**
+     * <p>
+     * Constructs a <code>JavaUnicodeEscaper</code> above the specified value 
(exclusive).
+     * </p>
+     * 
+     * @param codepoint
+     *            above which to escape
+     * @return the newly created {@code UnicodeEscaper} instance
+     */
+    public static JavaUnicodeEscaper above(final int codepoint) {
+        return outsideOf(0, codepoint);
+    }
+
+    /**
+     * <p>
+     * Constructs a <code>JavaUnicodeEscaper</code> below the specified value 
(exclusive).
+     * </p>
+     * 
+     * @param codepoint
+     *            below which to escape
+     * @return the newly created {@code UnicodeEscaper} instance
+     */
+    public static JavaUnicodeEscaper below(final int codepoint) {
+        return outsideOf(codepoint, Integer.MAX_VALUE);
+    }
+
+    /**
+     * <p>
+     * Constructs a <code>JavaUnicodeEscaper</code> between the specified 
values (inclusive).
+     * </p>
+     * 
+     * @param codepointLow
+     *            above which to escape
+     * @param codepointHigh
+     *            below which to escape
+     * @return the newly created {@code UnicodeEscaper} instance
+     */
+    public static JavaUnicodeEscaper between(final int codepointLow, final int 
codepointHigh) {
+        return new JavaUnicodeEscaper(codepointLow, codepointHigh, true);
+    }
+
+    /**
+     * <p>
+     * Constructs a <code>JavaUnicodeEscaper</code> outside of the specified 
values (exclusive).
+     * </p>
+     * 
+     * @param codepointLow
+     *            below which to escape
+     * @param codepointHigh
+     *            above which to escape
+     * @return the newly created {@code UnicodeEscaper} instance
+     */
+    public static JavaUnicodeEscaper outsideOf(final int codepointLow, final 
int codepointHigh) {
+        return new JavaUnicodeEscaper(codepointLow, codepointHigh, false);
+    }
+
+    /**
+     * <p>
+     * Constructs a <code>JavaUnicodeEscaper</code> for the specified range. 
This is the underlying method for the
+     * other constructors/builders. The <code>below</code> and 
<code>above</code> boundaries are inclusive when
+     * <code>between</code> is <code>true</code> and exclusive when it is 
<code>false</code>.
+     * </p>
+     * 
+     * @param below
+     *            int value representing the lowest codepoint boundary
+     * @param above
+     *            int value representing the highest codepoint boundary
+     * @param between
+     *            whether to escape between the boundaries or outside them
+     */
+    public JavaUnicodeEscaper(final int below, final int above, final boolean 
between) {
+        super(below, above, between);
+    }
+
+    /**
+     * Converts the given codepoint to a hex string of the form {@code 
"\\uXXXX\\uXXXX"}
+     * 
+     * @param codepoint
+     *            a Unicode code point
+     * @return the hex string for the given codepoint
+     */
+    @Override
+    protected String toUtf16Escape(final int codepoint) {
+        final char[] surrogatePair = Character.toChars(codepoint);
+        return "\\u" + hex(surrogatePair[0]) + "\\u" + hex(surrogatePair[1]);
+    }
+
+}

http://git-wip-us.apache.org/repos/asf/commons-text/blob/4d927351/src/main/java/org/apache/commons/text/beta/translate/LookupTranslator.java
----------------------------------------------------------------------
diff --git 
a/src/main/java/org/apache/commons/text/beta/translate/LookupTranslator.java 
b/src/main/java/org/apache/commons/text/beta/translate/LookupTranslator.java
new file mode 100644
index 0000000..588fa9b
--- /dev/null
+++ b/src/main/java/org/apache/commons/text/beta/translate/LookupTranslator.java
@@ -0,0 +1,97 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * 
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.text.beta.translate;
+
+import java.io.IOException;
+import java.io.Writer;
+import java.security.InvalidParameterException;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.Map;
+
+/**
+ * Translates a value using a lookup table.
+ *
+ * @since 1.0
+ */
+public class LookupTranslator extends CharSequenceTranslator {
+
+    private final Map<String, String> lookupMap;
+    private final HashSet<Character> prefixSet;
+    private final int shortest;
+    private final int longest;
+
+    /**
+     * Define the lookup table to be used in translation
+     *
+     * Note that, as of Lang 3.1 (the orgin of this code), the key to the 
lookup
+     * table is converted to a java.lang.String. This is because we need the 
key
+     * to support hashCode and equals(Object), allowing it to be the key for a
+     * HashMap. See LANG-882.
+     *
+     * @param lookupMap Map&lt;CharSequence, CharSequence&gt; table of 
translator
+     *                  mappings
+     */
+    public LookupTranslator(final Map<CharSequence, CharSequence> lookupMap) {
+        if (lookupMap == null) {
+            throw new InvalidParameterException("lookupMap cannot be null");
+        }
+        this.lookupMap = new HashMap<>();
+        prefixSet = new HashSet<>();
+        int _shortest = Integer.MAX_VALUE;
+        int _longest = 0;
+        for (final CharSequence key : lookupMap.keySet()) {
+            this.lookupMap.put(key.toString(),
+                    lookupMap.get(key).toString());
+            this.prefixSet.add(key.charAt(0));
+            final int sz = key.length();
+            if (sz < _shortest) {
+                _shortest = sz;
+            }
+            if (sz > _longest) {
+                _longest = sz;
+            }
+        }
+        shortest = _shortest;
+        longest = _longest;
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    @Override
+    public int translate(final CharSequence input, final int index, final 
Writer out) throws IOException {
+        // check if translation exists for the input at position index
+        if (prefixSet.contains(input.charAt(index))) {
+            int max = longest;
+            if (index + longest > input.length()) {
+                max = input.length() - index;
+            }
+            // implement greedy algorithm by trying maximum match first
+            for (int i = max; i >= shortest; i--) {
+                final CharSequence subSeq = input.subSequence(index, index + 
i);
+                final String result = lookupMap.get(subSeq.toString());
+
+                if (result != null) {
+                    out.write(result);
+                    return i;
+                }
+            }
+        }
+        return 0;
+    }
+}

http://git-wip-us.apache.org/repos/asf/commons-text/blob/4d927351/src/main/java/org/apache/commons/text/beta/translate/NumericEntityEscaper.java
----------------------------------------------------------------------
diff --git 
a/src/main/java/org/apache/commons/text/beta/translate/NumericEntityEscaper.java
 
b/src/main/java/org/apache/commons/text/beta/translate/NumericEntityEscaper.java
new file mode 100644
index 0000000..ab6f4e0
--- /dev/null
+++ 
b/src/main/java/org/apache/commons/text/beta/translate/NumericEntityEscaper.java
@@ -0,0 +1,118 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.text.beta.translate;
+
+import java.io.IOException;
+import java.io.Writer;
+
+/**
+ * Translates codepoints to their XML numeric entity escaped value.
+ *
+ * @since 1.0
+ */
+public class NumericEntityEscaper extends CodePointTranslator {
+
+    private final int below;
+    private final int above;
+    private final boolean between;
+
+    /**
+     * <p>Constructs a <code>NumericEntityEscaper</code> for the specified 
range. This is
+     * the underlying method for the other constructors/builders. The 
<code>below</code>
+     * and <code>above</code> boundaries are inclusive when 
<code>between</code> is
+     * <code>true</code> and exclusive when it is <code>false</code>. </p>
+     *
+     * @param below int value representing the lowest codepoint boundary
+     * @param above int value representing the highest codepoint boundary
+     * @param between whether to escape between the boundaries or outside them
+     */
+    private NumericEntityEscaper(final int below, final int above, final 
boolean between) {
+        this.below = below;
+        this.above = above;
+        this.between = between;
+    }
+
+    /**
+     * <p>Constructs a <code>NumericEntityEscaper</code> for all characters. 
</p>
+     */
+    public NumericEntityEscaper() {
+        this(0, Integer.MAX_VALUE, true);
+    }
+
+    /**
+     * <p>Constructs a <code>NumericEntityEscaper</code> below the specified 
value (exclusive). </p>
+     *
+     * @param codepoint below which to escape
+     * @return the newly created {@code NumericEntityEscaper} instance
+     */
+    public static NumericEntityEscaper below(final int codepoint) {
+        return outsideOf(codepoint, Integer.MAX_VALUE);
+    }
+
+    /**
+     * <p>Constructs a <code>NumericEntityEscaper</code> above the specified 
value (exclusive). </p>
+     *
+     * @param codepoint above which to escape
+     * @return the newly created {@code NumericEntityEscaper} instance
+     */
+    public static NumericEntityEscaper above(final int codepoint) {
+        return outsideOf(0, codepoint);
+    }
+
+    /**
+     * <p>Constructs a <code>NumericEntityEscaper</code> between the specified 
values (inclusive). </p>
+     *
+     * @param codepointLow above which to escape
+     * @param codepointHigh below which to escape
+     * @return the newly created {@code NumericEntityEscaper} instance
+     */
+    public static NumericEntityEscaper between(final int codepointLow, final 
int codepointHigh) {
+        return new NumericEntityEscaper(codepointLow, codepointHigh, true);
+    }
+
+    /**
+     * <p>Constructs a <code>NumericEntityEscaper</code> outside of the 
specified values (exclusive). </p>
+     *
+     * @param codepointLow below which to escape
+     * @param codepointHigh above which to escape
+     * @return the newly created {@code NumericEntityEscaper} instance
+     */
+    public static NumericEntityEscaper outsideOf(final int codepointLow, final 
int codepointHigh) {
+        return new NumericEntityEscaper(codepointLow, codepointHigh, false);
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    @Override
+    public boolean translate(final int codepoint, final Writer out) throws 
IOException {
+        if(between) {
+            if (codepoint < below || codepoint > above) {
+                return false;
+            }
+        } else {
+            if (codepoint >= below && codepoint <= above) {
+                return false;
+            }
+        }
+
+        out.write("&#");
+        out.write(Integer.toString(codepoint, 10));
+        out.write(';');
+        return true;
+    }
+}

http://git-wip-us.apache.org/repos/asf/commons-text/blob/4d927351/src/main/java/org/apache/commons/text/beta/translate/NumericEntityUnescaper.java
----------------------------------------------------------------------
diff --git 
a/src/main/java/org/apache/commons/text/beta/translate/NumericEntityUnescaper.java
 
b/src/main/java/org/apache/commons/text/beta/translate/NumericEntityUnescaper.java
new file mode 100644
index 0000000..6d7b8c9
--- /dev/null
+++ 
b/src/main/java/org/apache/commons/text/beta/translate/NumericEntityUnescaper.java
@@ -0,0 +1,138 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * 
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.text.beta.translate;
+
+import java.io.IOException;
+import java.io.Writer;
+import java.util.Arrays;
+import java.util.EnumSet;
+
+/**
+ * Translate XML numeric entities of the form &amp;#[xX]?\d+;? to 
+ * the specific codepoint.
+ *
+ * Note that the semi-colon is optional.
+ *
+ * @since 1.0
+ */
+public class NumericEntityUnescaper extends CharSequenceTranslator {
+
+    public static enum OPTION { semiColonRequired, semiColonOptional, 
errorIfNoSemiColon }
+
+    // TODO?: Create an OptionsSet class to hide some of the conditional logic 
below
+    private final EnumSet<OPTION> options;
+
+    /**
+     * Create a UnicodeUnescaper.
+     *
+     * The constructor takes a list of options, only one type of which is 
currently 
+     * available (whether to allow, error or ignore the semi-colon on the end 
of a 
+     * numeric entity to being missing).
+     *
+     * For example, to support numeric entities without a ';':
+     *    new 
NumericEntityUnescaper(NumericEntityUnescaper.OPTION.semiColonOptional)
+     * and to throw an IllegalArgumentException when they're missing:
+     *    new 
NumericEntityUnescaper(NumericEntityUnescaper.OPTION.errorIfNoSemiColon)
+     *
+     * Note that the default behaviour is to ignore them. 
+     *
+     * @param options to apply to this unescaper
+     */
+    public NumericEntityUnescaper(final OPTION... options) {
+        if(options.length > 0) {
+            this.options = EnumSet.copyOf(Arrays.asList(options));
+        } else {
+            this.options = EnumSet.copyOf(Arrays.asList(new OPTION[] { 
OPTION.semiColonRequired }));
+        }
+    }
+
+    /**
+     * Whether the passed in option is currently set.
+     *
+     * @param option to check state of
+     * @return whether the option is set
+     */
+    public boolean isSet(final OPTION option) { 
+        return options == null ? false : options.contains(option);
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    @Override
+    public int translate(final CharSequence input, final int index, final 
Writer out) throws IOException {
+        final int seqEnd = input.length();
+        // Uses -2 to ensure there is something after the &#
+        if(input.charAt(index) == '&' && index < seqEnd - 2 && 
input.charAt(index + 1) == '#') {
+            int start = index + 2;
+            boolean isHex = false;
+
+            final char firstChar = input.charAt(start);
+            if(firstChar == 'x' || firstChar == 'X') {
+                start++;
+                isHex = true;
+
+                // Check there's more than just an x after the &#
+                if(start == seqEnd) {
+                    return 0;
+                }
+            }
+
+            int end = start;
+            // Note that this supports character codes without a ; on the end
+            while(end < seqEnd && ( input.charAt(end) >= '0' && 
input.charAt(end) <= '9' ||
+                                    input.charAt(end) >= 'a' && 
input.charAt(end) <= 'f' ||
+                                    input.charAt(end) >= 'A' && 
input.charAt(end) <= 'F' ) )
+            {
+                end++;
+            }
+
+            final boolean semiNext = end != seqEnd && input.charAt(end) == ';';
+
+            if(!semiNext) {
+                if(isSet(OPTION.semiColonRequired)) {
+                    return 0;
+                } else
+                if(isSet(OPTION.errorIfNoSemiColon)) {
+                    throw new IllegalArgumentException("Semi-colon required at 
end of numeric entity");
+                }
+            }
+
+            int entityValue;
+            try {
+                if(isHex) {
+                    entityValue = Integer.parseInt(input.subSequence(start, 
end).toString(), 16);
+                } else {
+                    entityValue = Integer.parseInt(input.subSequence(start, 
end).toString(), 10);
+                }
+            } catch(final NumberFormatException nfe) {
+                return 0;
+            }
+
+            if(entityValue > 0xFFFF) {
+                final char[] chrs = Character.toChars(entityValue);
+                out.write(chrs[0]);
+                out.write(chrs[1]);
+            } else {
+                out.write(entityValue);
+            }
+
+            return 2 + end - start + (isHex ? 1 : 0) + (semiNext ? 1 : 0);
+        }
+        return 0;
+    }
+}

http://git-wip-us.apache.org/repos/asf/commons-text/blob/4d927351/src/main/java/org/apache/commons/text/beta/translate/OctalUnescaper.java
----------------------------------------------------------------------
diff --git 
a/src/main/java/org/apache/commons/text/beta/translate/OctalUnescaper.java 
b/src/main/java/org/apache/commons/text/beta/translate/OctalUnescaper.java
new file mode 100644
index 0000000..e30ff09
--- /dev/null
+++ b/src/main/java/org/apache/commons/text/beta/translate/OctalUnescaper.java
@@ -0,0 +1,79 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * 
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.text.beta.translate;
+
+import java.io.IOException;
+import java.io.Writer;
+
+/**
+ * Translate escaped octal Strings back to their octal values.
+ *
+ * For example, "\45" should go back to being the specific value (a %).
+ *
+ * Note that this currently only supports the viable range of octal for Java; 
namely 
+ * 1 to 377. This is because parsing Java is the main use case.
+ *
+ * @since 1.0
+ */
+public class OctalUnescaper extends CharSequenceTranslator {
+
+    /**
+     * {@inheritDoc}
+     */
+    @Override
+    public int translate(final CharSequence input, final int index, final 
Writer out) throws IOException {
+        final int remaining = input.length() - index - 1; // how many 
characters left, ignoring the first \
+        final StringBuilder builder = new StringBuilder();
+        if(input.charAt(index) == '\\' && remaining > 0 && 
isOctalDigit(input.charAt(index + 1)) ) {
+            final int next = index + 1;
+            final int next2 = index + 2;
+            final int next3 = index + 3;
+
+            // we know this is good as we checked it in the if block above
+            builder.append(input.charAt(next));
+
+            if(remaining > 1 && isOctalDigit(input.charAt(next2))) {
+                builder.append(input.charAt(next2));
+                if(remaining > 2 && isZeroToThree(input.charAt(next)) && 
isOctalDigit(input.charAt(next3))) {
+                    builder.append(input.charAt(next3));
+                }
+            }
+
+            out.write( Integer.parseInt(builder.toString(), 8) );
+            return 1 + builder.length();
+        }
+        return 0;
+    }
+
+    /**
+     * Checks if the given char is an octal digit. Octal digits are the 
character representations of the digits 0 to 7.
+     * @param ch the char to check
+     * @return true if the given char is the character representation of one 
of the digits from 0 to 7
+     */
+    private boolean isOctalDigit(final char ch) {
+        return ch >= '0' && ch <= '7';
+    }
+
+    /**
+     * Checks if the given char is the character representation of one of the 
digit from 0 to 3.
+     * @param ch the char to check
+     * @return true if the given char is the character representation of one 
of the digits from 0 to 3
+     */
+    private boolean isZeroToThree(final char ch) {
+        return ch >= '0' && ch <= '3';
+    }
+}

http://git-wip-us.apache.org/repos/asf/commons-text/blob/4d927351/src/main/java/org/apache/commons/text/beta/translate/SingleLookupTranslator.java
----------------------------------------------------------------------
diff --git 
a/src/main/java/org/apache/commons/text/beta/translate/SingleLookupTranslator.java
 
b/src/main/java/org/apache/commons/text/beta/translate/SingleLookupTranslator.java
new file mode 100644
index 0000000..37700c0
--- /dev/null
+++ 
b/src/main/java/org/apache/commons/text/beta/translate/SingleLookupTranslator.java
@@ -0,0 +1,141 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.text.beta.translate;
+
+import java.io.IOException;
+import java.io.Writer;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.Map;
+
+/**
+ * Translates a value using a lookup table.
+ * But doesn't translate if that value is already translated.
+ *
+ * @since 1.0
+ */
+public class SingleLookupTranslator extends CharSequenceTranslator {
+
+    private final Map<String, String> lookupMap;
+    private final HashSet<Character>      prefixSet;
+    private final int                     shortest;
+    private final int                     longest;
+    private final int                     shortestValue;
+    private final int                     longestValue;
+
+    /**
+     * Define the look tables to be used in translation.
+     *
+     * Note that, as of Lang 3.1, the key to the lookup table is converted to a
+     * java.lang.String. This is because we need the key to support hashCode 
and
+     * equals(Object), allowing it to be the key for a HashMap. See LANG-882.
+     *
+     * Also note that, multiple lookup tables should be passed to this 
translator
+     * instead of passing multiple instances of this translator to the
+     * AggregateTranslator. Because, this translator only checks the values of 
the
+     * lookup table passed to this instance while deciding whether a value is
+     * already translated or not.
+     *
+     * @param inputMaps, an array of Map&lt;CharSequence, CharSequence&gt;.
+     */
+    public SingleLookupTranslator(Map<CharSequence, CharSequence>... 
inputMaps) {
+        Map<CharSequence, CharSequence> lookup = new HashMap<>();
+        for (Map<CharSequence, CharSequence> input : inputMaps) {
+            for(CharSequence key : input.keySet()) {
+                lookup.put(key, input.get(key));
+            }
+        }
+        lookupMap = new HashMap<String, String>();
+        prefixSet = new HashSet<Character>();
+        int _shortest = Integer.MAX_VALUE;
+        int _longest = 0;
+        int _shortestValue = Integer.MAX_VALUE;
+        int _longestValue = 0;
+        if (lookup != null) {
+            for (final CharSequence key: lookup.keySet()) {
+                this.lookupMap.put(key.toString(), lookup.get(key).toString());
+                this.prefixSet.add(key.charAt(0));
+                final int sz = key.length();
+                if (sz < _shortest) {
+                    _shortest = sz;
+                }
+                if (sz > _longest) {
+                    _longest = sz;
+                }
+                final int sizeOfValue = lookup.get(key).length();
+                if (sizeOfValue < _shortestValue) {
+                    _shortestValue = sizeOfValue;
+                }
+                if (sizeOfValue > _longestValue) {
+                    _longestValue = sizeOfValue;
+                }
+            }
+        }
+        shortest = _shortest;
+        longest = _longest;
+        shortestValue = _shortestValue;
+        longestValue = _longestValue;
+    }
+
+    /**
+     * Translate a set of codepoints, represented by an int index into a 
CharSequence,
+     * into another set of codepoints. The number of codepoints consumed must 
be returned,
+     * and the only IOExceptions thrown must be from interacting with the 
Writer so that
+     * the top level API may reliably ignore StringWriter IOExceptions.
+     *
+     * @param input CharSequence that is being translated
+     * @param index int representing the current point of translation
+     * @param out   Writer to translate the text to
+     * @return int count of codepoints consumed
+     * @throws IOException if and only if the Writer produces an IOException
+     */
+    @Override
+    public int translate(CharSequence input, int index, Writer out) throws 
IOException {
+        // check if already translated
+        int maxValue = longestValue;
+        if (index + maxValue > input.length()) {
+            maxValue = input.length() - index;
+        }
+        // implement greedy algorithm to check all the possible 'value' 
matches for which we need to skip translation.
+        for (int i = maxValue; i >= shortestValue; i--) {
+            final CharSequence subSeq = input.subSequence(index, index + i);
+            // If the sub-string is already translated, return without 
translating.
+            if (lookupMap.containsValue(subSeq.toString())) {
+                return 0;
+            }
+        }
+
+        // check if translation exists for the input at position index
+        if (prefixSet.contains(input.charAt(index))) {
+            int max = longest;
+            if (index + longest > input.length()) {
+                max = input.length() - index;
+            }
+            // implement greedy algorithm by trying maximum match first
+            for (int i = max; i >= shortest; i--) {
+                final CharSequence subSeq = input.subSequence(index, index + 
i);
+                final String result = lookupMap.get(subSeq.toString());
+
+                if (result != null) {
+                    out.write(result);
+                    return i;
+                }
+            }
+        }
+        return 0;
+    }
+}

http://git-wip-us.apache.org/repos/asf/commons-text/blob/4d927351/src/main/java/org/apache/commons/text/beta/translate/SinglePassTranslator.java
----------------------------------------------------------------------
diff --git 
a/src/main/java/org/apache/commons/text/beta/translate/SinglePassTranslator.java
 
b/src/main/java/org/apache/commons/text/beta/translate/SinglePassTranslator.java
new file mode 100644
index 0000000..a8bdf45
--- /dev/null
+++ 
b/src/main/java/org/apache/commons/text/beta/translate/SinglePassTranslator.java
@@ -0,0 +1,54 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.text.beta.translate;
+
+import java.io.IOException;
+import java.io.Writer;
+
+/**
+ * Abstract translator for processing whole input in single pass.
+ * Handles initial index checking and counting of returned code points.
+ */
+abstract class SinglePassTranslator extends CharSequenceTranslator {
+
+    @Override
+    public int translate(final CharSequence input, final int index, final 
Writer out) throws IOException {
+        if (index != 0) {
+            throw new IllegalArgumentException(getClassName() + 
".translate(final CharSequence input, final int " +
+                    "index, final Writer out) can not handle a non-zero 
index.");
+        }
+
+        translateWhole(input, out);
+
+        return Character.codePointCount(input, index, input.length());
+    }
+
+    private String getClassName() {
+        final Class clazz = this.getClass();
+        return clazz.isAnonymousClass() ?  clazz.getName() : 
clazz.getSimpleName();
+    }
+
+    /**
+     * Translate whole set of code points passed in input.
+     *
+     * @param input CharSequence that is being translated
+     * @param out Writer to translate the text to
+     * @return total count of codepoints in input
+     * @throws IOException if and only if the Writer produces an IOException
+     */
+    abstract void translateWhole(final CharSequence input, final Writer out) 
throws IOException;
+}

http://git-wip-us.apache.org/repos/asf/commons-text/blob/4d927351/src/main/java/org/apache/commons/text/beta/translate/UnicodeEscaper.java
----------------------------------------------------------------------
diff --git 
a/src/main/java/org/apache/commons/text/beta/translate/UnicodeEscaper.java 
b/src/main/java/org/apache/commons/text/beta/translate/UnicodeEscaper.java
new file mode 100644
index 0000000..3b8c983
--- /dev/null
+++ b/src/main/java/org/apache/commons/text/beta/translate/UnicodeEscaper.java
@@ -0,0 +1,137 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.text.beta.translate;
+
+import java.io.IOException;
+import java.io.Writer;
+
+/**
+ * Translates codepoints to their Unicode escaped value.
+ *
+ * @since 1.0
+ */
+public class UnicodeEscaper extends CodePointTranslator {
+
+    private final int below;
+    private final int above;
+    private final boolean between;
+
+    /**
+     * <p>Constructs a <code>UnicodeEscaper</code> for all characters. </p>
+     */
+    public UnicodeEscaper(){
+        this(0, Integer.MAX_VALUE, true);
+    }
+
+    /**
+     * <p>Constructs a <code>UnicodeEscaper</code> for the specified range. 
This is
+     * the underlying method for the other constructors/builders. The 
<code>below</code>
+     * and <code>above</code> boundaries are inclusive when 
<code>between</code> is
+     * <code>true</code> and exclusive when it is <code>false</code>. </p>
+     *
+     * @param below int value representing the lowest codepoint boundary
+     * @param above int value representing the highest codepoint boundary
+     * @param between whether to escape between the boundaries or outside them
+     */
+    protected UnicodeEscaper(final int below, final int above, final boolean 
between) {
+        this.below = below;
+        this.above = above;
+        this.between = between;
+    }
+
+    /**
+     * <p>Constructs a <code>UnicodeEscaper</code> below the specified value 
(exclusive). </p>
+     *
+     * @param codepoint below which to escape
+     * @return the newly created {@code UnicodeEscaper} instance
+     */
+    public static UnicodeEscaper below(final int codepoint) {
+        return outsideOf(codepoint, Integer.MAX_VALUE);
+    }
+
+    /**
+     * <p>Constructs a <code>UnicodeEscaper</code> above the specified value 
(exclusive). </p>
+     *
+     * @param codepoint above which to escape
+     * @return the newly created {@code UnicodeEscaper} instance
+     */
+    public static UnicodeEscaper above(final int codepoint) {
+        return outsideOf(0, codepoint);
+    }
+
+    /**
+     * <p>Constructs a <code>UnicodeEscaper</code> outside of the specified 
values (exclusive). </p>
+     *
+     * @param codepointLow below which to escape
+     * @param codepointHigh above which to escape
+     * @return the newly created {@code UnicodeEscaper} instance
+     */
+    public static UnicodeEscaper outsideOf(final int codepointLow, final int 
codepointHigh) {
+        return new UnicodeEscaper(codepointLow, codepointHigh, false);
+    }
+
+    /**
+     * <p>Constructs a <code>UnicodeEscaper</code> between the specified 
values (inclusive). </p>
+     *
+     * @param codepointLow above which to escape
+     * @param codepointHigh below which to escape
+     * @return the newly created {@code UnicodeEscaper} instance
+     */
+    public static UnicodeEscaper between(final int codepointLow, final int 
codepointHigh) {
+        return new UnicodeEscaper(codepointLow, codepointHigh, true);
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    @Override
+    public boolean translate(final int codepoint, final Writer out) throws 
IOException {
+        if (between) {
+            if (codepoint < below || codepoint > above) {
+                return false;
+            }
+        } else {
+            if (codepoint >= below && codepoint <= above) {
+                return false;
+            }
+        }
+
+        // TODO: Handle potential + sign per various Unicode escape 
implementations
+        if (codepoint > 0xffff) {
+            out.write(toUtf16Escape(codepoint));
+        } else {
+          out.write("\\u");
+          out.write(HEX_DIGITS[(codepoint >> 12) & 15]);
+          out.write(HEX_DIGITS[(codepoint >> 8) & 15]);
+          out.write(HEX_DIGITS[(codepoint >> 4) & 15]);
+          out.write(HEX_DIGITS[(codepoint) & 15]);
+        }
+        return true;
+    }
+
+    /**
+     * Converts the given codepoint to a hex string of the form {@code 
"\\uXXXX"}
+     * 
+     * @param codepoint
+     *            a Unicode code point
+     * @return the hex string for the given codepoint
+     *
+     */
+    protected String toUtf16Escape(final int codepoint) {
+        return "\\u" + hex(codepoint);
+    }
+}

http://git-wip-us.apache.org/repos/asf/commons-text/blob/4d927351/src/main/java/org/apache/commons/text/beta/translate/UnicodeUnescaper.java
----------------------------------------------------------------------
diff --git 
a/src/main/java/org/apache/commons/text/beta/translate/UnicodeUnescaper.java 
b/src/main/java/org/apache/commons/text/beta/translate/UnicodeUnescaper.java
new file mode 100644
index 0000000..fcd1e3f
--- /dev/null
+++ b/src/main/java/org/apache/commons/text/beta/translate/UnicodeUnescaper.java
@@ -0,0 +1,64 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * 
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.text.beta.translate;
+
+import java.io.IOException;
+import java.io.Writer;
+
+/**
+ * Translates escaped Unicode values of the form \\u+\d\d\d\d back to 
+ * Unicode. It supports multiple 'u' characters and will work with or 
+ * without the +.
+ *
+ * @since 1.0
+ */
+public class UnicodeUnescaper extends CharSequenceTranslator {
+
+    /**
+     * {@inheritDoc}
+     */
+    @Override
+    public int translate(final CharSequence input, final int index, final 
Writer out) throws IOException {
+        if (input.charAt(index) == '\\' && index + 1 < input.length() && 
input.charAt(index + 1) == 'u') {
+            // consume optional additional 'u' chars
+            int i = 2;
+            while (index + i < input.length() && input.charAt(index + i) == 
'u') {
+                i++;
+            }
+
+            if (index + i < input.length() && input.charAt(index + i) == '+') {
+                i++;
+            }
+
+            if (index + i + 4 <= input.length()) {
+                // Get 4 hex digits
+                final CharSequence unicode = input.subSequence(index + i, 
index + i + 4);
+
+                try {
+                    final int value = Integer.parseInt(unicode.toString(), 16);
+                    out.write((char) value);
+                } catch (final NumberFormatException nfe) {
+                    throw new IllegalArgumentException("Unable to parse 
unicode value: " + unicode, nfe);
+                }
+                return i + 4;
+            }
+            throw new IllegalArgumentException("Less than 4 hex digits in 
unicode value: '" + input.subSequence(index, input.length())
+                    + "' due to end of CharSequence");
+        }
+        return 0;
+    }
+}

http://git-wip-us.apache.org/repos/asf/commons-text/blob/4d927351/src/main/java/org/apache/commons/text/beta/translate/UnicodeUnpairedSurrogateRemover.java
----------------------------------------------------------------------
diff --git 
a/src/main/java/org/apache/commons/text/beta/translate/UnicodeUnpairedSurrogateRemover.java
 
b/src/main/java/org/apache/commons/text/beta/translate/UnicodeUnpairedSurrogateRemover.java
new file mode 100644
index 0000000..d316863
--- /dev/null
+++ 
b/src/main/java/org/apache/commons/text/beta/translate/UnicodeUnpairedSurrogateRemover.java
@@ -0,0 +1,42 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.text.beta.translate;
+
+import java.io.IOException;
+import java.io.Writer;
+
+/**
+ * Helper subclass to CharSequenceTranslator to remove unpaired surrogates.
+ *
+ * @since 1.0
+ */
+public class UnicodeUnpairedSurrogateRemover extends CodePointTranslator {
+    /**
+     * Implementation of translate that throws out unpaired surrogates. 
+     * {@inheritDoc}
+     */
+    @Override
+    public boolean translate(final int codepoint, final Writer out) throws 
IOException {
+        if (codepoint >= Character.MIN_SURROGATE && codepoint <= 
Character.MAX_SURROGATE) {
+            // It's a surrogate. Write nothing and say we've translated.
+            return true;
+        }
+        // It's not a surrogate. Don't translate it.
+        return false;
+    }
+}
+

http://git-wip-us.apache.org/repos/asf/commons-text/blob/4d927351/src/main/java/org/apache/commons/text/beta/translate/package-info.java
----------------------------------------------------------------------
diff --git 
a/src/main/java/org/apache/commons/text/beta/translate/package-info.java 
b/src/main/java/org/apache/commons/text/beta/translate/package-info.java
new file mode 100644
index 0000000..6376a56
--- /dev/null
+++ b/src/main/java/org/apache/commons/text/beta/translate/package-info.java
@@ -0,0 +1,24 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * <p> An API for creating text translation routines from a set of smaller 
building blocks. Initially created to make it
+ * possible for the user to customize the rules in the StringEscapeUtils 
class.</p>
+ * <p>These classes are immutable, and therefore thread-safe.</p>
+ *
+ * @since 1.0
+ */
+package org.apache.commons.text.beta.translate;

http://git-wip-us.apache.org/repos/asf/commons-text/blob/4d927351/src/main/java/org/apache/commons/text/diff/CommandVisitor.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/text/diff/CommandVisitor.java 
b/src/main/java/org/apache/commons/text/diff/CommandVisitor.java
deleted file mode 100644
index 7e5f40f..0000000
--- a/src/main/java/org/apache/commons/text/diff/CommandVisitor.java
+++ /dev/null
@@ -1,146 +0,0 @@
-/*
- * Licensed to the Apache Software Foundation (ASF) under one or more
- * contributor license agreements.  See the NOTICE file distributed with
- * this work for additional information regarding copyright ownership.
- * The ASF licenses this file to You under the Apache License, Version 2.0
- * (the "License"); you may not use this file except in compliance with
- * the License.  You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-package org.apache.commons.text.diff;
-
-/**
- * This interface should be implemented by user object to walk
- * through {@link EditScript EditScript} objects.
- * <p>
- * Users should implement this interface in order to walk through
- * the {@link EditScript EditScript} object created by the comparison
- * of two sequences. This is a direct application of the visitor
- * design pattern. The {@link EditScript#visit EditScript.visit}
- * method takes an object implementing this interface as an argument,
- * it will perform the loop over all commands in the script and the
- * proper methods of the user class will be called as the commands are
- * encountered.
- * </p>
- * <p>
- * The implementation of the user visitor class will depend on the
- * need. Here are two examples.
- * </p>
- * <p>
- * The first example is a visitor that build the longest common
- * subsequence:
- * </p>
- * <pre>
- * import org.apache.commons.text.diff.CommandVisitor;
- *
- * import java.util.ArrayList;
- *
- * public class LongestCommonSubSequence implements CommandVisitor {
- *
- *   public LongestCommonSubSequence() {
- *     a = new ArrayList();
- *   }
- *
- *   public void visitInsertCommand(Object object) {
- *   }
- *
- *   public void visitKeepCommand(Object object) {
- *     a.add(object);
- *   }
- *
- *   public void visitDeleteCommand(Object object) {
- *   }
- *
- *   public Object[] getSubSequence() {
- *     return a.toArray();
- *   }
- *
- *   private ArrayList a;
- *
- * }
- * </pre>
- * <p>
- * The second example is a visitor that shows the commands and the way
- * they transform the first sequence into the second one:
- * <pre>
- * import org.apache.commons.text.diff.CommandVisitor;
- *
- * import java.util.Arrays;
- * import java.util.ArrayList;
- * import java.util.Iterator;
- *
- * public class ShowVisitor implements CommandVisitor {
- *
- *   public ShowVisitor(Object[] sequence1) {
- *     v = new ArrayList();
- *     v.addAll(Arrays.asList(sequence1));
- *     index = 0;
- *   }
- *
- *   public void visitInsertCommand(Object object) {
- *     v.insertElementAt(object, index++);
- *     display("insert", object);
- *   }
- *
- *   public void visitKeepCommand(Object object) {
- *     ++index;
- *     display("keep  ", object);
- *   }
- *
- *   public void visitDeleteCommand(Object object) {
- *     v.remove(index);
- *     display("delete", object);
- *   }
- *
- *   private void display(String commandName, Object object) {
- *     System.out.println(commandName + " " + object + ": " + this);
- *   }
- *
- *   public String toString() {
- *     StringBuffer buffer = new StringBuffer();
- *     for (Iterator iter = v.iterator(); iter.hasNext();) {
- *       buffer.append(' ').append(iter.next());
- *     }
- *     return buffer.toString();
- *   }
- *
- *   private ArrayList v;
- *   private int index;
- *
- * }
- * </pre>
- *
- * @param <T> object type
- * @since 1.0
- */
-public interface CommandVisitor<T> {
-
-    /**
-     * Method called when an insert command is encountered.
-     *
-     * @param object object to insert (this object comes from the second 
sequence)
-     */
-    void visitInsertCommand(T object);
-
-    /**
-     * Method called when a keep command is encountered.
-     *
-     * @param object object to keep (this object comes from the first sequence)
-     */
-    void visitKeepCommand(T object);
-
-    /**
-     * Method called when a delete command is encountered.
-     *
-     * @param object object to delete (this object comes from the first 
sequence)
-     */
-    void visitDeleteCommand(T object);
-
-}

http://git-wip-us.apache.org/repos/asf/commons-text/blob/4d927351/src/main/java/org/apache/commons/text/diff/DeleteCommand.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/text/diff/DeleteCommand.java 
b/src/main/java/org/apache/commons/text/diff/DeleteCommand.java
deleted file mode 100644
index 8173718..0000000
--- a/src/main/java/org/apache/commons/text/diff/DeleteCommand.java
+++ /dev/null
@@ -1,56 +0,0 @@
-/*
- * Licensed to the Apache Software Foundation (ASF) under one or more
- * contributor license agreements.  See the NOTICE file distributed with
- * this work for additional information regarding copyright ownership.
- * The ASF licenses this file to You under the Apache License, Version 2.0
- * (the "License"); you may not use this file except in compliance with
- * the License.  You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-package org.apache.commons.text.diff;
-
-/**
- * Command representing the deletion of one object of the first sequence.
- * <p>
- * When one object of the first sequence has no corresponding object in the
- * second sequence at the right place, the {@link EditScript edit script}
- * transforming the first sequence into the second sequence uses an instance of
- * this class to represent the deletion of this object. The objects embedded in
- * these type of commands always come from the first sequence.
- * </p>
- *
- * @see StringsComparator
- * @see EditScript
- *
- * @param <T> object type
- * @since 1.0
- */
-public class DeleteCommand<T> extends EditCommand<T> {
-
-    /**
-     * Simple constructor. Creates a new instance of {@link DeleteCommand}.
-     *
-     * @param object  the object of the first sequence that should be deleted
-     */
-    public DeleteCommand(final T object) {
-        super(object);
-    }
-
-    /**
-     * Accept a visitor. When a <code>DeleteCommand</code> accepts a visitor, 
it calls
-     * its {@link CommandVisitor#visitDeleteCommand visitDeleteCommand} method.
-     *
-     * @param visitor  the visitor to be accepted
-     */
-    @Override
-    public void accept(final CommandVisitor<T> visitor) {
-        visitor.visitDeleteCommand(getObject());
-    }
-}

http://git-wip-us.apache.org/repos/asf/commons-text/blob/4d927351/src/main/java/org/apache/commons/text/diff/EditCommand.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/text/diff/EditCommand.java 
b/src/main/java/org/apache/commons/text/diff/EditCommand.java
deleted file mode 100644
index 7920206..0000000
--- a/src/main/java/org/apache/commons/text/diff/EditCommand.java
+++ /dev/null
@@ -1,88 +0,0 @@
-/*
- * Licensed to the Apache Software Foundation (ASF) under one or more
- * contributor license agreements.  See the NOTICE file distributed with
- * this work for additional information regarding copyright ownership.
- * The ASF licenses this file to You under the Apache License, Version 2.0
- * (the "License"); you may not use this file except in compliance with
- * the License.  You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-package org.apache.commons.text.diff;
-
-/**
- * Abstract base class for all commands used to transform an objects sequence
- * into another one.
- * <p>
- * When two objects sequences are compared through the
- * {@link StringsComparator#getScript StringsComparator.getScript} method,
- * the result is provided has a {@link EditScript script} containing the 
commands
- * that progressively transform the first sequence into the second one.
- * </p>
- * <p>
- * There are only three types of commands, all of which are subclasses of this
- * abstract class. Each command is associated with one object belonging to at
- * least one of the sequences. These commands are {@link InsertCommand
- * InsertCommand} which correspond to an object of the second sequence being
- * inserted into the first sequence, {@link DeleteCommand DeleteCommand} which
- * correspond to an object of the first sequence being removed and
- * {@link KeepCommand KeepCommand} which correspond to an object of the first
- * sequence which <code>equals</code> an object in the second sequence. It is
- * guaranteed that comparison is always performed this way (i.e. the
- * <code>equals</code> method of the object from the first sequence is used and
- * the object passed as an argument comes from the second sequence) ; this can
- * be important if subclassing is used for some elements in the first sequence
- * and the <code>equals</code> method is specialized.
- * </p>
- *
- * <p>
- * This code has been adapted from Apache Commons Collections 4.0.
- * </p>
- *
- * @see StringsComparator
- * @see EditScript
- *
- * @param <T> object type
- * @since 1.0
- */
-public abstract class EditCommand<T> {
-
-    /** Object on which the command should be applied. */
-    private final T object;
-
-    /**
-     * Simple constructor. Creates a new instance of EditCommand
-     *
-     * @param object  reference to the object associated with this command, 
this
-     *   refers to an element of one of the sequences being compared
-     */
-    protected EditCommand(final T object) {
-        this.object = object;
-    }
-
-    /**
-     * Returns the object associated with this command.
-     *
-     * @return the object on which the command is applied
-     */
-    protected T getObject() {
-        return object;
-    }
-
-    /**
-     * Accept a visitor.
-     * <p>
-     * This method is invoked for each commands belonging to
-     * an {@link EditScript EditScript}, in order to implement the visitor 
design pattern
-     *
-     * @param visitor  the visitor to be accepted
-     */
-    public abstract void accept(CommandVisitor<T> visitor);
-
-}

Reply via email to