1.0 Introduzione
2.0 Problemi noti
2.1 Aggiunta di file dei moduli a un progetto Enterprise Application
2.2 Elementi alt-dd (alternate deployment descriptor) nelle applicazioni aziendali
2.3
Impostazioni del percorso di generazione Java per i progetti client EJB/Web/Application
2.4 Spazi non supportati negli URI JAR all'interno di un EAR
2.5
I nomi dei progetti Enterprise Application non devono contenere caratteri DBCS
2.6 I progetto binari sono di sola lettura
2.7 Creazione ripetuta di esempi
2.8 Il percorso di generazione Java viene aggiornato quando si elimina la dipendenza in un file JAR di utilità
2.9 La pagina delle dipendenze JAR Java non riesce ad aggiornare il percorso di generazione Java
2.10 Rimozione automatica di binding WebSphere con eliminazione
2.11 Supporto dell'attività ANT J2EE
2.12 Blocco delle risorse dovuto alla convalida JSP
2.13 Estrazione automatica da ClearCase durante l'importazione e la sostituzione di file esistenti
2.14 Errore 'Descrizione progetto non valida'
durante l'uso di un percorso per un nuovo progetto J2EE non predefinito
2.15 Supporto Ant J2EE: applicazione com.ibm.etools.j2ee.ant.RunAnt
Nella prospettiva J2EE sono contenute le viste solitamente utilizzate quando si sviluppano risorse per progetti Enterprise Application, EJB, Web e client di applicazione. In questo file Readme vengono descritti problemi noti, limitazioni e soluzioni associati agli strumenti di sviluppo J2EE in WebSphere Studio. Inoltre, nel file readme relativo agli strumenti Web, è possibile trovare ulteriori informazioni relative alle viste J2EE e ai progetti Web J2EE.
Quando si importa uno dei tipi di file dei moduli (file JAR EJB, WAR, RAR e file JAR del client di applicazioni), è necessario utilizzare la procedura guidata per l'importazione e importare il modulo nel tipo di progetto appropriato. Non importare il file in un progetto Enterprise Application. Se il file del modulo viene importato nel progetto Enterprise Application, non sarà possibile aggiungere il modulo all'applicazione mediante l'editor del descrittore di distribuzione dell'applicazione.
L'utilizzo di alt-dd non è attualmente supportato in WebSphere Studio. La soluzione a questo problema consiste nel modificare i descrittori di distribuzione dei moduli contenuti.
Laddove è possibile, si consiglia di accettare le impostazioni predefinite del percorso di generazione Java per i tipi di progetti J2EE. Per impostare le dipendenze tra i progetti contenuti in una applicazione Enterprise, utilizzare invece l'editor Dipendenze JAR o la pagina delle proprietà di Dipendenze JAR di Java. L'attributo Class-Path del file MANIFEST.MF (utilizzato per il runtime del server) verrà sincronizzato con il percorso di generazione Java del progetto (utilizzato per la compilazione Java).
In generale, le librerie richieste da un modulo devono essere contenute nell'applicazione Enterprise oppure devono essere visibili al server. Di conseguenza, fare attenzione quando si aggiungono librerie esterne al percorso di generazione del progetto, perché il progetto potrebbe non avviare il server. Ad esempio, si supponga di disporre di una libreria off_the_shelf.jar da utilizzare come riferimento in un modulo WEB. È possibile:
- Aggiungere la libreria off_the_shelf.jar all'applicazione Enterprise utilizzando la procedura guidata dell'importazione del file system, utilizzare quindi l'editor Dipendenze JAR per rendere il modulo WEB dipendente dal file JAR, oppure
- Utilizzare le proprietà del percorso di generazione Java del progetto WEB per aggiungere il file JAR al percorso di generazione; il file JAR deve essere visibile al server.
Per realizzare questa operazione per la verifica dell'unità, modificare la configurazione server e aggiungere il file JAR al percorso classi.
Gli spazi negli URI per i moduli o nei JAR di utilità nelle applicazioni Enterprise non sono supportati. L'attributo "Class-Path:" del file MANIFEST.MF in un JAR o in un modulo, è un elenco dei percorsi relativi in un EAR delimitato da spazi. Un JAR non può fare riferimento ad un altro JAR in EAR, se l'URI dello JAR specificato contiene degli spazi.
Se si crea un progetto Enterprise Application, è preferibile non assegnargli un nome contenente caratteri DBCS.
I progetti binari creati dall'importazione EAR (disponibile come opzione della procedura guidata) sono di sola lettura. Non modificare il contenuto dei progetti binari. È possibile, invece, eliminare il progetto binario e sostituirlo con una versione di origine di un repository. La maggior parte delle azioni dovrebbero essere disabilitate per i progetti binari. Se si utilizzano progetti binari, non eseguire alcuna azione che possa modificare il contenuto del progetto o del file JAR.
Per creare diverse istanze degli esempi dell'applicazione Enterprise integrata, è necessario ridenominare il progetto di esempio esistente e tutti i progetti di moduli associati, prima di importare nuovamente l'esempio. Se non viene eseguita questa procedura, la seconda importazione eliminerà i progetti di modulo senza visualizzare messaggi di avviso.
Nella vista Gerarchia J2EE, fare clic con il tasto destro del mouse su ciascun modulo da ridenominare, e selezionare Rinomina. Nella finestra visualizzata, immettere il nuovo nome e selezionare sia Rinomina modulo in tutte le applicazioni Enterprise che Rinomina le dipendenze del modulo che fanno riferimento al progetto selezionato. È importante utilizzare la funzione di ridenominazione della vista Gerarchia J2EE e queste due opzioni, in modo che le interdipendenze dei moduli non subiscano modifiche.
Quando si elimina la dipendenza di un file JAR di un programma di utilità, il progetto Java corrispondente viene eliminato dal percorso di generazione Java solo se il progetto EAR fa ancora riferimento al file JAR dipendente.
Ad esempio, si supponga che vengano creati un progetto web J2EE 1.3 in EAR ed un progetto JUnit Java e che il progetto JUnit venga aggiunto come JAR del programma di utilità in EAR, specificando JUnit come dipendenza JAR Java del progetto Web.
Se si desidera rimuovere la dipendenza tra JUnit e il progetto Web, eliminare prima la dipendenza JAR Java dal progetto Web e poi il file JAR del programma di utilità da EAR. Rispettare questo ordine per garantire la riuscita dell'operazione.
La pagina Dipendenze JAR Java non è sincronizzata con la pagina del percorso di generazione Java nella finestra Proprietà del progetto. È possibile che una modifica apportata ad una di queste pagine non sia stata trasmessa anche all'altra pagina durante la stessa sessione.
Esistono anche delle istanze in cui, lo scorrimento delle pagine determina l'aggiornamento per una pagina e l'eliminazione di tale aggiornamento per l'altra pagina, quando si preme il pulsante OK o il pulsante Applica. Di solito, questa condizione è simile all'aggiunta di una dipendenza JAR, ma il progetto non viene aggiunto al percorso di generazione Java.
Per risolvere il problema, aprire nuovamente la finestra delle proprietà, passare alla pagina delle dipendenze JAR, deselezionare e poi riselezionare la dipendenza JAR e quindi premere OK.
Quando si elimina un oggetto contenente binding WebSphere, l'oggetto di binding viene eliminato automaticamente. Ad esempio, se si elimina un ruolo di protezione con binding nella pagina Protezione dell'editor del descrittore di distribuzione dell'applicazione, vengono eliminati anche i binding del ruolo di protezione. Se si aggiunge nuovamente un ruolo di protezione con lo stesso nome, ricordarsi di eseguire nuovamente il binding.
Nella versione 4.x le attività J2EE e ANT dello spazio di lavoro per l'esportazione erano disponibili mediante lo scaricamento di un file zip (com.ibm.ant.extras.zip) dal Web. Tali attività vengono invece ora fornite con il prodotto di base e sono disponibili nel plugin com.ibm.etools.j2ee.ant.
Se vi sono generazioni ANT basate sul precedente plugin, è necessario eseguirne la migrazione, dal momento che sono stati realizzati i seguenti aggiornamenti rispetto alla versione 4.0:
- Dal momento che i plugin vengono ridenominati dall'opzione scaricabile disponibile per la versione 4.0, il file di esempio runAnt.bat utilizzato per l'esecuzione senza limite iniziale viene aggiornato. In particolare, l'ID o l'applicazione di avvio da "com.ibm.ant.extras.RunAnt" diventa "com.ibm.etools.j2ee.ant.RunAnt". È necessario modificare tutti i file .bat esistenti utilizzati per avviare lo spazio di lavoro senza limite iniziale.
- L'attività utilJAR è quindi inutile e serve solo a garantire la compatibilità; è invece necessario utilizzare il supporto util JAR nell'editor dell'applicazione. Si noti inoltre che l'attività è stata modificata e che vi sono parametri non più applicabili. Per ulteriori informazioni, consultare la documentazione relativa all'attività.
- È stato aggiunto un parametro all'attività di esportazione EAR, in modo da includere il nuovo indicatore supportato dalla procedura guidata, che contiene i meta file di progetto durante l'esportazione. Tale parametro risulta molto utile per i progetti binari. Fare riferimento alla documentazione sul prodotto per ulteriori informazioni sull'ottimizzazione dello sviluppo dei progetti binari.
- Il parametro "use35rules" dell'attività EJBDeploy è stato ridenominato "compatible35".
Se un progetto Web è stato convalidato di recente dal validator JSP, è possibile che sia ancora utilizzato un file JAR di libreria o di classe cui il progetto fa riferimento. In questo caso, potrebbe risultare difficile eliminare o spostare i singoli file JAR o di classe (ad esempio, se si sceglie di eliminare la directory /WEB-INF/lib). Se in un progetto Web esiste un riferimento a un file JAR di un progetto EAR come dipendenza JAR Java, potrebbe divenire impossibile la cancellazione del progetto EAR o del JAR al suo interno. Per "rilasciare" queste risorse per le attività di gestione dei file, chiudere il progetto Web e riaprirlo.
Se durante l'importazione di un modulo J2EE si sceglie di sovrascrivere file esistenti integrati in ClearCase, sarà necessario estrarre i file per poterli sovrascrivere. Quando il processo di importazione rileva un file integrato in ClearCase, viene visualizzato un messaggio che richiede di estrarre il file specificato. Scegliendo il pulsante "Sì a tutti", WebSphere Studio tenterà di estrarre i file specificati e tutti i file integrati che verranno eventualmente rilevati durante l'operazione di importazione.
Se viene creato un nuovo progetto J2EE (che comprende Java, applicazione enterprise, Web, EJB, client di applicazioni e progetti connettori), non è possibile utilizzare un percorso già utilizzato da un altro progetto de workbench. Se si sceglie un percorso già utilizzato da un altro progetto, la procedura guidata produrrà il messaggio di errore "Descrizione progetto non valida". Anche se dopo aver ricevuto questo messaggio viene selezionato un percorso valido mediante il pulsante Sfoglia, la creazione del progetto non verrà completata. Per risolvere il problema, scegliere Annulla e riavviare la procedura guidata per la creazione dei progetti.
Quando vengono eseguite attività J2EE o EJB Ant, utilizzare l'applicazione com.ibm.etools.j2ee.ant.RunAnt invece dell'applicazione org.eclipse.ant.core.antRunner.
L'utilizzo di RunAnt presenta due vantaggi:
- Lo spazio di lavoro viene salvato dopo aver eseguito il file di generazione specificato.
- La funzione di generazione automatica viene disabilitata durante l'esecuzione dello script Ant per migliorare le prestazioni e per risolvere un problema noto con org.eclipse.ant.core.antRunner su Linux.
Visualizza il file Readme principale
(C) Copyright IBM Corporation 2000, 2003. Tutti i diritti riservati.