[jboss-cvs] JBossAS SVN: r83700 - projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work.

jboss-cvs-commits at lists.jboss.org jboss-cvs-commits at lists.jboss.org
Fri Jan 30 13:12:16 EST 2009


Author: jesper.pedersen
Date: 2009-01-30 13:12:16 -0500 (Fri, 30 Jan 2009)
New Revision: 83700

Added:
   projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/HintsContext.java
   projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/SecurityContext.java
   projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/TransactionContext.java
Removed:
   projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/HintsWorkContext.java
   projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/SecurityWorkContext.java
   projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/TransactionWorkContext.java
Log:
[JBJCA-37] Merge API changes from Public Final Draft

Copied: projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/HintsContext.java (from rev 83083, projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/HintsWorkContext.java)
===================================================================
--- projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/HintsContext.java	                        (rev 0)
+++ projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/HintsContext.java	2009-01-30 18:12:16 UTC (rev 83700)
@@ -0,0 +1,110 @@
+/*
+* JBoss, Home of Professional Open Source
+* Copyright 2008, JBoss Inc., and individual contributors as indicated
+* by the @authors tag. See the copyright.txt in the distribution for a
+* full listing of individual contributors.
+*
+* This is free software; you can redistribute it and/or modify it
+* under the terms of the GNU Lesser General Public License as
+* published by the Free Software Foundation; either version 2.1 of
+* the License, or (at your option) any later version.
+*
+* This software is distributed in the hope that it will be useful,
+* but WITHOUT ANY WARRANTY; without even the implied warranty of
+* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+* Lesser General Public License for more details.
+*
+* You should have received a copy of the GNU Lesser General Public
+* License along with this software; if not, write to the Free
+* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+*/
+
+package javax.resource.spi.work;
+
+import java.io.Serializable;
+import java.util.Map;
+import java.util.HashMap;
+
+/**
+ * A standard {@link WorkContext WorkContext} that allows a {@link Work
+ * Work} instance to propagate quality-of-service (QoS) hints about the
+ * {@link Work Work} to the <code>WorkManager</code>.
+ * 
+ * @since 1.6
+ * @see javax.resource.spi.work.WorkContextProvider
+ * @version JSR322-PublicReview
+ */
+
+public class HintsContext implements WorkContext 
+{
+
+   /**
+    * Determines if a deserialized instance of this class
+    * is compatible with this class.
+    */
+   private static final long serialVersionUID = 7956353628297167255L;
+   
+   public static final String NAME_HINT = "javax.resource.Name";
+   public static final String LONGRUNNING_HINT = "javax.resource.LongRunning";
+   
+   protected String description = "Hints Context";
+   protected String name = "HintsContext";
+   
+   /**
+    * {@inheritDoc}
+    */
+   public String getDescription() 
+   {
+      return description;
+   }
+   
+   /**
+    * {@inheritDoc}
+    */
+   public String getName() 
+   {
+      return name;
+   }
+   
+   /**
+    * Set a brief description of the role played by the instance of
+    * HintsContext and any other related debugging information.
+    *
+    * This could be used by the resource adapter and the WorkManager
+    * for logging and debugging purposes.
+    */
+   public void setDescription(String description)
+   {
+      this.description = description;
+   }
+   
+   /**
+    * Set the associated name of the HintsContext. This
+    * could be used by the resource adapter and the WorkManager
+    * for logging and debugging purposes.
+    */
+   public void setName(String name)
+   {
+      this.name = name;
+   }
+   
+   Map<String, Serializable> hints = new HashMap<String, Serializable>();
+   
+   /**
+    * Set a Hint and a related value. The hintName must be non-Null.
+    * Standard HintNames are defined in the Connector specification. Use of
+    * "javax.resource." prefixed hintNames are reserved for use by the 
+    * Connector specification.
+    *
+    */
+   public void setHint(String hintName, Serializable value) 
+   {
+      hints.put(hintName, value);
+   }
+   
+   public Map<String, Serializable> getHints() 
+   {
+      return hints;
+   }
+}


