Adicionando versão do JAR ao manifest.xml usando Maven

O Selenium e o Webdriver se uniram para criar um poderoso framework de código aberto para testes de aceitação baseado em javascript para as aplicações web. Os testes podem ser realizados com um browser normal, instanciado e aberto como também pode fornecer um driver leve, super rápido que simula um browser baseado no HtmlUnit dando suporte para situações comuns que poderiam ser testadas em uma aplicação web.

Se você quiser fazer uns testes, basta baixar os .jars e adicionar ao classpath do seu projeto.

Nesse “how-to” irei desenvolver testes de integração com o Selenium e o Webdriver, que serão executados no ciclo de vida do maven, configurados através do cargo-maven-plugin.

O cargo-maven-plugin é utilizado frequentemente para deploy de aplicações utilizando o maven. O cargo instala o container e as dependências necessárias para o deploy da sua aplicação. Pode ser configurado para diversos containers como Tomcat, JBoss, Jetty(embedded), GlashFish entre outros. Ele levantará o container configurado e irá fazer o deploy da aplicação e em seguida os testes do Selenium serão executados.

Para exemplifcar melhor, irei utilizar o projeto cadastro Modelos de Celulares desenvolvido no post anterior e adicionar simplesmente os testes do Selenium e as configurações do cargo-maven-plugin.

Primeiramente vamos adicionar a dependência do cargo-maven-plugin que irá levantar o container para a execução dos testes e então vamos configurá-lo para fazê-lo na fase pre-integration-test do ciclo de vida do maven e desligar o container no post-integration-test. O container utilizado no exemplo foi o Tomcat 6x que deve está instalado localmente e definido no atributo <home>.

Será necessário adicionarmos mais um plugin para que todos os testes sejam executados quando o container estiver levantado. O plugin que utilizaremos é o maven-surefire-plugin.

Segue abaixo a configuração dos plugins cargo-maven-plugin e maven-surefire-plugin que devem ser configurados no pom.xml:

<plugin>
   <groupId>org.codehaus.cargo</groupId>
   <artifactId>cargo-maven2-plugin</artifactId>
   <version>1.0.6</version>
   <configuration>
      <wait>false</wait>
      <!-- Container configuration -->
      <container>
         <type>installed</type>
         <containerId>tomcat6x</containerId>
         <home>${TOMCAT_HOME}</home>
      </container>
   </configuration>
   <executions>
      <execution>
         <id>start-container</id>
         <phase>pre-integration-test</phase>
         <goals>
            <goal>start</goal>
         </goals>
      </execution>
      <execution>
         <id>stop-container</id>
         <phase>post-integration-test</phase>
         <goals>
           <goal>stop</goal>
         </goals>
      </execution>
   </executions>
</plugin>
<plugin>
   <groupId>org.apache.maven.plugins</groupId>
   <artifactId>maven-surefire-plugin</artifactId>
   <configuration>
   <!-- Skip the normal tests,
                 we'll run them in the integration-test phase -->
      <skip>true</skip>
   </configuration>
   <executions>
      <execution>
         <phase>integration-test</phase>
         <goals>
            <goal>test</goal>
         </goals>
         <configuration>
            <skip>false</skip>
         </configuration>
      </execution>
   </executions>
</plugin>

Em seguida vamos adicionar a dependência do Selenium para implementarmos os testes de aceitação. Basta adicionar ao pom.xml

<dependency>
   <groupId>org.seleniumhq.selenium</groupId>
   <artifactId>selenium</artifactId>
   <version>2.0a4</version>
   <scope>test</scope>
</dependency>

Após adicionar a dependência vamos a classe de teste. Os objetos do browser são acessados através de quatro drivers oficiais: FirefoxDriver, que o driver mais maduro e o utilizado no exemplo, Internet Explorer Driver, testado com as versões IE6, IE7 no windows Vista e XP e aparentemente é o mais lento dos drivers. Tem também o ChromeDriver, relativamente um driver mais novo e o HtmlUnit como o mais leve e rápido dos drivers por que ele emula um browser onde não é necessário instanciá-lo.

Agora vamos interagir com o browser através de métodos da classe FirefoxDriver utilizando métodos como “findElement” passando um WebElement, podendo ser recuperado através da classe By. Como podemos ver no método tentaCadastrarSemNenhumDado:

public void tentaCadastrarSemNenhumDado()  {
    driver.get("http://localhost:8080/CadastroCelular");
	driver.findElement(By.id("botaoSubmit")).click();

	String mensagemErroNome = driver.findElement(By.id("mensagemErroNome")).getText();
	Assert.assertEquals("Campo Nome Obrigatório", mensagemErroNome);

	String mensagemErroDescricao = driver.findElement(By.id("mensagemErroDescricao")).getText();
	Assert.assertEquals("Campo Descrição Obrigatório", mensagemErroDescricao);

	driver.close();
}

O método de teste acima tenta inserir um modelo de celular sem preencher nenhum campo e verifica se as mensagens de campos obrigatórios são exibidas.

Através da classe By é possível recuperar os elementos da aplicação acessando links, pelo nome, tag html, css ou pelo nome do link. Nessa versão do Selenium existe também a annotation @FindBy que foi uma forma de deixar o código mais limpo e de fácil manutenção. Com essa annotation é uma alternativa para localizar um WebElement. No caso, o método anterior foi desenvolvido sem a utilização da annotation, agora veja o mesmo método desenvolvido com a annotation @FindBy:

     @FindBy(id = "botaoSubmit")
	private WebElement botaoSubmit;

	@FindBy(id = "mensagemErroNome")
	private WebElement msgErroNome;

	@FindBy(id = "mensagemErroDescricao")
	private WebElement msgErroDescricao;

	@Test
	public void tentaCadastrarSemNenhumDado() {
	    driver.get("http://localhost:8080/CadastroCelular");
		botaoSubmit.click();

		Assert.assertEquals("Campo Nome Obrigatório", msgErroNome.getText());

		Assert.assertEquals("Campo Descrição Obrigatório", msgErroDescricao.getText());

		driver.close();
	}

Perceba que no exemplo final o código final ficou bem mais simples e limpo. A configuração e a implementação dos testes funcionais são tão simples que não existem desculpas para não testar suas aplicações. Bons testes a todos.

Tags: apache, apache tomcat, cargo-maven-plugin, maven, selenium, tomcat, webdriver