All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.apache.xerces.jaxp.JAXPValidatorComponent Maven / Gradle / Ivy

/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 * 
 *      http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.apache.xerces.jaxp;

import java.io.IOException;

import javax.xml.validation.TypeInfoProvider;
import javax.xml.validation.ValidatorHandler;

import org.apache.xerces.dom.DOMInputImpl;
import org.apache.xerces.impl.Constants;
import org.apache.xerces.impl.XMLErrorReporter;
import org.apache.xerces.impl.xs.opti.DefaultXMLDocumentHandler;
import org.apache.xerces.util.AttributesProxy;
import org.apache.xerces.util.AugmentationsImpl;
import org.apache.xerces.util.ErrorHandlerProxy;
import org.apache.xerces.util.ErrorHandlerWrapper;
import org.apache.xerces.util.LocatorProxy;
import org.apache.xerces.util.SymbolTable;
import org.apache.xerces.util.XMLResourceIdentifierImpl;
import org.apache.xerces.xni.Augmentations;
import org.apache.xerces.xni.NamespaceContext;
import org.apache.xerces.xni.QName;
import org.apache.xerces.xni.XMLAttributes;
import org.apache.xerces.xni.XMLDocumentHandler;
import org.apache.xerces.xni.XMLLocator;
import org.apache.xerces.xni.XMLString;
import org.apache.xerces.xni.XNIException;
import org.apache.xerces.xni.parser.XMLComponent;
import org.apache.xerces.xni.parser.XMLComponentManager;
import org.apache.xerces.xni.parser.XMLConfigurationException;
import org.apache.xerces.xni.parser.XMLEntityResolver;
import org.apache.xerces.xni.parser.XMLErrorHandler;
import org.apache.xerces.xni.parser.XMLInputSource;
import org.w3c.dom.TypeInfo;
import org.w3c.dom.ls.LSInput;
import org.w3c.dom.ls.LSResourceResolver;
import org.xml.sax.Attributes;
import org.xml.sax.ContentHandler;
import org.xml.sax.ErrorHandler;
import org.xml.sax.SAXException;
import org.xml.sax.SAXParseException;
import org.xml.sax.helpers.DefaultHandler;

