Skip to content

Latest commit

 

History

History
501 lines (345 loc) · 15.7 KB

README.md

File metadata and controls

501 lines (345 loc) · 15.7 KB

Safeguard

Biblioteca java para validação de CPF, CNPJ, Inscrição Estadual, Telefone, CEP, placas de veículos, telefone e outros campos de texto. Integrado com provedores de validação e persistência.

Downloads

Maven

Faça o Clone ou use o maven adicionando a dependência no seu arquivo pom.xml.

<dependencies>
	<dependency>
		<groupId>com.github.gilmardeveloper</groupId>
		<artifactId>safeguard</artifactId>
		<version>0.0.1-RELEASE</version>
	</dependency>
</dependencies>

Como usar

  1. Validando um elemento

    String texto = "digite apenas letras ou números";
    
    Check check = new SafeguardCheck();
    
    boolean hasError = check
    			.elementOf(texto,ParametroTipo.DEFAULT_SEM_CARACTERES_ESPECIAIS)
    			.validate()
    			.hasError();
  2. Validando mais de um elemento

    String texto = "digite apenas letras ou números";
    String numeros = "1234567890";
    String cpf= "96205663279";
    
    Check check = new SafeguardCheck();
    
    boolean hasError = check
    			.elementOf(texto,ParametroTipo.DEFAULT_SEM_CARACTERES_ESPECIAIS)
    			.elementOf(numeros,ParametroTipo.NUMERO)
    			.elementOf(cpf,ParametroTipo.CPF)
    			.validate()
    			.hasError();
  3. Validando o mesmo elemento

    Obs.: Apenas opções do tipo DEFAULT devem ser usadas em um mesmo elemento, sendo distintas entre si.

    String texto = "Você pode digita apenas letras ou números";
    	
    Check check = new SafeguardCheck();
    
    boolean hasError = check
    			.elementOf(texto,ParametroTipo.DEFAULT_SEM_CARACTERES_ESPECIAIS)
    			.elementOf(texto,ParametroTipo.DEFAULT_SEM_NUMEROS)
    			.validate()
    			.hasError();
  4. Validando atributos de classe

    4.1. Anotando atributos com @Verify

    public class Empresa {
    
    @Verify(ParametroTipo.TEXTO_SEM_CARACTERES_ESPECIAIS)
    private String nome;
    @Verify(ParametroTipo.CNPJ)
    private String cnpj;
    @Verify(ParametroTipo.IE_SAO_PAULO_SP)
    private String ie;
    
    }

    4.2. Validando a instância da classe de forma manual

    Empresa empresa = new Empresa(nome, cnpj, ie);
    	
    Check check = new SafeguardCheck();
    
    boolean hasError = check.elementOf(empresa).Validate().hasError();

    4.3. Usando um provedor de validação

     4.3.1 Usando a validação do Spring MVC
     
     public void validar(@Valid Empresa empresa, BindingResult result, HttpServletResponse response) {
    
     		if(!result.hasErrors()) { 
     			//do anything
     			response.setStatus(200);
     		}else {
    
     			response.setStatus(400);
     		}
    
     }
     
     4.3.2 Usando a validação do JPA
     
     EntityManager manager = entityManagerFactory.createEntityManager();
    
     manager.persist(empresa);
    
     manager.close();
    

Métodos da interface Check

  • elementOf(Object object)

    • Método que recebe um objeto que tenha atributos da classe anotados com (@Verify) para ser adicionado em um (List) de elementos
  • elementOf(String value, BaseParam tipo)

    • Método que recebe um (String) e um (BaseParam) para ser adicionado em um (Map) de elementos
  • elementOf(String value, ParametroTipo tipo)

    • Método que recebe um (String) e um (BaseParam) para ser adicionado em um (Map) de elementos
  • getInvalidElements()

    • Método que retorna uma lista de elementos inválidos
  • getValidElements()

    • Método que retorna uma lista de elementos válidos
  • hasError()

    • Método que retorna true caso os elementos verificados sejam inválidos, false caso contrário
  • validate()

    • O método que faz a validação dos valores passados anteriormente no método elementOf(), e retorna a própria classe

