Package net.sf.saxon.event
Class Stripper
java.lang.Object
net.sf.saxon.event.SequenceReceiver
net.sf.saxon.event.ProxyReceiver
net.sf.saxon.event.Stripper
- Direct Known Subclasses:
AllElementStripper
,StylesheetStripper
The Stripper class maintains details of which elements need to be stripped.
The code is written to act as a SAX-like filter to do the stripping.
- Author:
- Michael H. Kay
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final byte
static final byte
static final byte
static final byte
static final byte
Fields inherited from class net.sf.saxon.event.ProxyReceiver
nextReceiver
Fields inherited from class net.sf.saxon.event.SequenceReceiver
pipelineConfiguration, previousAtomic, systemId
Fields inherited from interface javax.xml.transform.Result
PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
attribute
(int nameCode, int typeCode, CharSequence value, int locationId, int properties) Notify an attribute.void
characters
(CharSequence chars, int locationId, int properties) Handle a text nodevoid
Handle an end-of-element eventGet a clean copy of this stripperboolean
Determine if all whitespace is to be stripped (in this case, no further testing is needed)byte
isSpacePreserving
(int nameCode) Decide whether an element is in the set of white-space preserving element typesbyte
isSpacePreserving
(NodeInfo element) Decide whether an element is in the set of white-space preserving element types.void
open()
Callback interface for SAX: not for application usevoid
Set the pipeline configurationvoid
Specify that all whitespace nodes are to be strippedvoid
startElement
(int nameCode, int typeCode, int locationId, int properties) Notify the start of an elementMethods inherited from class net.sf.saxon.event.ProxyReceiver
close, comment, endDocument, getConfiguration, getDocumentLocator, getNamePool, getUnderlyingReceiver, namespace, processingInstruction, setSystemId, setUnderlyingReceiver, setUnparsedEntity, startContent, startDocument
Methods inherited from class net.sf.saxon.event.SequenceReceiver
append, getPipelineConfiguration, getSystemId
-
Field Details
-
ALWAYS_PRESERVE
public static final byte ALWAYS_PRESERVE- See Also:
-
ALWAYS_STRIP
public static final byte ALWAYS_STRIP- See Also:
-
STRIP_DEFAULT
public static final byte STRIP_DEFAULT- See Also:
-
PRESERVE_PARENT
public static final byte PRESERVE_PARENT- See Also:
-
CANNOT_STRIP
public static final byte CANNOT_STRIP- See Also:
-
-
Constructor Details
-
Stripper
protected Stripper()Default constructor for use in subclasses -
Stripper
create a Stripper and initialise variables- Parameters:
stripperRules
- defines which elements have whitespace stripped. If null, all whitespace is preserved.
-
-
Method Details
-
getAnother
Get a clean copy of this stripper -
setStripAll
public void setStripAll()Specify that all whitespace nodes are to be stripped -
getStripAll
public boolean getStripAll()Determine if all whitespace is to be stripped (in this case, no further testing is needed) -
setPipelineConfiguration
Description copied from interface:Receiver
Set the pipeline configuration- Specified by:
setPipelineConfiguration
in interfaceReceiver
- Overrides:
setPipelineConfiguration
in classProxyReceiver
-
isSpacePreserving
Decide whether an element is in the set of white-space preserving element types- Parameters:
nameCode
- Identifies the name of the element whose whitespace is to be preserved- Returns:
- ALWAYS_PRESERVE if the element is in the set of white-space preserving element types, ALWAYS_STRIP if the element is to be stripped regardless of the xml:space setting, and STRIP_DEFAULT otherwise
- Throws:
XPathException
-
isSpacePreserving
Decide whether an element is in the set of white-space preserving element types. This version of the method is useful in cases where getting the namecode of the element is potentially expensive, e.g. with DOM nodes.- Parameters:
element
- Identifies the element whose whitespace is possibly to be preserved- Returns:
- ALWAYS_PRESERVE if the element is in the set of white-space preserving element types, ALWAYS_STRIP if the element is to be stripped regardless of the xml:space setting, and STRIP_DEFAULT otherwise
- Throws:
XPathException
-
open
Callback interface for SAX: not for application use- Specified by:
open
in interfaceReceiver
- Overrides:
open
in classProxyReceiver
- Throws:
XPathException
-
startElement
public void startElement(int nameCode, int typeCode, int locationId, int properties) throws XPathException Description copied from class:ProxyReceiver
Notify the start of an element- Specified by:
startElement
in interfaceReceiver
- Overrides:
startElement
in classProxyReceiver
- Parameters:
nameCode
- integer code identifying the name of the element within the name pool.typeCode
- integer code identifying the element's type within the name pool.locationId
- an integer which can be interpreted using aLocationProvider
to return information such as line number and system ID. If no location information is available, the value zero is supplied.properties
- properties of the element node- Throws:
XPathException
-
attribute
public void attribute(int nameCode, int typeCode, CharSequence value, int locationId, int properties) throws XPathException Description copied from class:ProxyReceiver
Notify an attribute. Attributes are notified after the startElement event, and before any children. Namespaces and attributes may be intermingled.- Specified by:
attribute
in interfaceReceiver
- Overrides:
attribute
in classProxyReceiver
- Parameters:
nameCode
- The name of the attribute, as held in the name pooltypeCode
- The type of the attribute, as held in the name poollocationId
- an integer which can be interpreted using aLocationProvider
to return information such as line number and system ID. If no location information is available, the value zero is supplied.properties
- Bit significant value. The following bits are defined:- DISABLE_ESCAPING
- Disable escaping for this attribute
- NO_SPECIAL_CHARACTERS
- Attribute value contains no special characters
- Throws:
XPathException
-
endElement
Handle an end-of-element event- Specified by:
endElement
in interfaceReceiver
- Overrides:
endElement
in classProxyReceiver
- Throws:
XPathException
-
characters
Handle a text node- Specified by:
characters
in interfaceReceiver
- Overrides:
characters
in classProxyReceiver
- Parameters:
chars
- The characterslocationId
- an integer which can be interpreted using aLocationProvider
to return information such as line number and system ID. If no location information is available, the value zero is supplied.properties
- Bit significant value. The following bits are defined:- DISABLE_ESCAPING
- Disable escaping for this text node
- USE_CDATA
- Output as a CDATA section
- NO_SPECIAL_CHARACTERS
- Value contains no special characters
- WHITESPACE
- Text is all whitespace
- Throws:
XPathException
-