Internally, Kodo does not adhere to any persistence specification. The Kodo kernel has its own set of APIs and components. Specifications like JPA and JDO are simply different "personalities" that can Kodo's native kernel can adopt.

As a Kodo JPA/JDO user, you will not normally see beneath Kodo's JPA and JDO personalities. Kodo allows you to access its feature set without leaving the comfort of JPA or JDO. Where Kodo goes beyond standard functionality, we have crafted JPA-specific and JDO-specific APIs to each Kodo extension for as seamless an experience as possible.

When writing Kodo plugins or otherwise extending the Kodo runtime, however, you will use Kodo's native APIs. So that you won't feel lost, the list below associates each specification interface with its backing native Kodo component:

The org.apache.openjpa.persistence.OpenJPAPersistence helper allows you to convert between EntityManagerFactories and BrokerFactories, EntityManagers and Brokers.

The kodo.jdo.KodoJDOHelper allows you to convert between PersistenceManagerFactories and BrokerFactories, PersistenceManagers and Brokers.

As a Kodo JPA/JDO user, you can use these methods to move from an JPA to a JDO persistence API (or vice versa) at any time. You can even switch back and forth within the same persistence context, as the following example illustrates:

EntityManager em = ...;
em.getTransaction ().begin ();

Magazine mag = em.find (Magazine.class, magId);
setHigherSellers (mag);

em.getTransaction ().commit ();
em.close ();

...

private void setHigherSellers (Magazine mag)
{
    // or we could get the EM using OpenJPAPersistence, convert it to a Broker,
    // and convert the Broker to a PM using KodoJDOHelper. this is easier
    PersistenceManager pm = JDOHelper.getPersistenceManager (mag);
    Query q = pm.newQuery (Magazine.class, "sales > :s");
    List results = (List) q.execute (mag.getSales ());
    mag.setHigherSellingMagazines (new HashSet (results)); 
}

<property name="kodo.BrokerImpl" value="EvictFromDataCache=true"/>

kodo.BrokerImpl: EvictFromDataCache=true