Apache Onami Persistence

Return-Path: X-Original-To: apmail-onami-commits-archive@minotaur.apache.org Delivered-To: apmail-onami-commits-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 268681079F for ; Mon, 12 May 2014 06:43:24 +0000 (UTC) Received: (qmail 72058 invoked by uid 500); 12 May 2014 06:43:24 -0000 Delivered-To: apmail-onami-commits-archive@onami.apache.org Received: (qmail 72015 invoked by uid 500); 12 May 2014 06:43:23 -0000 Mailing-List: contact commits-help@onami.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@onami.apache.org Delivered-To: mailing list commits@onami.apache.org Received: (qmail 72008 invoked by uid 99); 12 May 2014 06:43:23 -0000 Received: from Unknown (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 12 May 2014 06:43:23 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED,FILL_THIS_FORM X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 12 May 2014 06:43:05 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id E3D942388B71; Mon, 12 May 2014 06:42:17 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: svn commit: r1593897 [7/27] - in /onami/site/persist: ./ apidocs/assets/ apidocs/reference/ apidocs/reference/org/apache/onami/persist/ cobertura/ xref-test/ xref-test/org/apache/onami/persist/ xref-test/org/apache/onami/persist/test/ xref-test/org/apa... Date: Mon, 12 May 2014 06:42:10 -0000 To: commits@onami.apache.org From: sclassen@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20140512064217.E3D942388B71@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Modified: onami/site/persist/plugin-management.html URL: http://svn.apache.org/viewvc/onami/site/persist/plugin-management.html?rev=1593897&r1=1593896&r2=1593897&view=diff ============================================================================== --- onami/site/persist/plugin-management.html (original) +++ onami/site/persist/plugin-management.html Mon May 12 06:42:06 2014 @@ -1,13 +1,13 @@ - + Apache Onami Persistence - Project Plugin Management @@ -46,7 +46,7 @@ - +

@@ -312,7 +362,7 @@ org.apache.maven.plugins maven-antrun-plugin -1.6 +1.7 org.apache.maven.plugins maven-assembly-plugin @@ -324,7 +374,7 @@ org.apache.maven.plugins maven-compiler-plugin -2.3.2 +2.5.1 org.apache.maven.plugins maven-dependency-plugin @@ -332,7 +382,7 @@ org.apache.maven.plugins maven-deploy-plugin -2.7 +2.8.1 org.apache.maven.plugins maven-doap-plugin @@ -347,72 +397,80 @@ 1.0.1 org.apache.maven.plugins -maven-gpg-plugin -1.3 +maven-failsafe-plugin +2.12.4 org.apache.maven.plugins -maven-install-plugin -2.4 +maven-gpg-plugin +1.4 org.apache.maven.plugins -maven-invoker-plugin -1.5 +maven-install-plugin +2.5.1 org.apache.maven.plugins -maven-jar-plugin -2.3.1 +maven-invoker-plugin +1.7 org.apache.maven.plugins +maven-jar-plugin +2.4 + +org.apache.maven.plugins maven-javadoc-plugin -2.8 +2.9 + +org.apache.maven.plugins +maven-plugin-plugin +3.2 org.apache.maven.plugins -maven-plugin-plugin -2.8 +maven-project-info-reports-plugin +2.7 org.apache.maven.plugins maven-release-plugin -2.4.1 +2.4.2 org.apache.maven.plugins maven-remote-resources-plugin -1.2.1 +1.4 org.apache.maven.plugins maven-resources-plugin 2.6 org.apache.maven.plugins -maven-scm-plugin -1.4 +maven-scm-plugin +1.8 org.apache.maven.plugins maven-scm-publish-plugin -1.0-beta-2 +1.0 org.apache.maven.plugins maven-site-plugin -3.0 +3.3 org.apache.maven.plugins maven-source-plugin -2.1.2 +2.2.1 org.apache.maven.plugins maven-surefire-plugin -2.9 +2.12.4 org.apache.rat apache-rat-plugin -0.7 +0.8 org.codehaus.mojo -clirr-maven-plugin -2.3 +build-helper-maven-plugin +1.8 org.codehaus.mojo -cobertura-maven-plugin -2.5.2 +clirr-maven-plugin +2.4 org.eclipse.m2e lifecycle-mapping Modified: onami/site/persist/plugins.html URL: http://svn.apache.org/viewvc/onami/site/persist/plugins.html?rev=1593897&r1=1593896&r2=1593897&view=diff ============================================================================== --- onami/site/persist/plugins.html (original) +++ onami/site/persist/plugins.html Mon May 12 06:42:06 2014 @@ -1,13 +1,13 @@ - + Apache Onami Persistence - Project Build Plugins @@ -46,7 +46,7 @@

- +

@@ -312,7 +362,7 @@ org.apache.felix maven-bundle-plugin -2.3.7 +2.4.0 org.apache.maven.plugins maven-clean-plugin @@ -324,7 +374,7 @@ org.apache.maven.plugins maven-deploy-plugin -2.7 +2.8.1 org.apache.maven.plugins maven-doap-plugin @@ -332,11 +382,11 @@ org.apache.maven.plugins maven-enforcer-plugin -1.2 +1.3.1 org.apache.maven.plugins maven-install-plugin -2.4 +2.5.1 org.apache.maven.plugins maven-jar-plugin @@ -344,11 +394,11 @@ org.apache.maven.plugins maven-javadoc-plugin -2.9 +2.9.1 org.apache.maven.plugins maven-remote-resources-plugin -1.2.1 +1.4 org.apache.maven.plugins maven-resources-plugin @@ -356,7 +406,7 @@ org.apache.maven.plugins maven-scm-publish-plugin -1.0-beta-2 +1.0 org.apache.maven.plugins maven-site-plugin @@ -368,15 +418,11 @@ org.apache.maven.plugins maven-surefire-plugin -2.14.1 +2.16 org.codehaus.mojo buildnumber-maven-plugin -1.2 - -org.codehaus.mojo -cobertura-maven-plugin -2.5.2 +1.2

Project Report Plugins

@@ -387,15 +433,15 @@ - + - + - + @@ -407,13 +453,9 @@ - + - - - -

org.apache.maven.plugins	maven-checkstyle-plugin	2.10
2.11
org.apache.maven.plugins	maven-javadoc-plugin	2.9
2.9.1
org.apache.maven.plugins	maven-jxr-plugin	2.3
2.4
org.apache.maven.plugins	maven-pmd-plugin
org.apache.maven.plugins	maven-surefire-report-plugin	2.14.1
2.16
org.codehaus.mojo	cobertura-maven-plugin	2.5.2
org.codehaus.mojo	taglist-maven-plugin	2.4

Modified: onami/site/persist/pmd.html URL: http://svn.apache.org/viewvc/onami/site/persist/pmd.html?rev=1593897&r1=1593896&r2=1593897&view=diff ============================================================================== --- onami/site/persist/pmd.html (original) +++ onami/site/persist/pmd.html Mon May 12 06:42:06 2014 @@ -1,13 +1,13 @@ - + Apache Onami Persistence - PMD Results @@ -46,7 +46,7 @@

Last Published: 19 March 2014
Last Published: 12 May 2014
|
Version: 1.0.0-SNAPSHOT

+ + + + DAO Example +
+ + + + Onami Persist vs. Guice Persist +
+ + + + EntityManagerProvider +
Samples
+ + + + Standalone Application +
+ + + + Simple Web Application +
+ + + + Multi Datasource Web Application +
Project Documentation
Project Information
@@ -100,9 +143,9 @@
- + - Cobertura Test Coverage + Test Source Xref
@@ -114,13 +157,6 @@
- - - Test Source Xref -
- Surefire Report @@ -280,7 +316,16 @@ Line Avoid unused imports such as 'com.google.inject.Key' -23 +23 +
+
org/apache/onami/persist/UserTransactionFacade.java
+ + + + + + +
Violation Line
Useless parentheses. 194
Modified: onami/site/persist/project-info.html URL: http://svn.apache.org/viewvc/onami/site/persist/project-info.html?rev=1593897&r1=1593896&r2=1593897&view=diff ============================================================================== --- onami/site/persist/project-info.html (original) +++ onami/site/persist/project-info.html Mon May 12 06:42:06 2014 @@ -1,13 +1,13 @@ - + Apache Onami Persistence - Project Information @@ -46,7 +46,7 @@
- Last Published: 19 March 2014
- Last Published: 12 May 2014
- |
- Version: 1.0.0-SNAPSHOT
- + + + + DAO Example +
- + + + + Onami Persist vs. Guice Persist +
- + + + + EntityManagerProvider +
- Samples
- + + + + Standalone Application +
- + + + + Simple Web Application +
- + + + + Multi Datasource Web Application +
- Project Documentation
- Project Information @@ -91,23 +134,23 @@
- - + - Project Summary + Plugin Management
- - + - Project License + Distribution Management
- - + - Project Team + Dependency Information
- @@ -119,6 +162,13 @@
- + + + Mailing Lists +
- + Issue Tracking @@ -126,55 +176,55 @@
- - + - Mailing Lists + Continuous Integration
- - + - Dependency Management + Project Plugins
- - + - Dependencies + Project License
- - + - Continuous Integration + Dependency Management
- - + - Plugin Management + Project Team
- - + - Project Plugins + Project Summary
- - + - Distribution Management + Dependencies
@@ -315,41 +365,44 @@ About Apache Onami Persistence is a Google Guice extension for JPA with support of container managed persistence units and transactions. -Project Summary -This document lists other related information of this project +Plugin Management +This document lists the plugins that are defined through pluginManagement. -Project License -This is a link to the definitions of project licenses. +Distribution Management +This document provides informations on the distribution management of this project. -Project Team -This document provides information on the members of this project. These are the individuals who have contributed to the project in one form or another. +Dependency Information +This document describes how to to include this project as a dependency using various dependency management tools. Source Repository This is a link to the online source repository that can be viewed via a web browser. -Issue Tracking -This is a link to the issue management system for this project. Issues (bugs, features, change requests) can be created and queried using this link. - Mailing Lists This document provides subscription and archive information for this project's mailing lists. - -Dependency Management -This document lists the dependencies that are defined through dependencyManagement. -Dependencies -This document lists the project's dependencies and provides information on each dependency. +Issue Tracking +This is a link to the issue management system for this project. Issues (bugs, features, change requests) can be created and queried using this link. Continuous Integration This is a link to the definitions of all continuous integration processes that builds and tests code on a frequent, regular basis. -Plugin Management -This document lists the plugins that are defined through pluginManagement. - Project Plugins This document lists the build plugins and the report plugins used by this project. + +Project License +This is a link to the definitions of project licenses. -Distribution Management -This document provides informations on the distribution management of this project. +Dependency Management +This document lists the dependencies that are defined through dependencyManagement. + +Project Team +This document provides information on the members of this project. These are the individuals who have contributed to the project in one form or another. + +Project Summary +This document lists other related information of this project + +Dependencies +This document lists the project's dependencies and provides information on each dependency. Modified: onami/site/persist/project-reports.html URL: http://svn.apache.org/viewvc/onami/site/persist/project-reports.html?rev=1593897&r1=1593896&r2=1593897&view=diff ============================================================================== --- onami/site/persist/project-reports.html (original) +++ onami/site/persist/project-reports.html Mon May 12 06:42:06 2014 @@ -1,13 +1,13 @@ - + Apache Onami Persistence - Generated Reports @@ -46,7 +46,7 @@
- Last Published: 19 March 2014
- Last Published: 12 May 2014
- |
- Version: 1.0.0-SNAPSHOT
- + + + + DAO Example +
- + + + + Onami Persist vs. Guice Persist +
- + + + + EntityManagerProvider +
- Samples
- + + + + Standalone Application +
- + + + + Simple Web Application +
- + + + + Multi Datasource Web Application +
- Project Documentation
- Project Information
- Project Reports @@ -98,9 +141,9 @@
- - + - Cobertura Test Coverage + Test Source Xref
- @@ -112,13 +155,6 @@
- - - - Test Source Xref -
- - Surefire Report @@ -280,24 +316,21 @@ JavaDocs JavaDoc API documentation. -Cobertura Test Coverage -Cobertura Test Coverage Report. +Test Source Xref +HTML based, cross-reference version of Java test source code. Source Xref HTML based, cross-reference version of Java source code. -Test Source Xref -HTML based, cross-reference version of Java test source code. - Surefire Report Report on the test results of the project. - + CPD Report Duplicate code detection. - + PMD Report Verification of coding rules. - + Tag List Report on various tags found in the code. Modified: onami/site/persist/project-summary.html URL: http://svn.apache.org/viewvc/onami/site/persist/project-summary.html?rev=1593897&r1=1593896&r2=1593897&view=diff ============================================================================== --- onami/site/persist/project-summary.html (original) +++ onami/site/persist/project-summary.html Mon May 12 06:42:06 2014 @@ -1,13 +1,13 @@ - + Apache Onami Persistence - Project Summary @@ -46,7 +46,7 @@
  - Last Published: 19 March 2014
  - Last Published: 12 May 2014
  - |
  - Version: 1.0.0-SNAPSHOT
  - + + + + DAO Example +
  - + + + + Onami Persist vs. Guice Persist +
  - + + + + EntityManagerProvider +
  - Samples
  - + + + + Standalone Application +
  - + + + + Simple Web Application +
  - + + + + Multi Datasource Web Application +
  - Project Documentation
  - @@ -91,23 +134,25 @@ About
  - +
  - - Project Summary -
  - - + - Project License + Distribution Management
  - - + - Project Team + Dependency Information
  - @@ -119,62 +164,67 @@
  - - + - Issue Tracking + Mailing Lists
  - - + - Mailing Lists + Issue Tracking
  - - + - Dependency Management + Continuous Integration
  - - + - Dependencies + Project Plugins
  - - + - Continuous Integration + Project License
  - - + - Plugin Management + Dependency Management
  - - + - Project Plugins + Project Team
  - + + Project Summary +
  - - + - Distribution Management + Dependencies
- @@ -342,7 +392,7 @@ org.apache.onami ArtifactId -onami-persist +org.apache.onami.persist Version 1.0.0-SNAPSHOT Added: onami/site/persist/simpleWebApp.html URL: http://svn.apache.org/viewvc/onami/site/persist/simpleWebApp.html?rev=1593897&view=auto ============================================================================== --- onami/site/persist/simpleWebApp.html (added) +++ onami/site/persist/simpleWebApp.html Mon May 12 06:42:06 2014 @@ -0,0 +1,361 @@ + + + + + + + + + + Apache Onami Persistence - Simple Web Application + + + + + + + + + + + + + + + + + + + + + +
  +
  +
  +
  +
  Apache Onami Persistence
  +
  +
  +
  
  +
  +
  + +
  +
  + + +
  Last Published: 09 May 2014
  +
  |
  
  Version: 1.0.0-SNAPSHOT
  + + + + + +
  + Google Guice +
  + +
  +
  + + +
  +
  +
  + + +
  +
  Apache Onamiâ¢ Persist
  + +
  + + + + Home +
  + +
  + + + + DAO Example +
  + +
  + + + + Onami Persist vs. Guice Persist +
  + +
  + + + + EntityManagerProvider +
  +
  Samples
  + +
  + + + + Standalone Application +
  + +
  + + Simple Web Application +
  + +
  + + + + Multi Datasource Web Application +
  +
  Project Documentation
  + +
  + + + + Project Information +
  + +
  + + + + Project Reports +
  +
  Community
  + +
  + + + + Volunteering +
  + +
  + + + + Contributing Patches +
  + +
  + + + + Mailing lists +
  +
  Committers
  + +
  + + + + SVN conventions +
  + +
  + + + + Maven settings +
  + +
  + + + + GPG keys +
  + +
  + + + + JIRA conventions +
  + +
  + + + + Code style recommendations +
  + +
  + + + + Release HowTo +
  +
  ASF
  + +
  + + + + How the ASF works +
  + +
  + + + + Get Involved +
  + +
  + + + + Developer Resources +
  + +
  + + + + Sponsorship +
  + +
  + + + + Thanks +
  +
  + + + +
  + +
  +
  +
  +
  + + + +
  +
  +
  + + +
  + +
  +
  Simple Web Application
  +
  +
  java code
  +
  +
  public class BootstrapServletListener extends GuiceServletContextListener { + protected Injector getInjector() { + final PersistenceModule persistenceModule = new PersistenceModule() { + @Override + protected void configurePersistence() { + bindContainerManagedPersistenceUnitWithJndiName("java:comp/env/foobar/puJndiName"); + } + }; + + final ServletModule servletModule = new ServletModule() { + filter("/*").through(PersistenceFilter.class); + }; + + return Guice.createInjector(servletModule, persistenceModule, getApplicationSpecificModules()); + }
  +
  +
  web.xml
  +
  +
  <?xml version="1.0" encoding="UTF-8"?> +<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" +xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"> + <display-name>FooBar App</display-name> + <filter> + <filter-name>guiceFilter</filter-name> + <filter-class>com.google.inject.servlet.GuiceFilter</filter-class> + </filter> + <filter-mapping> + <filter-name>guiceFilter</filter-name> + <url-pattern>/*</url-pattern> + </filter-mapping> + <listener> + <listener-class>foo.bar.BootstrapServletListener</listener-class> + </listener> +  +</web-app>
  +
  +
  persistence.xml
  +
  +
  <persistence xmlns="http://java.sun.com/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd" version="2.0"> + <persistence-unit name="puName" transaction-type="RESOURCE_LOCAL"> +  + </peristence-unit> +</peristence>
  +
  +
  JNDI Binding
  +
  In order to allow container managed persistence units the persistence unit must be bound in the JNDI framework.
  +
  If your container follows the J2EE Standard 5.0 add the following to your web.xml
  +
  +
  <peristence-unit-ref> + <peristence-unit-ref-name>foobar/puJndiName</peristence-unit-ref-name> + <peristence-unit-name>puName</peristence-unit-name> +</peristence-unit-ref>
  +
  Important: JBoss AS7.x do not support placing the JNDI binding in the web.xml. Instead add the following to your persistence.xml
  +
  +
  <property name="jboss.entity.manager.factory.jndi.name" value="java:comp/env/foobar/puJndiName" /> +<property name="jboss.as.jpa.managed" value="true" />
  +
  Important: JBoss AS 7.x makes all datasources defined in the standalone.xml JTA managed. If you want one or more of the datasources to be resource local you must add the attribute "jta" to the datasource element.
  +
  +
  <datasource jndi-name="java:jboss/datasources/systemDS" pool-name="systemDS" enabled="true" use-java-context="true" jta="false"> + ... +</datasource>
  +
  +
  Structure of the .war
  +
  +
  + app.war +| + META-INF +| | + MANIFEST.MF +| | + persistence.xml +| + WEB-INF +| | + classes +| | | + META-INF +| | | | + MANIFEST.MF +| | | + foo +| | | | + bar +| | | | | + BootstrapServletListener.class +| | + lib +| | | + guice.jar +| | | + onami-persist.jar
  +
  +
  +
  + +
  + +
  +
  +
  Copyright © 2013-2014 + The Apache Software Foundation. + All Rights Reserved. + +
  + + +
  Apache Onami, Apache Onami Persist, Apache, the Apache feather logo, and the Apache Onami project logos are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
  + + +
  +
  + + \ No newline at end of file Propchange: onami/site/persist/simpleWebApp.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: onami/site/persist/simpleWebApp.html ------------------------------------------------------------------------------ svn:keywords = Date Revision Author HeadURL Id Propchange: onami/site/persist/simpleWebApp.html ------------------------------------------------------------------------------ svn:mime-type = text/html Modified: onami/site/persist/source-repository.html URL: http://svn.apache.org/viewvc/onami/site/persist/source-repository.html?rev=1593897&r1=1593896&r2=1593897&view=diff ============================================================================== --- onami/site/persist/source-repository.html (original) +++ onami/site/persist/source-repository.html Mon May 12 06:42:06 2014 @@ -1,13 +1,13 @@ - + Apache Onami Persistence - Source Repository @@ -46,7 +46,7 @@
  - Last Published: 19 March 2014
  - Last Published: 12 May 2014
  - |
  - Version: 1.0.0-SNAPSHOT
  - + + + + DAO Example +
  - + + + + Onami Persist vs. Guice Persist +
  - + + + + EntityManagerProvider +
  - Samples
  - + + + + Standalone Application +
  - + + + + Simple Web Application +
  - + + + + Multi Datasource Web Application +
  - Project Documentation
  - @@ -93,23 +136,23 @@
  - - + - Project Summary + Plugin Management
  - - + - Project License + Distribution Management
  - - + - Project Team + Dependency Information
  - @@ -119,6 +162,13 @@
  - + + + Mailing Lists +
  - + Issue Tracking @@ -126,55 +176,55 @@
  - - + - Mailing Lists + Continuous Integration
  - - + - Dependency Management + Project Plugins
  - - + - Dependencies + Project License
  - - + - Continuous Integration + Dependency Management
  - - + - Plugin Management + Project Team
  - - + - Project Plugins + Project Summary
  - - + - Distribution Management + Dependencies
- @@ -314,12 +364,12 @@
  Anonymous access
  
  The source can be checked out anonymously from SVN with this command:
  -
```
$ svn checkout https://svn.apache.org/repos/asf/onami/trunk/sandbox/persist onami-persist
```
  +
```
$ svn checkout https://svn.apache.org/repos/asf/onami/trunk/sandbox/persist org.apache.onami.persist
```
  Developer access
  
  Everyone can access the Subversion repository via HTTP, but Committers must checkout the Subversion repository via HTTPS.
  -
```
$ svn checkout https://svn.apache.org/repos/asf/onami/trunk/sandbox/persist onami-persist
```
  +
```
$ svn checkout https://svn.apache.org/repos/asf/onami/trunk/sandbox/persist org.apache.onami.persist
```
  To commit changes to the repository, execute the following command to commit your changes (svn will prompt you for your password)
```
$ svn commit --username your-username -m "A message"
```
  @@ -327,7 +377,7 @@
  Access from behind a firewall
  
  For those users who are stuck behind a corporate firewall which is blocking HTTP access to the Subversion repository, you can try to access it via the developer connection:
  -
```
$ svn checkout https://svn.apache.org/repos/asf/onami/trunk/sandbox/persist onami-persist
```
  +
```
$ svn checkout https://svn.apache.org/repos/asf/onami/trunk/sandbox/persist org.apache.onami.persist
```
  Access through a proxy
  
  The Subversion client can go through a proxy, if you configure it to do so. First, edit your "servers" configuration file to indicate which proxy to use. The file's location depends on your operating system. On Linux or Unix it is located in the directory "~/.subversion". On Windows it is in "%APPDATA%\Subversion". (Try "echo %APPDATA%", note this is a hidden directory.)

Project Report Plugins

org/apache/onami/persist/UserTransactionFacade.java

Simple Web Application

java code

web.xml

persistence.xml

JNDI Binding

Structure of the .war

Anonymous access

Developer access

Access from behind a firewall

Access through a proxy