HHH-9919 Re-write hibernate-osgi user guide based on published features.xml and ORM 5.0

Author: brmeyer

documentation/src/main/asciidoc/quickstart/guides/index.adoc

@@ -14,5 +14,3 @@ include::tutorial_annotations.adoc[]
 include::tutorial_jpa.adoc[]
 
 include::tutorial_envers.adoc[]
-
-include::tutorial_osgi.adoc[]

documentation/src/main/asciidoc/quickstart/guides/tutorial_osgi.adoc

@@ -0,0 +1,19 @@
+public class HibernateUtil {
+
+    private SessionFactory sf;
+
+    public Session getSession() {
+        return getSessionFactory().openSession();
+    }
+
+    private SessionFactory getSessionFactory() {
+        if ( sf == null ) {
+            Bundle thisBundle = FrameworkUtil.getBundle( HibernateUtil.class );
+            BundleContext context = thisBundle.getBundleContext();
+
+            ServiceReference sr = context.getServiceReference( SessionFactory.class.getName() );
+            sf = (SessionFactory) context.getService( sr );
+        }
+        return sf;
+    }
+}

documentation/src/main/docbook/userGuide/en-US/chapters/osgi/OSGi.xml

@@ -0,0 +1,21 @@
+public class HibernateUtil {
+
+    private EntityManagerFactory emf;
+
+    public EntityManager getEntityManager() {
+        return getEntityManagerFactory().createEntityManager();
+    }
+
+    private EntityManagerFactory getEntityManagerFactory() {
+        if ( emf == null ) {
+            Bundle thisBundle = FrameworkUtil.getBundle( HibernateUtil.class );
+            BundleContext context = thisBundle.getBundleContext();
+
+            ServiceReference serviceReference = context.getServiceReference( PersistenceProvider.class.getName() );
+            PersistenceProvider persistenceProvider = (PersistenceProvider) context.getService( serviceReference );
+
+            emf = persistenceProvider.createEntityManagerFactory( "YourPersistenceUnitName", null );
+        }
+        return emf;
+    }
+}

documentation/src/main/docbook/userGuide/en-US/chapters/osgi/extras/NativeHibernateUtil.java

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<blueprint  default-activation="eager"
+            xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0"
+            xmlns:jpa="http://aries.apache.org/xmlns/jpa/v1.0.0"
+            xmlns:tx="http://aries.apache.org/xmlns/transactions/v1.0.0">
+
+  <!-- This gets the container-managed EntityManager and injects it into the DataPointServiceImpl bean.
+  Assumes DataPointServiceImpl has an "entityManager" field with a getter and setter. -->
+  <bean id="dpService" class="org.hibernate.osgitest.DataPointServiceImpl"> 
+      <jpa:context unitname="managed-jpa" property="entityManager"/>
+      <tx:transaction method="*" value="Required"/>
+  </bean>
+  <service ref="dpService" interface="org.hibernate.osgitest.DataPointService" />
+</blueprint>

documentation/src/main/docbook/userGuide/en-US/chapters/osgi/extras/UnmanagedJPAHibernateUtil.java

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+First install the H2 driver using:
+> install -s mvn:com.h2database/h2/1.3.163
+
+Then copy this file to the deploy folder
+-->
+<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0">
+
+  <bean id="dataSource" class="org.h2.jdbcx.JdbcDataSource">
+    <property name="URL" value="jdbc:h2:mem:db1;DB_CLOSE_DELAY=-1;MVCC=TRUE"/>
+    <property name="user" value="sa"/>
+    <property name="password" value=""/>
+  </bean>
+
+  <service interface="javax.sql.DataSource" ref="dataSource">
+    <service-properties>
+      <entry key="osgi.jndi.service.name" value="jdbc/h2ds"/>
+    </service-properties>
+  </service>
+</blueprint>