Autentica��o em Aplica��es Web utilizando JPA

Fique por dentro

O objetivo desse artigo � criar um sistema web via JPA (Persist�ncia) que tenha autenticaç�o b�sica, onde ser� implementada uma p�gina padr�o de login e senha, sendo como inicial, e a outra p�gina denominada principal com a opç�o de menu para sair do sistema.

JPA (Java Persistence API) � um framework para persist�ncia de dados que auxilia desenvolvedores de sistemas Java a implementarem p�ginas para internet, ou em outros tipos, geradas de forma din�mica e automaticamente. Nesse artigo, o ambiente de desenvolvimento a ser utilizado � o Netbeans, que al�m de nele existir o servidor para a execuç�o da aplicaç�o conhecido como Apache Tomcat, existem drivers espec�ficos para a conectividade de dados como, por exemplo, a utilizaç�o do PostgreSQL que agiliza muito o envio e a troca de informaç�es entre o banco de dados criado e a aplicaç�o web.

Saiba mais: cursos de java

Primeiros Passos

Figura 1. Configuraç�o do Nome do Projeto Java Web AutenticaJPA

Depois de configurado, clique em Pr�ximo e selecione o servidor Apache Tomcat, e para concluir clique em Finalizar. O projeto ser� criado e estar� pronto para ser implementado.

Criando a Persist�ncia

Em cima do nome do projeto AutenticaJPA, clique com o bot�o direito e v� em Novo. Ao clicar na opç�o Outros abrir� uma janela: selecione a Categoria Persist�ncia e o tipo de arquivo Classe de Entidade. Ao clicar em Pr�ximo, o nome da classe ser� definido como Funcion�rio e o pacote (que obrigatoriamente deve ser definido) ser� como autentica.entidades. Clique em Pr�ximo novamente e aparecer� uma janela para selecionar a Biblioteca de persist�ncia Eclipse (JPA 2.1) e selecionar a Conex�o de Banco de dados jdbc:postgresql://127.0.0.1:5732/postgres [postgres em public] (mas pode mudar dependendo da configuraç�o atual do Netbeans). Selecione a Estrat�gia de criaç�o Criar e complete clicando em Finalizar.

Implementando o Pacote Entidades

Primeiramente ser� programada uma classe Java que controlar� uma nova entidade com base na criaç�o da tabela Funcionarios, seus campos, propriedades, tamanhos e consultas. Ser� criado um novo pacote (clicando com o bot�o direito em cima de Pacotes de C�digos-Fonte, v� em Novo → Pacote Java) com o nome autentica.entidades; clique em Finalizar.

Saiba mais: Autenticaç�o em Aplicaç�es Web

Ser� criada a classe Funcionario.java a ser programada com c�digo referente a Listagem 1. Essa classe ser� respons�vel por criar a tabela Funcionario com todos os campos, propriedades, chave prim�ria e tamanhos.


package autentica.entidades;
import java.io.Serializable;
import javax.persistence.Basic;
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.NamedQueries;
import javax.persistence.NamedQuery;
import javax.persistence.Table;
import javax.persistence.UniqueConstraint;
 
@Entity
@Table(catalog = "postgres", schema = "public", uniqueConstraints = {
    @UniqueConstraint(columnNames = {"fun_login"})})
@NamedQueries({
    @NamedQuery(name = "Funcionario.findAll", query = 
    "SELECT f FROM Funcionario f"),
    @NamedQuery(name = "Funcionario.findByCodigo", query = 
    "SELECT f FROM Funcionario f WHERE f.codigo = :codigo"),
    @NamedQuery(name = "Funcionario.findByLogin", query = 
    "SELECT f FROM Funcionario f WHERE f.login = :login")})
public class Funcionario implements Serializable {
 
