Desabafo binário

Durante o período que trabalhei na SEA Tecnologia, fui apresentado ao desenvolvimento Ágil e o desenvolvimento de aplicações usando TDD. No início participei de alguns projetos em Java, posteriormente conheci o Ruby on Rails e comecei a fazer testes com o RSpec, confesso que fiquei fascinado com a integração, facilidade e clareza que essa ferramenta de testes apresenta. Com o JRuby, projeto que compila código Ruby pra bytecode Java, podemos não só executar Ruby através da JVM, como fazer a integração com código Java. Existe um projeto que permite essa integração (Java x Ruby) utilizando maven. Então meu objetivo com esse post é mostrar como fazer essa integração, e escrever alguns testes em Ruby testando classes Java.

Pré requisito:
Maven

Instalação Jruby
Adicionar a variável de ambiente JRUBY_HOME
Edite o arquivo ~/.bash_profile, adicionando as seguintes linhas:

export JRUBY_HOME=/opt/jruby-1.3.1

Hands on, vamos começar a criação de um game, snake game o famoso jogo da cobrinha nos celulares mais antigos =P

Criando o projeto maven:

mvn archetype:generate -DarchetypeGroupId=org.apache.maven.archetypes -DgroupId=org.rodrigoramalho.snake-game -DartifactId=snake-game
# Quando aparecer essa linha, apenas aperte enter.
Choose a number or apply filter (format: [groupId:]artifactId, case sensitive contains): 16:
# Nessa também
Define value for property 'version':  1.0-SNAPSHOT: :

Depois basta confirmar (Y) e pronto o projeto estará criado.
Entre no diretório e execute a task do maven para gerar os arquivos necessários para importamos o projeto no eclipse.

cd snake-game/
mvn eclipse:eclipse

Já com o projeto importado no eclipse, ediciona o plugin do RSpec no pom.xml

<build>
<plugins>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>rspec-maven-plugin</artifactId>
<configuration>
<jrubyHome>${env.JRUBY_HOME}</jrubyHome>
<sourceDirectory>${basedir}/src/test/specs</sourceDirectory>
<outputDirectory>${basedir}/target</outputDirectory>
<systemProperties>
<property>
<name>testProp</name>
<value>testValue</value>
</property>
</systemProperties>
</configuration>
<executions>
<execution>
<id>test</id>
<phase>test</phase>
<goals>
<goal>spec</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>

Crie o diretório “specs” dentro da pasta test.
snake-game/src/test/specs  Pronto, chegando aqui seu ambiente já está (ou deveria estar, rs) configurado para começar o desenvolvimento. Então, go go go!

Criando a classe de testes em Ruby: (Como o eclipse não tem syntax highlight nativo pro Ruby, eu prefiro usar um editor de texto comum: vim, gedit, textmate)

snake-game/src/test/specs/snake_spec.rb

import org.rodrigoramalho.snakegame.model.Snake;

describe Snake do

end

Para executar o teste, rode:

mvn test

O seguinte erro vai ocorrer:

