[ 
https://issues.apache.org/jira/browse/OPENJPA-317?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Patrick Linskey updated OPENJPA-317:
------------------------------------

    Attachment: OPENJPA-317.patch

Patch notes:

Changed OpenJPA published API pre-1.0. Reduced the scope of the dependencies in 
OpenJPAEntityManager and the other published interfaces; converted JDK1.4-style 
symbolic constant usage to new enums; changed some method names for clarity and 
consistency; removed old javax.resource dependencies; updated @published and 
@nojavadoc tags. The published interfaces should now only reference other 
published interfaces in method signatures, and it should be possible to build 
javadoc for just the published interfaces.

Removed getDelegate() calls from the published interfaces, as they expose 
internals. They are still available on the impl classes themselves, or the SPI 
ifaces when available.

To do: 

- covariant types in JDBCFetchPlan interface

- maybe move tx methods to new OpenJPATransaction interface that does not 
extend EntityTransaction? (can't keep in subtype of EntityTx because getTx() 
fails in a JTA context)

- review API emails again

- BrokerFactoryListener changes, other event changes?

We will need to grow these published interfaces to provide access to some 
things in the internal interfaces. However, these interfaces will remain stable 
moving forward within the constraints of the OpenJPA deprecation policies.

> API formalization pre-1.0
> -------------------------
>
>                 Key: OPENJPA-317
>                 URL: https://issues.apache.org/jira/browse/OPENJPA-317
>             Project: OpenJPA
>          Issue Type: New Feature
>          Components: jpa
>    Affects Versions: 0.9.0, 0.9.6, 0.9.7
>            Reporter: Patrick Linskey
>             Fix For: 1.0.0
>
>         Attachments: OPENJPA-317.patch
>
>
> This issue tracks the effort to formalize and optimize our API prior to the 
> 1.0 release.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply via email to