Apostila Java

ABSTRAÇÃO DE DADOS
Depois é chamado o aplicativo javadoc, passando como parâmetro da linha de comando o nome do
código-fonte (ou dos códigos-fonte) a serem documentados.
Para ver a documentação recém criada, basta usar um browser para ler o arquivo que foi gerado
automaticamente dentro do diretório de documentação: ./docs/index.html
Note que a documentação realça partes da documentação, como o nome do autor, a versão da classe,
etc. Esse destaque pode ser definido durante a implementação do código, através de TAGS reservadas
pelo javadoc.
Algumas dessas tags, que devem ser usadas dentro de comentários delimitados por /** */, são
enumeradas abaixo:
@author
@version
@param
@return
@exception
o nome de quem implementou a clase (ou da empresa).
a versão da classe
o nome de um argumento usado por um método
o retorno de um método
o tipo de exceção ao qual um método está sujeito
O aplicativo javadoc tem várias opções que permitem ao programador personalizar a documentação de
seus sistemas. Para aprender mais sobre o javadoc, consulte a documentação que acompanha o
ambiente de desenvolvimento Java. (normalmente, essa documentação se encontra no diretório:
../jdk1.3.1/docs/tooldocs/javadoc/index.html, mas pode variar conforme o sistema
operacional e as opções utilizadas durante a instalação do jdk).
Documentação da API Java
Agora que você está familiarizado com o formato de documentação usado pelo Java, podemos investigar
a API Java (Application Programming Interface – interface de programação de aplicativo).
A API Java é um conjunto de classes disponíveis aos programadores, desenvolvidas pela SUN e que
visam agilizar a produção de softwares compatíveis com a linguagem Java.
Essas classes se encontram no diretório ../jdk1.3.1/jre/lib/rt.jar. (Os arquivos *.jar podem ser
"investigados" com aplicativos de compactação de arquivos, tais como o WinZIP)
A documentação dessas classes está publicada na documentação do ambiente de desenvolvimento Java
(normalmente no diretório ../jdk1.3.1/docs/api/index.html). Note que essa documentação foi criada
também pelo javadoc, e que tem o mesmo formato da documentação das classes
é vital que o aluno se habitue a consultar essa documentação durante o desenvolvimento de
programas em Java. Nesse primeiro momento, procure navegar pela documentação da API Java,
identificando o formato da informação, os termos,etc. Outra boa iniciativa é consultar também a
documentação do ambiente de desenvolvimento Java, que normalmente se encontra no diretório
../jdk1.3.1/docs/index.html. Conhecer amplamente a API Java é prerrogativa para todo bom
programador Java.
Exercícios
1. Implemente um classe que represente um aluno da FIC, contendo três membros:
a. O nome do aluno
b. O número de matrícula do aluno
c. Um objeto da classe Avaliacao
50