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
Show replies by date