zio.json

package zio.json

Type members

Classlikes

case object BuildInfo

This object was generated by sbt-buildinfo.

This object was generated by sbt-buildinfo.

case object CamelCase extends JsonMemberFormat
case class CustomCase(f: String => String) extends JsonMemberFormat
final implicit class DecoderOps(json: CharSequence) extends AnyVal
final implicit class EncoderOps[A](a: A) extends AnyVal
final case class JsonCodec[A](encoder: JsonEncoder[A], decoder: JsonDecoder[A])

A JsonCodec[A] instance has the ability to encode values of type A into JSON, together with the ability to decode such JSON into values of type A.

A JsonCodec[A] instance has the ability to encode values of type A into JSON, together with the ability to decode such JSON into values of type A.

Instances of this trait should satisfy round-tripping laws: that is, for every value, instances must be able to successfully encode the value into JSON, and then successfully decode the same value from such JSON.

For more information, see JsonDecoder and JsonEncoder.

{{ val intCodec: JsonCodec[Int] = JsonCodec[Int]

intCodec.encodeJson(intCodec.encodeJson(42)) == Right(42) }}

Companion:
object
Companion:
class

A JsonDecoder[A] instance has the ability to decode JSON to values of type A, potentially failing with an error if the JSON content does not encode a value of the given type.

A JsonDecoder[A] instance has the ability to decode JSON to values of type A, potentially failing with an error if the JSON content does not encode a value of the given type.

Companion:
object
Companion:
object
sealed abstract class JsonError

A JsonError value describes the ways in which decoding could fail. This structure is used to facilitate human-readable error messages during decoding failures.

A JsonError value describes the ways in which decoding could fail. This structure is used to facilitate human-readable error messages during decoding failures.

Companion:
object
object JsonError
Companion:
class

When decoding a JSON Object, we only allow the keys that implement this interface.

When decoding a JSON Object, we only allow the keys that implement this interface.

Companion:
object
Companion:
class

When encoding a JSON Object, we only allow keys that implement this interface.

When encoding a JSON Object, we only allow keys that implement this interface.

Companion:
object
Companion:
class
sealed trait JsonMemberFormat extends String => String
sealed trait JsonStreamDelimiter
Companion:
object
Companion:
class
case object KebabCase extends JsonMemberFormat
case object PascalCase extends JsonMemberFormat
case object SnakeCase extends JsonMemberFormat
final case class jsonDiscriminator(name: String) extends Annotation

If used on a sealed class, will determine the name of the field for disambiguating classes.

If used on a sealed class, will determine the name of the field for disambiguating classes.

The default is to not use a typehint field and instead have an object with a single key that is the class name.

Note that using a discriminator is less performant, uses more memory, and may be prone to DOS attacks that are impossible with the default encoding. In addition, there is slightly less type safety when using custom product encoders (which must write an unenforced object type). Only use this option if you must model an externally defined schema.

final class jsonExclude extends Annotation

If used on a case class field, will exclude it from the resulting JSON.

If used on a case class field, will exclude it from the resulting JSON.

final case class jsonField(name: String) extends Annotation

If used on a case class field, determines the name of the JSON field. Defaults to the case class field name.

If used on a case class field, determines the name of the JSON field. Defaults to the case class field name.

final case class jsonHint(name: String) extends Annotation

If used on a case class will determine the type hint value for disambiguating sealed traits. Defaults to the short type name.

If used on a case class will determine the type hint value for disambiguating sealed traits. Defaults to the short type name.

final case class jsonMemberNames(format: JsonMemberFormat) extends Annotation

If used on a case class, determines the strategy of member names transformation during serialization and deserialization. Four common strategies are provided above and a custom one to support specific use cases.

If used on a case class, determines the strategy of member names transformation during serialization and deserialization. Four common strategies are provided above and a custom one to support specific use cases.

final class jsonNoExtraFields extends Annotation

If used on a case class, will exit early if any fields are in the JSON that do not correspond to field names in the case class.

If used on a case class, will exit early if any fields are in the JSON that do not correspond to field names in the case class.

This adds extra protections against a DOS attacks but means that changes in the schema will result in a hard error rather than silently ignoring those fields.

Cannot be combined with @jsonDiscriminator since it is considered an extra field from the perspective of the case class.

object ziojson_03

zio-json version 0.3.0 formats. abc123Def -> abc_123_def

zio-json version 0.3.0 formats. abc123Def -> abc_123_def

Implicits

Implicits

final implicit def DecoderOps(json: CharSequence): DecoderOps
final implicit def EncoderOps[A](a: A): EncoderOps[A]