openjpa-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From allee8...@apache.org
Subject svn commit: r1465092 - in /openjpa/site/trunk: content/ templates/
Date Fri, 05 Apr 2013 18:41:32 GMT
Author: allee8285
Date: Fri Apr  5 18:41:32 2013
New Revision: 1465092

URL: http://svn.apache.org/r1465092
Log:
Add Consumers topic with tip and techniques, best practices and trouble shooting sections.

Added:
    openjpa/site/trunk/content/best-practices.mdtext
    openjpa/site/trunk/content/consumers.mdtext
    openjpa/site/trunk/content/detached.state.serialization.mdtext
    openjpa/site/trunk/content/tips-n-techniques.mdtext
    openjpa/site/trunk/content/troubleshoot.mdtext
Modified:
    openjpa/site/trunk/content/site-index.mdtext
    openjpa/site/trunk/templates/standard.html

Added: openjpa/site/trunk/content/best-practices.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/best-practices.mdtext?rev=1465092&view=auto
==============================================================================
--- openjpa/site/trunk/content/best-practices.mdtext (added)
+++ openjpa/site/trunk/content/best-practices.mdtext Fri Apr  5 18:41:32 2013
@@ -0,0 +1,6 @@
+Title: Best Practices
+<a name="Best.Practics"></a>
+# OpenJPA Best Practices
+
+* [TBD](best-practices.html) &mdash; <SPAN class="smalltext">TBD</SPAN> 
                          
+

Added: openjpa/site/trunk/content/consumers.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/consumers.mdtext?rev=1465092&view=auto
==============================================================================
--- openjpa/site/trunk/content/consumers.mdtext (added)
+++ openjpa/site/trunk/content/consumers.mdtext Fri Apr  5 18:41:32 2013
@@ -0,0 +1,9 @@
+Title: Consumers
+<a name="Consumers-Overview"></a>
+
+# Consumers Overview
+
+* [Best Practices](best-practices.html) &mdash; <SPAN class="smalltext">Best Practices
</SPAN>                            
+* [Tips and Techniques](tips-n-techniques.html) &mdash; <SPAN class="smalltext">Tips
and Techniques</SPAN>
+* [Trouble Shoot](troubleshoot.html) &mdash; <SPAN class="smalltext">Trouble Shooting
OpenJPA Problems</SPAN>
+ 
\ No newline at end of file

