How to Enable File Browsing for a Custom Protocol Handler

To allow users to insert images more easily, the Oxygen XML WebApp Component provides a file browsing JavaScript widget that can be used for any custom protocol plugin. To enable this widget, follow these steps:

1. Develop a plugin that implements the ro.sync.exml.plugin.urlstreamhandler.URLStreamHandlerPluginExtension interface. The getURLStreamHandler method should return an instance of java.net.URLStreamHandler (for example, myHandler).
2. myHandler.openConnection()should open an instance of the ro.sync.net.protocol.FileBrowsingConnection interface.
3. On the client-side, register the sync.api.FileBrowsingDialog widget as a UrlChooser using the following code snippet:

   workspace.setUrlChooser(new sync.api.FileBrowsingDialog());