Exemple #1
0
  /**
   * Parses content of an <code>InputSource</code> to create an XML <code>Element</code> object.
   *
   * @param source the input source that is supposed to contain XML to be parsed, not <code>null
   *     </code>.
   * @return the parsed result, not <code>null</code>.
   * @throws IOException if there is an I/O error.
   * @throws ParseException if the content is not considered to be valid XML.
   */
  private Element parse(InputSource source) throws IOException, ParseException {

    // TODO: Consider using an XMLReader instead of a SAXParser

    // Initialize our SAX event handler
    Handler handler = new Handler();

    try {
      // Let SAX parse the XML, using our handler
      SAXParserProvider.get().parse(source, handler);

    } catch (SAXException exception) {

      // TODO: Log: Parsing failed
      String exMessage = exception.getMessage();

      // Construct complete message
      String message = "Failed to parse XML";
      if (TextUtils.isEmpty(exMessage)) {
        message += '.';
      } else {
        message += ": " + exMessage;
      }

      // Throw exception with message, and register cause exception
      throw new ParseException(message, exception, exMessage);
    }

    Element element = handler.getElement();

    return element;
  }
Exemple #2
0
  /**
   * Parses content of a file to create an XML <code>Element</code> object.
   *
   * @param file the file that is supposed to contain XML to be parsed, not <code>null</code>.
   * @return the parsed result, not <code>null</code>.
   * @throws IllegalArgumentException if <code>file == null</code>.
   * @throws IOException if there is an I/O error, e.g. the file does not exist or is actually a
   *     directory.
   * @throws ParseException if the content of the file is not considered to be valid XML.
   * @since XINS 2.2
   */
  public Element parse(File file) throws IllegalArgumentException, IOException, ParseException {

    // Check preconditions
    MandatoryArgumentChecker.check("file", file);

    FileInputStream fis = null;
    try {
      fis = new FileInputStream(file);
      return parse(fis);

      // Enrich an I/O exception with the file name
    } catch (IOException cause) {
      IOException e =
          new IOException(
              "Failed to parse file "
                  + TextUtils.quote(file.getAbsolutePath())
                  + " due to an I/O error.");
      e.initCause(cause);
      throw e;

      // Enrich a parse exception with the file name
    } catch (ParseException cause) {
      throw new ParseException(
          "Failed to parse file " + TextUtils.quote(file.getAbsolutePath()) + '.', cause);

      // Anyway, always attempt to close the input stream
    } finally {
      try {
        if (fis != null) {
          fis.close();
        }
      } catch (IOException ex) {
        // Never mind
      }
    }
  }