public class XmlInputStream
extends java.lang.Object
XmlManager.createLocalFileInputStream(java.lang.String)
,XmlManager.createStdInInputStream()
,XmlManager.createURLInputStream(java.lang.String, java.lang.String, java.lang.String)
,XmlManager.createInputStream(java.io.InputStream)
, orXmlDocument.getContentAsXmlInputStream()
.XmlContainer.putDocument(com.sleepycat.dbxml.XmlDocument)
and
XmlDocument.setContentAsXmlInputStream(com.sleepycat.dbxml.XmlInputStream)
.
You can manually retrieve the contents of the input stream using
readBytes(byte[], long)
and curPos()
.
XmlInputStream is a pure virtual interface. It can be subclassed
by an application, and an instance passed to any of the methods
that take XmlInputStream as a parameter, such as XmlContainer.putDocument(com.sleepycat.dbxml.XmlDocument)
.
This is especially useful for streaming XML from an application directly
into Berkeley DB XML without first converting it to a string.
Constructor and Description |
---|
XmlInputStream() |
Modifier and Type | Method and Description |
---|---|
long |
curPos()
Returns the number of bytes currently read from the beginning of the
input stream.
|
void |
delete()
Free the native resources associated with this object.
|
long |
readBytes(byte[] toFill,
long maxToRead)
Reads
maxToRead number of bytes from the input stream and
places those bytes in toFill . |
public void delete()
public long curPos() throws XmlException
XmlException
public long readBytes(byte[] toFill, long maxToRead) throws XmlException
maxToRead
number of bytes from the input stream and
places those bytes in toFill
. Returns the number of bytes read,
or 0 if the end of the stream has been reached.toFill
- A buffer used to place the bytes read from the
input stream. It is the responsibility of the programmer to ensure that
the buffer provided here is large enough for the amount of data to be
read.maxToRead
- Identifies the maximum number of bytes to read from the input stream.XmlException
Copyright (c) 2004,2014 Oracle. All rights reserved.