Guida al tool: Assemblaggio di moduli ed applicazioni J2EE mediante Rational XDE Developer - Java Platform Edition
Questa guida al tool descrive come creare archivi J2EE (ad esempio JAR, WAR, JAR EJB e EAR) con Rational XDE.
Strumento: Rational XDE Developer
Relazioni
Descrizione principale

Scopo

Questa guida al tool fornisce le seguenti informazioni specifiche a J2EE:

Panoramica

XDE fornisce un'automazione per creare archivi J2EE, stabilire quali componenti devono essere distribuiti negli archivi e a quali nodi (contenitori e server) gli archivi J2EE devono essere distribuiti. Queste attività sono svolte nei modelli di distribuzione XDE.

Le seguenti operazioni vengono effettuate in questa guida al tool:

Per ulteriori informazioni

I collegamenti alle sezioni della guida in linea di Rational XDE™ sono contrassegnate con icona della guida.

Impostazione del workspace di assemblaggio

In XDE, il workspace di assemblaggio è costituito dai modelli di distribuzione XDE (EJB, Web e EAR). Quindi, in questa fase vengono creati i modelli di distribuzione XDE necessari. Per le raccomandazioni relative alla definizione dei progetti e dei modelli di distribuzione, vedere le Linee guida per la struttura dei modelli XDE.

Alcuni dei modelli di distribuzione potrebbero essere già stati prodotti al momento della creazione dei progetti XDE. Tuttavia, l'assemblatore può scegliere di creare ulteriori "workspace di assemblaggio" separati per supportare la distribuzione ai fini di verifica e produzione.

In XDE, i workspace di assemblaggio separati possono essere implementati attraverso modelli di distribuzione XDE separati o definendo singoli archivi all'interno dello stesso modello di distribuzione (ad esempio, archivi separati per la verifica, la produzione, ecc.).  Il vantaggio di quest'ultimo approccio è la riduzione del numero di modelli XDE ed è più semplice aggiungere, rimuovere e modificare simultaneamente componenti J2EE, file di archivio ecc. negli archivi quando si trovano nello stesso modello. Tuttavia, la gestione di modifiche contemporanee allo stesso modello rappresenta l'inconveniente di questo approccio. Un modello separato rende anche più semplice limitare l'accesso ai contenuti degli archivi di produzione, quando questi ultimi devono essere controllati attentamente.

