net.sourceforge.htmlunit.xerces.util.ParserConfigurationSettings Maven / Gradle / Ivy
Show all versions of neko-htmlunit 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 net.sourceforge.htmlunit.xerces.util;
import java.util.ArrayList;
import java.util.HashMap;
import net.sourceforge.htmlunit.xerces.xni.parser.XMLComponentManager;
import net.sourceforge.htmlunit.xerces.xni.parser.XMLConfigurationException;
/**
* This class implements the basic operations for managing parser
* configuration features and properties. This utility class can
* be used as a base class for parser configurations or separately
* to encapsulate a number of parser settings as a component
* manager.
*
* This class can be constructed with a "parent" settings object
* (in the form of an XMLComponentManager) that allows
* parser configuration settings to be "chained" together.
*
* @author Andy Clark, IBM
*/
public class ParserConfigurationSettings
implements XMLComponentManager {
/** Recognized properties. */
protected final ArrayList fRecognizedProperties;
/** Properties. */
protected final HashMap fProperties;
/** Recognized features. */
protected final ArrayList fRecognizedFeatures;
/** Features. */
protected final HashMap fFeatures;
// Constructs a parser configuration settings object with a
// parent settings object.
public ParserConfigurationSettings() {
// create storage for recognized features and properties
fRecognizedFeatures = new ArrayList<>();
fRecognizedProperties = new ArrayList<>();
// create table for features and properties
fFeatures = new HashMap<>();
fProperties = new HashMap<>();
}
/**
* Allows a parser to add parser specific features to be recognized
* and managed by the parser configuration.
*
* @param featureIds An array of the additional feature identifiers
* to be recognized.
*/
public void addRecognizedFeatures(String[] featureIds) {
// add recognized features
int featureIdsCount = featureIds != null ? featureIds.length : 0;
for (int i = 0; i < featureIdsCount; i++) {
String featureId = featureIds[i];
if (!fRecognizedFeatures.contains(featureId)) {
fRecognizedFeatures.add(featureId);
}
}
}
/**
* Set the state of a feature.
*
* Set the state of any feature in a SAX2 parser. The parser
* might not recognize the feature, and if it does recognize
* it, it might not be able to fulfill the request.
*
* @param featureId The unique identifier (URI) of the feature.
* @param state The requested state of the feature (true or false).
*
* @exception net.sourceforge.htmlunit.xerces.xni.parser.XMLConfigurationException If the
* requested feature is not known.
*/
public void setFeature(String featureId, boolean state)
throws XMLConfigurationException {
// check and store
checkFeature(featureId);
fFeatures.put(featureId, state ? Boolean.TRUE : Boolean.FALSE);
}
/**
* Allows a parser to add parser specific properties to be recognized
* and managed by the parser configuration.
*
* @param propertyIds An array of the additional property identifiers
* to be recognized.
*/
public void addRecognizedProperties(String[] propertyIds) {
// add recognizedProperties
int propertyIdsCount = propertyIds != null ? propertyIds.length : 0;
for (int i = 0; i < propertyIdsCount; i++) {
String propertyId = propertyIds[i];
if (!fRecognizedProperties.contains(propertyId)) {
fRecognizedProperties.add(propertyId);
}
}
}
/**
* setProperty
*
* @param propertyId the property id
* @param value the value
* @exception net.sourceforge.htmlunit.xerces.xni.parser.XMLConfigurationException If the
* requested feature is not known.
*/
public void setProperty(String propertyId, Object value)
throws XMLConfigurationException {
// check and store
checkProperty(propertyId);
fProperties.put(propertyId, value);
}
/**
* {@inheritDoc}
*/
@Override
public boolean getFeature(String featureId)
throws XMLConfigurationException {
Boolean state = fFeatures.get(featureId);
if (state == null) {
checkFeature(featureId);
return false;
}
return state.booleanValue();
}
/**
* {@inheritDoc}
*/
@Override
public Object getProperty(String propertyId)
throws XMLConfigurationException {
Object propertyValue = fProperties.get(propertyId);
if (propertyValue == null) {
checkProperty(propertyId);
}
return propertyValue;
}
/**
* Check a feature. If feature is known and supported, this method simply
* returns. Otherwise, the appropriate exception is thrown.
*
* @param featureId The unique identifier (URI) of the feature.
*
* @exception net.sourceforge.htmlunit.xerces.xni.parser.XMLConfigurationException If the
* requested feature is not known.
*/
protected void checkFeature(String featureId)
throws XMLConfigurationException {
// check feature
if (!fRecognizedFeatures.contains(featureId)) {
short type = XMLConfigurationException.NOT_RECOGNIZED;
throw new XMLConfigurationException(type, featureId);
}
}
/**
* Check a property. If the property is known and supported, this method
* simply returns. Otherwise, the appropriate exception is thrown.
*
* @param propertyId The unique identifier (URI) of the property
* being set.
* @exception net.sourceforge.htmlunit.xerces.xni.parser.XMLConfigurationException If the
* requested feature is not known.
*/
protected void checkProperty(String propertyId)
throws XMLConfigurationException {
// check property
if (!fRecognizedProperties.contains(propertyId)) {
short type = XMLConfigurationException.NOT_RECOGNIZED;
throw new XMLConfigurationException(type, propertyId);
}
}
}