mirror of https://github.com/apache/openjpa.git
OPENJPA-1520. Doc updates to point at appropriate javase 6 and javaee 6 api urls (instead of javase/ee 5 urls).
git-svn-id: https://svn.apache.org/repos/asf/openjpa/trunk@911608 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
parent
88e32fb2ee
commit
babda8d218
|
@ -299,7 +299,7 @@ appropriate, most notably <classname>IllegalArgumentException</classname>s and
|
|||
<classname>IllegalStateException</classname>s. The specification also provides
|
||||
a few JPA-specific exceptions in the <literal>javax.persistence</literal>
|
||||
package. These exceptions should be self-explanatory. See the
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api">Javadoc</ulink> for
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api">Javadoc</ulink> for
|
||||
additional details on JPA exceptions.
|
||||
</para>
|
||||
<note>
|
||||
|
|
|
@ -37,7 +37,7 @@
|
|||
The diagram above presents an overview of the <classname>EntityManager
|
||||
</classname> interface. For a complete treatment of the <classname>
|
||||
EntityManager</classname> API, see the
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/EntityManager.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/EntityManager.html">
|
||||
Javadoc</ulink> documentation. Methods whose parameter signatures consist of
|
||||
an ellipsis (...) are overloaded to take multiple parameter types.
|
||||
</para>
|
||||
|
@ -515,7 +515,7 @@ public void lock(Object entity, LockModeType mode);
|
|||
</seealso>
|
||||
</indexterm>
|
||||
This method locks the given entity using the named mode. The
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/LockmodeType.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/LockmodeType.html">
|
||||
<classname>javax.persistence.LockModeType</classname></ulink> enum defines two
|
||||
modes:
|
||||
</para>
|
||||
|
@ -916,7 +916,7 @@ The <classname>EntityManager</classname>'s <literal>FlushMode</literal> property
|
|||
controls whether to flush transactional changes before executing queries. This
|
||||
allows the query results to take into account changes you have made during the
|
||||
current transaction. Available
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/FlushModeType.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/FlushModeType.html">
|
||||
<classname>javax.persistence.FlushModeType</classname></ulink> constants are:
|
||||
</para>
|
||||
<itemizedlist>
|
||||
|
|
|
@ -1069,7 +1069,7 @@ lifecycle events and their corresponding method markers are:
|
|||
lifecycle callbacks
|
||||
</seealso>
|
||||
</indexterm>
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/PrePersist.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/PrePersist.html">
|
||||
<classname>PrePersist</classname></ulink>: Methods marked with this annotation
|
||||
will be invoked before an object is persisted. This could be used for assigning
|
||||
primary key values to persistent objects. This is equivalent to the XML element
|
||||
|
@ -1086,7 +1086,7 @@ tag <literal>pre-persist</literal>.
|
|||
lifecycle callbacks
|
||||
</seealso>
|
||||
</indexterm>
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/PostPersist.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/PostPersist.html">
|
||||
<classname>PostPersist</classname></ulink>: Methods marked with this annotation
|
||||
will be invoked after an object has transitioned to the persistent state. You
|
||||
might want to use such methods to update a screen after a new row is added. This
|
||||
|
@ -1103,7 +1103,7 @@ is equivalent to the XML element tag <literal>post-persist</literal>.
|
|||
lifecycle callbacks
|
||||
</seealso>
|
||||
</indexterm>
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/PostLoad.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/PostLoad.html">
|
||||
<classname>PostLoad</classname></ulink>: Methods marked with this annotation
|
||||
will be invoked after all eagerly fetched fields of your class have been loaded
|
||||
from the datastore. No other persistent fields can be accessed in this method.
|
||||
|
@ -1125,7 +1125,7 @@ data structure.
|
|||
lifecycle callbacks
|
||||
</seealso>
|
||||
</indexterm>
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/PreUpdate.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/PreUpdate.html">
|
||||
<classname>PreUpdate</classname></ulink>: Methods marked with this annotation
|
||||
will be invoked just the persistent values in your objects are flushed to the
|
||||
datastore. This is equivalent to the XML element tag <literal>
|
||||
|
@ -1149,7 +1149,7 @@ persistent fields with information cached in non-persistent data.
|
|||
lifecycle callbacks
|
||||
</seealso>
|
||||
</indexterm>
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/PostUpdate.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/PostUpdate.html">
|
||||
<classname>PostUpdate</classname></ulink>: Methods marked with this annotation
|
||||
will be invoked after changes to a given instance have been stored to the
|
||||
datastore. This is useful for clearing stale data cached at the application
|
||||
|
@ -1166,7 +1166,7 @@ layer. This is equivalent to the XML element tag <literal>post-update</literal>.
|
|||
lifecycle callbacks
|
||||
</seealso>
|
||||
</indexterm>
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/PreRemove.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/PreRemove.html">
|
||||
<classname>PreRemove</classname></ulink>: Methods marked with this annotation
|
||||
will be invoked before an object transactions to the deleted state. Access to
|
||||
persistent fields is valid within this method. You might use this method to
|
||||
|
@ -1185,7 +1185,7 @@ pre-remove</literal>.
|
|||
lifecycle callbacks
|
||||
</seealso>
|
||||
</indexterm>
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/PostRemove.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/PostRemove.html">
|
||||
<classname>PostRemove</classname></ulink>: Methods marked with this annotation
|
||||
will be invoked after an object has been marked as to be deleted. This is
|
||||
equivalent to the XML element tag <literal>post-remove</literal>.
|
||||
|
|
|
@ -68,7 +68,7 @@ additional utility methods.
|
|||
Within a container, you will typically use <emphasis>injection</emphasis> to
|
||||
access an <classname>EntityManagerFactory</classname>. Applications operating
|
||||
outside of a container, however, can use the
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/Persistence.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/Persistence.html">
|
||||
<classname>Persistence</classname></ulink> class to obtain <classname>
|
||||
EntityManagerFactory</classname> objects in a vendor-neutral fashion.
|
||||
</para>
|
||||
|
@ -456,7 +456,7 @@ transaction management.
|
|||
<para>
|
||||
<literal>provider</literal>: If you are using a third-party JPA vendor, this
|
||||
element names its implementation of the
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/spi/PersistenceProvider.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/spi/PersistenceProvider.html">
|
||||
<classname>PersistenceProvider</classname></ulink> bootstrapping interface.
|
||||
</para>
|
||||
<note>
|
||||
|
|
|
@ -74,7 +74,7 @@ public Query createQuery(String jpql);
|
|||
</programlisting>
|
||||
<para>
|
||||
The
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/EntityManager.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/EntityManager.html">
|
||||
<methodname>EntityManager.createQuery</methodname></ulink> method creates a
|
||||
<classname>Query</classname> instance from a given JPQL string.
|
||||
</para>
|
||||
|
@ -83,7 +83,7 @@ public List getResultList();
|
|||
</programlisting>
|
||||
<para>
|
||||
Invoking
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/Query.html#getResultList()">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/Query.html#getResultList()">
|
||||
<methodname>Query.getResultList</methodname></ulink> executes the query and
|
||||
returns a <classname>List</classname> containing the matching objects. The
|
||||
following example executes our <classname>Magazine</classname> query above:
|
||||
|
|
|
@ -35,7 +35,7 @@ EJB 3 JSR page</ulink>
|
|||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/index.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/index.html">
|
||||
javax.persistence Javadoc</ulink>
|
||||
</para>
|
||||
</listitem>
|
||||
|
|
|
@ -785,7 +785,7 @@ public void evictAll();
|
|||
</programlisting>
|
||||
<para>
|
||||
For JPA queries with parameters, set the desired parameter values into the
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/Query.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/Query.html">
|
||||
<classname>Query</classname></ulink> instance before calling the above methods.
|
||||
</para>
|
||||
<example id="ref_guide_cache_query_classchange">
|
||||
|
@ -829,7 +829,7 @@ public void unpin(Query q);
|
|||
</programlisting>
|
||||
<para>
|
||||
For JPA queries with parameters, set the desired parameter values into the
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/Query.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/Query.html">
|
||||
<classname>Query</classname></ulink> instance before calling the above methods.
|
||||
</para>
|
||||
<para>
|
||||
|
|
|
@ -139,7 +139,7 @@ global transactions.
|
|||
<para>
|
||||
You can override the global transaction mode setting when you obtain an
|
||||
<classname>EntityManager</classname> using the
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/EntityManagerFactory.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/EntityManagerFactory.html">
|
||||
<classname>EntityManagerFactory</classname></ulink>'s
|
||||
<methodname>createEntityManager(Map props)</methodname> method. Simply set the
|
||||
<literal>openjpa.TransactionMode</literal> key of the given <classname>Map
|
||||
|
|
|
@ -658,7 +658,7 @@ Returns the level at which the given object is currently locked.
|
|||
</para>
|
||||
<para>
|
||||
In addition to the standard
|
||||
<ulink url="http://java.sun.com/javaee/5/docs/api/javax/persistence/EntityManager.html">
|
||||
<ulink url="http://java.sun.com/javaee/6/docs/api/javax/persistence/EntityManager.html">
|
||||
<methodname>EntityManager.lock(Object, LockModeType)</methodname></ulink>
|
||||
method, the
|
||||
<ulink url="../javadoc/org/apache/openjpa/persistence/OpenJPAEntityManager.html">
|
||||
|
|
|
@ -534,7 +534,7 @@ the JDBC connection URL of a slice.
|
|||
for database operations such as query or flush on individual slices.
|
||||
The value of the property is a
|
||||
fully-qualified class name that implements
|
||||
<ulink url="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ExecutorService.html">
|
||||
<ulink url="http://java.sun.com/javase/6/docs/api/java/util/concurrent/ExecutorService.html">
|
||||
<classname>java.util.concurrent.ExecutorService</classname>
|
||||
</ulink> interface.
|
||||
Two pre-defined pools can be chosen via their aliases namely
|
||||
|
@ -542,7 +542,7 @@ the JDBC connection URL of a slice.
|
|||
</para>
|
||||
<para>
|
||||
The pre-defined alias <classname>cached</classname> activates a
|
||||
<ulink url="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/Executors.html#newCachedThreadPool()">cached thread pool</ulink>.
|
||||
<ulink url="http://java.sun.com/javase/6/docs/api/java/util/concurrent/Executors.html#newCachedThreadPool()">cached thread pool</ulink>.
|
||||
A cached thread pool creates new threads as needed, but will reuse
|
||||
previously constructed threads when they are available. This pool
|
||||
is suitable in scenarios that execute many short-lived asynchronous tasks.
|
||||
|
@ -552,23 +552,23 @@ the JDBC connection URL of a slice.
|
|||
</para>
|
||||
<para>
|
||||
The <classname>fixed</classname> alias activates a
|
||||
<ulink url="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/Executors.html#newFixedThreadPool(int)">fixed thread pool</ulink>.
|
||||
<ulink url="http://java.sun.com/javase/6/docs/api/java/util/concurrent/Executors.html#newFixedThreadPool(int)">fixed thread pool</ulink>.
|
||||
The fixed thread pool can be further parameterized with
|
||||
<classname>CorePoolSize</classname>, <classname>MaximumPoolSize</classname>,
|
||||
<classname>KeepAliveTime</classname> and <classname>RejectedExecutionHandler</classname>.
|
||||
The meaning of these parameters are described in
|
||||
<ulink url="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ThreadPoolExecutor.html">JavaDoc</ulink>.
|
||||
<ulink url="http://java.sun.com/javase/6/docs/api/java/util/concurrent/ThreadPoolExecutor.html">JavaDoc</ulink>.
|
||||
The users can exercise finer control on thread pool behavior via these
|
||||
parameters.
|
||||
By default, the core pool size is <classname>10</classname>, maximum pool size is
|
||||
also <classname>10</classname>, keep alive time is <classname>60</classname> seconds and
|
||||
rejected execution is
|
||||
<ulink url="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ThreadPoolExecutor.AbortPolicy.html">aborted</ulink>.
|
||||
<ulink url="http://java.sun.com/javase/6/docs/api/java/util/concurrent/ThreadPoolExecutor.AbortPolicy.html">aborted</ulink>.
|
||||
</para>
|
||||
<para>
|
||||
Both of the pre-defined aliases can be parameterized with a fully-qualified
|
||||
class name that implements
|
||||
<ulink url="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ThreadFactory.html">
|
||||
<ulink url="http://java.sun.com/javase/6/docs/api/java/util/concurrent/ThreadFactory.html">
|
||||
<classname>java.util.concurrent.ThreadFactory</classname>
|
||||
</ulink> interface.
|
||||
</para>
|
||||
|
|
Loading…
Reference in New Issue