Property changes on: projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/HintsContext.java
___________________________________________________________________
Name: svn:mergeinfo
   + 
Name: svn:eol-style
   + native

Deleted: projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/HintsWorkContext.java
===================================================================
--- projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/HintsWorkContext.java	2009-01-30 17:12:13 UTC (rev 83699)
+++ projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/HintsWorkContext.java	2009-01-30 18:12:16 UTC (rev 83700)
@@ -1,110 +0,0 @@
-/*
-* JBoss, Home of Professional Open Source
-* Copyright 2008, JBoss Inc., and individual contributors as indicated
-* by the @authors tag. See the copyright.txt in the distribution for a
-* full listing of individual contributors.
-*
-* This is free software; you can redistribute it and/or modify it
-* under the terms of the GNU Lesser General Public License as
-* published by the Free Software Foundation; either version 2.1 of
-* the License, or (at your option) any later version.
-*
-* This software is distributed in the hope that it will be useful,
-* but WITHOUT ANY WARRANTY; without even the implied warranty of
-* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-* Lesser General Public License for more details.
-*
-* You should have received a copy of the GNU Lesser General Public
-* License along with this software; if not, write to the Free
-* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
-* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
-*/
-
-package javax.resource.spi.work;
-
-import java.io.Serializable;
-import java.util.Map;
-import java.util.HashMap;
-
-/**
- * A standard {@link WorkContext WorkContext} that allows a {@link Work
- * Work} instance to propagate quality-of-service (QoS) hints about the
- * {@link Work Work} to the <code>WorkManager</code>.
- * 
- * @since 1.6
- * @see javax.resource.spi.work.WorkContextProvider
- * @version JSR322-PublicReview
- */
-
-public class HintsWorkContext implements WorkContext 
-{
-
-   /**
-    * Determines if a deserialized instance of this class
-    * is compatible with this class.
-    */
-   private static final long serialVersionUID = 7956353628297167255L;
-   
-   public static final String NAME_HINT = "javax.resource.Name";
-   public static final String LONGRUNNING_HINT = "javax.resource.LongRunning";
-   
-   protected String description = "Hints Work Context";
-   protected String name = "HintsWorkContext";
-   
-   /**
-    * {@inheritDoc}
-    */
-   public String getDescription() 
-   {
-      return description;
-   }
-   
-   /**
-    * {@inheritDoc}
-    */
-   public String getName() 
-   {
-      return name;
-   }
-   
-   /**
-    * Set a brief description of the role played by the instance of
-    * HintsWorkContext and any other related debugging information.
-    *
-    * This could be used by the resource adapter and the WorkManager
-    * for logging and debugging purposes.
-    */
-   public void setDescription(String description)
-   {
-      this.description = description;
-   }
-   
-   /**
-    * Set the associated name of the HintsWorkContext. This
-    * could be used by the resource adapter and the WorkManager
-    * for logging and debugging purposes.
-    */
-   public void setName(String name)
-   {
-      this.name = name;
-   }
-   
-   Map<String, Serializable> hints = new HashMap<String, Serializable>();
-   
-   /**
-    * Set a Hint and a related value. The hintName must be non-Null.
-    * Standard HintNames are defined in the Connector specification. Use of
-    * "javax.resource." prefixed hintNames are reserved for use by the 
-    * Connector specification.
-    *
-    */
-   public void setHint(String hintName, Serializable value) 
-   {
-      hints.put(hintName, value);
-   }
-   
-   public Map<String, Serializable> getHints() 
-   {
-      return hints;
-   }
-}