I modelli di distribuzione XDE possono essere creati "manualmente" (leggere icona della guidaCreazione di modelli di distribuzione Java o utilizzando procedure guidate di distribuzione J2EE di XDE al momento stesso in cui viene creato l'archivio (leggere la successiva fase: Definizione degli archivi). Le procedure guidate di distribuzione XDE creano o aggiornano il modello di distribuzione Web o EJB appropriato, nonché un modello EAR che racchiude l'EAR "contenitore" richiesto per la distribuzione alla maggior parte dei server di applicazione.

Vedere le rimanenti fasi di questa guida al tool per informazioni su come popolare i modelli di distribuzione XDE.

Definizione degli archivi

In questa fase si creano gli archivi, se non esistono già, e si decide quali elementi inserirvi.

Gli archivi di modulo J2EE, JAR EJB e WAR, sono descritti rispettivamente nei modelli di distribuzione EJB e Web. In questi modelli di distribuzione si stabilisce quali elementi saranno distribuiti negli archivi in questione.

Gli archivi dell'applicazione J2EE, EAR, sono definiti nel modello di distribuzione EAR, nel quale si stabilisce quali archivi di modulo J2EE saranno inseriti nell'EAR, nonché a quale nodo del server di applicazione l'EAR dovrà essere distribuito. Per ulteriori informazioni sulla mappatura degli archivi ai nodi, vedere le icona della guidaRelazioni di distribuzione . Il nodo contiene informazioni sul tipo di server e inerenti alla distribuzione. Se il server di applicazione è di un tipo supportato da XDE, XDE permetterà di specificare alcune proprietà (come i ruoli di sicurezza del livello di applicazione) relative al server per facilitare la distribuzione. Per maggiori informazioni, leggere i icona della guidaNodi di distribuzione (Java) . Vedere anche i icona della guidaServer di applicazione (Java) .

In XDE, è possibile utilizzare procedure guidate di distribuzione dell'applicazione J2EE per impostare modelli di distribuzione J2EE e creare i modelli, gli archivi ed identificare gli elementi che saranno distribuiti in questi archivi, specificando il nodo al quale l'archivio dovrebbe essere distribuito. Nei modelli di distribuzione Web ed EJB si definiscono gli elementi da includere negli archivi di modulo J2EE, mentre la procedura guidata di distribuzione imposta le relazioni tra i file di archivio e i componenti. Nel modello di distribuzione EAR, si definisce quali archivi vanno nell'EAR (la procedura guidata di distribuzione imposta le relazioni predefinite con gli archivi nei modelli di distribuzione EJB e Web) e i "nodi" del server di applicazione ai quali l'archivio viene distribuito. Per maggiori dettagli sulle procedure guidate di distribuzione XDE, leggere le icona della guidaProcedure guidate di distribuzione J2EE .

Alcune osservazioni sull'utilizzo di procedure guidate di distribuzione XDE:

  • I modelli XDE che contengono gli elementi da inserire negli archivi devono essere aperti prima di chiamare le procedure guidate, affinché gli elementi appaiano nelle caselle a discesa e possano essere selezionati e inclusi nell'archivio.
  • Le procedure guidate aggiungono semplicemente elementi agli archivi. Non possono rimuovere voci specificate in precedenza, anche se queste ultime non vengono selezionate nelle procedure guidate o nelle chiamate successive.
  • Se esiste più di un archivio in un modello di distribuzione XDE, XDE sceglierà come "predefinito" l'archivio specificato nel corso dell'ultima fase della procedura guidata di distribuzione. Se si utilizza XDE in WebSphere Studio Application Developer, tale archivio sarà l'unico riconosciuto da XDE, poiché Application Developer richiede un progetto separato per ogni archivio. Non si potrà dunque utilizzare tool di Application Developer per lavorare su archivi "non predefiniti".
  • Si possono eseguire procedure guidate in modo ripetuto man mano che l'applicazione evolve e dovranno essere aggiunti nuovi elementi agli archivi esistenti, creati nuovi archivi e modificate informazioni sulla distribuzione (per maggiori dettagli sulla distribuzione di archivi J2EE, leggere la Guida al tool: Distribuzione di moduli e applicazioni J2EE mediante Rational XDE Developer - Java Platform Edition).
  • Dopo aver eseguito le procedure guidate, sarebbe utile aprire il diagramma predefinito in ciascun modello di distribuzione, per poi trascinare gli elementi creati nei modelli di distribuzione, come i componenti e gli archivi, nel diagramma e organizzarli come si desidera.

I risultati di questa fase devono essere catturati nei diagrammi di distribuzione. Per ulteriori informazioni, consultare l'icona della guidaUtilizzo dei diagrammi di distribuzione . Vedere anche icona della guidaLayout e raggruppamento di forme nel diagramma .

Definizione dei descrittori di distribuzione

In XDE, i descrittori di distribuzione non vengono modificati direttamente. Sono piuttosto definiti nei modelli di distribuzione XDE e in seguito viene creato automaticamente il file descrittore di distribuzione (nella relativa fase). Il modello di distribuzione XDE è essenzialmente un modello del descrittore di distribuzione corrispondente. Per maggiori informazioni sui descrittori di distribuzione XDE, vedere i icona della guidaFile dei descrittori di distribuzione .

Le procedure di distribuzione guidate XDE (descritte nella precedente fase: Definizione degli archivi) popolano automaticamente molte delle proprietà dei descrittori di distribuzione quando si crea l'archivio e ogni qual volta vengono eseguite le procedure guidate di distribuzione. Così i descrittori di distribuzione evolvono assieme ai componenti che contengono.

Alcuni server di applicazione richiedono un "wrapper" EAR intorno al JAR EJB, WAR e ad altri archivi JAR per la distribuzione, ossia il provider del componente dell'applicazione può richiedere l'assemblaggio di un EAR per verifica. In casi come questi, l'EAR generato automaticamente è spesso sufficiente.

Tuttavia, gli assemblatori di applicazione si occupano spesso dei dettagli sui contenuti EAR, specialmente dei ruoli di sicurezza dell'applicazione ecc. che possono anche essere modellati in XDE. Nel modello di distribuzione XDE, si possono modellare i ruoli di sicurezza, i permessi, le transazioni ecc. utilizzando i menu a comparsa o le caselle degli strumenti corrispondenti. Il "Connector Assistant" in ciascuna casella degli strumenti sa quale tipo di relazione creare tra gli elementi. In situazioni in cui sono possibili varie opzioni, viene presentata una richiesta di selezione all'utente. Per ulteriori informazioni sul "connector assistant", vedere la icona della guidaDefinizione di relazioni per EJB . Per i dettagli sulla modellazione di file WAR, leggere la icona della guidaModellazione di file WAR . Per i dettagli sulla modellazione di file JAR EJB, vedere la icona della guidaModellazione della distribuzione .

I modelli di distribuzione XDE (EJB, Web e EAR) contengono tutte le informazioni richieste per generare descrittori di distribuzione ejb-jar.xml, web.xml e application.xml - rispettivamente EJB, Web ed Enterprise Application - (alcune delle informazioni sono prese dai modelli di codice associati ai modelli di distribuzione). Si tratta dei descrittori definiti dallo standard J2EE. Altri descrittori sono solitamente richiesti per completare la distribuzione a gran parte dei server di applicazione. XDE genera questi ulteriori descrittori di distribuzione relativi ai server di applicazione supportati. Per ulteriori dettagli, leggere la icona della guidaDistribuzione dell'applicazione Java .

Se si definiscono associazioni tra le tabelle database nel modello dati e le entità CMP (Container-Managed Persistent) di EJB, tali associazioni saranno utilizzate per creare direttive nei descrittori specifici al vendor (le quali non fanno parte del descrittore standard EJB). Se non sono stati definite associazioni nel modello dati, saranno create associazioni predefinite per entità CMP di EJB. Per maggiori dettagli, leggere l'icona della guidaUtilizzo di EJB nei database .

XDE non modella né genera i contenuti completi di tutti i descrittori specifici al vendor. È invece possibile sovrapporre la creazione automatica di uno o più descrittori e mantenerli comunque. Ogni archivio ha una proprietà che possiede un elenco di file o directory da includere nell'archivio, ma che non sono modellati. La proprietà è chiamataJARNonModelElements per JAR, EJBNonModelElements per JAR EJB, WebNonModelElementsper WAR e EARNonModelElements per EAR. Aggiungere i descrittori di distribuzione e altri file che si desidera mantenere alla giusta proprietà relativa all'archivio corrispondente. Per ulteriori informazioni, vedere la icona della guidaDistribuzione dell'applicazione Java .

Convalida degli archivi

Potrebbe essere una buona idea quella di convalidare i modelli di distribuzione XDE prima di tentare la distribuzione, poiché potrebbero esservi degli errori sconosciuti, specialmente sul lato server dell'applicazione, che daranno luogo a messaggi di errore non esistente o sconosciuto. In realtà, non sarebbe sbagliato convalidare i modelli "mentre si procede" (es. occasionalmente durante l'assemblaggio e almeno una volta prima della distribuzione, per una corretta verifica).

XDE fornisce un supporto per il controllo dell'integrità dei modelli. Selezionare il modello in Model Explorer, quindi dare il comando "Convalida". In caso di problemi, le voci di attività sono scritte nell'elenco di attività. Per maggiori informazioni, vedere la icona della guidaConvalida di modelli Java . Per ulteriori informazioni su cosa viene convalidato da XDE relativamente ai modelli di distribuzione, leggere le icona della guidaRegole di convalida della distribuzione .

Per ulteriori informazioni

Oltre alla modellazione degli archivi J2EE e ai descrittori di distribuzione in XDE, possono essere importati descrittori di distribuzione o interi archivi all'interno di XDE. Per ulteriori informazioni leggere icona della guidaImportazione ed esportazione nella distribuzione .

Per maggiori informazioni sulla modellazione della distribuzione XDE, leggere la icona della guidaModellazione della distribuzione . I dettagli sulla distribuzione sono contenuti nella Guida al tool: Distribuzione di moduli e applicazioni J2EE mediante Rational XDE Developer - Java Platform Edition.