Downloaded 65 times
Uploaded byAchim Nierbeck
ApacheCon EU 2014: Enterprise Development with Apache Karaf
The document discusses the implementation of enterprise Java applications within the Apache Karaf container, focusing on the integration of OSGi frameworks and various enterprise requirements such as EJB, CDI, and JPA. It outlines the architecture of Karaf, including its modular capabilities, and details the use of various services like HTTP and clustering via Apache Cellar. Additionally, it provides configuration examples and coding practices for setting up servlets and service registrations.
More Related Content
Similar to ApacheCon EU 2014: Enterprise Development with Apache Karaf
ApacheCon EU 2014: Enterprise Development with Apache Karaf
- 1.
- 2. What needs tobe done to run JEE like applications inside Karaf?
- 3. 2014-‐10-‐23 3 @anierbeck - Karaf PMC, Apache Member - OPS4j Pax Web Project Lead - Senior IT Consultant @codecentric - co-Author of Apache Karaf Cookbook
- 4. Agenda • EnterpriseRequirements • OSGi with Karaf • Enterprise Requirements on Karaf • Specialties • Http Service • Cellar - or how to cluster Karaf • Summary 2014-‐10-‐23 4
- 5.
- 6. Enterprise Java EJB3.1 CDI 2014-‐10-‐23 6 Servlet 3 JSF 2 JSP JPA 2 JTA Bean Validation JAX-WS JAX-RS JAXR JAXB JMS JAAS JASPIC JACC JSR-88 JCA JavaMail JSR-77 RMI JNDI JAX-RPC SAAJ
- 7.
- 8. OSGi - avery brief introduction • Modular • OSGi Bundles: • High Cohesion (One classloader/bundle) • Low Coupling (Package Import/Export) • Versioning per bundle ( [1.0,2,0) ) • Service Registry 2014-‐10-‐23 8
- 9. What is Karaf • Container • OSGi Applications • Ligthtweight • expandable to Full Enterprise support • Covers all major needs • Logging • Deployment • Configuration 2014-‐10-‐23 9
- 10. Karaf - Overview 2014-‐10-‐23 10 Config Logging Deployer Console Admin OSGi Framework - Felix / Equinox JMX Blueprint SSH
- 11.
- 12. Karaf EJB 3.1CDI 2014-‐10-‐23 12 Servlet 3 JSF 2 JSP JPA 2 JTA Bean Validation JAX-WS JAX-RS JAXR JAXB JMS JAAS JASPIC JACC JSR-88 JCA JavaMail JSR-77 RMI JNDI JAX-RPC SAAJ
- 13. Enterprise - PaxWeb EJB 3.1 CDI 2014-‐10-‐23 13 Servlet 3 JSF 2 JSP JPA 2 JTA Bean Validation JAX-WS JAX-RS JAXR JAXB JMS JAAS JASPIC JACC JSR-88 JCA JavaMail JSR-77 RMI JNDI JAX-RPC SAAJ
- 14. Enterprise - PaxCDI EJB 3.1 CDI 2014-‐10-‐23 14 Servlet 3 JSF 2 JSP JPA 2 JTA Bean Validation JAX-WS JAX-RS JAXR JAXB JMS JAAS JASPIC JACC JSR-88 JCA JavaMail JSR-77 RMI JNDI JAX-RPC SAAJ
- 15. Enterprise - Aries EJB 3.1 CDI 2014-‐10-‐23 15 Servlet 3 JSF 2 JSP JPA 2 JTA Bean Validation JAX-WS JAX-RS JAXR JAXB JMS JAAS JASPIC JACC JSR-88 JCA JavaMail JSR-77 RMI JNDI JAX-RPC SAAJ
- 16. Enterprise - Tomeeaka OpenEJB EJB 3.1 CDI 2014-‐10-‐23 16 Servlet 3 JSF 2 JSP JPA 2 JTA Bean Validation JAX-WS JAX-RPC JAX-RS JAXR JAXB JMS JAAS JASPIC JACC JSR-88 JCA JavaMail JSR-77 RMI SAAJ JNDI
- 17. Enterprise - CXF EJB 3.1 CDI 2014-‐10-‐23 17 Servlet 3 JSF 2 JSP JPA 2 JTA Bean Validation JAX-WS JAX-RPC JAX-RS JAXR JAXB JMS JAAS JASPIC JACC JSR-88 JCA JavaMail JSR-77 RMI SAAJ JNDI
- 18. Enterprise - ActiveMQ EJB 3.1 CDI 2014-‐10-‐23 18 Servlet 3 JSF 2 JSP JPA 2 JTA Bean Validation JAX-WS JAX-RPC JAX-RS JAXR JAXB JMS JAAS JASPIC JACC JSR-88 JCA JavaMail JSR-77 RMI SAAJ JNDI
- 19. Enterprise - Cellar EJB 3.1 CDI 2014-‐10-‐23 19 Servlet 3 JSF 2 JSP JPA 2 JTA Bean Validation JAX-WS JAX-RPC JAX-RS JAXR JAXB JMS JAAS JASPIC JACC JSR-88 JCA JavaMail JSR-77 RMI SAAJ JNDI
- 20. Enterprise - Karafwith features EJB 3.1 CDI 2014-‐10-‐23 20 Servlet 3 JSF 2 JSP JPA 2 JTA Bean Validation JAX-WS JAX-RPC JAX-RS JAXR SAAJ JAXB JMS JAAS JASPIC JACC JSR-88 JCA JavaMail JSR-77 RMI JNDI
- 21.
- 22. JPA - Karaf 2014-‐10-‐23 22 <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="cookbook" transaction-type="JTA"> <provider>org.apache.openjpa.persistence.PersistenceProviderImpl</provider> <jta-data-source> osgi:service/javax.sql.DataSource/(osgi.jndi.service.name=jdbc/cookbook) </jta-data-source> <class>de.nierbeck.apachecon.persistence.entity.Book</class> <class>de.nierbeck.apachecon.persistence.entity.Recipe</class> <exclude-unlisted-classes>true</exclude-unlisted-classes> <properties> <property name="openjpa.Log" value="slf4j" /> <property name="openjpa.RuntimeUnenhancedClasses" value="supported" /> <property name="openjpa.jdbc.SynchronizeMappings" value="buildSchema"/> </properties> </persistence-unit> </persistence>
- 23. JPA - Karaf 2014-‐10-‐23 22 <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="cookbook" transaction-type="JTA"> <provider>org.apache.openjpa.persistence.PersistenceProviderImpl</provider> <jta-data-source> osgi:service/javax.sql.DataSource/(osgi.jndi.service.name=jdbc/cookbook) </jta-data-source> <class>de.nierbeck.apachecon.persistence.entity.Book</class> <class>de.nierbeck.apachecon.persistence.entity.Recipe</class> <exclude-unlisted-classes>true</exclude-unlisted-classes> <properties> <property name="openjpa.Log" value="slf4j" /> <property name="openjpa.RuntimeUnenhancedClasses" value="supported" /> <property name="openjpa.jdbc.SynchronizeMappings" value="buildSchema"/> </properties> </persistence-unit> </persistence> To have this blueprint JNDI is needed
- 24. JTA - Karaf 2014-‐10-‐23 23 <blueprint default-activation=„eager" xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:jpa="http://aries.apache.org/xmlns/jpa/v1.0.0" xmlns:tx="http://aries.apache.org/xmlns/transactions/v1.0.0" xsi:schemaLocation="http://www.osgi.org/xmlns/blueprint/v1.0.0 http://www.osgi.org/xmlns/blueprint/v1.0.0/blueprint.xsd"> <bean id="cookBookServiceImpl" class="de.nierbeck.apachecon.persistence.dao.CookBookServiceImpl"> <jpa:context property="em" unitname="cookbook" /> <tx:transaction method="*" value="Required" /> </bean> <service id="cookBookService" ref="cookBookServiceImpl" interface="de.nierbeck.apachecon.persistence.api.CookBookService" /> </blueprint>
- 25. JTA - Karaf 2014-‐10-‐23 23 <blueprint default-activation=„eager" xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:jpa="http://aries.apache.org/xmlns/jpa/v1.0.0" xmlns:tx="http://aries.apache.org/xmlns/transactions/v1.0.0" xsi:schemaLocation="http://www.osgi.org/xmlns/blueprint/v1.0.0 http://www.osgi.org/xmlns/blueprint/v1.0.0/blueprint.xsd"> <bean id="cookBookServiceImpl" class="de.nierbeck.apachecon.persistence.dao.CookBookServiceImpl"> <jpa:context property="em" unitname="cookbook" /> <tx:transaction method="*" value="Required" /> </bean> <service id="cookBookService" ref="cookBookServiceImpl" interface="de.nierbeck.apachecon.persistence.api.CookBookService" /> </blueprint> To have this blueprint JPA and JTA is needed
- 26. Client - Karaf 2014-‐10-‐23 24 <?xml version="1.0" encoding="UTF-8"?> <blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0" default-activation="lazy"> <reference id="cookBookService" interface="de.nierbeck.apachecon.persistence.api.CookBookService" /> <command-bundle xmlns="http://karaf.apache.org/xmlns/shell/v1.1.0"> <command> <action class="de.nierbeck.apachecon.commands.CreateBook"> <property name="bookService" ref="cookBookService" /> </action> </command> ... </command-bundle> </blueprint>
- 27.
- 28.
- 29.
- 30.
- 31. Client - Shell 2014-‐10-‐23 29
- 32.
- 33. Client - Shell 2014-‐10-‐23 31
- 34.
- 35. HTTP Service 2014-‐10-‐23 33 • Using an Activator: final HttpContext httpContext = httpService .createDefaultHttpContext(); // register the BookServlet // first wait for the DAO-Service CookBookService cookBookService; ServiceReference<CookBookService> serviceReference = bundleContext .getServiceReference(CookBookService.class); cookBookService = bundleContext.getService(serviceReference); //now create the servlet ViewBookServlet viewBookServlet = new ViewBookServlet(); //set the DAO to the Servlet viewBookServlet.setCookBookService(cookBookService); final Dictionary<String, Object> initParams = new Hashtable<String, Object>(); try { httpService.registerServlet("/book", // alias viewBookServlet, initParams, httpContext);
- 36. Whiteboard • Usingthe whiteboard approach via Activator public void start(BundleContext bc) throws Exception { bundleContext = bc; // first wait for the DAO-Service CookBookService cookBookService; ServiceReference<CookBookService> serviceReference = bundleContext 2014-‐10-‐23 34 .getServiceReference(CookBookService.class); cookBookService = bundleContext.getService(serviceReference); // create new Servlet ViewBookServlet cookBookViewServlet = new ViewBookServlet(); cookBookViewServlet.setCookBookService(cookBookService); registerServiced = bundleContext.registerService(Servlet.class, cookBookViewServlet, null); }
- 37. Whiteboard 2014-‐10-‐23 35 • Using the whiteboard approach via Blueprint <blueprint default-activation="eager"> <reference id="cookBookService" interface="de.nierbeck.apachecon.persistence.api.CookBookService" /> <bean id="viewBookServlet" class="de.nierbeck.apachecon.view.ViewBookServlet" > <property name="cookBookService" ref="cookBookService"/> </bean> <service id="servletService" interface="javax.servlet.Servlet" ref="viewBookServlet" /> </blueprint>
- 38. Servlet 3.0 -Just annotation 2014-‐10-‐23 36 @WebServlet(urlPatterns = "/book") public class ViewBookServlet extends HttpServlet { /** * */ private static final long serialVersionUID = 1L; @Inject @OsgiService CookBookService cookBookService; @Override protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { ... } }
- 39.
- 40. Registering - Servlet 2014-‐10-‐23 38 Pax-Web HTTP Service Service- Registry Servlet
- 41. Registering - Servlet 2014-‐10-‐23 38 Pax-Web HTTP Service Service- Registry Servlet Registerd
- 42. Registering - Servlet 2014-‐10-‐23 38 Pax-Web HTTP Service Service- Registry Servlet Registerd Registerd
- 43. Registering - Whiteboard 2014-‐10-‐23 39 Pax-Web WebContainer Service-Tracker Service- Registry Servlet
- 44. Registering - Whiteboard 2014-‐10-‐23 39 Pax-Web WebContainer Service-Tracker Service- Registry Servlet Registerd
- 45. Registering - Whiteboard 2014-‐10-‐23 39 Pax-Web WebContainer Service-Tracker Service- Registry Servlet Registerd Registerd
- 46. Registering - Whiteboard 2014-‐10-‐23 39 Pax-Web WebContainer Service-Tracker Service- Registry Servlet Registerd Registerd
- 47. Registering - WAR 2014-‐10-‐23 40 Pax-Web WebContainer Pax-Web WAR Extender Service- Registry WAB-Bundle Servlet
- 48. Registering - WAR 2014-‐10-‐23 40 Pax-Web WebContainer Pax-Web WAR Extender Service- Registry WAB-Bundle Servlet Registerd
- 49. Registering - WAR 2014-‐10-‐23 40 Pax-Web WebContainer Pax-Web WAR Extender Service- Registry WAB-Bundle Servlet Registerd Registerd
- 50. Registering - WAR 2014-‐10-‐23 40 Pax-Web WebContainer Pax-Web WAR Extender Service- Registry WAB-Bundle Servlet Registerd Registerd
- 51. Servlet + JPA/ Service 2014-‐10-‐23 41 Blueprint Extender Pax-Web WAR Extender JPA-Bundle Service- Registry JPA - Service WEB-Bundle Servlet
- 52. Servlet + JPA/ Service 2014-‐10-‐23 41 Blueprint Extender Pax-Web WAR Extender JPA-Bundle Service- Registry JPA - Service WEB-Bundle Servlet Registerd
- 53. Servlet + JPA/ Service 2014-‐10-‐23 41 Blueprint Extender Pax-Web WAR Extender JPA-Bundle Service- Registry JPA - Service WEB-Bundle Servlet Registerd Injected
- 54. Servlet + JPA/ Service 2014-‐10-‐23 41 Blueprint Extender Pax-Web WAR Extender JPA-Bundle Service- Registry JPA - Service WEB-Bundle Servlet Registerd Registerd Injected
- 55.
- 56.
- 57.
- 58. Cluster provided byApache Karaf Cellar
- 59. Cellar - ClusterCommunication 2014-‐10-‐23 46
- 60. Cellar - ClusterCommunication 2014-‐10-‐23 47 Hazelcast
- 61. Cellar - Events 2014-‐10-‐23 48
- 62. Cellar - DistributingBundles 2014-‐10-‐23 49 Node A Node B Node C Maven Repository Hazelcast
- 63. Cellar - DistributingBundles 2014-‐10-‐23 49 Node A Node B Node C Maven Repository osgi:install mvn:groupId/artifactId/version Hazelcast
- 64. Cellar - DistributingBundles 2014-‐10-‐23 49 Node A Node B Node C Maven Repository Hazelcast
- 65. Cellar - DistributingBundles 2014-‐10-‐23 49 Node A Node B Node C Maven Repository Hazelcast
- 66. Cellar - DistributingBundles 2014-‐10-‐23 49 Node A Node B Node C Maven Repository Hazelcast
- 67. Cellar - DistributingBundles 2014-‐10-‐23 49 Node A Node B Node C Maven Repository Hazelcast
- 68. Cellar - DistributingBundles 2014-‐10-‐23 49 Node A Node B Node C Maven Repository Hazelcast
- 69. Cellar - DistributingBundles 2014-‐10-‐23 49 Node A Node B Node C Maven Repository Hazelcast
- 70. Cellar - DistributingBundles 2014-‐10-‐23 49 Node A Node B Node C Maven Repository Hazelcast DEPRECATED
- 71. Cellar - DistributingBundles 2014-‐10-‐23 49 Node A Node B Node C Maven Repository cluster:install mvn:groupId/artifactId/version Hazelcast DEPRECATED
- 72. Cellar - RMI 2014-‐10-‐23 50 Group 1 Node A Consumes OSGi-Service Group 2 Node B Consumes OSGi-Service Node C Consumes OSGi-Service Node A Provides OSGi-Service Node B Hazelcast Provides OSGi-Service
- 73. Cellar - Websession failover 2014-‐10-‐23 51 Node A Hazelcast DataBase Client Filter Servlet Node B Filter Servlet
- 74. Cellar - Websession failover 2014-‐10-‐23 51 Node A Hazelcast DataBase Client Filter Servlet Node B Filter Servlet
- 75. Cellar - Websession failover 2014-‐10-‐23 51 Node A Hazelcast DataBase Client Filter Servlet Node B Filter Servlet
- 76. Cellar - Websession failover 2014-‐10-‐23 51 Node A Hazelcast DataBase Client Filter Servlet Node B Filter Servlet
- 77. Cellar - Websession failover 2014-‐10-‐23 51 Node A Hazelcast DataBase Client Filter Servlet Node B Filter Servlet
- 78. Cellar - Websession failover 2014-‐10-‐23 51 Node A Hazelcast DataBase Client Filter Servlet Node B Filter Servlet
- 79. Cellar - Websession failover 2014-‐10-‐23 51 Node A Hazelcast DataBase Client Filter Servlet Node B Filter Servlet
- 80. Cellar - Websession failover 2014-‐10-‐23 51 Node A Hazelcast DataBase Client Filter Servlet Node B Filter Servlet
- 81. Cellar - Websession failover 2014-‐10-‐23 51 Node A Hazelcast DataBase Client Filter Servlet Node B Filter Servlet
- 82. Cellar - Websession failover 2014-‐10-‐23 51 Node A Hazelcast DataBase Client Filter Servlet Node B Filter Servlet
- 83. Cellar - Websession failover 2014-‐10-‐23 51 Node A Hazelcast DataBase Client Filter Servlet Node B Filter Servlet
- 84. Cellar - Websession failover 2014-‐10-‐23 51 Node A Hazelcast DataBase Client Filter Servlet Node B Filter Servlet
- 85. Cellar - Websession failover 2014-‐10-‐23 51 Node A Hazelcast DataBase Client Filter Servlet Node B Filter Servlet
- 86.
- 87.
- 88. web.xml - Hazelcast 2014-‐10-‐23 54 • Hazelcast for Session Replication <?xml version="1.0" encoding="UTF-8"?> <web-app 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_3_0.xsd" version="3.0"> <filter> <filter-name>hazelcast-filter</filter-name> <filter-class>com.hazelcast.web.WebFilter</filter-class> <!-- Name of the distributed map storing your web session objects --> <init-param> <param-name>map-name</param-name> <param-value>my-sessions</param-value> </init-param> <init-param> <param-name>sticky-session</param-name> <param-value>false</param-value> </init-param> </filter> <filter-mapping> <filter-name>hazelcast-filter</filter-name> <url-pattern>/*</url-pattern> <dispatcher>FORWARD</dispatcher> <dispatcher>INCLUDE</dispatcher> <dispatcher>REQUEST</dispatcher> </filter-mapping> <listener> <listener-class>com.hazelcast.web.SessionListener</listener-class> </listener> </web-app>
- 89.
- 90.
- 91.
- 92.
- 93. Enterprise - Karaf 2014-‐10-‐23 59 Servlet 3 EJB 3.1 CDI JSF 2 JSP JPA 2 JTA JAX-WS JAX-RPC JAX-RS JAXR SAAJ JAXB JMS JNDI JAAS RMI
- 94. JEE with Karaf? • Adoptions needed? YES • Minor on Persistence - JNDI lookup • Minor on transaction - Blueprint JTA • Wiring of Services: • Use Blueprint • Use Servlet 3.0 with CDI - @OsgiService • Session Replication throughout cluster, it’s still standard Hazelcast 2014-‐10-‐23 60
- 95. Resources • @anierbeck • notitzblog.nierbeck.de • https://github.com/ANierbeck/karaf-enterprise-sample • www.codecentric.de • karaf.apache.org • https://ops4j1.jira.com/wiki/display/paxweb/Pax+Web • #karaf at irc.codehaus.org • https://www.packtpub.com/application-development/apache-karaf-cookbook • Pictures, mainly from flickr 2014-‐10-‐23 61
- 97.
- 98. Thanks to theApache Community
- 99.
- 100.