|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object net.sf.saxon.lib.AugmentedSource
public class AugmentedSource
This class is an extension of the JAXP Source interface. The class can be used wherever a JAXP Source object can be used, and it provides additional information about the way that the Source is to be processed: for example, it indicates whether or not it should be validated against a schema. Other options that can be set include the SAX XMLReader to be used, and the choice of whether a source in the form of an existing tree should be copied or wrapped.
Internally, an AugmentedSource combines an underlying Source object with a
ParseOptions
object holding the selected options. Many Saxon interfaces allow
the ParseOptions to be supplied directly, making this class unnecessary; but it is useful
when passing a Source to a JAXP interface that does not allow further options to be
supplied.
Method Summary | |
---|---|
void |
addFilter(FilterFactory filter)
Add a filter to the list of filters to be applied to the raw input |
void |
close()
Close any resources held by this Source. |
Source |
getContainedSource()
Get the Source object wrapped by this AugmentedSource |
int |
getDTDValidation()
Get whether or not DTD validation of this source is required |
EntityResolver |
getEntityResolver()
Get the EntityResolver that will be used when parsing |
ErrorListener |
getErrorListener()
Get the ErrorListener that will be used when parsing |
List<FilterFactory> |
getFilters()
Get the list of filters to be applied to the input. |
TreeModel |
getModel()
Get the tree model that will be used. |
ParseOptions |
getParseOptions()
Get the ParseOptions defined in this AugmentedSource |
int |
getSchemaValidation()
Get whether or not schema validation of this source is required |
int |
getStripSpace()
Get the space-stripping action to be applied to the source document |
String |
getSystemId()
Get the System ID. |
StructuredQName |
getTopLevelElement()
Get the name of the top-level element for validation. |
SchemaType |
getTopLevelType()
Get the type of the document element for validation. |
int |
getTreeModel()
Deprecated. since 9.2: use getModel() |
Boolean |
getWrapDocument()
Assuming that the contained Source is a node in a tree, determine whether a tree will be created as a view of this supplied tree, or as a copy. |
XMLReader |
getXMLReader()
Get the SAX parser (XMLReader) to be used |
boolean |
isLineNumbering()
Get whether line numbers are to be maintained in the constructed document |
boolean |
isLineNumberingSet()
Determine whether setLineNumbering() has been called |
boolean |
isPleaseCloseAfterUse()
Determine whether or not the user of this Source is encouraged to close it as soon as reading is finished. |
boolean |
isXIncludeAware()
Get state of XInclude processing. |
boolean |
isXIncludeAwareSet()
Determine whether setXIncludeAware() has been called. |
static AugmentedSource |
makeAugmentedSource(Source source)
Create an AugmentedSource that wraps a given Source object. |
void |
setDTDValidationMode(int option)
Set whether or not DTD validation of this source is required |
void |
setEntityResolver(EntityResolver resolver)
Set an EntityResolver to be used when parsing. |
void |
setErrorListener(ErrorListener listener)
Set an ErrorListener to be used when parsing |
void |
setLineNumbering(boolean lineNumbering)
Set whether line numbers are to be maintained in the constructed document |
void |
setModel(TreeModel model)
Set the tree model to use. |
void |
setPleaseCloseAfterUse(boolean close)
Set whether or not the user of this Source is encouraged to close it as soon as reading is finished. |
void |
setSchemaValidationMode(int option)
Set whether or not schema validation of this source is required |
void |
setStripSpace(int stripAction)
Set the space-stripping action to be applied to the source document |
void |
setSystemId(String id)
Set the System ID. |
void |
setTopLevelElement(StructuredQName elementName)
Set the name of the top-level element for validation. |
void |
setTopLevelType(SchemaType type)
Set the type of the top-level element for validation. |
void |
setTreeModel(int model)
Deprecated. since 9.2: use setModel(net.sf.saxon.om.TreeModel) |
void |
setWrapDocument(Boolean wrap)
Assuming that the contained Source is a node in a tree, indicate whether a tree should be created as a view of this supplied tree, or as a copy. |
void |
setXIncludeAware(boolean state)
Set state of XInclude processing. |
void |
setXMLReader(XMLReader parser)
Set the SAX parser (XMLReader) to be used |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public static AugmentedSource makeAugmentedSource(Source source)
source
- the Source object to be wrapped
public void addFilter(FilterFactory filter)
filter
- a factory for the filter to be addedpublic List<FilterFactory> getFilters()
public Source getContainedSource()
public ParseOptions getParseOptions()
public void setStripSpace(int stripAction)
stripAction
- one of Whitespace.IGNORABLE
,
Whitespace.ALL
, or Whitespace.NONE
public int getStripSpace()
Whitespace.IGNORABLE
,
Whitespace.ALL
, or Whitespace.NONE
public void setTreeModel(int model)
setModel(net.sf.saxon.om.TreeModel)
model
- one of Builder.TINY_TREE
, Builder.TINY_TREE_CONDENSED
or
Builder.LINKED_TREE
public int getTreeModel()
getModel()
Builder.TINY_TREE
, Builder.TINY_TREE_CONDENSED
,
Builder.LINKED_TREE
, or {link Builder#UNSPECIFIED_TREE_MODEL}
if no call on setTreeModel() has been madepublic void setModel(TreeModel model)
model
- typically one of the constants TreeModel.TINY_TREE
,
TreeModel.TINY_TREE_CONDENSED
, or TreeModel.LINKED_TREE
. However, in principle
a user-defined tree model can be used.public TreeModel getModel()
TreeModel.TINY_TREE
,
TreeModel.TINY_TREE_CONDENSED
, or TreeModel.LINKED_TREE
. However, in principle
a user-defined tree model can be used.public void setSchemaValidationMode(int option)
option
- one of Validation.STRICT
,
Validation.LAX
, Validation.STRIP
,
Validation.PRESERVE
, Validation.DEFAULT
public int getSchemaValidation()
Validation.DEFAULT
to use the default validation mode from the Configuration.public void setTopLevelElement(StructuredQName elementName)
elementName
- the QName of the required top-level element, or null to unset the valuepublic StructuredQName getTopLevelElement()
public void setTopLevelType(SchemaType type)
type
- the schema type required for the document element, or null to unset the valuepublic SchemaType getTopLevelType()
public void setDTDValidationMode(int option)
option
- one of Validation.STRICT
,
Validation.STRIP
, Validation.DEFAULT
public int getDTDValidation()
Validation.DEFAULT
to use the default validation mode from the Configuration.public void setLineNumbering(boolean lineNumbering)
lineNumbering
- true if line numbers are to be maintainedpublic boolean isLineNumbering()
public boolean isLineNumberingSet()
public void setXMLReader(XMLReader parser)
parser
- the SAX parserpublic XMLReader getXMLReader()
public void setWrapDocument(Boolean wrap)
This option is used only when the Source is supplied to an interface such as the JAXP Transformer.transform() method where there is no other way of indicating whether a supplied external document should be wrapped or copied. It is not used when the Source is supplied to a Saxon-defined interface.
wrap
- if true, the node in the supplied Source is wrapped, to create a view. If false, the node
and its contained subtree is copied. If null, the system default is chosen.public Boolean getWrapDocument()
This option is used only when the Source is supplied to an interface such as the JAXP Transformer.transform() method where there is no other way of indicating whether a supplied external document should be wrapped or copied. It is not used when the Source is supplied to a Saxon-defined interface.
public void setSystemId(String id)
setSystemId
in interface Source
id
- the System ID. This provides a base URI for the document, and also the result
of the document-uri() functionpublic String getSystemId()
getSystemId
in interface Source
public void setXIncludeAware(boolean state)
Set state of XInclude processing.
If XInclude markup is found in the document instance, should it be processed as specified in XML Inclusions (XInclude) Version 1.0.
XInclude processing defaults to false
.
state
- Set XInclude processing to true
or
false
public boolean isXIncludeAwareSet()
Determine whether setXIncludeAware() has been called.
public boolean isXIncludeAware()
Get state of XInclude processing.
public void setEntityResolver(EntityResolver resolver)
resolver
- the EntityResolver to be usedpublic EntityResolver getEntityResolver()
setEntityResolver(org.xml.sax.EntityResolver)
,
otherwise null.public void setErrorListener(ErrorListener listener)
listener
- the ErrorListener to be usedpublic ErrorListener getErrorListener()
setErrorListener(javax.xml.transform.ErrorListener)
,
otherwise null.public void setPleaseCloseAfterUse(boolean close)
close
- true if the source should be closed as soon as it has been consumedpublic boolean isPleaseCloseAfterUse()
public void close()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |