[jboss-cvs] JBossAS SVN: r105037 - projects/jboss-jca/trunk/codegenerator/src/main/java/org/jboss/jca/codegenerator.

jboss-cvs-commits at lists.jboss.org jboss-cvs-commits at lists.jboss.org
Thu May 20 05:01:15 EDT 2010


Author: jeff.zhang
Date: 2010-05-20 05:01:14 -0400 (Thu, 20 May 2010)
New Revision: 105037

Modified:
   projects/jboss-jca/trunk/codegenerator/src/main/java/org/jboss/jca/codegenerator/AbstractCodeGen.java
   projects/jboss-jca/trunk/codegenerator/src/main/java/org/jboss/jca/codegenerator/McCodeGen.java
   projects/jboss-jca/trunk/codegenerator/src/main/java/org/jboss/jca/codegenerator/McfCodeGen.java
   projects/jboss-jca/trunk/codegenerator/src/main/java/org/jboss/jca/codegenerator/RaCodeGen.java
Log:
[JBJCA-330] add javadoc for generated method, add for RA MCF MC

Modified: projects/jboss-jca/trunk/codegenerator/src/main/java/org/jboss/jca/codegenerator/AbstractCodeGen.java
===================================================================
--- projects/jboss-jca/trunk/codegenerator/src/main/java/org/jboss/jca/codegenerator/AbstractCodeGen.java	2010-05-20 08:49:03 UTC (rev 105036)
+++ projects/jboss-jca/trunk/codegenerator/src/main/java/org/jboss/jca/codegenerator/AbstractCodeGen.java	2010-05-20 09:01:14 UTC (rev 105037)
@@ -164,6 +164,16 @@
     */
    void writeDefaultConstructor(Definition def, Writer out, int indent) throws IOException
    {
+      writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * default constructor");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
       //constructor
       writeIndent(out, indent);
       out.write("public " + getClassName(def) + "()");

Modified: projects/jboss-jca/trunk/codegenerator/src/main/java/org/jboss/jca/codegenerator/McCodeGen.java
===================================================================
--- projects/jboss-jca/trunk/codegenerator/src/main/java/org/jboss/jca/codegenerator/McCodeGen.java	2010-05-20 08:49:03 UTC (rev 105036)
+++ projects/jboss-jca/trunk/codegenerator/src/main/java/org/jboss/jca/codegenerator/McCodeGen.java	2010-05-20 09:01:14 UTC (rev 105037)
@@ -24,7 +24,9 @@
 import java.io.IOException;
 import java.io.Writer;
 
+import javax.resource.ResourceException;
 
+
 /**
  * A managed connection CodeGen.
  * 
@@ -126,12 +128,39 @@
    private void writeConnection(Definition def, Writer out, int indent) throws IOException
    {
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Creates a new connection handle for the underlying physical connection ");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * represented by the ManagedConnection instance. ");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param        subject        security context as JAAS subject");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param        cxRequestInfo  ConnectionRequestInfo instance");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @return       generic Object instance representing the connection handle. ");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws  ResourceException     generic exception if operation fails");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public Object getConnection(Subject subject,");
       writeEol(out);
       writeIndent(out, indent + 2);
       out.write("ConnectionRequestInfo cxRequestInfo) throws ResourceException");
       writeLeftCurlyBracket(out, indent);
-
       writeIndent(out, indent + 1);
       out.write("log.debug(\"call getConnection\");");
       writeEol(out);
@@ -139,14 +168,34 @@
       out.write("return null;");
       writeRightCurlyBracket(out, indent);
       writeEol(out);
+
+      writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Used by the container to change the association of an ");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * application-level connection handle with a ManagedConneciton instance.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param   connection  Application-level connection handle");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws  ResourceException     generic exception if operation fails");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
       
       writeIndent(out, indent);
       out.write("public void associateConnection(Object connection) throws ResourceException");
       writeLeftCurlyBracket(out, indent);
-
       writeIndent(out, indent + 1);
       out.write("log.debug(\"call associateConnection\");");
-
       writeRightCurlyBracket(out, indent);
       writeEol(out);
    }
@@ -161,6 +210,22 @@
    private void writeLifecycle(Definition def, Writer out, int indent) throws IOException
    {
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Application server calls this method to force any cleanup on the ManagedConnection instance.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws    ResourceException     generic exception if operation fails");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public void cleanup() throws ResourceException");
       writeEol(out);
       writeLeftCurlyBracket(out, indent);
@@ -170,6 +235,22 @@
       writeEol(out);
 
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Destroys the physical connection to the underlying resource manager.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws    ResourceException     generic exception if operation fails");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public void destroy() throws ResourceException");
       writeLeftCurlyBracket(out, indent);
       writeIndent(out, indent + 1);
@@ -188,6 +269,22 @@
    private void writeConnectionEventListener(Definition def, Writer out, int indent) throws IOException
    {
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Adds a connection event listener to the ManagedConnection instance.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param  listener   a new ConnectionEventListener to be registered");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public void addConnectionEventListener(ConnectionEventListener listener)");
       writeLeftCurlyBracket(out, indent);
       writeIndent(out, indent + 1);
@@ -196,6 +293,22 @@
       writeEol(out);
       
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Removes an already registered connection event listener from the ManagedConnection instance.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param  listener   already registered connection event listener to be removed");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public void removeConnectionEventListener(ConnectionEventListener listener)");
       writeLeftCurlyBracket(out, indent);
       writeIndent(out, indent + 1);
@@ -214,6 +327,25 @@
    private void writeLogWriter(Definition def, Writer out, int indent) throws IOException
    {
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Gets the log writer for this ManagedConnection instance.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @return  Character ourput stream associated with this Managed-Connection instance");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws ResourceException     generic exception if operation fails");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public PrintWriter getLogWriter() throws ResourceException");
       writeLeftCurlyBracket(out, indent);
       writeIndent(out, indent + 1);
@@ -225,6 +357,25 @@
       writeEol(out);
       
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Sets the log writer for this ManagedConnection instance.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param      out        Character Output stream to be associated");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws     ResourceException  generic exception if operation fails");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public void setLogWriter(PrintWriter out) throws ResourceException");
       writeLeftCurlyBracket(out, indent);
       writeIndent(out, indent + 1);
@@ -243,6 +394,25 @@
    private void writeTransaction(Definition def, Writer out, int indent) throws IOException
    {
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Returns an <code>javax.resource.spi.LocalTransaction</code> instance.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @return     LocalTransaction instance");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws ResourceException     generic exception if operation fails");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+            
+      writeIndent(out, indent);
       out.write("public LocalTransaction getLocalTransaction() throws ResourceException");
       writeLeftCurlyBracket(out, indent);
       writeIndent(out, indent + 1);
@@ -254,6 +424,25 @@
       writeEol(out);
       
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Returns an <code>javax.transaction.xa.XAresource</code> instance. ");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @return     XAResource instance");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws ResourceException     generic exception if operation fails");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+            
+      writeIndent(out, indent);
       out.write("public XAResource getXAResource() throws ResourceException");
       writeLeftCurlyBracket(out, indent);
       writeIndent(out, indent + 1);
@@ -275,6 +464,25 @@
    private void writeMetaData(Definition def, Writer out, int indent) throws IOException
    {
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Gets the metadata information for this connection's underlying EIS resource manager instance. ");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @return ManagedConnectionMetaData instance");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws ResourceException     generic exception if operation fails");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public ManagedConnectionMetaData getMetaData() throws ResourceException");
       writeLeftCurlyBracket(out, indent);
       writeIndent(out, indent + 1);

Modified: projects/jboss-jca/trunk/codegenerator/src/main/java/org/jboss/jca/codegenerator/McfCodeGen.java
===================================================================
--- projects/jboss-jca/trunk/codegenerator/src/main/java/org/jboss/jca/codegenerator/McfCodeGen.java	2010-05-20 08:49:03 UTC (rev 105036)
+++ projects/jboss-jca/trunk/codegenerator/src/main/java/org/jboss/jca/codegenerator/McfCodeGen.java	2010-05-20 09:01:14 UTC (rev 105037)
@@ -25,6 +25,8 @@
 import java.io.Writer;
 import java.util.List;
 
+import javax.resource.ResourceException;
+
 /**
  * A McfCodeGen.
  * 
@@ -201,6 +203,30 @@
    private void writeConnectionFactory(Definition def, Writer out, int indent) throws IOException
    {
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Creates a Connection Factory instance. ");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param    cxManager    ConnectionManager to be " + 
+         "associated with created EIS connection factory instance");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @return   EIS-specific Connection Factory instance or " +
+         "javax.resource.cci.ConnectionFactory instance");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws   ResourceException Generic exception");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public Object createConnectionFactory(ConnectionManager cxManager) throws ResourceException");
       writeLeftCurlyBracket(out, indent);
       if (def.isImplRaAssociation())
@@ -220,6 +246,26 @@
       writeEol(out);
       
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Creates a Connection Factory instance. ");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @return   EIS-specific Connection Factory instance or " +
+         "javax.resource.cci.ConnectionFactory instance");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws   ResourceException Generic exception");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public Object createConnectionFactory() throws ResourceException");
       writeLeftCurlyBracket(out, indent);
       if (def.isImplRaAssociation())
@@ -264,6 +310,32 @@
    private void writeManagedConnection(Definition def, Writer out, int indent) throws IOException
    {
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Creates a new physical connection to the underlying EIS resource manager.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param   subject        Caller's security information");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param   cxRequestInfo  Additional resource adapter " +
+         "specific connection request information");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws  ResourceException     generic exception");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @return  ManagedConnection instance ");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public ManagedConnection createManagedConnection(Subject subject,");
       writeEol(out);
       writeIndent(out, indent + 2);
@@ -282,6 +354,35 @@
       writeEol(out);
       
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Returns a matched connection from the candidate set of connections. ");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param   connectionSet   candidate connection set");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param   subject        Caller's security information");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param   cxRequestInfo  Additional resource adapter " +
+         "specific connection request information");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws  ResourceException     generic exception");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @return  ManagedConnection if resource adapter finds an acceptable match otherwise null ");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public ManagedConnection matchManagedConnections(Set connectionSet,");
       writeEol(out);
       writeIndent(out, indent + 2);
@@ -309,6 +410,25 @@
    private void writeLogWriter(Definition def, Writer out, int indent) throws IOException
    {
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Get the log writer for this ManagedConnectionFactory instance.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @return  PrintWriter");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws  ResourceException     generic exception");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public PrintWriter getLogWriter() throws ResourceException");
       writeLeftCurlyBracket(out, indent);
       writeIndent(out, indent + 1);
@@ -320,6 +440,25 @@
       writeEol(out);
       
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Set the log writer for this ManagedConnectionFactory instance.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param   out PrintWriter - an out stream for error logging and tracing");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws  ResourceException     generic exception");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public void setLogWriter(PrintWriter out) throws ResourceException");
       writeLeftCurlyBracket(out, indent);
       writeIndent(out, indent + 1);
@@ -339,8 +478,24 @@
     * @throws IOException ioException
     */
    private void writeResourceAdapter(Definition def, Writer out, int indent) throws IOException
-   {
+   {      
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Get the resource adapter");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @return The handle");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public ResourceAdapter getResourceAdapter()");
       writeLeftCurlyBracket(out, indent);
       writeIndent(out, indent + 1);
@@ -352,6 +507,22 @@
       writeEol(out);
       
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * Set the resource adapter");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param ra The handle");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public void setResourceAdapter(ResourceAdapter ra)");
       writeLeftCurlyBracket(out, indent);
       writeIndent(out, indent + 1);

Modified: projects/jboss-jca/trunk/codegenerator/src/main/java/org/jboss/jca/codegenerator/RaCodeGen.java
===================================================================
--- projects/jboss-jca/trunk/codegenerator/src/main/java/org/jboss/jca/codegenerator/RaCodeGen.java	2010-05-20 08:49:03 UTC (rev 105036)
+++ projects/jboss-jca/trunk/codegenerator/src/main/java/org/jboss/jca/codegenerator/RaCodeGen.java	2010-05-20 09:01:14 UTC (rev 105037)
@@ -25,6 +25,9 @@
 import java.io.Writer;
 import java.util.List;
 
+import javax.resource.ResourceException;
+import javax.resource.spi.ResourceAdapterInternalException;
+
 /**
  * A resource adapter code generator
  * 
@@ -113,6 +116,28 @@
    private void writeXAResource(Definition def, Writer out, int indent) throws IOException
    {
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * This method is called by the application server during crash recovery.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param specs an array of ActivationSpec JavaBeans ");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws ResourceException generic exception ");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @return an array of XAResource objects");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public XAResource[] getXAResources(ActivationSpec[] specs)");
       writeEol(out);
       writeIndent(out, indent + 1);
@@ -137,6 +162,25 @@
    private void writeLifecycle(Definition def, Writer out, int indent) throws IOException
    {
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * This is called when a resource adapter instance is bootstrapped.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param ctx a bootstrap context containing references ");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws ResourceAdapterInternalException indicates bootstrap failure.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public void start(BootstrapContext ctx)");
       writeEol(out);
       writeIndent(out, indent + 1);
@@ -148,6 +192,19 @@
       writeEol(out);
 
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * This is called when a resource adapter instance is undeployed or");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * during application server shutdown. ");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public void stop()");
       writeLeftCurlyBracket(out, indent);
       writeIndent(out, indent + 1);
@@ -166,6 +223,28 @@
    private void writeEndpointLifecycle(Definition def, Writer out, int indent) throws IOException
    {
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * This is called during the activation of a message endpoint.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param endpointFactory a message endpoint factory instance.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param spec an activation spec JavaBean instance.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @throws ResourceException generic exception ");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public void endpointActivation(MessageEndpointFactory endpointFactory,");
       writeEol(out);
       writeIndent(out, indent + 1);
@@ -177,6 +256,25 @@
       writeEol(out);
 
       writeIndent(out, indent);
+      out.write("/**");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * This is called when a message endpoint is deactivated. ");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" *");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param endpointFactory a message endpoint factory instance.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" * @param spec an activation spec JavaBean instance.");
+      writeEol(out);
+      writeIndent(out, indent);
+      out.write(" */");
+      writeEol(out);
+      
+      writeIndent(out, indent);
       out.write("public void endpointDeactivation(MessageEndpointFactory endpointFactory,");
       writeEol(out);
       writeIndent(out, indent + 1);




More information about the jboss-cvs-commits mailing list