users@connector-spec.java.net

[connector-spec-users] [jsr322-experts] Please review the first draft of the Connectors 1.7 specification

From: Sivakumar Thyagarajan <sivakumar.thyagarajan_at_oracle.com>
Date: Sat, 26 Jan 2013 21:19:03 +0530

Hello experts

Please find the first draft of the Connectors 1.7 Maintenance release
specification uploaded at
http://java.net/projects/connector-spec/downloads/download/connector_1_7-working-draft-v1-20130126.pdf.


Since I did not hear any feedback on [1], in the interest of time I have
gone ahead with Choice #1s in this draft. However, for CONNECTOR_SPEC-1,
since we are only adding MEF.getActivationName, I have tried to write the
requirements there so that it doesn't adversely impact MEF and AS
implementers but still provide enough room for a portable JMS RA to be
built. Similarly in the resource definition annotations case, I have tried
to word the resource adapter name requirements so as to not prevent
implementations beyond the standard deployment model. Please go through
these two changes in more detail, and let me know your inputs.

The detailed change history is in Appendix I (Page 595).

This spec draft addresses the following issues in the connector-spec JIRA,
and a bunch of other clarifications/requirements:
- JMS 2.0 related enhancements: MEF.getActivationName
http://java.net/jira/browse/CONNECTOR_SPEC-1, component namespace
availability during endpoint activation
http://java.net/jira/browse/CONNECTOR_SPEC-4, remove appendix B
http://java.net/jira/browse/CONNECTOR_SPEC-5
- Resource Definition Annotations (@ConnectionFactoryDefinition and
@AdministeredObjectDefinition): http://java.net/jira/browse/CONNECTOR_SPEC-6
- Password Aliases for confidential properties and the 'Password'
configuration property: http://java.net/jira/browse/CONNECTOR_SPEC-2
- Errata: http://java.net/jira/browse/CONNECTOR_SPEC-3

I will send the spec javadoc in a separate email by Monday.

Could you please review this and share your inputs by Wednesday (Jan 30)
PDT end of day?

My plan, as I had shared earlier, is to author the final draft that
handles all feedback that I receive from the EG by Friday (Feb 1) and do
one more round of sanity-check with the EG, before sending the final draft
out to the JCP on Feb 7.

I understand this is short notice, but most of the changes in the draft
has been discussed in the EG ML for the last two months, and the verbiage
should reflect our consensus. For easier review of the changes, go to
Appendix I, and work with the Sections mentioned there.

Any feedback that you provide in this short time would be very useful and
appreciated.

Thanks
--Siva.

[1]
http://java.net/projects/connector-spec/lists/jsr322-experts/archive/2013-01/message/74