[jboss-cvs] JBossAS SVN: r106761 - projects/specs/trunk/jboss-connector-api_1.6_spec/src/main/java/javax/resource/spi/work.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Thu Jul 15 12:15:38 EDT 2010
Author: smcgowan at redhat.com
Date: 2010-07-15 12:15:37 -0400 (Thu, 15 Jul 2010)
New Revision: 106761
Removed:
projects/specs/trunk/jboss-connector-api_1.6_spec/src/main/java/javax/resource/spi/work/HintsWorkContext.java
projects/specs/trunk/jboss-connector-api_1.6_spec/src/main/java/javax/resource/spi/work/SecurityWorkContext.java
projects/specs/trunk/jboss-connector-api_1.6_spec/src/main/java/javax/resource/spi/work/TransactionWorkContext.java
Log:
remove renamed APIs
Deleted: projects/specs/trunk/jboss-connector-api_1.6_spec/src/main/java/javax/resource/spi/work/HintsWorkContext.java
===================================================================
--- projects/specs/trunk/jboss-connector-api_1.6_spec/src/main/java/javax/resource/spi/work/HintsWorkContext.java 2010-07-15 15:41:01 UTC (rev 106760)
+++ projects/specs/trunk/jboss-connector-api_1.6_spec/src/main/java/javax/resource/spi/work/HintsWorkContext.java 2010-07-15 16:15:37 UTC (rev 106761)
@@ -1,94 +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 {
- String description = "Hints Inflow Context";
- 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;
- }
-
-}
Deleted: projects/specs/trunk/jboss-connector-api_1.6_spec/src/main/java/javax/resource/spi/work/SecurityWorkContext.java
===================================================================
--- projects/specs/trunk/jboss-connector-api_1.6_spec/src/main/java/javax/resource/spi/work/SecurityWorkContext.java 2010-07-15 15:41:01 UTC (rev 106760)
+++ projects/specs/trunk/jboss-connector-api_1.6_spec/src/main/java/javax/resource/spi/work/SecurityWorkContext.java 2010-07-15 16:15:37 UTC (rev 106761)
@@ -1,205 +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 {
-
- /**
- * {@inheritDoc}
- */
- public String getDescription() {
- return "Security Inflow 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);
-}
Deleted: projects/specs/trunk/jboss-connector-api_1.6_spec/src/main/java/javax/resource/spi/work/TransactionWorkContext.java
===================================================================
--- projects/specs/trunk/jboss-connector-api_1.6_spec/src/main/java/javax/resource/spi/work/TransactionWorkContext.java 2010-07-15 15:41:01 UTC (rev 106760)
+++ projects/specs/trunk/jboss-connector-api_1.6_spec/src/main/java/javax/resource/spi/work/TransactionWorkContext.java 2010-07-15 16:15:37 UTC (rev 106761)
@@ -1,56 +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 {
- /**
- * {@inheritDoc}
- */
- public String getDescription() {
- return "Transaction Inflow Context";
- }
-
- /**
- * {@inheritDoc}
- */
- public String getName() {
- return "TransactionWorkContext";
- }
-}
More information about the jboss-cvs-commits
mailing list