    private static final long serialVersionUID = 1L;
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Basic(optional = false)
    @Column(name = "fun_codigo", nullable = false)
    private Integer codigo;
    @Basic(optional = false)
    @Column(name = "fun_nome", nullable = false, length = 100)
    private String nome;
    @Basic(optional = false)
    @Column(name = "fun_login", nullable = false, length = 15)
    private String login;
    @Basic(optional = false)
    @Column(name = "fun_senha", nullable = false, length = 32)
    private String senha;
    @Basic(optional = false)
    @Column(name = "fun_endereco", nullable = false, length = 100)
    private String endereco;
    @Column(name = "fun_endereco_numero")
    private Integer enderecoNumero;
    @Column(name = "fun_endereco_complemento", length = 15)
    private String enderecoComplemento;
    @Column(name = "fun_bairro", length = 70)
    private String bairro;
    @Basic(optional = false)
    @Column(name = "fun_ativo", nullable = false)
    private boolean ativo;
 
    public Funcionario() {
    }
 
    public Funcionario(Integer funCodigo) {
        this.codigo = funCodigo;
    }
 
    public Funcionario(Integer funCodigo, String funNome, 
    String funLogin, String funSenha, String funEndereco, 
    boolean funAtivo) {
        this.codigo = funCodigo;
        this.nome = funNome;
        this.login = funLogin;
        this.senha = funSenha;
        this.endereco = funEndereco;
        this.ativo = funAtivo;
    }
 
    public Integer getCodigo() {
        return codigo;
    }
 
    public void setCodigo(Integer codigo) {
        this.codigo = codigo;
    }
 
    public String getNome() {
        return nome;
    }
 
    public void setNome(String nome) {
        this.nome = nome;
    }
 
    public String getLogin() {
        return login;
    }
 
    public void setLogin(String login) {
        this.login = login;
    }
 
    public String getSenha() {
        return senha;
    }
 
    public void setSenha(String senha) {
        this.senha = senha;
    }
 
    public String getEndereco() {
        return endereco;
    }
 
    public void setEndereco(String endereco) {
        this.endereco = endereco;
    }
 
    public Integer getEnderecoNumero() {
        return enderecoNumero;
    }
 
    public void setEnderecoNumero(Integer enderecoNumero) {
        this.enderecoNumero = enderecoNumero;
    }
 
    public String getEnderecoComplemento() {
        return enderecoComplemento;
    }
 
    public void setEnderecoComplemento(String enderecoComplemento) {
        this.enderecoComplemento = enderecoComplemento;
    }
 
    public String getBairro() {
        return bairro;
    }
 
    public void setBairro(String bairro) {
        this.bairro = bairro;
    }
 
    public boolean isAtivo() {
        return ativo;
    }
 
    public void setAtivo(boolean ativo) {
        this.ativo = ativo;
    }
    
    @Override
    public int hashCode() {
        int hash = 0;
        hash += (codigo != null ? codigo.hashCode() : 0);
        return hash;
    }
 
    @Override
    public boolean equals(Object object) {
        if (!(object instanceof Funcionario)) {
            return false;
        }
        Funcionario other = (Funcionario) object;
        return !((this.codigo == null && other.codigo != null) || 
        (this.codigo != null && !this.codigo.equals(other.codigo)));
    }
 
    @Override
    public String toString() {
        return "autentica.entidades.Funcionario[ fun_codigo=" + codigo + " ]";
    }
}

Listagem 1. Classe Funcionario.java

Logo em cima da declaraç�o da chave prim�ria s�o criadas as NamedQuery(s), onde cada uma � respons�vel por executar um comando de consulta pr�-definida em cada linha. Em seguida, � criado um construtor que recebe todos os campos da tabela criada de acordo com cada propriedade respectiva definida por cada get e set imposto para que cada campo receba e envie sua informaç�o.

Depois � criado o m�todo hashCode, que � respons�vel por criar uma chave pr�pria para a senha cujo seu objetivo � manter sua integridade.

O m�todo do tipo boolean (equals) � respons�vel por comparar se o que o usu�rio digitou � compat�vel com o que est� armazenado no banco de dados.

