JarCastingcaptcha-logico
API para implementação de um Captcha com perguntas lógicas em português, ao invés de imagens e textos. Isso possibilita a implementação de acessibilidade e melhora a usabilidade do sistema. Será criado em tela uma questão com 4 respostas objetivas, a ser selecionado somente 1 correta.
É utilizado um banco de dados leve interno (hsqldb memory) para retornar a pergunta e as respostas. As perguntas são carregadas uma única vez neste banco, quando o servidor de aplicação sobe.
Os fontes foram propositadamente escrito e voltado para português BR.
Quantidade de perguntas diferentes cadastradas: 20.
Encoding: UTF-8.
Página: http://jopss.github.io/captcha-logico/
Licença
O projeto foi concebido na licença Mozilla 2.0, ou seja, pode-se utilizar o jar em qualquer projeto, comercial ou não. Mas alterações na API devem ser obrigatoriamente disponibilizada na mesma licença.
É OpenSource, e como tal, qualquer um pode melhorar o código, corrigindo ou adicionando novas funcionalidades. Basta dar um fork neste repo.
Maven
Está publicado no Maven Central. Então basta configurar a dependência conforme abaixo.
<dependency>
<groupId>com.jopss</groupId>
<artifactId>captcha-logico</artifactId>
<version>1.0</version>
</dependency>
Uso
Para utilizar o Captcha Logico na sua aplicação, basta configurar a dependência maven no seu projeto, utilizar a classe "CaptchaLogico" para carregar, criar as perguntas e referenciar a tag html na página web.
Controlador/Serviço
No seu controlador ou serviço web você deve carregar uma pergunta e as respostas na requisição:
CaptchaLogico.carregar(session, request).criarNovaPerguntaRespostas();
Isso irá fazer com que guarde o valor real da resposta em sessão no servidor, e retorna parâmetros da requisição (escopo de Request) com os valores da pergunta e respostas. Ao retornar no submit da sua página, verifique a resposta digitada com o valor guardado na sessão com:
CaptchaLogico.carregar(session, request).validarRespostaUsuario( form.getRespostaUsuario() );
Este métod é 'void', e caso a resposta estiver errada, lancará uma 'CaptchaLogicoException' (checked exception). Assim você poderá tratar o erro conforme o seu caso.
Ao retornar do submit (controlador para a página), lembre-se de recarregar os dados da requisição com novas perguntas.
HTML/JSP
Em tela deve criar referenciar o diretorio de tags da API no cabeçalho na página:
<%@ taglib prefix="cp-componentes" tagdir="/WEB-INF/tags/cp-componentes"%>
E em sua página, posicionar a tag que ira exibir as perguntas:
<cp-componentes:captcha-logico nameRadiosRespostas="respostaCaptcha" />
O HTML gerado não irá conter nenhum tipo de CSS ou estilo. Cabe a cada projeto gerar o layout adequado. Os parâmetros possíveis para esta tag são:
- nameRadiosRespostas: Atributo a ser inserido no 'name' de todos os radios de respostas. Normalmente ele deve referenciar algum atributo do 'backend bean' do formulario a receber o valor da resposta selecionada.
- classDivConteudo: Classe CSS para estilizacao do div content. Este div esta em volta de todos os componentes.
- classPergunta: Classe CSS para o paragrado (p) da pergunta.
- classSpanRespostas: Classe CSS para o span das respostas. Dentro deste estarão os radios com as respostas.
Status
Finalizado primeira release. Em manutenção.