O commons code nada mais é do que o Usuario, seguido de dois pontos + a senha. Codifica em 64 bits. Essa sequencia de palavra é seguida de Basic e espaço entre a palavra Basic e o token. Ex: Basic ZW1haWxAZ9hGosluY

Os filtros (15 filtros) são responsáveis por trancar a aplicação, e a partir da implemenntação você seleciona quais de fato serão utilizados na app do blog pessoal. 

<dependency>
 <groupId>commons-codec</groupId>
 <artifactId>commons-codec</artifactId>
</dependency> 

____________________________________
Criptografar Senha.

Se o Usuário não existir no Banco de Dados, a senha será criptografada através do Método criptografarSenha.

EX:
    usuario.setSenha(criptografarSenha(usuario.getSenha()));

Assim como na Expressão Lambda, o resultado do método save será retornado dentro de um Optional, com o Usuario persistido no Banco de Dados.

of​ -> Retorna um Optional com o valor fornecido, mas o valor não pode ser nulo.  Se não tiver certeza de que o valor não é nulo use ofNullable.

EX.:
     return Optional.of(usuarioRepository.save(usuario));
     }
____________________________________ 

Atualizar Usuário

Checa se o usuário já existe no Banco de Dados através do método findById, porquê não é possíve atualizar 1 usuário inexistente.
Se não existir retorna um Optional vazio.

isPresent() -> Se um valor estiver presente retorna true, caso contrário retorna false.

EX.:
  public Optional<Usuario> atualizarUsuario(Usuario usuario) {

    if(usuarioRepository.findById(usuario.getId()).isPresent())
    {

Cria um Objeto Optional com o resultado do método findById

EX.:
     Optional<Usuario> buscaUsuario =      usuarioRepository.findByUsuario(usuario.getUsuario());


Se o Usuário existir no Banco de dados e o Id do Usuário encontrado no Banco for diferente do usuário do Id do Usuário enviado na requisição, a Atualização dos dados do Usuário não pode ser realizada.

EX.:
     if ( (buscaUsuario.isPresent()) && (  buscaUsuario.get().getId() != usuario.getId()))
throw new ResponseStatusException(
     HttpStatus.BAD_REQUEST, "Usuário já existe!", null);

Se o Usuário existir no Banco de Dados e o Id for o mesmo, a senha será criptografada através do Método criptografarSenha.

EX.:
    usuario.setSenha(criptografarSenha(usuario.getSenha()));

Assim como na Expressão Lambda, o resultado do método save será retornado dentro de um Optional, com o Usuario persistido no Banco de Dados ou um Optional vazio, caso aconteça algum erro.

ofNullable​ -> Se um valor estiver presente, retorna um Optional com o valor,  caso contrário, retorna um Optional vazio.

EX.:
     return Optional.
     ofNullable(usuarioRepository.save(usuario))
     }

empty -> Retorna uma instância de Optional vazia, caso o usuário não seja encontrado.

EX.:
     return Optional.empty();

} 
____________________________________  

____________________________________

Autenticar Usuario

A principal função do método autenticarUsuario, que é executado no endpoint logar, é gerar o token do usuário codificado em Base64. O login prorpiamente dito é executado pela BasicSecurityConfig em conjunto com as classes UserDetailsService e Userdetails

