org.knime.core.data.xml
Class XMLCellFactory

java.lang.Object
  org.knime.core.data.xml.XMLCellFactory

public class XMLCellFactory
extends Object

Cell factory that creates XML cells. Depending on the size either normal DataCells or BlobDataCells are created.

Author:

Heiko Hofer

Field Summary

static int	DEF_MIN_BLOB_SIZE_IN_BYTES Minimum size for blobs in bytes.
static DataType	TYPE Type for XML cells.

Method Summary

static DataCell	create(Document dom) Factory method to create DataCell representing Document.
static DataCell	create(InputStream is) Factory method to create DataCell representing Document.
static DataCell	create(String xml) Factory method to create DataCell representing Document.
static DataCell	create(XMLValue xml) Factory method to create DataCell representing Document.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEF_MIN_BLOB_SIZE_IN_BYTES

public static final int DEF_MIN_BLOB_SIZE_IN_BYTES

Minimum size for blobs in bytes. That is, if a given string is at least as large as this value, it will be represented by a blob cell

See Also:

Constant Field Values

TYPE

public static final DataType TYPE

Type for XML cells.

Method Detail

create

public static DataCell create(String xml)
                       throws IOException,
                              ParserConfigurationException,
                              SAXException,
                              XMLStreamException

Factory method to create DataCell representing Document. The returned cell is either of type XMLCell (for small documents) or XMLBlobCell (otherwise, default threshold is 8192 bytes or larger).

Parameters:

xml - String representing the XML document

Returns:

DataCell representing the XML document

Throws:

IOException - if an io error occurs while reading the XML string

SAXException - if an error occurs while parsing

ParserConfigurationException - if the parser cannot be instantiated

XMLStreamException

NullPointerException - if argument is null

create

public static DataCell create(Document dom)

Factory method to create DataCell representing Document. The returned cell is either of type XMLCell (for small documents) or XMLBlobCell (otherwise, default threshold is 8192 bytes or larger).

Parameters:

dom - the returned data cell encapsulates this DOM

Returns:

DataCell representing the XML document

Throws:

NullPointerException - if argument is null

create

public static DataCell create(InputStream is)
                       throws IOException,
                              ParserConfigurationException,
                              SAXException,
                              XMLStreamException

Factory method to create DataCell representing Document. The returned cell is either of type XMLCell (for small documents) or XMLBlobCell (otherwise, default threshold is 8192 bytes or larger).

Parameters:

is - The stream containing the XML document

Returns:

DataCell representing the XML document

Throws:

IOException - if an io error occurs while reading the XML string

SAXException - if an error occurs while parsing

ParserConfigurationException - if the parser cannot be instantiated

XMLStreamException

NullPointerException - if argument is null

create

public static DataCell create(XMLValue xml)

Factory method to create DataCell representing Document. The returned cell is either of type XMLCell (for small documents) or XMLBlobCell (otherwise, default threshold is 8192 bytes or larger).

Parameters:

xml - The cell represents this value.

Returns:

DataCell representing the XML document

Throws:

NullPointerException - if argument is null