Obiettivo della lezione

Transcript

1 Obiettivo della lezione Lezione 17 Enterprise JavaBeans (5) Vittorio Scarano Corso di Sistemi Distribuiti ( ) Laurea Specialistica in Informatica Università degli Studi di Salerno Comprendere quanto è complesso scrivere un EJB entity che la cui persistenza sia a carico del bean stesso (Bean Managed Persistent) 2 Organizzazione della lezione Due modalità diverse degli Entity EJB Entity bean e le due modalità di persistenza Le caratteristiche di un Entity Bean Bean Managed Persistent (BMP) Implementazione di un BMP Entity bean E necessario che sia scritto il codice che accede al database per poter assicurare la persistenza degli oggetti entity se lo fa lo sviluppatore, allora si ha un bean-managed persistent bean (BMP Entity Bean) altrimenti, lo fa il container e si ha un container-managed persistent bean (CMP Entity Bean) lo sviluppatore informa solamente del tipo di operazioni e della struttura del bean, poi il container a deployment time crea il codice necessario enorme risparmio di codice 3 4

2 Creazione e distruzione di Entity EJB Un esempio di creazione All atto della creazione e rimozione di un entity Se il metodo di un AccountBean è: si deve fisicamente creare nel DB di supporto (ad es.) una riga in una tabella (creazione) oppure si deve cancellare L oggetto Home dell Entity si occupa di effettuare la creazione dell entity che prende come parametri i dati necessari per riempire il record e restituisce un parametro di chiave primaria (come definito dallo sviluppatore) public AccountPK ejbcreate(string accountid, String owner) throws.. La interfaccia di home deve avere: public Account create(string accountid, String owner) throws La creazione di un entity EJB Altre caratteristiche di Entity EJB Ricerca di entity Necessario specificare, per gli entity bean-managed, uno (o più) metodi di finder() servono per poter implementare la ricerca di un dato bean corrispondono di solito ad una SELECT SQL Modifica di dati del Bean senza usare EJB ovviamente, se si usa un DB, si possono modificare i dati direttamente sul DB (utile per i legacy) e i cambi sono riflessi sull entity attenzione alla configurazione del container per i problemi di caching! Problemi di coerenza 7 8

3 Organizzazione della lezione Contesto di Entity EJB: javax.ejb.entitycontext Entity bean e le due modalità di persistenza Ereditato da javax.ejb.ejbcontext, aggiunge Le caratteristiche di un Entity Bean Bean Managed Persistent (BMP) Implementazione di un BMP Entity bean oltre a metodi per la gestione dei EJBObject (una specie di this) il metodo getprimarykey() che restituisce la chiave associata alla istanza del bean A cosa serve? essenzialmente per evitare che ci siano problemi con il riuso ed il pooling di risorse: si chiama per poter sapere ejbload() da che riga della tabella deve caricare i dati oppure si chiama per ejbremove() 9 10 BMP Entity Bean: : i metodi da implementare Metodo setentitycontext() 11 Per un BMP Entity Bean sono da implementare un certo numero di metodi: setentitycontext() ejbfindxxxx() ejbhomexxxx() ejbcreate() ejbpostcreate() ejbactivate() ejbload() ejbstore() ejbpassivate() ejbremove() unsetentitycontext() 12 se il container genera una nuova istanza (per aumentare il pool disponibile), il metodo viene chiamato subito dopo per associare il bean all ambiente memorizzare il context in una variabile membro per accessi successivi (ad es. sicurezza) definire altre risorse necessarie per il bean (senza riferimento alcuno a quali dati il bean sta rappresentando) il bean è nel pool e non contiene dati in quanto non legato a nessun oggetto EJB

4 Metodi finder: ejbfindxxx() Metodi di home: ejbhomexxxx() localizzare istanze di dati nel sistema di memorizzazione persistente. Per un BMP almeno un metodo finder deve essere definito ricerca attraverso una query (via JDBC o altro) sul DB e restituisce una primary key il bean non è più nel pool, contiene dati specifici all interno in quanto viene associato ad un oggetto EJB metodi che non si riferiscono ad una istanza di dati particolare (contare il numero di record in una tabella) una sorta di metodi statici per tutti gli entity beans di quel tipo accessibili via la Home interface Es. contare quanti righi (record) ha una tabella non applicabile, in quanto non viene influenzato alcun entity bean Metodi di creazione: ejbcreate() Metodi di post-creazione: ejbpostcreate() 15 quando un client chiama create() sull oggetto Home, allora il container chiama ejbcreate() su un bean nel pool responsabile creazione e inizializzazione possibile non crearli (se si vuole creare dati solo via DB) controllati i parametri, si usa una INSERT SQL nel DB restituisce la primary key l istanza non è più nel pool ed ha dati specifici 16 necessario definire un ejbpostcreate() per ogni ejbcreate() (con la stessa firma) viene chiamato subito dopo la ejbcreate() dopo che l oggetto EJB viene associato con i dati completare la installazione dell oggetto, settando parametri extra (potrebbero essere stati usati da dati precedentemente memorizzati nel bean) l istanza non è più nel pool, ha dati specifici e contiene eventuali dati addizionali inizializzati correttamente