E finalmente o m�todo toString � utilizado para que a entidade busque o c�digo do funcion�rio e compare com a atual posiç�o do funcion�rio pesquisado, caso houve �xito na autenticaç�o.

Implementando o Pacote JSF

Agora ser� implementado o pacote JSF para manter um controle entre a persist�ncia dos dados e a aplicaç�o. Ser� criado um novo pacote chamado autentica.jsf.

Saiba mais: Curso Online de JSF (Java Server Faces)

Ser� criada tamb�m a classe abstrata AbstractForm.java a ser programada com c�digo referente a Listagem 2. Ela ser� respons�vel por efetuar uma busca no contexto JSF, gerar uma mensagem de erro com n�vel de severidade Warn e gerar uma mensagem de erro vinculada a um dado componente.


package autentica.jsf;
 
import autentica.persistence.JPAManager;
import java.io.Serializable;
import javax.faces.application.FacesMessage;
import javax.faces.component.UIComponent;
import javax.faces.context.FacesContext;
import javax.persistence.EntityManagerFactory;
 
 
public abstract class AbstractForm
        implements Serializable {
 
    private final JPAManager controlador;
 
    public AbstractForm() {
        super();
        controlador = new JPAManager();
    }
 
    protected final EntityManagerFactory getEntityManagerFactory() {
        return controlador.getEntityManagerFactory();
    }
 
    protected final void closeEntityManagerFactory() {
        controlador.closeEntityManagerFactory();
    }
    protected static FacesContext getFacesContext() {
        return FacesContext.getCurrentInstance();
    }
 
    protected final void setMessage(String summary) {
        setMessage(null, summary);
    }
 
    protected final void setMessage(UIComponent component, String summary) {
        FacesContext ctx = getFacesContext();
        ctx.addMessage((component != null ? component.getClientId(ctx) : null),
                new FacesMessage(FacesMessage.SEVERITY_WARN, summary, null));
    }
}

Listagem 2. Classe AbstractForm.java

Agora ser� necess�rio criar a interface Bean Gerenciado com o nome de FormTransiente.java, a ser programada com c�digo referente a Listagem 3. Essa interface ser� respons�vel por marcar um Bean Gerenciado como transiente, devendo ser removido da sess�o quando outro form for colocado na sess�o, ou seja, ser� respons�vel por manter a sess�o durante a navegaç�o das p�ginas.


package autentica.jsf;
 
public interface FormTransiente {
}

Listagem 3. FormTransiente.java

E finalizando essa parte, ser� criada a classe Bean Gerenciado com o nome de LoginForm.java a ser programada com c�digo referente a Listagem 4, e ser� respons�vel por controlar as aç�es do Login e Logoff da autenticaç�o durante a aplicaç�o.


package autentica.jsf;
 
import autentica.entidades.Funcionario;
import javax.faces.bean.ManagedBean;
import javax.faces.bean.SessionScoped;
import javax.persistence.EntityManager;
import javax.persistence.NoResultException;
import javax.persistence.Query;
 
@ManagedBean(name = "loginForm")
@SessionScoped
public class LoginForm extends AbstractForm {
 
    private Funcionario funcionarioLogado;
    private String login;
    private String senha;
 
    public LoginForm() {
        super();
        limpaAtributosForm();
    }
 
    private void limpaAtributosForm() {
        funcionarioLogado = null;
        login = null;
        senha = null;
    }
 
    public Funcionario getFuncionarioLogado() {
        return funcionarioLogado;
    }
 
    public void setSenha(String senha) {
        this.senha = senha;
    }
 
    public String getSenha() {
        return senha;
    }
 
    public String getLogin() {
        return login;
    }
 
    public void setLogin(String login) {
        this.login = login;
    }
 
    public boolean isUsuarioLogado() {
        return funcionarioLogado != null;
    }
 
    public String limpaTelaCadastro_action() {
        limpaAtributosForm();
        return "LIMPA";
    }
 
    public String logout_action() {
        limpaAtributosForm();
        return "LOGOUT";
    }
 
