/* * 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 DocumentSerializer
represents a converter that
* converts a "Office" Document
to a
* "Device" Document
format.
The DocumentSerializer
object is created by a
* the PluginFactory
{@link
* org.openoffice.xmerge.DocumentSerializerFactory#createDocumentSerializer
* createDocumentSerializer} method. When it is constructed, a
* "Office" Document
object is passed in to
* be used as input.
Convert the data passed into the DocumentSerializer
* constructor into the "Device" 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.
* * @returnConvertData
object to pass back the
* converted data.
*
* @throws ConvertException If any conversion error occurs.
* @throws IOException If any I/O error occurs.
*/
public ConvertData serialize() throws ConvertException, IOException;
}