GWT - Integrazione JUnit

GWT fornisce un supporto eccellente per il test automatico del codice lato client utilizzando il framework di test JUnit. In questo articolo dimostreremo l'integrazione di GWT e JUNIT.

Scarica l'archivio Junit

Sito ufficiale di JUnit - https://www.junit.org

Scarica Junit-4.10.jar

OS	Nome dell'archivio
finestre	junit4.10.jar
Linux	junit4.10.jar
Mac	junit4.10.jar

Archivia il file jar scaricato in una posizione sul tuo computer. L'abbiamo archiviato inC:/ > JUNIT

Individua la cartella di installazione di GWT

OS	Cartella di installazione di GWT
finestre	C: \ GWT \ gwt-2.1.0
Linux	/usr/local/GWT/gwt-2.1.0
Mac	/Library/GWT/gwt-2.1.0

Classe GWTTestCase

GWT fornisce GWTTestCaseclasse base che fornisce l'integrazione JUnit. L'esecuzione di una classe compilata che estende GWTTestCase sotto JUnit avvia il browser HtmlUnit che serve per emulare il comportamento dell'applicazione durante l'esecuzione del test.

GWTTestCase è una classe derivata da TestCase di JUnit e può essere eseguita utilizzando JUnit TestRunner.

Utilizzando webAppCreator

GWT fornisce uno speciale strumento da riga di comando webAppCreator che può generare un test case iniziale per noi, oltre a obiettivi di formiche e configurazioni di lancio di eclipse per i test sia in modalità di sviluppo che in modalità di produzione.

Apri il prompt dei comandi e vai a C:\ > GWT_WORKSPACE > dove vuoi creare un nuovo progetto con supporto di test. Esegui il seguente comando

C:\GWT_WORKSPACE>C:\GWT\gwt-2.1.0\webAppCreator 
   -out HelloWorld 
   -junit C:\JUNIT\junit-4.10.jar 
   com.tutorialspoint.HelloWorld

Punti degni di nota

Stiamo eseguendo l'utilità della riga di comando webAppCreator.
HelloWorld è il nome del progetto da creare
L'opzione -junit indica a webAppCreator di aggiungere il supporto junit al progetto
com.tutorialspoint.HelloWorld è il nome del modulo

Verifica l'output.

Created directory HelloWorld\src
Created directory HelloWorld\war
Created directory HelloWorld\war\WEB-INF
Created directory HelloWorld\war\WEB-INF\lib
Created directory HelloWorld\src\com\tutorialspoint
Created directory HelloWorld\src\com\tutorialspoint\client
Created directory HelloWorld\src\com\tutorialspoint\server
Created directory HelloWorld\src\com\tutorialspoint\shared
Created directory HelloWorld\test\com\tutorialspoint
Created directory HelloWorld\test\com\tutorialspoint\client
Created file HelloWorld\src\com\tutorialspoint\HelloWorld.gwt.xml
Created file HelloWorld\war\HelloWorld.html
Created file HelloWorld\war\HelloWorld.css
Created file HelloWorld\war\WEB-INF\web.xml
Created file HelloWorld\src\com\tutorialspoint\client\HelloWorld.java
Created file 
HelloWorld\src\com\tutorialspoint\client\GreetingService.java
Created file 
HelloWorld\src\com\tutorialspoint\client\GreetingServiceAsync.java
Created file 
HelloWorld\src\com\tutorialspoint\server\GreetingServiceImpl.java
Created file HelloWorld\src\com\tutorialspoint\shared\FieldVerifier.java
Created file HelloWorld\build.xml
Created file HelloWorld\README.txt
Created file HelloWorld\test\com\tutorialspoint\HelloWorldJUnit.gwt.xml
Created file HelloWorld\test\com\tutorialspoint\client\HelloWorldTest.java
Created file HelloWorld\.project
Created file HelloWorld\.classpath
Created file HelloWorld\HelloWorld.launch
Created file HelloWorld\HelloWorldTest-dev.launch
Created file HelloWorld\HelloWorldTest-prod.launch

Capire la classe di test: HelloWorldTest.java

package com.tutorialspoint.client;

