GWT Brasil

Neste pequeno tutorial veremos como criar a primeira aplicação em GWT. Primeiramente se você ainda não fez o download do toolkit faça-o até o dia de hoje, 01/04/2007, a versão disponível é a 1.3 com distribuições Windows, Linux e Mac. Feito o download, descompacte no diretório de sua preferência. A tí­tulo de exemplo, descompactei o zip na raiz da unidade. Assim, temos a seguinte estrutura de diretórios:




C:\

|

+ gwt-windows-1.3.3

|

+doc \\Aqui você encontra o javadoc

+samples \\E aqui algumas aplicações exemplo

No diretório principal, gwt-windows-1.3.3, temos os arquivos .bat que criarão o nosso projeto. A princípio usaremos apenas 2 deles, projectCreator e applicationCreator.

O comando para usar o projectCreator é o seguinte:

ProjectCreator [-ant projectName] [-eclipse projectName] [-out dir] [-overwrite] [-ignore]


Onde, apenas os switches ant ou eclipse são necessários, mas vamos usar alguns outros. Abaixo, a descrição do que cada um faz.

• -ant
  

  Gera um build do ant com o nome sugerido seguido da extensão .ant.xml
  (recomendo mudar o nome para build.xml depois assim, o eclipse reconhece como um build file e abre com o editor padrão do ant )

• -eclipse
  

  Cria um projeto no eclipse com o nome indicado no switch

• -out
  

  Determina o diretório onde será criado o projeto. Caso não seja indicado, o padrão é o diretório atual.

• -overwrite
  

  Sobrescreve possí­veis arquivos previamente criados pelo projectCreator

• -ignore
  

  Ignora quaisquer arquivos previamente criados e não os sobrescreve.

Sendo assim, vamos criar então o primeiro projeto:

Feito isso, como visto acima, os diretórios helloWorld, src e test foram criados. Além deles, os arquivos HelloWorld.ant.xml, .project e .classpath foram criados no diretório helloWorld.

Já estamos com meio caminho andado. Até então criamos um projeto para o eclipse! Agora usaremos o applicationCreator para criar a aplicação em si.

Obs.: Nesse momento, já podemos usar o eclipse para importar o conteúdo criado até agora, mas vou deixar esse passo para depois por enquanto.

De maneira análoga ao projectCreator o applicationCreator possui a seguinte sintaxe:


ApplicationCreator [-eclipse projectName] [-out dir] [-overwrite] [-ignore] className


Nenhum dos switches acima são obrigatórios, para o ApplicationCreator apenas o className é requisito. Além disso, o nome da classe deve ser completo, incluindo a estrutura de pacotes, e um detalhe a mais deve ser observado. O ultimo pacote deve ter o nome ‘client’ ou seja, se sua aplicação possui uma classe principal chamada HelloWorld, no nosso caso, e assumindo que a estrutura de pacotes seja br.com.gwt, teremos o seguinte nome da classe: br.com.gwt.client.HelloWorld isso é apenas uma boa prática de programação estimulada pelo Google. A classe que o applicationCreator gera é a classe inicial, o “main” do sistema

Observados os detalhes acima, vamos à descrição dos switches:

• -eclipse
  

  Cria uma configuração de Debug para o projeto sugerido.

• -out
  

  O diretório em que serão gerados os arquivos. Se nenhum for informado o diretório atual será utilizado.

• -overwrite
  

  Sobrescreve quaisquer arquivos previamente gerados pelo applicationCreator.

• -ignore
  

  Ignora quaisquer arquivos previamente gerados e não os sobrescreve.

Explicado o funcionamento, vamos gerar a applicação de exemplo:

ao final, essa será a estrutura de diretórios que devemos ter:

agora, vamos ao que interessa, abrir o projeto no eclipse e executar a aplicação que já está pronta!! Abra o eclipse e importe o projeto para o workspace assim como demonstrado nas imagens abaixo:

Após ter importado o projeto para o eclipse você terá em mãos o projeto como abaixo:

Como já foi dito anteriormente, o projeto já está pronto para ser executado, vejamos como:

Clique em Run e pronto
Você verá que duas novas janelas serão criadas:O shell onde são enviadas mensagens de erro, warnings ou pode até mesmo ser usado por você como saí­da de log da sua aplicação enquanto estiver rodando em modo hosted (em um tutorial não muito distante daqui pretendo mostrar como fazer isso ).

E finalmente a sua aplicação propriamente dita, a página que executa o código gerado por você ou no caso, o applicationCreator.

Veja aqui os arquivos gerados, prontos para importação no eclipse