org.apache.xerces.jaxp.JAXPValidatorComponent Maven / Gradle / Ivy
Show all versions of xercesImpl Show documentation
/*
* 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