Package org.codehaus.stax2.io
Class Stax2Result
- java.lang.Object
-
- org.codehaus.stax2.io.Stax2Result
-
- All Implemented Interfaces:
javax.xml.transform.Result
- Direct Known Subclasses:
Stax2BlockResult
,Stax2ReferentialResult
public abstract class Stax2Result extends java.lang.Object implements javax.xml.transform.Result
This is the base class for additional output results (implementations ofResult
) that Stax2XMLInputFactory2
implementations should support.Note about usage by the parser factory implementations: the expectation is that at least one of methods
constructWriter()
andconstructOutputStream()
will succeed, but not necessarily both. This generally depends on type of resource being represented: for example, if the source is a StringBuffer, it is most naturally represent viaWriter
. For File-backed results, on the other hand, anOutputStream
is the most natural access method.Other things to note about using result
Writer
s andOutputStream
s:- Caller is responsible for closing any
Writer
andOutputStream
instances requested. That is, caller owns these accessor objects. - Result objects are only required to return a non-null object once: after this, if new non-null instances are returned, they must not be the same objects as returned earlier. Implementations can choose to construct new instances to the same backing data structure or resource; if so, they should document this behavior.
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
Stax2Result()
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description abstract java.io.OutputStream
constructOutputStream()
This method creates anOutputStream
via which underlying output target can be written to.abstract java.io.Writer
constructWriter()
This method creates aWriter
via which underlying output target can be written to.java.lang.String
getEncoding()
java.lang.String
getPublicId()
java.lang.String
getSystemId()
void
setEncoding(java.lang.String enc)
void
setPublicId(java.lang.String id)
void
setSystemId(java.lang.String id)
-
-
-
Method Detail
-
getSystemId
public java.lang.String getSystemId()
- Specified by:
getSystemId
in interfacejavax.xml.transform.Result
-
setSystemId
public void setSystemId(java.lang.String id)
- Specified by:
setSystemId
in interfacejavax.xml.transform.Result
-
getPublicId
public java.lang.String getPublicId()
-
setPublicId
public void setPublicId(java.lang.String id)
-
getEncoding
public java.lang.String getEncoding()
-
setEncoding
public void setEncoding(java.lang.String enc)
-
constructWriter
public abstract java.io.Writer constructWriter() throws java.io.IOException
This method creates aWriter
via which underlying output target can be written to. Note that caller is responsible for closing that Writer when it is done reading it.- Throws:
java.io.IOException
-
constructOutputStream
public abstract java.io.OutputStream constructOutputStream() throws java.io.IOException
This method creates anOutputStream
via which underlying output target can be written to. Note that caller is responsible for closing that OutputStream when it is done reading it- Throws:
java.io.IOException
-
-