org.docx4j.openpackaging.parts

Class XmlPart

java.lang.Object

org.docx4j.openpackaging.Base

org.docx4j.openpackaging.parts.Part

org.docx4j.openpackaging.parts.XmlPart

Direct Known Subclasses:

ActiveXControlXmlPart, CustomXmlDataStorageImpl, DefaultXmlPart

public abstract class XmlPart
extends Part

OPC Parts are either XML, or binary (or text) documents. Most are XML documents. docx4j aims to represent XML parts using JAXB. However, at present there are some parts for which we don't have JAXB representations. Until such time as a JAXB representation for an XML Part exists, the Part should extend this class.

Field Summary

Fields

Modifier and Type	Field and Description
protected Document	doc This part's XML contents.
protected static org.slf4j.Logger	log

Fields inherited from class org.docx4j.openpackaging.parts.Part

pack

Fields inherited from class org.docx4j.openpackaging.Base

contentType, partName, relationships

Constructor Summary

Constructors

Constructor and Description
XmlPart()
XmlPart(PartName partName)

Method Summary

Modifier and Type	Method and Description
String	cachedXPathGetString(String xpath, String prefixMappings)
void	discardCacheXPathObject()
abstract Document	getDocument()
String	getXML() Get the XML as a String.
boolean	isContentEqual(Part other)
void	setDocument(Document doc)
void	setDocument(InputStream is)
boolean	setNodeValueAtXPath(String xpath, String value, String prefixMappings) Set the value of the node referenced in the xpath expression.
List<Node>	xpathGetNodes(String xpathString, String prefixMappings)
String	xpathGetString(String xpathString, String prefixMappings) Note: If the result is an empty node-set, it will be converted to an empty string, rather than null.

Methods inherited from class org.docx4j.openpackaging.parts.Part

getContentLengthAsLoaded, getOwningRelationshipPart, getPackage, getRelationshipType, getSourceRelationship, getSourceRelationships, getVersion, remove, rename, setContentLengthAsLoaded, setOwningRelationshipPart, setPackage, setPartShortcut, setRelationshipType, setSourceRelationship, setVersion

Methods inherited from class org.docx4j.openpackaging.Base

addTargetPart, addTargetPart, addTargetPart, addTargetPart, getContentType, getPartName, getRelationshipsPart, getRelationshipsPart, getUserData, reset, setContentType, setPartName, setRelationships, setUserData

Methods inherited from class java.lang.Object

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

Field Detail

log

protected static org.slf4j.Logger log

doc

protected Document doc

This part's XML contents. Not guaranteed to be up to date. Whether it is or not will depend on how the class which extends Part chooses to treat it. It may be that the class uses some other internal representation for its data.

Constructor Detail

XmlPart

public XmlPart(PartName partName)
        throws InvalidFormatException

Throws:

InvalidFormatException

XmlPart

public XmlPart()
        throws InvalidFormatException

Throws:

InvalidFormatException

Method Detail

setDocument

public void setDocument(InputStream is)
                 throws Docx4JException

Throws:

Docx4JException

setDocument

public void setDocument(Document doc)

getDocument

public abstract Document getDocument()
                              throws Docx4JException

Throws:

Docx4JException

getXML

public String getXML()
              throws Docx4JException

Get the XML as a String.

Throws:

Docx4JException

Since:

3.0.1

xpathGetString

public String xpathGetString(String xpathString,
                             String prefixMappings)
                      throws Docx4JException

Note: If the result is an empty node-set, it will be converted to an empty string, rather than null.

Parameters:

xpathString -

prefixMappings -

Returns:

Throws:

Docx4JException

cachedXPathGetString

public String cachedXPathGetString(String xpath,
                                   String prefixMappings)
                            throws Docx4JException

Throws:

Docx4JException

discardCacheXPathObject

public void discardCacheXPathObject()

xpathGetNodes

public List<Node> xpathGetNodes(String xpathString,
                                String prefixMappings)

setNodeValueAtXPath

public boolean setNodeValueAtXPath(String xpath,
                                   String value,
                                   String prefixMappings)
                            throws Docx4JException

Set the value of the node referenced in the xpath expression.

Parameters:

xpath -

value -

prefixMappings - a string such as "xmlns:ns0='http://schemas.medchart'"

Returns:

Throws:

Docx4JException

isContentEqual

public boolean isContentEqual(Part other)
                       throws Docx4JException

Specified by:

isContentEqual in class Part

Throws:

Docx4JException