EE Module Names (JBAS-7644)
brian.stansberry Mar 4, 2010 4:50 PMI've been working on https://jira.jboss.org/jira/browse/JBAS-7644 and related work dealing with EE.8.1.1's and EE.8.1.2's requirements for how EE 6 modules should be named.
The gist of the issue is the deployment descriptors for the different EE 6 component types allow configuration of a "module name". EE.8.1.1 and EE.8.1.2 spell out rules for defaults if the module name isn't specified, and add a requirement that during deployment we ensure that the names for all modules w/in an ear are unique.
The approach I'm taking to this is:
- Create a new interface in jboss-metadata-common: org.jboss.metadata.javaee.jboss.NamedModule. This basically includes a getter and setter for String property "moduleName".
- The various jboss-specific metadata classes for the EE 6 component types will implement NamedModule:
- JBossMetaData
- JBossWebMetaData
- JBossClientMetaData
- some JCA-related metadata class; need to touch base with Jesper on which.
- logically this could be expanded to metadata types for non-EE stuff that can be packaged in an EAR, e.g. ServiceMetaData, HibernateMetaData. At this point I don't plan to do this, as there's no requirement and I don't know of a use case.
- To org.jboss.metadata.ear.spec.ModuleMetaData, add a new read/write property "uniqueName".
- Create a new ModuleNameDeployer that:
- takes as inputs the above metadata classes
- provides as outputs the above classes, plus JBossAppMetaData
- when asked to process a DeploymentUnit, finds the relevant attached component metadata object, then checks whether the parent has a JBossAppMetaData attached
- if no, checks if the component metadata object's getModuleName() returns null; if so creates a module name following the EE.8.1.2 rules and sets it
- if yes, checks if the component metadata object's getModuleName() returns null; if so creates a module name following the EE.8.1.2 rules. Then cycles through the JBossAppMetaData's associated ModuleMetaData objects, calling getUniqueName() on each, looking for duplicates. If a duplicate is found, creates a new module name, looping until it finds one that is unique. Once one is found, sets it on the component metadata object and as the unique name property on the ModuleMetaData.
It's all seems pretty straightforward; biggest hassle is it touches a bunch of different metadata projects, so actually getting it into the AS will take some coordination.
The thing I'm going to explore now is how EJBs packaged in wars will work.
Carlo,
ComponentNamingDeployer and ModuleNamingDeployer are calling JavaEEModuleInformer.getModulePath() to get a module name. I think this should be changed:
- JavaEEModuleInformer should add a new getModuleName() method.
- Implementations should implement this by calling the above referenced NamedModule.getModuleName() on the relevant metadata object.