Identifying and modifying the JPA specification level

Newly created profiles default to the Java Persistence API (JPA) 2.1 specification. You can run AdminTask wsadmin commands to list JPA specifications that are supported by the product and to change the JPA specification that is used by a server, server cluster, or servers that are members of a cluster.

About this task

Avoid trouble Avoid trouble: In the Java EE Application Client environment, only the JPA 2.1 specification, using the EclipseLink bundle that is provided by WebSphere® Application Server, is supported. gotcha
New feature New feature:
newfeat

WebSphere Application Server version 9 supports both the JPA 2.1 and JPA 2.0 specification levels. JPA 2.1 simplifies the management of relational data in applications. You can find information about supported JPA specification levels and JPA providers by using the wsadmin tool or the administrative console. Run the wsadmin AdminTasklistSupportedJPASpecifications command to list JPA specification levels and default JPA providers supported by the product. Run the AdminTask showJPASpecLevel command to identify the JPA specification level used by a cluster or server. Run the AdminTask modifyJPASpecLevel command to change the JPA specification level used by a cluster or server.

Starting with WebSphere Application Server Version 9, Eclipselink is provided as a JPA 2.1 provider implementation and is the default persistence provider when JPA 2.1 is configured to be the active specification level. Before version 9, WSJPA, the IBM JPA provider based on Apache OpenJPA, which supports the JPA 2.0 specification, was the default JPA persistence provider. Because JPA providers differ in both behavior and vendor-specific APIs, and OpenJPA is not available as a JPA 2.1 specification implementation, the product provides a JPA 2.0 specification compatibility mode.

The product bundles the following JPA persistence providers:
  • Eclipselink 2.6.x_WAS (default for the JPA 2.1 specification)
  • WSJPA 2.2.x (default for the JPA 2.0 specification)
You can use third-party JPA providers as mandated by the JPA specification. The third-party JPA provider implementation must match the enabled JPA specification level.

Procedure


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: March 5, 2017 17:27
File name: tejb_idmod_jpaspec.html