Packages

package json

Json API

For example:

import play.api.libs.json._
import play.api.libs.functional.syntax._

case class User(id: Long, name: String, friends: Seq[User] = Seq.empty)
object User {

  // In this format, an undefined friends property is mapped to an empty list
  implicit val format: Format[User] = (
    (__ \ "id").format[Long] and
    (__ \ "name").format[String] and
    (__ \ "friends").lazyFormatNullable(implicitly[Format[Seq[User]]])
      .inmap[Seq[User]](_ getOrElse Seq.empty, Some(_))
  )(User.apply, unlift(User.unapply))
}

object MyController extends play.api.mvc.Controller {
   def displayUserAsJson(id: String) = Action {
      Ok(Json.toJson(User(id.toLong, "myName")))
   }

   def saveUser(jsonString: String)= Action {
     val user = Json.parse(jsonString).as[User]
     //myDataStore.save(user)
     Ok
   }
}
Source
package.scala
Linear Supertypes
AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. json
  2. AnyRef
  3. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Type Members

  1. final case class BigDecimalParseSettings(mathContext: MathContext = MathContext.DECIMAL128, scaleLimit: Int, digitsLimit: Int) extends Product with Serializable

    Parse settings for BigDecimals.

    Parse settings for BigDecimals. Defines limits that will be used when parsing the BigDecimals, like how many digits are accepted.

    mathContext

    the MathContext used when parsing.

    scaleLimit

    limit the scale, and it is related to the math context used.

    digitsLimit

    how many digits are accepted, also related to the math context used.

  2. final case class BigDecimalSerializerSettings(minPlain: BigDecimal, maxPlain: BigDecimal) extends Product with Serializable
  3. trait ConstraintFormat extends AnyRef
  4. trait ConstraintReads extends AnyRef
  5. trait ConstraintWrites extends AnyRef
  6. trait DefaultFormat extends AnyRef

    Default Json formatters.

  7. trait DefaultReads extends LowPriorityDefaultReads

    Default deserializer type classes.

  8. trait DefaultWrites extends LowPriorityWrites

    Default Serializers.

  9. trait EnvKeyReads extends AnyRef
  10. trait EnvKeyWrites extends AnyRef
  11. trait EnvReads extends AnyRef
  12. trait EnvWrites extends AnyRef
  13. trait Format[A] extends Writes[A] with Reads[A]

    Json formatter: write an implicit to define both a serializer and a deserializer for any type.

    Json formatter: write an implicit to define both a serializer and a deserializer for any type.

    Annotations
    @implicitNotFound( ... )
  14. case class IdxPathNode(idx: Int) extends PathNode with Product with Serializable
  15. case class JsArray(value: IndexedSeq[JsValue] = Array[JsValue]()) extends JsValue with Product with Serializable

    Represent a Json array value.

  16. sealed abstract class JsBoolean extends JsValue with Product with Serializable

    Represents a Json boolean value.

  17. final case class JsDefined(value: JsValue) extends AnyVal with JsLookupResult with Product with Serializable

    Wrapper for JsValue to represent an existing Json value.

  18. case class JsError(errors: Seq[(JsPath, Seq[JsonValidationError])]) extends JsResult[Nothing] with Product with Serializable

    The result in case of parsing errors.

  19. final case class JsLookup(result: JsLookupResult) extends AnyVal with Product with Serializable

    A value representing the value at a particular JSON path, either an actual JSON node or undefined.

  20. sealed trait JsLookupResult extends JsReadable
  21. case class JsNumber(value: BigDecimal) extends JsValue with Product with Serializable

    Represent a Json number value.

  22. case class JsObject(underlying: Map[String, JsValue]) extends JsValue with Product with Serializable

    Represent a Json object value.

  23. case class JsPath(path: List[PathNode] = List()) extends Product with Serializable

    Path to a JsValue; As for path to file on FS, there may not be any matching value in the parsed JSON.

  24. trait JsReadable extends Any

    A trait representing a Json node which can be read as an arbitrary type A using a Reads[A]

  25. sealed trait JsResult[+A] extends AnyRef
  26. case class JsResultException(errors: Seq[(JsPath, Seq[JsonValidationError])]) extends RuntimeException with Product with Serializable
  27. case class JsString(value: String) extends JsValue with Product with Serializable

    Represent a Json string value.

  28. case class JsSuccess[T](value: T, path: JsPath = JsPath()) extends JsResult[T] with Product with Serializable

    The result for a successful parsing.

  29. final class JsUndefined extends JsLookupResult

    Represent a missing Json value.

  30. sealed trait JsValue extends JsReadable

    Generic json value

  31. sealed trait JsonConfiguration extends AnyRef

    JSON configuration

  32. sealed trait JsonFacade extends AnyRef

  33. trait JsonNaming extends (String) ⇒ String

    Naming strategy, to map each class property to the corresponding column.

  34. final case class JsonParserSettings(bigDecimalParseSettings: BigDecimalParseSettings, bigDecimalSerializerSettings: BigDecimalSerializerSettings) extends Product with Serializable
  35. case class JsonValidationError(messages: Seq[String], args: Any*) extends Product with Serializable

    A JSON validation error representation.

  36. case class KeyPathNode(key: String) extends PathNode with Product with Serializable
  37. trait KeyReads[T] extends AnyRef

    Used to read object key for types other than String.

    Used to read object key for types other than String.

    See also

    Reads.keyMapReads

  38. trait KeyWrites[T] extends AnyRef

    Used to write object key for types other than String.

    Used to write object key for types other than String.

    See also

    Writes.keyMapWrites

  39. trait LowPriorityDefaultReads extends EnvReads

    Low priority reads.

    Low priority reads.

    This exists as a compiler performance optimization, so that the compiler doesn't have to rule them out when DefaultReads provides a simple match.

    See https://github.com/playframework/playframework/issues/4313 for more details.

  40. sealed trait LowPriorityWrites extends EnvWrites
  41. trait OFormat[A] extends OWrites[A] with Reads[A] with Format[A]
  42. trait OWrites[A] extends Writes[A]
    Annotations
    @implicitNotFound( ... )
  43. trait OptionHandlers extends AnyRef

    Configure how options should be handled

  44. trait PathFormat extends AnyRef
  45. sealed trait PathNode extends AnyRef
  46. trait PathReads extends AnyRef
  47. trait PathWrites extends AnyRef
  48. trait Reads[A] extends AnyRef

    A Reads object describes how to decode JSON into a value.

    A Reads object describes how to decode JSON into a value. Reads objects are typically provided as implicit values. When Reads implicit values are in scope, a program is able to deserialize JSON into values of the right type.

    The inverse of a Reads object is a Writes object, which describes how to encode a value into JSON. If you combine a Reads and a Writes then you get a Format.

    Annotations
    @implicitNotFound( ... )
  49. case class RecursiveSearch(key: String) extends PathNode with Product with Serializable
  50. trait Writes[A] extends AnyRef

    Json serializer: write an implicit to define a serializer for any type

    Json serializer: write an implicit to define a serializer for any type

    Annotations
    @implicitNotFound( ... )