Lista de Validações

/**Cadeia de caracteres que representa um documento de CPF*/
CPF

/**Cadeia de caracteres que representa um documento de CPF formatado*/
CPF_FORMATADO

/**Cadeia de caracteres que representa um documento de Titulo de Eleitor*/
TITULO_DE_ELEITOR

/**Cadeia de caracteres que representa um documento de Titulo de Eleitor formatado*/
TITULO_DE_ELEITOR_FORMATADO

/**Cadeia de caracteres que representa um documento de Número de Indentificação do Trabalhador*/
NIT

/**Cadeia de caracteres que representa um documento de Número de Indentificação do Trabalhador formatado*/
NIT_FORMATADO

/**Cadeia de caracteres que representa um CNPJ*/
CNPJ

/**Cadeia de caracteres que representa um CNPJ formatado*/
CNPJ_FORMATADO

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_ACRE_AC

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_ACRE_AC_FORMATADO

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_ALAGOAS_AL

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_ALAGOAS_AL_FORMATADO

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_AMAPA_AP

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_AMAPA_AP_FORMATADO

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_AMAZONAS_AM	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_AMAZONAS_AM_FORMATADO

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_BAHIA_BA

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_BAHIA_BA_FORMATADO

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_CEARA_CE

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_CEARA_CE_FORMATADO

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_DISTRITO_FEDERAL_DF	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_DISTRITO_FEDERAL_DF_FORMATADO

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_ESPIRITO_SANTO_ES	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_ESPIRITO_SANTO_ES_FORMATADO	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_GOIAIS_GO	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_GOIAIS_GO_FORMATADO	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_MARANHAO_MA	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_MARANHAO_MA_FORMATADO

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_MATO_GROSSO_MT

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_MATO_GROSSO_MT_FORMATADO

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_MATO_GROSSO_DO_SUL_MS

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_MATO_GROSSO_DO_SUL_MS_FORMATADO

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_MINAS_GERAIS_MG 

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_MINAS_GERAIS_MG_FORMATADO 

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_PARA_PA		

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_PARA_PA_FORMATADO	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_PARAIBA_PB	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_PARAIBA_PB_FORMATADO	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_PARARA_PR		

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_PARARA_PR_FORMATADO	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_PERNAMBUCO_PE	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_PERNAMBUCO_PE_FORMATADO	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_PIAUI_PI		

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_PIAUI_PI_FORMATADO	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_RIO_DE_JANEIRO_RJ	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_RIO_DE_JANEIRO_RJ_FORMATADO	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_RIO_GRANDE_DO_NORTE_RN

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_RIO_GRANDE_DO_NORTE_RN_FORMATADO

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_RIO_GRANDE_DO_SUL_RS	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_RIO_GRANDE_DO_SUL_RS_FORMATADO

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_RONDONIA_RO	 	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_RONDONIA_RO_FORMATADO

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_RORAIMA_RR		

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_RORAIMA_RR_FORMATADO	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_SANTA_CATARINA_SC	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_SANTA_CATARINA_SC_FORMATADO

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_SAO_PAULO_SP		

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_SAO_PAULO_SP_FORMATADO

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_SERGIPE_SE		

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_SERGIPE_SE_FORMATADO	

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_TOCANTINS_TO

/**Cadeia de caracteres que representa uma Inscrição estadual*/
IE_TOCANTINS_TO_FORMATADO
	
/**
 * Cadeia de caracteres de texto padrão, contendo caracters da tabela unicode
 * iniciando em \u0020 e terminando em \u00FC 
 */
DEFAULT	

/**Cadeia de caracteres de texto padrão sem o sinal de maior */
DEFAULT_SEM_SIMBOLO_DE_MAIOR

/**Cadeia de caracteres de texto padrão sem o sinal de menor */
DEFAULT_SEM_SIMBOLO_DE_MENOR	

/**Cadeia de caracteres de texto padrão sem o sinal de menor e maior*/
DEFAULT_SEM_SIMBOLO_DE_MENOR_E_MAIOR	

