INTEGRATION: CWS lo8 (1.1.2); FILE ADDED

2005/06/08 16:27:16 lo 1.1.2.1: restructuring of project and fix for #i44847#

2 files changed, 729 insertions, 0 deletions

diff --git a/xmerge/source/aportisdoc/java/org/openoffice/xmerge/converter/xml/sxw/aportisdoc/DocumentSerializerImpl.java b/xmerge/source/aportisdoc/java/org/openoffice/xmerge/converter/xml/sxw/aportisdoc/DocumentSerializerImpl.java
new file mode 100644
index 000000000000..dc629c1a85b0
--- /dev/null
+++ b/xmerge/source/aportisdoc/java/org/openoffice/xmerge/converter/xml/sxw/aportisdoc/DocumentSerializerImpl.java
@@ -0,0 +1,560 @@
+/************************************************************************
+ *
+ *  The Contents of this file are made available subject to the terms of
+ *  either of the following licenses
+ *
+ *         - GNU Lesser General Public License Version 2.1
+ *         - Sun Industry Standards Source License Version 1.1
+ *
+ *  Sun Microsystems Inc., October, 2000
+ *
+ *  GNU Lesser General Public License Version 2.1
+ *  =============================================
+ *  Copyright 2000 by Sun Microsystems, Inc.
+ *  901 San Antonio Road, Palo Alto, CA 94303, USA
+ *
+ *  This library is free software; you can redistribute it and/or
+ *  modify it under the terms of the GNU Lesser General Public
+ *  License version 2.1, as published by the Free Software Foundation.
+ *
+ *  This library is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ *  Lesser General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Lesser General Public
+ *  License along with this library; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston,
+ *  MA  02111-1307  USA
+ *
+ *
+ *  Sun Industry Standards Source License Version 1.1
+ *  =================================================
+ *  The contents of this file are subject to the Sun Industry Standards
+ *  Source License Version 1.1 (the "License"); You may not use this file
+ *  except in compliance with the License. You may obtain a copy of the
+ *  License at http://www.openoffice.org/license.html.
+ *
+ *  Software provided under this License is provided on an "AS IS" basis,
+ *  WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
+ *  WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
+ *  MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
+ *  See the License for the specific provisions governing your rights and
+ *  obligations concerning the Software.
+ *
+ *  The Initial Developer of the Original Code is: Sun Microsystems, Inc.
+ *
+ *  Copyright: 2000 by Sun Microsystems, Inc.
+ *
+ *  All Rights Reserved.
+ *
+ *  Contributor(s): _______________________________________
+ *
+ *
+ ************************************************************************/
+
+package org.openoffice.xmerge.converter.xml.sxw.aportisdoc;
+
+import org.w3c.dom.NodeList;
+import org.w3c.dom.Node;
+import org.w3c.dom.NamedNodeMap;
+import org.w3c.dom.Element;
+
+import java.io.IOException;
+
+import org.openoffice.xmerge.Document;
+import org.openoffice.xmerge.ConvertData;
+import org.openoffice.xmerge.ConvertException;
+import org.openoffice.xmerge.DocumentSerializer;
+import org.openoffice.xmerge.converter.xml.OfficeConstants;
+import org.openoffice.xmerge.converter.xml.sxw.SxwDocument;
+import org.openoffice.xmerge.converter.palm.PdbEncoder;
+import org.openoffice.xmerge.converter.palm.PdbDecoder;
+import org.openoffice.xmerge.converter.palm.PalmDB;
+import org.openoffice.xmerge.converter.palm.Record;
+import org.openoffice.xmerge.converter.palm.PalmDocument;
+import org.openoffice.xmerge.util.Debug;
+import org.openoffice.xmerge.util.XmlUtil;
+
+/**
+ *  <p>AportisDoc implementation of
+ *  org.openoffice.xmerge.DocumentSerializer
+ *  for the {@link
+ *  org.openoffice.xmerge.converter.xml.sxw.aportisdoc.PluginFactoryImpl
+ *  PluginFactoryImpl}.</p>
+ *
+ *  <p>The <code>serialize</code> method traverses the DOM
+ *  document from the given <code>Document</code> object.  It uses a
+ *  <code>DocEncoder</code> object for the actual conversion of
+ *  contents to the AportisDoc format.</p>
+ *
+ *  @author      Herbie Ong
+ */
+
+
+public final class DocumentSerializerImpl
+    implements OfficeConstants, DocConstants, DocumentSerializer {
+
+    /** A <code>DocEncoder</code> object for encoding to AportisDoc. */
+    private DocEncoder encoder = null;
+
+    /** SXW <code>Document</code> object that this converter processes. */
+    private SxwDocument sxwDoc = null;
+
+
+    /**
+     *  Constructor.
+     *
+     *  @param  doc  A SXW <code>Document</code> to be converted.
+     */
+    public DocumentSerializerImpl(Document doc) {
+        sxwDoc = (SxwDocument) doc;
+    }
+
+
+    /**
+     *  <p>Method to convert a <code>Document</code> into a PDB.
+     *  It passes back the converted data as a <code>ConvertData</code>
+     *  object.</p>
+     *
+     *  <p>This method is not thread safe for performance reasons.
+     *  This method should not be called from within two threads.
+     *  It would be best to call this method only once per object
+     *  instance.</p>
+     *
+     *  @return  The <code>ConvertData</code> object containing the output.
+     *
+     *  @throws  ConvertException  If any conversion error occurs.
+     *  @throws  IOException       If any I/O error occurs.
+     */
+    public ConvertData serialize() throws ConvertException, IOException {
+
+
+        // get the server document name
+
+        String docName = sxwDoc.getName();
+
+        // get DOM document
+
+        org.w3c.dom.Document domDoc = sxwDoc.getContentDOM();
+
+        encoder = new DocEncoder();
+
+        // Traverse to the office:body element.
+        // There should only be one.
+
+        NodeList list = domDoc.getElementsByTagName(TAG_OFFICE_BODY);
+        int len = list.getLength();
+
+        if (len > 0) {
+            Node node = list.item(0);
+            traverseBody(node);
+        }
+
+        // create a ConvertData object.
+        //
+        Record records[] = encoder.getRecords();
+        ConvertData cd = new ConvertData();
+
+        PalmDocument palmDoc = new PalmDocument(docName,
+            DocConstants.CREATOR_ID, DocConstants.TYPE_ID,
+            0, PalmDB.PDB_HEADER_ATTR_BACKUP, records);
+
+        cd.addDocument(palmDoc);
+        return cd;
+    }
+
+
+    /**
+     *  This method traverses <i>office:body</i> element.
+     *
+     *  @param  node  <i>office:body</i> <code>Node</code>.
+     *
+     *  @throws  IOException  If any I/O error occurs.
+     */
+    private void traverseBody(Node node) throws IOException {
+
+        log("<?xml version=\"1.0\" encoding=\"UTF-8\"?>");
+        log("<AportisDOC>");
+
+        if (node.hasChildNodes()) {
+
+            NodeList nodeList = node.getChildNodes();
+            int len = nodeList.getLength();
+
+            for (int i = 0; i < len; i++) {
+                Node child = nodeList.item(i);
+
+                if (child.getNodeType() == Node.ELEMENT_NODE) {
+                    String nodeName = child.getNodeName();
+
+                    if (nodeName.equals(TAG_PARAGRAPH) ||
+                        nodeName.equals(TAG_HEADING)) {
+
+                        traverseParagraph(child);
+
+                    } else if (nodeName.equals(TAG_UNORDERED_LIST)) {
+
+                        traverseList(child);
+
+                    } else if (nodeName.equals(TAG_ORDERED_LIST)) {
+
+                        traverseList(child);
+
+                    } else {
+
+                        log("<OTHERS " + XmlUtil.getNodeInfo(child) + " />");
+                    }
+                }
+            }
+        }
+
+        log("</AportisDOC>");
+    }
+
+
+    /**
+     *  This method traverses the <i>text:p</i> and <i>text:h</i>
+     *  element <code>Node</code> objects.
+     *
+     *  @param  node  A <i>text:p</i> or <i>text:h</i>
+     *                <code>Node</code>.
+     *
+     *  @throws  IOException  If any I/O error occurs.
+     */
+    private void traverseParagraph(Node node) throws IOException {
+
+        log("<PARA>");
+        traverseParaContents(node);
+        encoder.addText(EOL_CHAR);
+        log("</PARA>");
+    }
+
+
+    /**
+     *  This method traverses a paragraph content.
+     *  It uses the <code>traverseParaElem</code> method to
+     *  traverse into Element <code>Node</code> objects.
+     *
+     *  @param  node  A paragraph or content <code>Node</code>.
+     *
+     *  @throws  IOException  If any I/O error occurs.
+     */
+    private void traverseParaContents(Node node) throws IOException {
+
+        if (node.hasChildNodes()) {
+
+            NodeList nodeList = node.getChildNodes();
+            int len = nodeList.getLength();
+
+            for (int i = 0; i < len; i++) {
+
+                Node child = nodeList.item(i);
+                short nodeType = child.getNodeType();
+
+                switch (nodeType) {
+
+                    case Node.TEXT_NODE:
+                        // this is for grabbing text nodes.
+                        String s = child.getNodeValue();
+
+                        if (s.length() > 0) {
+                            encoder.addText(s);
+                        }
+
+                        log("<TEXT>");
+                        log(s);
+                        log("</TEXT>");
+
+                        break;
+
+                    case Node.ELEMENT_NODE:
+
+                        traverseParaElem(child);
+                        break;
+
+                    case Node.ENTITY_REFERENCE_NODE:
+
+                        log("<ENTITY_REFERENCE>");
+                        traverseParaContents(child);
+                        log("<ENTITY_REFERENCE/>");
+                        break;
+
+                    default:
+                        log("<OTHERS " + XmlUtil.getNodeInfo(node) + " />");
+                }
+            }
+        }
+    }
+
+
+    /**
+     *  This method traverses an <code>Element</code> <code>Node</code>
+     *  within a paragraph.
+     *
+     *  @param  node  <code>Element</code> <code>Node</code> within a
+     *                paragraph.
+     *
+     *  @throws  IOException  If any I/O error occurs.
+     */
+    private void traverseParaElem(Node node) throws IOException {
+
+        String nodeName = node.getNodeName();
+
+        if (nodeName.equals(TAG_SPACE)) {
+
+            // this is for text:s tags.
+            NamedNodeMap map = node.getAttributes();
+            Node attr = map.getNamedItem(ATTRIBUTE_SPACE_COUNT);
+            StringBuffer space = new StringBuffer(SPACE_CHAR);
+            int count = 1;
+
+            if (attr != null) {
+
+                try {
+
+                    String countStr = attr.getNodeValue();
+                    count = Integer.parseInt(countStr.trim());
+
+                } catch (NumberFormatException e) {
+
+                    // TODO: for now, throw IOException.
+                    // later, perhaps will have to throw
+                    // some other conversion exception instead.
+                    throw new IOException(e.getMessage());
+                }
+            }
+
+            for (int j = 0; j < count; j++) {
+
+                space.append(SPACE_CHAR);
+            }
+
+            encoder.addText(space.toString());
+
+            log("<SPACE count=\"" + count + "\" />");
+
+        } else if (nodeName.equals(TAG_TAB_STOP)) {
+
+            // this is for text:tab-stop
+            encoder.addText(TAB_CHAR);
+
+            log("<TAB/>");
+
+        } else if (nodeName.equals(TAG_LINE_BREAK)) {
+
+            // commented out by Csaba: There is no point to convert a linebreak
+            // into a EOL, because it messes up the number of XML nodes and the
+            // merge won't work properly. Other solution would be to implement such
+            // nodemerger, which would be able to merge embedded tags in a paragraph
+
+            // this is for text:line-break
+            // encoder.addText(EOL_CHAR);
+
+            log("skipped <LINE-BREAK/>");
+
+        } else if (nodeName.equals(TAG_SPAN)) {
+
+            // this is for text:span
+            log("<SPAN>");
+            traverseParaContents(node);
+            log("</SPAN>");
+
+        } else if (nodeName.equals(TAG_HYPERLINK)) {
+
+            // this is for text:a
+            log("<HYPERLINK>");
+            traverseParaContents(node);
+            log("<HYPERLINK/>");
+
+        } else if (nodeName.equals(TAG_BOOKMARK) ||
+                   nodeName.equals(TAG_BOOKMARK_START)) {
+
+            log("<BOOKMARK/>");
+
+        } else if (nodeName.equals(TAG_TEXT_VARIABLE_SET)
+                   || nodeName.equals(TAG_TEXT_VARIABLE_GET)
+                   || nodeName.equals(TAG_TEXT_EXPRESSION)
+                   || nodeName.equals(TAG_TEXT_USER_FIELD_GET)
+                   || nodeName.equals(TAG_TEXT_PAGE_VARIABLE_GET)
+                   || nodeName.equals(TAG_TEXT_SEQUENCE)
+                   || nodeName.equals( TAG_TEXT_VARIABLE_INPUT)
+                   || nodeName.equals(TAG_TEXT_TIME)
+                   || nodeName.equals( TAG_TEXT_PAGE_COUNT)
+                   || nodeName.equals(TAG_TEXT_PAGE_NUMBER )
+                   || nodeName.equals(TAG_TEXT_SUBJECT)
+                   || nodeName.equals(TAG_TEXT_TITLE)
+                   || nodeName.equals(TAG_TEXT_CREATION_TIME)
+                   || nodeName.equals(TAG_TEXT_DATE)
+                   || nodeName.equals(TAG_TEXT_TEXT_INPUT)
+                   || nodeName.equals(TAG_TEXT_AUTHOR_INITIALS)) {
+            log("<FIELD>");
+            traverseParaContents(node);
+            log("</FIELD>");
+
+        }else if (nodeName.startsWith(TAG_TEXT)) {
+            log("<Unknown text Field>");
+            traverseParaContents(node);
+            log("</Unknown text Field>");
+
+        }else {
+
+            log("<OTHERS " + XmlUtil.getNodeInfo(node) + " />");
+        }
+    }
+
+
+    /**
+     *  This method traverses list tags <i>text:unordered-list</i> and
+     *  <i>text:ordered-list</i>.  A list can only contain one optional
+     *  <i>text:list-header</i> and one or more <i>text:list-item</i>
+     *  elements.
+     *
+     *  @param  node  A list <code>Node</code>.
+     *
+     *  @throws  IOException  If any I/O error occurs.
+     */
+    private void traverseList(Node node) throws IOException {
+
+        log("<LIST>");
+
+        if (node.hasChildNodes()) {
+
+            NodeList nodeList = node.getChildNodes();
+            int len = nodeList.getLength();
+
+            for (int i = 0; i < len; i++) {
+
+                Node child = nodeList.item(i);
+
+                if (child.getNodeType() == Node.ELEMENT_NODE) {
+
+                    String nodeName = child.getNodeName();
+
+                    if (nodeName.equals(TAG_LIST_ITEM)) {
+
+                        traverseListItem(child);
+
+                    } else if (nodeName.equals(TAG_LIST_HEADER)) {
+
+                        traverseListHeader(child);
+
+                    } else {
+
+                        log("<INVALID-XML-BUG " + XmlUtil.getNodeInfo(child) + " />");
+                    }
+                }
+            }
+        }
+
+        log("</LIST>");
+    }
+
+
+    /**
+     *  This method traverses a <i>text:list-header</i> element.
+     *  It contains one or more <i>text:p</i> elements.
+     *
+     *  @param  node  A list header <code>Node</code>.
+     *
+     *  @throws  IOException  If any I/O error occurs.
+     */
+    private void traverseListHeader(Node node) throws IOException {
+
+        log("<LIST-HEADER>");
+
+        if (node.hasChildNodes()) {
+
+            NodeList nodeList = node.getChildNodes();
+            int len = nodeList.getLength();
+
+            for (int i = 0; i < len; i++) {
+
+                Node child = nodeList.item(i);
+
+                if (child.getNodeType() == Node.ELEMENT_NODE) {
+
+                    String nodeName = child.getNodeName();
+
+                    if (nodeName.equals(TAG_PARAGRAPH)) {
+
+                        traverseParagraph(child);
+
+                    } else {
+
+                        log("<INVALID-XML-BUG " + XmlUtil.getNodeInfo(child) + " />");
+                    }
+                }
+            }
+        }
+
+        log("</LIST-HEADER>");
+    }
+
+
+    /**
+     *  <p>This method will traverse a <i>text:list-item</i>.
+     *  A list item may contain one or more of <i>text:p</i>,
+     *  <i>text:h</i>, <i>text:section</i>, <i>text:ordered-list</i>
+     *  and <i>text:unordered-list</i>.</p>
+     *
+     *  <p>This method currently only implements grabbing <i>text:p</i>,
+     *  <i>text:h</i>, <i>text:unordered-list</i> and
+     *  <i>text:ordered-list</i>.</p>
+     *
+     *  @param  node  The <code>Node</code>.
+     *
+     *  @throws  IOException  If any I/O error occurs.
+     */
+    private void traverseListItem(Node node) throws IOException {
+
+        log("<LIST-ITEM>");
+
+        if (node.hasChildNodes()) {
+
+            NodeList nodeList = node.getChildNodes();
+            int len = nodeList.getLength();
+
+            for (int i = 0; i < len; i++) {
+
+                Node child = nodeList.item(i);
+
+                if (child.getNodeType() == Node.ELEMENT_NODE) {
+
+                    String nodeName = child.getNodeName();
+
+                    if (nodeName.equals(TAG_PARAGRAPH)) {
+
+                        traverseParagraph(child);
+
+                    } else if (nodeName.equals(TAG_UNORDERED_LIST)) {
+
+                        traverseList(child);
+
+                    } else if (nodeName.equals(TAG_ORDERED_LIST)) {
+
+                        traverseList(child);
+
+                    } else {
+
+                        log("<INVALID-XML-BUG " + XmlUtil.getNodeInfo(child) + " />");
+                    }
+                }
+            }
+        }
+
+        log("</LIST-ITEM>");
+    }
+
+
+    /**
+     *  Logs debug messages.
+     *
+     *  @param  str  The debug message.
+     */
+    private void log(String str) {
+
+        Debug.log(Debug.TRACE, str);
+    }
+}
+
diff --git a/xmerge/source/aportisdoc/java/org/openoffice/xmerge/converter/xml/sxw/aportisdoc/PluginFactoryImpl.java b/xmerge/source/aportisdoc/java/org/openoffice/xmerge/converter/xml/sxw/aportisdoc/PluginFactoryImpl.java
new file mode 100644
index 000000000000..6dfb7941f5d4
--- /dev/null
+++ b/xmerge/source/aportisdoc/java/org/openoffice/xmerge/converter/xml/sxw/aportisdoc/PluginFactoryImpl.java
@@ -0,0 +1,169 @@
+/************************************************************************
+ *
+ *  The Contents of this file are made available subject to the terms of
+ *  either of the following licenses
+ *
+ *         - GNU Lesser General Public License Version 2.1
+ *         - Sun Industry Standards Source License Version 1.1
+ *
+ *  Sun Microsystems Inc., October, 2000
+ *
+ *  GNU Lesser General Public License Version 2.1
+ *  =============================================
+ *  Copyright 2000 by Sun Microsystems, Inc.
+ *  901 San Antonio Road, Palo Alto, CA 94303, USA
+ *
+ *  This library is free software; you can redistribute it and/or
+ *  modify it under the terms of the GNU Lesser General Public
+ *  License version 2.1, as published by the Free Software Foundation.
+ *
+ *  This library is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ *  Lesser General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Lesser General Public
+ *  License along with this library; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston,
+ *  MA  02111-1307  USA
+ *
+ *
+ *  Sun Industry Standards Source License Version 1.1
+ *  =================================================
+ *  The contents of this file are subject to the Sun Industry Standards
+ *  Source License Version 1.1 (the "License"); You may not use this file
+ *  except in compliance with the License. You may obtain a copy of the
+ *  License at http://www.openoffice.org/license.html.
+ *
+ *  Software provided under this License is provided on an "AS IS" basis,
+ *  WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
+ *  WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
+ *  MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
+ *  See the License for the specific provisions governing your rights and
+ *  obligations concerning the Software.
+ *
+ *  The Initial Developer of the Original Code is: Sun Microsystems, Inc.
+ *
+ *  Copyright: 2000 by Sun Microsystems, Inc.
+ *
+ *  All Rights Reserved.
+ *
+ *  Contributor(s): _______________________________________
+ *
+ *
+ ************************************************************************/
+
+package org.openoffice.xmerge.converter.xml.sxw.aportisdoc;
+
+import org.openoffice.xmerge.Document;
+import org.openoffice.xmerge.ConvertData;
+import org.openoffice.xmerge.DocumentMerger;
+import org.openoffice.xmerge.DocumentMergerFactory;
+import org.openoffice.xmerge.DocumentSerializer;
+import org.openoffice.xmerge.DocumentSerializerFactory;
+import org.openoffice.xmerge.DocumentDeserializer;
+import org.openoffice.xmerge.DocumentDeserializerFactory;
+import org.openoffice.xmerge.ConverterCapabilities;
+import org.openoffice.xmerge.converter.xml.sxw.SxwPluginFactory;
+import org.openoffice.xmerge.converter.palm.PalmDocument;
+import org.openoffice.xmerge.util.registry.ConverterInfo;
+import java.io.IOException;
+import java.io.InputStream;
+
+/**
+ *  <p>AportisDoc implementation of the <code>PluginFactory</code>.
+ *  This encapsulates conversion of StarWriter XML format to and from
+ *  AportisDoc format.</p>
+ *
+ *  <p>The superclass produces a particular
+ *  {@link org.openoffice.xmerge.Document Document}
+ *  object, i.e. {@link
+ *  org.openoffice.xmerge.converter.xml.sxw.SxwDocument
+ *  SxwDocument} that the converters in this class works with.  Thus,
+ *  this class only implements the methods that produces the converters,
+ *  i.e. {@link
+ *  org.openoffice.xmerge.DocumentSerializer
+ *  DocumentSerializer} and {@link
+ *  org.openoffice.xmerge.DocumentDeserializer
+ *  DocumentDeserializer};
+ *  as well as the {@link
+ *  org.openoffice.xmerge.ConverterCapabilities
+ *  ConverterCapabilities} object that is specific to this format
+ *  conversion.  That superclass also  produces a {@link
+ *  org.openoffice.xmerge.DocumentMerger DocumentMerger}
+ *  object, i.e. {@link
+ *  org.openoffice.xmerge.converter.xml.sxw.aportisdoc.DocumentMergerImpl
+ *  DocumentMergerImpl} which this class derives the functionality.</p>
+ *
+ *  @author   Herbie Ong
+ */
+public final class PluginFactoryImpl extends SxwPluginFactory
+    implements DocumentDeserializerFactory, DocumentSerializerFactory,
+    DocumentMergerFactory {
+
+    public PluginFactoryImpl (ConverterInfo ci) {
+        super(ci);
+    }
+
+    /** ConverterCapabilities object for this type of conversion. */
+    private final static ConverterCapabilities converterCap =
+        new ConverterCapabilitiesImpl();
+
+
+    /**
+     *  Returns an instance of <code>DocumentSerializerImpl</code>,
+     *  which is an implementation of the <code>DocumentSerializer</code>
+     *  interface.
+     *
+     *  @param  doc  <code>Document</code> object to be
+     *               converted/serialized.
+     *
+     *  @return  A <code>DocumentSerializerImpl</code> object.
+     */
+    public DocumentSerializer createDocumentSerializer(Document doc) {
+
+        return new DocumentSerializerImpl(doc);
+    }
+
+
+    /**
+     *  Returns an instance of <code>DocumentDeserializerImpl</code>,
+     *  which is an implementation of the <code>DocumentDeserializer</code>
+     *  interface.
+     *
+     *  @param  cd   <code>ConvertData</code> object for reading data
+     *               which will be converted back to a
+     *               <code>Document</code> object.
+     *
+     *  @return  A DocumentDeserializerImpl object.
+     */
+    public DocumentDeserializer createDocumentDeserializer(ConvertData cd) {
+
+        return new DocumentDeserializerImpl(cd);
+    }
+
+
+    /**
+     *  Returns an instance of <code>DocumentMergerImpl</code>,
+     *  which is an implementation of the <code>DocumentMerger</code>
+     *  interface.
+     *
+     *  @param  doc  <code>Document</code> to merge.
+     *
+     *  @return  A DocumentMergerImpl object.
+     */
+    public DocumentMerger createDocumentMerger(Document doc) {
+
+        ConverterCapabilities cc = converterCap;
+        DocumentMergerImpl merger = new DocumentMergerImpl(doc, cc);
+        return merger;
+    }
+
+    public Document createDeviceDocument(String name, InputStream is)
+    throws IOException {
+
+        PalmDocument palmDoc = new PalmDocument(is);
+        return palmDoc;
+    }
+}
+