5 Metodo ejbactivate() Metodo ejbload() quando un client chiama un metodo di un EJB object ma nessuna istanza è legata a quell oggetto, il container prende un bean del pool e lo rende ready (attivazione), subito dopo chiama il metodo acquisisce le risorse necessarie (es. socket) al bean non si devono leggere i dati nel bean (c è ejbload() per questo e viene chiamato subito dopo) il bean è ready per poter leggere i dati dopo la attivazione di un bean, viene chiamato questo metodo per caricare i dati del DB nel bean attraverso il metodo getprimarykey() (del contesto) il Bean reperisce informazioni che permettono di caricare i dati attraverso una query il bean è ready e contiene i dati necessari Metodo ejbstore() Metodo ejbpassivate() il container chiama il metodo per sincronizzare i dati nell oggetto con il DB aggiorna esplicitamente la rappresentazione nel DB dei dati dell oggetto (tipicamente una query UPDATE) il bean in-memory contiene gli stessi dati del DB il container chiama il metodo per far ritornare il bean nel pool di bean disponibili (passivazione) rilascia le risorse acquisite (socket, etc.) attraverso la ejbactivate() non si devono scrivere i dati nel DB (c è ejbstore() per questo ed è stato chiamato subito prima di ejbpassivate()) il bean è nel pool e non contiene più dati usabili (che sono nel DB) 19 20

6 Metodo ejbremove() Metodo unsetentitycontext() elimina i dati dal DB (non l oggetto, che viene rimesso nel pool) attraverso il metodo getprimarykey() (del contesto) il Bean reperisce informazioni che permettono di identificare i dati da cancellare (attraverso una REMOVE SQL) il bean è nel pool ed i dati che conteneva non sono più utilizzabili e sono stati cancellati anche dal DB eliminare la associazione del bean con il contesto il metodo viene chiamato quando il container vuole ridurre la dimensione del pool e vuole eliminare l oggetto rilasciare le risorse eventualmente acquisite con setentitycontext() l oggetto verrà reso disponibile per la garbage collection Alcuni commenti sui metodi finder (1) Alcuni commenti sui metodi finder (2) Tra i metodi finder, deve essere presente (almeno) Se il metodo finder di un AccountBean è: ejbfindbyprimarykey() Un finder deve restituire una PrimaryKey oppure un insieme di PrimaryKey I client non invocano mai i metodi finder sull oggetto ma sulla interfaccia quindi necessario definire nella interfaccia la controparte di ogni metodo finder definito nell EJB nell EJB deve avere lo stesso nome e signature (a parte il valore restituito) della interface con ejb iniziale e la f di Find maiuscola esempio: findbyname(string s) diventa ejbfindbyname(string s) public AccountPK ejbfindbigaccounts(int minimum) throws FinderException La interfaccia di home (locale) deve avere: public Accountlocal findbigaccounts(int minimum) throws FinderException se la interfaccia di home remota ha lo stesso metodo deve lanciare anche RemoteException 23 24

7 Organizzazione della lezione Implementazione di un BMP entity bean 25 Entity bean e le due modalità di persistenza Le caratteristiche di un Entity Bean Bean Managed Persistent (BMP) Implementazione di un BMP Entity bean 26 Complessa e tediosa un esempio (cap. 6 di Mastering EJB ) di gestione di un account Presentiamo la implementazione per grandi linee i dettagli ed il codice serviranno per il confronto con i Container-managed Persistent (CMP) Entity Beans Commento sulle interfacce tipicamente gli entity bean implementano solamente le interfacce local, in quanto tipicamente vengono chiamati solamente da altri oggetti (EJB session, servlet, etc.) che sono locali per motivi di testing, viene comunque di solito fornita una interface remota (che viene soppressa in produzione) Lo schema di AccountBean Commenti su Account e AccountLocal Sono le interfaccia (remota e locale) offerte dal container verso il client Metodi di business: deposit() withdraw() Vari metodi accessori getbalance() (e non il setbalance() ) getaccountid() e setaccountid() Differenza i metodi della interfaccia remota lanciano RemoteException 27 28

