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 
  24 package javax.xml.parsers.ptests;
  25 
  26 import static jaxp.library.JAXPTestUtilities.failUnexpected;
  27 import static org.testng.Assert.assertFalse;
  28 import static org.testng.Assert.assertNull;
  29 import static org.testng.Assert.assertTrue;
  30 
  31 import javax.xml.parsers.FactoryConfigurationError;
  32 import javax.xml.parsers.ParserConfigurationException;
  33 import javax.xml.parsers.SAXParser;
  34 import javax.xml.parsers.SAXParserFactory;
  35 
  36 import org.testng.annotations.DataProvider;
  37 import org.testng.annotations.Test;
  38 import org.xml.sax.Parser;
  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.ext.DeclHandler;
  44 import org.xml.sax.ext.LexicalHandler;
  45 
  46 /**
  47  * Class contains the test cases for SAXParser API
  48  */
  49 public class SAXParserTest02 {
  50     final String DOM_NODE = "http://xml.org/sax/properties/dom-node";
  51     final String XML_STRING = "http://xml.org/sax/properties/xml-string";
  52     final String DECL_HANDLER = "http://xml.org/sax/properties/declaration-handler";
  53     final String LEXICAL_HANDLER = "http://xml.org/sax/properties/lexical-handler";
  54 
  55     /**
  56      * Provide SAXParser.
  57      *
  58      * @throws SAXException
  59      * @throws ParserConfigurationException
  60      */
  61     @DataProvider(name = "parser-provider")
  62     public Object[][] getParser() throws ParserConfigurationException, SAXException {
  63         SAXParserFactory spf = SAXParserFactory.newInstance();
  64         SAXParser saxparser = spf.newSAXParser();
  65         return new Object[][] { { saxparser } };
  66     }
  67 
  68     /**
  69      * Testcase to test the default functionality (No validation) of the parser.
  70      */
  71     @Test(dataProvider = "parser-provider")
  72     public void testValidate01(SAXParser saxparser) {
  73         try {
  74             assertFalse(saxparser.isValidating());
  75         } catch (FactoryConfigurationError e) {
  76             failUnexpected(e);
  77         }
  78 
  79     }
  80 
  81     /**
  82      * Testcase to test the functionality of setValidating and isvalidating
  83      * methods.
  84      */
  85     @Test
  86     public void testValidate02() {
  87         try {
  88             SAXParserFactory spf = SAXParserFactory.newInstance();
  89             spf.setValidating(true);
  90             spf.newSAXParser();
  91             assertTrue(spf.isValidating());
  92         } catch (FactoryConfigurationError | ParserConfigurationException | SAXException e) {
  93             failUnexpected(e);
  94         }
  95 
  96     }
  97 
  98     /**
  99      * Test case to test isNamespaceAware() method. By default, namespaces are
 100      * not supported.
 101      */
 102     @Test(dataProvider = "parser-provider")
 103     public void testNamespace01(SAXParser saxparser) {
 104         try {
 105             assertFalse(saxparser.isNamespaceAware());
 106         } catch (FactoryConfigurationError e) {
 107             failUnexpected(e);
 108         }
 109 
 110     }
 111 
 112     /**
 113      * Test case to test setnamespaceAware() method.
 114      */
 115     @Test
 116     public void testNamespace02() {
 117         try {
 118             SAXParserFactory spf = SAXParserFactory.newInstance();
 119             spf.setNamespaceAware(true);
 120             SAXParser saxparser = spf.newSAXParser();
 121             assertTrue(saxparser.isNamespaceAware());
 122         } catch (FactoryConfigurationError | ParserConfigurationException | SAXException e) {
 123             failUnexpected(e);
 124         }
 125 
 126     }
 127 
 128     /**
 129      * Test case to test if the getParser() method returns instance of Parser.
 130      */
 131     @Test(dataProvider = "parser-provider")
 132     public void testParser01(SAXParser saxparser) {
 133         try {
 134             Parser parser = saxparser.getParser();
 135         } catch (FactoryConfigurationError | SAXException e) {
 136             failUnexpected(e);
 137         }
 138 
 139     }
 140 
 141     /**
 142      * Test case to test if the getXMLReader() method returns instance of
 143      * XMLReader.
 144      */
 145     @Test(dataProvider = "parser-provider")
 146     public void testXmlReader01(SAXParser saxparser) {
 147         try {
 148             XMLReader xmlReader = saxparser.getXMLReader();
 149         } catch (FactoryConfigurationError | SAXException e) {
 150             failUnexpected(e);
 151         }
 152     }
 153 
 154     /**
 155      * Test whether the xml-string property is not supported.
 156      *
 157      * @throws SAXNotSupportedException
 158      */
 159     @Test(expectedExceptions = SAXNotSupportedException.class, dataProvider = "parser-provider")
 160     public void testProperty01(SAXParser saxparser) throws SAXNotSupportedException {
 161         try {
 162             Object object = saxparser.getProperty(XML_STRING);
 163         } catch (SAXNotRecognizedException e) {
 164             failUnexpected(e);
 165         }
 166     }
 167 
 168     /**
 169      * Test whether the dom-node property is not supported.
 170      *
 171      * @throws SAXNotSupportedException
 172      */
 173     @Test(expectedExceptions = SAXNotSupportedException.class, dataProvider = "parser-provider")
 174     public void testProperty02(SAXParser saxparser) throws SAXNotSupportedException {
 175         try {
 176             Object object = saxparser.getProperty(DOM_NODE);
 177         } catch (SAXNotRecognizedException e) {
 178             failUnexpected(e);
 179         }
 180     }
 181 
 182     /**
 183      * Test the default lexical-handler not exists.
 184      */
 185     @Test(dataProvider = "parser-provider")
 186     public void testProperty03(SAXParser saxparser) {
 187         try {
 188             assertNull(saxparser.getProperty(LEXICAL_HANDLER));
 189         } catch (SAXException e) {
 190             failUnexpected(e);
 191         }
 192 
 193     }
 194 
 195     /**
 196      * Test the default declaration-handler not exists.
 197      */
 198     @Test(dataProvider = "parser-provider")
 199     public void testProperty04(SAXParser saxparser) {
 200 
 201         try {
 202             assertNull(saxparser.getProperty(DECL_HANDLER));
 203         } catch (SAXException e) {
 204             failUnexpected(e);
 205         }
 206     }
 207 
 208     /**
 209      * Test to set and get the lexical-handler.
 210      */
 211     @Test(dataProvider = "parser-provider")
 212     public void testProperty05(SAXParser saxparser) {
 213         try {
 214             MyLexicalHandler myLexicalHandler = new MyLexicalHandler();
 215             saxparser.setProperty(LEXICAL_HANDLER, myLexicalHandler);
 216             Object object = saxparser.getProperty(LEXICAL_HANDLER);
 217             assertTrue(object instanceof LexicalHandler);
 218         } catch (SAXException e) {
 219             failUnexpected(e);
 220         }
 221     }
 222 
 223     /**
 224      * Test to set and get the declaration-handler.
 225      */
 226     @Test(dataProvider = "parser-provider")
 227     public void testProperty06(SAXParser saxparser) {
 228         try {
 229             MyDeclHandler myDeclHandler = new MyDeclHandler();
 230             saxparser.setProperty(DECL_HANDLER, myDeclHandler);
 231             Object object = saxparser.getProperty(DECL_HANDLER);
 232             assertTrue(object instanceof DeclHandler);
 233         } catch (SAXException e) {
 234             failUnexpected(e);
 235         }
 236 
 237     }
 238 
 239     /**
 240      * Customized LexicalHandler used for test.
 241      */
 242     private class MyLexicalHandler implements LexicalHandler {
 243 
 244         public void comment(char[] ch, int start, int length) {
 245         }
 246 
 247         public void endCDATA() {
 248         }
 249 
 250         public void endDTD() {
 251         }
 252 
 253         public void endEntity(String name) {
 254         }
 255 
 256         public void startCDATA() {
 257         }
 258 
 259         public void startDTD(String name, String publicId, String systemId) {
 260         }
 261 
 262         public void startEntity(String name) {
 263         }
 264     }
 265 
 266     /**
 267      * Customized DeclHandler used for test.
 268      */
 269     private class MyDeclHandler implements DeclHandler {
 270 
 271         public void attributeDecl(String eName, String aName, String type, String valueDefault, String value) {
 272         }
 273 
 274         public void elementDecl(String name, String model) {
 275         }
 276 
 277         public void externalEntityDecl(String name, String publicId, String systemId) {
 278         }
 279 
 280         public void internalEntityDecl(String name, String value) {
 281         }
 282     }
 283 }