< Indietro | Avanti >

Lezione 3: Creazione di un client di servizi EGL

Durante la fase successiva, verrà creato un progetto client che utilizza il servizio. Anche se il client che viene creato in questa esercitazione si trova nello stesso workspace, potrebbe trovarsi in una ubicazione completamente separata o su una diversa piattaforma. Poiché non è necessario che i servizi e i client vengano scritti nello stesso linguaggio di codice, è anche possibile che questa applicazione client venga scritta in un altro linguaggio o che sia creata con una serie di tool completamente diversa.

Procedimento

  1. Fare clic su File > Nuovo > Progetto.
  2. Espandere EGL e fare clic su Progetto EGL.
  3. Fare clic su Avanti.
  4. Chiamare il nuovo progetto EGL EGLClient.
  5. Fare clic su Progetto Web.
  6. Fare clic su Avanti.
  7. Assicurarsi che l'opzione Crea un nuovo descrittore di build sia selezionata. Non è necessario modificare le impostazioni avanzate a meno che non si stia utilizzando WAS e siano state precedentemente modificate le impostazioni in modo che venga disabilitata l'aggiunta di un progetto a un EAR.
  8. È possibile che venga visualizzata una finestra in cui si richiede se si desidera passare alla prospettiva J2EE. In questa finestra, fare clic su No.

Creazione del pagina Web del client

Per utilizzare il servizio, verrà creata una pagina Web nel client per richiamare l'input, trasmettere l'input al servizio e visualizzare l'output proveniente dal servizio. Iniziare creando un gestore JSF, un tipo di parte logica EGL che controlla una pagina Web; successivamente EGL creerà una pagina Web che verrà utilizzata insieme a questo gestore JSF.
  1. Nella vista Esplora progetti, fare clic sul progetto EGLClient per selezionarlo.
  2. Fare clic su File > Nuovo > Altro.
  3. Espandere EGL e fare clic su Gestore JSF.
  4. Fare clic su Avanti.
  5. Nella finestra Nuovo gestore JSF EGL, assicurarsi che il campo Cartella di origine sia impostato sulla cartella EGLSource del progetto:
    EGLClient\EGLSource
  6. Nel campo Package, immettere questo nome:
    jsfhandlers
  7. Nel campo Nome file sorgente EGL, immettere questo nome:
    ClientPage
    La finestra risulterà simile a questa immagine:
    La finestra Nuovo gestore JSF EGL
  8. Fare clic su Fine. Il nuovo gestore JSF viene aperto nell'editor.

    Salvare il file solo quando viene indicato nelle istruzioni. Quando si salva un gestore JSF, EGL verifica se la pagina Web indicata come riferimento nella proprietà view esiste o meno. Se la pagina non esiste, EGL il file ed aggiunge automaticamente campi in base alle variabili nel gestore JSF e le proprietà DisplayUse di tali variabili. Se si salva il file prima di aver aggiunto tutte le variabili, la nuova pagina Web non conterrà tutte le variabili. In questo caso, è possibile eliminare il file JSP (non il file gestore JSF) e generare nuovamente il gestore JSF per ottenere una nuova pagina Web.

  9. Rimuovere il codice di esempio dal nuovo gestore JSF in modo che rimanga solo il seguente codice:
    package jsfhandlers;
    
    handler ClientPage type JSFHandler
       {view = "jspLocation/jspName.jsp"}
       
    end
  10. Impostare il valore della proprietà view su ClientPage.jsp, come in questo esempio:
    {view = "ClientPage.jsp"}
  11. Nel gestore JSF, creare le seguenti variabili:
    name string {DisplayUse = input};
    city string {DisplayUse = input};
    output string {DisplayUse = output};
  12. Al di sotto di queste variabili, aggiungere questa funzione:
    function getHello()
    
    end
    Il codice a questa funzione verrà aggiunto in un secondo momento. Il gestore JSF risulterà simile all'immagine seguente:
    Il codice nel gestore JSF
  13. Salvare il file. Quando si salva il file, EGL crea automaticamente una pagina Web dal file. Il nome di questo file è il valore della proprietà view, ClientPage.jsp, e il file viene ubicato nella cartella WebContent del progetto.
    Se non si ottiene un file JSP, vuol dire che EGL non è configurato per generare automaticamente parti del gestore JSF. Generare il gestore JSF manualmente facendo clic con il tasto destro del mouse nella vista Esplora progetti o nell'editor EGL e scegliendo Genera. Successivamente, per configurare la generazione automatica dei gestori JSF, procedere come segue:
    1. Fare clic su Finestra > Preferenze.
    2. Nella finestra Preferenze, espandere EGL e fare clic su Generazione.
    3. Nella pagina Generazione, selezionare la casella di spunta Gestore.
    4. Fare clic su OK.

    Adesso i gestori JSF eseguiranno la generazione automaticamente al salvataggio.

  14. Aprire il file ClientPage.jsp nell'editor. Questa pagina contiene campi basati sulle variabili create nel gestore JSF. Questi campi sono pre-associati alle variabili. In questo modo, quando i valori dei campi vengono modificati nella pagina, le variabili cambieranno in modo da corrispondere ai valori dei campi. Allo stesso modo, quando i valori delle variabili nel gestore JSF vengono modificati, i valori dei campi nella pagina cambieranno per corrispondere ai valori delle variabili.

    Questa pagina contiene anche diversi campi con messaggi di errore. Questo non significa che la pagina contenga errori: i campi nella pagina conterranno gli errori che potrebbero verificarsi durante l'esecuzione della pagina.

  15. Individuare la vista Dati di pagina. Per aprire questa vista, fare clic su Finestra > Mostra vista > Dati di pagina. La vista contiene i dati disponibili per la pagina, incluse le variabili create nel gestore JSF. Inoltre mostra le funzioni nel gestore JSF.
  16. Nella vista Dati di pagina, espandere Gestore JSF > Azioni e individuare la funzione getHello().
  17. Trascinare la funzione getHello() dalla vista Dati di pagina direttamente nella parte inferiore della pagina. Nella pagina viene visualizzato un pulsante associato alla funzione. Quando l'utente preme il pulsante nella pagina al runtime, verrà eseguita la funzione nel gestore JSF.
  18. Salvare la pagina.
La pagina risulterà simile alla seguente immagine:
Aspetto della pagina Web del client

A questo punto si dispone di una pagina Web pronta per utilizzare il servizio Web. Nella lezione successiva verrà configurato il progetto in modo agisca come client per il servizio attraverso questa pagina Web.

< Indietro | Avanti >