Enterprise JavaBeans 3.0

Transkrypt

1 Enterprise JavaBeans 3.0 Jacek Laskowski Politechnika Poznańska Poznań, , wersja 1

2 O mnie... Entuzjasta technologii Java EE 5 Założyciel i lider Warszawa JUG Członek zespołów rozwojowych Apache Geronimo, Apache OpenEJB, Apache ServiceMix, Apache ActiveMQ, Apache XBean Uczestnik programów NetBeans Community Acceptance Test (NetCAT) 5.0, 5.5 i 6.0 Prowadzi Notatnik Projektanta Java EE - Założyciel Polskiej Grupy Użytkowników Technologii BEA (PLBUG) Służbowo: konsultant oprogramowania w IBM

3 Certyfikacja SCBCD 5

4 Literatura

5 Specyfikacje

6 Enterprise JavaBeans 3.0 Enterprise JavaBeans (EJB) rozproszony model komponentów aplikacyjnych Część Java EE 5 Specyfikacja EJB3 zatwierdzona 2 maja 2006r. Implementacje: GlassFish referencyjna implementacja Java EE 5 Apache Geronimo 2 z Apache OpenEJB 3 IBM WebSphere Application Server 6.1 z EJB 3.0 Feature Pack BEA WebLogic Server 10 JBoss AS z dodatkiem EJB 3.0

7 Fundamenty EJB3 POJO (ang. Plain-Old Java Object) powrót do korzeni JavaBeans Konfiguracja przez nadpisywanie (ang. configuration by exception) Java SE 5 a przede wszystkim adnotacje Wstrzeliwanie zależności (ang. DI dependency injection) Interceptory (ang. interceptors) Plik jar jako format dystrybucji

8 Projekty otwarte a EJB3 Kształt EJB3 pod wpływem projektów otwartych (ang. OSS open source software) Spring Framework Hibernate XDoclet AspectWerkz/AspectJ...wiele innych

9 Rezultat prac nad EJB3 Intuicyjne tworzenie komponentów biznesowych Bezinwazyjność realizujemy założenia biznesowe a nie specyfikacji Dowolne Java IDE Brak wymagań odnośnie środowiska programistycznego Możliwość uruchomienia komponentów encyjnych w ramach Java SE Uproszczone testowanie poza środowiskiem serwera aplikacyjnego

10 Typy komponentów EJB3 Bezstanowe ziarno sesyjne (ang. SLSB stateless session bean) Stanowe ziarno sesyjne (ang. SFSB stateful session bean) Ziarno sterowane komunikatami (ang. MDB message-driven bean) Komponent encyjny encja (ang. entity bean)

11 Przeznaczenie biznesowe komponentów Ziarno sesyjne nietrwały, ulotny, modeluje akcje (na encjach) SLSB agent bezstanowy (czasownik) SFSB podobnie jak SLSB tyle, że dla wybranego klienta utrzymuje jego stan (rzeczownik) Ziarno sterowane komunikatami asynchroniczna komunikacja Encja trwały (najczęściej baza danych) Encja byt (rzeczownik)

12 Konfiguracja przez nadpisywanie ang. Configuration by exception (CbE) Brak konfiguracji = w użyciu domyślne parametry konfiguracyjne Porządek ważności parametrów konfiguracyjnych Domyślne wartości Annotacje Deskryptor instalacji (META-INF/ejb-jar.xml)

13 Korzyści CbE Szybkie tworzenie komponentów Uproszczone prototypowanie Możliwość nadpisywania wartości konfiguracyjnych na życzenie, np. per środowisko Stosowanie annotacji jako dokumentacja kodu i możliwe nadpisanie w deskryptorze instalacji

14 Typy interfejsów Interfejs biznesowy Lokalny Zdalny Interfejs usługi internetowej (ang. web services) per klasa per metoda (wyłącznie SLSB) Interfejs biznesowy MDB to interfejs usługi komunikatów, np. javax.jms.messagelistener dla JMS

15 Interceptory Interceptor to metoda przechwytująca zdarzenia związane ze stadiami rozwojowymi ziarna bądź wywołaniem jego metod biznesowych Wyłącznie dla komponentów sesyjnych i MDB na klasie komponentu Domyślne interceptory w deskryptorze InvocationContext interfejs komunikacyjny dla wielu interceptorów związanych z pojedyńczym komponentem

