LTP CAP03 VA08 JAVA API SPECIFICATION

O Java é
repleto de classes.

Mas como utilizar
todas essas classes?

Onde eu consigo ter informações
a respeito dos métodos,

dos atributos,
e como utilizá-los?

É aí que entra
o Java API Specification.

O Java API Specification
é nada mais nada menos

que um conjunto de informações
sobre todas as bibliotecas básicas do Java,

desde quais são
e como utilizá-las.

Supondo que eu precise usar
alguma função que eu desconheço.

Não necessariamente
eu preciso criá-la.

Eu posso verificar
no Java API Specification

se já existe alguma
classe e algum método

que torne aquele
trabalho mais fácil.

Para ter acesso a toda essa
documentação, é muito simples.

Basta acessar o link
do Java API Specification.

Nesse link, que é on-line, você
consegue ver todas as informações

de todas as classes, métodos,
atributos, explicações e exemplos.

Uma vez acessado esse link
através do seu navegador,

você consegue enxergar três grandes
áreas dentro dessa documentação.

Na área esquerda superior,
você consegue fazer consultas

através dos pacotes que existem
dentro da especificação Java.

Então, por exemplo: se eu quiser ver
alguma classe do pacote java.awt,

eu clico
em java.awt

e todas as interfaces e classes
desse pacote serão apresentadas.

Se eu quiser selecionar
uma dessas classes ou interfaces

e entender
um pouquinho mais,

basta eu clicar na classe
e logo no centro da minha tela

aparecem as informações
a respeito daquela classe.

Vou consultar um pouquinho agora
informações da classe String.

Então, eu seleciono aqui
no topo esquerdo "All Classes"

para que todas
as classes apareçam,

e vou procurar nessa minha
listagem a classe String.

Uma vez encontrada
a classe String, eu a seleciono,

e automaticamente,
no centro da tela,

aparecem todas as informações,
desde quais são as classes

nas quais a classe String
realiza herança,

e também quais são as interfaces
que são implementadas pela classe String.

Também tenho toda uma descrição
do que significa a classe String,

exemplos de uso da classe
String e demais definições.

Tem um outro campo que indica
desde qual versão do JDK

que aquela classe
está implementada.

A classe String, por exemplo,
é desde os primórdios do Java,

desde a versão 1.0.

Essa documentação
também me informa

quais classes estão
associadas à classe String

para que eu possa
fazer consultas.

Além disso, a documentação mostra
quais são os construtores daquela classe,

desde o construtor padrão até
os diversos construtores de classe,

e também quais são os diversos
métodos daquela classe.

Se eu quiser conhecer
um pouquinho mais de cada método,

apesar de eu ter
uma breve descrição aqui,

eu posso selecionar
o método

e é feita toda uma descrição
daquele método,

desde o que, de fato,
o método faz,

quais são os parâmetros de entrada,
os parâmetros de retorno,

até quais os tipos de erro
que aquele método pode gerar.

Mas você também pode olhar
toda essa documentação

dentro de ferramentas,
como o próprio Eclipse.

Vou fazer um exemplo bem simples
para sintetizar o que eu estou dizendo.

Vou criar aqui um atributo do tipo
String, que é a classe String,

vou passar
o mouse em cima.

É possível verificar que a mesma
documentação on-line que está lá

também é apresentada
aqui no Eclipse,

facilitando muito
a vida do programador.