[JAVA][Enterprise JavaBeans 3.0 EJB 3.0 Simplified API].pdf

(273 KB) Pobierz

microsystems

Sun Microsystems

JSR 220: Enterprise

,Version

JavaBeans

3.0

EJB 3.0 Simplified API

EJB 3.0 Expert Group

Specification Lead:

Linda DeMichiel, Sun Microsystems

Michael Keith, Oracle Corporation

Please send comments to: ejb3-spec-feedback@sun.com

Version 3.0, Final Release

May 2, 2006

Enterprise JavaBeans 3.0, Final Release

Sun Microsystems, Inc.

Specification: JSR-000220 Enterprise JavaBeans v.3.0 ("Specification")

Version: 3.0

Status: Final Release

Release: 8 May 2006

4150 Network Circle, Santa Clara, California 95054, U.S.A

LIMITED LICENSE GRANTS

1. _License for Evaluation Purposes_. Sun hereby grants you a fully-paid, non-exclusive, non-transfer-

able, worldwide, limited license (without the right to sublicense), under Sun’s applicable intellectual

property rights to view, download, use and reproduce the Specification only for the purpose of internal

evaluation. This includes (i) developing applications intended to run on an implementation of the Spec-

ification, provided that such applications do not themselves implement any portion(s) of the Specifica-

tion, and (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 ex-

cerpts do not in the aggregate constitute a significant portion of the Specification.

2. _License for the Distribution of Compliant Implementations_. Sun also grants you a perpetual, non-

exclusive, non-transferable, worldwide, fully paid-up, royalty free, limited license (without the right to

sublicense) under any applicable copyrights or, subject to the provisions of subsection 4 below, patent

rights it may have covering the Specification to create and/or distribute an Independent Implementation

of the Specification that: (a) fully implements the Specification including all its required interfaces and

functionality; (b) does not modify, subset, superset or otherwise extend the Licensor Name Space, or in-

clude 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 imple-

mented; and (c) passes the Technology Compatibility Kit (including satisfying the requirements of the

applicable TCK Users Guide) for such Specification ("Compliant Implementation"). In addition, the

foregoing license is expressly conditioned on your not acting outside its scope. No license is granted

hereunder for any other purpose (including, for example, modifying the Specification, other than to the

extent of your fair use rights, or distributing the Specification to third parties). Also, no right, title, or

interest in or to any trademarks, service marks, or trade names of Sun or Sun’s licensors is granted here-

under. Java, and Java-related logos, marks and names are trademarks or registered trademarks of Sun Mi-

crosystems, Inc. in the U.S. and other countries.

3. _Pass-through Conditions_. You need not include limitations (a)-(c) from the previous paragraph or

any other particular "pass through" requirements in any license You grant concerning the use of your In-

dependent Implementation or products derived from it. However, except with respect to Independent Im-

plementations (and products derived from them) that satisfy limitations (a)-(c) from the previous

paragraph, You may neither: (a) grant or otherwise pass through to your licensees any licenses under

Sun’s applicable intellectual property rights; nor (b) authorize your licensees to make any claims con-

cerning their implementation’s compliance with the Specification in question.

4. _Reciprocity Concerning Patent Licenses_.

a. With respect to any patent claims covered by the license granted under subparagraph 2 above that

would be infringed by all technically feasible implementations of the Specification, such license is con-

ditioned upon your offering on fair, reasonable and non-discriminatory terms, to any party seeking it

from You, a perpetual, non-exclusive, non-transferable, worldwide license under Your patent rights

5/2/06

Enterprise JavaBeans 3.0, Final Release

Sun Microsystems, Inc.

which are or would be infringed by all technically feasible implementations of the Specification to de-

velop, distribute and use a Compliant Implementation.

b With respect to any patent claims owned by Sun and covered by the license granted under subparagraph

2, whether or not their infringement can be avoided in a technically feasible manner when implementing

the Specification, such license shall terminate with respect to such claims if You initiate a claim against

Sun that it has, in the course of performing its responsibilities as the Specification Lead, induced any oth-

er entity to infringe Your patent rights.

c Also with respect to any patent claims owned by Sun and covered by the license granted under sub-

paragraph 2 above, where the infringement of such claims can be avoided in a technically feasible man-

ner when implementing the Specification such license, with respect to such claims, shall terminate if You

initiate a claim against Sun that its making, having made, using, offering to sell, selling or importing a

Compliant Implementation infringes Your patent rights.

5. _Definitions_. For the purposes of this Agreement: "Independent Implementation" shall mean an im-

plementation of the Specification that neither derives from any of Sun’s source code or binary code ma-

terials nor, except with an appropriate and separate license from Sun, includes any of Sun’s source code

or binary code materials; "Licensor Name Space" shall mean the public class or interface declarations

whose names begin with "java", "javax", "com.sun" or their equivalents in any subsequent naming con-

vention adopted by Sun through the Java Community Process, or any recognized successors or replace-

ments thereof; and "Technology Compatibility Kit" or "TCK" shall mean the test suite and

accompanying TCK User’s Guide provided by Sun which corresponds to the Specification and that was

available either (i) from Sun 120 days before the first release of Your Independent Implementation that

allows its use for commercial purposes, or (ii) more recently than 120 days from such release but against

which You elect to test Your implementation of the Specification.

This Agreement will terminate immediately without notice from Sun if you breach the Agreement or act

outside the scope of the licenses granted above.

DISCLAIMER OF WARRANTIES

THE SPECIFICATION IS PROVIDED "AS IS". SUN MAKES NO REPRESENTATIONS OR WAR-

RANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRAN-

TIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-

INFRINGEMENT (INCLUDING AS A CONSEQUENCE OF ANY PRACTICE OR IMPLEMENTA-

TION OF THE SPECIFICATION), OR THAT THE CONTENTS OF THE SPECIFICATION ARE

SUITABLE FOR ANY PURPOSE. This document does not represent any commitment to release or im-

plement any portion of the Specification in any product. In addition, the Specification could include tech-

nical inaccuracies or typographical errors.

LIMITATION OF LIABILITY

TO THE EXTENT NOT PROHIBITED BY LAW, IN NO EVENT WILL SUN OR ITS LICENSORS

BE LIABLE FOR ANY DAMAGES, INCLUDING WITHOUT LIMITATION, LOST REVENUE,

PROFITS OR DATA, OR FOR SPECIAL, INDIRECT, CONSEQUENTIAL, INCIDENTAL OR PU-

NITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILI-

TY, ARISING OUT OF OR RELATED IN ANY WAY TO YOUR HAVING, IMPLEMENTING OR

OTHERWISE USING THE SPECIFICATION, EVEN IF SUN AND/OR ITS LICENSORS HAVE

BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

You will indemnify, hold harmless, and defend Sun and its licensors from any claims arising or resulting

from: (i) your use of the Specification; (ii) the use or distribution of your Java application, applet and/or

implementation; and/or (iii) any claims that later versions or releases of any Specification furnished to

you are incompatible with the Specification provided to you under this license.

5/2/06

Enterprise JavaBeans 3.0, Final Release

Sun Microsystems, Inc.

RESTRICTED RIGHTS LEGEND

U.S. Government: If this Specification 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).

