|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object net.sf.saxon.event.Builder net.sf.saxon.tree.linked.LinkedTreeBuilder
public class LinkedTreeBuilder
The LinkedTreeBuilder class is responsible for taking a stream of Receiver events and constructing a Document tree using the linked tree implementation.
Field Summary |
---|
Fields inherited from class net.sf.saxon.event.Builder |
---|
baseURI, config, currentRoot, JDOM_TREE, JDOM2_TREE, lineNumbering, LINKED_TREE, namePool, open, pipe, STANDARD_TREE, started, systemId, timing, TINY_TREE, TINY_TREE_CONDENSED, UNSPECIFIED_TREE_MODEL |
Fields inherited from interface javax.xml.transform.Result |
---|
PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING |
Constructor Summary | |
---|---|
LinkedTreeBuilder(PipelineConfiguration pipe)
Create a Builder and initialise variables |
Method Summary | |
---|---|
void |
attribute(NodeName attName,
SimpleType typeCode,
CharSequence value,
int locationId,
int properties)
Notify an attribute. |
void |
characters(CharSequence chars,
int locationId,
int properties)
Notify a text node. |
void |
close()
Close the stream of Receiver events |
void |
comment(CharSequence chars,
int locationId,
int properties)
Notify a comment |
void |
endDocument()
Notify the end of the document |
void |
endElement()
Notify the end of an element |
BuilderMonitor |
getBuilderMonitor()
Get a builder monitor for this builder. |
NodeImpl |
getCurrentLeafNode()
Get the current text, comment, or processing instruction node |
net.sf.saxon.tree.linked.ParentNodeImpl |
getCurrentParentNode()
Get the current document or element node |
NodeInfo |
getCurrentRoot()
Get the current root node. |
void |
graftElement(ElementImpl element)
graftElement() allows an element node to be transferred from one tree to another. |
void |
namespace(NamespaceBinding namespaceBinding,
int properties)
Notify a namespace. |
void |
open()
Open the stream of Receiver events |
void |
processingInstruction(String name,
CharSequence remainder,
int locationId,
int properties)
Notify a processing instruction |
void |
reset()
Reset the builder to its initial state. |
void |
setAllocateSequenceNumbers(boolean allocate)
Set whether the builder should allocate sequence numbers to elements as they are added to the tree. |
void |
setNodeFactory(NodeFactory factory)
Set the Node Factory to use. |
void |
setUnparsedEntity(String name,
String uri,
String publicId)
Set an unparsed entity URI for the document |
void |
startContent()
Notify the start of the content, that is, the completion of all attributes and namespaces. |
void |
startDocument(int properties)
Start of a document node. |
void |
startElement(NodeName nameCode,
SchemaType typeCode,
int locationId,
int properties)
Notify the start of an element |
Methods inherited from class net.sf.saxon.event.Builder |
---|
getBaseURI, getConfiguration, getPipelineConfiguration, getSystemId, isTiming, setBaseURI, setLineNumbering, setPipelineConfiguration, setSystemId, setTiming, usesTypeAnnotations |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public LinkedTreeBuilder(PipelineConfiguration pipe)
pipe
- the pipeline configurationMethod Detail |
---|
public NodeInfo getCurrentRoot()
getCurrentRoot
in class Builder
public void reset()
Builder
reset
in class Builder
public void setAllocateSequenceNumbers(boolean allocate)
allocate
- true if sequence numbers are to be allocatedpublic void setNodeFactory(NodeFactory factory)
factory
- the node factory to be used. This allows custom objects to be used to represent
the elements in the tree.public void open()
open
in interface Receiver
open
in class Builder
public void startDocument(int properties) throws XPathException
properties
- bit-significant integer indicating properties of the document node.
The definitions of the bits are in class ReceiverOptions
XPathException
- if an error occurspublic void endDocument() throws XPathException
XPathException
- if an error occurspublic void close() throws XPathException
close
in interface Receiver
close
in class Builder
XPathException
- if an error occurspublic void startElement(NodeName nameCode, SchemaType typeCode, int locationId, int properties) throws XPathException
nameCode
- the name of the element.typeCode
- the type annotation of the element.locationId
- an integer which can be interpreted using a LocationProvider
to return
information such as line number and system ID. If no location information is available,
the value zero is supplied.properties
- bit-significant properties of the element node. If there are no revelant
properties, zero is supplied. The definitions of the bits are in class ReceiverOptions
XPathException
- if an error occurspublic void namespace(NamespaceBinding namespaceBinding, int properties)
Receiver
namespaceBinding
- contains the namespace prefix and namespace URIproperties
- The most important property is REJECT_DUPLICATES. If this property is set, the
namespace declaration will be rejected if it conflicts with a previous declaration of the same
prefix. If the property is not set, the namespace declaration will be ignored if it conflicts
with a previous declaration. This reflects the fact that when copying a tree, namespaces for child
elements are emitted before the namespaces of their parent element. Unfortunately this conflicts
with the XSLT rule for complex content construction, where the recovery action in the event of
conflicts is to take the namespace that comes last. XSLT therefore doesn't recover from this error:public void attribute(NodeName attName, SimpleType typeCode, CharSequence value, int locationId, int properties) throws XPathException
Receiver
attName
- The name of the attributetypeCode
- The type of the attribute, as held in the name pool. The additional bit
NodeInfo.IS_DTD_TYPE may be set to indicate a DTD-derived type.value
- the string value of the attributelocationId
- an integer which can be interpreted using a LocationProvider
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:
XPathException
- if an error occurspublic void startContent() throws XPathException
Receiver
XPathException
- if an error occurspublic void endElement() throws XPathException
XPathException
- if an error occurspublic void characters(CharSequence chars, int locationId, int properties) throws XPathException
chars
- The characterslocationId
- an integer which can be interpreted using a LocationProvider
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:
XPathException
- if an error occurspublic void processingInstruction(String name, CharSequence remainder, int locationId, int properties)
name
- The PI name. This must be a legal name (it will not be checked).remainder
- The data portion of the processing instructionlocationId
- an integer which can be interpreted using a LocationProvider
to return
information such as line number and system ID. If no location information is available,
the value zero is supplied.properties
- Additional information about the PI.public void comment(CharSequence chars, int locationId, int properties) throws XPathException
chars
- The content of the commentlocationId
- an integer which can be interpreted using a LocationProvider
to return
information such as line number and system ID. If no location information is available,
the value zero is supplied.properties
- Additional information about the comment.
XPathException
- if an error occurspublic net.sf.saxon.tree.linked.ParentNodeImpl getCurrentParentNode()
public NodeImpl getCurrentLeafNode()
public void graftElement(ElementImpl element) throws XPathException
element
- the element to be grafted in as a new child.
XPathException
public void setUnparsedEntity(String name, String uri, String publicId)
name
- The name of the unparsed entityuri
- The system identifier of the unparsed entitypublicId
- The public identifier of the unparsed entitypublic BuilderMonitor getBuilderMonitor()
getBuilderMonitor
in class Builder
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |