org.openoffice.xmerge.util.registry package

Provides an interface for plug-in registration. Each plug-in must have a corresponding Plugin Configuration XML File which is named converter.xml. If the plug-in is stored in a jarfile, this converter.xml file is typically stored in the following location in the jarfile:

> META-INF/converter.xml

The Plugin Configuration XML File must validate against the converter.dtd file provided with this package. Since a jarfile can contain multiple plug-ins, this DTD supports specifying multiple plug-ins per jarfile. Please refer to the SDK document for more information about how to implement a Plugin Configuration XML File for a specific plugin.

All information in the Plugin Configuratino XML File is bundled into one or more `ConverterInfo` object. The `ConverterInfoReader` object is used to build a `Vector` of `ConverterInfo` objects from a jarfile.

The `ConverterInfoMgr` manages the registry of `ConverterInfo`. It is a singleton class, so that only one registry manager will ever exist. It is the client program's responsibility to register `ConverterInfo` objects that correspond to the plug-ins that are to be used.

## TODO/IDEAS list

1. The `ConverterInfo` object could contain `org.w3c.dom.Document` fragments that are accessed in a generic fashion rather than get/set methods for each item in the DTD. This would provide a more flexible approach, especially for adding custom tags to a specific Plugin Configuration XML file (tags that are only used by its associated plug-in).
2. `ConverterInfo` should allow the merge/serialize/deserialize logic to be included in separate plug-ins, if desired.
3. `ConverterInfoMgr` could use the Java Activation Framework (JAF) to manage registration.