8 Commenti su AccountHome.java e AccountLocalHome.java Oggetto Home (factory) che interagisce con il bean remota e locale Metodi implementati Account create(string accountid, String ownername) e versione locale che restituisce AccountLocal Account findbyprimarykey(accountpk key) Collection findbyownername(string name) restituisce un insieme di primary keys gettotalbankvalue() indipendente da uno specifico account, restituisce il totale di tutti gli account nella banca Commenti su AccountPK.java Rappresenta la classe di primary key che viene utilizzata per la identificazione Importante caratteristica offerta al progettista poter contare su una chiave che non è una semplice estensione di ID numeriche/stringa ma che può essere adattata ad ogni circostanza Esempio: pensate alle matricole di studenti ed a come si cerca di codificare informazioni semantiche aggiuntive su una semplice codifica numerica 556/xxxx nuovo ordinamento, 56/xxxx vecchio ordinamento La primary key: AccountPK Commenti su AccountBean.java 31 public class AccountPK implements java.io.serializable { public String accountid; public AccountPK (String id) { this.accountid = id; public AccountPK () { public String tostring() { return accountid; public int hashcode() { return accountid.hashcode(); public boolean equals(object account) { return ((AccountPk) account).accountid.equals(accountid); Serializzabile Unico variabile membro Costruttori Metodi di utilità tostring() hashcode() equals() 32 Tre parti di codice da implementare i campi che rappresentano lo stato del bean che verranno caricati e memorizzati dal/nel database i metodi di business esposti attraverso interfaccia locale e remota (AccountLocal e Account) i metodi richiesti dalla specifica EJB creatori, post-creatori, finder, attivazione/passivazione, load/store Le prime due parti sono semplici da codificare mentre quella relativa alla interazione con il database risulta essere più complessa dovendo gestire tutte le interazioni di stato con il database

9 Commenti su AccountException.java Il deployment descriptor di Account (1) Una semplice gestione delle eccezioni è necessaria Anche se la classe semplicemente delega tutto ai metodi della superclasse Exception è importante poter distinguere tra eccezioni che sono generate a causa di errori nella logica del bean che gestisce un account e quelle invece generate da una altra componente del nostro sistema <ejb-jar> <enterprise-beans> <entity> <ejb-name>account</ejb-name> <home>examples.accounthome</home> <remote>examples.account </remote> <local-home>examples.accountlocalhome </local-home> <local>examples.accountlocal</local> <ejb-class>examples.accountbean </ejb-class> <persistence-type>bean </persistence-type> <prim-key-class>examples.accountpk </prim-key-class> <reentrant>false</reentrant>. Tipo del bean Nome delle varie interfacce Persistenza a carico del Bean La classe di chiave primaria Non è prevista la esecuzione multithread all interno Il deployment descriptor di Account (2) Il ciclo di vita di un BMP entity bean 35 <resource-ref> <res-ref-name>jdbc/ejbpool </res-ref-name> <res-type>javax.sql.datasource </res-type> <res-auth>container</res-auth> </resource-ref> </entity> </enterprise-beans> <assembly-descriptor> <container-transaction> <method> <ejb-name>account</ejb-name> <method-intf>local</method-intf> <method-name>*</method-name> </method>.// stesso per Account remoto Indicazione delle risorse utilizzate come JDBC dal nostro bean maggiori dettagli seguono Descrizione delle transazioni per tutti i metodi (locali e remoti) viene richiesta la gestione delle transazioni da parte del container 36 istanze non ancora create istanze create ma non ancora riempite con dati e con risorse non inizializzate istanze legate a dati specifici

10 Come connettersi ad una risorsa Una parte di AccountBean.java: getconnection() 37 Una resource factory rappresenta un fornitore di risorse di qualsiasi tipo: come JDBC driver, JMS driver o altre (accessibili con J2EE Container Architecture) Il meccanismo è gestito dal container il che permette, ad esempio, il connection pooling riutilizzo di socket Per potersi connettere ad una risorsa, si usa JNDI buona caratteristica, garantisce portabilità, etc. Un esempio in AccountBean.java un metodo getconnection() per ottenere una connessione ad un driver JDBC 38.. public Connection getconnection() throws Exception { try{ Context ctx= new InitialContext(); javax.sql.datasource ds = (javax.sql.datasource) ctx.lookup( java:comp/env/jdbc/ejbpool ); return ds.getconnection(); catch (Exception e) { e.printstacktrace() throw e; Un metodo usato in tutti gli accessi al DB Si ottiene il contesto di default settato a carico del container Si fa lookup di una risorsa definita come EJB Reference specificata nel file di deployment Si restituisce la connessione.. che viene usata così.. Una parte di AccountBean.java : ejbload() Una rilettura del deployment descriptor di Account // metodo ejbload() PreparedStatement pstmt = null; Connection conn = null; try { conn=getconnection(); pstmt = conn.preparestatement( select ownername, balance from accounts where id =? ); pstmt.setstring(1,id); ResultSet rs = pstsmt.executequery(): rs.next(); ownername = rs.getstring( ownername ); balance = rs.getdouble( balance );.. Metodo per caricare i dati nel bean in memoria Viene reperita la primary key.. poi Si ottiene la connessione al DB Si prepara lo statement SQL Lo si istanzia con la id Si esegue la query Si prelevano i risultati <resource-ref> <res-ref-name>jdbc/ejbpool </res-ref-name> <res-type>javax.sql.datasource </res-type> <res-auth>container</res-auth> </resource-ref> </entity> </enterprise-beans>.. Si indica una risorsa indicandone il nome (EJB reference) mantenuta a carico dal container il tipo la autorizzazione a carico di chi è (Application/Container) 39 40