openjpa-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Patrick Linskey (JIRA)" <j...@apache.org>
Subject [jira] Updated: (OPENJPA-404) Backward-compatibility for pre-1.0 APIs
Date Tue, 16 Oct 2007 16:57:51 GMT

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

Patrick Linskey updated OPENJPA-404:
------------------------------------

    Attachment: OPENJPA-404.patch

This patch introduces deprecated methods for most of the methods that were removed or modified
in OPENJPA-317.

It re-introduces symbolic constants that were removed, but does so by directly listing the
symbolic constants to the appropriate and marking them as deprecated, instead of making the
interfaces extend the symbolic-constant interfaces.

OpenJPAEntityManager now extends EntityTransaction. Sadly, there is no language-enforced way
to mark this as deprecated that I know of, so I've noted the deprecation in the JavaDoc. 

The following thirteen methods changed only in their return type, so the old method signature
could not be re-introduced. The - prefix denotes the pre-1.0 syntax; the + syntax denotes
the 1.0-and-later syntax.

OpenJPAEntityManager {
-    public int getConnectionRetainMode();
+    public ConnectionRetainMode getConnectionRetainMode();
-    public int getRestoreState();
+    public RestoreStateType getRestoreState();
-    public int getDetachState();
+    public DetachStateType getDetachState();
-    public int getAutoClear();
+    public AutoClearType getAutoClear();
-    public int getAutoDetach();
+    public EnumSet<AutoDetachType> getAutoDetach();
}

OpenJPAQuery {
-    public int getOperation();
+    public QueryOperationType getOperation();
}

JDBCFetchPlan {
-    public int getEagerFetchMode();
+    public FetchMode getEagerFetchMode();
-    public int getSubclassFetchMode();
+    public FetchMode getSubclassFetchMode();
-    public int getResultSetType();
+    public ResultSetType getResultSetType();
-    public int getFetchDirection();
+    public FetchDirection getFetchDirection();
-    public int getJoinSyntax();
+    public JoinSyntax getJoinSyntax();
}

EagerFetchMode {
-    EagerFetchType value() default EagerFetchType.NONE;
+    FetchMode value() default FetchMode.NONE;
}

SubclassFetchMode {
-    EagerFetchType value() default EagerFetchType.NONE;
+    FetchMode value() default FetchMode.NONE;
}

> Backward-compatibility for pre-1.0 APIs
> ---------------------------------------
>
>                 Key: OPENJPA-404
>                 URL: https://issues.apache.org/jira/browse/OPENJPA-404
>             Project: OpenJPA
>          Issue Type: New Feature
>    Affects Versions: 1.0.0
>            Reporter: Patrick Linskey
>             Fix For: 1.1.0
>
>         Attachments: OPENJPA-404.patch
>
>
> When I changed the OpenJPA APIs before the 1.0 release, I made a number of incompatible
changes. At the time, we deemed that this was fine since 1.0 was the first OpenJPA release.
However, it turns out that this runs up against BEA policy, since BEA shipped a product using
a build from around 0.9.7. So, we'd like to do some work to address this where possible.

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


Mime
View raw message