1 /* 2 * Copyright (c) 2014, 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 package org.xml.sax.ptests; 24 25 import java.io.FileInputStream; 26 import java.io.FilePermission; 27 import java.io.IOException; 28 import javax.xml.parsers.ParserConfigurationException; 29 import javax.xml.parsers.SAXParserFactory; 30 import jaxp.library.JAXPBaseTest; 31 import static org.testng.Assert.assertFalse; 32 import static org.testng.Assert.assertNotNull; 33 import static org.testng.Assert.assertTrue; 34 import org.testng.annotations.AfterGroups; 35 import org.testng.annotations.BeforeGroups; 36 import org.testng.annotations.Test; 37 import org.xml.sax.ContentHandler; 38 import org.xml.sax.InputSource; 39 import org.xml.sax.SAXException; 40 import org.xml.sax.SAXNotRecognizedException; 41 import org.xml.sax.SAXNotSupportedException; 42 import org.xml.sax.XMLReader; 43 import org.xml.sax.helpers.ParserAdapter; 44 import org.xml.sax.helpers.XMLFilterImpl; 45 import org.xml.sax.helpers.XMLReaderAdapter; 46 import static org.xml.sax.ptests.SAXTestConst.XML_DIR; 47 48 49 /** 50 * Unit test cases for ParserAdapter API. By default the only features recognized 51 * are namespaces and namespace-prefixes. 52 */ 53 public class ParserAdapterTest extends JAXPBaseTest { 54 /** 55 * namespaces feature name. 56 */ 57 private static final String NAMESPACES = 58 "http://xml.org/sax/features/namespaces"; 59 60 /** 61 * namespaces-prefiexs feature name. 62 */ 63 private static final String NAMESPACE_PREFIXES = 64 "http://xml.org/sax/features/namespace-prefixes"; 65 66 /** 67 * ParserAdapter instance to share by all tests. 68 */ 69 private final ParserAdapter parserAdapter; 70 71 /** 72 * Initiate ParserAdapter. 73 * @throws ParserConfigurationException 74 * @throws SAXException 75 */ 76 ParserAdapterTest() throws ParserConfigurationException, SAXException { 77 SAXParserFactory spf = SAXParserFactory.newInstance(); 78 XMLReader xmlReader = spf.newSAXParser().getXMLReader(); 79 XMLReaderAdapter xmlReaderAdapter = new XMLReaderAdapter(xmlReader); 80 parserAdapter = new ParserAdapter(xmlReaderAdapter); 81 } 82 83 /** 84 * Verifies parserAdapter.getContentHandler() 85 */ 86 @Test 87 public void contentHandler01() { 88 ContentHandler contentHandler = new XMLFilterImpl(); 89 parserAdapter.setContentHandler(contentHandler); 90 assertNotNull(parserAdapter.getContentHandler()); 91 } 92 93 /** 94 * No exception is expected when set content handler as null. 95 */ 96 @Test 97 public void contentHandler02() { 98 parserAdapter.setContentHandler(null); 99 } 100 101 /** 102 * Verifies parserAdapter.getEntityResolver() 103 */ 104 @Test 105 public void entity01() { 106 XMLFilterImpl xmlFilter = new XMLFilterImpl(); 107 parserAdapter.setEntityResolver(xmlFilter); 108 assertNotNull(parserAdapter.getEntityResolver()); 109 } 110 111 /** 112 * No exception is expected when set entity resolver as null. 113 */ 114 @Test 115 public void entity02() { 116 parserAdapter.setEntityResolver(null); 117 } 118 119 /** 120 * Verifies parserAdapter.getDTDHandler() 121 */ 122 @Test 123 public void dtdHandler01() { 124 XMLFilterImpl xmlFilter = new XMLFilterImpl(); 125 parserAdapter.setDTDHandler(xmlFilter); 126 assertNotNull(parserAdapter.getDTDHandler()); 127 } 128 129 /** 130 * No exception is expected when set DTD handler as null. 131 */ 132 @Test 133 public void dtdHandler02() { 134 parserAdapter.setDTDHandler(null); 135 } 136 137 /** 138 * Verifies parserAdapter.getErrorHandler() 139 */ 140 @Test 141 public void errorHandler01() { 142 XMLFilterImpl eHandler = new XMLFilterImpl(); 143 parserAdapter.setErrorHandler(eHandler); 144 assertNotNull(parserAdapter.getErrorHandler()); 145 } 146 147 /** 148 * No exception is expected when set error handler as null. 149 */ 150 @Test 151 public void errorHandler02() { 152 parserAdapter.setErrorHandler(null); 153 } 154 155 /** 156 * parserAdapter.getFeature(NAMESPACES) returns true be default. 157 * 158 * @exception SAXNotRecognizedException If the feature 159 * value can't be assigned or retrieved. 160 * @exception SAXNotSupportedException If the 161 * feature is not currently readable. 162 */ 163 @Test 164 public void getFeature01() throws SAXNotRecognizedException, SAXNotSupportedException { 165 assertTrue(parserAdapter.getFeature(NAMESPACES)); 166 } 167 168 /** 169 * parserAdapter.getFeature(NAMESPACE_PREFIXES) returns true be default. 170 * 171 * @exception SAXNotRecognizedException If the feature 172 * value can't be assigned or retrieved. 173 * @exception SAXNotSupportedException If the 174 * feature is not currently readable. 175 */ 176 @Test 177 public void getFeature02() throws SAXNotRecognizedException, SAXNotSupportedException { 178 assertFalse(parserAdapter.getFeature(NAMESPACE_PREFIXES)); 179 } 180 181 /** 182 * SAXNotRecognizedException thrown when feature name is not known one. 183 * 184 * @exception SAXNotRecognizedException If the feature 185 * value can't be assigned or retrieved. 186 * @exception SAXNotSupportedException If the 187 * feature is not currently readable. 188 */ 189 @Test(expectedExceptions = SAXNotRecognizedException.class) 190 public void getFeature03() throws SAXNotRecognizedException, SAXNotSupportedException { 191 parserAdapter.getFeature("no-meaning-feature"); 192 } 193 194 /** 195 * Obtain getFeature after it's set returns set value. 196 * 197 * @exception SAXNotRecognizedException If the feature 198 * value can't be assigned or retrieved. 199 * @exception SAXNotSupportedException If the 200 * feature is not currently readable. 201 */ 202 @Test 203 public void setFeature01() throws SAXNotRecognizedException, SAXNotSupportedException { 204 parserAdapter.setFeature(NAMESPACES, false); 205 assertFalse(parserAdapter.getFeature(NAMESPACES)); 206 } 207 208 /** 209 * Obtain getFeature after it's set returns set value. 210 * 211 * @exception SAXNotRecognizedException If the feature 212 * value can't be assigned or retrieved. 213 * @exception SAXNotSupportedException If the 214 * feature is not currently readable. 215 */ 216 @Test 217 public void setFeature02() throws SAXNotRecognizedException, SAXNotSupportedException { 218 parserAdapter.setFeature(NAMESPACE_PREFIXES, false); 219 assertFalse(parserAdapter.getFeature(NAMESPACE_PREFIXES)); 220 } 221 222 /** 223 * Obtain getFeature after it's set returns set value. 224 * 225 * @exception SAXNotRecognizedException If the feature 226 * value can't be assigned or retrieved. 227 * @exception SAXNotSupportedException If the 228 * feature is not currently readable. 229 */ 230 @Test 231 public void setFeature03() throws SAXNotRecognizedException, SAXNotSupportedException { 232 parserAdapter.setFeature(NAMESPACES, true); 233 assertTrue(parserAdapter.getFeature(NAMESPACES)); 234 } 235 236 /** 237 * Obtain getFeature after it's set returns set value. 238 * 239 * @exception SAXNotRecognizedException If the feature 240 * value can't be assigned or retrieved. 241 * @exception SAXNotSupportedException If the 242 * feature is not currently readable. 243 */ 244 @Test 245 public void setFeature04() throws SAXNotRecognizedException, 246 SAXNotSupportedException { 247 parserAdapter.setFeature(NAMESPACE_PREFIXES, true); 248 assertTrue(parserAdapter.getFeature(NAMESPACE_PREFIXES)); 249 } 250 251 /** 252 * NPE expected when parsing a null object by ParserAdapter. 253 * 254 * @throws SAXException If there is a problem processing the document. 255 * @throws IOException if the file exists but is a directory rather than 256 * a regular file, does not exist but cannot be created, or cannot 257 * be opened for any other reason. 258 */ 259 @Test(expectedExceptions = NullPointerException.class) 260 public void parse01() throws IOException, SAXException { 261 parserAdapter.parse((InputSource)null); 262 } 263 264 /** 265 * Save system property for restoring. 266 */ 267 @BeforeGroups (groups = {"readLocalFiles"}) 268 public void setFilePermissions() { 269 setPermissions(new FilePermission(XML_DIR + "/-", "read")); 270 } 271 272 /** 273 * Restore the system property. 274 */ 275 @AfterGroups (groups = {"readLocalFiles"}) 276 public void restoreFilePermissions() { 277 setPermissions(); 278 } 279 280 /** 281 * SAXException expected when parsing a wrong-formatter XML with ParserAdapter. 282 * 283 * @throws SAXException If there is a problem processing the document. 284 * @throws IOException if the file exists but is a directory rather than 285 * a regular file, does not exist but cannot be created, or cannot 286 * be opened for any other reason. 287 */ 288 @Test(groups = {"readLocalFiles"}, expectedExceptions = SAXException.class) 289 public void parse02() throws SAXException, IOException { 290 try(FileInputStream fis = new FileInputStream(XML_DIR + "invalid.xml")) { 291 InputSource is = new InputSource(fis); 292 parserAdapter.parse(is); 293 } 294 } 295 296 /** 297 * Parse a well-formatter XML with ParserAdapter. 298 * 299 * @throws SAXException If there is a problem processing the document. 300 * @throws IOException if the file exists but is a directory rather than 301 * a regular file, does not exist but cannot be created, or cannot 302 * be opened for any other reason. 303 */ 304 @Test(groups = {"readLocalFiles"}) 305 public void parse03() throws SAXException, IOException { 306 try(FileInputStream fis = new FileInputStream(XML_DIR + "correct.xml")) { 307 InputSource is = new InputSource(fis); 308 parserAdapter.parse(is); 309 } 310 } 311 }