6-2 Programming Enterprise JavaBeans, Version 3.0, for Oracle WebLogic Server
requirements described in Integrating TopLink with an Application Server in the same document.
6.3 Using JPA 2.0 with TopLink in WebLogic Server
When you use Oracle TopLink as the persistence provider in this release of WebLogic Server, you can install a patch that provides support for Java Persistence Architecture
JPA 2.0.
JPA 2.0 includes improvements and enhancements to domain modeling, objectrelational mapping, EntityManager and Query interfaces, and the Java
Persistence Query Language JPQL. It includes a new API for criteria queries, a metamodel API, and support for validation. For the JPA 2.0 Specification, see
JSR-000317 Java Persistence 2.0 Final Release at
http:jcp.orgaboutJavacommunityprocessfinaljsr317index.htm l
.
To use JPA 2.0 in this release of WebLogic Server, do the following:
1.
Use Oracle TopLink as the persistence provider, as described in Integrating TopLink with Oracle WebLogic Server in Oracle Fusion Middleware Developers
Guide for Oracle TopLink.
2.
Install the patch, using either of the following two methods.
■
Section 6.3.1, Installing Using Smart Update
■
Section 6.3.2, Installing Manually
6.3.1 Installing Using Smart Update
Oracle Smart Update is a standalone Java application that simplifies the process of applying patches to your WebLogic Server installation. It is automatically installed in
the Middleware home directory. You must have an active My Oracle Support account to use Smart Update.
To install the patch using Smart Update, do the following:
1. Ensure that you are logged in to My Oracle Support. For information, see
http:\\support.oracle.com .
2. Start Smart Update, as described in Starting Smart Update.
3. In the Target Installation panel of the main Smart Update window, select the target
installation.
4. Select the Get Patches tab.
5. In the available patches panel, select the check box for patch QWG8 - Enable JPA
2.0 support on WebLogic Server .
6. Click Download Selected.
Note: Support for JPA 2.0 in WebLogic Server is provided as a patch,
because JPA 2.0 is part of Java Platform, Enterprise Edition Java EE 6. Therefore, enabling JPA 2.0 support in the current release results in
WebLogic Server not meeting all Java EE 5 compatibility requirements. To maintain Java EE 5 compatibility in the current
release, the files required for the support are not enabled by default, although they are included in a standard WebLogic Server installation.
Using Oracle TopLink with Oracle WebLogic Server 6-3
7. Select the Manage Patches tab.
8. In the Downloaded Patches panel, select the patch, then click the Up Arrow button
under Apply.
For more information on using Smart Update, see Oracle Smart Update Installing Patches and Maintenance Packs.
Using Smart Update to apply the the patch does the following:
■
A folder FMW_HOMEpatch_wls1034 is created, and the patch files are copied to that directory.
■
FMW_HOME \patch_wls1034\profiles\default\sys_manifest_
classpath\weblogic_patch.jar is added in the CLASSPATH by FMW_ HOME
wlserver_10.3\common\bin\setPatchEnv.cmd.
■
You can use the standard startWeblogic.cmd or startWeblogic.sh to start the server. No further modification is required.
■
If you use a custom script to start the server, you may need to put FMW_ HOME
\javax.persistence_1.0.0.0_2-0-0.jar;wls_ modules\com.oracle.jpa2support_1.0.0.0_2-0.jar or FMW_
HOME \patch_wls1034\profiles\default\sys_manifest_
classpath\weblogic_patch.jar at the beginning of CLASSPATH. See Section 6.3.2, Installing Manually,
