Curso Java Starter

www.t2ti.com
1

Curso Java Starter

Apresentao

O Curso Java Starter foi projetado com o objetivo de ajudar quelas pessoas que tm uma base de lgica de programao e desejam entrar no mercado de trabalho sabendo Java, A estrutura do curso formada por mdulos em PDF e por mini-cursos em vdeo. O aluno deve baixar esse material e estud-lo. Deve realizar os exerccios propostos. Todas as dvidas devem ser enviadas para a lista de discusso que est disponvel para inscrio na pgina do Curso Java Starter no site www.t2ti.com. As dvidas sero respondidas pelos instrutores Albert Eije, Cludio de Barros e Miguel Kojiio, alm dos demais participantes da lista. Nosso objetivo que aps o estudo do Curso Java Starter o aluno no tenha dificuldades para acompanhar um curso avanado onde poder aprender a desenvolver aplicativos para Web, utilizando tecnologias como Servlets e JSP e frameworks como Struts e JSF, alm do desenvolvimento para dispositivos mveis. Albert Eije trabalha com informtica desde 1993. Durante esse perodo j trabalhou com vrias linguagens de programao: Clipper, PHP, Delphi, C, Java, etc. Atualmente mantm o site www.alberteije.com. Cludio de Barros Tecnlogo em Processamento de Dados. Miguel Kojiio bacharel em Sistemas de Informao, profissional certificado Java (SCJP 1.5). O curso Java Starter surgiu da idia dos trs amigos que trabalham juntos em uma instituio financeira de grande porte.

www.t2ti.com
2

Curso Java Starter

Mdulo

06
JAVADOC
A

JAVADOC E ARQUIVOS JAR

JAVADOC, um utilitrio para a gerao da documentao das classes criadas em Java. Esta documentao muito importante, pois atravs dela que conhecemos melhor as classes, verificando quais mtodos determinada classe possui e suas funcionalidades. Aprender utiliz-la essencial. documentao da API Java 1.6 pode ser acessada no link: http://java.sun.com/javase/6/docs/api/

www.t2ti.com
3

Curso Java Starter

Na tela seguinte, estamos acessando a API da classe java.util.Calendar:

O campo representado por 1 contm a lista de pacotes. O campo representado por 2 contm a lista de classes e interfaces do pacote selecionado em 1. O campo representado por 3 contm a descrio da classe selecionada em 2. Todo o detalhamento da classe vai estar no campo representado por 3. No cabealho da pgina encontramos links para: Overview Mostra todos os pacotes da API Java. Package Mostra a descrio de todas as classes do pacote atual. Neste

www.t2ti.com
4

Curso Java Starter

caso, java.util. Class classe que est sendo acessada. Use Lista dos pacotes que a classe atual utiliza. Tree Hierarquia de classes no pacote atual. Deprecated classes e mtodos que no so recomendados utilizar. Index ndice de mtodos e campos. Muito til quando no se sabe a classe. Help ajuda de como utilizar a documentao.

Identificado com a letra A temos o nome do pacote em B temos o nome da classe em C temos a estrutura hierrquica de classes em D temos as interfaces que so implementadas por esta classe e em E temos as classes que estendem esta classe.

www.t2ti.com
5

Curso Java Starter

Nesta parte da tela temos a lista de campos da classe. Na primeira coluna temos o tipo(int, String, etc.) e na segunda temos o nome e a descrio do campo.

www.t2ti.com
6

Curso Java Starter

Aqui temos a lista de construtores e a lista de mtodos. Na lista de construtores, a primeira coluna mostra o modificador de acesso(public, protected, etc) e na segunda coluna mostra o nome e a descrio do construtor. Na lista de mtodos, a primeira coluna mostra o tipo de retorno(void, boolean, etc.) e na segunda coluna mostra o nome e a descrio do mtodo.

Nesta tela temos os mtodos que so herdados da super-classe. Neste caso, a classe java.util.Calendar s herda os mtodos da classe java.lang.Object. Em cada nome de campo, construtor, mtodo mostrados nas telas que vimos, tem um link direcionando para a sua respectiva descrio detalhada. Na tela abaixo vemos o detalhamento do mtodo getInstance(TimeZone).

www.t2ti.com
7

Curso Java Starter

Podemos observar aqui o modificador de acesso (public), o tipo de retorno (Calendar) o nome do mtodo (getInstance) e o parmetro (TimeZone).

