1 /*
2 * Copyright (c) 1999, 2015, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation.
8 *
9 * This code is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
12 * version 2 for more details (a copy is included in the LICENSE file that
13 * accompanied this code).
14 *
15 * You should have received a copy of the GNU General Public License version
16 * 2 along with this work; if not, write to the Free Software Foundation,
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18 *
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20 * or visit www.oracle.com if you need additional information or have any
21 * questions.
22 */
23
24 package javax.xml.parsers.ptests;
25
26 import static org.testng.Assert.assertFalse;
27 import static org.testng.Assert.assertNull;
28 import static org.testng.Assert.assertTrue;
29 import javax.xml.parsers.SAXParser;
30 import javax.xml.parsers.SAXParserFactory;
31 import jaxp.library.JAXPBaseTest;
32 import static org.testng.Assert.assertNotNull;
33 import org.testng.annotations.DataProvider;
34 import org.testng.annotations.Test;
35 import org.xml.sax.SAXException;
36 import org.xml.sax.SAXNotSupportedException;
37 import org.xml.sax.ext.DeclHandler;
38 import org.xml.sax.ext.LexicalHandler;
39
40 /**
41 * Class contains the test cases for SAXParser API
42 */
43 public class SAXParserTest02 extends JAXPBaseTest {
44 private static final String DOM_NODE = "http://xml.org/sax/properties/dom-node";
45 private static final String XML_STRING = "http://xml.org/sax/properties/xml-string";
46 private static final String DECL_HANDLER = "http://xml.org/sax/properties/declaration-handler";
47 private static final String LEXICAL_HANDLER = "http://xml.org/sax/properties/lexical-handler";
48
49 /**
50 * Provide SAXParser.
51 *
52 * @return a data provider contains a SAXParser instance.
53 * @throws Exception If any errors occur.
54 */
55 @DataProvider(name = "parser-provider")
56 public Object[][] getParser() throws Exception {
57 SAXParserFactory spf = SAXParserFactory.newInstance();
58 SAXParser saxparser = spf.newSAXParser();
59 return new Object[][] { { saxparser } };
60 }
61
62 /**
63 * Test to test the default functionality (No validation) of the parser.
64 *
65 * @param saxparser a SAXParser instance.
66 */
67 @Test(dataProvider = "parser-provider")
68 public void testValidate01(SAXParser saxparser) {
69 assertFalse(saxparser.isValidating());
70 }
71
72 /**
73 * Test to test the functionality of setValidating and isValidating
74 * methods.
75 *
76 * @throws Exception If any errors occur.
77 */
78 @Test
79 public void testValidate02() throws Exception {
80 SAXParserFactory spf = SAXParserFactory.newInstance();
81 spf.setValidating(true);
82 spf.newSAXParser();
83 assertTrue(spf.isValidating());
84 }
85
86 /**
87 * Test isNamespaceAware() method. By default, namespaces are
88 * not supported.
89 *
90 * @param saxparser a SAXParser instance.
91 */
92 @Test(dataProvider = "parser-provider")
93 public void testNamespace01(SAXParser saxparser) {
94 assertFalse(saxparser.isNamespaceAware());
95 }
96
97 /**
98 * Test case to test setnamespaceAware() method.
99 *
100 * @throws Exception If any errors occur.
101 */
102 @Test
103 public void testNamespace02() throws Exception {
104 SAXParserFactory spf = SAXParserFactory.newInstance();
105 spf.setNamespaceAware(true);
106 SAXParser saxparser = spf.newSAXParser();
107 assertTrue(saxparser.isNamespaceAware());
108 }
109
110 /**
111 * Test case to test if the getParser() method returns instance of Parser.
112 *
113 * @param saxparser a SAXParser instance.
114 * @throws SAXException If any parse errors occur.
115 */
116 @Test(dataProvider = "parser-provider")
117 public void testParser01(SAXParser saxparser) throws SAXException {
118 assertNotNull(saxparser.getParser());
119 }
120
121 /**
122 * Test case to test if the getXMLReader() method returns instance of
123 * XMLReader.
124 *
125 * @param saxparser a SAXParser instance.
126 * @throws SAXException If any parse errors occur.
127 */
128 @Test(dataProvider = "parser-provider")
129 public void testXmlReader01(SAXParser saxparser) throws SAXException {
130 assertNotNull(saxparser.getXMLReader());
131 }
132
133 /**
134 * Test whether the xml-string property is not supported.
135 *
136 * @param saxparser a SAXParser instance.
137 * @throws SAXException If any parse errors occur.
138 */
139 @Test(expectedExceptions = SAXNotSupportedException.class,
140 dataProvider = "parser-provider")
141 public void testProperty01(SAXParser saxparser) throws SAXException {
142 saxparser.getProperty(XML_STRING);
143 }
144
145 /**
146 * Test whether the dom-node property is not supported.
147 *
148 * @param saxparser a SAXParser instance.
149 * @throws SAXException If any parse errors occur.
150 */
151 @Test(expectedExceptions = SAXNotSupportedException.class,
152 dataProvider = "parser-provider")
153 public void testProperty02(SAXParser saxparser) throws SAXException {
154 saxparser.getProperty(DOM_NODE);
155 }
156
157 /**
158 * Test the default lexical-handler not exists.
159 *
160 * @param saxparser a SAXParser instance.
161 * @throws SAXException If any parse errors occur.
162 */
163 @Test(dataProvider = "parser-provider")
164 public void testProperty03(SAXParser saxparser) throws SAXException {
165 assertNull(saxparser.getProperty(LEXICAL_HANDLER));
166 }
167
168 /**
169 * Test the default declaration-handler not exists.
170 *
171 * @param saxparser a SAXParser instance.
172 * @throws SAXException If any parse errors occur.
173 */
174 @Test(dataProvider = "parser-provider")
175 public void testProperty04(SAXParser saxparser) throws SAXException {
176 assertNull(saxparser.getProperty(DECL_HANDLER));
177 }
178
179 /**
180 * Test to set and get the lexical-handler.
181 *
182 * @param saxparser a SAXParser instance.
183 * @throws SAXException If any parse errors occur.
184 */
185 @Test(dataProvider = "parser-provider")
186 public void testProperty05(SAXParser saxparser) throws SAXException {
187 MyLexicalHandler myLexicalHandler = new MyLexicalHandler();
188 saxparser.setProperty(LEXICAL_HANDLER, myLexicalHandler);
189 assertTrue(saxparser.getProperty(LEXICAL_HANDLER) instanceof LexicalHandler);
190 }
191
192 /**
193 * Test to set and get the declaration-handler.
194 *
195 * @param saxparser a SAXParser instance.
196 * @throws SAXException If any parse errors occur.
197 */
198 @Test(dataProvider = "parser-provider")
199 public void testProperty06(SAXParser saxparser) throws SAXException {
200 MyDeclHandler myDeclHandler = new MyDeclHandler();
201 saxparser.setProperty(DECL_HANDLER, myDeclHandler);
202 assertTrue(saxparser.getProperty(DECL_HANDLER) instanceof DeclHandler);
203 }
204
205 /**
206 * Customized LexicalHandler used for test. An empty implementation for
207 * LexicalHandler.
208 */
209 private class MyLexicalHandler implements LexicalHandler {
210
211 @Override
212 public void comment(char[] ch, int start, int length) {
213 }
214
215 @Override
216 public void endCDATA() {
217 }
218
219 @Override
220 public void endDTD() {
221 }
222
223 @Override
224 public void endEntity(String name) {
225 }
226
227 @Override
228 public void startCDATA() {
229 }
230
231 @Override
232 public void startDTD(String name, String publicId, String systemId) {
233 }
234
235 @Override
236 public void startEntity(String name) {
237 }
238 }
239
240 /**
241 * Customized DeclHandler used for test. An empty implementation for
242 * DeclHandler.
243 */
244 private class MyDeclHandler implements DeclHandler {
245
246 @Override
247 public void attributeDecl(String eName, String aName, String type, String valueDefault, String value) {
248 }
249
250 @Override
251 public void elementDecl(String name, String model) {
252 }
253
254 @Override
255 public void externalEntityDecl(String name, String publicId, String systemId) {
256 }
257
258 @Override
259 public void internalEntityDecl(String name, String value) {
260 }
261 }
262 }