EX.:
     public Optional<UsuarioLogin>  autenticarUsuario(Optional<UsuarioLogin> usuarioLogin) {

Cria um objeto Optional do tipo Usuario para receber o resultado do método findByUsuario().

Observe que o método autenticarUsuario recebe como parâmetro um objeto da Classe UsuarioLogin, ao invés de Usuario.

get() -> Se um valor estiver presente no objeto ele retorna o valor, caso contrário lança uma Exception NoSuchElementException. Então para usar get é preciso ter certeza de que o Optional não está vazio.
O get() funciona como uma chave que abre o Objeto Optional e permite acessar os Métodos do Objeto encpsulado.

EX.:
      Optional<Usuario> usuario = usuarioRepository.findByUsuario(usuarioLogin.get().getUsuario());

Checa se o usuario existe

EX.:
     if (usuario.isPresent()) {

Checa se a senha enviada, depois de criptografada, é igual a senha gravada no Banco de Dados, através do Método compararSenhas.

O Método Retorna verdadeiro se as senhas forem iguais, e falso caso contrário.

EX.:
     if (compararSenhas(usuarioLogin.get().getSenha(),  usuario.get().getSenha())) {

Se as senhas forem iguais, atualiza o objeto usuarioLogin com os dados recuperados do Banco de Dados e insere o Token Gerado através do Método gerarBasicToken.
Desta forma, será possível exibir o nome e a foto do usuário no Frontend.

EX.:
     usuarioLogin.get().setId(usuario.get().getId());
     usuarioLogin.get().setNome(usuario.get().getNome());
     usuarioLogin.get().setFoto(usuario.get().getFoto());
usuarioLogin.get().setToken(gerarBasicToken(usuarioLogin.get().getUsuario(), usuarioLogin.get().getSenha()));
      usuarioLogin.get().setSenha(usuario.get().getSenha());

Retorna o objeto usarioLogin atualizado para a classe UsuarioController.
A Classe controladora checará se deu tudo certo nesta operação e retornará o status.

EX.:
     return usuarioLogin;

         }
    }

empty -> Retorna uma instância de Optional vazia, caso o usuário não seja encontrado.

EX.:
     return Optional.empty();

}

____________________________________ 

____________________________________

Método Criptografar Senhas.

Instancia um objeto da Classe BCryptPasswordEncoder para criptografar a senha do usuário.

O método encode retorna a senha criptografada no formato BCrypt. Para mais detalhes, consulte a documentação do BCryptPasswordEncoder.

EX.:
     private String criptografarSenha(String senha) {

        BCryptPasswordEncoder encoder = new   BCryptPasswordEncoder();
      return encoder.encode(senha);
 }

____________________________________

Método Comparar Senhas.

Checa se a senha enviada, depois de criptografada, é igual a senha gravada no Banco de Dados.

Instancia um objeto da Classe BCryptPasswordEncoder para comparar a senha do usuário com a senha gravad no Banco de dados.

matches -> Verifca se a senha codificada obtida do banco de dados corresponde à senha enviada depois que ela também for codificada. Retorna verdadeiro se as
senhas coincidem e falso se não coincidem.

EX.:
     private boolean compararSenhas(String senhaDigitada, String senhaBanco) {
     BCryptPasswordEncoder encoder = new BCryptPasswordEncoder();
     return encoder.matches(senhaDigitada, senhaBanco);
}

____________________________________

Método Gerar Basic Token

A primeira linha, monta uma String (token) seguindo o padrão Basic, através  da concatenação de caracteres que será codificada (Não criptografada) no formato Base64, através da Dependência Apache Commons Codec.

Essa String tem o formato padrão: <username>:<password> que não pode ser alterado

Na segunda linha, faremos a codificação em Base 64 da String.

Observe que o vetor tokenBase64 é do tipo Byte para receber o resultado da codificação, porquê durante o processo é necessário trabalhar diretamente com os bits (0 e 1) da String

Base64.encodeBase64 -> aplica o algoritmo de codificação do Código Decimal para Base64, que foi gerado no próximo método. Para mais detalhes, veja Codificação 64 bits na
Documentação.

Charset.forName("US-ASCII") -> Retorna o codigo ASCII (formato Decimal) de cada caractere da String. Para mais detalhes, veja a Tabela ASCII na Documentação.

Na terceira linha, acrescenta a palavra Basic acompanhada de um espaço em branco (Obrigatório), além de converter o vetor de Bytes novamente em String e concatenar tudo em uma única String.

O espaço depois da palavra Basic é obrigatório. Caso não seja inserrido, o Token não será reconhecido.

EX.:
private String gerarBasicToken(String usuario, String senha) {
    String token = usuario + ":" + senha;
     byte[] tokenBase64 = Base64.encodeBase64(token.getBytes(Charset.forName("US-ASCII")));
     return "Basic " + new String(tokenBase64);
       }
}