1. /*
  2. * The Apache Software License, Version 1.1
  3. *
  4. *
  5. * Copyright (c) 2001-2004 The Apache Software Foundation.
  6. * All rights reserved.
  7. *
  8. * Redistribution and use in source and binary forms, with or without
  9. * modification, are permitted provided that the following conditions
  10. * are met:
  11. *
  12. * 1. Redistributions of source code must retain the above copyright
  13. * notice, this list of conditions and the following disclaimer.
  14. *
  15. * 2. Redistributions in binary form must reproduce the above copyright
  16. * notice, this list of conditions and the following disclaimer in
  17. * the documentation and/or other materials provided with the
  18. * distribution.
  19. *
  20. * 3. The end-user documentation included with the redistribution,
  21. * if any, must include the following acknowledgment:
  22. * "This product includes software developed by the
  23. * Apache Software Foundation (http://www.apache.org/)."
  24. * Alternately, this acknowledgment may appear in the software itself,
  25. * if and wherever such third-party acknowledgments normally appear.
  26. *
  27. * 4. The names "Xerces" and "Apache Software Foundation" must
  28. * not be used to endorse or promote products derived from this
  29. * software without prior written permission. For written
  30. * permission, please contact apache@apache.org.
  31. *
  32. * 5. Products derived from this software may not be called "Apache",
  33. * nor may "Apache" appear in their name, without prior written
  34. * permission of the Apache Software Foundation.
  35. *
  36. * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
  37. * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  38. * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  39. * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
  40. * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  41. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  42. * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  43. * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  44. * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  45. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  46. * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  47. * SUCH DAMAGE.
  48. * ====================================================================
  49. *
  50. * This software consists of voluntary contributions made by many
  51. * individuals on behalf of the Apache Software Foundation and was
  52. * originally based on software copyright (c) 2001, International
  53. * Business Machines, Inc., http://www.apache.org. For more
  54. * information on the Apache Software Foundation, please see
  55. * <http://www.apache.org/>.
  56. */
  57. package com.sun.org.apache.xerces.internal.util;
  58. import com.sun.org.apache.xerces.internal.xni.XNIException;
  59. import com.sun.org.apache.xerces.internal.xni.XMLResourceIdentifier;
  60. import com.sun.org.apache.xerces.internal.xni.grammars.XMLGrammarDescription;
  61. import com.sun.org.apache.xerces.internal.xni.parser.XMLEntityResolver;
  62. import com.sun.org.apache.xerces.internal.xni.parser.XMLInputSource;
  63. import org.w3c.dom.ls.LSResourceResolver;
  64. import org.w3c.dom.ls.LSInput;
  65. import java.io.InputStream;
  66. import java.io.IOException;
  67. import java.io.Reader;
  68. import java.io.StringReader;
  69. /**
  70. * This class wraps DOM entity resolver to XNI entity resolver.
  71. *
  72. * @see LSResourceResolver
  73. *
  74. * @author Gopal Sharma, SUN MicroSystems Inc.
  75. * @author Elena Litani, IBM
  76. * @author Ramesh Mandava, Sun Microsystems
  77. * @version $Id: DOMEntityResolverWrapper.java,v 1.12 2004/02/25 19:46:15 kohsuke Exp $
  78. */
  79. public class DOMEntityResolverWrapper
  80. implements XMLEntityResolver {
  81. //
  82. // Data
  83. //
  84. /** XML 1.0 type constant according to DOM L3 LS CR spec "http://www.w3.org/TR/2003/CR-DOM-Level-3-LS-20031107" */
  85. private static final String XML_TYPE = "http://www.w3.org/TR/REC-xml";
  86. /** XML Schema constant according to DOM L3 LS CR spec "http://www.w3.org/TR/2003/CR-DOM-Level-3-LS-20031107" */
  87. private static final String XSD_TYPE = "http://www.w3.org/2001/XMLSchema";
  88. /** The DOM entity resolver. */
  89. protected LSResourceResolver fEntityResolver;
  90. //
  91. // Constructors
  92. //
  93. /** Default constructor. */
  94. public DOMEntityResolverWrapper() {}
  95. /** Wraps the specified DOM entity resolver. */
  96. public DOMEntityResolverWrapper(LSResourceResolver entityResolver) {
  97. setEntityResolver(entityResolver);
  98. } // LSResourceResolver
  99. //
  100. // Public methods
  101. //
  102. /** Sets the DOM entity resolver. */
  103. public void setEntityResolver(LSResourceResolver entityResolver) {
  104. fEntityResolver = entityResolver;
  105. } // setEntityResolver(LSResourceResolver)
  106. /** Returns the DOM entity resolver. */
  107. public LSResourceResolver getEntityResolver() {
  108. return fEntityResolver;
  109. } // getEntityResolver():LSResourceResolver
  110. //
  111. // XMLEntityResolver methods
  112. //
  113. /**
  114. * Resolves an external parsed entity. If the entity cannot be
  115. * resolved, this method should return null.
  116. *
  117. * @param resourceIdentifier description of the resource to be revsoved
  118. * @throws XNIException Thrown on general error.
  119. * @throws IOException Thrown if resolved entity stream cannot be
  120. * opened or some other i/o error occurs.
  121. */
  122. public XMLInputSource resolveEntity(XMLResourceIdentifier resourceIdentifier)
  123. throws XNIException, IOException {
  124. // resolve entity using DOM entity resolver
  125. if (fEntityResolver != null) {
  126. // For entity resolution the type of the resource would be XML TYPE
  127. // DOM L3 LS spec mention only the XML 1.0 recommendation right now
  128. LSInput inputSource =
  129. resourceIdentifier == null
  130. ? fEntityResolver.resolveResource(
  131. null,
  132. null,
  133. null,
  134. null,
  135. null)
  136. : fEntityResolver.resolveResource(
  137. getType(resourceIdentifier),
  138. resourceIdentifier.getNamespace(),
  139. resourceIdentifier.getPublicId(),
  140. resourceIdentifier.getLiteralSystemId(),
  141. resourceIdentifier.getBaseSystemId());
  142. if (inputSource != null) {
  143. String publicId = inputSource.getPublicId();
  144. String systemId = inputSource.getSystemId();
  145. String baseSystemId = inputSource.getBaseURI();
  146. InputStream byteStream = inputSource.getByteStream();
  147. Reader charStream = inputSource.getCharacterStream();
  148. String encoding = inputSource.getEncoding();
  149. String data = inputSource.getStringData();
  150. XMLInputSource xmlInputSource =
  151. new XMLInputSource(publicId, systemId, baseSystemId);
  152. if (charStream != null) {
  153. xmlInputSource.setCharacterStream(charStream);
  154. }
  155. if (byteStream != null) {
  156. xmlInputSource.setByteStream((InputStream) byteStream);
  157. }
  158. if (data != null && data.length() != 0) {
  159. xmlInputSource.setCharacterStream(
  160. new StringReader(data));
  161. }
  162. xmlInputSource.setEncoding(encoding);
  163. return xmlInputSource;
  164. }
  165. }
  166. // unable to resolve entity
  167. return null;
  168. } // resolveEntity(String,String,String):XMLInputSource
  169. /** Determines the type of resource being resolved **/
  170. private String getType(XMLResourceIdentifier resourceIdentifier) {
  171. if (resourceIdentifier instanceof XMLGrammarDescription) {
  172. XMLGrammarDescription desc = (XMLGrammarDescription) resourceIdentifier;
  173. if (XMLGrammarDescription.XML_SCHEMA.equals(desc.getGrammarType())) {
  174. return XSD_TYPE;
  175. }
  176. }
  177. return XML_TYPE;
  178. } // getType(XMLResourceIdentifier):String
  179. } // DOMEntityResolverWrapper