View Javadoc
1   package org.apache.maven.doxia.util;
2   
3   /*
4    * Licensed to the Apache Software Foundation (ASF) under one
5    * or more contributor license agreements.  See the NOTICE file
6    * distributed with this work for additional information
7    * regarding copyright ownership.  The ASF licenses this file
8    * to you under the Apache License, Version 2.0 (the
9    * "License"); you may not use this file except in compliance
10   * with the License.  You may obtain a copy of the License at
11   *
12   *   http://www.apache.org/licenses/LICENSE-2.0
13   *
14   * Unless required by applicable law or agreed to in writing,
15   * software distributed under the License is distributed on an
16   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
17   * KIND, either express or implied.  See the License for the
18   * specific language governing permissions and limitations
19   * under the License.
20   */
21  
22  import java.net.URLEncoder;
23  
24  import org.codehaus.plexus.PlexusTestCase;
25  
26  /**
27   * Test case for <code>HtmlTools</code>.
28   *
29   * @author <a href="mailto:vincent.siveton@gmail.com">Vincent Siveton</a>
30   * @version $Id$
31   */
32  public class HtmlToolsTest
33      extends PlexusTestCase
34  {
35      /**
36       * Verify the expected results.
37       */
38      public void testEscapeHTML()
39      {
40          assertEquals( HtmlTools.escapeHTML( null ), "" );
41          assertEquals( HtmlTools.escapeHTML( "" ), "" );
42          assertEquals( HtmlTools.escapeHTML( "\u0009" ), "\u0009" );
43          assertEquals( HtmlTools.escapeHTML( "\u0001" ), "\u0001" );
44  
45          // Predefined entities
46          assertEquals( HtmlTools.escapeHTML( "<" ), "&lt;" );
47          assertEquals( HtmlTools.escapeHTML( ">" ), "&gt;" );
48          assertEquals( HtmlTools.escapeHTML( "&" ), "&amp;" );
49          assertEquals( HtmlTools.escapeHTML( "\"" ), "&quot;" );
50          assertEquals( HtmlTools.escapeHTML( "\'" ), "&apos;" );
51          assertEquals( HtmlTools.escapeHTML( "\'", false ), "\'" );
52  
53          // xml mode
54          assertEquals( HtmlTools.escapeHTML( "&amp;" ), "&amp;amp;" );
55          assertEquals( HtmlTools.escapeHTML( "\u00e4", true ), "\u00e4" );
56          assertEquals( HtmlTools.escapeHTML( "\u00e4", false ), "&#xe4;" );
57          assertEquals( HtmlTools.escapeHTML( "\u0159", false ), "&#x159;" );
58          assertEquals( HtmlTools.escapeHTML( "\uD835\uDFED", false ), "&#x1d7ed;" );
59      }
60  
61      /**
62       * Verify the expected results.
63       */
64      public void testUnescapeHTML()
65      {
66          assertNull( HtmlTools.unescapeHTML( null ) );
67          assertEquals( "", HtmlTools.unescapeHTML( "" ) );
68          assertEquals( "\u0009", HtmlTools.unescapeHTML( "\u0009" ) );
69          assertEquals( "\u0001", HtmlTools.unescapeHTML( "\u0001" ) );
70          assertEquals( "<", HtmlTools.unescapeHTML( "&lt;" ) );
71          assertEquals( ">", HtmlTools.unescapeHTML( "&gt;" ) );
72          assertEquals( "&", HtmlTools.unescapeHTML( "&amp;" ) );
73          assertEquals( "\"", HtmlTools.unescapeHTML( "&quot;" ) );
74          assertEquals( "&apos;", HtmlTools.unescapeHTML( "&apos;" ) );
75          assertEquals( "\'", HtmlTools.unescapeHTML( "&apos;", true ) );
76          assertEquals( "&amp;", HtmlTools.unescapeHTML( "&amp;amp;" ) );
77          assertEquals( "&lt;Fran&ccedil;ais&gt;", HtmlTools.unescapeHTML( "&amp;lt;Fran&amp;ccedil;ais&amp;gt;" ) );
78          assertEquals( "\u0159", HtmlTools.unescapeHTML( "&#x159;" ) );
79          assertEquals( "\uD808\uDF45", HtmlTools.unescapeHTML( "&#x12345;" ) );
80          assertEquals( "\uD835\uDFED", HtmlTools.unescapeHTML( "&#x1d7ed;" ) );
81          assertEquals( "\uD808\uDF45\uD835\uDFED", HtmlTools.unescapeHTML( "&#x12345;&#x1d7ed;" ) );
82          assertEquals( "&#x1d7ed &#x1d7ed", HtmlTools.unescapeHTML( "&#x1d7ed &#x1d7ed" ) );
83          assertEquals( "&#x1d7ed \uD835\uDFED", HtmlTools.unescapeHTML( "&#x1d7ed &#x1d7ed;" ) );
84          assertEquals( "&#xQWER;", HtmlTools.unescapeHTML( "&#xQWER;" ) );
85          assertEquals( "\u00E5", HtmlTools.unescapeHTML( "&#229;" ) );
86          assertEquals( "<>&\"\u00E5\u0159\uD835\uDFED",
87                        HtmlTools.unescapeHTML( "&lt;&gt;&amp;&quot;&#229;&#x159;&#x1d7ed;" ) );
88      }
89  
90      /**
91       * Verify the expected results.
92       */
93      public void testEncodeId()
94      {
95          assertEquals( HtmlTools.encodeId( null ), null );
96          assertEquals( HtmlTools.encodeId( "" ), "a" );
97          assertEquals( HtmlTools.encodeId( " " ), "a" );
98          assertEquals( HtmlTools.encodeId( " _ " ), "a_" );
99          assertEquals( HtmlTools.encodeId( "1" ), "a1" );
100         assertEquals( HtmlTools.encodeId( "1anchor" ), "a1anchor" );
101         assertEquals( HtmlTools.encodeId( "_anchor" ), "a_anchor" );
102         assertEquals( HtmlTools.encodeId( "a b-c123 " ), "a_b-c123" );
103         assertEquals( HtmlTools.encodeId( "   anchor" ), "anchor" );
104         assertEquals( HtmlTools.encodeId( "myAnchor" ), "myAnchor" );
105         assertEquals( HtmlTools.encodeId( "H\u00E5kon" ), "H.C3.A5kon" );
106         assertEquals( HtmlTools.encodeId( "Theu\u00DFl" ), "Theu.C3.9Fl" );
107     }
108 
109     /**
110      * Verify the expected results.
111      *
112      * @throws Exception should not happen.
113      */
114     public void testEncodeURL()
115         throws Exception
116     {
117         assertNull( HtmlTools.encodeURL( null ) );
118         assertEquals( HtmlTools.encodeURL( "" ), "" );
119         assertEquals( HtmlTools.encodeURL( "http://www.example.com/?This is a simple test." ),
120                       "http://www.example.com/?This%20is%20a%20simple%20test." );
121 
122         assertEquals( HtmlTools.encodeURL( "http://www.example.com/?This is a simple & short test." ),
123                       "http://www.example.com/?This%20is%20a%20simple%20&%20short%20test." );
124 
125         String url = "\uD808\uDF45";
126         assertEquals( HtmlTools.encodeURL( url ), URLEncoder.encode( url, "UTF-8" ) );
127     }
128 
129     /**
130      * Verify the expected results.
131      */
132     public void testIsId()
133     {
134         assertFalse( HtmlTools.isId( null ) );
135         assertFalse( HtmlTools.isId( "" ) );
136         assertFalse( HtmlTools.isId( " " ) );
137         assertFalse( HtmlTools.isId( " _ " ) );
138         assertFalse( HtmlTools.isId( "1" ) );
139         assertFalse( HtmlTools.isId( "1anchor" ) );
140         assertFalse( HtmlTools.isId( "_anchor" ) );
141         assertFalse( HtmlTools.isId( "a b-c123 " ) );
142         assertFalse( HtmlTools.isId( "   anchor" ) );
143         assertTrue( HtmlTools.isId( "myAnchor" ) );
144         assertTrue( HtmlTools.isId( "a_" ) );
145         assertTrue( HtmlTools.isId( "a-" ) );
146         assertTrue( HtmlTools.isId( "a:" ) );
147         assertTrue( HtmlTools.isId( "a." ) );
148         assertFalse( HtmlTools.isId( "Theu\u00DFl" ) );
149     }
150 
151     /**
152      * Verify the expected results.
153      */
154     public void testGetHtmlTag()
155     {
156         assertNull( HtmlTools.getHtmlTag( null ) );
157         assertNull( HtmlTools.getHtmlTag( "" ) );
158         assertNull( HtmlTools.getHtmlTag( "weirdHtmlTag" ) );
159         assertNotNull( HtmlTools.getHtmlTag( "strong" ) );
160     }
161 }