Copied: projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/SecurityContext.java (from rev 83083, projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/SecurityWorkContext.java)
===================================================================
--- projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/SecurityContext.java	                        (rev 0)
+++ projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/SecurityContext.java	2009-01-30 18:12:16 UTC (rev 83700)
@@ -0,0 +1,211 @@
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2008, JBoss Inc., and individual contributors as indicated
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * This is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation; either version 2.1 of
+ * the License, or (at your option) any later version.
+ *
+ * This software is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this software; if not, write to the Free
+ * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+ * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+ */
+
+package javax.resource.spi.work;
+
+import javax.security.auth.Subject;
+import javax.security.auth.callback.CallbackHandler;
+
+/**
+ * A standard {@link WorkContext WorkContext} that allows a {@link Work
+ * Work} instance to propagate security related context information from an EIS
+ * to an application server.
+ * <p>
+ * 
+ * 
+ * This allows an EIS/resource adapter to flow-in security context information
+ * and execute a Work instance, and call methods on a MessageEndpoint interface,
+ * to effect message inflow, within that Work instance, in the context of an
+ * established identity.
+ * <p>
+ * 
+ * 
+ * A resource adapter indicates to the WorkManager, that a Work instance needs
+ * to be run in a specified security execution context by submitting a Work
+ * instance that implements WorkContextProvider interface and ensuring that
+ * the List of WorkContexts for that Work instance contains an instance of its
+ * subclass of SecurityContext.
+ * <p>
+ * 
+ * 
+ * It should be noted however that when a resource adapter flows-in an identity
+ * to be used by the application server, the propagated identity may or may not
+ * belong to the application server's security domain.
+ * <p>
+ * 
+ * 
+ * There are therefore, two scenarios while a resource adapter propagates a
+ * security identity from an EIS to the application server:
+ * <p>
+ * 
+ * <ul>
+ * <li>Case 1: Resource adapter flows-in an identity in the application server's
+ * security domain: In this case, the application server could just set the
+ * initiating principal, flown-in from the resource adapter, as the security
+ * context the Work instance executes as.</li>
+ * <li>Case 2: Resource adapter flows-in an identity belonging to the EIS'
+ * security domain: The resource adapter establishes a connection to the EIS and
+ * needs to perform a Work in the context of an EIS identity. In this case, the
+ * initiating or caller principal does not exist in the application server's
+ * security domain and a translation from one domain to the other needs to be
+ * performed.</li>
+ * </ul>
+ * <p>
+ * 
+ * @since 1.6
+ * @see javax.resource.spi.work.WorkContextProvider
+ * @version JSR322-EarlyDraft
+ */
+
+public abstract class SecurityContext implements WorkContext 
+{
+   /**
+    * Determines if a deserialized instance of this class
+    * is compatible with this class.
+    */
+   private static final long serialVersionUID = 7730296651802712658L;
+   
+   /**
+    * {@inheritDoc}
+    */
+   public String getDescription() {
+      return "Security Context";
+   }
+   
+   /**
+    * {@inheritDoc}
+    */
+   public String getName() {
+      return "SecurityContext";
+   }
+   
+   /**
+    * The container calls this method to set up the security Context for the
+    * <code>Work</code> instance.
+    * <p>
+    * 
+    * The handler argument must not be null, and the argument handler and the
+    * <code>CallbackHandler</code> passed to this method must support the
+    * following <code>Callback</code>s defined in JSR 196: Java Authentication
+    * SPI for Containers specification:
+    * <p>
+    * <ul>
+    * <li>CallerPrincipalCallback</li>
+    * <li>GroupPrincipalCallback</li>
+    * <li>PasswordValidationCallback</li>
+    * </ul>
+    * The following <code>Callback</code>s may be supported by the container.
+    * <ul>
+    * <li>CertStoreCallback
+    * <li>
+    * <li>PrivateKeyCallback
+    * <li>
+    * <li>SecretKeyCallback
+    * <li>
+    * <li>TrustStoreCallback
+    * <li>
+    * </ul>
+    * <p>
+    * 
+    * A resource adapter might use the <code>CallerPrincipalCallback</code> “to
+    * set the container's representation of the caller principal. The
+    * CallbackHandler must establish the argument Principal as the caller
+    * principal associated with the invocation being processed by the
+    * container. When the argument Principal is null, the handler will
+    * establish the container's representation of the unauthenticated caller
+    * principal.”
+    * <p>
+    * 
+    * A resource adapter might use the <code>GroupPrincipalCallback</code> “to
+    * establish the container's representation of the corresponding group
+    * principals within the Subject. When a null value is passed to the groups
+    * argument, the handler will establish the container's representation of no
+    * group principals within the Subject. Otherwise, the handler's processing
+    * of this callback is additive, yielding the union (without duplicates) of
+    * the principals existing within the Subject, and those created with the
+    * names occuring within the argument array. The CallbackHandler will define
+    * the type of the created principals.”
+    * <p>
+    * 
+    * A resource adapter might use the <code>PasswordValidationCallback</code>
+    * “to employ the password validation facilities of its containing runtime.”
+    * <p>
+    * 
+    * The executionSubject argument must be non-null and it must not be
+    * read-only. It is expected that this method will populate this
+    * executionSubject with principals and credentials that would be flown into
+    * the application server.
+    * <p>
+    * 
+    * The serviceSubject argument must be non-null and it must not be
+    * read-only. It represents the application server and it may be used by the
+    * Work implementation to retrieve Principals and credentials necessary to
+    * establish a connection to the EIS (in the cause of mutual-auth like
+    * scenarios). If the Subject is not null, the Work implementation may
+    * collect the server credentials, as necessary, by using the callback
+    * handler passed to them .
+    * <p>
+    * 
+    * 
+    * When this method is called, the method implementation
+    * <ul>
+    * <li>identifies the security context that needs to be flown-in to the
+    * application server to serve as the execution context of the Work
+    * instance.</li>
+    * <li>populates the executionSubject with the EIS Principals and
+    * Credentials that it wants to serve as the security context for the Work
+    * instance to be executed in.</li>
+    * <li>adds instances of the necessary Callbacks , usually a subset of the
+    * ones listed above, to an array and invokes the handle() method in the
+    * container's CallbackHandler implementation passing in the array of
+    * Callback instances.</li>
+    * <li>on sucessful return from the CallbackHandler.handle() method the
+    * setSecurityContext returns after ensuring that the executionSubject is
+    * populated with the valid Principals and Credentials that represent the
+    * execution context of the Work instance</li>
+    * </ul>
+    * <p>
+    * 
+    * @see JSR 196: Java Authentication SPI for Containers specification and
+    *      related JavaDoc
+    * 
+    * @param handler
+    *            A <code>CallbackHandler</code> provided by the
+    *            <code>WorkManager</code> that supports the
+    *            <code>Callback</code>s described above
+    * @param executionSubject
+    *            A Subject that represents the security identity that needs to
+    *            be established as the context for the <code>Work</code>
+    *            instance. It is used by the method implementation to store
+    *            Principals and credentials that needs to be used as the
+    *            security context of the <code>Work</code> instance.
+    * @param serviceSubject
+    *            A Subject that represents the application server It may be
+    *            used by the method implementation as the source of Principals
+    *            or credentials to be used to validate a connection to the EIS.
+    *            If the Subject is not null, the method implementation may add
+    *            additional Principals or credentials (pertaining to the
+    *            recipient of the service request) to the Subject. *
+    */
+   public abstract void setupSecurityContext(CallbackHandler handler,
+                                             Subject executionSubject, Subject serviceSubject);
+}


