1 /*
   2  * Copyright (c) 2003, 2016, 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 static jaxp.library.JAXPTestUtilities.USER_DIR;
  26 import static jaxp.library.JAXPTestUtilities.compareWithGold;
  27 import static org.testng.Assert.assertTrue;
  28 import static org.testng.Assert.fail;
  29 import static org.xml.sax.ptests.SAXTestConst.GOLDEN_DIR;
  30 import static org.xml.sax.ptests.SAXTestConst.XML_DIR;
  31 
  32 import java.io.BufferedWriter;
  33 import java.io.FileInputStream;
  34 import java.io.FileWriter;
  35 import java.io.IOException;
  36 
  37 import javax.xml.parsers.SAXParser;
  38 import javax.xml.parsers.SAXParserFactory;
  39 
  40 import org.testng.annotations.Listeners;
  41 import org.testng.annotations.Test;
  42 import org.xml.sax.InputSource;
  43 import org.xml.sax.SAXException;
  44 import org.xml.sax.SAXParseException;
  45 import org.xml.sax.XMLReader;
  46 import org.xml.sax.helpers.XMLFilterImpl;
  47 
  48 /**
  49  * ErrorHandler unit test. Set a ErrorHandle to XMLReader. Capture fatal error
  50  * events in ErrorHandler.
  51  */
  52 @Listeners({jaxp.library.FilePolicy.class})
  53 public class EHFatalTest {
  54     /**
  55      * Error Handler to capture all error events to output file. Verifies the
  56      * output file is same as golden file.
  57      *
  58      * @throws Exception If any errors occur.
  59      */
  60     @Test
  61     public void testEHFatal() throws Exception {
  62         String outputFile = USER_DIR + "EHFatal.out";
  63         String goldFile = GOLDEN_DIR + "EHFatalGF.out";
  64         String xmlFile = XML_DIR + "invalid.xml";
  65 
  66         try(MyErrorHandler eHandler = new MyErrorHandler(outputFile);
  67                 FileInputStream instream = new FileInputStream(xmlFile)) {
  68             SAXParser saxParser = SAXParserFactory.newInstance().newSAXParser();
  69             XMLReader xmlReader = saxParser.getXMLReader();
  70             xmlReader.setErrorHandler(eHandler);
  71             InputSource is = new InputSource(instream);
  72             xmlReader.parse(is);
  73             fail("Parse should throw SAXException");
  74         } catch (SAXException expected) {
  75             // This is expected.
  76         }
  77         // Need close the output file before we compare it with golden file.
  78         assertTrue(compareWithGold(goldFile, outputFile));
  79     }
  80 }
  81 
  82 /**
  83  * A fatal error event handler only capture fatal error event and write event to
  84  * output file.
  85  */
  86 class MyErrorHandler extends XMLFilterImpl implements AutoCloseable {
  87     /**
  88      * FileWriter to write string to output file.
  89      */
  90     private final BufferedWriter bWriter;
  91 
  92     /**
  93      * Initiate FileWriter when construct a MyContentHandler.
  94      * @param outputFileName output file name.
  95      * @throws SAXException creation of FileWriter failed.
  96      */
  97     MyErrorHandler(String outputFileName) throws SAXException {
  98         super();
  99         try {
 100             bWriter = new BufferedWriter(new FileWriter(outputFileName));
 101         } catch (IOException ex) {
 102             throw new SAXException(ex);
 103         }
 104     }
 105 
 106     /**
 107      * Write fatalError tag along with exception to the file when meet
 108      * unrecoverable error event.
 109      * @throws IOException error happen when writing file.
 110      */
 111     @Override
 112     public void fatalError(SAXParseException e) throws SAXException {
 113         String str = "In fatalError..\nSAXParseException: " + e.getMessage();
 114         try {
 115             bWriter.write( str, 0,str.length());
 116             bWriter.newLine();
 117         } catch (IOException ex) {
 118             throw new SAXException(ex);
 119         }
 120     }
 121 
 122     /**
 123      * Flush the content and close the file.
 124      * @throws IOException error happen when writing file or closing file.
 125      */
 126     @Override
 127     public void close() throws IOException {
 128         bWriter.flush();
 129         bWriter.close();
 130     }
 131 }