    public String efetuaLogin_action() {
        EntityManager em = null;
        try {
            em = getEntityManagerFactory().createEntityManager();
            Query q = em.createNamedQuery("Funcionario.findByLogin");
            q.setParameter("login", login);
            this.funcionarioLogado = (Funcionario) q.getSingleResult();
            if (funcionarioLogado.getSenha().equalsIgnoreCase(senha)) {
                return "PRINCIPAL";
            } else {
                setMessage("Senha inv�lida.");
            }
        } catch (NoResultException ex) {
            setMessage("Usu�rio n�o encontrado.");
        } catch (Exception ex) {
        } finally {
            if (em != null) {
                em.close();
            }
            closeEntityManagerFactory();
        }
        funcionarioLogado = null;
        return null;
    }
}

Listagem 4. Classe LoginForm.java

Os campos login e senha tem uma propriedade denominada funcionarioLogado que retorna se o login e a senha est�o corretas ou erradas.

O m�todo limpaAtributosForm() � respons�vel por limpar os campos e em seguida s�o criadas as propriedades get(s) e set(s)dos campos login e senha.

O m�todo isUsuarioLogado() � respons�vel por retornar se o usu�rio est� logado.

J� o m�todo logout_action() � respons�vel por executar comandos para logout do sistema, e o m�todo efetuaLogin_action() � respons�vel por executar toda a verificaç�o dos campos digitados pelo usu�rio, verificando os valores com os contidos no banco de dados. Se houve �xito, � encaminhado para a p�gina principal, se n�o houver �xito ou se o usu�rio n�o existir s�o informadas mensagens de erros na tela.

Implementando o Pacote Persistence

Agora ser� implementado o pacote Persistence cujo objetivo � criar um controle consistente para a persist�ncia dos dados. Ser�o criados um novo pacote autentica.persistence e uma classe (customizadora de sess�o) com o nome de JPAEclipseLinkSessionCustomizer.java. Essa ser� programada com c�digo referente a Listagem 5 e ser� respons�vel por obter uma conex�o ao banco de dados e enviar para a sess�o a string de conex�o. Se a string j� existe � alterada para a pr�xima subsequente da lista, tornando a persist�ncia �ntegra, e se tudo ocorrer sem erros, em seguida essa string � gravada automaticamente para a execuç�o do projeto com segurança e autenticidade.


package autentica.persistence;
 
import javax.naming.Context;
import javax.naming.InitialContext;
import org.eclipse.persistence.config.SessionCustomizer;
import org.eclipse.persistence.sessions.DatabaseLogin;
import org.eclipse.persistence.sessions.JNDIConnector;
import org.eclipse.persistence.sessions.Session;
import org.eclipse.persistence.sessions.server.ServerSession;
 
public class JPAEclipseLinkSessionCustomizer
        implements SessionCustomizer {
    @Override
    public void customize(Session session) throws Exception {
        JNDIConnector connector = null;
        Context context = null;
        try {
            context = new InitialContext();
            if (null != context) {
                connector = (JNDIConnector) session.getLogin()
                .getConnector(); 
                
                connector.setLookupType(JNDIConnector.STRING_LOOKUP);
 
                JNDIConnector writeConnector = (JNDIConnector) 
                session.getLogin().getConnector();
                writeConnector.setLookupType(JNDIConnector
                .STRING_LOOKUP);
                JNDIConnector readConnector =
                        (JNDIConnector) ((DatabaseLogin) 
                        ((ServerSession) session)
                        .getReadConnectionPool()
                        .getLogin()).getConnector();
                readConnector.setLookupType(JNDIConnector
                .STRING_LOOKUP);
            } else {
                throw new 
                Exception("_JPAEclipseLinkSessionCustomizer: Context is null");
            }
        } catch (Exception e) {
        }
    }
}

Listagem 5. Classe JPAEclipseLinkSessionCustomizer.java

