1.0 Introduzione
2.0 Differenze con il rilascio precedente
3.0 Limitazioni
3.1 Funzione di selezione colore
su GTK
3.2 Impossibile inserire DBCS Kanji utilizzando la finestra Candidato
in Web Site Designer
3.3 Casi in cui un modello di pagina non
verrà applicato a una pagina We
4.0 Problemi noti
4.1 Il validator JSP non si compila automaticamente in caso di modifiche Java dipendenti
4.2 Suggerimento relativo alle prestazioni: chiusura dei progetti non attivi
4.3 Suggerimento relativo
alle prestazioni: disabilitazione della convalida automatica
4.4 File non creati dalle procedure guidate
di Web Tooling nelle cartelle di sola lettura in Linux
4.5 Limitazione della personalizzazione del menu della barra degli strumenti di Page Designer
4.6 Avvertenza di collegamenti interrotti nelle applet
4.7 Inserimento di applet nei file HTML e JSP utilizzando Page Designer
4.8 Considerazioni sul cast del tipo per il codice creato con la procedura guidata per le pagine Web del database
4.9 I file JSP devono utilizzare istruzioni di importazioni esplicite
4.10
Migrazione dei dati relazionali in progetti Web 4.0.3
4.11 I JSP e i Servlet Java progettati in ambiente DBCS per un livello J2EE 1.3 sul server WebSphere 5 necessitano di un ulteriore frammento di codice
4.12 Trascinamento elementi nella vista Modifica rapida
4.13 Utilizzo degli elementi della vista Frammenti con azioni semplici nella vista Modifica rapida
4.14 Supporto per linguaggio mobile in Page Designer
4.15 Supporto per i modelli di pagina in Page Designer
4.16 Note sull'utilizzo delle
parti del sito con Web Site Designer
4.17 Visualizzazione
del simbolo dell'euro nella pagina Progettazione di Page Designer su Motif
4.18 Azione di doppio clic
sull'assistente ai contenuti con impostazioni internazionali per DBCS
4.19 Ricerca di annotazioni
in file non salvati negli editor
4.20 Limitazioni di ClearCase utilizzando Web Site Designer o i modelli pagina
4.21 Problema di inoltro dei moduli Javascript nelle JSP generate dalla procedura
guidata Pagine Web del database
L'ambiente di sviluppo Web in WebSphere Studio fornisce gli strumenti necessari allo sviluppo di applicazioni Web. Per applicazioni Web si intendono le pagine Web statiche, le pagine JSP (JavaServer Pages), i servlet Java, un descrittore di distribuzione XML (web.xml) e altre risorse Web. In questo file Readme vengono descritti i problemi noti, le limitazioni e le soluzioni associate agli strumenti utilizzati nell'ambiente di sviluppo Web.
I nomi delle cartelle Web Content e Java Source dei progetti Web sono adesso configurabili. I nomi predefiniti sono WebContent e JavaSource; tuttavia i nomi predefiniti dei nuovi progetti Web possono essere modificati scegliendo Strumenti Web->Nuovo progetto nella pagina Preferenze. Le cartelle dei progetti esistenti possono essere ridenominate attraverso la vista Selezione.
NOTA: i nomi di cartella diversi dai nomi predefiniti non sono compatibili con WebSphere Studio Versione 5.0.0. Non modificare i nomi predefiniti se si desidera preservare la compatibilità dello spazio di lavoro con la versione 5.0.0.Alla prospettiva Web sono state aggiunte due nuove viste per semplificare l'editazione delle pagine HTML/JSP. La vista Tavolozza contiene una serie di elementi che è possibile trascinare in una pagina Web in Page Designer. La vista Modifica rapida consente agli utenti di aggiungere/modificare script e script di eventi tag in Page Designer. Per ulteriori dettagli, fare riferimento alla Guida.
Nelle viste Colori, Attributi e Stili è possibile selezionare i colori; questa funzione, però, non funziona nei sistemi GTK. Se si desidera utilizzare la funzione di selezione colore, selezionare il sistema Motif.
In Web Site Designer, se per modificare i campi di testo si utilizza la finestra 'canna', non sarà possibile immettere DBCS KANJI.
Per evitare questo problema, utilizzare 'Wnn' invece di 'canna'. Per ulteriori informazioni, consultare la guida all'installazione del sistema operativo.
Esistono diverse circostanze in cui un modello di pagina potrebbe non essere applicato a una pagina Web quando si utilizza una delle procedure guidata per i modelli di pagina.
- Non viene applicato a una pagina Web che ha una codifica diversa dal modello selezionato.
- Non viene applicato quando il modello selezionato o la pagina selezionata sono descritti da JSP stile XML.
- Non viene applicato a una pagina Web a cui è già associato un modello.
Il validator JSP non esegue la convalida automatica di un file JSP quando viene modificata una classe Java cui il file fa riferimento. Il validator può essere eseguito di nuovo sul file selezionandolo in Selezione progetti e scegliendo Esegui convalida nel menu di scelta rapida.
Per migliorare le prestazioni, si consiglia di chiudere i progetti attualmente non utilizzati. Quando si sceglie Ricrea tutto vengono ricreati soltanto i progetti aperti.
Per impostazione predefinita, i validator vengono avviati automaticamente quando si salvano le risorse in un progetto Web. Se non si desidera avviare automaticamente i validator al salvataggio delle risorse, aprire la finestra di dialogo Proprietà del progetto Web dal menu di scelta rapida nella vista Selezione J2EE. Selezionare l'opzione Ignora preferenze di convalida e disattivare l'opzione Esegui la convalida automaticamente quando si salvano le modifiche alle risorse dalla pagina Convalida. È inoltre possibile disattivare la convalida automatica (e le generazioni) per tutti i progetti selezionando Finestra > Preferenze e disattivando la selezione Esegui automaticamente generazione alla modifica delle risorse dalla pagina Workbench. Se si disabilitano le generazioni automatiche, è possibile eseguire manualmente una generazione (e la convalida) selezionando Progetto > Nuova generazione del progetto.
Se si tenta di creare file in una cartella di sola lettura su Linux, i file non verranno creati e non verrà visualizzato alcun messaggio di errore.
Dopo aver personalizzato la barra degli strumenti utilizzando la finestra Personalizza prospettiva (disponibile selezionando Finestra > Personalizza prospettiva), il menu Barra degli strumenti di Page Designer non può essere utilizzato per ulteriori personalizzazioni della barra. In questo caso, è necessario utilizzare la finestra Personalizza prospettiva per personalizzare le voci della barra degli strumenti visualizzate.
LinksBuilder può contrassegnare erroneamente il valore dell'attributo del codice applet come collegamento non valido se viene utilizzato un nome di classe Java completo:
<applet code="aaa.bbb.AnApplet" codebase="MyApplets">Questa avvertenza può essere ignorata e non influisce sul comportamento dell'applet durante l'esecuzione sul server.Questa avvertenza può essere evitata utilizzando un separatore di percorso ('/') invece del separatore ('.') e verificando che l'estensione .class sia stata dichiarata in modo esplicito. Ad esempio:
<applet code="aaa/bbb/AnApplet.class" codebase="MyApplets">
La cartella di origine Java (per impostazione predefinita JavaSource) di un progetto Web è riservata alle classi del server, quindi il codice di origine applet non può essere contenuto in questa cartella. Di conseguenza, si consiglia di rispettare la seguente procedura quando si sviluppano le applet:
- Creare un progetto Java per le applet e le classi applet nel progetto.
- Copiare i file di classe applet nella cartella del contenuto Web (per impostazione predefinita WebContent) di un progetto Web. Non copiarli nella cartella WEB-INF, perché questa cartella è riservata solo alle classi del server. Per visualizzare i file di classe, modificare i filtri della vista Selezione progetti selezionando Filtri dal menu a discesa.
- Inserire un'applet in una pagina Web selezionando Inserisci > Altre > Applet Java in Page Designer. Quindi, impostare gli attributi e il codice appropriato.
Ad esempio, se la classe dell'applet è aaa.bbb.AnApplet, la struttura del file sarà:
WebContent/index.htmlil codice è "aaa.bbb.AnApplet"
WebContent/MyApplets/aaa/bbb/AnApplet.classquindi, il tag applet in index.html deve contenere:
codebase is "MyApplets"
Nella procedura guidata delle pagine Web del database, quando si utilizza IBM Data Access Beans - Master Details Pattern, possono verificarsi problemi durante l'esecuzione del cast interno delle stringhe nei tipi di dati corrispondenti. Ad esempio Oracle 8.17i non esegue il cast dei numeri dalle stringhe.
Per risolvere questo problema, è necessario modificare il metodo prepareStatement() nel file $Prefix$ViewBean.java generato per ciascuna query DataAccess.
Il codice che viene visualizzato nel seguente modo:
//Aggiunta delle descrizioni dei parametri ai metadati.
DBParameterMetaData metaData = getDBSelect().getParameterMetaData();
metaData.setParameter(1, PARAM1_NAME, DatabaseMetaData.procedureColumnIn,
java.sql.Types.DECIMAL,
java.lang.String.class);
// Impostazione parametri.
getDBSelect().setParameter(PARAM1_NAME, inSAL);
dovrà essere modificato in:
//Aggiunta delle descrizioni dei parametri ai metadati.
È necessario indicare a Parameter Meta Data il tipo di oggetto Java che il database dovrà contenere. A questo punto, utilizzare il metodo setParmeterFromString e non più il metodo setParameter nell'istanza DBSelect. In questo modo la conversione del tipo verrà eseguita da DBSelect Object e non dal database.
DBParameterMetaData metaData = getDBSelect().getParameterMetaData();
metaData.setParameter(1, PARAM1_NAME, DatabaseMetaData.procedureColumnIn,
java.sql.Types.DECIMAL,
java.math.BigDecimal.class);
// Impostazione parametri.
getDBSelect().setParameterFromString(PARAM1_NAME, inSAL);
I file JSP devono utilizzare l'attributo 'import' della direttiva di pagina per descrivere i tipi disponibili per l'ambiente di esecuzione degli script in tale pagina. Alcuni tipi possono essere stati importati implicitamente nei file JSP contenuti nei progetti J2EE1.2, ma visualizzeranno messaggi di errore se utilizzati in un progetto J2EE1.3. Per evitare questo problema, i tipi devono essere importati sempre in modo esplicito nella pagina JSP (a meno che il tipo non sia inserito nell'elenco di importazione predefinito: java.lang.*, javax.servlet.*, javax.servlet.jsp.* e javax.servlet.http.*).
Per migrare i dati relazionali da progetti WebSphere Studio 4.0.3, è necessario procedere come segue:
- Da uno spazio di lavoro 4.0.3, generare file DDL per ogni database disponibile.
- Rimuovere il database dalla cartella database/origine del progetto Web (tramite la vista Definizione dati)
- Aprire lo spazio di lavoro 4.0.3 con WebSphere Studio Versione 5.
- Migrare i progetti Web per i quali si desidera ripristinare i dati relazionali.
- Scegliere File > Importa > File system e specificare i file DDL dallo spazio di lavoro 4.0.3.
- Nella vista Definizione dati della prospettiva Dati, selezionare Esegui a fronte del locale e specificare il progetto Web di destinazione.
Le risorse dei dati relazionali verranno ripristinate.
Le indicazioni riportate di seguito si riferiscono ai JSP e ai Servlet Java progettati in ambiente DBCS per un livello J2EE 1.3 sul server WebSphere 5. Inserire il seguente frammento nel codice di origine prima di accedere ai parametri o agli attributi richiesti:
if(request.getCharacterEncoding() == null){
request.setCharacterEncoding(<encoding>); // generalmente è la codifica del JSP o del servlet
}
//...codice del jsp/servlet normale che accede agli oggetti richiesti come
// <%=request.getParameter("message")%>
Se non viene eseguita l'operazione appena indicata e la richiesta non include le informazioni di codifica, tutti i parametri richiesti verranno analizzati in ISO-8859-1 e quindi i caratteri DBCS eventualmente inclusi in uno dei parametri verrebbero visualizzati in modo non corretto.
Prima di trascinare gli elementi o il testo dalle viste Frammenti o Tavolozza nella vista Modifica rapida, assicurarsi che quest'ultima non contenga l'istruzione "Inserire un'azione/frammento di codice".
Per ciascun elemento della vista Frammenti JavaScript, nella vista Modifica sarà disponibile un'azione semplice. Non utilizzare le azioni semplici con gli elementi nella vista Modifica rapida, con elementi della vista Frammenti nello stesso script di eventi. Se è necessario combinare gli elementi, prestare la dovuta attenzione alla posizione dell'elemento nel frammento. Trascinando gli elementi dalla vista Frammenti nella vista Modifica rapida quando l'editor già contiene azioni semplici, l'elemento di frammento potrebbe essere inserito in una posizione non corretta. In questo caso, eliminare e reinserire l'azione semplice.
Gli attributi non supportati in linguaggi mobili, quali cHTML o WML, possono essere inseriti dalla finestra Inserisci o dalla vista Attributi.
Tuttavia, è possibile controllare la validità del codice utilizzando Strumenti > Convalida sintassi HTML per un documento cHTML o Strumenti > Convalida sintassi WML per un documento WML.
I modelli di pagina sono supportati solo da Page Designer e non da Page Designer Classic. È possibile utilizzare Page Designer per modificare una pagina HTML/JSP utilizzando la funzione di modello pagina.
- In alcune parti del sito non è possibile inserire nelle pagine determinati tipi di documento. Dopo aver scelto OK nella finestra di inserimento, verrà visualizzato il messaggio di errore "Impossibile utilizzare questa parte del sito." Questo significa che verrà generata un'origine non valida se il file di specifica della parte del sito selezionata viene utilizzata nel tipo di documento per la pagina di destinazione. Ad esempio, se il tipo di documenti di una pagina è cHTML o WML, quasi tutte le parti del sito conterranno tag non validi per quei linguaggi di markup.
- La barra di navigazione potrebbe contenere un'origine non valida a causa del file di specifica ad essa associato. Se nella vista Attività vengono visualizzati molti errori e avvisi, molto probabilmente la causa è il file di specifica della barra di navigazione. Per correggere gli errori, modificare il file di specifica.
- Una barra di navigazione di una pagina potrebbe contenere caratteri danneggiati. Questo succede se l'etichetta di navigazione contiene caratteri che non possono essere codificati in base alla regola di codifica specificata nella pagina. Per evitare questo problema, limitare il tipo di caratteri utilizzati nelle etichette di navigazione alla codifica utilizzata nella pagina oppure utilizzare una regola di codifica più completa nella pagina.
- Tutti i file di specifica di esempio contenuti nella finestra Inserimento mappa del sito possono gestire le pagine comprese tra il livello-1 ed il livello-5 nella struttura del sito. Anche se viene impostato un livello finale superiore a 5 nella vista attributi per il tag siteedit:sitemap, i collegamenti alle pagine superiori al livello-5 non verranno inclusi nella mappa del sito.
Page Designer non è in grado di visualizzare il simbolo dell'euro nella pagina Progettazione quando è in esecuzione su un sistema Motif. Per visualizzare il simbolo, è necessario utilizzare un sistema GTK.
Quando si utilizza Linux (Motif o GTK) e una impostazione internazionale per DBCS, facendo doppio clic sull'assistente ai contenuti, a volte la VM Java viene interrotta. Invece di fare doppio clic sull'elenco, per effettuare delle selezioni, utilizzare i tasti freccia e Invio.
Nell'editor Origine e nella pagina Origine degli editor a più pagine, ad esempio l'editor XML, la funzione di ricerca deve essere utilizzata dalla risorsa salvata sul file system piuttosto che dal contenuto dell'editor. Le annotazioni di ricerca contenute in editor in cui non è stato eseguito il salvataggio non sono affidabili. Per evitare questo problema, prima di effettuare una ricerca, salvare il file.
Se si utilizza Web Site Designer per lavorare con un progetto Web, è necessario che i file del progetto, ad esempio html o jsp e file correlati, vengano estratti dal repository ClearCase.
Inoltre, se si utilizzano i modello pagina nel progetto Web, è necessario estrarre i file appropriati da ClearCase.
In alcune JSP generate dalla procedura guidata Pagine Web del database, soprattutto nella '***MasterView.jsp'
i collegamenti 'Indietro', 'Aggiorna' e altri, potrebbero non funzionare correttamente in tutti i browser. Sono stati riscontrati problemi soprattutto in alcuni browser come Mozilla e Konqueror.
Per risolvere il problema nella maggior parte dei browser, modificare il codice Javascript per la funzione 'submitForm' nel JSP.
Modificare la variabile 'document.<formName>.elements.action' nel metodo 'document.<formName>.action'.
Ad esempio, function submitForm(nav){ if(nav == 'SCHEMA_TABLEInputForm'){ document.myForm.elements.action = "/Web3/SCHEMA_TABLEInputForm.html"; } else if(nav == 'SCHEMA_TABLEMasterView'){ document.myForm.elements.action = "/Web3/SCHEMA_TABLEMasterView"; } else{ document.myForm.elements.action = "/Web3/SCHEMA_TABLEDetailsView"; }
diventa
function submitForm(nav){ if(nav == 'SCHEMA_TABLEInputForm'){ document.myForm.action = "/Web3/SCHEMA_TABLEInputForm.html"; } else if(nav == 'SCHEMA_TABLEMasterView'){ document.myForm.action = "/Web3/SCHEMA_TABLEMasterView"; } else{ document.myForm.action = "/Web3/SCHEMA_TABLEDetailsView"; }
Visualizza il file Readme principale
(C) Copyright IBM Corporation 2000, 2003. Tutti i diritti riservati.