import com.tutorialspoint.shared.FieldVerifier;
import com.google.gwt.core.client.GWT;
import com.google.gwt.junit.client.GWTTestCase;
import com.google.gwt.user.client.rpc.AsyncCallback;
import com.google.gwt.user.client.rpc.ServiceDefTarget;

/**
 * GWT JUnit tests must extend GWTTestCase.
 */
public class HelloWorldTest extends GWTTestCase {

   /**
    * must refer to a valid module that sources this class.
    */
   public String getModuleName() {
      return "com.tutorialspoint.HelloWorldJUnit";
   }

   /**
    * tests the FieldVerifier.
    */
   public void testFieldVerifier() {
      assertFalse(FieldVerifier.isValidName(null));
      assertFalse(FieldVerifier.isValidName(""));
      assertFalse(FieldVerifier.isValidName("a"));
      assertFalse(FieldVerifier.isValidName("ab"));
      assertFalse(FieldVerifier.isValidName("abc"));
      assertTrue(FieldVerifier.isValidName("abcd"));
   }

   /**
    * this test will send a request to the server using the greetServer
    *  method in GreetingService and verify the response.
    */
   public void testGreetingService() {
      /* create the service that we will test. */
      GreetingServiceAsync greetingService = 
      GWT.create(GreetingService.class);
      ServiceDefTarget target = (ServiceDefTarget) greetingService;
      target.setServiceEntryPoint(GWT.getModuleBaseURL() 
      + "helloworld/greet");

      /* since RPC calls are asynchronous, we will need to wait 
       for a response after this test method returns. This line 
       tells the test runner to wait up to 10 seconds 
       before timing out. */
      delayTestFinish(10000);

      /* send a request to the server. */
      greetingService.greetServer("GWT User", 
         new AsyncCallback<String>() {
         public void onFailure(Throwable caught) {
            /* The request resulted in an unexpected error. */
            fail("Request failure: " + caught.getMessage());
         }

         public void onSuccess(String result) {
            /* verify that the response is correct. */
            assertTrue(result.startsWith("Hello, GWT User!"));

            /* now that we have received a response, we need to 
             tell the test runner that the test is complete. 
             You must call finishTest() after an asynchronous test 
             finishes successfully, or the test will time out.*/
            finishTest();
         }
      });
   }
}

Punti degni di nota

Sr.No.	Nota
1	La classe HelloWorldTest è stata generata nel pacchetto com.tutorialspoint.client nella directory HelloWorld / test.
2	La classe HelloWorldTest conterrà casi di unit test per HelloWorld.
3	La classe HelloWorldTest estende la classe GWTTestCase nel pacchetto com.google.gwt.junit.client.
4	La classe HelloWorldTest ha un metodo astratto (getModuleName) che deve restituire il nome del modulo GWT. Per HelloWorld, questo è com.tutorialspoint.HelloWorldJUnit.
5	La classe HelloWorldTest viene generata con due casi di test di esempio testFieldVerifier, testSimple. Abbiamo aggiunto testGreetingService.
6	Questi metodi utilizzano una delle tante funzioni assert * che eredita dalla classe JUnit Assert, che è un antenato di GWTTestCase.
7	La funzione assertTrue (boolean) afferma che l'argomento booleano passato restituisce true. In caso contrario, il test fallirà se eseguito in JUnit.

GWT - Esempio completo di integrazione JUnit

Questo esempio ti guiderà attraverso semplici passaggi per mostrare un esempio di integrazione JUnit in GWT.

Segui i seguenti passaggi per aggiornare l'applicazione GWT che abbiamo creato sopra:

Passo	Descrizione
1	Importa il progetto con un nome HelloWorld in eclipse utilizzando la procedura guidata di importazione del progetto esistente (File → Importa → Generale → Progetti esistenti nell'area di lavoro).
2	Modifica HelloWorld.gwt.xml , HelloWorld.css , HelloWorld.html e HelloWorld.java come spiegato di seguito. Mantieni invariato il resto dei file.
3	Compilare ed eseguire l'applicazione per verificare il risultato della logica implementata.

Di seguito sarà la struttura del progetto in eclipse.

Di seguito è riportato il contenuto del descrittore del modulo modificato src/com.tutorialspoint/HelloWorld.gwt.xml.

<?xml version = "1.0" encoding = "UTF-8"?>
<module rename-to = 'helloworld'>
   <!-- Inherit the core Web Toolkit stuff.                        -->
   <inherits name = 'com.google.gwt.user.User'/>

   <!-- Inherit the default GWT style sheet.                       -->
   <inherits name = 'com.google.gwt.user.theme.clean.Clean'/>
   <!-- Inherit the UiBinder module.                               -->
   <inherits name = "com.google.gwt.uibinder.UiBinder"/>
   <!-- Specify the app entry point class.                         -->
   <entry-point class = 'com.tutorialspoint.client.HelloWorld'/>
  
   <!-- Specify the paths for translatable code                    -->
   <source path = 'client'/>
   <source path = 'shared'/>

</module>

Di seguito è riportato il contenuto del file del foglio di stile modificato war/HelloWorld.css.

body {
   text-align: center;
   font-family: verdana, sans-serif;
}

h1 {
   font-size: 2em;
   font-weight: bold;
   color: #777777;
   margin: 40px 0px 70px;
   text-align: center;
}

Di seguito è riportato il contenuto del file host HTML modificato war/HelloWorld.html.

<html>
   <head>
      <title>Hello World</title>
      <link rel = "stylesheet" href = "HelloWorld.css"/>
      <script language = "javascript" src = "helloworld/helloworld.nocache.js">
      </script>
   </head>

   <body>
      <h1>JUnit Integration Demonstration</h1>
      <div id = "gwtContainer"></div>
   </body>
</html>

Sostituisci il contenuto di HelloWorld.java in src/com.tutorialspoint/client pacchetto con quanto segue

package com.tutorialspoint.client;

import com.google.gwt.core.client.EntryPoint;

import com.google.gwt.core.client.GWT;
import com.google.gwt.event.dom.client.ClickEvent;
import com.google.gwt.event.dom.client.ClickHandler;
import com.google.gwt.event.dom.client.KeyCodes;
import com.google.gwt.event.dom.client.KeyUpEvent;
import com.google.gwt.event.dom.client.KeyUpHandler;

import com.google.gwt.user.client.Window;
import com.google.gwt.user.client.rpc.AsyncCallback;
import com.google.gwt.user.client.ui.Button;
import com.google.gwt.user.client.ui.DecoratorPanel;
import com.google.gwt.user.client.ui.HasHorizontalAlignment;
import com.google.gwt.user.client.ui.HorizontalPanel;
import com.google.gwt.user.client.ui.Label;
import com.google.gwt.user.client.ui.RootPanel;
import com.google.gwt.user.client.ui.TextBox;
import com.google.gwt.user.client.ui.VerticalPanel;

public class HelloWorld implements EntryPoint {
	
   public void onModuleLoad() {
      /*create UI */
      final TextBox txtName = new TextBox(); 
      txtName.setWidth("200");
      txtName.addKeyUpHandler(new KeyUpHandler() {
         @Override
         public void onKeyUp(KeyUpEvent event) {
            if(event.getNativeKeyCode() == KeyCodes.KEY_ENTER){
               Window.alert(getGreeting(txtName.getValue()));
            }				
         }
      });
      Label lblName = new Label("Enter your name: ");

      Button buttonMessage = new Button("Click Me!");

      buttonMessage.addClickHandler(new ClickHandler() {			
         @Override
         public void onClick(ClickEvent event) {
            Window.alert(getGreeting(txtName.getValue()));
         }
      });

      HorizontalPanel hPanel = new HorizontalPanel();	
      hPanel.add(lblName);
      hPanel.add(txtName);
      hPanel.setCellWidth(lblName, "130");

      VerticalPanel vPanel = new VerticalPanel();
      vPanel.setSpacing(10);
      vPanel.add(hPanel);
      vPanel.add(buttonMessage);
      vPanel.setCellHorizontalAlignment(buttonMessage, 
      HasHorizontalAlignment.ALIGN_RIGHT);

      DecoratorPanel panel = new DecoratorPanel();
      panel.add(vPanel);

      // Add widgets to the root panel.
      RootPanel.get("gwtContainer").add(panel);
   }  
   
   public String getGreeting(String name){
      return "Hello "+name+"!";
   }
}

Sostituisci il contenuto di HelloWorldTest.java in test/com.tutorialspoint/client pacchetto con quanto segue

package com.tutorialspoint.client;

import com.tutorialspoint.shared.FieldVerifier;
import com.google.gwt.core.client.GWT;
import com.google.gwt.junit.client.GWTTestCase;
import com.google.gwt.user.client.rpc.AsyncCallback;
import com.google.gwt.user.client.rpc.ServiceDefTarget;

/**
 * GWT JUnit tests must extend GWTTestCase.
 */
public class HelloWorldTest extends GWTTestCase {

   /**
    * must refer to a valid module that sources this class.
    */
   public String getModuleName() {
      return "com.tutorialspoint.HelloWorldJUnit";
   }

   /**
    * tests the FieldVerifier.
    */
   public void testFieldVerifier() {
      assertFalse(FieldVerifier.isValidName(null));
      assertFalse(FieldVerifier.isValidName(""));
      assertFalse(FieldVerifier.isValidName("a"));
      assertFalse(FieldVerifier.isValidName("ab"));
      assertFalse(FieldVerifier.isValidName("abc"));
      assertTrue(FieldVerifier.isValidName("abcd"));
   }

   /**
      * this test will send a request to the server using the greetServer
      *  method in GreetingService and verify the response.
   */
   public void testGreetingService() {
      /* create the service that we will test. */
      GreetingServiceAsync greetingService = 
      GWT.create(GreetingService.class);
      ServiceDefTarget target = (ServiceDefTarget) greetingService;
      target.setServiceEntryPoint(GWT.getModuleBaseURL() 
      + "helloworld/greet");

      /* since RPC calls are asynchronous, we will need to wait 
       for a response after this test method returns. This line 
       tells the test runner to wait up to 10 seconds 
       before timing out. */
      delayTestFinish(10000);

      /* send a request to the server. */
      greetingService.greetServer("GWT User", 
         new AsyncCallback<String>() {
         public void onFailure(Throwable caught) {
            /* The request resulted in an unexpected error. */
            fail("Request failure: " + caught.getMessage());
         }

         public void onSuccess(String result) {
            /* verify that the response is correct. */
            assertTrue(result.startsWith("Hello, GWT User!"));

            /* now that we have received a response, we need to 
             tell the test runner that the test is complete. 
             You must call finishTest() after an asynchronous test 
             finishes successfully, or the test will time out.*/
            finishTest();
         }
      });
	
      /**
         * tests the getGreeting method.
      */
      public void testGetGreeting() {
         HelloWorld helloWorld = new HelloWorld();
         String name = "Robert";
         String expectedGreeting = "Hello "+name+"!";
         assertEquals(expectedGreeting,helloWorld.getGreeting(name));
      }
   }
}

Esegui casi di test in Eclipse utilizzando le configurazioni di avvio generate

Eseguiremo unit test in Eclipse utilizzando le configurazioni di lancio generate da webAppCreator sia per la modalità di sviluppo che per la modalità di produzione.

Esegui il test JUnit in modalità di sviluppo

Dalla barra dei menu di Eclipse, seleziona Esegui → Esegui configurazioni ...
Nella sezione JUnit, seleziona HelloWorldTest-dev
Per salvare le modifiche agli argomenti, premere Applica
Per eseguire il test, premere Esegui

Se tutto va bene con la tua applicazione, questo produrrà il seguente risultato:

Esegui il test JUnit in modalità di produzione

Dalla barra dei menu di Eclipse, seleziona Esegui → Esegui configurazioni ...
Nella sezione JUnit, seleziona HelloWorldTest-prod
Per salvare le modifiche agli argomenti, premere Applica
Per eseguire il test, premere Esegui

Se tutto va bene con la tua applicazione, questo produrrà il seguente risultato:

↰ Previous page Next page ↱

GWT - Integrazione JUnit

Scarica l'archivio Junit

Individua la cartella di installazione di GWT

Classe GWTTestCase

Utilizzando webAppCreator

Capire la classe di test: HelloWorldTest.java

Punti degni di nota

GWT - Esempio completo di integrazione JUnit

Esegui casi di test in Eclipse utilizzando le configurazioni di avvio generate

Esegui il test JUnit in modalità di sviluppo

Esegui il test JUnit in modalità di produzione

Tutorial GWT

Risorse utili di GWT