Property changes on: projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/SecurityContext.java
___________________________________________________________________
Name: svn:mergeinfo
   + 
Name: svn:eol-style
   + native

Deleted: projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/SecurityWorkContext.java
===================================================================
--- projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/SecurityWorkContext.java	2009-01-30 17:12:13 UTC (rev 83699)
+++ projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/SecurityWorkContext.java	2009-01-30 18:12:16 UTC (rev 83700)
@@ -1,211 +0,0 @@
-/*
- * JBoss, Home of Professional Open Source
- * Copyright 2008, JBoss Inc., and individual contributors as indicated
- * by the @authors tag. See the copyright.txt in the distribution for a
- * full listing of individual contributors.
- *
- * This is free software; you can redistribute it and/or modify it
- * under the terms of the GNU Lesser General Public License as
- * published by the Free Software Foundation; either version 2.1 of
- * the License, or (at your option) any later version.
- *
- * This software is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this software; if not, write to the Free
- * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
- * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
- */
-
-package javax.resource.spi.work;
-
-import javax.security.auth.Subject;
-import javax.security.auth.callback.CallbackHandler;
-
-/**
- * A standard {@link WorkContext WorkContext} that allows a {@link Work
- * Work} instance to propagate security related context information from an EIS
- * to an application server.
- * <p>
- * 
- * 
- * This allows an EIS/resource adapter to flow-in security context information
- * and execute a Work instance, and call methods on a MessageEndpoint interface,
- * to effect message inflow, within that Work instance, in the context of an
- * established identity.
- * <p>
- * 
- * 
- * A resource adapter indicates to the WorkManager, that a Work instance needs
- * to be run in a specified security execution context by submitting a Work
- * instance that implements WorkContextProvider interface and ensuring that
- * the List of WorkContexts for that Work instance contains an instance of its
- * subclass of SecurityWorkContext.
- * <p>
- * 
- * 
- * It should be noted however that when a resource adapter flows-in an identity
- * to be used by the application server, the propagated identity may or may not
- * belong to the application server's security domain.
- * <p>
- * 
- * 
- * There are therefore, two scenarios while a resource adapter propagates a
- * security identity from an EIS to the application server:
- * <p>
- * 
- * <ul>
- * <li>Case 1: Resource adapter flows-in an identity in the application server's
- * security domain: In this case, the application server could just set the
- * initiating principal, flown-in from the resource adapter, as the security
- * context the Work instance executes as.</li>
- * <li>Case 2: Resource adapter flows-in an identity belonging to the EIS'
- * security domain: The resource adapter establishes a connection to the EIS and
- * needs to perform a Work in the context of an EIS identity. In this case, the
- * initiating or caller principal does not exist in the application server's
- * security domain and a translation from one domain to the other needs to be
- * performed.</li>
- * </ul>
- * <p>
- * 
- * @since 1.6
- * @see javax.resource.spi.work.WorkContextProvider
- * @version JSR322-EarlyDraft
- */
-
-public abstract class SecurityWorkContext implements WorkContext 
-{
-   /**
-    * Determines if a deserialized instance of this class
-    * is compatible with this class.
-    */
-   private static final long serialVersionUID = 7730296651802712658L;
-   
-   /**
-    * {@inheritDoc}
-    */
-   public String getDescription() {
-      return "Security Work Context";
-   }
-   
-   /**
-    * {@inheritDoc}
-    */
-   public String getName() {
-      return "SecurityWorkContext";
-   }
-   
-   /**
-    * The container calls this method to set up the security Context for the
-    * <code>Work</code> instance.
-    * <p>
-    * 
-    * The handler argument must not be null, and the argument handler and the
-    * <code>CallbackHandler</code> passed to this method must support the
-    * following <code>Callback</code>s defined in JSR 196: Java Authentication
-    * SPI for Containers specification:
-    * <p>
-    * <ul>
-    * <li>CallerPrincipalCallback</li>
-    * <li>GroupPrincipalCallback</li>
-    * <li>PasswordValidationCallback</li>
-    * </ul>
-    * The following <code>Callback</code>s may be supported by the container.
-    * <ul>
-    * <li>CertStoreCallback
-    * <li>
-    * <li>PrivateKeyCallback
-    * <li>
-    * <li>SecretKeyCallback
-    * <li>
-    * <li>TrustStoreCallback
-    * <li>
-    * </ul>
-    * <p>
-    * 
-    * A resource adapter might use the <code>CallerPrincipalCallback</code> “to
-    * set the container's representation of the caller principal. The
-    * CallbackHandler must establish the argument Principal as the caller
-    * principal associated with the invocation being processed by the
-    * container. When the argument Principal is null, the handler will
-    * establish the container's representation of the unauthenticated caller
-    * principal.”
-    * <p>
-    * 
-    * A resource adapter might use the <code>GroupPrincipalCallback</code> “to
-    * establish the container's representation of the corresponding group
-    * principals within the Subject. When a null value is passed to the groups
-    * argument, the handler will establish the container's representation of no
-    * group principals within the Subject. Otherwise, the handler's processing
-    * of this callback is additive, yielding the union (without duplicates) of
-    * the principals existing within the Subject, and those created with the
-    * names occuring within the argument array. The CallbackHandler will define
-    * the type of the created principals.”
-    * <p>
-    * 
-    * A resource adapter might use the <code>PasswordValidationCallback</code>
-    * “to employ the password validation facilities of its containing runtime.”
-    * <p>
-    * 
-    * The executionSubject argument must be non-null and it must not be
-    * read-only. It is expected that this method will populate this
-    * executionSubject with principals and credentials that would be flown into
-    * the application server.
-    * <p>
-    * 
-    * The serviceSubject argument must be non-null and it must not be
-    * read-only. It represents the application server and it may be used by the
-    * Work implementation to retrieve Principals and credentials necessary to
-    * establish a connection to the EIS (in the cause of mutual-auth like
-    * scenarios). If the Subject is not null, the Work implementation may
-    * collect the server credentials, as necessary, by using the callback
-    * handler passed to them .
-    * <p>
-    * 
-    * 
-    * When this method is called, the method implementation
-    * <ul>
-    * <li>identifies the security context that needs to be flown-in to the
-    * application server to serve as the execution context of the Work
-    * instance.</li>
-    * <li>populates the executionSubject with the EIS Principals and
-    * Credentials that it wants to serve as the security context for the Work
-    * instance to be executed in.</li>
-    * <li>adds instances of the necessary Callbacks , usually a subset of the
-    * ones listed above, to an array and invokes the handle() method in the
-    * container's CallbackHandler implementation passing in the array of
-    * Callback instances.</li>
-    * <li>on sucessful return from the CallbackHandler.handle() method the
-    * setSecurityContext returns after ensuring that the executionSubject is
-    * populated with the valid Principals and Credentials that represent the
-    * execution context of the Work instance</li>
-    * </ul>
-    * <p>
-    * 
-    * @see JSR 196: Java Authentication SPI for Containers specification and
-    *      related JavaDoc
-    * 
-    * @param handler
-    *            A <code>CallbackHandler</code> provided by the
-    *            <code>WorkManager</code> that supports the
-    *            <code>Callback</code>s described above
-    * @param executionSubject
-    *            A Subject that represents the security identity that needs to
-    *            be established as the context for the <code>Work</code>
-    *            instance. It is used by the method implementation to store
-    *            Principals and credentials that needs to be used as the
-    *            security context of the <code>Work</code> instance.
-    * @param serviceSubject
-    *            A Subject that represents the application server It may be
-    *            used by the method implementation as the source of Principals
-    *            or credentials to be used to validate a connection to the EIS.
-    *            If the Subject is not null, the method implementation may add
-    *            additional Principals or credentials (pertaining to the
-    *            recipient of the service request) to the Subject. *
-    */
-   public abstract void setupSecurityContext(CallbackHandler handler,
-                                             Subject executionSubject, Subject serviceSubject);
-}

