To whom it may concern,
while reading a few sections of the JSR-342 Java EE 7 spec i've come
across the following inconsistencies, which i'd like to propose for
correction before the final release:
--
Section EE.5.18 "Resource Definition and Configuration" describes
annotations and deployment descriptor elements to define resources.
These annotations are: DataSourceDefinition,
JMSConnectionFactoryDefinition, JMSDestinationDefinition,
MailSessionDefinition, ConnectionFactoryDefinition, and
AdministeredObjectDefinition.
However, a small but important number of resource types (to which a
component may express dependencies in the form of resource references)
cannot be defined in this way:
- Web services, so that Web service references as described in section
EE.5.6 can refer to them.
- URL connection factories (i.e. java.net.URL), so that resource
manager connection factory references as described in section EE.5.7
(and more specifically in section E.5.7.1.4 "Standard Resource Manager
Connection Factory Types") can refer to them.
- Simple configuration parameters, so that simple environment entries
as described in section EE.5.4 can refer to them.
I would argue that annotations and deployment descriptor elements to
allow the definition of these remaining resource types would be very
useful.
Furthermore, there is a naming inconsistency insofar as
- section EE.5.18.7 speaks of *connector* connection factory
definitions (and describes annotations and deployment descriptor
elements using that terminology) while the closely related section
EE.5.7 refers to *resource manager* connection factory references.
- section EE.5.18.8 speaks of *connector administered object*
definitions (and describes annotations and deployment descriptor
elements using that terminology) while the closely related section
EE.5.8 refers to *resource environment* references.
I would propose to harmonize terminology in this area, both in the
specification text as in the definition of annotations and deployment
descriptor elements.
--
cheers,
gerald
--
Gerald Loeffler
mailto:gerald.loeffler_at_googlemail.com
http://www.gerald-loeffler.net