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.ContentHandler; 35 import org.xml.sax.InputSource; 36 import org.xml.sax.SAXException; 37 import org.xml.sax.SAXNotRecognizedException; 38 import org.xml.sax.SAXNotSupportedException; 39 import org.xml.sax.XMLReader; 40 import org.xml.sax.helpers.ParserAdapter; 41 import org.xml.sax.helpers.XMLFilterImpl; 42 import org.xml.sax.helpers.XMLReaderAdapter; 43 import static org.xml.sax.ptests.SAXTestConst.XML_DIR; 44 45 46 /** 47 * Unit test cases for ParserAdapter API. By default the only features recognized 48 * are namespaces and namespace-prefixes. 49 */ 50 public class ParserAdapterTest { 51 /** 52 * namespaces feature name. 53 */ 54 private static final String NAMESPACES = 55 "http://xml.org/sax/features/namespaces"; 56 57 /** 58 * namespaces-prefiexs feature name. 59 */ 60 private static final String NAMESPACE_PREFIXES = 61 "http://xml.org/sax/features/namespace-prefixes"; 62 63 /** 64 * ParserAdapter instance to share by all tests. 65 */ 66 private final ParserAdapter parserAdapter; 67 68 /** 69 * Initiate ParserAdapter. 70 * @throws ParserConfigurationException 134 /** 135 * Verifies parserAdapter.getErrorHandler() 136 */ 137 @Test 138 public void errorHandler01() { 139 XMLFilterImpl eHandler = new XMLFilterImpl(); 140 parserAdapter.setErrorHandler(eHandler); 141 assertNotNull(parserAdapter.getErrorHandler()); 142 } 143 144 /** 145 * No exception is expected when set error handler as null. 146 */ 147 @Test 148 public void errorHandler02() { 149 parserAdapter.setErrorHandler(null); 150 } 151 152 /** 153 * parserAdapter.getFeature(NAMESPACES) returns true be default. 154 */ 155 @Test 156 public void getFeature01() { 157 try { 158 assertTrue(parserAdapter.getFeature(NAMESPACES)); 159 } catch (SAXNotRecognizedException | SAXNotSupportedException ex) { 160 failUnexpected(ex); 161 } 162 } 163 164 /** 165 * parserAdapter.getFeature(NAMESPACE_PREFIXES) returns true be default. 166 */ 167 @Test 168 public void getFeature02() { 169 try { 170 assertFalse(parserAdapter.getFeature(NAMESPACE_PREFIXES)); 171 } catch (SAXNotRecognizedException | SAXNotSupportedException ex) { 172 failUnexpected(ex); 173 } 174 } 175 176 /** 177 * SAXNotRecognizedException thrown when feature name is not known one. 178 * @throws org.xml.sax.SAXNotRecognizedException expected Exception 179 */ 180 @Test(expectedExceptions = SAXNotRecognizedException.class) 181 public void getFeature03() throws SAXNotRecognizedException { 182 try { 183 parserAdapter.getFeature("no-meaning-feature"); 184 } catch (SAXNotSupportedException ex) { 185 failUnexpected(ex); 186 } 187 } 188 189 /** 190 * Obtain getFeature after it's set returns set value. 191 */ 192 @Test 193 public void setFeature01() { 194 try { 195 parserAdapter.setFeature(NAMESPACES, false); 196 assertFalse(parserAdapter.getFeature(NAMESPACES)); 197 } catch (SAXNotRecognizedException | SAXNotSupportedException ex) { 198 failUnexpected(ex); 199 } 200 } 201 202 /** 203 * Obtain getFeature after it's set returns set value. 204 */ 205 @Test 206 public void setFeature02() { 207 try { 208 parserAdapter.setFeature(NAMESPACE_PREFIXES, false); 209 assertFalse(parserAdapter.getFeature(NAMESPACE_PREFIXES)); 210 } catch (SAXNotRecognizedException | SAXNotSupportedException ex) { 211 failUnexpected(ex); 212 } 213 } 214 215 /** 216 * Obtain getFeature after it's set returns set value. 217 */ 218 @Test 219 public void setFeature03() { 220 try { 221 parserAdapter.setFeature(NAMESPACES, true); 222 assertTrue(parserAdapter.getFeature(NAMESPACES)); 223 } catch (SAXNotRecognizedException | SAXNotSupportedException ex) { 224 failUnexpected(ex); 225 } 226 } 227 228 /** 229 * Obtain getFeature after it's set returns set value. 230 */ 231 @Test 232 public void setFeature04() { 233 try { 234 parserAdapter.setFeature(NAMESPACE_PREFIXES, true); 235 assertTrue(parserAdapter.getFeature(NAMESPACE_PREFIXES)); 236 } catch (SAXNotRecognizedException | SAXNotSupportedException ex) { 237 failUnexpected(ex); 238 } 239 } 240 241 /** 242 * NPE expected when parsing a null object by ParserAdapter. 243 */ 244 @Test(expectedExceptions = NullPointerException.class) 245 public void parse01() { 246 try { 247 parserAdapter.parse((InputSource)null); 248 } catch (IOException | SAXException ex) { 249 failUnexpected(ex); 250 } 251 } 252 253 /** 254 * SAXException expected when parsing a wrong-formatter XML with ParserAdapter. 255 * @throws org.xml.sax.SAXException 256 */ 257 @Test(expectedExceptions = SAXException.class) 258 public void parse02() throws SAXException { 259 try(FileInputStream fis = new FileInputStream(XML_DIR + "invalid.xml")) { 260 InputSource is = new InputSource(fis); 261 parserAdapter.parse(is); 262 } catch (IOException ex) { 263 failUnexpected(ex); 264 } 265 } 266 267 /** 268 * Parse a well-formatter XML with ParserAdapter. 269 */ 270 @Test 271 public void parse03() { 272 try(FileInputStream fis = new FileInputStream(XML_DIR + "correct.xml")) { 273 InputSource is = new InputSource(fis); 274 parserAdapter.parse(is); 275 } catch (IOException | SAXException ex) { 276 failUnexpected(ex); 277 } 278 } 279 } | 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 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 } |