com.helger.commons.xml.serialize.read

Class SAXReaderSettings

java.lang.Object

com.helger.commons.xml.serialize.read.SAXReaderSettings

All Implemented Interfaces:

ICloneable<SAXReaderSettings>, IBaseXMLReaderSettings, ISAXReaderSettings

@NotThreadSafe
public class SAXReaderSettings
extends Object
implements ISAXReaderSettings, ICloneable<SAXReaderSettings>

SAX reader settings

Author:

Philip Helger

Constructor Summary

Constructors

Constructor and Description
SAXReaderSettings() Default constructor
SAXReaderSettings(ISAXReaderSettings aOther) Copy constructor

Method Summary

Modifier and Type	Method and Description
void	applyToSAXReader(XMLReader aParser) Apply all settings of this object onto the specified XMLReader object
static SAXReaderSettings	createCloneOnDemand(ISAXReaderSettings aOther) Create a clone of the passed settings, depending on the parameter.
Map<EXMLParserFeature,Boolean>	getAllFeatureValues()
Map<EXMLParserProperty,Object>	getAllPropertyValues()
SAXReaderSettings	getClone()
ContentHandler	getContentHandler()
DeclHandler	getDeclarationHandler()
DTDHandler	getDTDHandler()
EntityResolver	getEntityResolver()
ErrorHandler	getErrorHandler()
IExceptionCallback<Throwable>	getExceptionHandler()
Boolean	getFeatureValue(EXMLParserFeature eFeature) Get the value of the specified parser feature
LexicalHandler	getLexicalHandler()
Locale	getLocale()
Object	getPropertyValue(EXMLParserProperty eProperty) Get the value of the specified parser property
boolean	hasAnyFeature()
boolean	hasAnyProperties()
boolean	isRequiresNewXMLParserExplicitly()
EChange	removeAllFeatures()
EChange	removeAllPropertyValues()
EChange	removeFeature(EXMLParserFeature eFeature)
EChange	removePropertyValue(EXMLParserProperty eProperty)
boolean	requiresNewXMLParser() Check if the current settings require a separate DocumentBuilderFactory or if a pooled default object can be used.
SAXReaderSettings	setContentHandler(ContentHandler aContentHandler)
SAXReaderSettings	setDeclarationHandler(DeclHandler aDeclHandler)
SAXReaderSettings	setDTDHandler(DTDHandler aDTDHandler)
SAXReaderSettings	setEntityResolver(EntityResolver aEntityResolver)
SAXReaderSettings	setErrorHandler(ErrorHandler aErrorHandler)
SAXReaderSettings	setExceptionHandler(IExceptionCallback<Throwable> aExceptionHandler)
SAXReaderSettings	setFeatureValue(EXMLParserFeature eFeature, boolean bValue)
SAXReaderSettings	setFeatureValue(EXMLParserFeature eFeature, Boolean aValue)
SAXReaderSettings	setFeatureValues(Map<EXMLParserFeature,Boolean> aValues)
SAXReaderSettings	setLexicalHandler(LexicalHandler aLexicalHandler)
SAXReaderSettings	setLocale(Locale aLocale)
SAXReaderSettings	setPropertyValue(EXMLParserProperty eProperty, Object aPropertyValue)
SAXReaderSettings	setPropertyValues(Map<EXMLParserProperty,?> aProperties)
SAXReaderSettings	setRequiresNewXMLParserExplicitly(boolean bRequiresNewXMLParserExplicitly)
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

SAXReaderSettings

public SAXReaderSettings()

Default constructor

SAXReaderSettings

public SAXReaderSettings(@Nonnull
                         ISAXReaderSettings aOther)

Copy constructor

Parameters:

aOther - the object to copy the settings from. May not be null.

Method Detail

getEntityResolver

@Nullable
public EntityResolver getEntityResolver()

Specified by:

getEntityResolver in interface IBaseXMLReaderSettings

Returns:

The special entity resolver to be used. May be null.

setEntityResolver

@Nonnull
public final SAXReaderSettings setEntityResolver(@Nullable
                                                           EntityResolver aEntityResolver)

getDTDHandler

@Nullable
public DTDHandler getDTDHandler()

Specified by:

getDTDHandler in interface ISAXReaderSettings

Returns:

The special DTD handler to be used. May be null.

setDTDHandler

@Nonnull
public final SAXReaderSettings setDTDHandler(@Nullable
                                                       DTDHandler aDTDHandler)

getContentHandler

@Nullable
public ContentHandler getContentHandler()

Specified by:

getContentHandler in interface ISAXReaderSettings

Returns:

The special content handler to be used. May be null.

setContentHandler

@Nonnull
public final SAXReaderSettings setContentHandler(@Nullable
                                                           ContentHandler aContentHandler)

getErrorHandler

@Nullable
public ErrorHandler getErrorHandler()

Specified by:

getErrorHandler in interface IBaseXMLReaderSettings

Returns:

A special error handler to be used or null if no special error handler is needed.

setErrorHandler

@Nonnull
public final SAXReaderSettings setErrorHandler(@Nullable
                                                         ErrorHandler aErrorHandler)

getLexicalHandler

@Nullable
public LexicalHandler getLexicalHandler()

Specified by:

getLexicalHandler in interface ISAXReaderSettings

Returns:

The special lexical handler to be used. May be null.

setLexicalHandler

@Nonnull
public final SAXReaderSettings setLexicalHandler(@Nullable
                                                           LexicalHandler aLexicalHandler)

getDeclarationHandler

@Nullable
public DeclHandler getDeclarationHandler()

Specified by:

getDeclarationHandler in interface ISAXReaderSettings

Returns:

The special DTD declaration event handler to be used. May be null.

setDeclarationHandler

