openjpa-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From curti...@apache.org
Subject svn commit: r1412141 - in /openjpa/site/trunk: WhoIsWorkingOnWhat.txt content/faq.mdtext content/fetch-statistics.mdtext content/verifying-release-signatures.mdtext content/websphere-application-server.mdtext
Date Wed, 21 Nov 2012 15:05:11 GMT
Author: curtisr7
Date: Wed Nov 21 15:05:10 2012
New Revision: 1412141

URL: http://svn.apache.org/viewvc?rev=1412141&view=rev
Log:
wiki updates

Modified:
    openjpa/site/trunk/WhoIsWorkingOnWhat.txt
    openjpa/site/trunk/content/faq.mdtext
    openjpa/site/trunk/content/fetch-statistics.mdtext
    openjpa/site/trunk/content/verifying-release-signatures.mdtext
    openjpa/site/trunk/content/websphere-application-server.mdtext

Modified: openjpa/site/trunk/WhoIsWorkingOnWhat.txt
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/WhoIsWorkingOnWhat.txt?rev=1412141&r1=1412140&r2=1412141&view=diff
==============================================================================
--- openjpa/site/trunk/WhoIsWorkingOnWhat.txt (original)
+++ openjpa/site/trunk/WhoIsWorkingOnWhat.txt Wed Nov 21 15:05:10 2012
@@ -32,8 +32,8 @@ done			enhancement-with-eclipse.mdtext
 done			enhancement-with-maven.mdtext
 done			entity-enhancement.mdtext
 			events-and-news.mdtext
-			faq.mdtext
-rgcurtis		fetch-statistics.mdtext
+done			faq.mdtext
+done			fetch-statistics.mdtext
 			findbugs-presentation-notes.mdtext
 done			found-a-bug.mdtext
 done			get-involved.mdtext
@@ -124,8 +124,8 @@ done			tools.mdtext
 			top-navigation-bar.mdtext
 			update-release-text-files.mdtext
 			using-criteria-api-in-daytrader.mdtext
-			verifying-release-signatures.mdtext
-rgcurtis		websphere-application-server.mdtext
+done			verifying-release-signatures.mdtext
+done			websphere-application-server.mdtext
 delete?			whither-openjpa.mdtext
 delete?			wiki.mdtext
 done			writing-test-cases-for-openjpa.mdtext

Modified: openjpa/site/trunk/content/faq.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/faq.mdtext?rev=1412141&r1=1412140&r2=1412141&view=diff
==============================================================================
--- openjpa/site/trunk/content/faq.mdtext (original)
+++ openjpa/site/trunk/content/faq.mdtext Wed Nov 21 15:05:10 2012
@@ -1,74 +1,72 @@
 Title: FAQ
-{excerpt:hidden=true}Frequently Asked Questions about the OpenJPA
-project{excerpt}
-
-<a name="FAQ-FAQ"></a>
-# FAQ
-
-{toc:style=disc|indent=20px|minLevel=2}
 
 <a name="FAQ-General"></a>
 ## General
