Loja de Carros em JAVA 🚗

I. Manual de utilização para o Usuário:

1. Ao iniciar o aplicativo, a tela abaixo será visualizada, para navegar para as próximas páginas, clique no botão Go to the Car store!

2. Na tela abaixo está sendo mostrada a página de cadastro de carros. Quando todos os campos estão preenchidos e o botão cadastrar é clicado, o carro aparece na tabela, sendo cadastrado também em um banco de dados. obs: preencha os dados corretamente de acordo com as validações.

3. Na tela de cadastro de clientes, quando todos os campos foram preenchidos corretamente e o botão cadastrar é clicado, o cliente aparece na tabela também sendo cadastrado no banco de dados. obs: preencha os dados corretamente de acordo com as validações.

4. Na tela de transações/vendas podemos efetuar a venda de um carro para determinado cliente, também é necessário colocar uma data de acordo com as normas dd/mm/yyyy, e inserir um valor.

II. Documentação do Código:

Connection

• Este código Java contém uma classe ConnectionFactory que fornece métodos para gerenciar conexões com um banco de dados PostgreSQL.

• Atributos:

  • Define atributos estáticos para a URL do banco de dados, nome de usuário e senha para se conectar ao banco de dados PostgreSQL.

• Método getConnection():

  • Retorna uma conexão ativa com o banco de dados usando o DriverManager e os detalhes de URL, usuário e senha fornecidos.
  • Lança uma exceção RuntimeException se ocorrer um erro ao obter a conexão.

• Método closeConnection(Connection connection):

  • Fecha a conexão com o banco de dados, se estiver aberta.
  • Trata exceções associadas ao fechamento da conexão, mas apenas imprime a rastreabilidade do erro.

• Método closeConnection(Connection connection, PreparedStatement stmt):

  • Além de fechar a conexão, também fecha um objeto PreparedStatement associado, se existir.
  • Trata exceções associadas ao fechamento da conexão e do PreparedStatement.

• Método closeConnection(Connection connection, PreparedStatement stmt, ResultSet rs):

  • Adicionalmente ao fechamento da conexão e do PreparedStatement, fecha um ResultSet, se existir.
  • Trata exceções associadas ao fechamento da conexão, do PreparedStatement e do ResultSet.

• Resumidamente, essa classe oferece métodos estáticos para obter conexões com o banco de dados PostgreSQL, bem como para fechar conexões, declarações preparadas (PreparedStatement) e resultados (ResultSet). Essa abordagem visa a reutilização de código e o encapsulamento de lógica de gerenciamento de conexão, facilitando o desenvolvimento e manutenção de aplicações Java que interagem com bancos de dados PostgreSQL.

Classe DAO

- A classe DAO atua como uma camada de acesso a dados para interagir com um banco de dados relacionado aos registros de carros. Aqui está um resumo das principais funcionalidades dessa classe:

• Atributos:

  • connection: Armazena a conexão com o banco de dados através da ConnectionFactory.
  • carros: Lista para armazenar objetos do tipo Carros.

• Método criaTabela():

  • Cria uma tabela no banco de dados usando SQL.
  • Usa uma instrução CREATE TABLE para criar a tabela carros_lojacarros se ela não existir.

• Método listarTodos():

  • Recupera todos os registros da tabela carros_lojacarros do banco de dados.
  • Utiliza uma consulta SQL para selecionar todos os registros.
  • Cria objetos Carros com os dados recuperados e os armazena em uma lista para posterior uso.

• Método cadastrar(String marca, String modelo, String ano, String placa, String valor):

  • Insere um novo registro na tabela carros_lojacarros do banco de dados.
  • Utiliza uma instrução INSERT INTO com parâmetros para realizar a inserção.
  • Controla exceções para evitar inserções com placas duplicadas.

• Método atualizar(String marca, String modelo, String ano, String placa, String valor):

  • Atualiza um registro na tabela carros_lojacarros baseado na placa.
  • Utiliza uma instrução UPDATE com parâmetros para modificar os dados do carro.

• Método apagar(String placa):

  • Remove um registro da tabela carros_lojacarros com base na placa fornecida.
  • Utiliza uma instrução DELETE FROM para excluir o registro.

• Essa classe encapsula a lógica para manipular o banco de dados relacionado aos registros de carros (Carros) por meio de operações de inserção, atualização, exclusão e recuperação de dados da tabela carros_lojacarros. Além disso, controla as conexões com o banco de dados para garantir sua abertura e fechamento adequados.

Controller

• A classe Control controla as interações entre a interface de usuário (UI) e operações relacionadas a carros armazenados em um banco de dados.

• Atributos:

  • carros: Armazena uma lista de objetos do tipo Carros.
  • tableModel: Representa o modelo da tabela Swing para exibir os dados.
  • table: É a tabela Swing onde os dados dos carros são mostrados.

