[JAVADOC] JavaDoc para a Lista de Exercícios de Classes, Métodos e At…

…ributos

exercises/classes-metodos-atributos/exercicio-01/src/main/java/MyProgram.java

@@ -1,5 +1,10 @@
 import java.util.Scanner;
 
+/**
+ * Classe MyProgram que define a aplicação para classes e métodos.
+ * Lê duas notas do usuário, calcula a média e informa se o aluno foi aprovado ou reprovado.
+ * 
+ */
 public class MyProgram {
 
     public static void main (String[] args) {

exercises/classes-metodos-atributos/exercicio-02/src/main/java/MediaCefet.java

@@ -1,5 +1,12 @@
 import java.util.Scanner;
 
+/**
+ * Classe MediaCefet que define a aplicação para classes e métodos.
+ * Lê duas notas do usuário e informa se são válidas ou não.
+ * Após isso calcula a média e informa se o aluno foi aprovado, reprovado ou se está na prova final.
+ * Caso o aluno vá para a prova final, a classe lê a a nota da PF e informa se foi aprovado ou não.
+ * 
+ */
 public class MediaCefet {
 
     public static void main(String[] args) {

exercises/classes-metodos-atributos/exercicio-02/src/main/java/MyProgram.java

@@ -1,5 +1,11 @@
 import java.util.Scanner;
 
+/**
+ * Classe MyProgram que define a aplicação para classes e métodos.
+ * Lê duas notas do usuário, calcula a média e informa se o aluno foi aprovado, reprovado ou se
+ * está na prova final.
+ * 
+ */
 public class MyProgram {
 
     public static void main(String[] args) {

exercises/classes-metodos-atributos/exercicio-03/src/main/java/MaiorValor.java

@@ -1,5 +1,10 @@
 import java.util.Scanner;
 
+/**
+ * Classe MaiorValor que define a aplicação para classes e métodos.
+ * Lê três valores e define o maior entre eles.
+ * 
+ */
 public class MaiorValor {
 
     public static void main(String[] args) {

exercises/classes-metodos-atributos/exercicio-03/src/main/java/MyProgram.java

@@ -1,5 +1,10 @@
 import java.util.Scanner;
 
+/**
+ * Classe MyProgram que define a aplicação para classes e métodos.
+ * Lê três valores e define o maior entre eles.
+ * 
+ */
 public class MyProgram {
 
     public static void main(String[] args) {

exercises/classes-metodos-atributos/exercicio-04/src/main/java/Contagem.java

@@ -1,5 +1,10 @@
 import java.util.Scanner;
 
+/**
+ * Classe Contagem que define a aplicação para classes e métodos.
+ * Lê um valor que define uma contagem crescente(1-10) ou decrescente(10-1).
+ * 
+ */
 public class Contagem {
 
     public static void main(String[] args) {

exercises/classes-metodos-atributos/exercicio-04/src/main/java/MyProgram.java

@@ -1,4 +1,8 @@
-
+/**
+ * Classe MyProgram que define a aplicação para classes e métodos.
+ * Imprime uma contagem crescente(1-10) e uma decrescente(10-1).
+ * 
+ */
 public class MyProgram {
 
     public static void main(String[] args) {

exercises/classes-metodos-atributos/exercicio-05-06/src/main/java/JogoAdivinhe.java

@@ -1,6 +1,12 @@
 import java.util.Random;
 import java.util.Scanner;
 
+/**
+ * Classe JogoAdivinhe que define a aplicação para classes e métodos.
+ * Sorteia um valor aleatório entre 1 e 100 e pde para que o usuário entre com um valor.
+ * O usuário deve entrar com o valor até que acerte. Após isso será mostrado o número de tentativas.
+ * 
+ */
 public class JogoAdivinhe {
 
     @SuppressWarnings("unused")

exercises/classes-metodos-atributos/exercicio-05-06/src/main/java/MyProgram.java

@@ -1,6 +1,12 @@
 import java.util.Random;
 import java.util.Scanner;
 
+/**
+ * Classe MyProgram que define a aplicação para classes e métodos.
+ * Sorteia um valor aleatório entre 1 e 100 e pde para que o usuário entre com um valor.
+ * O usuário deve entrar com o valor até que acerte. Após isso será mostrado o número de tentativas.
+ * 
+ */
 public class MyProgram {
 
     public static void main(String[] args) {

exercises/classes-metodos-atributos/exercicio-07/src/main/java/MyProgram.java

@@ -1,5 +1,10 @@
 import java.util.Scanner;
 
+/**
+ * Classe MyProgram que define a aplicação para classes e métodos.
+ * Lê três valores dos coeficientes "a", "b" e "c" e mostra as raízes da equação. 
+ * 
+ */
 public class MyProgram {
 
     public static void main(String[] args) {

exercises/classes-metodos-atributos/exercicio-07/src/main/java/RaizBaskara.java

@@ -1,5 +1,11 @@
 import java.util.Scanner;
 
+/**
+ * Classe RaizBaskara que define a aplicação para classes e métodos.
+ * Lê três valores dos coeficientes "a", "b" e "c", calcula usando a Fórmula de Bháskara e mostra
+ * as raízes da equação. 
+ * 
+ */
 public class RaizBaskara {
 
     public static void main(String[] args) {

exercises/classes-metodos-atributos/exercicio-08/src/main/java/Automovel.java

@@ -1,3 +1,8 @@
+/**
+ * Classe que representa um automovel.
+ * Possui marca, modelo, ano de fabricação, ano do modelo, cor e quilometragem.
+ * 
+ */
 public class Automovel {
 
     private String marca;
@@ -7,12 +12,30 @@ public class Automovel {
     private String cor;
     private float km = 0;
 
+    /**
+     * Construtor da classe Automovel com marca, modelo e ano de fabricação.
+     * 
+     * @param marca Marca do automóvel
+     * @param modelo Modelo do automóvel
+     * @param ano_fabricacao Ano de fabricação do automóvel
+     */
     public Automovel(String marca, String modelo, int ano_fabricacao){
         this.marca = marca;
         this.modelo = modelo;
         this.ano_fabricacao = ano_fabricacao;
     }
 
+    /**
+     * Construtor da classe Automovel com marca, modelo, ano de fabricação, ano do modelo, cor e 
+     * quilometragem.
+     * 
+     * @param marca Marca do automóvel
+     * @param modelo Modelo do automóvel
+     * @param ano_fabricacao Ano de fabricação do automóvel
+     * @param ano_modelo Ano do modelo do automóvel
+     * @param cor Cor do automóvel
+     * @param km Quilometragem do automóvel
+     */
     public Automovel (String marca, String modelo, int ano_fabricacao, int ano_modelo, String cor, float km){
         this.marca = marca;
         this.modelo = modelo;
@@ -21,81 +44,178 @@ public Automovel (String marca, String modelo, int ano_fabricacao, int ano_model
         this.cor = cor;
         this.km = km;
     }
+
+    /**
+     * Retorna a marca do automóvel.
+     * 
+     * @return Marca do automóvel
+     */
     public String getMarca(){
         return marca;
     }
 
+    /**
+     * Define a marca do automóvel.
+     * 
+     * @param marca Marca do automóvel
+     */
     public void setMarca(String marca){
         this.marca = marca;
     }
 
+    /**
+     * Retorna o modelo do automóvel.
+     * 
+     * @return Modelo do automóvel
+     */
     public String getModelo(){
         return modelo;
     }
 
+    /**
+     * Define o modelo do automóvel.
+     * 
+     * @param modelo Modelo do automóvel
+     */
     public void setModelo(String modelo){
         this.modelo = modelo;
     }
 
+    /**
+     * Retorna a ano de fabricação do automóvel.
+     * 
+     * @return Ano de fabricação do automóvel
+     */
     public int getAno_fabricacao(){
         return ano_fabricacao;
     }
 
+    /**
+     * Define o ano de fabricação do automóvel.
+     * 
+     * @param ano_fabricaçao Ano de fabricação do automóvel
+     */
     public void setAno_fabricacao(int ano_fabricacao){
         this.ano_fabricacao = ano_fabricacao;
     }
 
+    /**
+     * Retorna o ano do modelo do automóvel.
+     * 
+     * @return Ano do modelo do automóvel
+     */
     public int getAno_modelo(){
         return ano_modelo;
     }
 
+    /**
+     * Define o ano do modelo do automóvel.
+     * 
+     * @param ano_modelo Ano do modelo do automóvel
+     */
     public void setAno_modelo(int ano_modelo){
         this.ano_modelo = ano_modelo;
     }
 
+    /**
+     * Retorna a cor do automóvel.
+     * 
+     * @return Cor do automóvel
+     */
     public String getCor(){
         return cor;
     }
 
+    /**
+     * Define a cor do automóvel.
+     * 
+     * @param cor Cor do automóvel
+     */
     public void setCor(String cor){
         this.cor = cor;
     }
 
+    /**
+     * Retorna a quilometragem do automóvel.
+     * 
+     * @return Quilometragem do automóvel
+     */
     public Float getKm(){
         return km;
     }
 
+    /**
+     * Define a quilometragem do automóvel.
+     * 
+     * @param km Quilometragem do automóvel
+     */
     public void setKm(Float km){
         this.km = km;
     }
 
 
-
+    /**
+     * Método para aumentar a quilometragem do automóvel.
+     * 
+     * @param km Valor a ser aumentado na quilometragem do automóvel
+     */
     public void AddKm(float km){
         this.km += km;
     }
 
+    /**
+     * Retorna a quilometragem total do automóvel.
+     * 
+     * @return Quilometragem total do automóvel
+     */
     public float KmTotal(){
         return this.km;
     }
 
+    /**
+     * Método que define a velocidade média do automóvel.
+     * 
+     * @param distperco Distância percorrida em quilômetros
+     * @param tempomin Período de tempo em que a distância foi percorrida em minutos
+     * @return Velocidade média do automóvel
+     */
     public float VelMedia(float distperco, float tempomin){
         float vm = distperco/tempomin;
         return vm;
     }
 
+    /**
+     * Método que simula a aceleração do automóvel.
+     * 
+     * @param marcacarro Marca do carro
+     */
     public void Acelerar(String marcacarro) {
         System.out.println("\nO carro " + marcacarro + " acelerou");
     }
 
+    /**
+     * Método que simula a frenagem do automóvel.
+     * 
+     * @param marcacarro Marca do carro
+     */
     public void Frear(String marcacarro) {
         System.out.println("\nO carro " + marcacarro + " freiou");
     }
 
+    /**
+     * Método que simula uma curva para a direita com o automóvel.
+     * 
+     * @param marcacarro Marca do carro
+     */
     public void Direita(String marcacarro) {
         System.out.println("\nO carro " + marcacarro + " se moveu para direita");
     }
 
+    /**
+     * Método que simula uma curva para a esquerda com o automóvel.
+     * 
+     * @param marcacarro Marca do carro
+     */
     public void Esquerda(String marcacarro) {
         System.out.println("\nO carro " + marcacarro + " se moveu para esquerda");
     }

exercises/classes-metodos-atributos/exercicio-08/src/main/java/MainAutomovel.java

@@ -1,5 +1,9 @@
 import java.util.Scanner;
 
+/**
+ * Classe MyProgram que define a aplicação para classes e métodos.
+ * 
+ */
 public class MainAutomovel {
 
     public static void main(String[] args) {

exercises/classes-metodos-atributos/exercicio-09/src/main/java/MainPessoa.java

@@ -1,5 +1,9 @@
 import java.time.LocalDate;
 
+/**
+ * Classe MainPessoa que define a aplicação para as classes e métodos existentes.
+ * 
+ */
 public class MainPessoa {
 
     public static void main(String[] args) {