http4s-client/endpoints4s.http4s.client/JsonEntitiesFromCodecs

JsonEntitiesFromCodecs

trait JsonEntitiesFromCodecs extends EndpointsWithCustomErrors with JsonEntitiesFromCodecs
trait Methods
trait Urls
trait Errors
trait Responses
trait Requests
trait Methods
trait Urls
class Object
trait Matchable
class Any

Type members

Inherited classlikes

final class CallbackDocs extends Serializable
Value parameters:
entity

Contents of the callback message

method

HTTP method used for the callback

response

Expected response

Inherited from:
EndpointsWithCustomErrors
object CallbackDocs
final class Endpoint[A, B](val request: () => A, val response: () => B)
final class EndpointDocs extends Serializable
Value parameters:
callbacks

Callbacks indexed by event name

deprecated

Indicates whether this endpoint is deprecated or not

description

Detailed description

operationId

A unique identifier which identifies this operation

summary

Short description

tags

OpenAPI tags

Inherited from:
EndpointsWithCustomErrors
object EndpointDocs
final implicit class EndpointSyntax[A, B](endpoint: Endpoint[A, B])

Extension methods for Endpoint.

Extension methods for Endpoint.

Inherited from:
EndpointsWithCustomErrors
implicit class InvariantFunctorSyntax[A, F[_]](val fa: F[A])(implicit ev: InvariantFunctor[F])

Extension methods for values of type F[A] for which there is an implicit InvariantFunctor[F] instance.

Extension methods for values of type F[A] for which there is an implicit InvariantFunctor[F] instance.

Inherited from:
InvariantFunctorSyntax
implicit class PartialInvariantFunctorSyntax[A, F[_]](val fa: F[A])(implicit ev: PartialInvariantFunctor[F])
trait Path[A] extends Url[A]
Inherited from:
Urls
implicit class PathOps[A](first: Path[A])

Convenient methods for Paths.

Convenient methods for Paths.

Inherited from:
Urls
trait QueryStringParam[A]
Inherited from:
Urls
implicit class QueryStringSyntax[A](first: QueryString[A])

Extension methods on QueryString.

Extension methods on QueryString.

Inherited from:
Urls
implicit class RequestEntitySyntax[A](requestEntity: RequestEntity[A])
Inherited from:
Requests
final implicit class RequestSyntax[A](request: Request[A])

Extension methods for Request.

Extension methods for Request.

Inherited from:
Requests
implicit class ResponseSyntax[A](response: Response[A])

Extension methods for Response.

Extension methods for Response.

Inherited from:
Responses
trait Segment[A]
Inherited from:
Urls
implicit class SemigroupalSyntax[A, F[_]](val f: F[A])(implicit ev: Semigroupal[F])
Inherited from:
SemigroupalSyntax
trait Url[A]
Inherited from:
Urls

Inherited types

type CallbacksDocs = Map[String, CallbackDocs]

Callbacks indexed by URL pattern

Callbacks indexed by URL pattern

See also:
Inherited from:
EndpointsWithCustomErrors
type ClientErrors

Errors in a request built by a client

Errors in a request built by a client

Inherited from:
Errors
type Effect[A]
type JsonCodec[A]

A JSON codec type class

A JSON codec type class

Inherited from:
JsonCodecs
type JsonRequest[A] = JsonCodec[A]
Inherited from:
JsonCodecs
type JsonResponse[A] = JsonCodec[A]
Inherited from:
JsonCodecs
type Method = Method
Inherited from:
Methods
type QueryString[A] = A => Query
Inherited from:
Urls
type Request[A] = A => Effect[Request[Effect]]
type Response[A] = (StatusCode, Headers) => Option[() => A]
type ServerError

Error raised by the business logic of a server

Error raised by the business logic of a server

Inherited from:
Errors
type StatusCode = Status
Inherited from:
StatusCodes
type WithDefault[A] = Option[A]
Inherited from:
Urls

Value members

Concrete methods

def jsonRequest[A](implicit codec: JsonCodec[A]): () => A
def jsonResponse[A](implicit codec: JsonCodec[A]): () => A