Value Members

  1. val __: JsPath.type

    Alias for JsPath companion object

  2. object Format extends PathFormat with ConstraintFormat with DefaultFormat

    Default Json formatters.

  3. object JsArray extends (IndexedSeq[JsValue]) ⇒ JsArray with Serializable
  4. object JsBoolean extends (Boolean) ⇒ JsBoolean with Serializable
  5. object JsError extends Serializable
  6. object JsFalse extends JsBoolean with Product with Serializable

    Represents Json Boolean False value.

  7. object JsLookupResult
  8. object JsNull extends JsValue with Product with Serializable

    Represents a Json null value.

  9. object JsObject extends (Seq[(String, JsValue)]) ⇒ JsObject with Serializable
  10. object JsPath extends JsPath

    Companion object and root path.

    Companion object and root path.

    For an object { "name": "foo" }, the path to the name property is:

    import play.api.libs.json.JsPath
    
    JsPath \ "name"

    For an object { "id": 1, "nested": { "score": 0.12 } }, the path to the nested score is:

    import play.api.libs.json.JsPath
    
    JsPath \ "nested" \ "score"
  11. object JsResult
  12. object JsTrue extends JsBoolean with Product with Serializable

    Represents Json Boolean True value.

  13. object JsUndefined
  14. object JsValue
  15. object Json extends JsonFacade

    Helper functions to handle JsValues.

  16. object JsonConfiguration
  17. object JsonNaming

    Naming companion

  18. object JsonParserSettings extends Serializable
  19. object JsonValidationError extends Serializable
  20. object KeyReads extends EnvKeyReads
  21. object KeyWrites extends EnvKeyWrites
  22. object MapWrites
  23. object OFormat
  24. object OWrites extends PathWrites with ConstraintWrites
  25. object OptionHandlers

    OptionHandlers companion

  26. object Reads extends ConstraintReads with PathReads with DefaultReads with GeneratedReads

    Default deserializer type classes.

  27. object StaticBinding
  28. object Writes extends PathWrites with ConstraintWrites with DefaultWrites with GeneratedWrites

    Default Serializers.

Inherited from AnyRef

Inherited from Any

Ungrouped