|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.verisign.epp.util.EPPXMLStream
public class EPPXMLStream
EPPXMLStream
is a utility class for reading and writing EPP
messages to/from streams. DOM Document are read and written to the streams.
An XML parser is required when reading from the stream. There is one
constructor that will create an XML parser per call to
read(InputStream)
and one that will use a parser pool. Use of a
parser pool is recommended.
Field Summary | |
---|---|
static int |
DEFAULT_MAX_PACKET_SIZE
Default Maximum packet size of bytes accepted to ensure that the client is not overrun with an invalid packet or a packet that exceeds the maximum size. |
Constructor Summary | |
---|---|
EPPXMLStream()
Default constructor for EPPXMLStream . |
|
EPPXMLStream(java.lang.String aParserPoolName)
Construct EPPXMLStream to use a parser pool and a default
transformer pool. |
|
EPPXMLStream(java.lang.String aParserPoolName,
java.lang.String aTransformerPoolName)
Construct EPPXMLStream to use a parser pool and a
transformer pool. |
Method Summary | |
---|---|
org.w3c.dom.Document |
read(java.io.InputStream aStream)
Reads an EPP packet from the aStream parameter,
parses/validates it, and returns the associated DOM Document. |
void |
write(org.w3c.dom.Document aDoc,
java.io.OutputStream aOutput)
Writes a DOM Document to the output stream. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final int DEFAULT_MAX_PACKET_SIZE
Constructor Detail |
---|
public EPPXMLStream()
EPPXMLStream
. When using this
constructor, a parser instance will be created on each call to
read(InputStream)
and a transformer instance will be created
on each call to write(Document,OutputStream)
. .
public EPPXMLStream(java.lang.String aParserPoolName)
EPPXMLStream
to use a parser pool and a default
transformer pool. The aParserPoolName
parameter has to be a
pool of EPPParserPool
subclasses. When using this
constructor, a parser instance will be checked out and checkin as needed
on each call to read(InputStream)
. The
Transformer
pool used is defined by the
EPPTransformer.POOL
constant.
aParserPoolName
- Parser pool name to usepublic EPPXMLStream(java.lang.String aParserPoolName, java.lang.String aTransformerPoolName)
EPPXMLStream
to use a parser pool and a
transformer pool. The aParserPoolName
parameter has to be a
pool of EPPParserPool
subclasses. When using this
constructor, a parser instance will be checked out and checkin as needed
on each call to read(InputStream)
. The
Transformer
pool used is defined by the
EPPTransformer.POOL
constant. The
aTransformerPoolName
parameters is the name of pool
containing Transformer
instances.
aParserPoolName
- Parser pool name to useaTransformerPoolName
- Transformer pool name to useMethod Detail |
---|
public org.w3c.dom.Document read(java.io.InputStream aStream) throws EPPAssemblerException, EPPException, java.io.IOException
aStream
parameter,
parses/validates it, and returns the associated DOM Document. The XML
parser is either created per call, or is retrieved from a parser pool
when EPPXMLStream(GenericPoolManager)
is used. Use of a
parser pool is recommended.
aStream
- Input stream to read for an EPP packet.
EPPException
- Error with received packet or end of stream. It is
recommended that the stream be closed.
EPPAssemblerException
- Error parsing packet
java.io.IOException
- Error reading packet from streampublic void write(org.w3c.dom.Document aDoc, java.io.OutputStream aOutput) throws EPPException
aDoc
- DOM Document to write to streamaOutput
- Output stream to write to
EPPException
- Error writing to stream. It is recommended that the stream
be closed.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |