[seam-commits] Seam SVN: r12729 - modules/jms/trunk/impl/src/main/java/org/jboss/seam/jms/impl/inject.

[seam-commits at lists.jboss.org]

Author: dan.j.allen
Date: 2010-05-14 17:50:41 -0400 (Fri, 14 May 2010)
New Revision: 12729

Modified:
   modules/jms/trunk/impl/src/main/java/org/jboss/seam/jms/impl/inject/ConnectionProducer.java
Log:
add docs


Modified: modules/jms/trunk/impl/src/main/java/org/jboss/seam/jms/impl/inject/ConnectionProducer.java
===================================================================
--- modules/jms/trunk/impl/src/main/java/org/jboss/seam/jms/impl/inject/ConnectionProducer.java	2010-05-14 20:29:22 UTC (rev 12728)
+++ modules/jms/trunk/impl/src/main/java/org/jboss/seam/jms/impl/inject/ConnectionProducer.java	2010-05-14 21:50:41 UTC (rev 12729)
@@ -31,6 +31,16 @@
 
 import org.jboss.seam.jms.annotations.Module;
 
+/**
+ * <p>Provides a producer of an unqualified (i.e., @Default) application-scoped JMS {@link Connection} object.</p>
+ *
+ * <p>According to the documentation, a {@link Connection} is a relatively heavyweight object because its creation
+ * involves setting up authentication and communication. Most clients will do all their messaging with a single
+ * connection. Only more advanced applications may use several connections, though it's considered atypical.
+ * Therefore, use of the application-scope is justified.</p>
+ *
+ * @author Jordan Ganoff
+ */
 public class ConnectionProducer
 {
    @Produces