Trait/Object

play.api.mvc

PlayBodyParsers

Related Docs: object PlayBodyParsers | package mvc

Permalink

trait PlayBodyParsers extends BodyParserUtils

Body parsers officially supported by Play (i.e. built-in to Play)

DO NOT EXTEND this trait in user or library code. It is intended only to represent Play's built-in body parsers. We may add methods here in the future, which may break binary compatibility for Scala 2.11 code.

Source
BodyParsers.scala
Linear Supertypes
BodyParserUtils, AnyRef, Any
Known Subclasses
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. PlayBodyParsers
  2. BodyParserUtils
  3. AnyRef
  4. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Value Members

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

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

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

    Permalink
    Definition Classes
    AnyRef → Any
  4. def DefaultMaxDiskLength: Long

    Permalink

    Default max length allowed for disk based body.

    Default max length allowed for disk based body.

    You can configure it in application.conf:

    play.http.parser.maxDiskBuffer = 512k
  5. def DefaultMaxTextLength: Int

    Permalink

    Default max length allowed for text based body.

    Default max length allowed for text based body.

    You can configure it in application.conf:

    play.http.parser.maxMemoryBuffer = 512k
  6. val UNLIMITED: Long

    Permalink

    Unlimited size.

  7. def anyContent(maxLength: Option[Long]): BodyParser[AnyContent]

    Permalink

    Guess the body content by checking the Content-Type header.

  8. def anyContent: BodyParser[AnyContent]

    Permalink

    Guess the body content by checking the Content-Type header.

  9. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  10. def byteString: BodyParser[ByteString]

    Permalink

    Buffer the body as a simple akka.util.ByteString.

    Buffer the body as a simple akka.util.ByteString.

    Will buffer up to the configured max memory buffer amount, after which point, it will return an EntityTooLarge HTTP response.

  11. def byteString(maxLength: Int): BodyParser[ByteString]

    Permalink

    Buffer the body as a simple akka.util.ByteString.

    Buffer the body as a simple akka.util.ByteString.

    maxLength

    Max length (in bytes) allowed or returns EntityTooLarge HTTP response.

  12. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  13. def createBadResult(msg: String, statusCode: Int = BAD_REQUEST): (RequestHeader) ⇒ Future[Result]

    Permalink
    Attributes
    protected
  14. def default(maxLength: Option[Long]): BodyParser[AnyContent]

    Permalink

    If the request has a body, parse the body content by checking the Content-Type header.

  15. def default: BodyParser[AnyContent]

    Permalink

    If the request has a body, parse the body content by checking the Content-Type header.

  16. def defaultBodyParser: BodyParser[AnyContent]

    Permalink
  17. def empty: BodyParser[Unit]

    Permalink

    Don't parse the body content.

    Don't parse the body content.

    Definition Classes
    BodyParserUtils
  18. final def eq(arg0: AnyRef): Boolean

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

    Permalink
    Definition Classes
    AnyRef → Any
  20. def error[A](result: Future[Result]): BodyParser[A]

    Permalink

    A body parser that always returns an error.

    A body parser that always returns an error.

    Definition Classes
    BodyParserUtils
  21. def file(to: File): BodyParser[File]

    Permalink

    Store the body content into a file.

    Store the body content into a file.

    to

    The file used to store the content.

  22. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  23. def flatten[A](underlying: Future[BodyParser[A]])(implicit ec: ExecutionContext, mat: Materializer): BodyParser[A]

    Permalink

    A body parser that flattens a future BodyParser.

    A body parser that flattens a future BodyParser.

    Definition Classes
    BodyParserUtils
  24. def form[A](form: Form[A], maxLength: Option[Long] = None, onErrors: (Form[A]) ⇒ Result = ...): BodyParser[A]

    Permalink

    Parse the body and binds it to a given form model.

    Parse the body and binds it to a given form model.

    case class User(name: String)
    
    val userForm: Form[User] = Form(mapping("name" -> nonEmptyText)(User.apply)(User.unapply))
    
    Action(parse.form(userForm)) { request =>
      Ok(s"Hello, ${request.body.name}!")
    }
    form

    Form model

    maxLength

    Max length (in bytes) allowed or returns EntityTooLarge HTTP response. If None, the default play.http.parser.maxMemoryBuffer configuration value is used.

    onErrors

    The result to reply in case of errors during the form binding process

  25. def formUrlEncoded: BodyParser[Map[String, Seq[String]]]

    Permalink

    Parse the body as form url encoded if the Content-Type is application/x-www-form-urlencoded.

  26. def formUrlEncoded(maxLength: Int): BodyParser[Map[String, Seq[String]]]

    Permalink

    Parse the body as form url encoded if the Content-Type is application/x-www-form-urlencoded.

    Parse the body as form url encoded if the Content-Type is application/x-www-form-urlencoded.

    maxLength

    Max length (in bytes) allowed or returns EntityTooLarge HTTP response.

  27. final def getClass(): Class[_]

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

    Permalink
    Definition Classes
    AnyRef → Any
  29. def ignore[A](body: A): BodyParser[A]

    Permalink
    Definition Classes
    BodyParserUtils
  30. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  31. def json[A](implicit reader: Reads[A]): BodyParser[A]

    Permalink

    Parse the body as Json if the Content-Type is text/json or application/json, validating the result with the Json reader.

    Parse the body as Json if the Content-Type is text/json or application/json, validating the result with the Json reader.

    A

    the type to read and validate from the body.

    reader

    a Json reader for type A.

  32. def json: BodyParser[JsValue]

    Permalink

    Parse the body as Json if the Content-Type is text/json or application/json.

  33. def json(maxLength: Int): BodyParser[JsValue]

    Permalink

    Parse the body as Json if the Content-Type is text/json or application/json.

    Parse the body as Json if the Content-Type is text/json or application/json.

    maxLength

    Max length (in bytes) allowed or returns EntityTooLarge HTTP response.

  34. def maxLength[A](maxLength: Long, parser: BodyParser[A])(implicit mat: Materializer): BodyParser[Either[MaxSizeExceeded, A]]

    Permalink

    Wrap an existing BodyParser with a maxLength constraints.

    Wrap an existing BodyParser with a maxLength constraints.

    maxLength

    The max length allowed

    parser

    The BodyParser to wrap

    Definition Classes
    BodyParserUtils
  35. def multipartFormData[A](filePartHandler: FilePartHandler[A], maxLength: Long = DefaultMaxDiskLength): BodyParser[MultipartFormData[A]]

    Permalink

    Parse the content as multipart/form-data

    Parse the content as multipart/form-data

    filePartHandler

    Handles file parts.

    maxLength

    Max length (in bytes) allowed or returns EntityTooLarge HTTP response.

    See also

    Results.EntityTooLarge

    DefaultMaxDiskLength

  36. def multipartFormData(maxLength: Long): BodyParser[MultipartFormData[TemporaryFile]]

    Permalink

    Parse the content as multipart/form-data

    Parse the content as multipart/form-data

    maxLength

    Max length (in bytes) allowed or returns EntityTooLarge HTTP response.

  37. def multipartFormData: BodyParser[MultipartFormData[TemporaryFile]]

    Permalink

    Parse the content as multipart/form-data

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

    Permalink
    Definition Classes
    AnyRef
  39. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
  40. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
  41. def raw: BodyParser[RawBuffer]

    Permalink

    Store the body content in a RawBuffer.

  42. def raw(memoryThreshold: Int = DefaultMaxTextLength, maxLength: Long = DefaultMaxDiskLength): BodyParser[RawBuffer]

    Permalink

    Store the body content in a RawBuffer.

    Store the body content in a RawBuffer.

    memoryThreshold

    If the content size is bigger than this limit, the content is stored as file.

    See also

    Results.EntityTooLarge

    DefaultMaxDiskLength

  43. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  44. def temporaryFile: BodyParser[TemporaryFile]

    Permalink

    Store the body content into a temporary file.

  45. def text: BodyParser[String]

    Permalink

    Parse the body as text if the Content-Type is text/plain.

  46. def text(maxLength: Int): BodyParser[String]

    Permalink

    Parse the body as text if the Content-Type is text/plain.

    Parse the body as text if the Content-Type is text/plain.

    maxLength

    Max length (in bytes) allowed or returns EntityTooLarge HTTP response.

  47. def toString(): String

    Permalink
    Definition Classes
    AnyRef → Any
  48. def tolerantBodyParser[A](name: String, maxLength: Long, errorMessage: String)(parser: (RequestHeader, ByteString) ⇒ A): BodyParser[A]

    Permalink

    Create a body parser that uses the given parser and enforces the given max length.

    Create a body parser that uses the given parser and enforces the given max length.

    name

    The name of the body parser.

    maxLength

    The maximum length of the body to buffer.

    errorMessage

    The error message to prepend to the exception message if an error was encountered.

    parser

    The parser.

    Attributes
    protected
  49. def tolerantFormUrlEncoded: BodyParser[Map[String, Seq[String]]]

    Permalink

    Parse the body as form url encoded without checking the Content-Type.

  50. def tolerantFormUrlEncoded(maxLength: Int): BodyParser[Map[String, Seq[String]]]

    Permalink

    Parse the body as Form url encoded without checking the Content-Type.

    Parse the body as Form url encoded without checking the Content-Type.

    maxLength

    Max length (in bytes) allowed or returns EntityTooLarge HTTP response.

  51. def tolerantJson: BodyParser[JsValue]

    Permalink

    Parse the body as Json without checking the Content-Type.

  52. def tolerantJson(maxLength: Int): BodyParser[JsValue]

    Permalink

    Parse the body as Json without checking the Content-Type.

    Parse the body as Json without checking the Content-Type.

    maxLength

    Max length (in bytes) allowed or returns EntityTooLarge HTTP response.

  53. def tolerantText: BodyParser[String]

    Permalink

    Parse the body as text without checking the Content-Type.

  54. def tolerantText(maxLength: Long): BodyParser[String]

    Permalink

    Parse the body as text without checking the Content-Type.

    Parse the body as text without checking the Content-Type.

    maxLength

    Max length (in bytes) allowed or returns EntityTooLarge HTTP response.

  55. def tolerantXml: BodyParser[NodeSeq]

    Permalink

    Parse the body as Xml without checking the Content-Type.

  56. def tolerantXml(maxLength: Int): BodyParser[NodeSeq]

    Permalink

    Parse the body as Xml without checking the Content-Type.

    Parse the body as Xml without checking the Content-Type.

    maxLength

    Max length (in bytes) allowed or returns EntityTooLarge HTTP response.

  57. def using[A](f: (RequestHeader) ⇒ BodyParser[A]): BodyParser[A]

    Permalink

    Allows to choose the right BodyParser parser to use by examining the request headers.

    Allows to choose the right BodyParser parser to use by examining the request headers.

    Definition Classes
    BodyParserUtils
  58. final def wait(): Unit

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

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

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  61. def when[A](predicate: (RequestHeader) ⇒ Boolean, parser: BodyParser[A], badResult: (RequestHeader) ⇒ Future[Result]): BodyParser[A]

    Permalink

    Creates a conditional BodyParser.

    Creates a conditional BodyParser.

    Definition Classes
    BodyParserUtils
  62. def xml: BodyParser[NodeSeq]

    Permalink

    Parse the body as Xml if the Content-Type is application/xml, text/xml or application/XXX+xml.

  63. def xml(maxLength: Int): BodyParser[NodeSeq]

    Permalink

    Parse the body as Xml if the Content-Type is application/xml, text/xml or application/XXX+xml.

    Parse the body as Xml if the Content-Type is application/xml, text/xml or application/XXX+xml.

    maxLength

    Max length (in bytes) allowed or returns EntityTooLarge HTTP response.

Deprecated Value Members

  1. def urlFormEncoded: BodyParser[Map[String, Seq[String]]]

    Permalink
    Annotations
    @deprecated
    Deprecated

    (Since version 2.6.0) Use formUrlEncoded

  2. def urlFormEncoded(maxLength: Int): BodyParser[Map[String, Seq[String]]]

    Permalink
    Annotations
    @deprecated
    Deprecated

    (Since version 2.6.0) Use formUrlEncoded

Inherited from BodyParserUtils

Inherited from AnyRef

Inherited from Any

Ungrouped