/**Cadeia de caracteres de texto padrão sem o sinal de chaves */
DEFAULT_SEM_SIMBOLO_DE_CHAVES		

/**Cadeia de caracteres de texto padrão sem o sinal de colchetes */
DEFAULT_SEM_SIMBOLO_DE_COLCHETES	

/**Cadeia de caracteres de texto padrão sem o sinal de parneteses */
DEFAULT_SEM_SIMBOLO_DE_PARENTESES	

/**Cadeia de caracteres de texto padrão sem o sinal de asterisco */
DEFAULT_SEM_SIMBOLO_DE_ASTERISCO	

/**Cadeia de caracteres de texto padrão sem o sinal de arroba */
DEFAULT_SEM_SIMBOLO_DE_ARROBA		

/**Cadeia de caracteres de texto padrão sem o sinal de hashtag */
DEFAULT_SEM_SIMBOLO_DE_HASHTAG		

/**Cadeia de caracteres de texto padrão sem o sinal de sifrão  */
DEFAULT_SEM_SIMBOLO_DE_SIFRAO		

/**Cadeia de caracteres de texto padrão sem o sinal de porcentagem */
DEFAULT_SEM_SIMBOLO_DE_PORCENTAGEM	

/**Cadeia de caracteres de texto padrão sem o sinal de trema */
DEFAULT_SEM_SIMBOLO_DE_TREMA	

/**Cadeia de caracteres de texto padrão sem o sinal de e comercial */
DEFAULT_SEM_SIMBOLO_DE_E_COMERCIAL	

/**Cadeia de caracteres de texto padrão sem o sinal de underline  */
DEFAULT_SEM_SIMBOLO_DE_UNDERLINE	

/**Cadeia de caracteres de texto padrão sem o sinal de hífem */
DEFAULT_SEM_SIMBOLO_DE_HIFEM	

/**Cadeia de caracteres de texto padrão sem o sinal de mais  */
DEFAULT_SEM_SIMBOLO_DE_MAIS	

/**Cadeia de caracteres de texto padrão sem o sinal de aspas simples */
DEFAULT_SEM_SIMBOLO_DE_ASPAS_SIMPLES	

/**Cadeia de caracteres de texto padrão sem o sinal de aspas duplas  */
DEFAULT_SEM_SIMBOLO_DE_ASPAS_DUPLA	

/**Cadeia de caracteres de texto padrão sem o sinal de ponto  */
DEFAULT_SEM_SIMBOLO_DE_PONTO		

/**Cadeia de caracteres de texto padrão sem o sinal de virgula  */
DEFAULT_SEM_SIMBOLO_DE_VIRGULA		

/**Cadeia de caracteres de texto padrão sem o sinal de dois pontos */
DEFAULT_SEM_SIMBOLO_DE_DOIS_PONTOS	

/**Cadeia de caracteres de texto padrão sem o sinal de ponto e virgula */
DEFAULT_SEM_SIMBOLO_DE_PONTO_E_VIRGULA	

/**Cadeia de caracteres de texto padrão sem o sinal de exclamação */
DEFAULT_SEM_SIMBOLO_DE_PONTO_DE_EXCLAMACAO

/**Cadeia de caracteres de texto padrão sem o sinal de interrogação */
DEFAULT_SEM_SIMBOLO_DE_PONTO_DE_INTERROGACAO

/**Cadeia de caracteres de texto padrão sem pontuação */
DEFAULT_SEM_PONTUACAO			

/**Cadeia de caracteres de texto padrão sem números */
DEFAULT_SEM_NUMEROS			

/**Cadeia de caracteres de texto padrão sem sinais matemáticos */
DEFAULT_SEM_SINAIS_MATEMATICOS		

/**Cadeia de caracteres de texto padrão sem caracteres especiais */
DEFAULT_SEM_CARACTERES_ESPECIAIS	
	
/**Cadeia de caracteres apenas com texto, sem númeors ou caracteres especiais*/
TEXTO_SEM_CARACTERES_ESPECIAIS			

/**Cadeia de caracteres apenas com texto e hífem, sem númeors ou caracteres especiais*/
TEXTO_SEM_CARACTERES_ESPECIAIS_COM_HIFEM	