+* [What is OpenJPA?](#what)
+* [What is the history of OpenJPA?](#history)
+* [What is the current relationship between Kodo and OpenJPA?](#kodo)
+* [What is the current status of the project?](#status)
+* [Where can I download OpenJPA?](#download)
+* [Does OpenJPA work with my application server or container?](#server)
+* [How can I contribute to OpenJPA?](#contribute)
+* [How do I enable connection pooling in OpenJPA?](#pooling)
+* [How do I figure out which version of OpenJPA I am running?](#version)
+* [How do I see the SQL that OpenJPA is executing?](#sql)
+* [Can OpenJPA reorder SQL statements to satisfy database foreign key constraints?](#reorder)
+* [Can OpenJPA map a one-sided one-many association without a cross table?](#crosstable)
 
-<a name="FAQ-WhatisOpenJPA?"></a>
-### What is OpenJPA?
+<a name="what"></a>
+## What is OpenJPA?
 
 OpenJPA is a 100% open-source implementation of the Java Persistence API
 (JPA), which is the persistence component for EJB in the [Java EE 5 specification](http://java.sun.com/javaee/)
 .
 
-<a name="FAQ-WhatisthehistoryofOpenJPA?"></a>
-### What is the history of OpenJPA?
-
-OpenJPA has its roots in the popular Kodo product, which was created by
-SolarMetric, Inc. in 2001. BEA Systems, Inc. purchased SolarMetric in
-November of 2005, and soon thereafter [announced](http://dev2dev.bea.com/pub/a/2006/02/interview-kodo-opensource.html)
- that they would be donating the bulk of the code to the Apache Software
-Foundation. OpenJPA is the result of that donation.
+<a name="history"></a>
+## What is the history of OpenJPA?
+OpenJPA has its roots in the popular Kodo product, which was created by SolarMetric, Inc.
in 2001. BEA Systems, Inc. 
+purchased SolarMetric in November of 2005, and soon thereafter announced that they would
be donating the bulk of the code to the Apache Software Foundation. OpenJPA is the result
of that donation.
 
-<a name="FAQ-WhatisthecurrentrelationshipbetweenKodoandOpenJPA?"></a>
-### What is the current relationship between Kodo and OpenJPA?
+<a name="kodo"></a>
+## What is the current relationship between Kodo and OpenJPA?
 
 Version 4.1 of Kodo will be based on the OpenJPA code base.
 
-<a name="FAQ-Whatisthecurrentstatusoftheproject?"></a>
-### What is the current status of the project?
+<a name="status"></a>
+## What is the current status of the project?
 
 OpenJPA is a top-level project at the Apache Software Foundation.
 
-<a name="FAQ-WherecanIdownloadOpenJPA?"></a>
-### Where can I download OpenJPA?
+<a name="download"></a>
+## Where can I download OpenJPA?
 
-Look at the [Downloads](downloads.html)
- page.
+Look at the [Downloads](downloads.html) page.
 
-<a name="FAQ-DoesOpenJPAworkwithmyapplicationserverorcontainer?"></a>
-### Does OpenJPA work with my application server or container?
+<a name="server"></a>
+## Does OpenJPA work with my application server or container?
 
 See [Integration](integration.html)
 .
 
-<a name="FAQ-HowcanIcontributetoOpenJPA?"></a>
-### How can I contribute to OpenJPA?
+<a name="contribute"></a>
+## How can I contribute to OpenJPA?
 
 Check out the [Get Involved](get-involved.html)
  page.
 
-<a name="FAQ-Technical"></a>
-## Technical
-
-<a name="FAQ-HowdoIfigureoutwhichversionofOpenJPAIamrunning?"></a>
-### How do I figure out which version of OpenJPA I am running?
+<a name="version"></a>
+## How do I figure out which version of OpenJPA I am running?
 
 You can get version number and other details of OpenJPA jar you are using
 by:
 
 
     
-    h3. How do I see the SQL that OpenJPA is executing?
+<a name="sql"></a>
+## How do I see the SQL that OpenJPA is executing?
     
-    OpenJPA provides configurable channel-based logging, as described in the
-chapter on [Logging|http://openjpa.apache.org/builds/latest/docs/manual/manual.html#ref_guide_logging]
+OpenJPA provides configurable channel-based logging, as described in the
+chapter on [Logging](http://openjpa.apache.org/builds/latest/docs/manual/manual.html#ref_guide_logging)
 . The simplest example of enabling verbose logging is by using the
 following property in your {{persistence.xml}} file:
     
@@ -86,8 +84,8 @@ transaction-type="RESOURCE_LOCAL">
 
 
 
-<a name="FAQ-HowdoIenableconnectionpoolinginOpenJPA?"></a>
-### How do I enable connection pooling in OpenJPA?
+<a name="pooling"/>
+## How do I enable connection pooling in OpenJPA?
 
 As of the 2.1.0 release, OpenJPA includes the [Apache DBCP](http://jakarta.apache.org/commons/dbcp/)
  connection pool. You can also use any third-party connection pool that is
@@ -96,66 +94,58 @@ configurable via the JDBC DataSource API
  database and the [Apache DBCP|http://jakarta.apache.org/commons/dbcp/]
  connection pool:
 
-{code:XML}
-<persistence xmlns="http://java.sun.com/xml/ns/persistence"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    version="1.0">
-    <persistence-unit name="example-derby"
-transaction-type="RESOURCE_LOCAL">
-	<properties>
-	    <property name="openjpa.ConnectionProperties" 
-		value="DriverClassName=org.apache.derby.jdbc.ClientDriver,
-		  Url=jdbc:derby://localhost:1527/database, 
-		  MaxActive=100, 
-		  MaxWait=10000, 
-		  TestOnBorrow=true, 
-		  Username=user, 
-		  Password=secret"/>
-	    <property name="openjpa.ConnectionDriverName" 
-		value="org.apache.commons.dbcp.BasicDataSource"/>
-	</properties>
-    </persistence-unit>
-</persistence>
-
-    
-    See the documentation on [Using a Third-Party DataSource|http://openjpa.apache.org/builds/latest/docs/manual/manual.html#ref_guide_dbsetup_thirdparty]
- for further details.
-                                                             
-    h3. Can OpenJPA reorder SQL statements to satisfy database foreign key
-constraints?
-    
-    Yes. OpenJPA can reorder and/or batch the SQL statements using different
+        {code:XML}
+        <persistence xmlns="http://java.sun.com/xml/ns/persistence"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            version="1.0">
+            <persistence-unit name="example-derby"
+                transaction-type="RESOURCE_LOCAL">
+        	<properties>
+        	    <property name="openjpa.ConnectionProperties" 
+        		value="DriverClassName=org.apache.derby.jdbc.ClientDriver,
+        		  Url=jdbc:derby://localhost:1527/database, 
+        		  MaxActive=100, 
+        		  MaxWait=10000, 
+        		  TestOnBorrow=true, 
+        		  Username=user, 
+        		  Password=secret"/>
+        	    <property name="openjpa.ConnectionDriverName" 
+        		value="org.apache.commons.dbcp.BasicDataSource"/>
+        	</properties>
+            </persistence-unit>
+        </persistence>
+
+    
+See the documentation on [Using a Third-Party DataSource](http://openjpa.apache.org/builds/latest/docs/manual/manual.html#ref_guide_dbsetup_thirdparty)
for further details.
+   
+<a name="reorder"></a>                                                      
   
+## Can OpenJPA reorder SQL statements to satisfy database foreign key constraints?
+Yes. OpenJPA can reorder and/or batch the SQL statements using different
 configurable strategies. The default strategy is capable of reordering the
 SQL statements to satisfy foreign key constraints. However ,you must tell
 OpenJPA to read the existing foreign key information from the database
 schema:
     
     {code:XML}
-    <property name="openjpa.jdbc.SchemaFactory"
-value="native(ForeignKeys=true)"/>
-
-
+    <property name="openjpa.jdbc.SchemaFactory" value="native(ForeignKeys=true)"/>
 
-See the documentation on [Schema Factory](http://openjpa.apache.org/builds/latest/docs/manual/manual.html#ref_guide_schema_info_list)
- for further details.
+See the documentation on [Schema Factory](http://openjpa.apache.org/builds/latest/docs/manual/manual.html#ref_guide_schema_info_list)
for further details.
 
-h3. Why OpenJPA is not creating foreign key constraints on the database
-tables?
+<a name="fk"></a>
+## Why OpenJPA is not creating foreign key constraints on the database tables?
 
 By default, OpenJPA does not create foreign key constraints on new tables
 that gets created according to O-R mapping annotation/descriptors. You can
-change this default behavior via following configuration property
-{code:XML}
-<property name="openjpa.jdbc.MappingDefaults"
-value="ForeignKeyDeleteAction=restrict,
-JoinForeignKeyDeleteAction=restrict"/>
+change this default behavior via following configuration property :
 
-    to create foreign key constraints on the database tables generated by
-OpenJPA. 
-    
-    h3. Can OpenJPA map a one-sided one-many association without a cross table?
+        {code:XML}
+        <property name="openjpa.jdbc.MappingDefaults" value="ForeignKeyDeleteAction=restrict,JoinForeignKeyDeleteAction=restrict"/>
+
+to create foreign key constraints on the database tables generated by OpenJPA. 
     
-    Yes. Standard JPA specification use a cross table to map one-sided
+<a name="crosstable"></a>
+## Can OpenJPA map a one-sided one-many association without a cross table?
+Yes. Standard JPA specification use a cross table to map one-sided
 one-to-many relation without a {{mappedBy}} inverse side. Often, you would
 like to create a one-to-many association based on an inverse foreign key
 (logical or actual) in the table of the related type. OpenJPA supports this

Modified: openjpa/site/trunk/content/fetch-statistics.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/fetch-statistics.mdtext?rev=1412141&r1=1412140&r2=1412141&view=diff
==============================================================================
--- openjpa/site/trunk/content/fetch-statistics.mdtext (original)
+++ openjpa/site/trunk/content/fetch-statistics.mdtext Wed Nov 21 15:05:10 2012
@@ -1,5 +1,5 @@
 Title: Fetch Statistics
-<a name="FetchStatistics-FetchStatistics"></a>
+<a name="fetch-statistics"></a>
 # Fetch Statistics
 
 The OpenJPA Fetch Statistics Tool (FST) monitors persistent field access
@@ -15,9 +15,9 @@ container hook).
 
 * The persistent fields which satisfy all the following conditions will be
 tracked :
-** The field is fetched eagerly.
-** The field is not a primary key.
-** The field is not defined as a version field.
+    * The field is fetched eagerly.
+    * The field is not a primary key.
+    * The field is not defined as a version field.
 
 <a name="FetchStatistics-Download"></a>
 ## Download
@@ -30,35 +30,31 @@ The latest OpenJPA FST jar file can be d
 ## Configuration
  * JSE - Append the path of openjpa-fetch-statistics-version-SNAPSHOT.jar
 file to the classpath prior to lanuching the JVM.
- * [Websphere Application Server](for-websphere-application-server.html)
+ * [Websphere Application Server](websphere-application-server.html)
  * OSGi -- ?? -- Probably need another module that creates a proper bundle.
 
 <a name="FetchStatistics-StatisticsCollectingandMonitoring"></a>
 ## Statistics Collecting and Monitoring
-{warning:title=Performance Consideration}
+
 There will be a large performance impact when running this tooling. It is
-not supported, nor recommended for production use. *This tool should not be
-used on a production machine.*
-{warning} 
+not supported, nor recommended for production use. **This tool should not be
+used on a production machine.**
+
 * When this tool is configured, it will be active for all persistence units
 in the JVM. Statistics will be dumped via the openjpa.Runtime channel with
 the INFO level every 10 minutes, or when the JVM terminates. 
 
-{info:title=Example output}
-\[7/13/12 9:05:44:265 CDT\](7/13/12-9:05:44:265-cdt\.html)
- 00000072 Runtime	I   CWWJP9990I: openjpa.Runtime: Info: Successfully
-collected fetch statistics from Entities
-\[org.apache.openjpa.test.Address\]. The following fields are
-FetchType.EAGER and were never fetched [ total 7 ]
- : 
-org.apache.openjpa.test.Address.city
-org.apache.openjpa.test.Address.country
-org.apache.openjpa.test.Address.phone
-org.apache.openjpa.test.Address.state
-org.apache.openjpa.test.Address.street1
-org.apache.openjpa.test.Address.street2
-org.apache.openjpa.test.Address.zip
-{info} 
+### Example output
+        [7/13/12 9:05:44:265 CDT](7/13/12-9:05:44:265-cdt.html)
+         00000072 Runtime	I   CWWJP9990I: openjpa.Runtime: Info: Successfully collected fetch
statistics from Entities [org.apache.openjpa.test.Address]. The following fields are
+        FetchType.EAGER and were never fetched [ total 7 ] : 
+        org.apache.openjpa.test.Address.city
+        org.apache.openjpa.test.Address.country
+        org.apache.openjpa.test.Address.phone
+        org.apache.openjpa.test.Address.state
+        org.apache.openjpa.test.Address.street1
+        org.apache.openjpa.test.Address.street2
+        org.apache.openjpa.test.Address.zip
 
 <a name="FetchStatistics-Configurationremoval"></a>
 ## Configuration removal

Modified: openjpa/site/trunk/content/verifying-release-signatures.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/verifying-release-signatures.mdtext?rev=1412141&r1=1412140&r2=1412141&view=diff
==============================================================================
--- openjpa/site/trunk/content/verifying-release-signatures.mdtext (original)
+++ openjpa/site/trunk/content/verifying-release-signatures.mdtext Wed Nov 21 15:05:10 2012
@@ -9,18 +9,11 @@ On unix platforms the following command 
 
 You'll need to look at the output contains only good signaturesie :
 
-    gpg: Good signature from "Michael Dick (CODE SIGNING KEY)
-<mikedd@apache.org>"
-    gpg: Signature made Tue 12 Jan 2010 05:30:17 PM CST using RSA key ID
-7412AD2C
-    gpg: Good signature from "Michael Dick (CODE SIGNING KEY)
-<mikedd@apache.org>"
-    gpg: Signature made Tue 12 Jan 2010 05:30:18 PM CST using RSA key ID
-7412AD2C
-    gpg: Good signature from "Michael Dick (CODE SIGNING KEY)
-<mikedd@apache.org>"
-    gpg: Signature made Tue 12 Jan 2010 05:30:17 PM CST using RSA key ID
-7412AD2C
-    gpg: Good signature from "Michael Dick (CODE SIGNING KEY)
-<mikedd@apache.org>"
+            gpg: Good signature from "Michael Dick (CODE SIGNING KEY) <mikedd@apache.org>"
+            gpg: Signature made Tue 12 Jan 2010 05:30:17 PM CST using RSA key ID 7412AD2C
+            gpg: Good signature from "Michael Dick (CODE SIGNING KEY) <mikedd@apache.org>"
+            gpg: Signature made Tue 12 Jan 2010 05:30:18 PM CST using RSA key ID 7412AD2C
+            gpg: Good signature from "Michael Dick (CODE SIGNING KEY) <mikedd@apache.org>"
+            gpg: Signature made Tue 12 Jan 2010 05:30:17 PM CST using RSA key ID 7412AD2C
+            gpg: Good signature from "Michael Dick (CODE SIGNING KEY) <mikedd@apache.org>"
 

Modified: openjpa/site/trunk/content/websphere-application-server.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/websphere-application-server.mdtext?rev=1412141&r1=1412140&r2=1412141&view=diff
==============================================================================
--- openjpa/site/trunk/content/websphere-application-server.mdtext (original)
+++ openjpa/site/trunk/content/websphere-application-server.mdtext Wed Nov 21 15:05:10 2012
@@ -5,7 +5,7 @@ Title: Websphere Application Server
 <a name="WebsphereApplicationServer-Download"></a>
 ## Download
 * The latest OpenJPA Tools JAR file can be download from the [SNAPSHOT Repository](https://repository.apache.org/content/groups/snapshots/org/apache/openjpa/openjpa-fetch-statistics-was/)
- or can be built from the source code in [svn|https://svn.apache.org/repos/asf/openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/]
+ or can be built from the source code in [svn](https://svn.apache.org/repos/asf/openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/)
  by using Maven 2.2.1 and Java SE 6.
 
 <a name="WebsphereApplicationServer-Configuration"></a>



Mime
View raw message