16 Interceptory rozwojowe Interceptory zwrotne związane ze stadiami rozwojowymi ziarna (ang. lifecycle callback interceptor Sygnatura: void metoda() i void metoda(invocationcontext)

17 Interceptory biznesowe Interceptory biznesowe (ang. business method interceptors) uruchamiane przed wywołaniem metod bądź around-invoke w DD Sygnatura metody: public Object metoda(invocationcontext) throws Exception

18 Sytuacje wyjątkowe Wyróżniamy wyjątki aplikacyjne i systemowe Wyjątki aplikacyjne związane z działaniem biznesowym komponentu, w ramach aplikacji (deklaracja poprzez dowolna klasa wyjątku kontrolowanego lub nie, która przekazywana jest klientowi bezpośrednio application-exception w deskryptorze instalacji (ejb-jar.xml) Obsługa transakcji poprzez element rollback

19 Sytuacje wyjątkowe - cd. Wyjątki systemowe związane z działaniem komponentu jako części serwera RemoteException i RuntimeException i ich podklasy (za Przykłady: Brak połączenia z bazą danych Wyjątki związane z działaniem JNDI Błędy wirtualnej maszyny Java (JVM) Opakowane jako javax.ejb.ejbexception W efekcie wycofanie transakcji i usunięcie komponentu z systemu

20 Tworzenie ziarna EJB3 2-krokowy proces: 1.Definiowanie interfejsu biznesowego 2.Klasa ziarna jako implementacja interfejsu biznesowego

21 Komponent EJB3 - przykład Interfejs biznesowy - ExamScheduler package pl.jaceklaskowski.exam.scheduler; import java.util.list; import pl.jaceklaskowski.exam.beans.exam; public interface ExamScheduler { } List<Exam> getexams();

22 Komponent EJB3 - przykład Klasa komponentu package pl.jaceklaskowski.exam.scheduler; import java.util.list; import pl.jaceklaskowski.exam.beans.exam; public class ExamSchedulerBean implements ExamScheduler { public List<Exam> getexams() { return...; } } Nie, to nie wszystko... ;-)

23 Komponent EJB3 - przykład Obowiązkowo określamy typ komponentu package pl.jaceklaskowski.exam.scheduler; import java.util.list; import javax.ejb.stateless; import public class ExamSchedulerBean implements ExamScheduler { public List<Exam> getexams() { return...; } }

24 Pytania? Nie! To jeszcze nie koniec...

25 Laboratoria - agenda Utworzenie aplikacji przemysłowej z EJB3 Ziarno sterowane komunikatami (MDB) z klientem zdalnym Ziarno MDB Usługa sieciowa JAX-WS jako bezstanowe ziarno sesyjne (SLSB) Wykorzystane oprogramowanie: Eclipse z wtyczką dla Geronimo NetBeans IDE 6.0

26 Pytania? Nie! To jeszcze nie koniec...

27 Java Persistence API 1.0 Java Persistence API interfejs programistyczny do obiektowej obsługi danych składowanych w relacyjnych bazach danych Część Java EE 5 w ramach EJB3 Specyfikacja JPA 1.0 zatwierdzona 2 maja 2006r. Implementacje: Apache OpenJPA TopLink Essentials (TopLink JPA) Hibernate EntityManager (Hibernate JPA)

28 Fundamenty JPA POJO (ang. Plain-Old Java Object) powrót do korzeni JavaBeans Konfiguracja przez nadpisywanie (ang. configuration by exception) konfiguracja jest wyjątkiem od ogólnie przyjętej reguły Java SE 5 a przede wszystkim adnotacje Wstrzeliwanie zależności (ang. DI dependency injection) alternatywa dla JNDI Plik jar jako format dystrybucji

29 Rezultat prac nad JPA Intuicyjne tworzenie komponentów biznesowych Bezinwazyjność - realizujemy założenia biznesowe a nie specyfikacji Brak wymagań odnośnie środowiska programistycznego dowolne Java IDE Możliwość uruchomienia komponentów encyjnych w ramach Java SE Uproszczone testowanie poza środowiskiem serwera aplikacyjnego

30 Nomenklatura JPA Encja obiekt trwały (egzemplarz klasy encji) Klasa encji klasa reprezentująca stan encji Zarządca encji interfejs do zarządzania kontekstem trwałym Fabryka zarządców encji interfejs do tworzenia (aplikacyjnych) zarządców trwałych Kontekst trwały zbiór zarządzanych obiektów trwałych, w którym dla danego identyfikatora trwałego istnieje pojedyńczy egzemplarz encji

31 Liczność bytów JPA Za Pro EJB 3 Java Persistence API Apress strona 24

32 EntityManagerFactory API EntityManager createentitymanager() EntityManager createentitymanager(map map) void close() boolean isopen()

33 Stadia rozwojowe encji Encja nowa (ang. new) Utworzenie egzemplarza klasy encji Brak identyfikatora trwałego Encja nie związana z żadnym kontekstem trwałym Encja zarządzana (ang. managed) Przypisany trwały identyfikator Encja związana z kontekstem trwałym Zmiany automatycznie zapisywane w bazie danych

34 Stadia rozwojowe encji kont. Encja odłączona (ang. detached) Encja posiadająca identyfikator trwały Nie związana z kontekstem trwałym Zmiany nie mają odzwierciedlenia w bazie danych Zwykły egzemplarz klasy encji Encja usunięta (ang. Removed) Encja zarządzana oczekująca trwałego usunięcia Nie istnieje API do rozpoznania stadium rozwojowego encji, ale...

35 EntityManager API void clear() Czyści kontekst trwały Wszystkie zarządzane encje przechodzą w stan odłączony <T> T merge(t entity) Synchronizuje stan encji z kontekstem trwałym Przejście ze stanu odłączonego w stan zarządzany UWAGA: Jedynie zwrócona encja jest zarządzana void persist(object entity) Utrwalenie egzemplarza encji Encja w stanie zarządzanym

36 EntityManager API kont. void refresh(object entity) Odświeża stan encji danymi z bazy danych Nadpisuje zmiany stanu encji void remove(object entity) Usuwa encję

37 Pytania? Nie! To jeszcze nie koniec...

38 Środowisko rozpoznawania JPA Korzysta z Apache Maven Tworzenie artefaktów projektowych w wybranym IDE (obecnie Eclipse IDE 3.3) Możliwość wyboru dostawcy JPA oraz bazy danych domyślnie Apache OpenJPA z Apache Derby Uruchomienie testów z poziomu IDE lub linii poleceń

39 Przykład #1 cykl rozwojowy encji Przykład demonstruje użycie interfejsu EntityManager Klasa LifecycleTest mvn -Dtest=LifecycleTest clean test

40 Konfiguracja JPA META-INF/persistence.xml plik konfiguracyjny JPA (deskryptor XML dla JPA) Opisuje konfigurację zarządcy encji Obowiązkowy atrybut: nazwa jednostki trwałej Dostawca JPA Obsługa transakcji Klasy encji Właściwości konfiguracyjne dostawcy JPA Może istnieć wiele definicji jednostek trwałych

41 (Aplikacyjna) konfiguracja JPA <?xml version="1.0" encoding="utf-8"?> <persistence version="1.0" xmlns=" xmlns:xsi=" xsi:schemalocation=" ns/persistence/persistence_1_0.xsd"> <persistence-unit name="testpu" transaction-type="resource_local"> <provider>org.apache.openjpa.persistence.persistenceproviderimpl</provider> <class>pl.jaceklaskowski.jpa.entity.osoba</class> <class>pl.jaceklaskowski.jpa.entity.projekt</class> <class>pl.jaceklaskowski.jpa.entity.pracownikspecjalny</class> <class>pl.jaceklaskowski.jpa.entity.a</class> <exclude-unlisted-classes>true</exclude-unlisted-classes> <properties> <property name="openjpa.connectiondrivername" value="org.apache.derby.jdbc.embeddeddriver" /> <property name="openjpa.connectionurl" value="jdbc:derby:target/derbydb;create=true" /> <property name="openjpa.connectionusername" value="app" /> <property name="openjpa.connectionpassword" value="app" /> <property name="openjpa.jdbc.dbdictionary" value="derby" /> <property name="openjpa.jdbc.synchronizemappings" value="buildschema(schemaaction='add,deletetablecontents')" /> <property name="openjpa.log" value="defaultlevel=trace,sql=trace" /> <!-- Breaks maven-surefire-plugin with TestNG --> <property name="openjpa.querycompilationcache" value="false" /> </properties> </persistence-unit> </persistence>

42 (Serwerowa) konfiguracja JPA <?xml version="1.0" encoding="utf-8"?> <persistence version="1.0" xmlns=" xmlns:xsi=" xsi:schemalocation=" ns/persistence/persistence_1_0.xsd"> <persistence-unit name="testyejb3encjepu"> <jta-data-source>jdbc/testyejb3postgres</jta-data-source> <properties> <property name="toplink.ddl-generation" value="drop-and-create-tables" /> <property name="toplink.logging.level" value="info" /> </properties> </persistence-unit> </persistence>

43 Przykład #2 JPA w Java SE Przykład demonstruje konstrukcję samodzielnej aplikacji korzystającej z JPA (w trybie poza kontenerem) Na podstawie artykułów w moim Wiki OpenJPA jako dostawca JPA w samodzielnej aplikacji Java Persistence API w samodzielnej aplikacji Hibernate jako dostawca JPA w samodzielnej aplikacji

44 Przykład #3 JPA w Java EE Przykład demonstruje prostotę tworzenia aplikacji korporacyjnej korzystającej z usług serwera aplikacyjnego Java EE 5 Zlecenie obsługi elementów składowych kontenerowi (serwerowi) Ziarno bezstanowe EJB z JPA Na podstawie artykułu w moim Wiki Aplikacja korporacyjna z JPA w trybie JTA z GlassFish i PostgreSQL

45 Pytania? Nie! To jeszcze nie koniec...

46 Tworzenie encji Zbudowanie klasy reprezentującej byt w domenie biznesowej (POJO) Uaktywnienie klasy jako klasy encji za pomocą adnotacji Adnotacje na polach Adnotacje na metodach odczytujących (ang. setter) Definicja jednostki trwałej (persistence.xml) Opcjonalna definicja mapowania Adnotacje Plik META-INF/orm.xml

47 Podstawowe adnotacje oznaczenie klasy jako klasy oznaczenie pola jako typu identyfikatora trwałego

48 Encja Prelegent package pl.jaceklaskowski.ejb3.testy.encje; import java.io.serializable; import javax.persistence.entity; import public class Prelegent implements Serializable { private static final long serialversionuid = private long id; private String imie; private String nazwisko; public Prelegent() { } public Prelegent(String imie, String nazwisko) { this.imie = imie; this.nazwisko = nazwisko; } public long getid() { return id; } // Zauważ zmianę widoczności metody, aby wybrani mogli z niej skorzystać void setid(long id) { this.id = id; } } // metody modyfikujace i odczytujące

49 Mapujące adnotacje tabela podstawowa dla definicja charakterystyki generator AUTO, IDENTITY, SEQUENCE, TABLE strategy @Basic z atrybutem fetch (domyślnie EAGER)

50 Konfiguracja mapowania JPA Plik META-INF/orm.xml Ważniejszy niż konfiguracja mapowania za pomocą adnotacji Każdej adnotacji odpowiada element deskryptora mapowania

51 Przykładowy orm.xml <entity-mappings xmlns=" version="1.0"> <entity class="pl.jaceklaskowski.jpa.entity.a"> <attributes> <basic name="str2"> <column name="col2" length="4" /> </basic> </attributes> </entity> </entity-mappings>

52 Typy zarządców encji Podział ze względu na zarządzanie nimi Aplikacyjny zarządca encji Serwerowy zarządca encji Podział ze względu na transakcje Zarządca encji JTA Zarządca encji lokalny dla zasobu

53 Pytania? Nie! To jeszcze nie koniec...

54 Java Persistence QL Java Persistence Query Language (JPQL) język zapytań JPA łudząco podobny do SQL Obowiązkowe klauzule SELECT... FROM... EntityManager.createN...Query() N... = Named lub Native Zapytania nazwane Zapytania lub lub named-native-query

55 Query API int executeupdate() List getresultlist() Object getsingleresult() Query setparameter() Parametry w zapytaniu poprzedzone dwukropkiem Parametry metody setparameter już bez niego

56 Pytania? Nie! To jeszcze nie koniec, ale już blisko...

57 Lektura do poduszki Specyfikacja JPA final/jsr220/index.html Strona Java Persistence API technologies/persistence.jsp Relacje z lektury specyfikacji JPA w Notatniku Artykuły o JPA na moim Wiki Aplikacja korporacyjna z JPA w trybie JTA z GlassFish i PostgreSQL Java Persistence API w samodzielnej aplikacji OpenJPA jako dostawca JPA w samodzielnej aplikacji Hibernate jako dostawca JPA w samodzielnej aplikacji

58 Laboratoria - agenda Utworzenie aplikacji przemysłowej z EJB3 Ziarno sterowane komunikatami (MDB) z klientem zdalnym Ziarno MDB z JPA w trybie JTA Usługa sieciowa JAX-WS jako bezstanowe ziarno sesyjne (SLSB) z JPA Wykorzystane oprogramowanie: Eclipse z wtyczką dla Geronimo NetBeans IDE 6.0

59 I to na dziś tyle...pytania? Słucham?