ws-woden-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Peter Danielsen (JIRA)" <>
Subject [jira] Created: (WODEN-163) Provide a mechanism for registering extensions and their error message formats independently of the API.
Date Thu, 10 May 2007 12:58:15 GMT
Provide a mechanism for registering extensions and their error message formats independently
of the API.

                 Key: WODEN-163
             Project: Woden
          Issue Type: Improvement
          Components: Parser
            Reporter: Peter Danielsen

Woden currently provides a means of registering extensions through methods of the ExtensionRegistry.
 An ExtensionRegistry is a member of a WSDLReader produced by a WSDLFactory.  The current
means of registering error message formats is to add them to the core Woden resource bundle

As Woden is currently used in Axis2 codegen, it is not possible to access the WSDLReader and
its ExtensionRegistry to register extensions before parsing begins. The way around this is
to subclass WSDLFactory, register the extensions in the subclass, and set the "org.apache.woden.WSDLFactory"
property to tell Woden to use the subclass.  This works, but if multiple sets of independently-developed
extensions (not part of the Woden distribution) need to be registered, a user will need to
create a "composite" subclass that will register their extensions and those developed by others.

Woden needs a mechanism to allow the modularization of the registration of extensions and
their error message formats.  It should allow the registration of multiple sets of independently-developed
extensions without requiring users to write code to perform the registration.

One Proposal

There are likely to be several implementation alternatives.  Here's one.

Create a new interface, org.apache.woden.wsdl20.extensions.ExtensionRegistrar,  with a single
   void registerExtensions(ExtensionRegistry registry)
Each set of extensions provides a class that implements this interface.  The implementation
registers all extensions belonging to its set.  A new property, org.apache.woden.extensionregistrars,
contains a list of ExtensionRegistrar classes whose "registerExtensions" methods are called
by org.apache.woden.WSDLFactory's constructor after the standard PopulatedExtensionRegistry
has been created.  Using the property achieves the effect of the composite sub-class without
having to write it.

A simple means of registering error message formats would be to modify org.apache.woden.internal.MessageFormatter
to allow the registration of additional resource bundles. MessageFormatter's "formatMessage"
method would look for the format key in each of the registered bundles.  An ExtensionRegistrar
would be responsible for registering the resource bundle for its extension set.

The net result of this implementation proposal is that a set of extensions could be packaged
in a jar file containing:
- the extension set's classes
- the extension set's error message format resource bundle.
- the ExtensionRegistrar implementation

This message is automatically generated by JIRA.
You can reply to this email to add a comment to the issue online.

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message