[JMS_SPEC-87] Section 2.5 "Interfaces" needs updating to introduce the simplified API Created: 12/Mar/12  Updated: 20/Mar/13  Resolved: 14/Feb/13

Status: Resolved
Project: jms-spec
Component/s: None
Affects Version/s: 1.1
Fix Version/s: 2.0FD, 2.0

Type: Improvement Priority: Major
Reporter: Nigel Deakin Assignee: Nigel Deakin
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Tags: jms20-fd20-doc-added


Section 2.5 "Interfaces" needs updating to introduce the simplified API alongside the "standard" API and to explain how they interrelate.

As part of this work it may be helpful to modify Figure 2.2 "Overview of JMS object relationships" to show the cardinality of the inter-object relationships, for both the standard and simplified API and for Java SE and for the Java EE web or EJB container.

Comment by Nigel Deakin [ 14/Feb/13 ]

The structure of the JMS 1.1 specification reflected the domain-specific APIs introduced in JMS 1.0, with section titles such as "QueueConnection" and "TopicSubscriber". This was an inappropriate structure even in JMS 1.1 since these interfaces had been superseded in JMS 1.1 by the "unified" API. The addition of the simplified API in JMS 2.0 makes that structure even more inappropriate.

The JMS 2.0 specification has now been completely restructured along functional lines, with chapter headings such as "connecting to a JMS provider" and "receiving messages". These describe each area of functionality in generic terms followed by a description of how it is implemented in the various APIs. In general these chapters contain the same text as in the previous version.

In particular a new section 2.5. "JMS APIs" introduces the various APIs introduced in each version of JMS. A new section 2.7. "Classic API interfaces" contains a diagram of the objects used in the "classic" (formerly "standard") API, and section 2.8. "Simplified API interfaces" contains a diagram of the objects used in the simplified API.

Generated at Sat Nov 28 16:20:08 UTC 2015 using JIRA 6.2.3#6260-sha1:63ef1d6dac3f4f4d7db4c1effd405ba38ccdc558.