REPORT

If you provide Sun with any comments or suggestions concerning the Specification ("Feedback"), you

hereby: (i) agree that such Feedback is provided on a non-proprietary and non-confidential basis, and (ii)

grant Sun a perpetual, non-exclusive, worldwide, fully paid-up, irrevocable license, with the right to sub-

license through multiple levels of sublicensees, to incorporate, disclose, and use without limitation the

Feedback for any purpose.

GENERAL TERMS

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.

The Specification is subject to U.S. export control laws and may be subject to export or import regula-

tions in other countries. Licensee agrees to comply strictly with all such laws and regulations and ac-

knowledges that it has the responsibility to obtain such licenses to export, re-export or import as may be

required after delivery to Licensee.

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 com-

munication between the parties relating to its subject matter during the term of this Agreement. No mod-

ification to this Agreement will be binding, unless in writing and signed by an authorized representative

of each party.

Rev. April, 2006

Sun/Final/Full

5/2/06

Sun Microsystems, Inc.

Enterprise JavaBeans 3.0, Final Release

Table of Contents

Chapter 1

Introduction.................................................................................................................... 9

1.1 Overview ......................................................................................................... 9

1.2 Goals of this Release ....................................................................................... 9

1.3 EJB 3.0 Expert Group...................................................................................... 10

1.4 Organization of the Speciﬁcation Documents ................................................. 10

1.5 Document Conventions ................................................................................... 11

Overview of the EJB 3.0 Simpliﬁed API....................................................................... 13

2.1 Metadata Annotations and Deployment Descriptors....................................... 14

2.1.1 Deployment Descriptors.................................................................... 14

2.2 Interoperability and Migration Between EJB 3.0 and EJB 2.1 and Earlier Clients and

Beans14

Chapter 2

Chapter 3

Enterprise Bean Class and Business Interface ............................................................... 15

3.1 Enterprise Bean Class...................................................................................... 15

3.1.1 Requirements for the Enterprise Bean Class..................................... 16

3.2 Business Interfaces .......................................................................................... 16

3.3 Exceptions ....................................................................................................... 17

3.4 Interceptors ...................................................................................................... 18

3.4.1 Lifecycle Callback Interceptor Methods........................................... 19

3.4.2 Business Method Interceptor Methods ............................................. 19

3.4.3 InvocationContext ............................................................................. 20

3.4.4 Exceptions ......................................................................................... 21

3.5 Home Interfaces............................................................................................... 21

Chapter 4

Stateless Session Beans.................................................................................................. 23

4.1 Requirements for Stateless Session Beans ...................................................... 23

4.1.1 Business Interface ............................................................................. 23

4.1.2 Home Interface.................................................................................. 23

4.1.3 Bean Class......................................................................................... 24

4.1.4 Lifecycle Callbacks for Stateless Session Beans .............................. 24

4.1.5 Dependency Injection........................................................................ 24

4.1.6 Interceptors for Stateless Session Beans ........................................... 24

4.1.6.1 Example .............................................................................. 25

4.2 Client View ...................................................................................................... 26

4.3 Other Requirements......................................................................................... 26

Stateful Session Beans ................................................................................................... 27

5.1 Requirements for Stateful Session Beans........................................................ 27

5.1.1 Business Interface ............................................................................. 27

Chapter 5

5/2/06

Plik z chomika:

nimtiz

Inne pliki z tego folderu:

[HTML][HTML5 Canvas. Graphics. Animation and Game Development].pdf (29804 KB)
[CSS][CSS3 Foundations].pdf (23466 KB)
[JAVASCRIPT][Professional AngularJS].pdf (21169 KB)
[HTML][HTML5 Foundations].pdf (32597 KB)
[JAVASCRIPT][Beginning JavaScript Charts].pdf (19671 KB)

[JAVA][Enterprise JavaBeans 3.0 EJB 3.0 Simplified API].pdf

Plik z chomika:

Inne pliki z tego folderu:

Inne foldery tego chomika: