org.xwiki.officeimporter.builder

Interface XDOMOfficeDocumentBuilder

@Role
public interface XDOMOfficeDocumentBuilder

Component responsible for building XDOMOfficeDocument objects from binary office files or XHTMLOfficeDocument objects.

Since:

2.1M1

Version:

$Id: a0133489a2f2cd2e82ffbe1897e66b55470bbfce $

Method Summary

Modifier and Type	Method and Description
XDOMOfficeDocument	build(InputStream officeFileStream, String officeFileName, org.xwiki.model.reference.DocumentReference reference, boolean filterStyles) Builds a XDOMOfficeDocument corresponding to the given office document.
XDOMOfficeDocument	build(XHTMLOfficeDocument xhtmlOfficeDocument) Builds a XDOMOfficeDocument from the given XHTMLOfficeDocument.

Method Detail

build

XDOMOfficeDocument build(InputStream officeFileStream,
                         String officeFileName,
                         org.xwiki.model.reference.DocumentReference reference,
                         boolean filterStyles)
                  throws OfficeImporterException

Builds a XDOMOfficeDocument corresponding to the given office document.

Parameters:

officeFileStream - InputStream corresponding to the office document

officeFileName - name of the office document (used to determine input document format)

reference - reference document w.r.t which HTML cleaning is performed. If the office file contains images or other binary artifacts, HTML cleaning will be performed assuming that those artifacts are present as attachments to the reference document

filterStyles - whether to filter CSS styles present in the HTML content produced by the office server

Returns:

an XDOMOfficeDocument corresponding to the office document

Throws:

OfficeImporterException - if an error occurs while performing the import operation

Since:

2.2M1

build

XDOMOfficeDocument build(XHTMLOfficeDocument xhtmlOfficeDocument)
                  throws OfficeImporterException

Builds a XDOMOfficeDocument from the given XHTMLOfficeDocument.

Parameters:

xhtmlOfficeDocument - XHTMLOfficeDocument already built using XHTMLOfficeDocumentBuilder

Returns:

an XDOMOfficeDocument corresponding to the given XHTMLOfficeDocument

Throws:

OfficeImporterException - if an error occurs while parsing XHTML into XDOM