Added: openjpa/site/trunk/content/detached.state.serialization.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/detached.state.serialization.mdtext?rev=1465092&view=auto
==============================================================================
--- openjpa/site/trunk/content/detached.state.serialization.mdtext (added)
+++ openjpa/site/trunk/content/detached.state.serialization.mdtext Fri Apr  5 18:41:32 2013
@@ -0,0 +1,57 @@
+Title: Detached State Serialization
+# Detached State Serialization
+
+## Symptom:
+
+OpenJPA requires persistence entities to be enhanced to support JPA semantics. If the client
and server are in
+two separate JVMs and entities are serialized/de-serialized in the transport layer, one may
encountered
+the following problem when:
+
+ * entities are **NOT** enhanced on the client,
+ * &lt;property name="openjpa.DetachState" value="fetch-groups(DetachedStateField=true)"/&gt;
is specified for the persistence context.
+
+&#20;
+
+    [err] javax.jms.MessageFormatException: CWSIA0122E: An exception occurred deserializing
a message, exception: \ 
+            java.io.InvalidClassException: com.ibm.wssvt.acme.annuity.common.bean.jpa.AbstractPersistebleObject;
\
+            Serializable incompatible with Externalizable.
+    [err]     at com.ibm.ws.sib.api.jms.impl.JmsObjectMessageImpl.getObject(JmsObjectMessageImpl.java:271)
+    [err]     at com.ibm.wssvt.acme.annuity.business.impl.ejb30mdb.AcmeAnnuityMgmtSvcEJB30MDBBean.validateInputMessage
\
+                  (AcmeAnnuityMgmtSvcEJB30MDBBean.java:173)
+    [err]     at com.ibm.wssvt.acme.annuity.business.impl.ejb30mdb.AcmeAnnuityMgmtSvcEJB30MDBBean.onMessage
\
+                  (AcmeAnnuityMgmtSvcEJB30MDBBean.java:67)
+    [err]     at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
+    [err]     at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:60)
+    [err]     at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:37)
+    [err]     at java.lang.reflect.Method.invoke(Method.java:611)
+    [err]     at [internal classes]
+    [err] Caused by: 
+    [err] java.io.InvalidClassException: com.ibm.wssvt.acme.annuity.common.bean.jpa.AbstractPersistebleObject;
\
+            Serializable incompatible with Externalizable
+    [err]     at java.io.ObjectStreamClass.initNonProxy(ObjectStreamClass.java:647)
+    [err]     at java.io.ObjectInputStream.readNonProxyDesc(ObjectInputStream.java:1600)
+    [err]     at java.io.ObjectInputStream.readClassDesc(ObjectInputStream.java:1513)
+    [err]     at java.io.ObjectInputStream.readNonProxyDesc(ObjectInputStream.java:1600)
+    [err]     at java.io.ObjectInputStream.readClassDesc(ObjectInputStream.java:1513)
+    [err]     at java.io.ObjectInputStream.readNonProxyDesc(ObjectInputStream.java:1600)
+    [err]     at java.io.ObjectInputStream.readClassDesc(ObjectInputStream.java:1513)
+    [err]     at java.io.ObjectInputStream.readOrdinaryObject(ObjectInputStream.java:1749)
+    [err]     at java.io.ObjectInputStream.readObject0(ObjectInputStream.java:1346)
+    [err]     at java.io.ObjectInputStream.defaultReadFields(ObjectInputStream.java:1964)
+    [err]     at java.io.ObjectInputStream.readSerialData(ObjectInputStream.java:1888)
+    [err]     at java.io.ObjectInputStream.readOrdinaryObject(ObjectInputStream.java:1770)
+    [err]     at java.io.ObjectInputStream.readObject0(ObjectInputStream.java:1346)
+    [err]     at java.io.ObjectInputStream.readObject(ObjectInputStream.java:365)
+    [err]     at com.ibm.ws.sib.api.jms.impl.JmsObjectMessageImpl.getObjectInternal(JmsObjectMessageImpl.java:344)
+    [err]     at [internal classes]
+    [err]     ... 22 more
+
+## Solution
+
+When `DetachedStateField=true` option is specified, the client application intends to take
advantage of the detached entity 
+field update management feature provided by OpenJPA. This requires entities to be enhanced
and OpenJPA runtime
+be accessible by the application. If application does not have or require the enhanced entity
or OpenJPA runtime
+on the client side, `DetachedStateField=[false|transient]` option should be used.
+ 
+See [DetachedStateField options](http://ci.apache.org/projects/openjpa/trunk/docbook/manual.html#ref_guide_detach_graph)
section for
+details of the `DetachedStateField` options as well the enhancement and runtime requirements.
 
\ No newline at end of file

Modified: openjpa/site/trunk/content/site-index.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/site-index.mdtext?rev=1465092&r1=1465091&r2=1465092&view=diff
==============================================================================
--- openjpa/site/trunk/content/site-index.mdtext (original)
+++ openjpa/site/trunk/content/site-index.mdtext Fri Apr  5 18:41:32 2013
@@ -111,6 +111,11 @@ Title: Site Index
  <BR>
  <DIV class="smalltext" style="margin: 0 0 0 36px">Intro to tuning OpenJPA     OpenJPA
Beginners Performance Guide  This guide is targeted at new users of OpenJPA that would like
to know some of the important performance tuning properties. Please do not mistake this for
an exhaustive tuning guide. This is just enough information ... </DIV>
  
+ <IMG src="images/docs_16.gif" height="16" width="16" border="0" align="absmiddle" title="Best
Practics">
+ <A href="best-practices.html">Best Practics</A>
+ <BR>
+ <DIV class="smalltext" style="margin: 0 0 0 36px">List of OpenJPA best practices for
optimial useage.</DIV>
+ 
  <IMG src="images/docs_16.gif" height="16" width="16" border="0" align="absmiddle" title="Build
and Runtime Dependencies">
  <A href="build-and-runtime-dependencies.html">Build and Runtime Dependencies</A>
  <BR>
@@ -148,6 +153,11 @@ Title: Site Index
  <BR>
  <DIV class="smalltext" style="margin: 0 0 0 36px">Community</DIV>
  
+ <IMG src="images/docs_16.gif" height="16" width="16" border="0" align="absmiddle" title="Consumers
Top Link">
+ <A href="consumers.html">Consumers Top Link</A>
+ <BR>
+ <DIV class="smalltext" style="margin: 0 0 0 36px">Consumers</DIV>
+ 
  </TD>
  </TR><TR valign="top">
  <td class="border"><H4 style="margin-top: 0px"><A name="index-D"></A>D</H4>
@@ -646,6 +656,11 @@ Title: Site Index
  <BR>
  <DIV class="smalltext" style="margin: 0 0 0 36px">Thanks to helpful people and organizations
 The Apache OpenJPA team would like to thank the following individuals and organizations.
   Apache Sponsors Without those sponsors, the ASF would simply not exist or sustain its activities
: http://www.apache.org/foundation/thanks.html  For those ... </DIV>
 
+ <IMG src="images/docs_16.gif" height="16" width="16" border="0" align="absmiddle" title="Tips
and Techniques">
+ <A href="tips-n-techniques.html">Tips and Techniques</A>
+ <BR>
+ <DIV class="smalltext" style="margin: 0 0 0 36px">Tips and techniques to maximize
OpenJPA useage.</DIV>
+
  <IMG src="images/docs_16.gif" height="16" width="16" border="0" align="absmiddle" title="Tools">
  <A href="tools.html">Tools</A>
  <BR>
@@ -655,7 +670,13 @@ Title: Site Index
  <A href="top-navigation-bar.html">Top Navigation Bar</A>
  <BR>
  <DIV class="smalltext" style="margin: 0 0 0 36px"></DIV>
- </TD>
+ 
+ <IMG src="images/docs_16.gif" height="16" width="16" border="0" align="absmiddle" title="Trouble
Shooting OpenJPA problems">
+ <A href="troubleshoot.html">Trouble Shooting OpenJPA problems.</A>
+ <BR>
+ <DIV class="smalltext" style="margin: 0 0 0 36px">List of documents for trouble shooting
OpenJPA problems.</DIV>
+</TD>
+ 
  <td class="border"><H4 style="margin-top: 0px"><A name="index-U"></A>U</H4>
 
  <IMG src="images/docs_16.gif" height="16" width="16" border="0" align="absmiddle" title="Update
release text files">

Added: openjpa/site/trunk/content/tips-n-techniques.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/tips-n-techniques.mdtext?rev=1465092&view=auto
==============================================================================
--- openjpa/site/trunk/content/tips-n-techniques.mdtext (added)
+++ openjpa/site/trunk/content/tips-n-techniques.mdtext Fri Apr  5 18:41:32 2013
@@ -0,0 +1,6 @@
+Title: Tips and Techniques
+<a name="Tips.n.Techniques"></a>
+# Tips and Techniquies
+
+* [TBD](tips-n-techniques.html) &mdash; <SPAN class="smalltext">TBD</SPAN>
                           
+  

Added: openjpa/site/trunk/content/troubleshoot.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/troubleshoot.mdtext?rev=1465092&view=auto
==============================================================================
--- openjpa/site/trunk/content/troubleshoot.mdtext (added)
+++ openjpa/site/trunk/content/troubleshoot.mdtext Fri Apr  5 18:41:32 2013
@@ -0,0 +1,5 @@
+Title: Trouble Shoot
+<a name="Trouble.Shoot"></a>
+# Trouble Shooting OpenJPA Problems
+
+* [Detached State Serialization](detached.state.serialization.html) &mdash; <SPAN
class="smalltext">Detached State Serialization</SPAN>                           


Modified: openjpa/site/trunk/templates/standard.html
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/templates/standard.html?rev=1465092&r1=1465091&r2=1465092&view=diff
==============================================================================
--- openjpa/site/trunk/templates/standard.html (original)
+++ openjpa/site/trunk/templates/standard.html Fri Apr  5 18:41:32 2013
@@ -119,6 +119,14 @@ limitations under the License.
                                                             <li><a href="release-management.html"
title="Release Management">Release Management</a></li>
                                                         </ul>
 
+                                                        <h3><a name="SideNav-Consumers"></a><a
href="consumers.html" title="Consumers">ConsumTrouble Shooters</a></h3>
+
+                                                        <ul class="alternate" type="square">
+                                                            <li><a href="best-practices.html"
title="Best Practices">Best Practices</a></li>                            
           
+                                                            <li><a href="tips-n-techniques.html"
title="Tips and Techniques">Tips and Techniques</a></li>
+                                                            <li><a href="troubleshoot.html"
title="Trouble Shoot">Trouble Shoot</a></li>
+                                                        </ul>
+
                                                         <h3>Search</h3>
 
                                                         <div style="padding: 5px 5px 0px
25px;">



Mime
View raw message