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.IOException; 27 import javax.xml.parsers.ParserConfigurationException; 28 import javax.xml.parsers.SAXParserFactory; 29 import static jaxp.library.JAXPTestUtilities.failUnexpected; 30 import static org.testng.Assert.assertFalse; 31 import static org.testng.Assert.assertNotNull; 32 import static org.testng.Assert.assertTrue; 33 import org.testng.annotations.Test; 34 import org.xml.sax.InputSource; 35 import org.xml.sax.SAXException; 36 import org.xml.sax.SAXNotRecognizedException; 37 import org.xml.sax.SAXNotSupportedException; 38 import org.xml.sax.XMLReader; 39 import org.xml.sax.helpers.XMLFilterImpl; 40 import static org.xml.sax.ptests.SAXTestConst.XML_DIR; 41 42 /** 43 * Unit test for XMLFilter. 44 */ 45 public class XMLFilterTest { 46 /** 47 * name spaces constant. 48 */ 49 private static final String NAMESPACES = 50 "http://xml.org/sax/features/namespaces"; 51 52 /** 53 * name spaces prefixes constant. 54 */ 55 private static final String NAMESPACE_PREFIXES = 56 "http://xml.org/sax/features/namespace-prefixes"; 57 58 /** 59 * No exception expected when set a correct content handler. 60 */ 61 @Test 62 public void contentHandler01() { 63 XMLFilterImpl xmlFilter = new XMLFilterImpl(); 64 xmlFilter.setContentHandler(xmlFilter); 65 assertNotNull(xmlFilter.getContentHandler()); 66 } 67 68 /** 69 * No exception is expected when set content handler as null. 70 */ 71 @Test 72 public void contentHandler02() { 73 new XMLFilterImpl().setContentHandler(null); 74 } 75 76 /** 77 * No exception expected when set a correct entity solver. 78 */ 79 @Test 80 public void entity01() { 81 XMLFilterImpl xmlFilter = new XMLFilterImpl(); 82 xmlFilter.setEntityResolver(xmlFilter); 83 assertNotNull(xmlFilter.getEntityResolver()); 84 } 85 86 /** 87 * No exception is expected when set entity resolver as null. 88 */ 89 @Test 90 public void entity02() { 91 new XMLFilterImpl().setEntityResolver(null); 92 } 93 94 /** 95 * No exception expected when set a correct DTD handler. 96 */ 97 @Test 98 public void dtdHandler01() { 99 XMLFilterImpl xmlFilter = new XMLFilterImpl(); 100 xmlFilter.setDTDHandler(xmlFilter); 101 assertNotNull(xmlFilter.getDTDHandler()); 102 } 103 104 /** 105 * No exception is expected when set DTD handler as null. 106 */ 107 @Test 108 public void dtdHandler02() { 109 new XMLFilterImpl().setDTDHandler(null); 110 } 111 112 /** 113 * No exception expected when set a correct error handler. 114 */ 115 @Test 116 public void errorHandler01() { 117 XMLFilterImpl xmlFilter = new XMLFilterImpl(); 118 xmlFilter.setErrorHandler(xmlFilter); 119 assertNotNull(xmlFilter.getErrorHandler()); 120 } 121 122 /** 123 * No exception is expected when set error handler as null. 124 */ 125 @Test 126 public void errorHandler02() { 127 new XMLFilterImpl().setErrorHandler(null); 128 } 129 130 /** 131 * By default true is expected get namespaces feature. 132 * @throws SAXException 133 */ 134 @Test 135 public void getFeature01() throws SAXException { 136 try { 137 SAXParserFactory spf = SAXParserFactory.newInstance(); 138 spf.setNamespaceAware(true); 139 XMLReader xmlReader = spf.newSAXParser().getXMLReader(); 140 141 XMLFilterImpl xmlFilter = new XMLFilterImpl(); 142 xmlFilter.setParent(xmlReader); 143 assertTrue(xmlFilter.getFeature(NAMESPACES)); 144 } catch (SAXException | ParserConfigurationException ex) { 145 failUnexpected(ex); 146 } 147 } 148 149 /** 150 * By default false is expected get namespaces-prefix feature. 151 */ 152 @Test 153 public void getFeature02() { 154 try { 155 SAXParserFactory spf = SAXParserFactory.newInstance(); 156 spf.setNamespaceAware(true); 157 XMLReader xmlReader = spf.newSAXParser().getXMLReader(); 158 159 XMLFilterImpl xmlFilter = new XMLFilterImpl(); 160 xmlFilter.setParent(xmlReader); 161 assertFalse(xmlFilter.getFeature(NAMESPACE_PREFIXES)); 162 } catch (SAXException | ParserConfigurationException ex) { 163 failUnexpected(ex); 164 } 165 } 166 167 /** 168 * SAXNotRecognizedException is expected when get a feature by an invalid 169 * feature name. 170 * @throws org.xml.sax.SAXNotRecognizedException If the feature 171 * value can't be assigned or retrieved from the parent. 172 * @throws org.xml.sax.SAXNotSupportedException When the 173 * parent recognizes the feature name but 174 * cannot determine its value at this time. 175 */ 176 @Test(expectedExceptions = SAXNotRecognizedException.class) 177 public void getFeature03() throws SAXNotRecognizedException, 178 SAXNotSupportedException { 179 new XMLFilterImpl().getFeature("no-meaning-feature"); 180 } 181 182 /** 183 * Set namespaces feature to a value to XMLFilter. it's expected same when 184 * obtain it again. 185 */ 186 @Test 187 public void setFeature01() { 188 try { 189 SAXParserFactory spf = SAXParserFactory.newInstance(); 190 spf.setNamespaceAware(true); 191 XMLReader xmlReader = spf.newSAXParser().getXMLReader(); 192 193 XMLFilterImpl xmlFilter = new XMLFilterImpl(); 194 xmlFilter.setParent(xmlReader); 195 xmlFilter.setFeature(NAMESPACES, false); 196 assertFalse(xmlFilter.getFeature(NAMESPACES)); 197 xmlFilter.setFeature(NAMESPACES, true); 198 assertTrue(xmlFilter.getFeature(NAMESPACES)); 199 } catch (SAXException | ParserConfigurationException ex) { 200 failUnexpected(ex); 201 } 202 } 203 204 /** 205 * Set namespaces-prefix feature to a value to XMLFilter. it's expected same 206 * when obtain it again. 207 */ 208 @Test 209 public void setFeature02() { 210 try { 211 SAXParserFactory spf = SAXParserFactory.newInstance(); 212 spf.setNamespaceAware(true); 213 XMLReader xmlReader = spf.newSAXParser().getXMLReader(); 214 215 XMLFilterImpl xmlFilter = new XMLFilterImpl(); 216 xmlFilter.setParent(xmlReader); 217 xmlFilter.setFeature(NAMESPACE_PREFIXES, false); 218 assertFalse(xmlFilter.getFeature(NAMESPACE_PREFIXES)); 219 xmlFilter.setFeature(NAMESPACE_PREFIXES, true); 220 assertTrue(xmlFilter.getFeature(NAMESPACE_PREFIXES)); 221 } catch (SAXException | ParserConfigurationException ex) { 222 failUnexpected(ex); 223 } 224 } 225 226 /** 227 * NullPointerException is expected when parse a null InputSource. 228 */ 229 @Test(expectedExceptions = NullPointerException.class) 230 public void parse01() { 231 try { 232 new XMLFilterImpl().parse((InputSource)null); 233 } catch (IOException | SAXException ex) { 234 failUnexpected(ex); 235 } 236 } 237 238 /** 239 * SAXException is expected when parsing a invalid formatted XML file. 240 * @throws org.xml.sax.SAXException when parse a incorrect formatted XML 241 * file. 242 */ 243 @Test(expectedExceptions = NullPointerException.class) 244 public void parse02() throws SAXException { 245 XMLFilterImpl xmlFilter = new XMLFilterImpl(); 246 try(FileInputStream fis = new FileInputStream(XML_DIR + "invalid.xml")) { 247 InputSource is = new InputSource(fis); 248 xmlFilter.parse(is); 249 } catch (IOException ex) { 250 failUnexpected(ex); 251 } 252 } 253 254 /** 255 * No exception when parse a normal XML file. 256 */ 257 @Test(expectedExceptions = NullPointerException.class) 258 public void parse03() { 259 XMLFilterImpl xmlFilter = new XMLFilterImpl(); 260 try(FileInputStream fis = new FileInputStream(XML_DIR + "correct2.xml")) { 261 InputSource is = new InputSource(fis); 262 xmlFilter.parse(is); 263 } catch (IOException | SAXException ex) { 264 failUnexpected(ex); 265 } 266 } 267 }