WebSphere Liberty Beta: JPA 2.2 and JSF 2.3 Updates

Java Persistence API 2.2 (JPA 2.2)

Updated to support new features introduced in Java 8, including the new Java Date and Time API, Query Result Collection streaming, repeatable JPA annotations.

Java 8 introduced a new Date and Time API, which is more powerful than the old APIs part of java.util for years. Collection streaming, introduced in Java 8, is now formally supported by the JPA 2.2 specification, enabling new ways to process query result sets. Many JPA annotations are now repeatable, eliminating the need to use grouping annotations.

Simply add <feature>jpa-2.2</feature> to the server.xml‘s <featureManager> list to enable the JPA 2.2 spec level and the Eclipselink 2.7 JPA persistence provider bundled with the feature. If you wish to use your own Eclipselink 2.7 binaries, you can instead enable the <feature>jpaContainer-2.2</feature> feature which provides JPA 2.2 container integration but does not enable the provided Eclipselink JPA provider implementation.

Examples of JPA 2.2 Enhancements

@Repeatable Annotations (before JPA 2.2):

@PersistenceContexts(
    @PersistenceContext(name=“foo”, unitName=“bar”),
    @PersistenceContext(name=“cloud”, unitName=“sky”))
@Stateless
public class SomeEJB {
…

@Repeatable Annotations (with JPA 2.2):

@PersistenceContext(name=“foo”, unitName=“bar”),
@PersistenceContext(name=“cloud”, unitName=“sky”)
@Stateless
public class SomeEJB {
…

JPA 2.2 supports java.time types:

@Entity
public class MyEntity {
…
    // The following map to database time column types natively now
    @Basic private java.time.LocalDate localDate;
    @Basic private java.time.LocalDateTime localDateTime;
    @Basic private java.time.LocalTime localTime;
    @Basic private java.time.OffsetTime offsetTime;
    @Basic private java.time.OffsetDateTime offsetDateTime;
…
}

Attribute Converter classes now support CDI bean injection:

@Converter
public class B2IConverter implements AttributeConverter<Boolean, Integer> {
    final static Integer FALSE = new Integer(0);
    final static Integer TRUE = new Integer(1);
 
    @Inject
    private MyLogger logger;
 
    @Override
    public Integer convertToDatabaseColumn(Boolean b) {
        Integer i = b ? TRUE : FALSE;
        logger.log("Convert: " + b + " -> " + i);
        return i;
    }
 
    @Override
    public Boolean convertToEntityAttribute(Integer i) {
        Boolean b = TRUE.equals(s) ? Boolean.TRUE : Boolean.FALSE;
        logger.log("Convert: " + i + " -> " + b);
        return b;
    }
}

Method Stream getResultStream() added to Query and TypedQuery interfaces:

@Stateless public class SBean {
   @PersistenceContext(unitName=“Personnel”) EntityManager em;
 
   public int getEmployeeSalaryBudget(int deptId) {
      final AtomicInteger salBudget = 0;
 
      TypedQuery<Employee> q = em.createQuery(”SELECT e FROM Employee e WHERE e.deptId = :deptId”, Employee.class);
      q.setParameter(“deptId”, deptId);
 
      Stream<Employee> empStream = q.getResultStream();
      empStream.forEach( t -> salBudget.set(salBudget.get() + t.getSalary()));
 
      return salBudget.get();
   }
}

For more information, see:

• JPA Specification Group
• JPA 2.2 Specification
• Java 2.2 JavaDoc
• Eclipselink

<featureManager>
    <feature>jsf-2.3</feature>
</featureManager>

`GET http://host:http_port/api/docs`
`GET http://host:http_port/api/explorer`

<openapi publicURL="myAPI" />