Trabalhando com testes funcionais distribu�dos em Java

Imagine uma aplicaç�o web com cem testes funcionais automatizados e, ao fazermos uma alteraç�o de funcionalidade desejamos executar os testes de regress�o com o intuito de verificar se as outras n�o foram danificadas. Ap�s a execuç�o sem problemas, podemos verificar que o tempo gasto nestes foi algo em torno de seis horas. Diante disso, precisamos otimizar para reduzir o tempo de execuç�o dos nossos testes funcionais automatizados.

Uma poss�vel soluç�o seria a distribuiç�o da execuç�o destes utilizando o Selenium GRID usando duas m�quinas virtualizadas com o apoio do VirtualBox. Com essa distribuiç�o de tarefas, o que levaria seis horas para rodar tudo passaria a gastar metade do tempo. Este artigo destaca essa soluç�o na pr�tica, mas com menos testes.

O Selenium WebDriver e o TestNG permitem escrever, execut�-los e escolher em quais navegadores isso ocorrer�. Veremos nesse artigo como isso funciona na pr�tica. Mas antes de iniciarmos o desenvolvimento, vamos conhecer melhor as ferramentas utilizadas.

Selenium WebDriver

� um framework de automaç�o de testes, fornecendo uma API em diferentes linguagens, como Java, C#, Python e outros, que automatiza aç�es de usu�rio na interface web em diferentes navegadores. Ele serve para integrar o c�digo-fonte com a tela do sistema e com o banco de dados. Sua arquitetura � apresentada na Figura 1.

Figura 1. Arquitetura do Selenium WebDriver

Selenium Grid

Este permite distribuir os testes escritos com a API WebDriver em v�rias m�quinas f�sicas ou virtuais. Al�m disso, o Selenium Grid tem dois conceitos importantes para o seu funcionamento:

Hub: atua como um ponto central, ou seja, um servidor que carregar� todos os testes a serem executados e distribu�dos para o(s) Node(s). Recomenda-se criar apenas um �nico Hub para comandar;
Node: atua como um ponto ligado ao Hub central esperando receber os testes a serem executados. V�rios nodes podem ser ligados ao Hub central, mas nenhum pode se ligar a outro.

Vejamos na Figura 2 a arquitetura do Selenium Grid.

Figura 2. Arquitetura do Selenium Grid

Para apoiar a qualidade do software, a fam�lia Selenium ainda conta com um IDE pr�prio para ajudar na execuç�o de testes funcionais

Para esse artigo tamb�m usaremos, em conjunto com o IDE Eclipse :

VirtualBox: � um software de virtualizaç�o de plataforma, que permite ao usu�rio instalar e executar sistemas operacionais independentes em um �nico computador.
TestNG: � um framework de criaç�o e execuç�o de testes de unidade em Java;
Apache Maven: � uma ferramenta de gest�o de projetos de software que utiliza o conceito de POM (modelo de objeto de projeto) para a compilaç�o de projetos que envolve a construç�o, elaboraç�o de relat�rios e documentaç�o em uma central de informaç�es, sendo compat�vel com diferentes linguagens. Mas usaremos a linguagem Java 8 para esse exemplo.

Vis�o geral

Desenvolveremos os testes funcionais distribu�dos na aplicaç�o web pronta que est� em http://artigo.pe.hu.

Ent�o o primeiro teste consiste em acessar na p�gina inicial a opç�o �Trabalhe Conosco�, preencher todos os campos do formul�rio e envi�-lo. Ao final, verifica-se se o envio deu certo. O segundo consiste em entrar na p�gina inicial e clicar na opç�o Conversor -> Temperatura e ao carregar a p�gina devemos testar todas as combinaç�es de c�lculos de convers�o de temperatura, verificando se todos os resultados est�o corretos.

O primeiro teste ser� executado no Firefox da primeira m�quina virtual (Ubuntu; Node 1) e o segundo no Google Chrome da segunda m�quina virtual (Ubuntu; Node 2).

Para que tudo funcione seguiremos os passos a seguir:

Configuraç�o das m�quinas i. Configuraç�o do Hub central na nossa m�quina f�sica local utilizando o Selenium Grid;ii. Virtualizaç�o de duas m�quinas com Ubuntu utilizando o VirtualBox;iii. Configuraç�o dos Nodes nas duas m�quinas virtuais, e ap�s, lig�-las ao Hub central utilizando Selenium Grid;
Criaç�o de um novo projeto no Eclipse com Maven utilizando o Java 8;
Criaç�o das classes utilizando o Selenium WebDriver;
Criaç�o das classes de testes utilizando o TestNG e posterior execuç�o dos mesmos;

Assim, a vis�o geral desse artigo pode ser vista na Figura 3.

Figura 3. Fluxo de execuç�o da vis�o geral

Configuraç�o das m�quinas

Para começar precisamos baixar o Selenium Standalone Server .jar (vide seç�o Links). Para criar o hub central em nossa m�quina f�sica local executaremos o comando a seguir (use o shell ou prompt de comando, pois o comando funciona para todos os sistemas operacionais):