Para finalizar o conceito de persist�ncia que est� sendo aplicado ao projeto, ser� necess�rio criar uma nova classe com o nome de JPAManager.java e o c�digo ser� referente a Listagem 6. A classe ser� respons�vel por gerenciar a persist�ncia, nomear a unidade de persist�ncia da aplicaç�o usada para criaç�o do gerenciador da entidade e fechar o seu gerenciamento liberando as propriedades da mem�ria.


package autentica.persistence;
 
import java.io.Serializable;
import java.util.HashMap;
import java.util.Map;
import javax.persistence.EntityManagerFactory;
import javax.persistence.Persistence;
import org.eclipse.persistence.config.PersistenceUnitProperties;
 
public final class JPAManager extends Object
        implements Serializable {
 
    
    private static final String NOME_UNIDADE_PERSISTENCIA = "ExemploJPA";
    
    private transient EntityManagerFactory entityManagerFactory = null;
 
    public final EntityManagerFactory getEntityManagerFactory() {
        if (entityManagerFactory == null) {
            Map propertiesMap = new HashMap();
            propertiesMap.put(PersistenceUnitProperties
            .CACHE_SHARED_DEFAULT, "false");
            entityManagerFactory = 
            Persistence.createEntityManagerFactory
            (NOME_UNIDADE_PERSISTENCIA, propertiesMap);
        }
        return entityManagerFactory;
    }
 
    public final void closeEntityManagerFactory() {
        if (entityManagerFactory != null) {
            entityManagerFactory.close();
            entityManagerFactory = null;
        }
    }
}

Listagem 6. JPAManager.java

Definindo as P�ginas para o Usu�rio

Para finalizar o projeto, daremos in�cio ao layout das p�ginas (camada de apresentaç�o), que consistir� em uma p�gina inicial para a autenticaç�o do usu�rio e a outra p�gina para o logout.

Dentro da p�gina index.xhtml, ser� implementada o c�digo referente a Listagem 7.


<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:h="http://java.sun.com/jsf/html"
      xmlns:f="http://java.sun.com/jsf/core">
    <h:head>
        <title>Autenticaç�o de Usu�rio</title>
    </h:head>
    <h:body>
        <h1>Autenticaç�o de Usu�rio</h1>
        <h:form>
            <h:messages />
            <table>
                <tr>
                    <th>Login:</th>
                    <td>
                        <h:inputText id="txtLogin" size="10" maxlength="6"
                               value="#{loginForm.login}"
                               required="true" requiredMessage="O Login n�o foi informado!"
                               validatorMessage="Tamanho m�ximo do campo Login excedido!"
                               title="Login">
                            <f:validateLength maximum="6"/>
                        </h:inputText>
 
                    </td>
                </tr>
                <tr>
                    <th>Senha:</th>
                    <td>
                        <h:inputSecret id="txtSenha" size="10" maxlength="6"
                               value="#{loginForm.senha}"
                               required="true" requiredMessage="A senha n�o foi informada!"
                               validatorMessage="Tamanho m�ximo do campo Senha excedido!"
                               title="Senha">
                            <f:validateLength maximum="6"/>
                        </h:inputSecret>
                    </td>
                </tr>
                <tr>
                    <td colspan="2">
                        <h:commandButton id="btnEnviar" value="Entrar"
                               action="#{loginForm.efetuaLogin_action}" />
                        <h:commandButton id="btnLimpar" value="Limpar" immediate="true"
                                action="#{loginForm.limpaTelaCadastro_action}" />
                    </td>
                </tr>
            </table>
        </h:form>
 
    </h:body>
</html>

Listagem 7. P�gina index.xhtml

Esse c�digo � respons�vel por definir o layout da p�gina inicial que cont�m atributos text(s) para a inserç�o do login e senha do usu�rio contendo valores, campos requeridos, validadores de mensagens e h� o bot�o contendo o direcionamento (aç�o) para o m�todo efetuaLogin_action contido na classe loginForm.

Tamb�m existe o bot�o para o m�todo limpaTelaCadastro_action, que � respons�vel por limpar os dados do formul�rio.