Copied: projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/TransactionContext.java (from rev 83083, projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/TransactionWorkContext.java)
===================================================================
--- projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/TransactionContext.java	                        (rev 0)
+++ projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/TransactionContext.java	2009-01-30 18:12:16 UTC (rev 83700)
@@ -0,0 +1,62 @@
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2008, JBoss Inc., and individual contributors as indicated
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * This is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation; either version 2.1 of
+ * the License, or (at your option) any later version.
+ *
+ * This software is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this software; if not, write to the Free
+ * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+ * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+ */
+
+package javax.resource.spi.work;
+
+/**
+ * A standard <code>WorkContext</code> that allows a <code>Work</code>
+ * instance to propagate transaction related context information from an EIS to
+ * an application server.<p>
+ * 
+ * This class extends <code>ExecutionContext</code> so that a resource adapter
+ * developer could migrate their existing code from
+ * <code>ExecutionContext</code> to <code>TransactionContext</code>
+ * easily.<p>
+ * 
+ * @since 1.6
+ * @see javax.resource.spi.work.WorkContext
+ * @see javax.resource.spi.work.ExecutionContext
+ * @version JSR322-EarlyDraft
+ */
+
+public class TransactionContext extends ExecutionContext implements WorkContext 
+{
+   /**
+    * Determines if a deserialized instance of this class
+    * is compatible with this class.
+    */
+   private static final long serialVersionUID = 6205067498708597824L;
+
+   /**
+    * {@inheritDoc}
+    */
+   public String getDescription() {
+      return "Transaction Context";
+   }
+
+   /**
+    * {@inheritDoc}
+    */
+   public String getName() {
+      return "TransactionContext";
+   }
+}