java -jar selenium-server-standalone-2.47.1.jar -role hub

Caso o comando n�o funcione, provavelmente � porque ainda n�o tem instalado o Java na m�quina ou n�o configurou bem as var�veis de ambiente.

Se tudo ocorreu bem, a mensagem apresentada ser� semelhante � Figura 4.

Figura 4. Mensagem de sucesso

Repare na linha em destaque que o Selenium Standalone Server nos forneceu o endereço, que servir� para registar os Nodes ao Hub central.

Se colocarmos no navegador o endereço http://192.168.0.6:4444/grid/console, podemos observar quais nodes est�o sob controle do Hub central, al�m das suas configuraç�es, como mostra a Figura 5.

Figura 5. P�gina web que exibe o(s) Node(s) ligado(s) ao Hub central

Precisamos agora virtualizar duas m�quinas utilizando o VirtualBox e depois fazer as configuraç�es de Nodes nelas. Baixe ISO do VirtualBox na vers�o do sistema operacional da m�quina local (vide seç�o Links), que no nosso caso � o Ubuntu em sua vers�o �14.10� 32 bits.

Com o programa aberto, clique em Novo e informe dentro do VirtualBox o valor �ubuntu 1� no campo nome e selecione a vers�o �Ubuntu (32 bits)�, como na Figura 6.

Figura 6. VirtualBox e o �Nome e Sistema Operacional� da m�quina virtual

Ap�s clicar em pr�ximo, a tela seguinte ser� para informar o tamanho da mem�ria. Como ser�o configuradas duas m�quinas, selecione apenas � da mem�ria total e clique em �Pr�ximo >�.

Na nova tela configuraremos o HD: certifique-se que as opç�es a seguir ser�o marcadas nas pr�ximas telas:

opç�o �Criar um disco r�gido virtual agora� e clique em �Criar�;
tipo de arquivo de disco r�gido de ser o �VDI (VirtualBox Disk Image)�;
o tipo �Armazenamento em disco r�gido f�sico� deve ser selecionado;
o tamanho deve ser �Tamanho Fixo�;
para a tela de �Localizaç�o e tamanho do arquivo� deixe o m�nimo recomend�vel, que no caso s�o 8 GB para o Ubuntu, em seguida clique em �Criar�.

Depois de termos criado a nossa m�quina virtual, selecione-a na janela principal do VirtualBox e depois clique no menu �Configuraç�es�. Na janela aberta selecione o item �Rede� no lado esquerdo e depois clique na aba �Adaptador 1� e, logo em seguida, na opç�o �Conectado a:� escolha o item �Placa em modo Bridge�, como mostra a Figura 7.

Figura 7. Configuraç�es de rede

Ainda com a opç�o �ubuntu 1� selecionada, clique no menu de opç�es �Iniciar (T)� para iniciar a instalaç�o do Ubuntu. Assim, uma janela como a Figura 8 � apresentada. Selecione o local onde est� a ISO ou disco de instalaç�o e depois clique em �Iniciar�.

Figura 8. Seleç�o do disco r�gido de boot

Para criar a segunda m�quina virtual basta repetir os mesmos passos, por�m, use o nome �ubuntu 2�. Ap�s a criaç�o, instale o Java em ambas e os respectivos browsers, de acordo com as instruç�es passadas no in�cio do artigo.

Para o Chrome, vamos baixar o driver direto do site do Selenium (vide seç�o Links). V� at� a seç�o �Third Party Drivers, Bindings, and Plugins → Browser� e clique no link chromedriver_linux32.zip. Este driver � necess�rio para facilitar a comunicaç�o do navegador com o Selenium Standalone Server (Hub central). Ap�s baixar realize a configuraç�o com os seguintes comandos:

No Ubuntu) e Mac OS X:
export PATH=$PATH:/caminho/para/chromedriver
No Windows:
PATH=$PATH;\caminho\para\chromedriver

Para o Firefox n�o precismos baixar ou configurar nenhum driver.

Para configurar os nodes nas m�quinas virtuais e lig�-las a Hub central precisamos executar um comanda Java em cada m�quina virtual. Para o Node 1 execute o seguinte comando:


java -jar selenium-server-standalone-2.47.1.jar -role node -hub 
http://192.168.0.6:4444/grid/register -browser browserName="firefox", 
maxInstances=1,platform=LINUX

E para o Node 2 execute o comando:


java -jar selenium-server-standalone-2.47.1.jar -role node -hub 
http://192.168.0.6:4444/grid/register -browser browserName="chrome", 
maxInstances=1,platform=LINUX

Note que o valor �http://192.168.0.6:4444/grid/register� a frente do comando -hub se refere ao endereço do Hub central, assim fizemos o registro ao Hub central.

Repare tamb�m que no comando �-browser� definimos ao atributo -browserName o nome do navegador que estar� apto para a executar os testes funcionais da aplicaç�o web.

Ao final podemos visualizar no endereço http://192.168.0.6:4444/grid/console os Nodes que registramos, como mostra a Figura 9.

Figura 9. Selenium Standalone Server (Hub central) exibindo os Nodes registrados