Inherited methods

def Accepted: StatusCode
Inherited from:
StatusCodes
override def AlreadyReported: StatusCode
Definition Classes
Inherited from:
StatusCodes
def BadRequest: StatusCode
Inherited from:
StatusCodes
override def Conflict: StatusCode
Definition Classes
Inherited from:
StatusCodes
def Created: StatusCode
Inherited from:
StatusCodes
def Delete: Method
Inherited from:
Methods
override def ExpectationFailed: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def FailedDependency: StatusCode
Definition Classes
Inherited from:
StatusCodes
def Forbidden: StatusCode
Inherited from:
StatusCodes
def Get: Method
Inherited from:
Methods
override def Gone: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def IMUsed: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def LengthRequired: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def Locked: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def MethodNotAllowed: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def MisdirectedRequest: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def MultiStatus: StatusCode
Definition Classes
Inherited from:
StatusCodes
def NoContent: StatusCode
Inherited from:
StatusCodes
override def NonAuthoritativeInformation: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def NotAcceptable: StatusCode
Definition Classes
Inherited from:
StatusCodes
def NotFound: StatusCode
Inherited from:
StatusCodes
override def NotModified: StatusCode
Definition Classes
Inherited from:
StatusCodes
def OK: StatusCode
Inherited from:
StatusCodes
def Options: Method
Inherited from:
Methods
override def PartialContent: StatusCode
Definition Classes
Inherited from:
StatusCodes
def Patch: Method
Inherited from:
Methods
override def PaymentRequired: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def PermanentRedirect: StatusCode
Definition Classes
Inherited from:
StatusCodes
def Post: Method
Inherited from:
Methods
override def PreconditionFailed: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def PreconditionRequired: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def ProxyAuthenticationRequired: StatusCode
Definition Classes
Inherited from:
StatusCodes
def Put: Method
Inherited from:
Methods
override def RangeNotSatisfiable: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def RequestHeaderFieldsTooLarge: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def RequestTimeout: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def ResetContent: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def TemporaryRedirect: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def TooEarly: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def UnavailableForLegalReasons: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def UnprocessableEntity: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def UnsupportedMediaType: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def UpgradeRequired: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def UriTooLong: StatusCode
Definition Classes
Inherited from:
StatusCodes
override def addRequestHeaders[A, H](request: () => A, headers: () => H)(implicit tupler: Tupler[A, H]): () => Out
override def addRequestQueryString[A, Q](request: () => A, qs: () => Q)(implicit tupler: Tupler[A, Q]): () => Out
override def addResponseHeaders[A, H](response: () => A, headers: () => H)(implicit tupler: Tupler[A, H]): () => Out
def authority: Authority

The authority to use to access the endpoints

The authority to use to access the endpoints

Inherited from:
EndpointsWithCustomErrors
final def badRequest[A, R](docs: Documentation, headers: () => A)(implicit tupler: Aux[ClientErrors, A, R]): () => R

Bad Request (400) response, with an entity of type ClientErrors.

Bad Request (400) response, with an entity of type ClientErrors.

See also:
Inherited from:
Responses
def chainPaths[A, B](first: Path[A], second: Path[B])(implicit tupler: Tupler[A, B]): Path[Out]
Inherited from:
Urls
override def choiceRequestEntity[A, B](requestEntityA: () => A, requestEntityB: () => B): () => Either[A, B]
override def choiceResponse[A, B](responseA: () => A, responseB: () => B): () => Either[A, B]
def clientErrorsResponseEntity: () => ClientErrors

Format of the response entity carrying the client errors.

Format of the response entity carrying the client errors.

Inherited from:
Errors
def clientErrorsToInvalid(clientErrors: ClientErrors): Invalid

Convert the ClientErrors type into the endpoints4s internal client error type

Convert the ClientErrors type into the endpoints4s internal client error type

Inherited from:
Errors
override def combineQueryStrings[A, B](first: () => A, second: () => B)(implicit tupler: Tupler[A, B]): () => Out
Definition Classes
Inherited from:
Urls
final def delete[UrlP, HeadersP, Out](url: Url[UrlP], docs: Documentation, headers: () => HeadersP)(implicit tuplerUH: Aux[UrlP, HeadersP, Out]): () => Out

Helper method to perform DELETE request

Helper method to perform DELETE request

Type parameters:
HeadersP

Payload carried by headers

UrlP

Payload carried by url

Inherited from:
Requests
override def emptyRequest: () => Unit
override def emptyRequestHeaders: () => Unit
override def emptyResponse: () => Unit
override def emptyResponseHeaders: () => Unit
override def endpoint[A, B](request: () => A, response: () => B, docs: EndpointDocs): Endpoint[A, B]
final def get[UrlP, HeadersP, Out](url: Url[UrlP], docs: Documentation, headers: () => HeadersP)(implicit tuplerUH: Aux[UrlP, HeadersP, Out]): () => Out

Helper method to perform GET request

Helper method to perform GET request

Type parameters:
HeadersP

Payload carried by headers

UrlP

Payload carried by url

Inherited from:
Requests
final def internalServerError[A, R](docs: Documentation, headers: () => A)(implicit tupler: Aux[ServerError, A, R]): () => R

Internal Server Error (500) response, with an entity of type ServerError.

Internal Server Error (500) response, with an entity of type ServerError.

See also:
Inherited from:
Responses
def invalidToClientErrors(invalid: Invalid): ClientErrors

Convert the endpoints4s internal client error type into the ClientErrors type

Convert the endpoints4s internal client error type into the ClientErrors type

Inherited from:
Errors
override def mapEndpointDocs[A, B](currentEndpoint: Endpoint[A, B], func: EndpointDocs => EndpointDocs): Endpoint[A, B]
override def mapEndpointRequest[A, B, C](currentEndpoint: Endpoint[A, B], func: (() => A) => () => C): Endpoint[C, B]
override def mapEndpointResponse[A, B, C](currentEndpoint: Endpoint[A, B], func: (() => B) => () => C): Endpoint[A, C]
final def ok[A, B, R](entity: () => A, docs: Documentation, headers: () => B)(implicit tupler: Aux[A, B, R]): () => R

OK (200) Response with the given entity

OK (200) Response with the given entity

Inherited from:
Responses
override def optQsWithDefault[A](name: String, default: A, docs: Documentation)(implicit value: QueryStringParam[A]): () => Option[A]
Definition Classes
Inherited from:
Urls
override def optRequestHeader(name: String, docs: Option[String]): () => Option[String]
override def optResponseHeader(name: String, docs: Option[String]): () => Option[String]
override def optionalQueryStringParam[A](implicit param: QueryStringParam[A]): QueryStringParam[Option[A]]
Definition Classes
Inherited from:
Urls
final def patch[UrlP, BodyP, HeadersP, UrlAndBodyPTupled, Out](url: Url[UrlP], entity: () => BodyP, docs: Documentation, headers: () => HeadersP)(implicit tuplerUB: Aux[UrlP, BodyP, UrlAndBodyPTupled], tuplerUBH: Aux[UrlAndBodyPTupled, HeadersP, Out]): () => Out

Helper method to perform PATCH request

Helper method to perform PATCH request

Type parameters:
BodyP

Payload carried by body

HeadersP

Payload carried by headers

UrlAndBodyPTupled

Payloads of Url and Body tupled together by Tupler

UrlP

Payload carried by url

Value parameters:
docs

Request documentation

Inherited from:
Requests
final def post[UrlP, BodyP, HeadersP, UrlAndBodyPTupled, Out](url: Url[UrlP], entity: () => BodyP, docs: Documentation, headers: () => HeadersP)(implicit tuplerUB: Aux[UrlP, BodyP, UrlAndBodyPTupled], tuplerUBH: Aux[UrlAndBodyPTupled, HeadersP, Out]): () => Out

Helper method to perform POST request

Helper method to perform POST request

Type parameters:
BodyP

Payload carried by body

HeadersP

Payload carried by headers

UrlAndBodyPTupled

Payloads of Url and Body tupled together by Tupler

