1   
2   
3   
4   
5   
6   
7   
8   
9   
10  
11  
12  
13  
14  
15  
16  
17  package com.google.common.escape;
18  
19  import com.google.common.annotations.GwtCompatible;
20  
21  import junit.framework.TestCase;
22  
23  
24  
25  
26  
27  
28  @GwtCompatible
29  public class UnicodeEscaperTest extends TestCase {
30  
31    private static final String SMALLEST_SURROGATE =
32        "" + Character.MIN_HIGH_SURROGATE + Character.MIN_LOW_SURROGATE;
33    private static final String LARGEST_SURROGATE =
34        "" + Character.MAX_HIGH_SURROGATE + Character.MAX_LOW_SURROGATE;
35  
36    private static final String TEST_STRING =
37        "\0abyz\u0080\u0100\u0800\u1000ABYZ\uffff" +
38        SMALLEST_SURROGATE + "0189" +  LARGEST_SURROGATE;
39  
40    
41    private static final UnicodeEscaper NOP_ESCAPER = new UnicodeEscaper() {
42      @Override
43      protected char[] escape(int c) {
44        return null;
45      }
46    };
47  
48    
49    private static final UnicodeEscaper SIMPLE_ESCAPER = new UnicodeEscaper() {
50      @Override
51      protected char[] escape(int cp) {
52        return ('a' <= cp && cp <= 'z') ||
53               ('A' <= cp && cp <= 'Z') ||
54               ('0' <= cp && cp <= '9') ? null :
55            ("[" + String.valueOf(cp) + "]").toCharArray();
56      }
57    };
58  
59    public void testNopEscaper() {
60      UnicodeEscaper e = NOP_ESCAPER;
61      assertEquals(TEST_STRING, escapeAsString(e, TEST_STRING));
62    }
63  
64    public void testSimpleEscaper() {
65      UnicodeEscaper e = SIMPLE_ESCAPER;
66      String expected =
67          "[0]abyz[128][256][2048][4096]ABYZ[65535]" +
68          "[" + Character.MIN_SUPPLEMENTARY_CODE_POINT + "]" +
69          "0189[" + Character.MAX_CODE_POINT + "]";
70      assertEquals(expected, escapeAsString(e, TEST_STRING));
71    }
72  
73    public void testGrowBuffer() { 
74      StringBuffer input = new StringBuffer();
75      StringBuffer expected = new StringBuffer();
76      for (int i = 256; i < 1024; i++) {
77        input.append((char) i);
78        expected.append("[" + i + "]");
79      }
80      assertEquals(expected.toString(), SIMPLE_ESCAPER.escape(input.toString()));
81    }
82  
83    public void testSurrogatePairs() {
84      UnicodeEscaper e = SIMPLE_ESCAPER;
85  
86      
87      final int min = Character.MIN_SUPPLEMENTARY_CODE_POINT;
88      final int max = Character.MAX_CODE_POINT;
89      final int range = max - min;
90      final int s1 = min + (1 * range) / 4;
91      final int s2 = min + (2 * range) / 4;
92      final int s3 = min + (3 * range) / 4;
93      final char[] dst = new char[12];
94  
95      
96      dst[0] = 'x';
97      Character.toChars(min, dst, 1);
98      Character.toChars(s1, dst, 3);
99      Character.toChars(s2, dst, 5);
100     Character.toChars(s3, dst, 7);
101     Character.toChars(max, dst, 9);
102     dst[11] = 'x';
103     String test = new String(dst);
104 
105     
106     String expected =
107         "x[" + min + "][" + s1 + "][" + s2 + "][" + s3 + "][" + max + "]x";
108     assertEquals(expected, escapeAsString(e, test));
109   }
110 
111   public void testTrailingHighSurrogate() {
112     String test = "abc" + Character.MIN_HIGH_SURROGATE;
113     try {
114       escapeAsString(NOP_ESCAPER, test);
115       fail("Trailing high surrogate should cause exception");
116     } catch (IllegalArgumentException expected) {
117       
118     }
119     try {
120       escapeAsString(SIMPLE_ESCAPER, test);
121       fail("Trailing high surrogate should cause exception");
122     } catch (IllegalArgumentException expected) {
123       
124     }
125   }
126 
127   public void testNullInput() {
128     UnicodeEscaper e = SIMPLE_ESCAPER;
129     try {
130       e.escape((String) null);
131       fail("Null string should cause exception");
132     } catch (NullPointerException expected) {
133       
134     }
135   }
136 
137   public void testBadStrings() {
138     UnicodeEscaper e = SIMPLE_ESCAPER;
139     String[] BAD_STRINGS = {
140         String.valueOf(Character.MIN_LOW_SURROGATE),
141         Character.MIN_LOW_SURROGATE + "xyz",
142         "abc" + Character.MIN_LOW_SURROGATE,
143         "abc" + Character.MIN_LOW_SURROGATE + "xyz",
144         String.valueOf(Character.MAX_LOW_SURROGATE),
145         Character.MAX_LOW_SURROGATE + "xyz",
146         "abc" + Character.MAX_LOW_SURROGATE,
147         "abc" + Character.MAX_LOW_SURROGATE + "xyz",
148     };
149     for (String s : BAD_STRINGS) {
150       try {
151         escapeAsString(e, s);
152         fail("Isolated low surrogate should cause exception [" + s + "]");
153       } catch (IllegalArgumentException expected) {
154         
155       }
156     }
157   }
158 
159   public void testFalsePositivesForNextEscapedIndex() {
160     UnicodeEscaper e = new UnicodeEscaper() {
161       
162       @Override
163       protected char[] escape(int cp) {
164         return ('a' <= cp && cp <= 'z') ?
165             new char[] { Character.toUpperCase((char) cp) } : null;
166       }
167       
168       @Override
169       protected int nextEscapeIndex(CharSequence csq, int index, int end) {
170         while (index < end && !Character.isLetter(csq.charAt(index))) {
171           index++;
172         }
173         return index;
174       }
175     };
176     assertEquals("\0HELLO \uD800\uDC00 WORLD!\n",
177         e.escape("\0HeLLo \uD800\uDC00 WorlD!\n"));
178   }
179   
180   public void testCodePointAt_IndexOutOfBoundsException() {
181     try {
182       UnicodeEscaper.codePointAt("Testing...", 4, 2);
183       fail();
184     } catch (IndexOutOfBoundsException expected) {
185     }
186   }
187 
188   private String escapeAsString(Escaper e, String s) {
189     return e.escape(s);
190   }
191 }