trait Requests extends Urls with Methods with SemigroupalSyntax
- Alphabetic
- By Inheritance
- Requests
- SemigroupalSyntax
- Methods
- Urls
- PartialInvariantFunctorSyntax
- InvariantFunctorSyntax
- AnyRef
- Any
- Hide All
- Show All
- Public
- All
Type Members
-
implicit
class
SemigroupalSyntax[A, F[_]] extends AnyRef
- Definition Classes
- SemigroupalSyntax
-
implicit
class
InvariantFunctorSyntax[A, F[_]] extends AnyRef
- Definition Classes
- InvariantFunctorSyntax
-
abstract
type
Method
HTTP Method
HTTP Method
- Definition Classes
- Methods
-
implicit
class
PartialInvariantFunctorSyntax[A, F[_]] extends AnyRef
- Definition Classes
- PartialInvariantFunctorSyntax
-
abstract
type
Path[A] <: Url[A]
An URL path carrying an
AinformationAn URL path carrying an
Ainformation- Definition Classes
- Urls
- Note
This type has implicit methods provided by the PathOps, InvariantFunctorSyntax, and the PartialInvariantFunctorSyntax classes.
-
abstract
type
QueryString[A]
A query string carrying an
AinformationA query string carrying an
AinformationQueryString values can be created with the qs operation, and can be combined with the
&operation:val queryPageAndLang: QueryString[(Int, Option[String])] = qs[Int]("page") & qs[Option[String]]("lang")
- Definition Classes
- Urls
- Note
This type has implicit methods provided by the QueryStringSyntax, InvariantFunctorSyntax, and the PartialInvariantFunctorSyntax classes.
-
abstract
type
QueryStringParam[A]
A query string parameter codec for type
A.A query string parameter codec for type
A.- Definition Classes
- Urls
- Note
This type has implicit methods provided by the PartialInvariantFunctorSyntax and the InvariantFunctorSyntax classes.
-
abstract
type
Request[A]
Information carried by a whole request (headers and entity)
-
abstract
type
RequestEntity[A]
Information carried by request entity
Information carried by request entity
- Note
This type has implicit methods provided by the InvariantFunctorSyntax class.
-
abstract
type
RequestHeaders[A]
Information carried by requests’ headers
Information carried by requests’ headers
- Note
This type has implicit methods provided by the SemigroupalSyntax and InvariantFunctorSyntax classes.
-
abstract
type
Segment[A]
An URL path segment codec for type
A.An URL path segment codec for type
A.- Definition Classes
- Urls
- Note
This type has implicit methods provided by the PartialInvariantFunctorSyntax and the InvariantFunctorSyntax classes.
-
abstract
type
Url[A]
An URL carrying an
AinformationAn URL carrying an
Ainformation- Definition Classes
- Urls
- Note
This type has implicit methods provided by the PartialInvariantFunctorSyntax and InvariantFunctorSyntax classes.
-
implicit
class
PathOps[A] extends AnyRef
Convenient methods for Paths.
-
implicit
class
QueryStringSyntax[A] extends AnyRef
Extension methods on QueryString.
Extension methods on QueryString.
- Definition Classes
- Urls
Abstract Value Members
-
abstract
def
Delete: Method
- Definition Classes
- Methods
-
abstract
def
Get: Method
- Definition Classes
- Methods
-
abstract
def
Options: Method
- Definition Classes
- Methods
-
abstract
def
Patch: Method
- Definition Classes
- Methods
-
abstract
def
Post: Method
- Definition Classes
- Methods
-
abstract
def
Put: Method
- Definition Classes
- Methods
-
abstract
def
chainPaths[A, B](first: Path[A], second: Path[B])(implicit tupler: Tupler[A, B]): Path[Out]
Chains the two paths
Chains the two paths
- Definition Classes
- Urls
-
abstract
def
combineQueryStrings[A, B](first: QueryString[A], second: QueryString[B])(implicit tupler: Tupler[A, B]): QueryString[Out]
Concatenates two
QueryStringsConcatenates two
QueryStrings- Definition Classes
- Urls
-
abstract
def
emptyHeaders: RequestHeaders[Unit]
No particular information.
No particular information. Does not mean that the headers *have to* be empty. Just that, from a server point of view no information will be extracted from them, and from a client point of view no particular headers will be built in the request.
Use
descriptionof endpoints.algebra.Endpoints#endpoint to document empty headers. -
abstract
def
emptyRequest: RequestEntity[Unit]
Empty request -- request without a body.
Empty request -- request without a body. Use
descriptionof endpoints.algebra.Endpoints#endpoint to document an empty body. -
abstract
def
header(name: String, docs: Documentation = None): RequestHeaders[String]
A required request header
A required request header
- name
Header name (e.g., “Authorization”)
-
abstract
def
optHeader(name: String, docs: Documentation = None): RequestHeaders[Option[String]]
An optional request header
An optional request header
- name
Header name (e.g., “Authorization”)
-
implicit abstract
def
optionalQueryStringParam[A](implicit arg0: QueryStringParam[A]): QueryStringParam[Option[A]]
Make a query string parameter optional:
Make a query string parameter optional:
path / "articles" /? qs[Option[Int]]("page")
Client interpreters must omit optional query string parameters that are empty. Server interpreters must accept incoming requests whose optional query string parameters are missing. Server interpreters must report a failure for incoming requests whose optional query string parameters are present, but malformed.
- Definition Classes
- Urls
-
implicit abstract
def
pathPartialInvariantFunctor: PartialInvariantFunctor[Path]
Provides
xmapandxmapPartialoperations.Provides
xmapandxmapPartialoperations.- Definition Classes
- Urls
- See also
-
abstract
def
qs[A](name: String, docs: Documentation = None)(implicit value: QueryStringParam[A]): QueryString[A]
Builds a
QueryStringwith one parameter.Builds a
QueryStringwith one parameter.Examples:
qs[Int]("page") // mandatory `page` parameter qs[Option[String]]("lang") // optional `lang` parameter qs[List[Long]]("id") // repeated `id` parameter
- A
Type of the value carried by the parameter
- name
Parameter’s name
- Definition Classes
- Urls
-
implicit abstract
def
queryStringParamPartialInvFunctor: PartialInvariantFunctor[QueryStringParam]
Provides
xmapandxmapPartialoperations.Provides
xmapandxmapPartialoperations.- Definition Classes
- Urls
- See also
-
implicit abstract
def
queryStringPartialInvFunctor: PartialInvariantFunctor[QueryString]
Provides
xmapandxmapPartialoperations.Provides
xmapandxmapPartialoperations.- Definition Classes
- Urls
- See also
-
abstract
def
remainingSegments(name: String = "", docs: Documentation = None): Path[String]
The remaining segments of the path.
The remaining segments of the path. The
Stringvalue carried by thisPathis still URL-encoded.- Definition Classes
- Urls
-
implicit abstract
def
repeatedQueryStringParam[A, CC[X] <: Iterable[X]](implicit arg0: QueryStringParam[A], factory: scala.collection.compat.Factory[A, CC[A]]): QueryStringParam[CC[A]]
Support query string parameters with multiple values:
Support query string parameters with multiple values:
path / "articles" /? qs[List[Long]]("id")
Server interpreters must accept incoming requests where such parameters are missing (in such a case, its value is an empty collection), and report a failure if at least one value is malformed.
- Definition Classes
- Urls
-
implicit abstract
def
reqEntityInvFunctor: InvariantFunctor[RequestEntity]
Provides
xmapoperation.Provides
xmapoperation.- See also
-
implicit abstract
def
reqHeadersInvFunctor: InvariantFunctor[RequestHeaders]
Provides
xmapoperation.Provides
xmapoperation.- See also
-
implicit abstract
def
reqHeadersSemigroupal: Semigroupal[RequestHeaders]
Provides
++operation.Provides
++operation.- See also
-
abstract
def
request[UrlP, BodyP, HeadersP, UrlAndBodyPTupled, Out](method: Method, url: Url[UrlP], entity: RequestEntity[BodyP] = emptyRequest, docs: Documentation = None, headers: RequestHeaders[HeadersP] = emptyHeaders)(implicit tuplerUB: Tupler.Aux[UrlP, BodyP, UrlAndBodyPTupled], tuplerUBH: Tupler.Aux[UrlAndBodyPTupled, HeadersP, Out]): Request[Out]
Request for given parameters
Request for given parameters
- UrlP
Payload carried by url
- BodyP
Payload carried by body
- HeadersP
Payload carried by headers
- UrlAndBodyPTupled
Payloads of Url and Body tupled together by Tupler
- method
Request method
- url
Request URL
- entity
Request entity
- docs
Request documentation
- headers
Request headers
-
abstract
def
segment[A](name: String = "", docs: Documentation = None)(implicit s: Segment[A]): Path[A]
A path segment carrying an
AinformationA path segment carrying an
Ainformation- Definition Classes
- Urls
-
implicit abstract
def
segmentPartialInvFunctor: PartialInvariantFunctor[Segment]
Provides
xmapandxmapPartialoperations.Provides
xmapandxmapPartialoperations.- Definition Classes
- Urls
- See also
-
abstract
def
staticPathSegment(segment: String): Path[Unit]
A path segment whose value is the given
segmentA path segment whose value is the given
segment- Definition Classes
- Urls
-
implicit abstract
def
stringQueryString: QueryStringParam[String]
Ability to define
Stringquery string parametersAbility to define
Stringquery string parameters- Definition Classes
- Urls
-
implicit abstract
def
stringSegment: Segment[String]
Ability to define
Stringpath segments Servers should return an URL-decoded string value, and clients should take an URL-decoded string value.Ability to define
Stringpath segments Servers should return an URL-decoded string value, and clients should take an URL-decoded string value.- Definition Classes
- Urls
-
abstract
def
textRequest: RequestEntity[String]
Request with a
Stringbody. -
implicit abstract
def
urlPartialInvFunctor: PartialInvariantFunctor[Url]
Provides
xmapandxmapPartialoperationsProvides
xmapandxmapPartialoperations- Definition Classes
- Urls
- See also
-
abstract
def
urlWithQueryString[A, B](path: Path[A], qs: QueryString[B])(implicit tupler: Tupler[A, B]): Url[Out]
Builds an URL from the given path and query string
Builds an URL from the given path and query string
- Definition Classes
- Urls
Concrete Value Members
-
final
def
!=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
final
def
##(): Int
- Definition Classes
- AnyRef → Any
-
final
def
==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
final
def
asInstanceOf[T0]: T0
- Definition Classes
- Any
-
implicit
def
booleanQueryString: QueryStringParam[Boolean]
Query string parameter containing a
BooleanvalueQuery string parameter containing a
Booleanvalue- Definition Classes
- Urls
-
def
clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( ... ) @native()
-
final
def
delete[UrlP, HeadersP, Out](url: Url[UrlP], docs: Documentation = None, headers: RequestHeaders[HeadersP] = emptyHeaders)(implicit tuplerUH: Tupler.Aux[UrlP, HeadersP, Out]): Request[Out]
Helper method to perform DELETE request
Helper method to perform DELETE request
- UrlP
Payload carried by url
- HeadersP
Payload carried by headers
-
implicit
def
doubleQueryString: QueryStringParam[Double]
Codec for query string parameters of type
DoubleCodec for query string parameters of type
Double- Definition Classes
- Urls
-
implicit
def
doubleSegment: Segment[Double]
Segment codec for type
DoubleSegment codec for type
Double- Definition Classes
- Urls
-
implicit
def
dummyPathToUrl[A](p: Path[A]): Url[A]
Implicit conversion to get rid of intellij errors when defining paths.
Implicit conversion to get rid of intellij errors when defining paths. Effectively should not be called.
- Definition Classes
- Urls
- See also
-
final
def
eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
def
equals(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
def
finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( classOf[java.lang.Throwable] )
-
final
def
get[UrlP, HeadersP, Out](url: Url[UrlP], docs: Documentation = None, headers: RequestHeaders[HeadersP] = emptyHeaders)(implicit tuplerUH: Tupler.Aux[UrlP, HeadersP, Out]): Request[Out]
Helper method to perform GET request
Helper method to perform GET request
- UrlP
Payload carried by url
- HeadersP
Payload carried by headers
-
final
def
getClass(): Class[_]
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
-
def
hashCode(): Int
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
-
implicit
def
intQueryString: QueryStringParam[Int]
Ability to define
Intquery string parametersAbility to define
Intquery string parameters- Definition Classes
- Urls
-
implicit
def
intSegment: Segment[Int]
Ability to define
Intpath segmentsAbility to define
Intpath segments- Definition Classes
- Urls
-
final
def
isInstanceOf[T0]: Boolean
- Definition Classes
- Any
-
implicit
def
longQueryString: QueryStringParam[Long]
Query string parameter containing a
LongvalueQuery string parameter containing a
Longvalue- Definition Classes
- Urls
-
implicit
def
longSegment: Segment[Long]
Segment containing a
LongvalueSegment containing a
Longvalue- Definition Classes
- Urls
-
final
def
ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
final
def
notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
-
final
def
notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
-
val
path: Path[Unit]
An empty path.
An empty path.
Useful to begin a path definition:
path / "foo" / segment[Int] /? qs[String]("bar")
- Definition Classes
- Urls
-
final
def
post[UrlP, BodyP, HeadersP, UrlAndBodyPTupled, Out](url: Url[UrlP], entity: RequestEntity[BodyP], docs: Documentation = None, headers: RequestHeaders[HeadersP] = emptyHeaders)(implicit tuplerUB: Tupler.Aux[UrlP, BodyP, UrlAndBodyPTupled], tuplerUBH: Tupler.Aux[UrlAndBodyPTupled, HeadersP, Out]): Request[Out]
Helper method to perform POST request
Helper method to perform POST request
- UrlP
Payload carried by url
- BodyP
Payload carried by body
- HeadersP
Payload carried by headers
- UrlAndBodyPTupled
Payloads of Url and Body tupled together by Tupler
- docs
Request documentation
-
final
def
put[UrlP, BodyP, HeadersP, UrlAndBodyPTupled, Out](url: Url[UrlP], entity: RequestEntity[BodyP], docs: Documentation = None, headers: RequestHeaders[HeadersP] = emptyHeaders)(implicit tuplerUB: Tupler.Aux[UrlP, BodyP, UrlAndBodyPTupled], tuplerUBH: Tupler.Aux[UrlAndBodyPTupled, HeadersP, Out]): Request[Out]
Helper method to perform PUT request
Helper method to perform PUT request
- UrlP
Payload carried by url
- BodyP
Payload carried by body
- HeadersP
Payload carried by headers
- UrlAndBodyPTupled
Payloads of Url and Body tupled together by Tupler
-
final
def
synchronized[T0](arg0: ⇒ T0): T0
- Definition Classes
- AnyRef
-
def
toString(): String
- Definition Classes
- AnyRef → Any
-
def
tryParseString[A](type: String)(parse: (String) ⇒ A): (String) ⇒ Validated[A]
- Definition Classes
- Urls
-
implicit
def
uuidQueryString: QueryStringParam[UUID]
Ability to define
UUIDquery string parametersAbility to define
UUIDquery string parameters- Definition Classes
- Urls
-
implicit
def
uuidSegment: Segment[UUID]
Ability to define
UUIDpath segmentsAbility to define
UUIDpath segments- Definition Classes
- Urls
-
final
def
wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... ) @native()
Inherited from endpoints.SemigroupalSyntax
Inherited from Methods
Inherited from Urls
Inherited from endpoints.PartialInvariantFunctorSyntax
Inherited from endpoints.InvariantFunctorSyntax
Inherited from AnyRef
Inherited from Any
Types
Types introduced by the algebra
Operations
Operations creating and transforming values