com.nappin.play.recaptcha

RecaptchaVerifier

Related Docs: object RecaptchaVerifier | package recaptcha

class RecaptchaVerifier extends AnyRef

Verifies whether a recaptcha response is valid, by invoking the Google Recaptcha verify web service.

Follows the API documented at Verify Without Plugins.

The package private constructor allows injection of dependencies (e.g. for unit testing), the no-arguments public constructor is for production use.

Linear Supertypes
AnyRef, Any
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. RecaptchaVerifier
  2. AnyRef
  3. Any
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Instance Constructors

  1. new RecaptchaVerifier()

    Constructor for production use.

Value Members

  1. final def !=(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  4. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  5. def bindFromRequestAndVerify[T](form: Form[T])(implicit request: Request[AnyContent], context: ExecutionContext): Future[Form[T]]

    High level API (using Play forms).

    High level API (using Play forms).

    Binds form data from the request, and if valid then verifies the recaptcha response, by invoking the Google Recaptcha verify web service (API v1 or v2) in a reactive manner. Possible errors include:

    • Binding error (form validation, regardless of recaptcha)
    • Recaptcha response missing (end user didn't enter it)
    • Recpatcha response incorrect
    • Error invoking the recaptcha service

    Apart from generic binding error, the recaptcha errors are populated against the artificial form field key formErrorKey, handled by the recaptcha view template tags.

    form

    The form

    request

    Implicit - The current web request

    context

    Implicit - The execution context used for futures

    returns

    A future that will be the form to use, either populated with an error or success

    Exceptions thrown

    IllegalStateException Developer errors that shouldn't happen - Plugin not present or not enabled, no recaptcha challenge, or muliple challenges or responses found

  6. def clone(): AnyRef

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  7. final def eq(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  8. def equals(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  9. def finalize(): Unit

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  10. final def getClass(): Class[_]

    Definition Classes
    AnyRef → Any
  11. def hashCode(): Int

    Definition Classes
    AnyRef → Any
  12. final def isInstanceOf[T0]: Boolean

    Definition Classes
    Any
  13. val logger: Logger

  14. final def ne(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  15. final def notify(): Unit

    Definition Classes
    AnyRef
  16. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  17. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef
  18. def toString(): String

    Definition Classes
    AnyRef → Any
  19. def verifyV1(challenge: String, response: String, remoteIp: String)(implicit context: ExecutionContext): Future[Either[Error, Success]]

    Low level API (independent of Play form and request APIs).

    Low level API (independent of Play form and request APIs).

    Verifies whether a recaptcha response is valid, by invoking the Google Recaptcha API version 1 verify web service in a reactive manner.

    challenge

    The recaptcha challenge

    response

    The recaptcha response, to verify

    remoteIp

    The IP address of the end user

    context

    Implicit - The execution context used for futures

    returns

    A future that will be either an Error (with a code) or Success

    Exceptions thrown

    IllegalStateException Developer errors that shouldn't happen - Plugin not present or not enabled

  20. def verifyV2(response: String, remoteIp: String)(implicit context: ExecutionContext): Future[Either[Error, Success]]

    Low level API (independent of Play form and request APIs).

    Low level API (independent of Play form and request APIs).

    Verifies whether a recaptcha response is valid, by invoking the Google Recaptcha API version 2 verify web service in a reactive manner.

    response

    The recaptcha response, to verify

    remoteIp

    The IP address of the end user

    context

    Implicit - The execution context used for futures

    returns

    A future that will be either an Error (with a code) or Success

    Exceptions thrown

    IllegalStateException Developer errors that shouldn't happen - Plugin not present or not enabled

  21. final def wait(): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  22. final def wait(arg0: Long, arg1: Int): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  23. final def wait(arg0: Long): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Inherited from AnyRef

Inherited from Any

Ungrouped