From d04e23a37711073a59618a79b74a10b8ad1bf44f Mon Sep 17 00:00:00 2001 From: Miguel Rodrigues Date: Mon, 30 Jun 2025 18:23:59 -0300 Subject: [PATCH 1/3] =?UTF-8?q?[TESTE]=20Teste=20Unit=C3=A1rio=20para=20a?= =?UTF-8?q?=20Avalia=C3=A7=C3=A3o=20Ted-Lasso=20#58?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- avaliacoes/ted-lasso/pom.xml | 27 ++++---- .../main/java/{ => prova/tedlasso}/MyApp.java | 8 ++- .../tedlasso}/controller/matchController.java | 16 ++--- .../{ => prova/tedlasso}/model/Match.java | 4 +- .../{ => prova/tedlasso}/model/Player.java | 2 +- .../java/{ => prova/tedlasso}/model/Team.java | 12 ++-- .../ted-lasso/src/main/webapp/WEB-INF/web.xml | 2 +- .../ted-lasso/src/main/webapp/index.jsp | 2 +- .../java/prova/tedlasso/model/MatchTest.java | 62 +++++++++++++++++++ .../java/prova/tedlasso/model/PlayerTest.java | 52 ++++++++++++++++ .../java/prova/tedlasso/model/TeamTest.java | 62 +++++++++++++++++++ 11 files changed, 215 insertions(+), 34 deletions(-) rename avaliacoes/ted-lasso/src/main/java/{ => prova/tedlasso}/MyApp.java (88%) rename avaliacoes/ted-lasso/src/main/java/{ => prova/tedlasso}/controller/matchController.java (87%) rename avaliacoes/ted-lasso/src/main/java/{ => prova/tedlasso}/model/Match.java (98%) rename avaliacoes/ted-lasso/src/main/java/{ => prova/tedlasso}/model/Player.java (96%) rename avaliacoes/ted-lasso/src/main/java/{ => prova/tedlasso}/model/Team.java (76%) create mode 100644 avaliacoes/ted-lasso/src/test/java/prova/tedlasso/model/MatchTest.java create mode 100644 avaliacoes/ted-lasso/src/test/java/prova/tedlasso/model/PlayerTest.java create mode 100644 avaliacoes/ted-lasso/src/test/java/prova/tedlasso/model/TeamTest.java diff --git a/avaliacoes/ted-lasso/pom.xml b/avaliacoes/ted-lasso/pom.xml index 01f34d7..b2b7b77 100644 --- a/avaliacoes/ted-lasso/pom.xml +++ b/avaliacoes/ted-lasso/pom.xml @@ -20,20 +20,19 @@ - - junit - junit - 4.11 - test - - - - jakarta.servlet - jakarta.servlet-api - 5.0.0 - provided - - + + jakarta.servlet + jakarta.servlet-api + 6.0.0 + provided + + + org.junit.jupiter + junit-jupiter + 5.10.0 + test + + ted-lasso diff --git a/avaliacoes/ted-lasso/src/main/java/MyApp.java b/avaliacoes/ted-lasso/src/main/java/prova/tedlasso/MyApp.java similarity index 88% rename from avaliacoes/ted-lasso/src/main/java/MyApp.java rename to avaliacoes/ted-lasso/src/main/java/prova/tedlasso/MyApp.java index ce16889..2803261 100644 --- a/avaliacoes/ted-lasso/src/main/java/MyApp.java +++ b/avaliacoes/ted-lasso/src/main/java/prova/tedlasso/MyApp.java @@ -1,5 +1,7 @@ -import model.Player; -import model.Team; +package prova.tedlasso; + +import prova.tedlasso.model.Player; +import prova.tedlasso.model.Team; public class MyApp { @@ -30,4 +32,4 @@ public static void main(String[] args){ t1.getPlayers().add(p2); t1.getPlayers().add(p3); } -} +} \ No newline at end of file diff --git a/avaliacoes/ted-lasso/src/main/java/controller/matchController.java b/avaliacoes/ted-lasso/src/main/java/prova/tedlasso/controller/matchController.java similarity index 87% rename from avaliacoes/ted-lasso/src/main/java/controller/matchController.java rename to avaliacoes/ted-lasso/src/main/java/prova/tedlasso/controller/matchController.java index 51c56b5..a40825c 100644 --- a/avaliacoes/ted-lasso/src/main/java/controller/matchController.java +++ b/avaliacoes/ted-lasso/src/main/java/prova/tedlasso/controller/matchController.java @@ -1,13 +1,13 @@ -package controller; +package prova.tedlasso.controller; -import model.Match; -import model.Team; -import jakarta.servlet.annotation.WebServlet; +import java.io.IOException; + +import jakarta.servlet.annotation.WebServlet; import jakarta.servlet.http.HttpServlet; -import jakarta.servlet.http.HttpServletResponse; import jakarta.servlet.http.HttpServletRequest; - -import java.io.IOException; +import jakarta.servlet.http.HttpServletResponse; +import prova.tedlasso.model.Match; +import prova.tedlasso.model.Team; @WebServlet("/matchController") public class matchController extends HttpServlet { @@ -39,4 +39,4 @@ public class matchController extends HttpServlet { System.out.println(m1.getResult().getName()); System.out.println(m1.getResult(m1.getVisitor())); } -} \ No newline at end of file +} diff --git a/avaliacoes/ted-lasso/src/main/java/model/Match.java b/avaliacoes/ted-lasso/src/main/java/prova/tedlasso/model/Match.java similarity index 98% rename from avaliacoes/ted-lasso/src/main/java/model/Match.java rename to avaliacoes/ted-lasso/src/main/java/prova/tedlasso/model/Match.java index cd7ef00..8b7cea7 100644 --- a/avaliacoes/ted-lasso/src/main/java/model/Match.java +++ b/avaliacoes/ted-lasso/src/main/java/prova/tedlasso/model/Match.java @@ -1,4 +1,4 @@ -package model; +package prova.tedlasso.model; import java.util.Date; @@ -86,4 +86,4 @@ else if(homeScore > visitorScore){ } } } -} +} \ No newline at end of file diff --git a/avaliacoes/ted-lasso/src/main/java/model/Player.java b/avaliacoes/ted-lasso/src/main/java/prova/tedlasso/model/Player.java similarity index 96% rename from avaliacoes/ted-lasso/src/main/java/model/Player.java rename to avaliacoes/ted-lasso/src/main/java/prova/tedlasso/model/Player.java index 230181b..6f021c7 100644 --- a/avaliacoes/ted-lasso/src/main/java/model/Player.java +++ b/avaliacoes/ted-lasso/src/main/java/prova/tedlasso/model/Player.java @@ -1,4 +1,4 @@ -package model; +package prova.tedlasso.model; public class Player { diff --git a/avaliacoes/ted-lasso/src/main/java/model/Team.java b/avaliacoes/ted-lasso/src/main/java/prova/tedlasso/model/Team.java similarity index 76% rename from avaliacoes/ted-lasso/src/main/java/model/Team.java rename to avaliacoes/ted-lasso/src/main/java/prova/tedlasso/model/Team.java index 89147c5..a528f68 100644 --- a/avaliacoes/ted-lasso/src/main/java/model/Team.java +++ b/avaliacoes/ted-lasso/src/main/java/prova/tedlasso/model/Team.java @@ -1,4 +1,4 @@ -package model; +package prova.tedlasso.model; import java.util.ArrayList; import java.util.List; @@ -7,9 +7,13 @@ public class Team { private String name; private String colors; - private List players = new ArrayList() { - - }; + private List players = new ArrayList() {}; + + public Team() {} + + public Team(String name) { + this.name = name; + } public String getName() { return this.name; diff --git a/avaliacoes/ted-lasso/src/main/webapp/WEB-INF/web.xml b/avaliacoes/ted-lasso/src/main/webapp/WEB-INF/web.xml index 9f88c1f..cb7c1d2 100644 --- a/avaliacoes/ted-lasso/src/main/webapp/WEB-INF/web.xml +++ b/avaliacoes/ted-lasso/src/main/webapp/WEB-INF/web.xml @@ -4,4 +4,4 @@ Archetype Created Web Application - + \ No newline at end of file diff --git a/avaliacoes/ted-lasso/src/main/webapp/index.jsp b/avaliacoes/ted-lasso/src/main/webapp/index.jsp index 4e23e56..dd23dac 100644 --- a/avaliacoes/ted-lasso/src/main/webapp/index.jsp +++ b/avaliacoes/ted-lasso/src/main/webapp/index.jsp @@ -16,4 +16,4 @@ - + \ No newline at end of file diff --git a/avaliacoes/ted-lasso/src/test/java/prova/tedlasso/model/MatchTest.java b/avaliacoes/ted-lasso/src/test/java/prova/tedlasso/model/MatchTest.java new file mode 100644 index 0000000..8a70631 --- /dev/null +++ b/avaliacoes/ted-lasso/src/test/java/prova/tedlasso/model/MatchTest.java @@ -0,0 +1,62 @@ +package prova.tedlasso.model; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; +import org.junit.jupiter.api.Test; + +public class MatchTest { + + @Test + public void testSetAndGetHome() { + Team home = new Team("Time A"); + Match match = new Match(); + match.setHome(home); + assertEquals(home, match.getHome()); + } + + @Test + public void testSetAndGetVisitor() { + Team visitor = new Team("Time B"); + Match match = new Match(); + match.setVisitor(visitor); + assertEquals(visitor, match.getVisitor()); + } + + @Test + public void testGetResultWinner() { + Team home = new Team("Time A"); + Team visitor = new Team("Time B"); + Match match = new Match(); + match.setHome(home); + match.setVisitor(visitor); + match.setHomeScore(3); + match.setVisitorScore(1); + assertEquals(home, match.getResult()); + } + + @Test + public void testGetResultDraw() { + Team home = new Team("Time A"); + Team visitor = new Team("Time B"); + Match match = new Match(); + match.setHome(home); + match.setVisitor(visitor); + match.setHomeScore(2); + match.setVisitorScore(2); + assertNull(match.getResult()); + } + + @Test + public void testGetResultScoreForTeam() { + Team home = new Team("Time A"); + Team visitor = new Team("Time B"); + Match match = new Match(); + match.setHome(home); + match.setVisitor(visitor); + match.setHomeScore(1); + match.setVisitorScore(2); + + assertEquals(0, match.getResult(home)); + assertEquals(3, match.getResult(visitor)); + } +} diff --git a/avaliacoes/ted-lasso/src/test/java/prova/tedlasso/model/PlayerTest.java b/avaliacoes/ted-lasso/src/test/java/prova/tedlasso/model/PlayerTest.java new file mode 100644 index 0000000..027a59c --- /dev/null +++ b/avaliacoes/ted-lasso/src/test/java/prova/tedlasso/model/PlayerTest.java @@ -0,0 +1,52 @@ +package prova.tedlasso.model; + +import static org.junit.jupiter.api.Assertions.assertAll; +import static org.junit.jupiter.api.Assertions.assertEquals; +import org.junit.jupiter.api.Test; + +public class PlayerTest { + + @Test + public void testSetAndGetName() { + Player player = new Player(); + player.setName("Ted"); + assertEquals("Ted", player.getName()); + } + + @Test + public void testSetAndGetSurname() { + Player player = new Player(); + player.setSurname("Lasso"); + assertEquals("Lasso", player.getSurname()); + } + + @Test + public void testSetAndGetNumber() { + Player player = new Player(); + player.setNumber(10); + assertEquals(10, player.getNumber()); + } + + @Test + public void testSetAndGetPosition() { + Player player = new Player(); + player.setPosition("Coach"); + assertEquals("Coach", player.getPosition()); + } + + @Test + public void testFullPlayer() { + Player player = new Player(); + player.setName("Jamie"); + player.setSurname("Tartt"); + player.setNumber(9); + player.setPosition("Forward"); + + assertAll("player", + () -> assertEquals("Jamie", player.getName()), + () -> assertEquals("Tartt", player.getSurname()), + () -> assertEquals(9, player.getNumber()), + () -> assertEquals("Forward", player.getPosition()) + ); + } +} diff --git a/avaliacoes/ted-lasso/src/test/java/prova/tedlasso/model/TeamTest.java b/avaliacoes/ted-lasso/src/test/java/prova/tedlasso/model/TeamTest.java new file mode 100644 index 0000000..0f18449 --- /dev/null +++ b/avaliacoes/ted-lasso/src/test/java/prova/tedlasso/model/TeamTest.java @@ -0,0 +1,62 @@ +package prova.tedlasso.model; + +import java.util.ArrayList; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertTrue; +import org.junit.jupiter.api.Test; + +public class TeamTest { + + @Test + public void testDefaultConstructor() { + Team team = new Team(); + assertNull(team.getName()); + assertNull(team.getColors()); + assertNotNull(team.getPlayers()); + assertTrue(team.getPlayers().isEmpty()); + } + + @Test + public void testConstructorWithName() { + Team team = new Team("Richmond FC"); + assertEquals("Richmond FC", team.getName()); + } + + @Test + public void testSetAndGetName() { + Team team = new Team(); + team.setName("Ted's Team"); + assertEquals("Ted's Team", team.getName()); + } + + @Test + public void testSetAndGetColors() { + Team team = new Team(); + team.setColors("Red and White"); + assertEquals("Red and White", team.getColors()); + } + + @Test + public void testSetAndGetPlayers() { + Player p1 = new Player(); + p1.setName("Jamie"); + + Player p2 = new Player(); + p2.setName("Roy"); + + List players = new ArrayList<>(); + players.add(p1); + players.add(p2); + + Team team = new Team(); + team.setPlayers(players); + + assertEquals(2, team.getPlayers().size()); + assertEquals("Jamie", team.getPlayers().get(0).getName()); + assertEquals("Roy", team.getPlayers().get(1).getName()); + } +} From 8760ca9ec367351ddcda2e10343e457a9179eeb0 Mon Sep 17 00:00:00 2001 From: Miguel Rodrigues Date: Mon, 14 Jul 2025 16:51:28 -0300 Subject: [PATCH 2/3] =?UTF-8?q?[JAVADOC]=20JavaDoc=20para=20a=20Lista=20de?= =?UTF-8?q?=20Exerc=C3=ADcios=20de=20Heran=C3=A7a?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../src/main/java/Automov\303\251l.java" | 47 +++++++++++++++- .../src/main/java/Avi\303\243o.java" | 34 +++++++++++- .../exercicio-01/src/main/java/Barco.java" | 37 ++++++++++++- .../exercicio-01/src/main/java/Main.java" | 4 ++ .../src/main/java/Ve\303\255culo.java" | 55 +++++++++++++++++++ .../exercicio-02/src/main/java/BadFish.java" | 34 ++++++++++++ .../exercicio-02/src/main/java/Kate.java" | 52 +++++++++++++++++- .../exercicio-02/src/main/java/MadCat.java" | 34 ++++++++++++ .../exercicio-02/src/main/java/Main.java" | 4 ++ .../exercicio-02/src/main/java/MegaBob.java" | 34 ++++++++++++ .../src/main/java/Obst\303\241culos.java" | 38 ++++++++++++- .../src/main/java/Personagens.java" | 35 ++++++++++++ .../exercicio-02/src/main/java/Poder.java" | 37 +++++++++++++ 13 files changed, 437 insertions(+), 8 deletions(-) diff --git "a/exercises/heran\303\247a/exercicio-01/src/main/java/Automov\303\251l.java" "b/exercises/heran\303\247a/exercicio-01/src/main/java/Automov\303\251l.java" index fce6230..bcde9cc 100644 --- "a/exercises/heran\303\247a/exercicio-01/src/main/java/Automov\303\251l.java" +++ "b/exercises/heran\303\247a/exercicio-01/src/main/java/Automov\303\251l.java" @@ -1,3 +1,8 @@ +/** + * Classe que representa um automóvel, herda da classe Veículo. + * Possui renavam, placa e controle de marcha. + * + */ public class Automovél extends Veículo{ private String renavam; @@ -5,15 +10,27 @@ public class Automovél extends Veículo{ private boolean marcha; private int cont = 0; - + /** + * Construtor padrão da classe automóvel. + */ public Automovél() { } + /** + * Construtor da classe Automóvel com renavan e placa. + * + * @param renavam Número do renavam do automóvel + * @param placa Placa do automóvel + */ public Automovél(String renavam, String placa) { this.renavam = renavam; this.placa = placa; } + /** + * Método que representa a passagem de marcha do automóvel. + * Leva em consideração se ele está ligado e também se está em movimento. + */ public void passar_marcha(){ if ((isOn() == true) && ((isFrente() == true) || (isRe() == true))){ @@ -38,6 +55,10 @@ else if (isOn() == false){ } } + /** + * Método que representa a frenagem do automóvel. + * Leva em consideração se ele está ligado. + */ public void frear(){ if (isOn() == true) { @@ -57,16 +78,38 @@ public void frear(){ } } - + /** + * Retorna o número do renavam do automóvel. + * + * @return Número do renavam do automóvel + */ public String getRenavam() { return renavam; } + + /** + * Define o número do renavam do automóvel. + * + * @param renavam Novo número do renavam do veículo + */ public void setRenavam(String renavam) { this.renavam = renavam; } + + /** + * Retorna a placa do automóvel. + * + * @return Placa do automóvel + */ public String getPlaca() { return placa; } + + /** + * Define a placa do automóvel. + * + * @param placa Nova placa do automóvel + */ public void setPlaca(String placa) { this.placa = placa; } diff --git "a/exercises/heran\303\247a/exercicio-01/src/main/java/Avi\303\243o.java" "b/exercises/heran\303\247a/exercicio-01/src/main/java/Avi\303\243o.java" index c6f556c..d4d6218 100644 --- "a/exercises/heran\303\247a/exercicio-01/src/main/java/Avi\303\243o.java" +++ "b/exercises/heran\303\247a/exercicio-01/src/main/java/Avi\303\243o.java" @@ -1,17 +1,32 @@ +/** + * Classe que representa um avião, herda da classe Veículo. + * Possui registro aeronáutico e controle de decolagem. + * + */ public class Avião extends Veículo{ private String registro_aeronaútico; private boolean decolar; - + /** + * Construtor padrão da classe Avião. + */ public Avião() { } + /** + * Construtor da classe Avião com registro aeronáutico. + * + * @param registro_aeronaútico Número do registro aeronáutico + */ public Avião(String registro_aeronaútico) { this.registro_aeronaútico = registro_aeronaútico; } - + /** + * Método que representa a decolagem do avião. + * Leva em consideração se ele está ligado. + */ public void decolar(){ if (isOn() == true) { @@ -30,6 +45,10 @@ public void decolar(){ } + /** + * Método que representa a aterrissagem do avião. + * Leva em consideração se ele está ligado. + */ public void pousar(){ if (isOn() == true) { @@ -47,11 +66,20 @@ public void pousar(){ } - + /** + * Retorna o número do registro aeronáutico do avião. + * + * @return Número do registro aeronáutico do avião + */ public String getRegistro_aeronaútico() { return registro_aeronaútico; } + /** + * Define o número do registro aeronáutico do avião. + * + * @param registro_aeronaútico Novo número do registro aeronáutico do avião + */ public void setRegistro_aeronaútico(String registro_aeronaútico) { this.registro_aeronaútico = registro_aeronaútico; } diff --git "a/exercises/heran\303\247a/exercicio-01/src/main/java/Barco.java" "b/exercises/heran\303\247a/exercicio-01/src/main/java/Barco.java" index 26a9d5c..a765da3 100644 --- "a/exercises/heran\303\247a/exercicio-01/src/main/java/Barco.java" +++ "b/exercises/heran\303\247a/exercicio-01/src/main/java/Barco.java" @@ -1,16 +1,33 @@ +/** + * Classe que representa um barco, herda da classe Veículo. + * Possui registro da embarcação, controle de navegação e controle de ancoragem. + * + */ public class Barco extends Veículo{ private String registro_embarcação; private boolean navegar; private boolean ancorar = true; - + + /** + * Construtor padrão da classe Barco. + */ public Barco() { } + /** + * Construtor da classe Barco com número do registro da embarcação. + * + * @param registro_embarcação Número do registro da embarcação + */ public Barco(String registro_embarcação) { this.registro_embarcação = registro_embarcação; } + /** + * Método que representa a navegação do barco. + * Leva em consideração se ele ligado. + */ public void navegar(){ if (isOn() == true) { @@ -32,6 +49,10 @@ else if (ancorar == true){ } + /** + * Método que representa a ancoragem do barco. + * Leva em consideração se ele está ligado. + */ public void ancorar(){ if (isOn() == true) { @@ -50,6 +71,10 @@ public void ancorar(){ } } + /** + * Método que representa a desatracação do barco. + * Leva em consideração se ele está ligado. + */ public void desancorar(){ if (isOn() == true) { if (ancorar == true){ @@ -66,10 +91,20 @@ public void desancorar(){ } } + /** + * Retorna o número do registro da embarcação do barco. + * + * @return Número do registro da embarcação do barco + */ public String getRegistro_embarcação() { return registro_embarcação; } + /** + * Define o número do registro da embarcação do barco. + * + * @param registro_embarcação Novo número do registro da embarcação do barco + */ public void setRegistro_embarcação(String registro_embarcação) { this.registro_embarcação = registro_embarcação; } diff --git "a/exercises/heran\303\247a/exercicio-01/src/main/java/Main.java" "b/exercises/heran\303\247a/exercicio-01/src/main/java/Main.java" index 0645e23..dd859a3 100644 --- "a/exercises/heran\303\247a/exercicio-01/src/main/java/Main.java" +++ "b/exercises/heran\303\247a/exercicio-01/src/main/java/Main.java" @@ -1,5 +1,9 @@ import java.util.Scanner; +/** + * A classe Main define a aplicação para as classes e métodos criados. + * +*/ public class Main { public static void main(String[] args) { diff --git "a/exercises/heran\303\247a/exercicio-01/src/main/java/Ve\303\255culo.java" "b/exercises/heran\303\247a/exercicio-01/src/main/java/Ve\303\255culo.java" index 806453f..3fc8fdf 100644 --- "a/exercises/heran\303\247a/exercicio-01/src/main/java/Ve\303\255culo.java" +++ "b/exercises/heran\303\247a/exercicio-01/src/main/java/Ve\303\255culo.java" @@ -1,9 +1,18 @@ +/** + * Classe que representa um veículo. + * Possui controle de partida, controle de aceleração e controle de ré. + * + */ public class Veículo { private boolean on; private boolean frente; private boolean re; + /** + * Método que representa a partida de um veículo. + * Leva em consideração se ele está desligado. + */ public void ligar(){ if (on == false){ @@ -15,6 +24,10 @@ public void ligar(){ } } + /** + * Método que representa o desligamento de um veículo. + * Leva em consideração se ele está ligado. + */ public void desligar(){ if (on == true){ @@ -26,6 +39,10 @@ public void desligar(){ } } + /** + * Método que representa a aceleração de um veículo. + * Leva em consideração se ele está ligado. + */ public void mover_frente(){ if (on == true) { @@ -44,6 +61,10 @@ public void mover_frente(){ } + /** + * Método que representa a ré de um veículo. + * Leva em consideração se ele está ligado. + */ public void mover_re(){ if (on == true) { @@ -63,6 +84,10 @@ public void mover_re(){ } + /** + * Método que representa a paragem de um veículo. + * Leva em consideração se ele está ligado. + */ public void parar(){ if (on == true) { @@ -80,26 +105,56 @@ public void parar(){ } } + /** + * Retorna o estado do veículo: Ligado ou Desligado. + * + * @return Estado do veículo: Ligado(true) ou Desligado(false) + */ public boolean isOn() { return on; } + /** + * Define o estado do veículo: Ligado ou desligado. + * + * @param on Novo estado do veículo: Ligado(true) ou Desligado(false) + */ public void setOn(boolean on) { this.on = on; } + /** + * Retorna o estado de movimento do veículo: Indo para frente ou Não. + * + * @return Estado de movimento do veículo: Indo para frente(true) ou Não(false) + */ public boolean isFrente() { return frente; } + /** + * Define o estado de movimento do veículo: Indo para frente ou Não. + * + * @param frente Novo estado de movimento do veículo: Indo para frente(true) ou Não(false) + */ public void setFrente(boolean frente) { this.frente = frente; } + /** + * Retorna o estado de movimento do veículo: Dando ré ou Não. + * + * @return Estado de movimento do veículo: Dando ré(true) ou Não(false) + */ public boolean isRe() { return re; } + /** + * Define o estado de movimento do veículo: Dando ré ou Não. + * + * @param re Novo estado de movimento do veículo: Dando ré(true) ou Não(false) + */ public void setRe(boolean re) { this.re = re; } diff --git "a/exercises/heran\303\247a/exercicio-02/src/main/java/BadFish.java" "b/exercises/heran\303\247a/exercicio-02/src/main/java/BadFish.java" index 39239ed..95fcdf0 100644 --- "a/exercises/heran\303\247a/exercicio-02/src/main/java/BadFish.java" +++ "b/exercises/heran\303\247a/exercicio-02/src/main/java/BadFish.java" @@ -1,28 +1,62 @@ +/** + * Classe que representa o personagem BadFish, herda da classe Personagens. + * Possui nome e controle de dano recebido. + * + */ public class BadFish extends Personagens{ private String nome; private float dano_recebido; + /** + * Construtor padrão da classe BadFish. + */ public BadFish() { } + /** + * Construtor da classe BadFish com energia e nome. + * + * @param energia Valor que representa a energia possuída pelo personagem + * @param cod Nome do personagem + */ public BadFish(float energia, String cod) { super(energia); this.nome = cod; } + /** + * Retorna o nome do personagem. + * + * @return Nome do personagem + */ public String getNome() { return nome; } + /** + * Define o nome do personagem. + * + * @param cod Novo nome do personagem + */ public void setNome(String cod) { this.nome = cod; } + /** + * Retorna o valor do dano recebido pelo personagem. + * + * @return Valor do dano recebido + */ public float getDano_recebido() { return dano_recebido; } + /** + * Define o valor do dano recebido pelo personagem. + * + * @param dano_recebido Novo valor do dano recebido + */ public void setDano_recebido(float dano_recebido) { this.dano_recebido = dano_recebido; } diff --git "a/exercises/heran\303\247a/exercicio-02/src/main/java/Kate.java" "b/exercises/heran\303\247a/exercicio-02/src/main/java/Kate.java" index d795161..8f22a1c 100644 --- "a/exercises/heran\303\247a/exercicio-02/src/main/java/Kate.java" +++ "b/exercises/heran\303\247a/exercicio-02/src/main/java/Kate.java" @@ -1,50 +1,100 @@ import java.util.ArrayList; +/** + * Classe que representa a personagem Kate, herda da classe Personagens. + * Possui valor que representa a quantidade de vida e uma lista de poderes. + * + */ public class Kate extends Personagens{ private int qtd_vida; private ArrayList poder; private int poder_atual = 0; + /** + * Construtor padrão da classe Kate. + */ public Kate() { this.poder = new ArrayList(); } + /** + * Construtor da classe Kate com energia e quantidade de vida. + * + * @param energia Valor que representa a energia da personagem + * @param qtd_vida Valor que representa a quantidade de vida da personagem + */ public Kate(float energia, int qtd_vida) { super(energia); this.qtd_vida = qtd_vida; } + /** + * Método que representa a ação de pular da personagem. + */ public void pular() { System.out.println("\nA kate pulou!"); } + /** + * Método que representa a ação de pular da personagem. + */ public void andar() { System.out.println("\nA kate andou!"); } - + /** + * Método que representa a arternagem entre os poderes da personagem. + * + * @param poder_atual Poder a ser alterado + */ public void alterarpoder(int poder_atual) { this.poder_atual = poder_atual; } + /** + * Retorna o valor do dano causado por um poder da personagem. + * + * @param poder Habilidade especial usado pela personagem + * @return Valor do dano causado pelo poder da personagem + */ public float poder(ArrayList poder) { float dano = poder.get(poder_atual).getDano();; return dano; } + /** + * Retorna o valor da quantidade de vida da personagem. + * + * @return Valor da quantidade de vida da personagem + */ public int getQtd_vida() { return qtd_vida; } + /** + * Define a valor da quantidade de vida da personagem. + * + * @param qtd_vida Novo valor da quantidade de vida da personagem + */ public void setQtd_vida(int qtd_vida) { this.qtd_vida = qtd_vida; } + /** + * Retorna a lista de poderes da personagem. + * + * @return Lista de poderes da personagem + */ public ArrayList getPoder() { return poder; } + /** + * Define um novo poder para a lista de poderes da personagem. + * + * @param poder Novo poder para a lista de poderes da personagem + */ public void setPoder(ArrayList poder) { this.poder = poder; } diff --git "a/exercises/heran\303\247a/exercicio-02/src/main/java/MadCat.java" "b/exercises/heran\303\247a/exercicio-02/src/main/java/MadCat.java" index 8df2495..4af390b 100644 --- "a/exercises/heran\303\247a/exercicio-02/src/main/java/MadCat.java" +++ "b/exercises/heran\303\247a/exercicio-02/src/main/java/MadCat.java" @@ -1,28 +1,62 @@ +/** + * Classe que representa a personagem MadCat, herda da classe Personagens. + * Possui nome e controle de dano recebido. + * + */ public class MadCat extends Personagens{ private String nome; private float dano_recebido; + /** + * Construtor padrão da classe MadCat. + */ public MadCat() { } + /** + * Construtor da classe MadCat com energia e nome. + * + * @param energia Valor que representa a energia da personagem + * @param nome Nome da personagem + */ public MadCat(float energia, String nome) { super(energia); this.nome = nome; } + /** + * Retorna o nome da personagem. + * + * @return Nome da personagem. + */ public String getNome() { return nome; } + /** + * Define o nome da personagem. + * + * @param nome Novo nome da personagem + */ public void setNome(String nome) { this.nome = nome; } + /** + * Retorna o valor que representa a quantidade de dano recebido. + * + * @return Valor que representa a quantidade de dano recebido + */ public float getDano_recebido() { return dano_recebido; } + /** + * Define o valor que representa a quantidade de dano recebido. + * + * @param dano_recebido Novo valor que representa a quantidade de dano recebido + */ public void setDano_recebido(float dano_recebido) { this.dano_recebido = dano_recebido; } diff --git "a/exercises/heran\303\247a/exercicio-02/src/main/java/Main.java" "b/exercises/heran\303\247a/exercicio-02/src/main/java/Main.java" index e564077..69a2979 100644 --- "a/exercises/heran\303\247a/exercicio-02/src/main/java/Main.java" +++ "b/exercises/heran\303\247a/exercicio-02/src/main/java/Main.java" @@ -2,6 +2,10 @@ import java.util.ArrayList; +/** + * Classe main que define a aplicação para as classes e métodos criados. + * + */ public class Main { public static void main (String args[]){ diff --git "a/exercises/heran\303\247a/exercicio-02/src/main/java/MegaBob.java" "b/exercises/heran\303\247a/exercicio-02/src/main/java/MegaBob.java" index 0c4da91..e4e1896 100644 --- "a/exercises/heran\303\247a/exercicio-02/src/main/java/MegaBob.java" +++ "b/exercises/heran\303\247a/exercicio-02/src/main/java/MegaBob.java" @@ -1,28 +1,62 @@ +/** + * Classe que representa o personagem MegaBob, herda da classe Personagens. + * Possui nome e controle de dano recebido. + * + */ public class MegaBob extends Personagens{ private String nome; private float dano_recebido; + /** + * Construtor padrão da classe MegaBob. + */ public MegaBob() { } + /** + * Construtor da classe MegaBob com energia e nome. + * + * @param energia Valor que representa a energia do personagem + * @param nome Nome do personagem + */ public MegaBob(float energia, String nome) { super(energia); this.nome = nome; } + /** + * Retorna o nome do personagem. + * + * @return Nome do personagem. + */ public String getNome() { return nome; } + /** + * Define o nome do personagem. + * + * @param nome Novo nome do personagem + */ public void setNome(String cod) { this.nome = cod; } + /** + * Retorna o valor que representa a quantidade de dano recebido. + * + * @return Valor que representa a quantidade de dano recebido + */ public float getDano_recebido() { return dano_recebido; } + /** + * Define o valor que representa a quantidade de dano recebido. + * + * @param dano_recebido Novo valor que representa a quantidade de dano recebido + */ public void setDano_recebido(float dano_recebido) { this.dano_recebido = dano_recebido; } diff --git "a/exercises/heran\303\247a/exercicio-02/src/main/java/Obst\303\241culos.java" "b/exercises/heran\303\247a/exercicio-02/src/main/java/Obst\303\241culos.java" index 82e8c55..8a5b2e8 100644 --- "a/exercises/heran\303\247a/exercicio-02/src/main/java/Obst\303\241culos.java" +++ "b/exercises/heran\303\247a/exercicio-02/src/main/java/Obst\303\241culos.java" @@ -1,28 +1,64 @@ +/** + * Classe que representa os obstáculos, herda de Personagens. + * Possui nome e material. + * + */ public class Obstáculos extends Personagens{ private String nome; private String material; + /** + * Construtor padrão da classe Obstáculos. + */ public Obstáculos() { } + /** + * Construtor da classe Obstáculos com nome, energia e material. + * + * @param nome Nome do obstáculo + * @param energia Valor que representa a energia do obstáculos + * @param material Material que compõe o obstáculo + */ public Obstáculos(String nome, float energia, String material) { super(energia); this.nome = nome; this.material = material; } - + + /** + * Retorna o material que compõe o obstáculo. + * + * @return Material que compõe o obstáculo + */ public String getMaterial() { return material; } + + /** + * Define o material que compõe o obstáculo. + * + * @param material Novo material que compõe o obstáculo + */ public void setMaterial(String material) { this.material = material; } + /** + * Retorna o nome do obstáculo. + * + * @return Nome do obstáculo + */ public String getNome() { return nome; } + /** + * Define o nome do obstáculo. + * + * @param nome Novo nome do obstáculo. + */ public void setNome(String nome) { this.nome = nome; } diff --git "a/exercises/heran\303\247a/exercicio-02/src/main/java/Personagens.java" "b/exercises/heran\303\247a/exercicio-02/src/main/java/Personagens.java" index 296b9e3..716aa5e 100644 --- "a/exercises/heran\303\247a/exercicio-02/src/main/java/Personagens.java" +++ "b/exercises/heran\303\247a/exercicio-02/src/main/java/Personagens.java" @@ -1,16 +1,41 @@ +/** + * Classe que representa os personagens. + * Possui energia. + * + */ import java.util.ArrayList; public class Personagens { private float energia; + /** + * Construtor padrão da classe Personagens. + */ public Personagens() { } + /** + * Construtor da classe Personagens com energia. + * + * @param energia Valor que representa a energia do personagem. + */ public Personagens(float energia) { this.energia = energia; } + /** + * Método que define o status de um personagem após um dano causado por algum poder. + * Compara o dano recebido com os danos dos poderes e exibe qual deles causou aquele dano, se + * algum for correspondente. + * Subtrai o dano causado da energia do personagem e mostra se ele resistiu ou morreu. + * + * @param poder Lista de poderes disponíveis. + * @param nome Nome do personagem que está recebendo o dano. + * @param dano_recebido Valor do dano que foi causado. + * @param energiainimigo Energia atual do personagem antes de receber o dano. + * @return Energia do personagem após receber o dano. + */ public float status(ArrayList poder, String nome, float dano_recebido, float energiainimigo){ if (dano_recebido != 0) { @@ -45,10 +70,20 @@ else if (dano_recebido == poder.get(1).getDano()){ } + /** + * Retorna o valor que representa a energia do personagem. + * + * @return Valor que representa a energia do personagem + */ public float getEnergia() { return energia; } + /** + * Define o valor que representa a energia do personagem. + * + * @param energia Novo valor que representa a energia do personagem + */ public void setEnergia(float energia) { this.energia = energia; } diff --git "a/exercises/heran\303\247a/exercicio-02/src/main/java/Poder.java" "b/exercises/heran\303\247a/exercicio-02/src/main/java/Poder.java" index b34a9aa..43fd35e 100644 --- "a/exercises/heran\303\247a/exercicio-02/src/main/java/Poder.java" +++ "b/exercises/heran\303\247a/exercicio-02/src/main/java/Poder.java" @@ -1,13 +1,27 @@ +/** + * Classe que representa o poder do personagem. + * Possui nome e valor do dano. + * + */ public class Poder { private String poder; private float dano; public static int qtd_instancia = 0; + /** + * Construtor padrão da classe Poder. + */ public Poder() { qtd_instancia++; } + /** + * Construtor da classe Poder com nome e dano. + * + * @param poder Nome do poder + * @param dano Valor do dano + */ public Poder(String poder, float dano) { if (qtd_instancia >= 4) { System.out.println("Erro de instância, a Kate só pode ter até 4 poderes! apartir do 4 poder, ele nao será instanciado! por favor remova"); @@ -19,15 +33,38 @@ public Poder(String poder, float dano) { } } + /** + * Retorna o nome do poder. + * + * @return Nome do poder + */ public String getPoder() { return poder; } + + /** + * Define o nome do poder. + * + * @param poder Novo nome do poder + */ public void setPoder(String poder) { this.poder = poder; } + + /** + * Retorna o valor do dano do poder. + * + * @return Valor do dano do poder + */ public float getDano() { return dano; } + + /** + * Define o valor do dano do poder. + * + * @param dano Novo valor do dano do poder + */ public void setDano(float dano) { this.dano = dano; } From ab3871315499e7b3db056820b8cf62b8a0365ee6 Mon Sep 17 00:00:00 2001 From: Miguel Rodrigues Date: Tue, 15 Jul 2025 17:20:17 -0300 Subject: [PATCH 3/3] =?UTF-8?q?[JAVADOC]=20JavaDoc=20para=20a=20Lista=20de?= =?UTF-8?q?=20Exerc=C3=ADcios=20de=20Classes,=20M=C3=A9todos=20e=20Atribut?= =?UTF-8?q?os?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../exercicio-01/src/main/java/MyProgram.java | 5 + .../src/main/java/MediaCefet.java | 7 + .../exercicio-02/src/main/java/MyProgram.java | 6 + .../src/main/java/MaiorValor.java | 5 + .../exercicio-03/src/main/java/MyProgram.java | 5 + .../exercicio-04/src/main/java/Contagem.java | 5 + .../exercicio-04/src/main/java/MyProgram.java | 6 +- .../src/main/java/JogoAdivinhe.java | 6 + .../src/main/java/MyProgram.java | 6 + .../exercicio-07/src/main/java/MyProgram.java | 5 + .../src/main/java/RaizBaskara.java | 6 + .../exercicio-08/src/main/java/Automovel.java | 122 ++++++++++++++++- .../src/main/java/MainAutomovel.java | 4 + .../src/main/java/MainPessoa.java | 4 + .../exercicio-09/src/main/java/Pessoa.java | 50 +++++++ .../src/main/java/MainRetangulo.java | 4 + .../exercicio-10/src/main/java/Retangulo.java | 46 ++++++- .../src/main/java/ContaCorrente.java | 85 +++++++++++- .../src/main/java/MainContaCorrente.java | 4 + .../src/main/java/Cryptographye.java | 26 ++++ .../src/main/java/MainCryptographye.java | 4 + .../exercicio-13/src/main/java/MyProgram.java | 4 + .../exercicio-13/src/main/java/Quarto.java | 108 ++++++++++++++- .../exercicio-13/src/main/java/Source.java | 4 + .../src/main/java/Ventilador.java | 36 ++++- .../exercicio-14/src/main/java/Celula.java | 10 ++ .../src/main/java/MainCelula.java | 4 + .../src/main/java/Arrays.java | 46 ++++++- .../src/main/java/MainArrays.java | 4 + .../src/main/java/Fornecedor.java | 57 +++++++- .../src/main/java/MainCarrinho.java | 4 + .../src/main/java/Mercadoria.java | 99 +++++++++++++- .../src/main/java/MainNotaFiscal.java | 4 + .../src/main/java/NotaFiscal.java | 128 +++++++++++++++++- 34 files changed, 904 insertions(+), 15 deletions(-) diff --git a/exercises/classes-metodos-atributos/exercicio-01/src/main/java/MyProgram.java b/exercises/classes-metodos-atributos/exercicio-01/src/main/java/MyProgram.java index 0627e2d..f59e707 100644 --- a/exercises/classes-metodos-atributos/exercicio-01/src/main/java/MyProgram.java +++ b/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) { diff --git a/exercises/classes-metodos-atributos/exercicio-02/src/main/java/MediaCefet.java b/exercises/classes-metodos-atributos/exercicio-02/src/main/java/MediaCefet.java index b00b37e..8ddd13a 100644 --- a/exercises/classes-metodos-atributos/exercicio-02/src/main/java/MediaCefet.java +++ b/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) { diff --git a/exercises/classes-metodos-atributos/exercicio-02/src/main/java/MyProgram.java b/exercises/classes-metodos-atributos/exercicio-02/src/main/java/MyProgram.java index d31e411..706acba 100644 --- a/exercises/classes-metodos-atributos/exercicio-02/src/main/java/MyProgram.java +++ b/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) { diff --git a/exercises/classes-metodos-atributos/exercicio-03/src/main/java/MaiorValor.java b/exercises/classes-metodos-atributos/exercicio-03/src/main/java/MaiorValor.java index f3a805d..bdb73aa 100644 --- a/exercises/classes-metodos-atributos/exercicio-03/src/main/java/MaiorValor.java +++ b/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) { diff --git a/exercises/classes-metodos-atributos/exercicio-03/src/main/java/MyProgram.java b/exercises/classes-metodos-atributos/exercicio-03/src/main/java/MyProgram.java index 5882caa..176528e 100644 --- a/exercises/classes-metodos-atributos/exercicio-03/src/main/java/MyProgram.java +++ b/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) { diff --git a/exercises/classes-metodos-atributos/exercicio-04/src/main/java/Contagem.java b/exercises/classes-metodos-atributos/exercicio-04/src/main/java/Contagem.java index 37d5f67..cfb63b4 100644 --- a/exercises/classes-metodos-atributos/exercicio-04/src/main/java/Contagem.java +++ b/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) { diff --git a/exercises/classes-metodos-atributos/exercicio-04/src/main/java/MyProgram.java b/exercises/classes-metodos-atributos/exercicio-04/src/main/java/MyProgram.java index 2ff0c2e..88199dd 100644 --- a/exercises/classes-metodos-atributos/exercicio-04/src/main/java/MyProgram.java +++ b/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) { diff --git a/exercises/classes-metodos-atributos/exercicio-05-06/src/main/java/JogoAdivinhe.java b/exercises/classes-metodos-atributos/exercicio-05-06/src/main/java/JogoAdivinhe.java index a34e5b2..fa1d7e1 100644 --- a/exercises/classes-metodos-atributos/exercicio-05-06/src/main/java/JogoAdivinhe.java +++ b/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") diff --git a/exercises/classes-metodos-atributos/exercicio-05-06/src/main/java/MyProgram.java b/exercises/classes-metodos-atributos/exercicio-05-06/src/main/java/MyProgram.java index 002a7ad..e782c0e 100644 --- a/exercises/classes-metodos-atributos/exercicio-05-06/src/main/java/MyProgram.java +++ b/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) { diff --git a/exercises/classes-metodos-atributos/exercicio-07/src/main/java/MyProgram.java b/exercises/classes-metodos-atributos/exercicio-07/src/main/java/MyProgram.java index 322abe3..0e9163a 100644 --- a/exercises/classes-metodos-atributos/exercicio-07/src/main/java/MyProgram.java +++ b/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) { diff --git a/exercises/classes-metodos-atributos/exercicio-07/src/main/java/RaizBaskara.java b/exercises/classes-metodos-atributos/exercicio-07/src/main/java/RaizBaskara.java index ced728e..5e4154b 100644 --- a/exercises/classes-metodos-atributos/exercicio-07/src/main/java/RaizBaskara.java +++ b/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) { diff --git a/exercises/classes-metodos-atributos/exercicio-08/src/main/java/Automovel.java b/exercises/classes-metodos-atributos/exercicio-08/src/main/java/Automovel.java index f4fc033..a927654 100644 --- a/exercises/classes-metodos-atributos/exercicio-08/src/main/java/Automovel.java +++ b/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"); } diff --git a/exercises/classes-metodos-atributos/exercicio-08/src/main/java/MainAutomovel.java b/exercises/classes-metodos-atributos/exercicio-08/src/main/java/MainAutomovel.java index 2b1b327..5c9e920 100644 --- a/exercises/classes-metodos-atributos/exercicio-08/src/main/java/MainAutomovel.java +++ b/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) { diff --git a/exercises/classes-metodos-atributos/exercicio-09/src/main/java/MainPessoa.java b/exercises/classes-metodos-atributos/exercicio-09/src/main/java/MainPessoa.java index c9f421c..b49aa6f 100644 --- a/exercises/classes-metodos-atributos/exercicio-09/src/main/java/MainPessoa.java +++ b/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) { diff --git a/exercises/classes-metodos-atributos/exercicio-09/src/main/java/Pessoa.java b/exercises/classes-metodos-atributos/exercicio-09/src/main/java/Pessoa.java index 569b69e..b3b3cc4 100644 --- a/exercises/classes-metodos-atributos/exercicio-09/src/main/java/Pessoa.java +++ b/exercises/classes-metodos-atributos/exercicio-09/src/main/java/Pessoa.java @@ -1,21 +1,41 @@ import java.time.LocalDate; import java.time.Period; +/** + * Classe que representa uma pessoa. + * + */ public class Pessoa { private String nome, apelido; private LocalDate datanascimento; + /** + * Construtor padrão da classe Pessoa com data de nascimento. + * + * @param datanascimento Data de nascimento + */ public Pessoa(LocalDate datanascimento) { this.datanascimento = datanascimento; } + /** + * Construtor padrão da classe Pessoa com nome, apelido e data de nascimento. + * @param nome Nome + * @param apelido Apelido + * @param datanascimento Data de nascimento + */ public Pessoa (String nome, String apelido, LocalDate datanascimento){ this.nome = nome; this.apelido = apelido; this.datanascimento = datanascimento; } + /** + * Retorna a idade da pessoa com base na data atual. + * + * @return Idade da pessoa + */ public int getIdade(){ LocalDate dataAtual = LocalDate.now(); Period periodo = Period.between(datanascimento, dataAtual); @@ -23,26 +43,56 @@ public int getIdade(){ return periodo.getYears(); } + /** + * Define o nome da pessoa. + * + * @param nome Nome da pessoa + */ public void setNome(String nome){ this.nome = nome; } + /** + * Retorna o nome da pessoa. + * + * @return Nome da pessoa + */ public String getNome() { return nome; } + /** + * Define o apelido da pessoa. + * + * @param apelido Apelido da pessoa + */ public void setApelido(String apelido){ this.apelido = apelido; } + /** + * Retorna o apelido da pessoa. + * + * @return Apelido da pessoa + */ public String getApelido() { return apelido; } + /** + * Retorna a data de nascimento da pessoa. + * + * @return Data de nascimento da pessoa + */ public LocalDate getDatanascimento() { return datanascimento; } + /** + * Define a data de nascimento da pessoa. + * + * @param datanascimento Data de nascimento da pessoa + */ public void setDatanascimento(LocalDate datanascimento) { this.datanascimento = datanascimento; } diff --git a/exercises/classes-metodos-atributos/exercicio-10/src/main/java/MainRetangulo.java b/exercises/classes-metodos-atributos/exercicio-10/src/main/java/MainRetangulo.java index 8679412..b59bce8 100644 --- a/exercises/classes-metodos-atributos/exercicio-10/src/main/java/MainRetangulo.java +++ b/exercises/classes-metodos-atributos/exercicio-10/src/main/java/MainRetangulo.java @@ -1,3 +1,7 @@ +/** + * Classe MainRetangulo que define a aplicação das classes e métodos existentes. + * + */ public class MainRetangulo { public static void main(String[] args) { diff --git a/exercises/classes-metodos-atributos/exercicio-10/src/main/java/Retangulo.java b/exercises/classes-metodos-atributos/exercicio-10/src/main/java/Retangulo.java index 583e77c..588f493 100644 --- a/exercises/classes-metodos-atributos/exercicio-10/src/main/java/Retangulo.java +++ b/exercises/classes-metodos-atributos/exercicio-10/src/main/java/Retangulo.java @@ -1,36 +1,80 @@ +/** + * Classe que representa um retangulo. + * Possui valor da base e altura. + * + */ public class Retangulo { private float base; private float altura; + /** + * Construtor da classe Retangulo com base e altura. + * + * @param base Valor da base + * @param altura Valor da altura + */ public Retangulo (float base, float altura){ this.base = base; this.altura = altura; } + /** + * Método que calcula o valor do perímetro do retângulo. + * + * @param base Valor da base + * @param altura Valor da altura + * @return Valor do peímetro + */ public float perimetro(float base, float altura){ float p = 2 * (base + altura); return p; } + /** + * Método que calcula o valor da área do retângulo. + * + * @param base Valor da base + * @param altura Valor da altura + * @return Valor da área + */ public float area(float base, float altura){ float a = base * altura; return a; } - + /** + * Define o valor da base do retângulo. + * + * @param base Valor da base do retângulo. + */ public void setRetangulo(float base){ this.base = base; } + /** + * Retorna o valor da base do retângulo. + * + * @return Valor da base do retângulo. + */ public float getBase(){ return base; } + /** + * Define o valor da altura do retângulo. + * + * @param altura Valor da altura do retângulo. + */ public void SetRetangulo(float altura){ this.altura = altura; } + /** + * Retorna o valor da altura do retângulo. + * + * @return Valor da altura do retângulo. + */ public float getAltura(){ return altura; } diff --git a/exercises/classes-metodos-atributos/exercicio-11/src/main/java/ContaCorrente.java b/exercises/classes-metodos-atributos/exercicio-11/src/main/java/ContaCorrente.java index 1deee20..98b12d2 100644 --- a/exercises/classes-metodos-atributos/exercicio-11/src/main/java/ContaCorrente.java +++ b/exercises/classes-metodos-atributos/exercicio-11/src/main/java/ContaCorrente.java @@ -1,3 +1,8 @@ +/** + * Classe que representa uma conta corrente. + * Possui saldo, numero, cliente, limite, situacao. + * + */ public class ContaCorrente { private float saldo; @@ -6,6 +11,15 @@ public class ContaCorrente { private float limite; private boolean situacao; + /** + * Construtor da classe ContaCorrente com saldo, número, cliente, limite e situação. + * + * @param saldo Saldo da conta + * @param numero Número da conta + * @param cliente Nome do cliente + * @param limite Valor do limite + * @param situacao Tipo de situação da conta (ativa ou inativa) + */ public ContaCorrente(Float saldo, int numero, String cliente, float limite, boolean situacao){ this.saldo = saldo; this.numero = numero; @@ -14,6 +28,11 @@ public ContaCorrente(Float saldo, int numero, String cliente, float limite, bool this.situacao = situacao; } + /** + * Método para fazer o levantamento da conta para realizar um saque. + * + * @param saque Valor do saque desejado + */ public void levantar(float saque){ if (this.situacao == true) { if (saque <= this.saldo){ @@ -36,6 +55,11 @@ else if(saque <= limite) { } } + /** + * Método que simula um depósito na conta + * + * @param deposito Valor do depósito + */ public void depositar(float deposito){ if (this.situacao == true) { this.saldo = this.saldo + deposito; @@ -46,6 +70,16 @@ public void depositar(float deposito){ } } + /** + * Método que simula uma transferência de valores entre contas + * + * @param valor Valor a ser transferido + * @param saldo Saldo atual da conta do remetente + * @param nome Nome do destinatário + * @param numero Número da conta do destinatário + * @param situacao Situação da conta do destinatário (ativa ou inativa) + * @return + */ public float transferir (float valor, float saldo, String nome, int numero, boolean situacao){ if ((this.situacao == true) && (situacao == true)) { if (valor <= this.saldo){ @@ -73,43 +107,92 @@ else if(valor <= limite) { } } - + /** + * Define um saldo para a conta corrente + * + * @param saldo Saldo da conta + */ public void setSaldo(float saldo){ this.saldo = saldo; } + /** + * Retorna o valor do saldo da conta corrente + * + * @return Valor do saldo da conta + */ public float getSaldo(){ return saldo; } + /** + * Define um numero para a conta corrente + * + * @param numero Número da conta + */ public void setNumero(int numero){ this.numero = numero; } + /** + * Retorna o numero da conta corrente + * + * @return Número da conta + */ public int getNumero(){ return numero; } + /** + * Define um nome para o cliente da conta corrente + * + * @param cliente Nome do cliente da conta + */ public void setCliente(String cliente){ this.cliente = cliente; } + /** + * Retorna o nome do cliente da conta corrente + * + * @return Nome do cliente da conta + */ public String getCliente(){ return cliente; } + /** + * Define um limite para a conta corrente + * + * @param limite Limite da conta + */ public void setLimite(float limite){ this.limite= limite; } + /** + * Retorna um limite para a conta corrente + * + * @return Limite da conta + */ public float getLimite(){ return limite; } + /** + * Define a situação da conta corrente + * + * @param situacao + */ public void setSituacao(boolean situacao){ this.situacao = situacao; } + /** + * Retorna a situação da conta corrente + * + * @return Situação da conta corrente + */ public boolean getSituacao(){ return situacao; } diff --git a/exercises/classes-metodos-atributos/exercicio-11/src/main/java/MainContaCorrente.java b/exercises/classes-metodos-atributos/exercicio-11/src/main/java/MainContaCorrente.java index 2ef9ec1..1162ffa 100644 --- a/exercises/classes-metodos-atributos/exercicio-11/src/main/java/MainContaCorrente.java +++ b/exercises/classes-metodos-atributos/exercicio-11/src/main/java/MainContaCorrente.java @@ -1,3 +1,7 @@ +/** + * Classe MainContaCorrente que define a aplicação das classes e métodos existentes. + * + */ public class MainContaCorrente { public static void main(String[] args) { diff --git a/exercises/classes-metodos-atributos/exercicio-12/src/main/java/Cryptographye.java b/exercises/classes-metodos-atributos/exercicio-12/src/main/java/Cryptographye.java index a3fbaf3..25e9b9d 100644 --- a/exercises/classes-metodos-atributos/exercicio-12/src/main/java/Cryptographye.java +++ b/exercises/classes-metodos-atributos/exercicio-12/src/main/java/Cryptographye.java @@ -1,12 +1,25 @@ +/** + * Classe que representa uma criptografia. + * Possui frase. + * + */ public class Cryptographye { private String frase; private char encrypt[] = new char[100]; + /** + * Construtor da classe Cryptographye com frase. + * + * @param frase Frase para criptografar + */ public Cryptographye (String frase){ this.frase = frase; } + /** + * Método para criptografar a frase. + */ public void encrypt(){ for (int i = 0; i < frase.length(); i++){ encrypt[i] = frase.charAt(i); @@ -38,6 +51,9 @@ public void encrypt(){ } + /** + * Método para descriptografar a frase. + */ public void decrypt(){ for (int i = 0; i < frase.length(); i++){ encrypt[i] = frase.charAt(i); @@ -67,10 +83,20 @@ public void decrypt(){ System.out.println("Frase desencriptpgrafada: "+frase); } + /** + * Define a frase. + * + * @param frase Frase + */ public void setFrase(String frase){ this.frase = frase; } + /** + * Retorna a frase. + * + * @return Frase + */ public String getFrase(){ return frase; } diff --git a/exercises/classes-metodos-atributos/exercicio-12/src/main/java/MainCryptographye.java b/exercises/classes-metodos-atributos/exercicio-12/src/main/java/MainCryptographye.java index 5f3d570..b8c2680 100644 --- a/exercises/classes-metodos-atributos/exercicio-12/src/main/java/MainCryptographye.java +++ b/exercises/classes-metodos-atributos/exercicio-12/src/main/java/MainCryptographye.java @@ -1,3 +1,7 @@ +/** + * Classe MainCryptographye que define a aplicação das classes e métodos existentes. + * + */ public class MainCryptographye { public static void main(String[] args) { diff --git a/exercises/classes-metodos-atributos/exercicio-13/src/main/java/MyProgram.java b/exercises/classes-metodos-atributos/exercicio-13/src/main/java/MyProgram.java index a769c27..6be6cec 100644 --- a/exercises/classes-metodos-atributos/exercicio-13/src/main/java/MyProgram.java +++ b/exercises/classes-metodos-atributos/exercicio-13/src/main/java/MyProgram.java @@ -1,6 +1,10 @@ import java.util.Scanner; import java.util.ArrayList; +/** + * Classe MyProgram que define a aplicação das classes e métodos existentes. + * + */ public class MyProgram { public static void main(String[] args) { diff --git a/exercises/classes-metodos-atributos/exercicio-13/src/main/java/Quarto.java b/exercises/classes-metodos-atributos/exercicio-13/src/main/java/Quarto.java index f0e8128..922db79 100644 --- a/exercises/classes-metodos-atributos/exercicio-13/src/main/java/Quarto.java +++ b/exercises/classes-metodos-atributos/exercicio-13/src/main/java/Quarto.java @@ -1,5 +1,10 @@ import java.util.ArrayList; +/** + * Classe que representa um quarto. + * Possui controle de lampada, controle de abajur, controle de ar-condicionado, controle de tv e lista/controle de ventiladores. + * + */ public class Quarto { private boolean lampada; @@ -8,10 +13,18 @@ public class Quarto { private boolean tv; private ArrayList ventiladores; + /** + * Construtor padrão da classe Quarto + * + */ public Quarto() { this.ventiladores = new ArrayList(); } + /** + * Método que representa o interruptor de uma lâmpada. + * Leva em consideração se ela está desligada. + */ public void ligarLampada(){ if (lampada == false){ System.out.println("\nlâmpada ligada!"); @@ -22,6 +35,10 @@ public void ligarLampada(){ } } + /** + * Método que representa o interruptor de uma lâmpada. + * Leva em consideração se ela está ligada. + */ public void desligarLampada(){ if (lampada == true){ System.out.println("\nlâmpada desligada!"); @@ -32,6 +49,10 @@ public void desligarLampada(){ } } + /** + * Método que representa o interruptor de um abajur. + * Leva em consideração se ele está desligado. + */ public void ligarAbajur(){ if (abajur == false){ System.out.println("\nabajur ligado!"); @@ -42,6 +63,10 @@ public void ligarAbajur(){ } } + /** + * Método que representa o interruptor de um abajur. + * Leva em consideração se ele está ligado. + */ public void desligarAbajur(){ if (abajur == true){ System.out.println("\nabajur desligado!"); @@ -52,6 +77,10 @@ public void desligarAbajur(){ } } + /** + * Método que representa o controle de um ar-condicionado. + * Leva em consideração se ele está desligado. + */ public void ligarArcondicionado(){ if (arcondicionado == false){ System.out.println("\nar-condicionado ligado!"); @@ -62,6 +91,10 @@ public void ligarArcondicionado(){ } } + /** + * Método que representa o controle de um ar-condicionado. + * Leva em consideração se ele está ligado. + */ public void desligarArcondicionado(){ if (arcondicionado == true){ System.out.println("\nar-condicionado desligado!"); @@ -72,6 +105,10 @@ public void desligarArcondicionado(){ } } + /** + * Método que representa o controle de uma TV. + * Leva em consideração se ela está desligada. + */ public void ligarTv(){ if (tv == false){ System.out.println("\nTelevisao ligada!"); @@ -82,6 +119,10 @@ public void ligarTv(){ } } + /** + * Método que representa o controle de uma TV. + * Leva em consideração se ela está ligada. + */ public void desligarTv(){ if (tv == true){ System.out.println("\nTelevisao desligada!"); @@ -92,6 +133,10 @@ public void desligarTv(){ } } + /** + * Método que representa o controle de uma TV. + * Leva em consideração se ela está ligada. + */ public void mudarCanalTv(String nomecanal){ if (tv == true){ System.out.println("\nAssistindo ao canal " + nomecanal); @@ -101,6 +146,10 @@ public void mudarCanalTv(String nomecanal){ } } + /** + * Método que representa o controle de uma TV. + * Leva em consideração se ela está ligada. + */ public void mudarSinalTv(Source source){ if (tv == true) { if (source == Source.IE){ @@ -118,6 +167,10 @@ else if (source == Source.HDMI){ } } + /** + * Método que representa o controle de um ventilador. + * Leva em consideração se ele está desligado. + */ public boolean ligarVentilador(boolean status){ if (status == false){ System.out.println("\nVentilador ligado!"); @@ -129,6 +182,10 @@ public boolean ligarVentilador(boolean status){ } } + /** + * Método que representa o controle de um ventilador. + * Leva em consideração se ele está desligado. + */ public boolean desligarVentilador(boolean status){ if (status == true){ System.out.println("\nVentilador desligado!"); @@ -140,43 +197,92 @@ public boolean desligarVentilador(boolean status){ } } - + /** + * Retorna o objeto lampada + * + * @return Lampada + */ public boolean isLampada() { return lampada; } + /** + * Define uma lampada + * + * @param lampada Lampada + */ public void setLampada(boolean lampada) { this.lampada = lampada; } + /** + * Retorna o objeto abajur + * + * @return abajur + */ public boolean isAbajur() { return abajur; } + /** + * Define uma abajur + * + * @param abajur abajur + */ public void setAbajur(boolean abajur) { this.abajur = abajur; } + /** + * Retorna o objeto ar-condicionado + * + * @return ar-condicionado + */ public boolean isArcondicionado() { return arcondicionado; } + /** + * Define uma ar-condicionado + * + * @param arcondicionado ar-condicionado + */ public void setArcondicionado(boolean arcondicionado) { this.arcondicionado = arcondicionado; } + /** + * Retorna o objeto tv + * + * @return tv + */ public boolean isTv() { return tv; } + /** + * Define uma tv + * + * @param tv tv + */ public void setTv(boolean tv) { this.tv = tv; } + /** + * Retorna uma lista de ventiladores + * + * @return Lista de ventiladores + */ public ArrayList getVentiladores() { return ventiladores; } + /** + * Define uma lista de ventiladores + * + * @param ventiladores Lista de ventiladores + */ public void setVentiladores(ArrayList ventiladores) { this.ventiladores = ventiladores; } diff --git a/exercises/classes-metodos-atributos/exercicio-13/src/main/java/Source.java b/exercises/classes-metodos-atributos/exercicio-13/src/main/java/Source.java index e9d88ef..dbcd960 100644 --- a/exercises/classes-metodos-atributos/exercicio-13/src/main/java/Source.java +++ b/exercises/classes-metodos-atributos/exercicio-13/src/main/java/Source.java @@ -1,3 +1,7 @@ +/** + * Enumeração que representa as fontes de entrada do dispositivo. + * + */ public enum Source{ IE, diff --git a/exercises/classes-metodos-atributos/exercicio-13/src/main/java/Ventilador.java b/exercises/classes-metodos-atributos/exercicio-13/src/main/java/Ventilador.java index 4de683d..2c61d06 100644 --- a/exercises/classes-metodos-atributos/exercicio-13/src/main/java/Ventilador.java +++ b/exercises/classes-metodos-atributos/exercicio-13/src/main/java/Ventilador.java @@ -1,28 +1,60 @@ +/** + * Classe que representa um ventilador. + * Possui velocidade e controle de status. + * + */ public class Ventilador { private int velocidade; private boolean status; - + /** + * Construtor padrão da classe Ventilador. + */ public Ventilador() { } + /** + * Construtor da classe Ventilador com velocidade. + * + * @param velocidade Nível de velocidade do ventilador + */ public Ventilador(int velocidade) { this.velocidade = velocidade; } - + /** + * Retorna o nível de velocidade do ventilador. + * + * @return Nível de velocidade do ventilador. + */ public int getVelocidade() { return velocidade; } + + /** + * Define o nível de velocidade do ventilador. + * + * @param velocidade Nível de velocidade do ventilador. + */ public void setVelocidade(int velocidade) { this.velocidade = velocidade; } + /** + * Retorna o status do ventilador. + * + * @return Status do ventilador. + */ public boolean isStatus() { return status; } + /** + * Define o status do ventilador. + * + * @param status Status do ventilador. + */ public void setStatus(boolean status) { this.status = status; } diff --git a/exercises/classes-metodos-atributos/exercicio-14/src/main/java/Celula.java b/exercises/classes-metodos-atributos/exercicio-14/src/main/java/Celula.java index 4cedecb..2304e4f 100644 --- a/exercises/classes-metodos-atributos/exercicio-14/src/main/java/Celula.java +++ b/exercises/classes-metodos-atributos/exercicio-14/src/main/java/Celula.java @@ -1,11 +1,21 @@ +/** + * Classe que representa uma célula. + * + */ public class Celula { private static int num_instancias = 0; + /** + * Construtor padrão da classe Celula. + */ public Celula(){ num_instancias++; } + /** + * Método que imprime o número de instâncias de células. + */ public static void getNumInstancias() { System.out.println("Número de instâncias de células: " + num_instancias); } diff --git a/exercises/classes-metodos-atributos/exercicio-14/src/main/java/MainCelula.java b/exercises/classes-metodos-atributos/exercicio-14/src/main/java/MainCelula.java index 7e2100d..c43fb21 100644 --- a/exercises/classes-metodos-atributos/exercicio-14/src/main/java/MainCelula.java +++ b/exercises/classes-metodos-atributos/exercicio-14/src/main/java/MainCelula.java @@ -1,3 +1,7 @@ +/** + * Classe MainCelula que define a aplicação das classes e métodos existentes. + * + */ public class MainCelula { public static void main(String[] args) { diff --git a/exercises/classes-metodos-atributos/exercicio-15-16-17/src/main/java/Arrays.java b/exercises/classes-metodos-atributos/exercicio-15-16-17/src/main/java/Arrays.java index ad7fbac..3845b34 100644 --- a/exercises/classes-metodos-atributos/exercicio-15-16-17/src/main/java/Arrays.java +++ b/exercises/classes-metodos-atributos/exercicio-15-16-17/src/main/java/Arrays.java @@ -1,11 +1,23 @@ import java.util.ArrayList; import java.util.Collections; +/** + * Classe que representa um array. + * + */ public class Arrays { + /** + * Construtor padrão da classe Arrays + */ public Arrays() { } + /** + * Método que ordena e exibe uma lista em ordem crescente com lista de números + * + * @param num Lista de números + */ public static void crescente(ArrayList num){ System.out.println("\nORDEM CRESCENTE: "); Collections.sort(num); @@ -14,6 +26,11 @@ public static void crescente(ArrayList num){ } } + /** + * Método que ordena e exibe uma lista em ordem decrescente com lista de números + * + * @param num Lista de números + */ public static void decrescente(ArrayList num) { System.out.println("\nORDEM DECRESCENTE: "); Collections.sort(num, Collections.reverseOrder()); @@ -22,7 +39,11 @@ public static void decrescente(ArrayList num) { } } - + /** + * Método que analisa e exibe o maior numero de uma lista de números com lista de números + * + * @param num Lista de números + */ public static void maiornum(ArrayList num){ float maior = num.get(0), numatual; @@ -38,7 +59,11 @@ public static void maiornum(ArrayList num){ } - + /** + * Método que analisa e exibe o menor numero de uma lista de números com lista de números + * + * @param num Lista de números + */ public static void menornum(ArrayList num){ float menor = num.get(0), numatual; @@ -53,7 +78,11 @@ public static void menornum(ArrayList num){ System.out.println("\nMenor número: " + menor); } - + /** + * Método que analisa e exibe a media entre os numeros com lista de números + * + * @param num Lista de números + */ public static void media(ArrayList num){ float media = 0; @@ -68,6 +97,11 @@ public static void media(ArrayList num){ } + /** + * Método que analisa e exibe o desvio padrão entre os numeros com lista de números + * + * @param num Lista de números + */ public static void desviopadrão(ArrayList num){ float media = 0, soma = 0, dp; @@ -90,7 +124,11 @@ public static void media(ArrayList num){ } - + /** + * Método que analisa e exibe um texto invertido com lista do tipo String + * + * @param num Lista de strings + */ public static void inverter(ArrayList texto){ System.out.println("\nOrdem invertida Array: "); Collections.reverse(texto); diff --git a/exercises/classes-metodos-atributos/exercicio-15-16-17/src/main/java/MainArrays.java b/exercises/classes-metodos-atributos/exercicio-15-16-17/src/main/java/MainArrays.java index da3c730..b36abc6 100644 --- a/exercises/classes-metodos-atributos/exercicio-15-16-17/src/main/java/MainArrays.java +++ b/exercises/classes-metodos-atributos/exercicio-15-16-17/src/main/java/MainArrays.java @@ -1,6 +1,10 @@ import java.util.ArrayList; import java.util.Scanner; +/** + * Classe MainArrays que define a aplicação das classes e métodos existentes. + * + */ public class MainArrays { public static void main(String[] args) { diff --git a/exercises/classes-metodos-atributos/exercicio-18/src/main/java/Fornecedor.java b/exercises/classes-metodos-atributos/exercicio-18/src/main/java/Fornecedor.java index ef1810c..113b8e0 100644 --- a/exercises/classes-metodos-atributos/exercicio-18/src/main/java/Fornecedor.java +++ b/exercises/classes-metodos-atributos/exercicio-18/src/main/java/Fornecedor.java @@ -1,11 +1,26 @@ +/** + * Classe que representa um fornecedor. + * Possui nome, telefone, endereço e cnpj. + * + */ public class Fornecedor { private String nome, telefone, endereço, cnpj; - + /** + * Construtor padrão da classe Fornecedor. + */ public Fornecedor() { } + /** + * Construtor da classe Fornecedor com nome, telefone, endereço e cnpj. + * + * @param nome Nome do fornecedor + * @param telefone Telefone do fornecedor + * @param endereço Enereço do fornecedor + * @param cnpj Cnpj do fornecedor + */ public Fornecedor(String nome, String telefone, String endereço, String cnpj) { this.nome = nome; this.telefone = telefone; @@ -13,34 +28,74 @@ public Fornecedor(String nome, String telefone, String endereço, String cnpj) { this.cnpj = cnpj; } + /** + * Retorna o nome do fornecedor. + * + * @return Nome do fornecedor + */ public String getNome() { return nome; } + /** + * Define o nome do fornecedor. + * + * @param nome Nome do fornecedor. + */ public void setNome(String nome) { this.nome = nome; } + /** + * Retorna o número de telefone do fornecedor. + * + * @return Número de telefone do fornecedor + */ public String getTelefone() { return telefone; } + /** + * Define o núemro de telefone do fornecedor. + * + * @param telefone Número de telefone do fornecedor. + */ public void setTelefone(String telefone) { this.telefone = telefone; } + /** + * Retorna o endereço do fornecedor. + * + * @return Endereço do fornecedor + */ public String getEndereço() { return endereço; } + /** + * Define o endereço do fornecedor. + * + * @param endereço Endereço do fornecedor. + */ public void setEndereço(String endereço) { this.endereço = endereço; } + /** + * Retorna o cnpj do fornecedor. + * + * @return Cnpj do fornecedor + */ public String getCnpj() { return cnpj; } + /** + * Define o cnpj do fornecedor. + * + * @param cnpj Cnpj do fornecedor. + */ public void setCnpj(String cnpj) { this.cnpj = cnpj; } diff --git a/exercises/classes-metodos-atributos/exercicio-18/src/main/java/MainCarrinho.java b/exercises/classes-metodos-atributos/exercicio-18/src/main/java/MainCarrinho.java index 06c3283..f1fe4bd 100644 --- a/exercises/classes-metodos-atributos/exercicio-18/src/main/java/MainCarrinho.java +++ b/exercises/classes-metodos-atributos/exercicio-18/src/main/java/MainCarrinho.java @@ -1,6 +1,10 @@ import java.time.LocalDate; import java.util.ArrayList; +/** + * Classe MainCarrinho que define a aplicação das classes e métodos existentes. + * + */ public class MainCarrinho { public static void main(String[] args) { diff --git a/exercises/classes-metodos-atributos/exercicio-18/src/main/java/Mercadoria.java b/exercises/classes-metodos-atributos/exercicio-18/src/main/java/Mercadoria.java index f6c6554..d2ca600 100644 --- a/exercises/classes-metodos-atributos/exercicio-18/src/main/java/Mercadoria.java +++ b/exercises/classes-metodos-atributos/exercicio-18/src/main/java/Mercadoria.java @@ -3,6 +3,11 @@ import java.util.HashSet; import java.util.Set; +/** + * Classe que representa uma mercadoria. + * Possui nome, valor, valor com juros, validade e fornecedor + * + */ public class Mercadoria { private String nome; @@ -14,9 +19,21 @@ public class Mercadoria { private static int qtd_itens_total = 0; private float valor_total = 0; + /** + * Construtor padrão da classe Mercadoria. + */ public Mercadoria() { } + /** + * Construtor da classe Mercadoria com nome, valor, validade e fornecedor. + * Também verifica se o produto está dentro da validade. + * + * @param nome Nome da mercadoria + * @param valor Valor da mercadoria + * @param validade Validade da mercadoria + * @param fornecedor Fornecedor da mercadoria + */ public Mercadoria(String nome, float valor, LocalDate validade, Fornecedor fornecedor) { LocalDate hoje = LocalDate.now(); @@ -40,20 +57,37 @@ public Mercadoria(String nome, float valor, LocalDate validade, Fornecedor forne } } + /** + * Método que imprime a quantidade total de mercadorias. + */ public void qtd_itens_total(){ System.out.println("\n QUANTIDADE DE PRODUTOS: " + getQtd_itens_total()); } + /** + * Método que calcula o valor total de uma mercadoria de acordo com sua quantidade. + * + * @param valor Valor unitário da mercadoria + * @param qtd Quantidade de mercadorias + */ public void calc_valor_total(float valor, int qtd){ this.valor_total = this.valor_total + (valor*qtd); } + /** + * Método que imprime o valor total da mercadoria. + */ public void valor_total(){ System.out.println(" VALOR TOTAL: " + this.valor_total); System.out.println("+-------------------------------+\n\n"); } + /** + * Método que imprime a quantidade de mercadorias por produto + * + * @param mercadoria Lista de produtos + */ public void qtd_por_produto(ArrayList mercadoria){ System.out.println("+-------------------------------+"); @@ -87,38 +121,101 @@ public void qtd_por_produto(ArrayList mercadoria){ } } - + /** + * Retorna o nome da mercadoria + * + * @return Nome da mercadoria + */ public String getNome() { return nome; } + + /** + * Define o nome da mercadoria + * + * @param nome Nome da mercadoria + */ public void setNome(String nome) { this.nome = nome; } + + /** + * Retorna o valor da mercadoria + * + * @return valor da mercadoria + */ public float getValor() { return valor; } + + /** + * Define o valor da mercadoria + * + * @param valor valor da mercadoria + */ public void setValor(float valor) { this.valor = valor; } + + /** + * Retorna o valor com juros da mercadoria + * + * @return valor com juros da mercadoria + */ public float getValor_c_juros() { return valor_c_juros; } + + /** + * Define o valor com juros da mercadoria + * + * @param valor_c_juros valor com juros da mercadoria + */ public void setValor_c_juros(float valor_c_juros) { this.valor_c_juros = valor_c_juros; } + + /** + * Retorna a validade da mercadoria + * + * @return Validade da mercadoria + */ public LocalDate getValidade() { return validade; } + + /** + * Define a validade da mercadoria + * + * @param validade validade da mercadoria + */ public void setValidade(LocalDate validade) { this.validade = validade; } + + /** + * Retorna o fornecedor da mercadoria + * + * @return Fornecedor da mercadoria + */ public Fornecedor getFornecedor() { return fornecedor; } + + /** + * Define o fornecedor da mercadoria + * + * @param fornecedor fornecedor da mercadoria + */ public void setFornecedor(Fornecedor fornecedor) { this.fornecedor = fornecedor; } + /** + * Retorna a quantidade total de mercadorias. + * + * @return Quantidade total de mercadorias + */ public static int getQtd_itens_total() { return qtd_itens_total; } diff --git a/exercises/classes-metodos-atributos/exercicio-19/src/main/java/MainNotaFiscal.java b/exercises/classes-metodos-atributos/exercicio-19/src/main/java/MainNotaFiscal.java index 1c70a99..6b87993 100644 --- a/exercises/classes-metodos-atributos/exercicio-19/src/main/java/MainNotaFiscal.java +++ b/exercises/classes-metodos-atributos/exercicio-19/src/main/java/MainNotaFiscal.java @@ -1,5 +1,9 @@ import java.time.LocalDate; +/** + * Classe MainNotaFiscal que define a aplicação das classes e métodos existentes. + * + */ public class MainNotaFiscal { public static void main(String[] args) { diff --git a/exercises/classes-metodos-atributos/exercicio-19/src/main/java/NotaFiscal.java b/exercises/classes-metodos-atributos/exercicio-19/src/main/java/NotaFiscal.java index f634873..bafb34c 100644 --- a/exercises/classes-metodos-atributos/exercicio-19/src/main/java/NotaFiscal.java +++ b/exercises/classes-metodos-atributos/exercicio-19/src/main/java/NotaFiscal.java @@ -1,6 +1,11 @@ import java.time.LocalDate; import java.time.Period; +/** + * Classe que representa uma nota fiscal + * Possui informações da compra, comprador, valor e status de pagamento. + * + */ public class NotaFiscal { private String numero; @@ -10,9 +15,22 @@ public class NotaFiscal { private boolean pagamento_realizado; private int qtd_dias; + /** + * Construtor padrão da classe NotaFiscal. + */ public NotaFiscal() { } + /** + * Construtor da classe NotaFiscal com parâmetros pré-definidos + * + * @param numero Número da nota fiscal. + * @param data_compra Data da compra. + * @param valor Valor da nota. + * @param nome_comprador Nome do comprador. + * @param telefone_comprador Telefone do comprador. + * @param cpf_comprador CPF do comprador. + */ public NotaFiscal(String numero, LocalDate data_compra, float valor, String nome_comprador, String telefone_comprador, String cpf_comprador) { this.numero = numero; @@ -23,6 +41,14 @@ public NotaFiscal(String numero, LocalDate data_compra, float valor, String nome this.cpf_comprador = cpf_comprador; } + /** + * Método que alcula o valor final com juros baseado nos dias de atraso desde a data da compra. + * Aplica 0.95% de juros ao dia. + * + * @param valor Valor original da nota. + * @param data_compra Data da compra. + * @return Valor total com os juros aplicados. + */ public float juros(float valor, LocalDate data_compra){ LocalDate data_atual = LocalDate.now(); @@ -36,7 +62,12 @@ public float juros(float valor, LocalDate data_compra){ return valor; } - + /** + * Método que exibe todos os dados da nota fiscal, incluindo o status de pagamento e o valor total com juros. + * + * @param nf Objeto da nota fiscal a ser visualizado. + * @param juros Valor total com juros. + */ public void visualizar_nota(NotaFiscal nf, float juros){ System.out.println("\n+-------------------------------------+"); @@ -65,53 +96,146 @@ public void visualizar_nota(NotaFiscal nf, float juros){ } - + /** + * Retorna o numero da nota fiscal. + * + * @return Número da nota fiscal. + */ public String getNumero() { return numero; } + /** + * Define o número da nota fiscal. + * + * @param numero Número da nota. + */ public void setNumero(String numero) { this.numero = numero; } + + /** + * Retorna a data da compra. + * + * @return Data da compra. + */ public LocalDate getData_compra() { return data_compra; } + + /** + * Define a data da compra. + * + * @param data_compra Data da compra. + */ public void setData_compra(LocalDate data_compra) { this.data_compra = data_compra; } + + /** + * Retorna o valor da nota fiscal. + * + * @return Valor da nota fiscal. + */ public float getValor() { return valor; } + + /** + * Define o valor da nota fiscal. + * + * @param valor Valor da nota. + */ public void setValor(float valor) { this.valor = valor; } + + /** + * Retorna o nome do comprador + * + * @return Nome do comprador. + */ public String getNome_comprador() { return nome_comprador; } + + /** + * Define o nome do comprador. + * + * @param nome_comprador Nome do comprador. + */ public void setNome_comprador(String nome_comprador) { this.nome_comprador = nome_comprador; } + + /** + * Retorna o endereço do comprador + * + * @return Endereço do comprador. + */ public String getEndereco_comprador() { return endereco_comprador; } + + /** + * Define o endereço do comprador. + * + * @param endereco_comprador Endereço do comprador. + */ public void setEndereco_comprador(String endereco_comprador) { this.endereco_comprador = endereco_comprador; } + + /** + * Retorna o número de telefone do comprador + * + * @return Telefone do comprador. + */ public String getTelefone_comprador() { return telefone_comprador; } + + /** + * Define o numero de telefone do comprador. + * + * @param telefone_comprador Telefone do comprador. + */ public void setTelefone_comprador(String telefone_comprador) { this.telefone_comprador = telefone_comprador; } + + /** + * Retorna o número de CPF do comprador + * + * @return CPF do comprador. + */ public String getCpf_comprador() { return cpf_comprador; } + + /** + * Define o CPF do comprador. + * + * @param cpf_comprador CPF do comprador. + */ public void setCpf_comprador(String cpf_comprador) { this.cpf_comprador = cpf_comprador; } + + /** + * Retorna o estado do pagamento: Realizado(true) ou não(false) + * + * @return true se o pagamento foi realizado; false caso contrário. + */ public boolean isPagamento_realizado() { return pagamento_realizado; } + + /** + * Define o status de pagamento. + * + * @param pagamento_realizado true se pago ou false se pendente. + */ public void setPagamento_realizado(boolean pagamento_realizado) { this.pagamento_realizado = pagamento_realizado; }