EJB<\/strong> of”Enterpsie JavaBeans’ zijn bedoeld voor\u00a0je applicatie logica en draaien binnen een EJB container op je applicatieserver. De EJB\u00a0schrijft o.a.\u00a0voor hoe omgegaan dient te worden met zaken als trancties, concurrency en security. Het schrijven van EJB’s is pas echt een feest sinds EJB 3.0 waar annotaties de\u00a0warboel van deployment descriptors en interfaces hebben vervangen. (@Wikipedia<\/a>)<\/p>\n JPA\u00a0<\/strong>of ‘Java Persistence API’ is een een specificatie die beschrijft hoe van uit Java\u00a0met (relationele) data omgegaan dient te worden. Met JPA breng je een object-relational-mapping tot stand o.b.v. annotaties. \u00a0JPA kent een aantal implementaties waarvan de bekendste wellicht Hibernate is.<\/p>\n EclipseLink\u00a0<\/strong>is de ‘referentie implementatie’ voor JPA en is (net zoals overigens Hibernate) volledig JPA 2.0 complient. \u00a0(@EclipseLink FAQ<\/a>, @Wikipedia<\/a>)<\/p>\n MySQL\u00a0<\/strong>is\u00a0‘s werelds meest gebruikte opensource RDBMS. En vergt volgens mij geen verdere toelichting.<\/p>\n Welnu, de voorbeeld implementatie betreft een denkbeeldig onderdeel van een beheerplatform. Het stukje ‘UserManagement’ is bedoeld om informatie van gebruikers van ‘het systeem’ aan te maken, of te raadplegen.<\/p>\n De demo bestaat uit een Stateless Session Bean (SSB) ‘UserManagement’ die met zijn twee methoden (t.b.v create\/retreive) beschikbaar wordt gesteld via JAX-RS. De User objecten worden gemanaged, opgehaald en opgeslagen in MySQL d.m.v. EclipseLink.<\/p>\n 1. Structuur \/ overzicht<\/b><\/p>\n Om te beginnen hieronder een overzicht van\u00a0het project. In dit project zit geen web.xml, alle configuratie gebeurt o.b.v. annotaties.<\/p>\n 2. EclipseLink & Mysql configuratie<\/strong><\/p>\n De basisconfiguratie van JPA wordt gevormd door persistence.xml. Hierin configureer je ‘Persistence Units’. Een persistent unit is een groep van ‘persistable classes’ met bijbehorende configuratie.<\/p>\n In bovenstaand voorbeeld configureren we een persisten-unit met de naam ‘default’. Het ‘transaction-type’ JTA (@wiki<\/a>) wordt afgedwongen doordat we JPA binnen de EJB managed context gebruiken.<\/p>\n We gebruiken EclipseLink (<provider\/>) en maken gebruik van de ‘java:app\/ee6sample\/SampleDS’ datasource (zie volgend onderdeel).<\/p>\n Waar je normaal gesproken met <class\/> configureert welke klassen bij deze persistence-unit horen, geven we in dit voorbeeld aan dat niet geconfigureerde klassen opgenomen kunnen worden in deze PU. Met slechts \u00e9\u00e9n PU laten we alle klassen dus managen door default. (exclude-unlisted-classes = false).<\/p>\n Aanvullend specificeren we dat de DDL voor de tabellen direct op de databases uit laten voeren. Anders verwoord, JPA gaat de tabellen aanmaken voor onze applicatie.<\/p>\n 3. Datasources.java – Datasource registratie m.b.v. annotaties<\/strong><\/p>\n Sinds\u00a0JSR-250 is er de mogleijkheid om datasources te regiteren met behulp van de annotaties @DataSourceDefinition en @DataSourceDefinitions. Voorheen was het altijd nodig om deze configuratie in de applicatie server uit te voeren, maar nu wordt deze configuratie dus portable.<\/p>\n Onderstaand codevoorbeeld registreert een datasource in de applicatie scope.<\/p>\n Deze configuratie valt uiteraard onder de noemer ‘hard-coded’, maar kan eventueel worden overriden in de web.xml<\/p>\n 4. User.java – een JPA managed entiteit<\/strong><\/p>\n De klasse User is een POJO geannoteerd met @Entity waarmee we zeggen dat dit een door ‘JPA gemanagde entiteit’ is.\u00a0Met de aangebrachte annotatie zal deze entiteit corresponderen met de\u00a0 tabel User (ID int(11) primary key, NAME varchar(255))<\/span>\u00a0.<\/p>\n De tabel – indien hij niet bestaat – zal automatisch worden aangemaakt door EclipseLink. Waarden voor ID zullen automatisch worden gegenereerd (@Id).<\/p>\n Uiteraard zijn er veel meer annotaties en instellingen, een mooi overzicht vondt ik op de website van de ObjectDB JPA implementatie<\/a>.<\/p>\n \u00a05. UserManagement.java – een JAX-RS exposed SSB met een EntityManager<\/strong><\/p>\n De klasse UserManagement\u00a0bevat de business logica voor het managen\u00a0van users. In dit geval een Stateless Session Bean (@Stateless) met twee methoden. Een om een user mee aan te maken, een andere om user-gegevens op te vragen a.d.h.v. een user id. Beide methoden worden aangeboden\u00a0via JAX-RS webservices. De\u00a0annotaties spreken voor zich wanneer je beseft dat ze het volgende mogelijk maken:<\/p>\n HTTP PUT http:\/\/localhost:8080\/Demo\/rest\/users?name=Ivo<\/em> HTTP GET http:\/\/localhost:8080\/Demo\/rest\/users?id=1<\/em> Met @PersistenceContext injecteren we een container-managed entity manager. Deze gebruiken we vervolgens om nieuwe Users aan te maken of terug te halen uit de database.<\/p>\n Naast de @QueryParam kun je ook nog annotaties als \u00a0@MatrixParam, @HeaderParam, @CookieParam, @FormParam gebruiken om b.v. headers of cookiers te benaderen.<\/em><\/p>\n \u00a06.\u00a0JerseyConfig.java<\/strong><\/p>\nDe implementatie<\/h3>\n
![\"Java](\"http:\/\/h2916922.stratoserver.net:8084\/wp-content\/uploads\/2015\/05\/Java-EE-JAX-RS-EJB-and-JPA-EclipseLink-Mysql-mbv-annotaties..png\")
<\/p>\n<persistence-unit name=\"default\" transaction-type=\"JTA\">\r\n\t<provider>org.eclipse.persistence.jpa.PersistenceProvider<\/provider>\r\n\r\n\t<jta-data-source>java:app\/ee6sample\/SampleDS<\/jta-data-source>\r\n\r\n\t<exclude-unlisted-classes>false<\/exclude-unlisted-classes>\r\n\r\n\t<properties>\r\n\t\t<property name=\"eclipselink.ddl-generation\" value=\"create-tables\" \/>\r\n\t\t<property name=\"eclipselink.ddl-generation.output-mode\"\tvalue=\"database\" \/>\r\n\t<\/properties>\r\n<\/persistence-unit><\/pre>\n
package nl.ivojonker.ee6sample.configuration;\r\n\r\nimport javax.annotation.sql.DataSourceDefinition;\r\n\r\n\r\n\/**\r\n * Registers the following datasources: \r\n * \t\tjava:app\/ee6sample\/SampleDS\r\n * \r\n * web.xml allow's to override the defaults.\r\n * @author ivo.jonker\r\n *\/\r\n\r\n@DataSourceDefinition(\r\n\t\tname = \"java:app\/ee6sample\/SampleDS\",\r\n\t\tclassName = \"com.mysql.jdbc.jdbc2.optional.MysqlXADataSource\",\r\n\t\turl = \"jdbc:mysql:\/\/localhost:3306\/ivo\",\r\n\t\tuser = \"root\",\r\n\t\tpassword = \"\") \r\n\r\npublic class Datasources {\r\n\r\n}<\/pre>\npackage nl.ivojonker.ee6sample.model;\r\n\r\nimport javax.persistence.Entity;\r\nimport javax.persistence.GeneratedValue;\r\nimport javax.persistence.Id;\r\n\r\n@Entity\r\npublic class User {\r\n\r\n\t@Id\r\n\t@GeneratedValue\r\n\tprivate int id;\r\n\t\r\n\tprivate String name;\r\n\r\n\tpublic int getId() {\r\n\t\treturn id;\r\n\t}\r\n\r\n\tpublic void setId(int id) {\r\n\t\tthis.id = id;\r\n\t}\r\n\r\n\tpublic String getName() {\r\n\t\treturn name;\r\n\t}\r\n\r\n\tpublic void setName(String name) {\r\n\t\tthis.name = name;\r\n\t}\r\n}\r\n<\/pre>\n
\nOm een nieuwe gebruiker aan te maken<\/p>\n
\nOm een gebruikergegevens met id 1 op te halen uit de database.<\/p>\npackage nl.ivojonker.ee6sample.logic;\r\n\r\nimport javax.ejb.Stateless;\r\nimport javax.persistence.EntityManager;\r\nimport javax.persistence.PersistenceContext;\r\nimport javax.ws.rs.GET;\r\nimport javax.ws.rs.PUT;\r\nimport javax.ws.rs.Path;\r\nimport javax.ws.rs.Produces;\r\nimport javax.ws.rs.QueryParam;\r\n\r\nimport nl.ivojonker.ee6sample.model.User;\r\n\r\n@Stateless\r\n@Path(\"\/users\")\r\n@Produces(\"text\/plain\")\r\npublic class UserManagement {\r\n\t\r\n\t@PersistenceContext\r\n\tEntityManager em;\r\n\r\n\t@GET\r\n\tpublic String getUser(@QueryParam(\"id\") int id){\r\n\t\tUser user = em.find(User.class, id);\r\n\t\treturn \"username: \"+user.getName();\r\n\t}\r\n\t\r\n\t@PUT\r\n\tpublic String createUser(@QueryParam(\"name\") String name){\r\n\t\tUser newUser = new User();\r\n\t\tnewUser.setName(name);\r\n\t\t\r\n\t\tem.persist(newUser);\r\n\t\t\r\n\t\treturn \"New user created with id: \"+newUser.getId();\r\n\t}\r\n}\r\n<\/pre>\n