@Nonnull
public final SAXReaderSettings setDeclarationHandler(@Nullable
                                                               DeclHandler aDeclHandler)

hasAnyProperties

public boolean hasAnyProperties()

Specified by:

hasAnyProperties in interface IBaseXMLReaderSettings

Returns:

true if at least one parser property is defined

getPropertyValue

@Nullable
public Object getPropertyValue(@Nullable
                                          EXMLParserProperty eProperty)

Description copied from interface: IBaseXMLReaderSettings

Get the value of the specified parser property

Specified by:

getPropertyValue in interface IBaseXMLReaderSettings

Parameters:

eProperty - The property to use. May be null.

Returns:

null if no such property was found.

getAllPropertyValues

@Nonnull
 @ReturnsMutableCopy
public Map<EXMLParserProperty,Object> getAllPropertyValues()

Specified by:

getAllPropertyValues in interface IBaseXMLReaderSettings

Returns:

A copy of all contained parser property values. Never null.

setPropertyValue

@Nonnull
public final SAXReaderSettings setPropertyValue(@Nonnull
                                                          EXMLParserProperty eProperty,
                                                          @Nullable
                                                          Object aPropertyValue)

setPropertyValues

@Nonnull
public final SAXReaderSettings setPropertyValues(@Nullable
                                                           Map<EXMLParserProperty,?> aProperties)

removePropertyValue

@Nonnull
public final EChange removePropertyValue(@Nullable
                                                   EXMLParserProperty eProperty)

removeAllPropertyValues

@Nonnull
public final EChange removeAllPropertyValues()

getLocale

@Nullable
public Locale getLocale()

Specified by:

getLocale in interface IBaseXMLReaderSettings

Returns:

The locale to be used for error messages. By default it is null and therefore the XML parser will use the system default locale.

setLocale

public SAXReaderSettings setLocale(@Nullable
                                   Locale aLocale)

hasAnyFeature

public boolean hasAnyFeature()

Specified by:

hasAnyFeature in interface IBaseXMLReaderSettings

Returns:

true if at least one parser feature is defined, false if not

getFeatureValue

@Nullable
public Boolean getFeatureValue(@Nullable
                                          EXMLParserFeature eFeature)

Description copied from interface: IBaseXMLReaderSettings

Get the value of the specified parser feature

Specified by:

getFeatureValue in interface IBaseXMLReaderSettings

Parameters:

eFeature - The feature to search. May be null.

Returns:

null if this feature is undefined.

getAllFeatureValues

@Nonnull
 @ReturnsMutableCopy
public Map<EXMLParserFeature,Boolean> getAllFeatureValues()

Specified by:

getAllFeatureValues in interface IBaseXMLReaderSettings

Returns:

A copy of all defined parser features at the associated values.

setFeatureValue

@Nonnull
public final SAXReaderSettings setFeatureValue(@Nonnull
                                                         EXMLParserFeature eFeature,
                                                         boolean bValue)

setFeatureValue

@Nonnull
public final SAXReaderSettings setFeatureValue(@Nonnull
                                                         EXMLParserFeature eFeature,
                                                         @Nullable
                                                         Boolean aValue)

setFeatureValues

@Nonnull
public final SAXReaderSettings setFeatureValues(@Nullable
                                                          Map<EXMLParserFeature,Boolean> aValues)

removeFeature

@Nonnull
public final EChange removeFeature(@Nullable
                                             EXMLParserFeature eFeature)

removeAllFeatures

@Nonnull
public final EChange removeAllFeatures()

requiresNewXMLParser

public boolean requiresNewXMLParser()

Description copied from interface: ISAXReaderSettings

Check if the current settings require a separate DocumentBuilderFactory or if a pooled default object can be used.

Specified by:

requiresNewXMLParser in interface IBaseXMLReaderSettings

Specified by:

requiresNewXMLParser in interface ISAXReaderSettings

Returns:

true if a separate DocumentBuilderFactory is required, false if not.

getExceptionHandler

@Nonnull
public IExceptionCallback<Throwable> getExceptionHandler()

Specified by:

getExceptionHandler in interface IBaseXMLReaderSettings

Returns:

A special exception handler to be used. Never null.

setExceptionHandler

@Nonnull
public final SAXReaderSettings setExceptionHandler(@Nonnull
                                                             IExceptionCallback<Throwable> aExceptionHandler)

isRequiresNewXMLParserExplicitly

public boolean isRequiresNewXMLParserExplicitly()

Specified by:

isRequiresNewXMLParserExplicitly in interface ISAXReaderSettings

Returns:

true if a new XML parser is explicitly required for this instance.

setRequiresNewXMLParserExplicitly

@Nonnull
public final SAXReaderSettings setRequiresNewXMLParserExplicitly(boolean bRequiresNewXMLParserExplicitly)

getClone

@Nonnull
public SAXReaderSettings getClone()

Specified by:

getClone in interface ICloneable<SAXReaderSettings>

Returns:

A 100% deep-copy of the implementing class.

applyToSAXReader

public void applyToSAXReader(@Nonnull
                             XMLReader aParser)

Description copied from interface: ISAXReaderSettings

Apply all settings of this object onto the specified XMLReader object

Specified by:

applyToSAXReader in interface ISAXReaderSettings

Parameters:

aParser - The XML reader to apply the settings onto. May not be null.

toString

public String toString()

Overrides:

toString in class Object

createCloneOnDemand

@Nonnull
public static SAXReaderSettings createCloneOnDemand(@Nullable
                                                              ISAXReaderSettings aOther)

Create a clone of the passed settings, depending on the parameter. If the parameter is null a new empty SAXReaderSettings object is created, otherwise a copy of the parameter is created.

Parameters:

aOther - The parameter to be used. May be null.

Returns:

Never null.