/**Cadeia de caracteres apenas com texto e underline, sem númeors ou caracteres especiais*/
TEXTO_SEM_CARACTERES_ESPECIAIS_COM_UNDERLINE	

/**Cadeia de caracteres apenas com texto e virgula, sem númeors ou caracteres especiais*/
TEXTO_SEM_CARACTERES_ESPECIAIS_COM_VIRGULA		

/**Cadeia de caracteres apenas com texto e pontuação, sem númeors ou caracteres especiais*/
TEXTO_SEM_CARACTERES_ESPECIAIS_COM_PONTUACAO		

/**Cadeia de caracteres apenas com texto, pontuação, hífem e underline, sem númeors ou caracteres especiais*/
TEXTO_SEM_CARACTERES_ESPECIAIS_COM_PONTUACAO_HIFEM_UNDERLINE

/**Cadeia de caracteres com texto e número, sem caracteres especiais*/
TEXTO_NUMERO_SEM_CARACTERES_ESPECIAIS		

/**Cadeia de caracteres com texto, números e hífem, sem caracteres especiais*/
TEXTO_NUMERO_SEM_CARACTERES_ESPECIAIS_COM_HIFEM		

/**Cadeia de caracteres com texto, números e underline, sem caracteres especiais*/
TEXTO_NUMERO_SEM_CARACTERES_ESPECIAIS_COM_UNDERLINE		

/**Cadeia de caracteres com texto, números e virgula, sem caracteres especiais*/
TEXTO_NUMERO_SEM_CARACTERES_ESPECIAIS_COM_VIRGULA		

/**Cadeia de caracteres com texto, números e pontuação, sem caracteres especiais*/
TEXTO_NUMERO_SEM_CARACTERES_ESPECIAIS_COM_PONTUACAO		

/**Cadeia de caracteres com texto, números, pontuação, hífem e underline, sem caracteres especiais*/
TEXTO_NUMERO_SEM_CARACTERES_ESPECIAIS_COM_PONTUACAO_HIFEM_UNDERLINE

/**Cadeia de caracteres com texto, números, virgula, hífem e underline, sem caracteres especiais*/
TEXTO_NUMERO_VIRGULA_HIFEM_UNDERLINE_SEM_PONTUACAO		

/**Cadeia de caracteres contendo apenas números*/
NUMERO					

/**Cadeia de caracteres que representa um email*/
EMAIL						

/**Cadeia de caracteres que representa um CEP*/
CEP					

/**Cadeia de caracteres que representa um CEP formatado*/
CEP_FORMATADO															
/**Cadeia de caracteres que representa uma placa de veículo*/
PLACA_DE_VEICULO_BRASIL			

/**Cadeia de caracteres que representa uma placa de veículo formatado*/
PLACA_DE_VEICULO_FORMATADO_BRASIL		

/**
 * Cadeia de caracteres que representa um telefone fixo ou móvel com ou sem número da operadora, DD + NÚMERO
 * 
 * Exemplos:
 * Com número da operadora  01211988774455, obs.: O dígito 9 pode ser omitido para telefones fixos 1133445566 
 * Sem o número da operadora  11988774455
 */
TELEFONE																

/**
 * Cadeia de caracteres que representa um telefone fixo ou móvel com ou sem número da operadora, DD + NÚMERO formatado
 * 
 * Exemplos:
 * Com número da operadora 012(11)98877-4455, obs.: O dígito 9 pode ser omitido para telefones fixos (11)3344-5566
 * Sem o número da operadora  (11)98877-4455
 */
TELEFONE_FORMATADO_BRASIL	

/**
 * Cadeia de caracteres que representa um telefone fixo ou móvel com o número do país, DD + NÚMERO formatado
 * 
 * Exemplos:
 * Formato internacional: +55 11 98877-4455, obs.: O dígito 9 pode ser omitido para telefones fixos +55 11 3344-5566
 */
TELEFONE_FORMATADO_INTERNACIONAL

© 2017 Gilmar Carlos All rights reserved.