typedrest/net.typedrest.endpoints.raw/UploadEndpointImpl

UploadEndpointImpl

class UploadEndpointImpl(referrer: Endpoint, relativeUri: URI, formField: String? = null) : AbstractEndpoint, UploadEndpoint

Implementation of an UploadEndpoint that accepts binary uploads using multi-part form encoding or raw bodies.

Parameters

referrer

The endpoint used to navigate to this one.

relativeUri

The URI of this endpoint relative to the referrer's.

formField

The name of the form field to place the uploaded data into; null to use raw bodies instead of multi-part forms.

Constructors

UploadEndpointImpl

constructor(referrer: Endpoint, relativeUri: URI, formField: String? = null)

constructor(referrer: Endpoint, relativeUri: String, formField: String? = null)

Creates a new upload endpoint.

Properties

errorHandler

open override val errorHandler: ErrorHandler

httpClient

open override val httpClient: OkHttpClient

linkExtractor

open override val linkExtractor: LinkExtractor

serializers

open override val serializers: List<Serializer>

uri

open override val uri: URI

Functions

deserialize

fun <T> deserialize(body: ResponseBody, type: Class<T>): T?

Deserializes an entity using the first serializer that supports the body's content type.

deserializeList

fun <T> deserializeList(body: ResponseBody, type: Class<T>): List<T>?

Deserializes a list of entities using the first serializer that supports the body's content type.

getLinks

open override fun getLinks(rel: String): List<Pair<URI, String?>>

Resolves all links with a specific relation type. Uses cached data from last response.

getLinkTemplate

fun getLinkTemplate(rel: String): UriTemplate

Retrieves a link template with a specific relation type.

link

open override fun link(rel: String): URI

Resolves a single link with a specific relation type. Uses cached data from last response if possible.

linkTemplate

open override fun linkTemplate(rel: String, variables: Map<String, Any>): URI

Resolves a link template with a specific relation type. Uses cached data from last response if possible.

serialize

fun <T> serialize(entity: T, type: Class<T>): RequestBody

Serializes an entity using the first serializer.

serializeList

fun <T> serializeList(entities: Iterable<T>, type: Class<T>): RequestBody

Serializes a list of entities using the first serializer.

setDefaultLink

fun setDefaultLink(rel: String, href: String?)

Registers one or more default links for a specific relation type.

setDefaultLinkTemplate

fun setDefaultLinkTemplate(rel: String, href: String?)

Registers a default link template for a specific relation type.

uploadFrom

open fun uploadFrom(path: String, mimeType: String? = null)

Uploads data to the endpoint from a file.

open override fun uploadFrom(stream: InputStream, fileName: String?, mimeType: String?)

Uploads data to the endpoint from a stream.