Class XMLBuilderParametersImpl
- java.lang.Object
-
- org.apache.commons.configuration2.builder.BasicBuilderParameters
-
- org.apache.commons.configuration2.builder.FileBasedBuilderParametersImpl
-
- org.apache.commons.configuration2.builder.HierarchicalBuilderParametersImpl
-
- org.apache.commons.configuration2.builder.XMLBuilderParametersImpl
-
- All Implemented Interfaces:
java.lang.Cloneable
,BasicBuilderProperties<BasicBuilderParameters>
,BuilderParameters
,FileBasedBuilderProperties<FileBasedBuilderParametersImpl>
,HierarchicalBuilderProperties<HierarchicalBuilderParametersImpl>
,XMLBuilderProperties<XMLBuilderParametersImpl>
public class XMLBuilderParametersImpl extends HierarchicalBuilderParametersImpl implements XMLBuilderProperties<XMLBuilderParametersImpl>
A specialized parameters class for XML configuration.
This parameters class defines some properties which allow customizing the parsing of XML documents. The location of the XML document to be loaded can be specified, too.
This class is not thread-safe. It is intended that an instance is constructed and initialized by a single thread during configuration of a
ConfigurationBuilder
.- Since:
- 2.0
- Version:
- $Id: XMLBuilderParametersImpl.java 1730383 2016-02-14 19:04:31Z oheger $
-
-
Field Summary
-
Fields inherited from interface org.apache.commons.configuration2.builder.BuilderParameters
RESERVED_PARAMETER_PREFIX
-
-
Constructor Summary
Constructors Constructor Description XMLBuilderParametersImpl()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description org.xml.sax.EntityResolver
getEntityResolver()
Returns theEntityResolver
stored in this parameters object.void
inheritFrom(java.util.Map<java.lang.String,?> source)
Inherits properties from the specified map.XMLBuilderParametersImpl
setDocumentBuilder(javax.xml.parsers.DocumentBuilder docBuilder)
Allows setting theDocumentBuilder
for parsing an XML document.XMLBuilderParametersImpl
setEntityResolver(org.xml.sax.EntityResolver resolver)
Allows setting theEntityResolver
which maps entity references during XML parsing.XMLBuilderParametersImpl
setPublicID(java.lang.String pubID)
Sets the public ID of the DOCTYPE declaration.XMLBuilderParametersImpl
setSchemaValidation(boolean f)
Sets the value of the schemaValidation flag.XMLBuilderParametersImpl
setSystemID(java.lang.String sysID)
Sets the system ID of the DOCTYPE declaration.XMLBuilderParametersImpl
setValidating(boolean f)
Sets a flag whether schema/DTD validation should be performed.-
Methods inherited from class org.apache.commons.configuration2.builder.HierarchicalBuilderParametersImpl
setExpressionEngine
-
Methods inherited from class org.apache.commons.configuration2.builder.FileBasedBuilderParametersImpl
clone, fromMap, fromParameters, fromParameters, getFileHandler, getParameters, getReloadingDetectorFactory, getReloadingRefreshDelay, setBasePath, setEncoding, setFile, setFileName, setFileSystem, setLocationStrategy, setPath, setReloadingDetectorFactory, setReloadingRefreshDelay, setURL
-
Methods inherited from class org.apache.commons.configuration2.builder.BasicBuilderParameters
copyPropertiesFrom, fetchBeanHelper, fetchInterpolatorSpecification, fetchProperty, merge, setBeanHelper, setConfigurationDecoder, setConversionHandler, setDefaultLookups, setInterpolator, setListDelimiterHandler, setLogger, setParentInterpolator, setPrefixLookups, setSynchronizer, setThrowExceptionOnMissing, storeProperty
-
-
-
-
Method Detail
-
inheritFrom
public void inheritFrom(java.util.Map<java.lang.String,?> source)
Description copied from class:HierarchicalBuilderParametersImpl
Inherits properties from the specified map. This can be used for instance to reuse parameters from one builder in another builder - also in parent-child relations in which a parent builder creates child builders. The purpose of this method is to let a concrete implementation decide which properties can be inherited. Because parameters are basically organized as a map it would be possible to simply copy over all properties from the source object. However, this is not appropriate in all cases. For instance, some properties - like aConfigurationInterpolator
- are tightly connected to a configuration and cannot be reused in a different context. For other properties, e.g. a file name, it does not make sense to copy it. Therefore, an implementation has to be explicit in the properties it wants to take over. This implementation takes some properties defined in this class into account. This implementation copies some more properties defined by this class.- Overrides:
inheritFrom
in classHierarchicalBuilderParametersImpl
- Parameters:
source
- the source properties to inherit from
-
setDocumentBuilder
public XMLBuilderParametersImpl setDocumentBuilder(javax.xml.parsers.DocumentBuilder docBuilder)
Description copied from interface:XMLBuilderProperties
Allows setting theDocumentBuilder
for parsing an XML document. This is the most flexible way of customizing XML processing.- Specified by:
setDocumentBuilder
in interfaceXMLBuilderProperties<XMLBuilderParametersImpl>
- Parameters:
docBuilder
- theDocumentBuilder
to use- Returns:
- a reference to this object for method chaining
-
setEntityResolver
public XMLBuilderParametersImpl setEntityResolver(org.xml.sax.EntityResolver resolver)
Description copied from interface:XMLBuilderProperties
Allows setting theEntityResolver
which maps entity references during XML parsing.- Specified by:
setEntityResolver
in interfaceXMLBuilderProperties<XMLBuilderParametersImpl>
- Parameters:
resolver
- theEntityResolver
to use- Returns:
- a reference to this object for method chaining
-
getEntityResolver
public org.xml.sax.EntityResolver getEntityResolver()
Returns theEntityResolver
stored in this parameters object. Result is null if no such object has been set.- Returns:
- the
EntityResolver
or null
-
setPublicID
public XMLBuilderParametersImpl setPublicID(java.lang.String pubID)
Description copied from interface:XMLBuilderProperties
Sets the public ID of the DOCTYPE declaration.- Specified by:
setPublicID
in interfaceXMLBuilderProperties<XMLBuilderParametersImpl>
- Parameters:
pubID
- the public ID- Returns:
- a reference to this object for method chaining
-
setSystemID
public XMLBuilderParametersImpl setSystemID(java.lang.String sysID)
Description copied from interface:XMLBuilderProperties
Sets the system ID of the DOCTYPE declaration.- Specified by:
setSystemID
in interfaceXMLBuilderProperties<XMLBuilderParametersImpl>
- Parameters:
sysID
- the system ID- Returns:
- a reference to this object for method chaining
-
setValidating
public XMLBuilderParametersImpl setValidating(boolean f)
Description copied from interface:XMLBuilderProperties
Sets a flag whether schema/DTD validation should be performed.- Specified by:
setValidating
in interfaceXMLBuilderProperties<XMLBuilderParametersImpl>
- Parameters:
f
- the validation flag- Returns:
- a reference to this object for method chaining
-
setSchemaValidation
public XMLBuilderParametersImpl setSchemaValidation(boolean f)
Description copied from interface:XMLBuilderProperties
Sets the value of the schemaValidation flag. This flag determines whether DTD or Schema validation should be used.- Specified by:
setSchemaValidation
in interfaceXMLBuilderProperties<XMLBuilderParametersImpl>
- Parameters:
f
- the flag value, true for schema validation, false for DTD validation- Returns:
- a reference to this object for method chaining
-
-