/**
 * Runs events through a {@link javax.xml.validation.ValidatorHandler}
 * and performs validation/infoset-augmentation by an external validator.
 * 
 * 

* This component sets up the pipeline as follows: * * *

 *             __                                           __
 *            /  |==> XNI2SAX --> Validator --> SAX2XNI ==>|  
 *           /   |                                         |   
 *       ==>| Tee|                                         | next
 *           \   |                                         |  component
 *            \  |============other XNI events============>|  
 *             ~~                                           ~~
 * 
*

* only those events that need to go through Validator will go the 1st route, * and other events go the 2nd direct route. * * @author Kohsuke Kawaguchi ([email protected]) * @version $Id: JAXPValidatorComponent.java 548088 2007-06-17 18:25:17Z mrglavas $ */ final class JAXPValidatorComponent extends TeeXMLDocumentFilterImpl implements XMLComponent { /** Property identifier: entity manager. */ private static final String ENTITY_MANAGER = Constants.XERCES_PROPERTY_PREFIX + Constants.ENTITY_MANAGER_PROPERTY; /** Property identifier: error reporter. */ private static final String ERROR_REPORTER = Constants.XERCES_PROPERTY_PREFIX + Constants.ERROR_REPORTER_PROPERTY; /** Property identifier: symbol table. */ private static final String SYMBOL_TABLE = Constants.XERCES_PROPERTY_PREFIX + Constants.SYMBOL_TABLE_PROPERTY; // pipeline parts private final ValidatorHandler validator; private final XNI2SAX xni2sax = new XNI2SAX(); private final SAX2XNI sax2xni = new SAX2XNI(); // never be null private final TypeInfoProvider typeInfoProvider; /** * Used to store the {@link Augmentations} associated with the * current event, so that we can pick it up again * when the event is forwarded by the {@link ValidatorHandler}. * * UGLY HACK. */ private Augmentations fCurrentAug; /** * {@link XMLAttributes} version of {@link #fCurrentAug}. */ private XMLAttributes fCurrentAttributes; // components obtained from a manager / property private SymbolTable fSymbolTable; private XMLErrorReporter fErrorReporter; private XMLEntityResolver fEntityResolver; /** * @param validatorHandler may not be null. */ public JAXPValidatorComponent( ValidatorHandler validatorHandler ) { this.validator = validatorHandler; TypeInfoProvider tip = validatorHandler.getTypeInfoProvider(); if(tip==null) tip = noInfoProvider; this.typeInfoProvider = tip; // configure wiring between internal components. xni2sax.setContentHandler(validator); validator.setContentHandler(sax2xni); this.setSide(xni2sax); // configure validator with proper EntityResolver/ErrorHandler. validator.setErrorHandler(new ErrorHandlerProxy() { protected XMLErrorHandler getErrorHandler() { XMLErrorHandler handler = fErrorReporter.getErrorHandler(); if(handler!=null) return handler; return new ErrorHandlerWrapper(DraconianErrorHandler.getInstance()); } }); validator.setResourceResolver(new LSResourceResolver() { public LSInput resolveResource(String type,String ns, String publicId, String systemId, String baseUri) { if(fEntityResolver==null) return null; try { XMLInputSource is = fEntityResolver.resolveEntity( new XMLResourceIdentifierImpl(publicId,systemId,baseUri,null)); if(is==null) return null; LSInput di = new DOMInputImpl(); di.setBaseURI(is.getBaseSystemId()); di.setByteStream(is.getByteStream()); di.setCharacterStream(is.getCharacterStream()); di.setEncoding(is.getEncoding()); di.setPublicId(is.getPublicId()); di.setSystemId(is.getSystemId()); return di; } catch( IOException e ) { // erors thrown by the callback is not supposed to be // reported to users. throw new XNIException(e); } } }); } public void startElement(QName element, XMLAttributes attributes, Augmentations augs) throws XNIException { fCurrentAttributes = attributes; fCurrentAug = augs; xni2sax.startElement(element,attributes,null); fCurrentAttributes = null; // mostly to make it easy to find any bug. } public void endElement(QName element, Augmentations augs) throws XNIException { fCurrentAug = augs; xni2sax.endElement(element,null); } public void emptyElement(QName element, XMLAttributes attributes, Augmentations augs) throws XNIException { startElement(element,attributes,augs); endElement(element,augs); } public void characters(XMLString text, Augmentations augs) throws XNIException { // since a validator may change the contents, // let this one go through a validator fCurrentAug = augs; xni2sax.characters(text,null); } public void ignorableWhitespace(XMLString text, Augmentations augs) throws XNIException { // since a validator may change the contents, // let this one go through a validator fCurrentAug = augs; xni2sax.ignorableWhitespace(text,null); } public void reset(XMLComponentManager componentManager) throws XMLConfigurationException { // obtain references from the manager fSymbolTable = (SymbolTable)componentManager.getProperty(SYMBOL_TABLE); fErrorReporter = (XMLErrorReporter)componentManager.getProperty(ERROR_REPORTER); try { fEntityResolver = (XMLEntityResolver) componentManager.getProperty(ENTITY_MANAGER); } catch (XMLConfigurationException e) { fEntityResolver = null; } } /** * * Uses {@link DefaultHandler} as a default implementation of * {@link ContentHandler}. * *

* We only forward certain events from a {@link ValidatorHandler}. * Other events should go "the 2nd direct route". */ private final class SAX2XNI extends DefaultHandler { /** * {@link Augmentations} to send along with events. * We reuse one object for efficiency. */ private final Augmentations fAugmentations = new AugmentationsImpl(); /** * {@link QName} to send along events. * we reuse one QName for efficiency. */ private final QName fQName = new QName(); public void characters(char[] ch, int start, int len) throws SAXException { try { handler().characters(new XMLString(ch,start,len),aug()); } catch( XNIException e ) { throw toSAXException(e); } } public void ignorableWhitespace(char[] ch, int start, int len) throws SAXException { try { handler().ignorableWhitespace(new XMLString(ch,start,len),aug()); } catch( XNIException e ) { throw toSAXException(e); } } public void startElement(String uri, String localName, String qname, Attributes atts) throws SAXException { try { updateAttributes(atts); handler().startElement(toQName(uri,localName,qname), fCurrentAttributes, elementAug()); } catch( XNIException e ) { throw toSAXException(e); } } public void endElement(String uri, String localName, String qname) throws SAXException { try { handler().endElement(toQName(uri,localName,qname),aug()); } catch( XNIException e ) { throw toSAXException(e); } } private Augmentations elementAug() { Augmentations aug = aug(); /** aug.putItem(Constants.TYPEINFO,typeInfoProvider.getElementTypeInfo()); **/ return aug; } /** * Gets the {@link Augmentations} that should be associated with * the current event. */ private Augmentations aug() { if( fCurrentAug!=null ) { Augmentations r = fCurrentAug; fCurrentAug = null; // we "consumed" this augmentation. return r; } fAugmentations.removeAllItems(); return fAugmentations; } /** * Get the handler to which we should send events. */ private XMLDocumentHandler handler() { return JAXPValidatorComponent.this.getDocumentHandler(); } /** * Converts the {@link XNIException} received from a downstream * component to a {@link SAXException}. */ private SAXException toSAXException( XNIException xe ) { Exception e = xe.getException(); if( e==null ) e = xe; if( e instanceof SAXException ) return (SAXException)e; return new SAXException(e); } /** * Creates a proper {@link QName} object from 3 parts. *

* This method does the symbolization. */ private QName toQName( String uri, String localName, String qname ) { String prefix = null; int idx = qname.indexOf(':'); if( idx>0 ) prefix = symbolize(qname.substring(0,idx)); localName = symbolize(localName); qname = symbolize(qname); uri = symbolize(uri); // notify handlers fQName.setValues(prefix, localName, qname, uri); return fQName; } } /** * Converts {@link XNI} events to {@link ContentHandler} events. * *

* Deriving from {@link DefaultXMLDocumentHandler} * to reuse its default {@link org.apache.xerces.xni.XMLDocumentHandler} * implementation. * * @author Kohsuke Kawaguchi ([email protected]) */ private static final class XNI2SAX extends DefaultXMLDocumentHandler { private ContentHandler fContentHandler; private String fVersion; /** Namespace context */ protected NamespaceContext fNamespaceContext; /** * For efficiency, we reuse one instance. */ private final AttributesProxy fAttributesProxy = new AttributesProxy(null); public void setContentHandler( ContentHandler handler ) { this.fContentHandler = handler; } public ContentHandler getContentHandler() { return fContentHandler; } public void xmlDecl(String version, String encoding, String standalone, Augmentations augs) throws XNIException { this.fVersion = version; } public void startDocument(XMLLocator locator, String encoding, NamespaceContext namespaceContext, Augmentations augs) throws XNIException { fNamespaceContext = namespaceContext; fContentHandler.setDocumentLocator(new LocatorProxy(locator)); try { fContentHandler.startDocument(); } catch (SAXException e) { throw new XNIException(e); } } public void endDocument(Augmentations augs) throws XNIException { try { fContentHandler.endDocument(); } catch (SAXException e) { throw new XNIException(e); } } public void processingInstruction(String target, XMLString data, Augmentations augs) throws XNIException { try { fContentHandler.processingInstruction(target,data.toString()); } catch (SAXException e) { throw new XNIException(e); } } public void startElement(QName element, XMLAttributes attributes, Augmentations augs) throws XNIException { try { // start namespace prefix mappings int count = fNamespaceContext.getDeclaredPrefixCount(); if (count > 0) { String prefix = null; String uri = null; for (int i = 0; i < count; i++) { prefix = fNamespaceContext.getDeclaredPrefixAt(i); uri = fNamespaceContext.getURI(prefix); fContentHandler.startPrefixMapping(prefix, (uri == null)?"":uri); } } String uri = element.uri != null ? element.uri : ""; String localpart = element.localpart; fAttributesProxy.setAttributes(attributes); fContentHandler.startElement(uri, localpart, element.rawname, fAttributesProxy); } catch( SAXException e ) { throw new XNIException(e); } } public void endElement(QName element, Augmentations augs) throws XNIException { try { String uri = element.uri != null ? element.uri : ""; String localpart = element.localpart; fContentHandler.endElement(uri, localpart, element.rawname); // send endPrefixMapping events int count = fNamespaceContext.getDeclaredPrefixCount(); if (count > 0) { for (int i = 0; i < count; i++) { fContentHandler.endPrefixMapping(fNamespaceContext.getDeclaredPrefixAt(i)); } } } catch( SAXException e ) { throw new XNIException(e); } } public void emptyElement(QName element, XMLAttributes attributes, Augmentations augs) throws XNIException { startElement(element,attributes,augs); endElement(element,augs); } public void characters(XMLString text, Augmentations augs) throws XNIException { try { fContentHandler.characters(text.ch,text.offset,text.length); } catch (SAXException e) { throw new XNIException(e); } } public void ignorableWhitespace(XMLString text, Augmentations augs) throws XNIException { try { fContentHandler.ignorableWhitespace(text.ch,text.offset,text.length); } catch (SAXException e) { throw new XNIException(e); } } } private static final class DraconianErrorHandler implements ErrorHandler { /** * Singleton instance. */ private static final DraconianErrorHandler ERROR_HANDLER_INSTANCE = new DraconianErrorHandler(); private DraconianErrorHandler() {} /** Returns the one and only instance of this error handler. */ public static DraconianErrorHandler getInstance() { return ERROR_HANDLER_INSTANCE; } /** Warning: Ignore. */ public void warning(SAXParseException e) throws SAXException { // noop } /** Error: Throws back SAXParseException. */ public void error(SAXParseException e) throws SAXException { throw e; } /** Fatal Error: Throws back SAXParseException. */ public void fatalError(SAXParseException e) throws SAXException { throw e; } } // DraconianErrorHandler /** * Compares the given {@link Attributes} with {@link #fCurrentAttributes} * and update the latter accordingly. */ private void updateAttributes( Attributes atts ) { int len = atts.getLength(); for( int i=0; i





© 2015 - 2024 Weber Informatics LLC | Privacy Policy