* For the performance reason, when a validator from Xerces is used * for a parser from Xerces, we will do "chating" by building an * XNI pipeline. This saves the overhead of conversion between * XNI events and SAX events. * *
* However, if we just insert the validator component into the * parser pipeline, the {@link XMLComponentManager} that the parser * uses could change the way the validator works. On the other hand, * certain configuration (such as error handlers) need to be given * through a parser configuration. * *
* To avoid this harmful interaction, this class wraps the validator * and behaves as an insulation. The class itself will implement * {@link XMLComponent}, and it selectively deliver properties to * the wrapped validator. * *
* Since the exact set of properties/features that require insulation * depends on the actual validator implementation, this class is * expected to be derived to add such validator-specific insulation * code. * * @author * Kohsuke Kawaguchi (kohsuke.kawaguchi@sun.com) */ public abstract class InsulatedValidatorComponent implements XMLComponent, // this object behaves as a component to the parent component manager XMLComponentManager // this object behaves as a manager to the wrapped validator. { /** * The object being wrapped. * We require the validator to be both {@link XMLDocumentFilter} * and {@link XMLComponent}. */ private final XMLDocumentFilter fValidator; /** * The same object as {@link #fValidator}. */ private final XMLComponent fValidatorComponent; /** * We will not use external {@link ValidationManager} to * avoid interaction. *
* The existance of JAXP validator should not change the * semantics of the parser processing. IOW it should not * interact with the other validators in the parser pipeline. */ private final ValidationManager fValidationManager = new ValidationManager(); /** * The current component manager. */ private XMLComponentManager fManager; public InsulatedValidatorComponent( XMLDocumentFilter validator ) { fValidator = validator; fValidatorComponent = (XMLComponent)validator; } /** * Obtains a reference to the validator as a filter. * * @return * non-null valid object. */ public final XMLDocumentFilter getValidator() { return fValidator; } // // // XMLComponent implementation // // public final void reset(XMLComponentManager componentManager) throws XMLConfigurationException { fManager = componentManager; fValidatorComponent.reset(this); fValidationManager.reset(); } public final String[] getRecognizedFeatures() { return fValidatorComponent.getRecognizedFeatures(); } public final void setFeature(String featureId, boolean state) throws XMLConfigurationException { // don't allow features to be set. } public final String[] getRecognizedProperties() { return fValidatorComponent.getRecognizedProperties(); } public final void setProperty(String propertyId, Object value) throws XMLConfigurationException { // don't allow properties to be set. } public final Boolean getFeatureDefault(String featureId) { return fValidatorComponent.getFeatureDefault(featureId); } public final Object getPropertyDefault(String propertyId) { return fValidatorComponent.getPropertyDefault(propertyId); } // // // XMLComponentManager implementation // // /** * Derived class may override this method to block additional features. */ public boolean getFeature(String featureId) throws XMLConfigurationException { return fManager.getFeature(featureId); } /** * Derived class may override this method to block additional properties. */ public Object getProperty(String propertyId) throws XMLConfigurationException { if( propertyId.equals(XercesConstants.VALIDATION_MANAGER) ) return fValidationManager; return fManager.getProperty(propertyId); } }