Solucionado (ver solução)
Solucionado
(ver solução)
4
respostas

Documentação

Alguém pode me dar um norte sobre como funciona documentação do Java? Pois, a implementação referência do Java hoje é o OpenJDK. No entanto, achei bastante confuso o site http://openjdk.java.net/ bem como o DevDocs para a versão 8. Por exemplo, preciso encontrar qual a referência usada para "java input string from keyboard", mas não encontro nada por lá. Penso que saber ler a documentação e encontrar as referências na documentação seja essencial para o aprendizado.

4 respostas

Vitor Lobo, você já tentou utilizar a documentação da própria oracle. Se ainda não é uma boa tentar já que independente da implementação todos os conceitos e regras para linguagem devem ser aplicados.

https://docs.oracle.com/javase/8/docs/api/

Leandro, boa noite! Cara, a melhor implementação da documentação que encontrei até agora foi esse http://devdocs.io/openjdk~8/ (lembrando que o OpenJDK é a implementação padrão da JVM hoje). Então, penso que é uma boa vir por este caminho.

Mas vou te exemplificar meu problema com a documentação (não sei se outras pessoas tem também). Por exemplo, estou fazendo um exercício que elaborei e preciso capturar os dígitos do teclado (método Input). Busquei por este método na documentação e não encontrei absolutamente nada a respeito.

O mais próximo disso que encontrei foi a classe java.util.Scanner (que faz o Input), e faz muito mais do que isso. No entanto, nunca encontraria esta classe se fosse somente pela documentação (tive q consultar o google) , stackoverflow coisa e tal.

Eu sinceramente não sei se é falta de costume, falta de conhecimento em manuzear a documentação, ou, se ela realmente é meio zoada.

solução!

A documentação no site da linguagem (Java Docs) vai te dar os detalhes sobre cada pacote, classe e métodos (como construir, quais parâmetros aceitam, tipo de retorno, quais tipos de exceções lançam, etc.) mas eles não te dizem como usar cada classe. Pra isso é melhor você ler os tutoriais no site da Oracle e os cursos aqui da Alura mesmo.

A sua busca "java input string from keyboard" na documentação dificilmente vai te dar algum resultado. Você deve aprender primeiro sobre como funciona a IO (input/output) no Java e as classes responsáveis por isso.

No site da Oracle há uma série de tutoriais sobre Java IO: Basic I/O E aí você vai entender que a sua busca "java input string from keyboard" seria algo como "Input Stream Reader OR Scanner" e que a parte do "from keyboard" está relacionada ao objeto System.in

Daniel, boa noite! Obrigado pelo esclarecimento. Vou me atentar a estas informações valiosas que deste.