Criando o projeto

No Eclipse pressione CTRL+N e selecione o item Project Maven. Ao clicar em "Next >" uma nova janela se abrir� e nela marque o checkbox "Create a simple project" e clique em "Next"novamente. Uma nova tela aparecer� e deve ser preenchida conforme mostra a Figura 10.

Figura 10. Configuraç�es do projeto Maven

Para adicionar as depend�ncias no POM do Maven abra o pom.xml e acrescente o c�digo da Listagem 1 entre as tags . Logo ap�s execute o �Maven Update Project� utilizando o ALT+F5.


<build>
   <plugins>
     <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-compiler-plugin</artifactId>
       <!-- Vers�o do plugin maven -->
       <version>3.3</version>
       <configuration>
         <!-- Vers�o do java -->
         <source>1.8</source>
         <target>1.8</target>
      </configuration>
    </plugin>
  </plugins>
</build>
<properties>
     <!-- Vers�o do selenium -->
     <selenium.version>2.47.1</selenium.version>
</properties>
<dependencies>
     <!-- Selenium -->
     <dependency>
       <groupId>org.seleniumhq.selenium</groupId>
       <artifactId>selenium-java</artifactId>
       <version>${selenium.version}</version>
       <scope>test</scope>
    </dependency>
    <!--Driver do Selenium remoto -->
    <dependency>
        <groupId>org.seleniumhq.selenium</groupId>
        <artifactId>selenium-remote-driver</artifactId>
        <version>${selenium.version}</version>
        <scope>test</scope>
    </dependency>
    <!-- TestNG -->
    <dependency>
        <groupId>org.testng</groupId>
           <artifactId>testng</artifactId>
        <version>6.9.6</version>
        <scope>test</scope>
    </dependency>
</dependencies>

Listagem 1. Depend�ncias do projeto

Criando as classes principais

Precisamos agora criar a estrutura de pacotes da Figura 11 em nosso projeto no diret�rio /projeto-maven/src/main/java.

Figura 11. Estrutura de pacote

Na Interface EstabelecerDriver.java precisamos adicionar o c�digo da Listagem 2 para definir as propriedades que o WebDriver usar� para acessar o browser. Assim, ao solicitar uma nova sess�o, o cliente pode especificar o browser e a plataforma a serem usadas.


public interface EstabelecerDriver {
 
   //Declaraç�es de m�todos
 
   WebDriver obterObjetoWebDriver(DesiredCapabilities desiredCapabilities);
 
   WebDriver obterObjetoWebDriverRemoto(DesiredCapabilities desiredCapabilities,
    Platform  plataforma, String enderecoRemoto);
 
   DesiredCapabilities obterCapacidadesDesejadas();
}

Listagem 2. C�digo da Interface EstabelecerDriver.java

Para o Enum TipoDriver adicionaremos o c�digo da Listagem 3. Este servir� para definir tipos de drivers, que cont�m m�todos �teis dos quais iremos utilizar nas classes de testes para a chamada de inst�ncias de WebDriver's (Firefox e Chrome).


public enum TipoDriver implements EstabelecerDriver {

 FIREFOX {
             
   public DesiredCapabilities obterCapacidadesDesejadas() {
     DesiredCapabilities capabilities = DesiredCapabilities.firefox();
     return capabilities;
   }

 public WebDriver obterObjetoWebDriver(DesiredCapabilities capabilities) {
    return new FirefoxDriver(capabilities);
 }

 public WebDriver obterObjetoWebDriverRemoto(
   DesiredCapabilities capabilities, Platform plataforma,
   String enderecoRemoto) {

     capabilities.setPlatform(plataforma);

     WebDriver driver = null;
     try {
         driver = new RemoteWebDriver(new URL(enderecoRemoto),
         capabilities);

     } catch (MalformedURLException e) {

         e.printStackTrace();
     }

     return driver;
   }

 },
 CHROME {

  public DesiredCapabilities obterCapacidadesDesejadas() {
    DesiredCapabilities capabilities = DesiredCapabilities.chrome();

    capabilities.setCapability("chrome.switches",
    Arrays.asList("--no-default-browser-check"));

    HashMap<String, String> chromePreferences = new HashMap<String, String>();
    chromePreferences.put("profile.password_manager_enabled", "false");

    capabilities.setCapability("chrome.prefs", chromePreferences);
    // Fim

    return capabilities;
  }

   public WebDriver obterObjetoWebDriver(DesiredCapabilities capabilities) {
      return new ChromeDriver(capabilities);
   }

    public WebDriver obterObjetoWebDriverRemoto(
     DesiredCapabilities capabilities, Platform plataforma,
     String enderecoRemoto) {

       capabilities.setPlatform(plataforma);
       WebDriver driver = null;
       try {
         driver = new RemoteWebDriver(new URL(enderecoRemoto),
         capabilities);
       } catch (MalformedURLException e) {

          e.printStackTrace();
       }

       return driver;
    }
}

Listagem 3. C�digo do Enum TipoDriver

A seguir temos alguns detalhes importantes sobre esse c�digo:

Linha 5: temos o m�todo que retorna as capacidades para usar o Firefox;
Linha 10: temos o m�todo que retorna uma inst�ncia do Driver do Firefox para uso;
Linha 15: temos o m�todo que retorna um objeto remoto;
Linha 19: Define o sistema operacional;
Linha 23: Atribuiç�o da inst�ncia do objeto remoto WebDriver, com o retorno na linha 31;
Linha 37: temos o m�todo que retorna as capacidades para usar o Chrome;
Linhas 40 a 47: temos neste bloco a definiç�o de alguns comandos para o Google Chrome, pois n�o queremos aquela pergunta de definiç�o do navegador padr�o e nem que o gerenciador de senhas pergunte se gostaria de salvar os dados de login cada vez que um teste executar uma aç�o de login;
Linha 52: m�todo que retorna uma inst�ncia do Driver do Chrome para uso;
Linha 56: m�todo que retorna um objeto WebDriver remoto.

Note que ao lado do nome do Enum TipoDriver existe a definiç�o implements EstabelecerDriver: isso quer dizer que o Enum TipoDriver est� assinando um contrato com a interface EstabelecerDriver e, como consequ�ncia, ir� definir todos os m�todos declarados na interface. Contudo, conseguimos definir os Enums FIREFOX e CHROME, que ser�o �teis na criaç�o das classes testes.

Partiremos para a criaç�o de outro pacote com a estrutura semelhante � Figura 12 no diret�rio /projeto-maven/src/main/java. Este servir� para colocarmos a classe de apoio ConversorTemperatura, que conter� m�todos de convers�o de temperatura, �teis para as classes de testes.

Figura 12. Pacote .apiconversor

Na Listagem 4 temos o c�digo da classe ConversorTemperatura.java, que fornecer� os resultados de c�lculos de convers�o de temperatura.


public class ConversorTemperatura {
                
