This repository has been archived by the owner. It is now read-only.
Permalink
Browse files

Added speclicense to javadoc. Added contants for valid values of TRAN…

…SACTION execution property. Updated example in ContextService to use TRANSACTION execution property instead of USE_PARENT_TRANSACTION.

svn path=/trunk/; revision=27
  • Loading branch information...
alai8 committed Feb 19, 2013
1 parent d14132b commit f57043d78be931b89afcf4b66002f99de4099a3e
View
@@ -204,7 +204,14 @@
<version>2.8</version>
<configuration>
<doctitle>Concurrency Utilities for Java EE ${project.version} API Specification</doctitle>
<bottom>Copyright © 2010-2012 Oracle Corporation. All Rights Reserved. Use is subject to license terms.</bottom>
<bottom>
<![CDATA[Copyright &#169; 1996-2013,
<a href="http://www.oracle.com">Oracle</a>
and/or its affiliates. All Rights Reserved.
Use is subject to
<a href="doc-files/speclicense.html" target="_top">license terms</a>.
]]>
</bottom>
<!--javaApiLinks>
<property>
<name>api_1.3</name>
@@ -216,7 +216,7 @@
* // Specify that contextual object should run inside the current
* // transaction. If we have a failure, we don't want to consume
* // the message.
* execProps.put(ContextService.USE_PARENT_TRANSACTION, &quot;true&quot;);
* execProps.put(ManagedTask.TRANSACTION, &quot;USE_TRANSACTION_OF_EXECUTION_THREAD&quot;);
*
* ProcessMessage msgProcessor =
* ctxSvc.createContextualProxy(new MessageProcessor(), execProps,
@@ -93,8 +93,21 @@
* {@link javax.transaction.UserTransaction} will be available.
* <P>
*/
public final String TRANSACTION = "javax.enterprise.concurrent.TRANSACTION";
public static final String TRANSACTION = "javax.enterprise.concurrent.TRANSACTION";
/**
* Constant for the "SUSPEND" value of the TRANSACTION execution property.
* See {@link ManagedTask#TRANSACTION}.
*/
public static final String SUSPEND = "SUSPEND";
/**
* Constant for the "USE_TRANSACTION_OF_EXECUTION_THREAD" value of the
* TRANSACTION execution property.
* See {@link ManagedTask#TRANSACTION}.
*/
public static final String USE_TRANSACTION_OF_EXECUTION_THREAD = "USE_TRANSACTION_OF_EXECUTION_THREAD";
/**
* Execution property to be returned in {@link #getExecutionProperties()} or
* {@link ContextService#createContextualProxy(java.lang.Object, java.util.Map, java.lang.Class) ContextService.createContextualProxy()}
@@ -46,9 +46,7 @@
* It can be registered with a {@link ManagedExecutorService} using the
* <code>submit</code> methods and will be invoked when the state of the
* {@link Future} changes.
* Each listener method will run with unspecified context unless
* {@link ManagedTask#CONTEXTUAL_CALLBACK_HINT} is specified to control whether
* or not these callback methods run under the same context in which the task runs.
* Each listener method will run with unspecified context.
* All listeners run without an explicit transaction
* (they do not enlist in the application component's transaction). If a transaction is required, use a
* {@link javax.transaction.UserTransaction} instance.
@@ -0,0 +1,215 @@
<html>
<head>
<title>Specification License</title>
</head>
<body>
Specification: JSR-236 Concurrency Utilities for Java EE ("Specification")
<br/>
Version: 1.0
<br/>
Status: Proposed Final Draft
<br/>
Release: February 2013
<br/>
<br/>
Copyright &#169; <Year> Oracle America, Inc.
<br/>
500 Oracle Parkway
<br/>
Redwood City, California 94065, U.S.A.
<br/>
<br/>
All rights reserved.
<br/>
<p>
NOTICE
<br/>
The Specification is protected by copyright and the information
described therein may be protected by one or more U.S. patents, foreign
patents, or pending applications. Except as provided under the
following license, no part of the Specification may be reproduced in
any form by any means without the prior written authorization of Oracle
America, Inc. ("Oracle") and its licensors, if any. Any use of the
Specification and the information described therein will be governed by
the terms and conditions of this Agreement.
</p>
<p>
Subject to the terms and conditions of this license, including your
compliance with Paragraphs 1 and 2 below, Oracle hereby grants you a
fully-paid, non-exclusive, non-transferable, limited license (without
the right to sublicense) under Oracle's intellectual property rights
to:
<br/>
1.Review the Specification for the purposes of evaluation. This
includes: (i) developing implementations of the Specification for your
internal, non-commercial use; (ii) discussing the Specification with
any third party; and (iii) excerpting brief portions of the
Specification in oral or written communications which discuss the
Specification provided that such excerpts do not in the aggregate
constitute a significant portion of the Technology.
<br/>
2.Distribute implementations of the Specification to third parties for
their testing and evaluation use, provided that any such
implementation:
<br/>
(i) does not modify, subset, superset or otherwise extend the Licensor
Name Space, or include any public or protected packages, classes, Java
interfaces, fields or methods within the Licensor Name Space other than
those required/authorized by the Specification or Specifications being
implemented;
<br/>
(ii) is clearly and prominently marked with the word "UNTESTED" or
"EARLY ACCESS" or "INCOMPATIBLE" or "UNSTABLE" or "BETA" in any list of
available builds and in proximity to every link initiating its
download, where the list or link is under Licensee's control; and
<br/>
(iii) includes the following notice:
<br/>
"This is an implementation of an early-draft specification developed
under the Java Community Process (JCP) and is made available for
testing and evaluation purposes only. The code is not compatible with
any specification of the JCP."
</p>
<p>
The grant set forth above concerning your distribution of
implementations of the specification is contingent upon your agreement
to terminate development and distribution of your "early draft"
implementation as soon as feasible following final completion of the
specification. If you fail to do so, the foregoing grant shall be
considered null and void.
</p>
<p>
No provision of this Agreement shall be understood to restrict your
ability to make and distribute to third parties applications written to
the Specification.
</p>
<p>
Other than this limited license, you acquire no right, title or
interest in or to the Specification or any other Oracle intellectual
property, and the Specification may only be used in accordance with the
license terms set forth herein. This license will expire on the earlier
of: (a) two (2) years from the date of Release listed above; (b) the
date on which the final version of the Specification is publicly
released; or (c) the date on which the Java Specification Request (JSR)
to which the Specification corresponds is withdrawn. In addition, this
license will terminate immediately without notice from Oracle if you
fail to comply with any provision of this license. Upon termination,
you must cease use of or destroy the Specification.
</p>
<p>
"Licensor Name Space" means the public class or interface declarations
whose names begin with "java", "javax", "com.oracle" or their
equivalents in any subsequent naming convention adopted by Oracle
through the Java Community Process, or any recognized successors or
replacements thereof
</p>
<p>
TRADEMARKS
<br/>
No right, title, or interest in or to any trademarks, service marks, or
trade names of Oracle or Oracle's licensors is granted hereunder.
Oracle, the Oracle logo, Java are trademarks or registered trademarks
of Oracle USA, Inc. in the U.S. and other countries.
</p>
<p>
DISCLAIMER OF WARRANTIES
<br/>
THE SPECIFICATION IS PROVIDED "AS IS" AND IS EXPERIMENTAL AND MAY
CONTAIN DEFECTS OR DEFICIENCIES WHICH CANNOT OR WILL NOT BE CORRECTED
BY ORACLE. ORACLE MAKES NO REPRESENTATIONS OR WARRANTIES, EITHER
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT
THAT THE CONTENTS OF THE SPECIFICATION ARE
</p>
<p>
SUITABLE FOR ANY PURPOSE OR THAT ANY PRACTICE OR IMPLEMENTATION OF SUCH
CONTENTS WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADE
SECRETS OR OTHER RIGHTS. This document does not represent any
commitment to release or implement any portion of the Specification in
any product.
</p>
<p>
THE SPECIFICATION COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL
ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION THEREIN;
THESE CHANGES WILL BE INCORPORATED INTO NEW VERSIONS OF THE
SPECIFICATION, IF ANY. ORACLE MAY MAKE IMPROVEMENTS AND/OR CHANGES TO
THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THE SPECIFICATION AT
ANY TIME. Any use of such changes in the Specification will be governed
by the then-current license for the applicable version of the
Specification.
</p>
<p>
LIMITATION OF LIABILITY
<br/>
TO THE EXTENT NOT PROHIBITED BY LAW, IN NO EVENT WILL ORACLE OR ITS
LICENSORS BE LIABLE FOR ANY DAMAGES, INCLUDING WITHOUT LIMITATION, LOST
REVENUE, PROFITS OR DATA, OR FOR SPECIAL, INDIRECT, CONSEQUENTIAL,
INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE
THEORY OF LIABILITY, ARISING OUT OF OR RELATED TO ANY FURNISHING,
PRACTICING, MODIFYING OR ANY USE OF THE SPECIFICATION, EVEN IF ORACLE
AND/OR ITS LICENSORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES.
</p>
<p>
You will hold Oracle (and its licensors) harmless from any claims based
on your use of the Specification for any purposes other than the
limited right of evaluation as described above, and from any claims
that later versions or releases of any Specification furnished to you
are incompatible with the Specification provided to you under this
license.
</p>
<p>
RESTRICTED RIGHTS LEGEND
<br/>
If this Software is being acquired by or on behalf of the U.S.
Government or by a U.S. Government prime contractor or subcontractor
(at any tier), then the Government's rights in the Software and
accompanying documentation shall be only as set forth in this license;
this is in accordance with 48 C.F.R. 227.7201 through 227.7202-4 (for
Department of Defense (DoD) acquisitions) and with 48 C.F.R. 2.101 and
12.212 (for non-DoD acquisitions).
</p>
<p>
REPORT
<br/>
You may wish to report any ambiguities, inconsistencies or inaccuracies
you may find in connection with your evaluation of the Specification
("Feedback"). To the extent that you provide Oracle with any Feedback,
you hereby: (i) agree that such Feedback is provided on a
non-proprietary and non-confidential basis, and (ii) grant Oracle a
perpetual, non-exclusive, worldwide, fully paid-up, irrevocable
license, with the right to sublicense through multiple levels of
sublicensees, to incorporate, disclose, and use without limitation the
Feedback for any purpose related to the Specification and future
versions, implementations, and test suites thereof.
</p>
<p>
GENERAL TERMS
<br/>
Any action related to this Agreement will be governed by California law
and controlling U.S. federal law. The U.N. Convention for the
International Sale of Goods and the choice of law rules of any
jurisdiction will not apply.
</p>
<p>
The Specification is subject to U.S. export control laws and may be
subject to export or import regulations in other countries. Licensee
agrees to comply strictly with all such laws and regulations and
acknowledges that it has the responsibility to obtain such licenses to
export, re-export or import as may be required after delivery to
Licensee.
</p>
<p>
This Agreement is the parties' entire agreement relating to its subject
matter. It supersedes all prior or contemporaneous oral or written
communications, proposals, conditions, representations and warranties
and prevails over any conflicting or additional terms of any quote,
order, acknowledgment, or other communication between the parties
relating to its subject matter during the term of this Agreement. No
modification to this Agreement will be binding, unless in writing and
signed by an authorized representative of each party.
</p>
</body>
</html>

0 comments on commit f57043d

Please sign in to comment.