Mailing-List: contact commits-help@hivemind.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@hivemind.apache.org
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: Apache Wiki <wikidiffs@apache.org>
To: hivemind-cvs@jakarta.apache.org
Date: Wed, 09 Aug 2006 07:07:52 -0000
Message-ID: <20060809070752.2126.89269@ajax.apache.org>
Subject: [Jakarta-hivemind Wiki] Update of "DescriptorApiRevampProposal" by
 KnutWannheden

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Jakarta-hivemind Wiki" for change notification.

The following page has been changed by KnutWannheden:
http://wiki.apache.org/jakarta-hivemind/DescriptorApiRevampProposal

------------------------------------------------------------------------------
  
  = Proposed Solution =
  
- The approach of the proposed solution is to move to a more abstract '''Descriptor API''' and factor the XML specifics into an XML implementation (based on this API).  Apart from the XML shorthand notations reflected in the current API it is primarily the ''schema processing'' which I consider as XML specific.  Factoring that out will in turn also affect parts of the '''Runtime API''' and implementation.
+ The approach of the proposed solution is to move to a more abstract '''Descriptor API''' and factor the XML specifics into an XML implementation (based on this API).  IMO the following features are XML specific:
+  * shorthand notations (e.g. <invoke-factory> allowed inside <service-point>) reflected in the current API
+  * the ''schema processing'' converting XML elements to POJOs (this also includes ${} symbol resolution)
+  * sub-modules -- these are really just normal modules
+  * conditional contribution expressions
+  * service implementation and interceptor factories
+ 
+ Factoring these out will in turn also affect parts of the '''Runtime API''' and implementation.
  
  == Descriptor API ==
- Here is an overview of the proposed Descriptor API (package {{{org.apache.hivemind.descriptor}}}).
+ Here is an overview of the proposed Descriptor API (package {{{org.apache.hivemind.def}}}).
+ 
+ attachment:module-def.gif
+ 
+ And the corresponding interfaces in Java:
  
  {{{
  public interface ModuleDef
@@ -46, +57 @@

  public interface ExtensionDef
  {
      public ModuleDef getModule();
-     public String getExtensionPointId();
+     public String getExtensionPointMatchPattern();
      public boolean isApplicable(DefContext context);
  }
  }}}
@@ -69, +80 @@

  public interface ImplementationDef extends ExtensionDef
  {
      public String getServiceModel();
+     public int getPriority();
      public ImplementationConstructor getConstructor(DefContext context);
  }
  }}}