UrlP

Payload carried by url

Value parameters:
docs

Request documentation

Inherited from:
Requests
final def put[UrlP, BodyP, HeadersP, UrlAndBodyPTupled, Out](url: Url[UrlP], entity: () => BodyP, docs: Documentation, headers: () => HeadersP)(implicit tuplerUB: Aux[UrlP, BodyP, UrlAndBodyPTupled], tuplerUBH: Aux[UrlAndBodyPTupled, HeadersP, Out]): () => Out

Helper method to perform PUT request

Helper method to perform PUT request

Type parameters:
BodyP

Payload carried by body

HeadersP

Payload carried by headers

UrlAndBodyPTupled

Payloads of Url and Body tupled together by Tupler

UrlP

Payload carried by url

Inherited from:
Requests
override def qs[A](name: String, docs: Documentation)(implicit value: QueryStringParam[A]): () => A
Definition Classes
Inherited from:
Urls
override def queryStringPartialInvariantFunctor: PartialInvariantFunctor[QueryString]
Definition Classes
Inherited from:
Urls
def remainingSegments(name: String, docs: Documentation): Path[String]
Inherited from:
Urls
override def repeatedQueryStringParam[A, CC <: (Iterable)](implicit param: QueryStringParam[A], factory: Factory[A, CC[A]]): QueryStringParam[CC[A]]
Definition Classes
Inherited from:
Urls
override def request[UrlP, BodyP, HeadersP, UrlAndBodyPTupled, Out](method: Method, url: Url[UrlP], entity: () => BodyP, docs: Documentation, headers: () => HeadersP)(implicit tuplerUB: Aux[UrlP, BodyP, UrlAndBodyPTupled], tuplerUBH: Aux[UrlAndBodyPTupled, HeadersP, Out]): () => Out
override def requestHeader(name: String, docs: Option[String]): () => String
override def response[A, B, R](statusCode: StatusCode, entity: () => A, docs: Documentation, headers: () => B)(implicit tupler: Aux[A, B, R]): () => R
override def responseHeader(name: String, docs: Option[String]): () => String
def scheme: Scheme

The scheme to use to access the endpoints

The scheme to use to access the endpoints

Inherited from:
EndpointsWithCustomErrors
def segment[A](name: String, docs: Documentation)(implicit s: Segment[A]): Path[A]
Inherited from:
Urls
override def segmentPartialInvariantFunctor: PartialInvariantFunctor[Segment]
Definition Classes
Inherited from:
Urls
def serverErrorResponseEntity: () => ServerError

Format of the response entity carrying the server error.

Format of the response entity carrying the server error.

Inherited from:
Errors
def serverErrorToThrowable(serverError: ServerError): Throwable

Convert the ServerError type into the endpoints4s internal server error type

Convert the ServerError type into the endpoints4s internal server error type

Inherited from:
Errors
def staticPathSegment(segment: String): Path[Unit]
Inherited from:
Urls
def stringCodec[A : JsonCodec]: Codec[String, A]

Turns a JsonCodec[A] into a Codec[String, A]

Turns a JsonCodec[A] into a Codec[String, A]

Inherited from:
JsonEntitiesFromCodecs
override def stringQueryString: QueryStringParam[String]
Definition Classes
Inherited from:
Urls
override def stringSegment: Segment[String]
Definition Classes
Inherited from:
Urls
override def textRequest: () => String
override def textResponse: () => String
def throwableToServerError(throwable: Throwable): ServerError

Convert the endpoints4s internal server error type into the ServerError type

Convert the endpoints4s internal server error type into the ServerError type

Inherited from:
Errors
override def urlPartialInvariantFunctor: PartialInvariantFunctor[Url]
Definition Classes
Inherited from:
Urls
override def urlWithQueryString[A, B](path: Path[A], qs: () => B)(implicit tupler: Tupler[A, B]): Url[Out]
Definition Classes
Inherited from:
Urls
final def wheneverFound[A](responseA: () => A, notFoundDocs: Documentation): () => Option[A]

Turns a Response[A] into a Response[Option[A]].