Property changes on: projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/TransactionContext.java
___________________________________________________________________
Name: svn:mergeinfo
   + 
Name: svn:eol-style
   + native

Deleted: projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/TransactionWorkContext.java
===================================================================
--- projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/TransactionWorkContext.java	2009-01-30 17:12:13 UTC (rev 83699)
+++ projects/jboss-jca/trunk/api/src/main/java/javax/resource/spi/work/TransactionWorkContext.java	2009-01-30 18:12:16 UTC (rev 83700)
@@ -1,62 +0,0 @@
-/*
- * JBoss, Home of Professional Open Source
- * Copyright 2008, JBoss Inc., and individual contributors as indicated
- * by the @authors tag. See the copyright.txt in the distribution for a
- * full listing of individual contributors.
- *
- * This is free software; you can redistribute it and/or modify it
- * under the terms of the GNU Lesser General Public License as
- * published by the Free Software Foundation; either version 2.1 of
- * the License, or (at your option) any later version.
- *
- * This software is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this software; if not, write to the Free
- * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
- * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
- */
-
-package javax.resource.spi.work;
-
-/**
- * A standard <code>WorkContext</code> that allows a <code>Work</code>
- * instance to propagate transaction related context information from an EIS to
- * an application server.<p>
- * 
- * This class extends <code>ExecutionContext</code> so that a resource adapter
- * developer could migrate their existing code from
- * <code>ExecutionContext</code> to <code>TransactionWorkContext</code>
- * easily.<p>
- * 
- * @since 1.6
- * @see javax.resource.spi.work.WorkContext
- * @see javax.resource.spi.work.ExecutionContext
- * @version JSR322-EarlyDraft
- */
-
-public class TransactionWorkContext extends ExecutionContext implements WorkContext 
-{
-   /**
-    * Determines if a deserialized instance of this class
-    * is compatible with this class.
-    */
-   private static final long serialVersionUID = 6205067498708597824L;
-
-   /**
-    * {@inheritDoc}
-    */
-   public String getDescription() {
-      return "Transaction Work Context";
-   }
-
-   /**
-    * {@inheritDoc}
-    */
-   public String getName() {
-      return "TransactionWorkContext";
-   }
-}




More information about the jboss-cvs-commits mailing list