/* * This file is part of the LibreOffice project. * * This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. * * This file incorporates work covered by the following license notice: * * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed * with this work for additional information regarding copyright * ownership. The ASF licenses this file to you under the Apache * License, Version 2.0 (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.apache.org/licenses/LICENSE-2.0 . */ package org.openoffice.xmerge; import java.io.IOException; /** *
A DocumentDeserializer
represents a converter that
* converts "Device" Document
objects into the
* "Office" Document
format.
The DocumentDeserializer
object is created by
* the PluginFactory {@link
* org.openoffice.xmerge.DocumentDeserializerFactory#createDocumentDeserializer
* createDocumentDeserializer} method. When it is constructed, a
* ConvertData
object is passed in to be used as input.
Convert the data passed into the DocumentDeserializer
* constructor into the "Office" Document
* format.
This method may or may not be thread-safe. It is expected * that the user code does not call this method in more than one * thread. And for most cases, this method is only done once.
* * @return The resultingDocument
object from conversion.
*
* @throws ConvertException If any Convert error occurs.
* @throws IOException If any I/O error occurs.
*/
public Document deserialize() throws ConvertException, IOException;
}