   private final static Integer SCALE = 6;
   private static Double valor = null;
 
   public static Double aplicarScala(Double valor) {
     // Atribui um BigDecimal que recebendo o valor de um Double e que ao
     // final � lhe aplicado um escala
     BigDecimal bd = new BigDecimal(valor).setScale(SCALE,
     RoundingMode.HALF_EVEN);
     // retorna o valor em Double
     return bd.doubleValue();
   }
 
   // Convers�o do valor de Celsius para Fahrenheit
   public static String celsiusParaFahrenheit(String celsius) {
     // Atribui o valor em Double convertida de uma String
     valor = Double.parseDouble(celsius);
     // Retorna uma String convertida de um valor Double onde lhe foi
     // aplicado uma escala
     return String.valueOf(aplicarScala(1.8 * valor + 32.0));
   }
 
   // Convers�o do valor de Fahrenheit para Celsius
   public static String fahrenheitParaCelsius(String fahrenheit) {
    // Atribui o valor em Double convertida de uma String
    valor = Double.parseDouble(fahrenheit);
    // Retorna uma String convertida de um valor Double onde lhe foi
    // aplicado uma escala
    return String.valueOf(aplicarScala((5.0 * (valor - 32.0) / 9.0)));
  }
 
}

Listagem 4. C�digo da classe ConversorTemperatura.java

O M�todo aplicarScala aplica a escala no valor Double, ou seja, o resultado do valor 51.12313121323123 ficar� 51.123131, com no m�ximo seis d�gitos ap�s a v�rgula.

Na Figura 13 vemos o novo pacote e as classes que precisamos criar no diret�rio /projeto-maven/src/main/java. Nessas classes incluiremos o mapeamento das p�ginas da aplicaç�o web utilizando o Selenium WebDriver, bem como m�todos �teis, isso porque criaremos os testes funcionais com base nelas.

A Listagem 5deve ser inclu�da na classe PaginaInicio e tem como objetivo fazer refer�ncia a p�gina In�cio da aplicaç�o (http://artigo.pe.hu).

Figura 13. Estrutura do pacote .fabricaobjetivopagina


public class PaginaInicio {
 @FindBy(how = How.ID, using = "conversor")
 private WebElement menuOpcaoConversor;
 @FindBy(how = How.ID, using = "temperatura")
 private WebElement menuOpcaoConversorTemperatura;
 private WebDriver driver;
 public PaginaInicio(WebDriver driver) {
   this.driver = driver;
   PageFactory.initElements(driver, this);
 this.driver.get("http://artigo.pe.hu");
}

public PaginaConversorTemperatura irParaPaginaConversorTemperatura() {
  Actions acoesAvancadasDeUsuario = new Actions(driver);
  WebDriverWait wait = new WebDriverWait(driver, 10);
  acoesAvancadasDeUsuario.moveToElement(menuOpcaoConversor).perform();
  wait.until(ExpectedConditions
  .visibilityOf(menuOpcaoConversorTemperatura));
  acoesAvancadasDeUsuario.moveToElement(menuOpcaoConversorTemperatura)
  .click().perform();

  return new PaginaConversorTemperatura(driver);
}
}

Listagem 5. C�digo da classe PaginaInicio.java

Na linha 2 começa o mapeamento entre o objeto WebElement com o elemento HTML que tem o id="conversor"na p�gina web. Na linha 4 temos o mesmo tipo de mapeamento, mas com o id="temperatura".

Na linha 7 temos a implementaç�o do construtor com a atribuiç�o do par�metro que tem a inst�ncia para o objeto do WebDriver corrente

O comando da linha 9 permite que os atributos mapeados nesta classe com @FindBy sejam carregados com os elementos HTML correspondentes para iniciar o navegador com o endereço web.

Na linha 14 inicializa-se o objeto Actions para uso com o WebDriver corrente, assim como a linha 15, que inicializa o objeto WebDriverWait para uso com o Webdriver corrente. No construtor da classe, al�m de ser definido o Webdriver, foi tamb�m definido o tempo de espera de 10 segundos. Se passar disso � lançada uma exception at� que os itens do menu Conversor apareçam. Quando isso acontecer, clique no item Conversor de Temperatura.

As aç�es ocorrem em tempo real na aplicaç�o web e para satisfazer o retorno do m�todo, o objeto da classe PaginaConversorTemperatura deve ser retornado com o driver corrente.

Na classe PaginaConversorTemperatura.java precisamos incluir o c�digo da Listagem 6, pois esta far� refer�ncia � P�gina Conversor de Temperatura (http://artigo.pe.hu/?pg=conv_temperatura.php).


public class PaginaConversorTemperatura {
 
  // Mapeamento entre o objeto WebElement com o elemento html que tem o
  // id="valuefromtemperature1" na p�gina web
  @FindBy(how = How.ID, using = "valuefromtemperature1")
  private WebElement valorEntrada;
 
  // Mapeamento entre o objeto WebElement com o elemento html que tem o
  // id="selectfromtemperature1" na p�gina web
  @FindBy(how = How.ID, using = "selectfromtemperature1")
  private WebElement webSelectDe;
 
  // Mapeamento entre o objeto WebElement com o elemento html que tem o
  // id="selecttotemperature1" na p�gina web
  @FindBy(how = How.ID, using = "selecttotemperature1")
  private WebElement webSelectPara;
 
  // Mapeamento entre o objeto WebElement com o elemento html que tem o
  // id="valuetotemperature1" na p�gina web
  @FindBy(how = How.ID, using = "valuetotemperature1")
  private WebElement resultado;
 
  // WebDriver
  private WebDriver driver;
 
   // Implementaç�o do construtor
   public PaginaConversorTemperatura(WebDriver driver) {
     // Atribuiç�o do parametro que tem inst�ncia do WebDriver, para o objeto
     // WebDriver que tem o escopo desta classe
     this.driver = driver;
     // Permite que os atributos mapeados nesta classe com @FindBy sejam
     // carregados com os elementos html correspondente
     PageFactory.initElements(this.driver, this);
     // Carrega e inicia o navegador com o endereço web
     this.driver.get("http://artigo.pe.hu/?pg=conv_temperatura.php");
   }
 
   public void preencherValorDeEntrada(String i) {
    // Comando que envia valores para o elemento html
    valorEntrada.sendKeys(i);
  }
 
   public WebElement obterValorDeEntrada() {
     // retorna objeto WebElement
     return valorEntrada;
   }
 
    public Select obterSelectDeTemperatura() {
     // Retorna um objeto Select que faz refer�ncia ao elemento html Select
     // na p�gina web
     return new Select(webSelectDe);
    }
 
     public Select obterSelectParaTemperatura() {
      // Retorna um objeto Select que faz refer�ncia ao elemento html Select
      // na p�gina web
      return new Select(webSelectPara);
     }
 
     public WebElement obterResultadoTemperatura() {
       // retorna objeto WebElement
       return resultado;
     }
 
}

Listagem 6. C�digo da PaginaConversorTemperatura.java

A classe PaginaTrabalheConosco est� presente no c�digo da Listagem 7 e tem como objetivo fazer refer�ncia a P�gina Trabalhe Conosco (http://artigo.pe.hu/?pg=trabalhe_conosco.php).


public class PaginaTrabalheConosco {
 
   // Mapeamento entre o objeto WebElement com o elemento html que tem o
   // id="nome" na p�gina web
   @FindBy(how = How.ID, using = "nome")
   private WebElement nome;
 
   // Mapeamento entre o objeto WebElement com o elemento html que tem o
   // id="email" na p�gina web
   @FindBy(how = How.ID, using = "email")
   private WebElement email;
 
   // Mapeamento entre o objeto WebElement com o elemento html que tem o
   // id="opcaoMasculino" na p�gina web
   @FindBy(how = How.ID, using = "opcaoMasculino")
   private WebElement opcaoSexoMasculino;
 
   // Mapeamento entre o objeto WebElement com o elemento html que tem o
   // id="checkIngles" na p�gina web
   @FindBy(how = How.ID, using = "checkIngles")
   private WebElement checkIdiomaIngles;
 
   // Mapeamento entre o objeto WebElement com o elemento html que tem o
   // id="selectOpcaoVaga" na p�gina web
   @FindBy(how = How.ID, using = "selectOpcaoVaga")
   private WebElement selectOpcaoVaga;
 
   // Mapeamento entre o objeto WebElement com o elemento html que tem o
   // id="arquivoCurriculo" na p�gina web
   @FindBy(how = How.ID, using = "arquivoCurriculo")
   private WebElement arquivoCurriculo;
 
   // Mapeamento entre o objeto WebElement com o elemento html que tem o
   // id="botaoEnviar" na p�gina web
   @FindBy(how = How.ID, using = "botaoEnviar")
   private WebElement botaoEnviar;
 
   // Mapeamento entre o objeto WebElement com o elemento html que tem o
   // id="msgAposEnvio" na p�gina web
   @FindBy(how = How.ID, using = "msgAposEnvio")
   private WebElement msgAposEnvio;
 
   // WebDriver
   private WebDriver driver;
 
   // Implementaç�o do construtor
   public PaginaTrabalheConosco(WebDriver driver) {
   // Atribuiç�o do parametro que tem inst�ncia do WebDriver, para o objeto
   // WebDriver que tem o escopo desta classe
   this.driver = driver;
   // Permite que os atributos mapeados nesta classe com @FindBy sej�o
   // carregados com os elementos html correspondente
   PageFactory.initElements(this.driver, this);
   // Carrega e inicia o navegador com o endereço web
   this.driver.get("http://artigo.pe.hu/?pg=trabalhe_conosco.php");
 }
 
 public void preencherNome(String nomeValor) {
  // Comando que envia valores para o elemento html
  nome.sendKeys(nomeValor);
 }
 
 public void preencherEmail(String emailValor) {
    // Comando que envia valores para o elemento html
    email.sendKeys(emailValor);
 }
 
 public void marcarRadioButtonSexoMasculino() {
   // Comando que clica no elemento html
   opcaoSexoMasculino.click();
 
 }
 
 public void marcarCkeckBoxIdiomaIngles() {
    // Comando que clica no elemento html
    checkIdiomaIngles.click();
 }
 
 public void selecionarVaga(String vaga) {
   // Atribuiç�o de objeto Select que faz refer�ncia ao elemento html
   // Select
   Select selOpcaoVaga = new Select(selectOpcaoVaga);
   // Comando que marca a opç�o do select que tem o texto x vis�vel na
   // p�gina web
   selOpcaoVaga.selectByVisibleText(vaga);
 }
 
 public void selecionarArquivoCurriculo(String urlAbsolutaDoArquivoPdf) {
   // Comando que envia valores para o elemento html
   arquivoCurriculo.sendKeys(urlAbsolutaDoArquivoPdf);
 }
 
 public void enviarMensagemDeTrabalheConosco() {
   // Comando que clica no elemento html
   botaoEnviar.click();
 }
 
 public String obterMensagemAposEnvio() {
   // Comando retorna o texto vis�vel do elemento html
   return msgAposEnvio.getText();
 }
}

Listagem 7. C�digo da classe P�ginaTrabalheConosco

Criaç�o dos testes

Para os nossos testes criaremos duas classes no diret�rio /projeto-maven/src/test/java, conforme a estrutura vista na Figura 14.

Figura 14. Estrutura do pacote .testepaginas

A classe TestePaginaTrabalheConosco.java, presente na Listagem 8, ir� executar os testes funcionais da p�gina Trabalhe conosco no navegador Firefox do Node 1, ent�o, certifique-se que o endereço da primeira m�quina virtual est� igual ao valor do par�metro do m�todo obterObjetoWebDriverRemoto(), que est� dentro do m�todo inicializarDriver() da classe TestePaginaTrabalheConosco. Lembre-se que os endereços dos Nodes podem ser visualizados em http://192.168.0.6:4444/grid/console (Selenium Standalone Server).


public class TestePaginaTrabalheConosco {
  // Declaraç�o de vari�vel
  WebDriver driver;
 
  @BeforeClass
  public void inicializarDriver() throws Exception {
    // Atribuiç�o da inst�ncia do Enum do Tipo Firefox
    TipoDriver selecionadoTipoDriver = TipoDriver.FIREFOX;
     // Atribuiç�o das capacidades para usar o tipo driver Firefox
     DesiredCapabilities capacidadesDesejadas = selecionadoTipoDriver
.obterCapacidadesDesejadas();

 
      driver = selecionadoTipoDriver.obterObjetoWebDriverRemoto(
capacidadesDesejadas, Platform.LINUX,
"http://192.168.0.9:5555/wd/hub");

 
      /**
* driver =
* selecionadoTipoDriver.obterObjetoWebDriver(capacidadesDesejadas);
*/

   }
 
   @AfterClass
   public void fecharDriver() {
    if (null != driver) {
     driver.quit();
    }
   }
   @Parameters({ "nomeParametro" })
   // Executa o m�todo como teste
   @Test
   public void testeEnviarMensagemDeTrabalheConosco(String nomeParametro) {
      PaginaTrabalheConosco paginaTrabalheConosco = new PaginaTrabalheConosco(
      driver);
      // Preenche o campo nome
      paginaTrabalheConosco.preencherNome(nomeParametro);
      // Preenche o campo email
      paginaTrabalheConosco.preencherEmail("brendo10x@gmail.com");
      // Marca a opç�o do radio button
      paginaTrabalheConosco.marcarRadioButtonSexoMasculino();
      // Marca a opç�o do checkbox
      paginaTrabalheConosco.marcarCkeckBoxIdiomaIngles();
      // Seleciona a opç�o do select
      paginaTrabalheConosco.selecionarVaga("Suporte de TI");
      // Escolhe o arquivo pdf
      paginaTrabalheConosco
      .selecionarArquivoCurriculo("/home/brendo/curriculo.pdf");
      // Clica no bot�o para enviar o formul�rio com as informaç�es acima
      paginaTrabalheConosco.enviarMensagemDeTrabalheConosco();
      // Retorna a mensagem informada na p�gina conversor temperatura
      String msg = paginaTrabalheConosco.obterMensagemAposEnvio();
      // Verifica se s�o iguais, o resultado com o esperado
      Assert.assertEquals(msg, "Sucesso!");
  }
}

Listagem 8. C�digo da TestePaginaTrabalheConosco.java

No primeiro m�todo a ser chamado na classe � anotado com @BeforeClass do TestNG. Em seguida, � atribu�da a inst�ncia do Enum do Tipo Firefox e as capacidades para usar o tipo driver(Firefox).

H� a atribuiç�o do WebDriver remoto, com as definiç�es de que os testes funcionais desta classe ser�o executados no navegador Google Chrome do Node http://192.168.0.9:5555/wd/hub (1� m�quina virtual usando Linux.

Descomente o seguinte trecho de c�digo e comente o anterior caso deseje testar esta classe no seu computador.


/**
 * driver =
 * selectedDriverType.obterObjetoWebDriver(desiredCapabilities);
 */

O �ltimo m�todo fecharDriver() � executado, pois est� anotado com @AfterClass do TestNG. Ele verifica se o driver � diferente null e se for, fecha o driver, ou seja o navegador que est� em execuç�o.

Na linha @Parameters({ "nomeParametro"}) temos a definiç�o de par�metro para que o m�todo testeEnviarMensagemDeTrabalheConosco receba a partir do arquivo do testng.xml (do TestNG) declarado neste projeto.

Na Listagem 9 temos o c�digo da classe TestePaginaConversorTemperatura, que ir� executar os testes funcionais no navegador Google Chrome do Node 2.


public class TestePaginaConversorTemperatura {
private Select selectDe;
private Select selectPara;
private WebElement resultado;
private WebElement entrada;
private WebDriver driver;
private String resultadoValor;
private String resultadoCalculado;

@BeforeClass
public void inicializarDriver() throws Exception {

	TipoDriver selecionadoTipoDriver = TipoDriver.CHROME;
	DesiredCapabilities capacidadesDesejadas = selecionadoTipoDriver
			.obterCapacidadesDesejadas();

	driver = selecionadoTipoDriver.obterObjetoWebDriverRemoto(
			capacidadesDesejadas, Platform.LINUX,
			"http://192.168.0.2:5555/wd/hub");

	/**
	 * driver =
	 * selecionadoTipoDriver.obterObjetoWebDriver(capacidadesDesejadas);
	 */

}

@AfterClass
public void fecharDriver() {
	if (null != driver) {
		driver.quit();
	}
}

@Parameters({ "entradaParametro" })
// Executa o m�todo como teste
@Test
public void testeCalcularConversorTemperatura(String entradaParametro)
		throws Exception {
	// Este teste executa como se fosse passos de usu�rio
	// Inicia a p�gina inicial
	PaginaInicio paginaInicio = new PaginaInicio(driver);

	// Depois vai, da p�gina inicial at� a p�gina Converso de Temperatura
	PaginaConversorTemperatura paginaConversorTemperatura = paginaInicio
			.irParaPaginaConversorTemperatura();

	// Estando na p�gina Conversor de temperatura
	// Preencha o campo com o valor de entrada
	paginaConversorTemperatura.preencherValorDeEntrada(entradaParametro);

	// Atribui o valor de entrada a partir da refer�ncia do elemento html
	entrada = paginaConversorTemperatura.obterValorDeEntrada();
	// Atribui a refer�ncia do elemento html Select
	selectDe = paginaConversorTemperatura.obterSelectDeTemperatura();
	// Atribui a refer�ncia de outro elemento html Select
	selectPara = paginaConversorTemperatura.obterSelectParaTemperatura();
	// Por fim, atribui do valor do resultado a partir da refer�ncia do
	// elemento html
	resultado = paginaConversorTemperatura.obterResultadoTemperatura();

}

// Este teste s� executa depois que o m�todo
// testeCalcularConversorTemperatura executar, pois este teste depende da
// execuç�o dele.
@Test(dependsOnMethods = { "testeCalcularConversorTemperatura" })
public void testeCelsiusParaCelsius() {

	// Esses dois primeiros m�todos, selecionam a opç�o do elemento
	// html Select que tiver com x texto v�sivel na aplicaç�o web.
	selectDe.selectByVisibleText("Celsius [�C]");
	selectPara.selectByVisibleText("Celsius [�C]");

	// Verifica se s�o iguais, o resultado com o esperado (valor de entrada)
	Assert.assertEquals(resultado.getAttribute("value"),
			entrada.getAttribute("value"));

}

// Este teste s� executa depois que o m�todo
// testeCalcularConversorTemperatura executar, pois este teste depende da
// execuç�o dele.
@Test(dependsOnMethods = { "testeCalcularConversorTemperatura" })
public void testeCelsiusParaFahrenheit() {

	// Esses dois primeiros m�todos, selecionam a opç�o do elemento
	// html Select que tiver com x texto vis�vel na aplicaç�o web.
	selectDe.selectByVisibleText("Celsius [�C]");
	selectPara.selectByVisibleText("Fahrenheit [�F]");

	// Atribui o valor do atributo value do elemento html
	resultadoValor = resultado.getAttribute("value");

	// Atribui o resultado da convers�o
	resultadoCalculado = ConversorTemperatura.celsiusParaFahrenheit(entrada
			.getAttribute("value"));

	// Verifica se s�o iguais, o resultado com o esperado
	Assert.assertEquals(resultadoValor, resultadoCalculado);

}

// Este teste s� executa depois que o m�todo
// testeCalcularConversorTemperatura executar, pois este teste depende da
// execuç�o dele.
@Test(dependsOnMethods = "testeCalcularConversorTemperatura")
public void testeFahrenheitParaCelsius() {

	// Esses dois primeiros m�todos, selecionam a opç�o do elemento
	// html Select que tiver com x texto v�sivel na aplicaç�o web.
	selectDe.selectByVisibleText("Fahrenheit [�F]");
	selectPara.selectByVisibleText("Celsius [�C]");

	// Atribui o valor do atributo value do elemento html
	resultadoValor = resultado.getAttribute("value");

	// Atribui o resultado da convers�o
	resultadoCalculado = ConversorTemperatura.fahrenheitParaCelsius(entrada
			.getAttribute("value"));

	// Verifica se s�o iguais, o resultado com o esperado
	Assert.assertEquals(resultadoValor, resultadoCalculado);

}

// Este teste s� executa depois que o m�todo
// testeCalcularConversorTemperatura executar, pois este teste depende da
// execuç�o dele.
@Test(dependsOnMethods = { "testeCalcularConversorTemperatura" })
public void testeFahrenheitParafahrenheit() {

	// Esses dois primeiros m�todos, selecionam a opç�o do elemento
	// html Select que tiver com x texto vis�vel na aplicaç�o web.
	selectDe.selectByVisibleText("Fahrenheit [�F]");
	selectPara.selectByVisibleText("Fahrenheit [�F]");

	// Verifica se s�o iguais, o resultado com o esperado (valor de entrada)
	Assert.assertEquals(resultado.getAttribute("value"),
			entrada.getAttribute("value"));

}

Listagem 9. C�digo da classe de TestePaginaConversorTemperatura.java

Execuç�o dos testes

Antes de executarmos os testes, certifique-se que os Nodes e o Hub central est�o funcionando corretamente. Lembre-se que o TestNG deve estar instalado no seu Eclipse (vide seç�o Links).

Agora, termos que criar um arquivo de configuraç�o do TestNG para dizermos a ele quais classes de testes ser�o executadas. Sendo assim, crie um arquivo chamado testng.xml no diret�rio /projeto-maven/src/test/resources e, em seguida cole o c�digo da Listagem 10 no arquivo testng.xml.


<suite name="Suite de teste" parallel="tests" thread-count="2">
                
   <test name="Teste na primeira m�quina">
       <parameter name="entradaParametro" value="2" />
       <classes>
         <class
         name="br.com.aprendendo.selenium.testepaginas.TestePaginaConversorTemperatura" />
      </classes>
    </test>
    <test name="Teste na segunda m�quina">
     <parameter name="nomeParametro" value="Brendo Felipe" />
     <classes>
       <class
       name="br.com.aprendendo.selenium.testepaginas.TestePaginaTrabalheConosco" />
     </classes>
   </test>
</suite>

Listagem 10. C�digo do arquivo testng.xml

Observe que no arquivo criado declaramos na tag dois atributos importantes: o parallel="tests" e thread-cont="2". Isso significa que o TestNG far� o lançamento ou execuç�o dos testes de forma paralela. Com isso, fizemos um �Aperfeiçoamento� e os testes ser�o iniciados e executados ao mesmo tempo, no respectivo navegador.

Neste momento, o nosso projeto j� est� pronto e agora vamos executar os nossos testes funcionais distribu�dos. Para isso, primeiro selecione o arquivo testng.xml e em seguida clique com o bot�o direto e escolha as opç�es Run As → TestNG Suite.

Figura 15. Mostra o resultado dos testes

Como mostra a Figura 15 todos os testes passaram. Assim, vimos na pr�tica como agilizar os nossos testes e otimizar o desenvolvimento das nossas aplicaç�es.

Links: