1 /*
   2  * Copyright (c) 1997, 2012, 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.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package com.sun.tools.internal.xjc.reader.internalizer;
  27 
  28 import com.sun.istack.internal.SAXParseException2;
  29 import org.xml.sax.Attributes;
  30 import org.xml.sax.Locator;
  31 import org.xml.sax.SAXException;
  32 import org.xml.sax.SAXParseException;
  33 import org.xml.sax.helpers.XMLFilterImpl;
  34 
  35 import java.io.File;
  36 import java.io.IOException;
  37 import java.net.URI;
  38 import java.net.URISyntaxException;
  39 
  40 /**
  41  * XMLFilter that finds references to other schema files from
  42  * SAX events.
  43  * <p/>
  44  * This implementation is a base implementation for typical case
  45  * where we just need to look for a particular attribute which
  46  * contains an URL to another schema file.
  47  *
  48  * @author Kohsuke Kawaguchi (kohsuke.kawaguchi@sun.com)
  49  */
  50 public abstract class AbstractReferenceFinderImpl extends XMLFilterImpl {
  51 
  52     protected final DOMForest parent;
  53 
  54     protected AbstractReferenceFinderImpl(DOMForest _parent) {
  55         this.parent = _parent;
  56     }
  57 
  58     /**
  59      * IF the given element contains a reference to an external resource,
  60      * return its URL.
  61      *
  62      * @param nsURI     Namespace URI of the current element
  63      * @param localName Local name of the current element
  64      * @return It's OK to return a relative URL.
  65      */
  66     protected abstract String findExternalResource(String nsURI, String localName, Attributes atts);
  67 
  68     @Override
  69     public void startElement(String namespaceURI, String localName, String qName, Attributes atts)
  70             throws SAXException {
  71         super.startElement(namespaceURI, localName, qName, atts);
  72 
  73         String relativeRef = findExternalResource(namespaceURI, localName, atts);
  74         if (relativeRef == null) {
  75             return; // not found
  76         }
  77         try {
  78             // absolutize URL.
  79             String lsi = locator.getSystemId();
  80             String ref;
  81             URI relRefURI = new URI(relativeRef);
  82             if (relRefURI.isAbsolute())
  83                 ref = relativeRef;
  84             else {
  85                 if (lsi.startsWith("jar:")) {
  86                     int bangIdx = lsi.indexOf('!');
  87                     if (bangIdx > 0) {
  88                         ref = lsi.substring(0, bangIdx + 1)
  89                                 + new URI(lsi.substring(bangIdx + 1)).resolve(new URI(relativeRef)).toString();
  90                     } else {
  91                         ref = relativeRef;
  92                     }
  93                 } else {
  94                     ref = new URI(lsi).resolve(new URI(relativeRef)).toString();
  95                 }
  96             }
  97 
  98             // then parse this schema as well,
  99             // but don't mark this document as a root.
 100             if (parent != null) { // this is there to allow easier testing
 101                 parent.parse(ref, false);
 102             }
 103         } catch (URISyntaxException e) {
 104             String msg = e.getMessage();
 105             if (new File(relativeRef).exists()) {
 106                 msg = Messages.format(Messages.ERR_FILENAME_IS_NOT_URI) + ' ' + msg;
 107             }
 108 
 109             SAXParseException spe = new SAXParseException2(
 110                     Messages.format(Messages.ERR_UNABLE_TO_PARSE, relativeRef, msg),
 111                     locator, e);
 112 
 113             fatalError(spe);
 114             throw spe;
 115         } catch (IOException e) {
 116             SAXParseException spe = new SAXParseException2(
 117                     Messages.format(Messages.ERR_UNABLE_TO_PARSE, relativeRef, e.getMessage()),
 118                     locator, e);
 119 
 120             fatalError(spe);
 121             throw spe;
 122         }
 123     }
 124 
 125     private Locator locator;
 126 
 127     @Override
 128     public void setDocumentLocator(Locator locator) {
 129         super.setDocumentLocator(locator);
 130         this.locator = locator;
 131     }
 132 }