Turns a Response[A] into a Response[Option[A]].

Interpreters represent None with an empty HTTP response whose status code is 404 (Not Found).

Inherited from:
Responses

Inherited fields

lazy val clientErrorsResponse: () => ClientErrors

Response used by endpoints4s when decoding a request fails.

Response used by endpoints4s when decoding a request fails.

The provided implementation forwards to badRequest.

Inherited from:
Errors
val path: Path[Unit]

An empty path.

An empty path.

Useful to begin a path definition:

 path / "foo" / segment[Int] /? qs[String]("bar")
Inherited from:
Urls
lazy val serverErrorResponse: () => ServerError

Response used by endpoints4s when the business logic of an endpoint fails.

Response used by endpoints4s when the business logic of an endpoint fails.

The provided implementation forwards to internalServerError

Inherited from:
Errors

Implicits

Inherited implicits

final implicit def EndpointSyntax[A, B](endpoint: Endpoint[A, B]): EndpointSyntax[A, B]

Extension methods for Endpoint.

Extension methods for Endpoint.

Inherited from:
EndpointsWithCustomErrors
final implicit def InvariantFunctorSyntax[A, F[_]](fa: F[A])(implicit ev: InvariantFunctor[F]): InvariantFunctorSyntax[A, F]

Extension methods for values of type F[A] for which there is an implicit InvariantFunctor[F] instance.

Extension methods for values of type F[A] for which there is an implicit InvariantFunctor[F] instance.

Inherited from:
InvariantFunctorSyntax
final implicit def PartialInvariantFunctorSyntax[A, F[_]](fa: F[A])(implicit ev: PartialInvariantFunctor[F]): PartialInvariantFunctorSyntax[A, F]
final implicit def PathOps[A](first: Path[A]): PathOps[A]

Convenient methods for Paths.

Convenient methods for Paths.

Inherited from:
Urls
final implicit def QueryStringSyntax[A](first: () => A): QueryStringSyntax[A]

Extension methods on QueryString.

Extension methods on QueryString.

Inherited from:
Urls
final implicit def RequestEntitySyntax[A](requestEntity: () => A): RequestEntitySyntax[A]
Inherited from:
Requests
final implicit def RequestSyntax[A](request: () => A): RequestSyntax[A]

Extension methods for Request.

Extension methods for Request.

Inherited from:
Requests
final implicit def ResponseSyntax[A](response: () => A): ResponseSyntax[A]

Extension methods for Response.

Extension methods for Response.

Inherited from:
Responses
final implicit def SemigroupalSyntax[A, F[_]](f: F[A])(implicit ev: Semigroupal[F]): SemigroupalSyntax[A, F]
Inherited from:
SemigroupalSyntax
implicit def booleanQueryString: QueryStringParam[Boolean]

Query string parameter containing a Boolean value

Query string parameter containing a Boolean value

Inherited from:
Urls
implicit def doubleQueryString: QueryStringParam[Double]

Codec for query string parameters of type Double

Codec for query string parameters of type Double

Inherited from:
Urls
implicit def doubleSegment: Segment[Double]

Path segment codec for type Double

Path segment codec for type Double

Inherited from:
Urls
implicit def effect: Concurrent[Effect]
implicit def intQueryString: QueryStringParam[Int]

Ability to define Int query string parameters

Ability to define Int query string parameters

Inherited from:
Urls
implicit def intSegment: Segment[Int]

Path segment codec for type Int

Path segment codec for type Int

Inherited from:
Urls
implicit def longQueryString: QueryStringParam[Long]

Query string parameter containing a Long value

Query string parameter containing a Long value

Inherited from:
Urls
implicit def longSegment: Segment[Long]

Path segment codec for type Long

Path segment codec for type Long

Inherited from:
Urls
implicit def uuidQueryString: QueryStringParam[UUID]

Ability to define UUID query string parameters

Ability to define UUID query string parameters

Inherited from:
Urls
implicit def uuidSegment: Segment[UUID]

Path segment codec for type UUID

Path segment codec for type UUID

Inherited from:
Urls