amap-captcha

Última modificación por Administrator el 2019/11/04 12:19

amap-captcha 1.0.4 2016/3/03

Mejorada la compatibilidad con JBoss.

amap-captcha 1.0.3 2016/1/27

Modificada la generación de imágenes por motivos de legibilidad.

amap-captcha 1.0.2 2014/12/03

Modificada la generación de imágenes por motivos de legibilidad.
Modificaciones en el taglib para mejorar la integración con diferentes entornos.

amap-captcha 1.0.1 2014/11/05

Soporte de audio castellano.

amap-captcha 1.0.0 2014/10/28

Primera versión del componente.

<dependency>
<groupId>es.gobcantabria.amap.utilidades</groupId>
<artifactId>amap-captcha</artifactId>
<version>1.0.4</version>
</dependency>

N/A

Sin recursos disponibles.

Configuración

Configuración del servidor de JBoss

Para desplegar el componente en un servidor JBoss, es necesario incorporar en el jboss-deployment-structure.xml el path "com/sun/media/sound" :

<jboss-deployment-structure>
       <deployment>
              <dependencies>
             ...
               <system export="true">
                   <paths>
                       <path name="com/sun/media/sound"/>
                   </paths>
               </system>
             ...
             </dependencies>
       </deployment>
</jboss-deployment-structure>

Configuración de la aplicación (opcional)

Si se va a utilizar el taglib, es necesario modificar el descriptor de la aplicación web (web.xml), añadiendo tanto los servlets como el mapeo:

Añadir servlets a web.xml

<servlet>
 <servlet-name>amap-imagen-captcha</servlet-name>
 <servlet-class>es.gobcantabria.utilidades.amapcaptcha.web.servlet.AmapImagenCaptchaServlet</servlet-class>
</servlet>
 
<servlet-mapping>
 <servlet-name>amap-imagen-captcha</servlet-name>
 <url-pattern>/captcha.png</url-pattern>
</servlet-mapping>
 
<servlet>
 <servlet-name>amap-audio-captcha</servlet-name>
 <servlet-class>es.gobcantabria.utilidades.amapcaptcha.web.servlet.AmapAudioCaptchaServlet</servlet-class>
</servlet>
 
<servlet-mapping>
 <servlet-name>amap-audio-captcha</servlet-name>
 <url-pattern>/captcha.wav</url-pattern>
</servlet-mapping>

N/A

Nombreamap-captcha
Identificadoramap-captcha
Grupoes.gobcantabria.amap.utilidades
Versión1.0.4
Licencia
DesarrolladorGobierno de Cantabria
Descripción

Utilidad para la generación de captchas

Documentaciónamap-captcha (JavaDoc)
Binarioamap-captcha (Jar)

N/A

Ejemplos de uso

Uso del componente como servicio

 

Este es el uso recomendado fuera de entornos web, para entornos web, usar el método descrito más abajo.

// Creación del servicio.
AmapCaptchaServiceInterface amapCaptchaService = AmapCaptchaServiceFactory.getServicio();

// Generación de una imagen captcha.
Image imagen = amapCaptchaService.generarImagen();

// Generación del audio para el captcha.
byte[] wav = amapCaptchaService.generarAudio(FormatoAudio.WAV);
byte[] mp3 = amapCaptchaService.generarAudio(FormatoAudio.MP3);
byte[] ogg = amapCaptchaService.generarAudio(FormatoAudio.OGG);

// Regeneración de la imagen y el audio, en caso de ser ilegible.
amapCaptchaService.regenerarCaptcha();
imagen = amapCaptchaService.generarImagen();
wav = amapCaptchaService.generarAudio(FormatoAudio.WAV);
...

Uso del componente en entorno Web

Para el uso en entorno web, se proporciona un taglib que contiene un solo tag que genera imagen y audio.

<%@ taglib prefix="captcha" uri="amapcaptcha"%>

...

<captcha:amapcaptcha />

...

Los atributos disponibles, así como su valor por defecto aparecen a continuación:


#URL de la imagen, el valor por defecto es adecuado si no se modifica el mapeo de los servlets descrito en el apartado de Configuración.
urlImagen = "captcha.png"

#URL del audio, el valor por defecto es adecuado si no se modifica el mapeo de los servlets descrito en el apartado de Configuración.
urlAudio = "captcha.wav"

#clase css que se aplica al divisor que contiene el captcha.
divClass = ""

#clase css que se aplica a la caja de texto que contiene la respuesta al captcha.
inputClass = ""

#determina si se debe mostar o no el botón de recarga.
mostrarBotonRecargar = "true"

#determina si se debe mostar o no el botón de reproducir el audio.
mostrarBotonAudio = "true"

#alto de la imagen generada.
altoImagen = "100"

#ancho de la imagen generada.
anchoImagen = "200"

#URL de la imagen a usar para el botón recargar.
urlBotonRecargar = ""

#URL de la imagen a usar para el botón de reproducción de audio.
urlBotonAudio = ""

#Estilo a aplicar al botón para recargar el captcha, el valor por defecto es el estilo para botones del arquetipo.
classBotonRecargar = "btn btn-primary"

#Estilo a aplicar al botón para oir el captcha, el valor por defecto es el estilo para botones del arquetipo.
classBotonAudio = "btn btn-primary"

#Texto para el botón de recargar, si se especificase una imagen, se usaría para el "alt".
textoBotonRecargar = "Recargar Captcha"

#Texto para el botón de audio, si se especificase una imagen, se usaría para el "alt".
textoBotonAudio = "O&iacute;r Captcha"

#Texto que se incluye en el label que precede al textbox de respuesta.
textoLabelRespuesta = "Respuesta"

© 2014 GOBIERNO DE CANTABRIA - AVISO LEGAL Y PROTECCIÓN DE DATOS