[INFO] Running RSpec tests from /Users/rodrigoramalho/Documents/workspace/snake-game/src/test/specs
/opt/jruby-1.3.1/lib/ruby/1.8/optparse.rb:605:in `get_proxy_or_package_under_package’: cannot load Java class org.rodrigoramalho.snakegame.model.Snake (NameError)
….

Então vamos criar a classe Snake.

package org.rodrigoramalho.snakegame.model;

public class Snake {

}

Rodamos os testes novamente, com mvn test.

[INFO]
[INFO] — rspec-maven-plugin:1.0-beta-6:spec (test) @ snake-game —
[INFO] Running RSpec tests from /Users/rodrigoramalho/Documents/workspace/snake-game/src/test/specs
=========================================
TOTAL: 0 passing; 0 failing; 0 pending

Qualquer alteração feita nessa classe, não é necessário rodar a task “mvn test” novamente, dentro do diretório snake-game/target/ contém um arquivo com o nome de run-specs.sh que recompila as classes e executa os testes. Utilizando esse script é economizado um bom tempo, pois roda bem mais rápido que o “mvn test”.

Os relatórios dos testes são gerados no arquivo snake-game/target/rspec_report.htmlDepois de fazer alguns testes segue o código da classe ruby. (A identação desse plugin ta zuada :/)

import org.rodrigoramalho.snakegame.model.Snake;
import org.rodrigoramalho.snakegame.model.Direcao;

describe Snake do

 before(:each) do
 @snake = Snake.new "3 5 5 NORTE"
 end

context "com parametros válidos" do

 it "deveria receber o comprimento e as coordenadas iniciais" do
 @snake.comprimento.should == 3
 @snake.posicao.x.should == 5
 @snake.posicao.y.should == 5
 @snake.posicao.direcao.should == Direcao::NORTE
 end

end

context "com parametros invalidos" do
 it "direção inválida" do
 expect{ Snake.new "5 5 5 Rodrigo" }.should raise_error(java.lang.IllegalArgumentException)
 end

 it "comprimento negativo" do
 expect{ Snake.new "-5 5 5 NORTE" }.should raise_error(java.lang.IllegalArgumentException)
 end

 it "posicao x negativa" do
 expect{ Snake.new "5 -5 5 NORTE" }.should raise_error(java.lang.IllegalArgumentException)
 end

 it "posicao y negativa" do
 expect{ Snake.new "5 5 -5 NORTE" }.should raise_error(java.lang.IllegalArgumentException)
 end
 end

 context "movimentação" do
 context "com movimentos possiveis" do
 it "deveria virar para esquerda quando estiver na direcao norte" do
 @snake.virarEsquerda();
 @snake.posicao.direcao.should == Direcao::OESTE
 end

 it "deveria virar para esquerda quando estiver na direcao sul" do
 @snake.posicao.direcao = Direcao::SUL
 @snake.virarEsquerda();
 @snake.posicao.direcao.should == Direcao::OESTE
 end

 it "deveria continuar apontando para esquerda ao tentar virar para esquerda" do
 @snake.posicao.direcao = Direcao::OESTE
 @snake.virarEsquerda();
 @snake.posicao.direcao.should == Direcao::OESTE
 end

 it "deveria virar para direita quando estiver na direcao norte" do
 @snake.virarDireita();
 @snake.posicao.direcao.should == Direcao::LESTE
 end
 end

 context "com movimentos impossíveis" do

 it 'quando apontando para o LESTE não deveria virar para a ESQUERDA' do
 @snake.posicao.direcao = Direcao::LESTE
 @snake.virarEsquerda();
 @snake.posicao.direcao.should == Direcao::LESTE
 end

 end
 end

end

Classe Java (Se quiser visualizar com detalhes, veja o fonte do código no github)

package org.rodrigoramalho.snakegame.model;

import org.rodrigoramalho.util.ValidacaoUtil;

public class Snake {

private Integer comprimento;

private Posicao posicao;

public Snake(){}

public Snake(String coordenadas){

String[] args = coordenadas.split(" ");

this.comprimento  = new Integer(args[0]);

getPosicao().setX(new Integer(args[1]));

getPosicao().setY(new Integer(args[2]));

getPosicao().setDirecao(Direcao.valueOf(args[3]));

if (ValidacaoUtil.isMenorQueZero(getComprimento(), getPosicao().getX(), getPosicao().getY()))

throw new IllegalArgumentException("Use apenas valores > 0");

}

public void virarEsquerda(){

if (getPosicao().getDirecao() != Direcao.LESTE){

getPosicao().setDirecao(Direcao.OESTE);

}

}

public Integer getComprimento() { return comprimento; }

public void setComprimento(Integer comprimento) { this.comprimento = comprimento; }

public Posicao getPosicao() {

if (posicao == null)

posicao = new Posicao();

return posicao;

}
public void setPosicao(Posicao posicao) { this.posicao = posicao; }

}

É isso ai! Depois aconselho a explorarem mais os testes com RSpec porque tem bastante coisa legal, e ainda tem o poder de fazer os testes usando 100% código Ruby, desfrutando de vários benefícios como Closures por exemplo

Fonte do projeto de exemplo.