<pathelement location="../../openide/convertor/netbeans/modules/org-netbeans-modules-convertor.jar"/>

Manifest-Version: 1.0

        <change id="use-convertor">

            <api name="registry"/>

            <summary>Enable use of Convertor SPI</summary>

            <version major="1" minor="1.5"/>

            <date day="26" month="9" year="2003"/>

            <author login="jglick"/>

            <compatibility addition="yes"/>

            <description>

                You may now use the Convertor SPI with the Registry over Filesystems.

                If you have a (layer) folder being used as a context, simply create a

                file <samp>foo.xml</samp> to create an object binding named <samp>foo</samp>.

                It should be a well-formed XML file whose root (document) element is

                namespace-qualified and registered using the Convertor SPI.

            </description>

            <issue number="36297"/>

        </change>

import org.w3c.dom.Document;

import org.w3c.dom.Element;

import org.xml.sax.SAXException;

import org.netbeans.core.registry.ContextImpl;

import org.openide.ErrorManager;

import org.netbeans.api.convertor.ConvertorException;

import org.netbeans.api.convertor.Convertors;

    /**

     * Try to get an object binding from a file.

     * @param ctx the basic context being used

     * @param folder the folder in which to look

     * @param name the file name (like a binding, no ext)

     * @return an object bound to it, or null

     * @throws ContextException if the binding exists but there is a problem loading it

     */

    }

    /**

     * Try to create an instance via the Convertors API.

     * @param _d a data object, which may be an XMLDataObject

     * @return an instance if its root element can be converted, or null if it is not a .xml file, or it has no convertor

     * @throws ContextException if it is a .xml file that cannot be parsed, or the convertor fails

     */

    private static Object instanceCreateViaConvertors(DataObject _d) throws ContextException {

        if (!(_d instanceof XMLDataObject)) {

            return null;

        }

        XMLDataObject d = (XMLDataObject)_d;

        Document doc;

        try {

            doc = d.getDocument();

        } catch (IOException ex) {

            ContextException e = SpiUtils.createContextException(null, null);

            ErrorManager.getDefault().annotate(e, ex);

            throw e;

        } catch (SAXException ex) {

            ContextException e = SpiUtils.createContextException(null, null);

            ErrorManager.getDefault().annotate(e, ex);

            throw e;

        }

        Element el = doc.getDocumentElement();

        assert el.getNodeName() != null;

        if (el.getNamespaceURI() != null && Convertors.canRead(el)) {

            try {

                return Convertors.read(el);

            } catch (ConvertorException ex) {

                ContextException e = SpiUtils.createContextException(null, null);

                ErrorManager.getDefault().annotate(e, ErrorManager.UNKNOWN, "From " + d.getPrimaryFile(), null, ex, null);

                throw e;

            } catch (Exception e) {

                assert false : e + " from " + d.getPrimaryFile();

                return null;

            }

        } else {

            return null;

        }

    }

    /**

     * Make a binding for an object to a file.

     * @param folder the folder to store it in

     * @param name the name of the binding (file basename)

     * @param o a structured object to store

     * @throws IOException if there is a problem storing it

     */

    public static void bindObjectToFile(DataFolder folder, final String name, final Object o) throws IOException {

        if (Convertors.canWrite(o)) {

            // XXX delete other kinds of bindings first? very unlikely to matter...

            final FileObject fileFolder = folder.getPrimaryFile();

            fileFolder.getFileSystem().runAtomicAction(new FileSystem.AtomicAction() {

                public void run() throws IOException {

                    FileObject xml = fileFolder.getFileObject(name, "xml");

                    if (xml == null) {

                        xml = fileFolder.createData(name, "xml");

                    }

                    FileLock l = xml.lock();

                    try {

                        OutputStream os = xml.getOutputStream(l);

                        try {

                            Convertors.write(os, o);

                        } finally {

                            os.close();

                        }

                    } finally {

                        l.releaseLock();

                    }

                }

            });

        } else {

            // Fallback to old-style storage, e.g. .settings with <serialdata>.

            InstanceDataObject.create(folder, name, o, null);

        }