Repository: commons-lang
Updated Branches:
refs/heads/master 242e1f549 -> 59c28bb25
StrSubstitutor can preserve escapes
StrSubstitutor can now optionally preserve the escape character for an
escaped reference, which is useful when substitution takes place in
multiple phases and some references are intentionally unresolved. Prior
to this change, an unresolved reference `${a}` and an escaped reference
`$${a}` may result in the same string `${a}`, making it impossible for
an additional substitution phase to distinguish between escaped
references and non-escaped references.
Project: http://git-wip-us.apache.org/repos/asf/commons-lang/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-lang/commit/e55aaa57
Tree: http://git-wip-us.apache.org/repos/asf/commons-lang/tree/e55aaa57
Diff: http://git-wip-us.apache.org/repos/asf/commons-lang/diff/e55aaa57
Branch: refs/heads/master
Commit: e55aaa5706f031df2e8d68bdf088604c79944246
Parents: a72a5ce
Author: Samuel Karp <sk...@amazon.com>
Authored: Wed Feb 3 15:45:21 2016 -0800
Committer: Samuel Karp <sk...@amazon.com>
Committed: Thu Feb 25 17:02:56 2016 -0800
----------------------------------------------------------------------
.../commons/lang3/text/StrSubstitutor.java | 33 ++++++++++++++++++++
.../commons/lang3/text/StrSubstitutorTest.java | 15 +++++++++
2 files changed, 48 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/commons-lang/blob/e55aaa57/src/main/java/org/apache/commons/lang3/text/StrSubstitutor.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/lang3/text/StrSubstitutor.java
b/src/main/java/org/apache/commons/lang3/text/StrSubstitutor.java
index 766e161..6f8da7f 100644
--- a/src/main/java/org/apache/commons/lang3/text/StrSubstitutor.java
+++ b/src/main/java/org/apache/commons/lang3/text/StrSubstitutor.java
@@ -165,6 +165,10 @@ public class StrSubstitutor {
* The flag whether substitution in variable names is enabled.
*/
private boolean enableSubstitutionInVariables;
+ /**
+ * Whether escapes should be preserved. Default is false;
+ */
+ private boolean preserveEscapes = false;
//-----------------------------------------------------------------------
/**
@@ -768,6 +772,10 @@ public class StrSubstitutor {
// found variable start marker
if (pos > offset && chars[pos - 1] == escape) {
// escaped
+ if (preserveEscapes) {
+ pos++;
+ continue;
+ }
buf.deleteCharAt(pos - 1);
chars = buf.buffer; // in case buffer was altered
lengthChange--;
@@ -1192,4 +1200,29 @@ public class StrSubstitutor {
final boolean enableSubstitutionInVariables) {
this.enableSubstitutionInVariables = enableSubstitutionInVariables;
}
+
+ /**
+ * Returns the flag controlling whether escapes are preserved during
+ * substitution.
+ *
+ * @return the preserve escape flag
+ */
+ public boolean isPreserveEscapes() {
+ return preserveEscapes;
+ }
+
+ /**
+ * Sets a flag controlling whether escapes are preserved during
+ * substitution. If set to <b>true</b>, the escape character is retained
+ * during substitution (e.g. <code>$${this-is-escaped}</code> remains
+ * <code>$${this-is-escaped}</code>). If set to <b>false</b>, the escape
+ * character is removed during substitution (e.g.
+ * <code>$${this-is-escaped}</code> becomes
+ * <code>${this-is-escaped}</code>). The default value is <b>false</b>
+ *
+ * @param preserveEscapes
+ */
+ public void setPreserveEscapes(final boolean preserveEscapes) {
+ this.preserveEscapes = preserveEscapes;
+ }
}
http://git-wip-us.apache.org/repos/asf/commons-lang/blob/e55aaa57/src/test/java/org/apache/commons/lang3/text/StrSubstitutorTest.java
----------------------------------------------------------------------
diff --git
a/src/test/java/org/apache/commons/lang3/text/StrSubstitutorTest.java
b/src/test/java/org/apache/commons/lang3/text/StrSubstitutorTest.java
index 9c96150..2f8759f 100644
--- a/src/test/java/org/apache/commons/lang3/text/StrSubstitutorTest.java
+++ b/src/test/java/org/apache/commons/lang3/text/StrSubstitutorTest.java
@@ -623,6 +623,21 @@ public class StrSubstitutorTest {
assertEquals("Hello there commons!",
StrSubstitutor.replace("@greeting@ there @name@!", map, "@", "@"));
}
+ @Test
+ public void testSubstitutePreserveEscape() {
+ final String org = "${not-escaped} $${escaped}";
+ final Map<String, String> map = new HashMap<String, String>();
+ map.put("not-escaped", "value");
+
+ StrSubstitutor sub = new StrSubstitutor(map, "${", "}", '$');
+ assertFalse(sub.isPreserveEscapes());
+ assertEquals("value ${escaped}", sub.replace(org));
+
+ sub.setPreserveEscapes(true);
+ assertTrue(sub.isPreserveEscapes());
+ assertEquals("value $${escaped}", sub.replace(org));
+ }
+
//-----------------------------------------------------------------------
private void doTestReplace(final String expectedResult, final String
replaceTemplate, final boolean substring) {
final String expectedShortResult = expectedResult.substring(1,
expectedResult.length() - 1);