Al�m disso, ser� criada uma p�gina denominada principal.xhtml que s� ser� acessada caso o usu�rio tenha feito login com sucesso, descrita na Listagem 8.


<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:h="http://java.sun.com/jsf/html">
    <h:head>
        <title>Menu</title>
    </h:head>
    <h:body>
        Menu do Sistema
        <ul>
            <li>
                <h:form>
                    <h:commandLink action="#{loginForm.logout_action()}" value="Sair"/>
                </h:form>
            </li>
        </ul>
    </h:body>
</html>

Listagem 8. Principal.xhtml

O c�digo � respons�vel por exibir ao usu�rio a p�gina principal contendo um link para que possa ser feito o logout de acordo com o m�todo logout_action() localizado na classe loginForm.

Ap�s ter finalizado, basta salvar o projeto e executar o mesmo apertando F6.

O resultado ser� um formul�rio simples de autenticaç�o mostrado em algum navegador, como mostra a Figura 2. No nosso caso abrimos usando o Mozilla Firefox.

Figura 2. Tela inicial do sistema sendo executado.

Inserindo Dados para o Banco de Dados

Para que tenham dados armazenados no banco de dados, � preciso cadastrar os mesmos. Assim, basta clicar na aba Serviços no Grupo de Menus (na maioria das vezes localizada na esquerda), de acordo com a Figura 3.

Figura 3. Banco de dados conectado em public, demonstrando que a tabela funcion�rio foi criada ap�s a execuç�o do projeto.

Agora, � s� clicar com o bot�o direito em cima da tabela funcion�rio, clicar em Exibir Dados, e pode colocar comandos de SQL para insert. Feito isso, � s� apertar Ctrl+Shift+E que executar� o comando, gravando os dados na tabela. Um exemplo de insert para a tabela funcionario se encontra no c�digo da Listagem 9.


insert into funcionario
(fun_ativo,fun_bairro,fun_endereco,fun_endereco_complemento,
fun_endereco_numero,fun_login,fun_nome,fun_senha)
values ('1','Teste','Teste','Teste','123','admin','Admin','123456')

Listagem 9. Exemplo de instruç�o SQL para inserir dados para a tabela funcionario

Finalmente, quando executar o projeto web novamente, o par�metro para o login ser� admin e para a senha 123456.

Para autenticar, basta colocar os dados que foram cadastrados na tabela anteriormente e depois clicar em Entrar.

Se a autenticaç�o n�o for correta, ent�o em seguida ser� apresentada uma mensagem de acordo com o sistema, por exemplo, se o login ou a senha n�o forem informados, como mostra a Figura 4.

Figura 4. P�gina com mensagem de erro que houve falha na autenticaç�o do sistema.

Com isso encerramos o nosso artigo. Espero que tenham gostado do assunto.

Saiu na DevMedia!

Quais os tr�s passos b�sicos para autenticaç�o?: Tornar algumas p�ginas acess�veis apenas a um grupo de usu�rios autenticados � uma tarefa trivial em aplicaç�es web. Quer saber qual a l�gica por tr�s de cada uma dessas etapas? Assista nesse DevCast!
Autenticaç�o no ASP.NET MVC: Neste curso voc� aprender� a implementar um mecanismo de autenticaç�o em aplicaç�es ASP.NET MVC.

Saiba mais sobre Java ;)

Guias de Estudo sobre Java: Encontre aqui os Guias de estudo que v�o ajudar voc� a aprofundar seu conhecimento na linguagem Java. Desde o b�sico ao mais avançado. Escolha o seu!
Programador Java: Aprender Java n�o � uma tarefa simples, mas seguindo a ordem proposta nesse Guia, voc� evitar� muitas confus�es e perdas de tempo no seu aprendizado. Vem aprender java de verdade, vem!

Sistema de Autentica��o Web utilizando JPA

Veja nesse artigo como criar um sistema de autenticação web com login e senha utilizando a tecnologia JPA e conectividade com banco de dados PostgreSQL.