You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openjpa.apache.org by cu...@apache.org on 2012/11/21 16:05:11 UTC
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
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)
-<mi...@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)
-<mi...@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)
-<mi...@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)
-<mi...@apache.org>"
+ gpg: Good signature from "Michael Dick (CODE SIGNING KEY) <mi...@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) <mi...@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) <mi...@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) <mi...@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>