Gerando o JAVADOC
Quando instalamos o JDK, o gerador de javadoc tambm instalado. O mesmo fica na pasta %JAVA_HOME%/bin/javadoc.exe. Agora vamos criar um javadoc da classe a seguir:
package veiculo public class CarroPasseio { public void acelerar(){ //cdigo... } public void frear(int intensidade){ //cdigo

www.t2ti.com
8

Curso Java Starter

} public int getVelocidade(){ //cdigo... return 0; } }

No prompt de comando digitamos o seguinte comando: javadoc veiculo veiculo --> nome do pacote

Ser gerado javadoc para todas as classes que estiverem no pacote veiculo. Se tiver mais de um pacote, faa assim: javadoc pacote1 pacote2 pacote3 ... Sero gerados vrios arquivos. Abra o arquivo index.html e temos o javadoc do pacote veiculo:

www.t2ti.com
9

Curso Java Starter

Acessando a classe CarroPasseio temos o seguinte:

Geramos o javadoc, mas vemos que s aparecem o nome do construtor e dos

www.t2ti.com
10

Curso Java Starter

mtodos sem nenhuma descrio. Como implementar isto? Para inserirmos texto na documentao devemos adicionar ao cdigo como se fossem comentrios. Para abrir o texto utilize /** , para cada linha adicional utilize * e para fechar utilize */. Neste texto tambm pode-se definir o autor, parmetros, verso, retorno, etc. Para isto, utilizamos o carectere @ seguido do comando javadoc. Ex.: @author quem o autor da classe, mtodo, etc @param parmetro que o mtodo recebe @return o que o mtodo retorna @version verso da classe @throws quais as excees que podem ser geradas @since a partir de qual verso est disponvel Vamos documentar a nossa classe CarroPasseio:
package veiculo; /** * Classe que define o comportamento de um Carro de Passeio * @author Cludio * */ public class CarroPasseio { /** * Este mtodo acelera o carro * */ public void acelerar(){ //cdigo... } /** * Frea o carro de acordo com a intensidade informada * @param intensidade - intensidade da freada. */ public void frear(int intensidade){ //cdigo } /** * Retorna a velocidade atual do veculo * @return velocidade do veculo */ public int getVelocidade(){ //cdigo... return 0; }

Aps gerar o javadoc com o mesmo comando utilizado anteriormente, vemos o resultado nas duas figuras seguintes:

www.t2ti.com
11

Curso Java Starter

Perceba, acima, que agora temos as descries do mtodos.

www.t2ti.com
12

Curso Java Starter Arquivos JAR

Depois que implementamos uma aplicao, vamos ter que distribu-la. Mas j imaginou seu sistema com dezenas de pacotes e classes, e ter que mandar todos esses arquivos para o cliente? Fica meio complicado no ? Normalmente as aplicaes Java so distribudas em arquivos JAR, que um arquivo compactado no formato ZIP, mas com a extenso .jar. Vamos criar duas classes e criar um arquivo JAR contendo essas classes:
public class Professor { public static void main(String args[]){ System.out.println("Primeiro arquivo JAR criado!"); }

public class Aluno { public void aprender(){ //cdigo... } }

Depois de compilada as classes, temos elas como mostra a figura abaixo:

Agora vamos criar o arquivo JAR com as duas classes. Usamos o seguinte comando: jar cvf PrimeiroJar.jar Aluno.class Professor.class

www.t2ti.com
13

Curso Java Starter

onde: cvf --> opes do comando jar (c = criar novo arquivo, v = mostrar o andamento do arquivamento, f = especificar o nome do arquivo gerado) PrimeiroJar.jar --> nome do arquivo que ser gerado Aluno.class e Professor.class --> classes que sero arquivadas.

Ok, agora as duas classes foram arquivadas no arquivo PrimeiroJar.jar. Fica bem melhor distribuir a aplicao assim. Mas como vamos executar esta aplicao? Para isso vamos usar a opo -jar do comando java.

Opa, o que aconteceu? Nossa aplicao no funcionou. Por que? Quando a JVM executa um arquivo JAR, ela procura no arquivo chamado manifest.mf para saber qual a classe ela deve executar primeiro(a que contm o mtodo main). Esse um arquivo txt que alm de informar qual a classe main, tem a verso, bibliotecas, etc. Vamos criar este arquivo para a nossa aplicao:

www.t2ti.com
14

Curso Java Starter

A primeira linha do arquivo contm a verso do arquivo manifest. Na segunda linha definimos a classe que contm o mtodo main. A ltima linha do arquivo deve estar em branco. Salvamos esse texto com o nome manifest.mf. Agora temos os seguintes arquivos:

Vamos agora incluir o manifest em nosso arquivo JAR:

Perceba que agora inclumos a opo m onde temos que indicar o arquivo manifest e o nome do arquivo manifest.mf. Vamos executar nossa aplicao para ver o que acontece:

Beleza, agora sim, nossa aplicao funcionou e poderemos distribu-la em um

www.t2ti.com
15

Curso Java Starter

nico arquivo. Pode ser que em um arquivo JAR no tenha nenhuma classe que contenha o mtodo main. Este arquivo pode ser um framework, um driver JDBC, uma biblioteca, etc. Por exemplo, quando vamos utilizar o hibernate temos que adicionar ao CLASSPATH o arquivo JAR que contm as bibliotecas do mesmo. Agora voc deve tentar resolver a lista de exerccios abaixo. Qualquer dificuldade envie para a lista de discusso.

Exerccios
Aprenda com quem tambm est aprendendo, veja e compartilhe as suas respostas no nosso Frum: Exerccios Mdulo 06 Documentao Java Consulta e JavaDOC 01 Para ir se acostumando$ e aprender um pouco mais sobre as classes do Java, consulte no link http://java.sun.com/javase/6/docs/api/ as especificaes das classes java.util.GregorianCalendar e java.lang.Math. 02 Crie uma classe chamada ImportarTexto que esteja no pacote texto.util e que contenha os mtodos importarArquivo e filtrarDados. Gere a documentao dessa classe, inclundo os comandos javadoc @param e @return. 03 No prompt de comando digite javadoc -help e veja as opes deste utilitrio. 04 No prompt de comando digite jar e veja as opes deste utilitrio. 05 Gere um arquivo JAR que contenha a classe criada no exerccio 2. 06 Implemente na classe criada no exerccio 2 o mtodo main contendo a linha javax.swing.JOptionPane.showMessageDialog(null, "Teste de arquivo JAR");. Crie um arquivo manifest.mf definindo a classe ImportarTexto como a classe principal e gere o arquivo JAR.

www.t2ti.com
16

Curso Java Starter

07 Se estiver utilizando o windows, abra o windows explorer e navegue at a pasta onde est o arquivo JAR gerado no exerccio anterior. Clique duas vezes neste arquivo e veja o que acontece.

www.t2ti.com
17