• Método atualizarTabela():

  • Limpa as linhas existentes na tabela.
  • Obtém os dados atualizados dos carros a partir do banco de dados usando um CarrosDAO.
  • Popula a tabela Swing com os dados dos carros, adicionando cada carro como uma nova linha na tabela.

• Método cadastrar(String marca, String modelo, String ano, String placa, String valor):

  • Chama o método de cadastro no banco de dados usando um CarrosDAO.
  • Após o cadastro, atualiza a tabela de exibição chamando o método atualizarTabela().

• Método atualizar(String marca, String modelo, String ano, String placa, String valor):

  • Chama o método de atualização no banco de dados usando um CarrosDAO.
  • Após a atualização, atualiza a tabela de exibição chamando o método atualizarTabela().

• Método apagar(String placa):

  • Chama o método de exclusão no banco de dados usando um CarrosDAO.
  • Após a exclusão, atualiza a tabela de exibição chamando o método atualizarTabela().

• Em resumo, a classe Control atua como um controlador entre a interface do usuário e as operações de manipulação de dados no banco de dados. Ela utiliza um objeto para realizar operações de cadastro, atualização e exclusão no banco de dados, ao mesmo tempo que atualiza a tabela Swing com os dados atualizados após cada operação.

View

- Representa a classe ClientesPainel, uma interface gráfica de usuário (GUI) para gerenciar informações de clientes.

• Componentes Visuais:

  • Utiliza JTextField para entrada de dados referentes a CPF, nome, telefone e cidade do cliente.
  • Usa JLabel para indicar os campos correspondentes aos valores a serem inseridos.
  • Contém uma tabela JTable para exibir os dados dos clientes cadastrados.

• Operações de Interface:

  • Possui botões para cadastrar, editar e apagar clientes.
  • Validações são aplicadas nos campos de entrada para garantir formatos adequados (CPF, telefone, nome, cidade).
  • Exibe mensagens de erro ou sucesso dependendo das operações executadas.
  • A interação com a tabela permite a seleção de linhas para edição ou exclusão.

• Interação com o Banco de Dados:

  • Ao iniciar, cria a tabela no banco de dados através da classe ClientesDAO.
  • Utiliza métodos da classe ClientesControl para realizar operações como cadastrar, atualizar e apagar clientes no banco de dados.
  • A cada operação, atualiza a tabela na interface para refletir as mudanças no banco de dados.

• Validações Específicas:

  • Verifica se os campos estão preenchidos antes de cadastrar um novo cliente.
  • Realiza validações específicas para formatos de CPF, telefone, nome e cidade.

• Atualização da Tabela de Clientes:

  • Possui um método atualizarTabela() que atualiza os dados na tabela de clientes a partir do banco de dados.

• Em resumo, essa classe ClientesPainel oferece uma interface interativa para gerenciar operações relacionadas aos clientes, como cadastro, edição e exclusão, mantendo a interface sincronizada com os dados armazenados no banco de dados.

View Vendas

• Representa a classe VendasPainel, uma interface gráfica de usuário (GUI) para gerenciar registros de vendas. Aqui está um resumo das principais funcionalidades:

• Componentes Visuais:

  • Utiliza componentes Swing como JTextField, JLabel, JComboBox, JButton para entrada de dados, exibição e interação do usuário.
  • Inclui uma tabela JTable para mostrar os registros de vendas.

• Operações de Interface:

  • Fornece campos para inserir informações como data da venda e valor.
  • Permite a seleção de clientes e carros por meio de JComboBox para associá-los à venda.
  • Inclui botões para cadastrar vendas, atualizar e excluir registros.

• Interação com o Banco de Dados:

  • Utiliza classes DAO (VendasDAO, CarrosDAO, ClientesDAO) para interagir com o banco de dados, realizando operações como cadastro, exclusão e listagem de vendas, carros e clientes.
  • Atualiza a tabela de vendas na interface para refletir as mudanças no banco de dados.

• Validações de Entrada:

  • Realiza validações nos campos de data e valor para garantir formatos adequados.
  • Fornece feedback ao usuário sobre os campos que devem ser preenchidos corretamente.

• Funcionalidades Adicionais:

  • Inclui métodos para atualizar as JComboBox de clientes e carros, garantindo que os dados estejam sempre atualizados na interface.

• Interação com o Usuário:

  • Permite a seleção de uma venda na tabela para visualização ou modificação dos dados.
  • Apresenta mensagens de confirmação para garantir a exclusão correta de vendas.

• Em resumo, a classe VendasPainel fornece uma interface interativa para registrar, visualizar e gerenciar vendas, integrando-se ao banco de dados e proporcionando uma experiência de usuário para manipular informações de vendas.