Class/Object

com.twitter.finagle.http

Request

Related Docs: object Request | package http

Permalink

abstract class Request extends Message

Rich HttpRequest.

Use RequestProxy to create an even richer subclass.

Linear Supertypes
Known Subclasses
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. Request
  2. Message
  3. AnyRef
  4. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Abstract Value Members

  1. abstract def method: Method

    Permalink

    Returns the HTTP method of this request.

  2. abstract def method_=(method: Method): Unit

    Permalink

    Sets the HTTP method of this request to the given method.

    Sets the HTTP method of this request to the given method.

    * @see method(Method) for Java users.

  3. abstract def reader: Reader

    Permalink

    A read-only handle to the internal stream of bytes, representing the message body.

    A read-only handle to the internal stream of bytes, representing the message body. See com.twitter.io.Reader for more information.

    Definition Classes
    Message
  4. abstract def remoteSocketAddress: InetSocketAddress

    Permalink

    The InetSocketAddress of the client or a place-holder ephemeral address for requests that have yet to be dispatched.

    The InetSocketAddress of the client or a place-holder ephemeral address for requests that have yet to be dispatched.

    Annotations
    @BeanProperty()
  5. abstract def uri: String

    Permalink

    Returns the URI of this request.

  6. abstract def uri_=(uri: String): Unit

    Permalink

    Set the URI of this request to the given uri.

    Set the URI of this request to the given uri.

    See also

    uri(String) for Java users.

  7. abstract def writer: Writer with Closable

    Permalink

    A write-only handle to the internal stream of bytes, representing the message body.

    A write-only handle to the internal stream of bytes, representing the message body. See com.twitter.io.Writer for more information.

    Definition Classes
    Message

Concrete Value Members

  1. final def !=(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  4. def accept: Seq[String]

    Permalink

    Accept header

    Accept header

    Definition Classes
    Message
  5. def acceptMediaTypes: Seq[String]

    Permalink

    Accept header media types (normalized, no parameters)

    Accept header media types (normalized, no parameters)

    Definition Classes
    Message
  6. def accept_=(values: Iterable[String]): Unit

    Permalink

    Set Accept header with list of values

    Set Accept header with list of values

    Definition Classes
    Message
  7. def accept_=(value: String): Unit

    Permalink

    Set Accept header

    Set Accept header

    Definition Classes
    Message
  8. def addCookie(cookie: Cookie): Unit

    Permalink

    Add a cookie

    Add a cookie

    Definition Classes
    Message
  9. def allow: Option[String]

    Permalink

    Allow header

    Allow header

    Definition Classes
    Message
  10. def allow_=(values: Iterable[Method]): Unit

    Permalink

    Set Authorization header

    Set Authorization header

    Definition Classes
    Message
  11. def allow_=(value: String): Unit

    Permalink

    Set Authorization header

    Set Authorization header

    Definition Classes
    Message
  12. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  13. def authorization: Option[String]

    Permalink

    Get Authorization header

    Get Authorization header

    Definition Classes
    Message
  14. def authorization_=(value: String): Unit

    Permalink

    Set Authorization header

    Set Authorization header

    Definition Classes
    Message
  15. def cacheControl: Option[String]

    Permalink

    Get Cache-Control header

    Get Cache-Control header

    Definition Classes
    Message
  16. def cacheControl_=(maxAge: Duration): Unit

    Permalink

    Set Cache-Control header with a max-age (and must-revalidate).

    Set Cache-Control header with a max-age (and must-revalidate).

    Definition Classes
    Message
  17. def cacheControl_=(value: String): Unit

    Permalink

    Set Cache-Control header

    Set Cache-Control header

    Definition Classes
    Message
  18. def charset: Option[String]

    Permalink

    Get charset from Content-Type header

    Get charset from Content-Type header

    Definition Classes
    Message
  19. def charset_=(value: String): Unit

    Permalink

    Set charset in Content-Type header.

    Set charset in Content-Type header. This does not change the content.

    Definition Classes
    Message
  20. final def clearContent(): Unit

    Permalink

    Clear content (set to "").

    Clear content (set to "").

    Definition Classes
    Message
  21. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  22. def close(): Future[Unit]

    Permalink

    End the response stream.

    End the response stream.

    Definition Classes
    Message
  23. def containsParam(name: String): Boolean

    Permalink

    Check if parameter exists.

  24. final def content(content: Buf): Request.this.type

    Permalink

    Set the content of this Message.

    Set the content of this Message.

    Any existing content is discarded. If this Message is set to chunked, an IllegalStateException is thrown.

    Definition Classes
    Message
    Annotations
    @throws( ... )
    See also

    content_=(Buf) for Scala users

  25. def content: Buf

    Permalink

    Retrieve the current content of this Message.

    Retrieve the current content of this Message.

    If this message is chunked, the resulting Buf will always be empty.

    Definition Classes
    Message
  26. final def contentLength(value: Long): Request.this.type

    Permalink

    Set Content-Length header.

    Set Content-Length header. Normally, this is automatically set by the Codec, but this method allows you to override that.

    Definition Classes
    Message
    See also

    contentLength_=(Long) for Scala users.

  27. def contentLength: Option[Long]

    Permalink

    Get the value of the Content-Length header.

    Get the value of the Content-Length header. Use length to get the length of actual content.

    Definition Classes
    Message
    See also

    Long for Java users.

  28. final def contentLengthOrElse(default: Long): Long

    Permalink

    Get the value of the Content-Length header, or the provided default if it doesn't exist.

    Get the value of the Content-Length header, or the provided default if it doesn't exist.

    Definition Classes
    Message
    See also

    Option(Long) for Scala users.

  29. def contentLength_=(value: Long): Unit

    Permalink

    Set Content-Length header.

    Set Content-Length header. Normally, this is automatically set by the Codec, but this method allows you to override that.

    Definition Classes
    Message
    See also

    contentLength(Long) for Java users.

  30. def contentString: String

    Permalink

    Get the content as a string.

    Get the content as a string.

    Definition Classes
    Message
  31. def contentString_=(value: String): Unit

    Permalink

    Set the content as a string.

    Set the content as a string.

    Definition Classes
    Message
  32. def contentType: Option[String]

    Permalink

    Get Content-Type header

    Get Content-Type header

    Definition Classes
    Message
  33. def contentType_=(value: String): Unit

    Permalink

    Set Content-Type header

    Set Content-Type header

    Definition Classes
    Message
  34. def content_=(content: Buf): Unit

    Permalink

    Set the content of this Message.

    Set the content of this Message.

    Any existing content is discarded. If this Message is set to chunked, an IllegalStateException is thrown.

    Definition Classes
    Message
    Annotations
    @throws( ... )
    See also

    content(Buf) for Java users

  35. lazy val cookies: CookieMap

    Permalink

    Cookies.

    Cookies. In a request, this uses the Cookie headers. In a response, it uses the Set-Cookie headers.

    Definition Classes
    Message
  36. def ctx: Record

    Permalink

    Arbitrary user-defined context associated with this request object.

    Arbitrary user-defined context associated with this request object. RecordSchema.Record is used here, rather than Context or similar out-of-band mechanisms, to make the connection between the request and its associated context explicit.

  37. def date: Option[String]

    Permalink

    Get Date header

    Get Date header

    Definition Classes
    Message
  38. def date_=(value: Date): Unit

    Permalink

    Set Date header by Date

    Set Date header by Date

    Definition Classes
    Message
  39. def date_=(value: String): Unit

    Permalink

    Set Date header

    Set Date header

    Definition Classes
    Message
  40. def encodeBytes(): Array[Byte]

    Permalink

    Encode an HTTP message to Array[Byte]

  41. def encodeString(): String

    Permalink

    Encode an HTTP message to String.

  42. final def eq(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  43. def equals(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  44. def expires: Option[String]

    Permalink

    Get Expires header

    Get Expires header

    Definition Classes
    Message
  45. def expires_=(value: Date): Unit

    Permalink

    Set Expires header by Date

    Set Expires header by Date

    Definition Classes
    Message
  46. def expires_=(value: String): Unit

    Permalink

    Set Expires header

    Set Expires header

    Definition Classes
    Message
  47. def fileExtension: String

    Permalink

    File extension.

    File extension. Empty string if none.

    Annotations
    @BeanProperty()
  48. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  49. def getBooleanParam(name: String, default: Boolean): Boolean

    Permalink

    Get Boolean param.

    Get Boolean param. Returns value or default.

  50. def getBooleanParam(name: String): Boolean

    Permalink

    Get Boolean param.

    Get Boolean param. Returns value or false.

  51. final def getClass(): Class[_]

    Permalink
    Definition Classes
    AnyRef → Any
  52. def getContentString(): String

    Permalink
    Definition Classes
    Message
  53. def getCookies(): Iterator[Cookie]

    Permalink

    Get iterator over Cookies

    Get iterator over Cookies

    Definition Classes
    Message
  54. final def getInputStream(): InputStream

    Permalink

    Get InputStream for content.

    Get InputStream for content. Caller must close. (Java interface. Scala users should use withInputStream.)

    Definition Classes
    Message
  55. def getIntParam(name: String, default: Int): Int

    Permalink

    Get Int param.

    Get Int param. Returns value or default.

  56. def getIntParam(name: String): Int

    Permalink

    Get Int param.

    Get Int param. Returns value or 0.

  57. final def getLength(): Int

    Permalink

    Get length of content.

    Get length of content.

    Definition Classes
    Message
  58. def getLongParam(name: String, default: Long): Long

    Permalink

    Get Long param.

    Get Long param. Returns value or default.

  59. def getLongParam(name: String): Long

    Permalink

    Get Long param.

    Get Long param. Returns value or 0.

  60. def getParam(name: String, default: String): String

    Permalink

    Get parameter value.

    Get parameter value. Returns value or default.

  61. def getParam(name: String): String

    Permalink

    Get parameter value.

    Get parameter value. Returns value or null.

  62. def getParamNames(): Set[String]

    Permalink

    Get parameters names.

  63. def getParams(): List[Entry[String, String]]

    Permalink

    Get all parameters.

  64. def getParams(name: String): List[String]

    Permalink

    Get all values of parameter.

    Get all values of parameter. Returns list of values.

  65. final def getReader(): Reader

    Permalink

    Get Reader for content.

    Get Reader for content. (Java interface. Scala users should use withReader.)

    Definition Classes
    Message
  66. def getShortParam(name: String, default: Short): Short

    Permalink

    Get Short param.

    Get Short param. Returns value or default.

  67. def getShortParam(name: String): Short

    Permalink

    Get Short param.

    Get Short param. Returns value or 0.

  68. def hashCode(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  69. def headerMap: HeaderMap

    Permalink
    Definition Classes
    Message
  70. final def host(value: String): Request.this.type

    Permalink

    Set the Host header

    Set the Host header

    Definition Classes
    Message
    See also

    host_=(String) for Scala users

  71. def host: Option[String]

    Permalink

    Get Host header

    Get Host header

    Definition Classes
    Message
  72. def host_=(value: String): Unit

    Permalink

    Set Host header

    Set Host header

    Definition Classes
    Message
    See also

    host(String) for Java users

  73. def isChunked: Boolean

    Permalink
    Definition Classes
    Message
  74. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  75. final def isRequest: Boolean

    Permalink
    Definition Classes
    RequestMessage
  76. def isResponse: Boolean

    Permalink
    Definition Classes
    Message
  77. def isXmlHttpRequest: Boolean

    Permalink

    Check if X-Requested-With contains XMLHttpRequest, usually signalling a request from a JavaScript AJAX libraries.

    Check if X-Requested-With contains XMLHttpRequest, usually signalling a request from a JavaScript AJAX libraries. Some servers treat these requests specially. For example, an endpoint might render JSON or XML instead HTML if it's an XmlHttpRequest. (Tip: don't do this - it's gross.)

    Definition Classes
    Message
  78. final def keepAlive: Boolean

    Permalink
    Definition Classes
    Message
  79. final def keepAlive(keepAlive: Boolean): Request.this.type

    Permalink
    Definition Classes
    Message
  80. def lastModified: Option[String]

    Permalink

    Get Last-Modified header

    Get Last-Modified header

    Definition Classes
    Message
  81. def lastModified_=(value: Date): Unit

    Permalink

    Set Last-Modified header by Date

    Set Last-Modified header by Date

    Definition Classes
    Message
  82. def lastModified_=(value: String): Unit

    Permalink

    Set Last-Modified header

    Set Last-Modified header

    Definition Classes
    Message
  83. final def length: Int

    Permalink

    Get length of content.

    Get length of content.

    Definition Classes
    Message
  84. def location: Option[String]

    Permalink

    Get Location header

    Get Location header

    Definition Classes
    Message
  85. def location_=(value: String): Unit

    Permalink

    Set Location header

    Set Location header

    Definition Classes
    Message
  86. def mediaType: Option[String]

    Permalink

    Get media-type from Content-Type header

    Get media-type from Content-Type header

    Definition Classes
    Message
  87. def mediaType_=(value: String): Unit

    Permalink

    Set media-type in Content-Type header.

    Set media-type in Content-Type header. Charset and parameter values are preserved, though may not be appropriate for the new media type.

    Definition Classes
    Message
  88. final def method(method: Method): Request.this.type

    Permalink

    Sets the HTTP method of this request to the given method.

    Sets the HTTP method of this request to the given method.

    See also

    method_=(Method) for Scala users.

  89. def multipart: Option[Multipart]

    Permalink

    Returns an _optional_ Multipart instance, which maintains the multipart/form-data content of this non-chunked, POST request.

    Returns an _optional_ Multipart instance, which maintains the multipart/form-data content of this non-chunked, POST request. If this requests is either streaming or non-POST, this method returns None.

    Note: This method is a part of an experimental API for handling multipart HTTP data and it will likely be changed in future in order to support streaming requests.

  90. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  91. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
  92. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
  93. def params: ParamMap

    Permalink

    Returns a ParamMap instance, which maintains query string and url-encoded params associated with this request.

  94. def path: String

    Permalink

    Path from URI.

    Path from URI.

    Annotations
    @BeanProperty()
  95. def referer: Option[String]

    Permalink

    Get Referer [sic] header

    Get Referer [sic] header

    Definition Classes
    Message
  96. def referer_=(value: String): Unit

    Permalink

    Set Referer [sic] header

    Set Referer [sic] header

    Definition Classes
    Message
  97. def remoteAddress: InetAddress

    Permalink

    Remote InetAddress

    Remote InetAddress

    Annotations
    @BeanProperty()
  98. def remoteHost: String

    Permalink

    Remote host - a dotted quad

    Remote host - a dotted quad

    Annotations
    @BeanProperty()
  99. def remotePort: Int

    Permalink

    Remote port

    Remote port

    Annotations
    @BeanProperty()
  100. def removeCookie(name: String): Unit

    Permalink

    Remove a cookie

    Remove a cookie

    Definition Classes
    Message
  101. def retryAfter: Option[String]

    Permalink

    Get Retry-After header

    Get Retry-After header

    Definition Classes
    Message
  102. def retryAfter_=(value: Long): Unit

    Permalink

    Set Retry-After header by seconds

    Set Retry-After header by seconds

    Definition Classes
    Message
  103. def retryAfter_=(value: String): Unit

    Permalink

    Set Retry-After header

    Set Retry-After header

    Definition Classes
    Message
  104. def server: Option[String]

    Permalink

    Get Server header

    Get Server header

    Definition Classes
    Message
  105. def server_=(value: String): Unit

    Permalink

    Set Server header

    Set Server header

    Definition Classes
    Message
  106. def setChunked(chunked: Boolean): Unit

    Permalink

    Manipulate the Message content mode.

    Manipulate the Message content mode.

    If chunked is true, any existing content will be discarded and further attempts to manipulate the synchronous content will result in an IllegalStateException.

    If chunked is false, the synchronous content methods will become available and the Reader/Writer of the message will be ignored by Finagle.

    Definition Classes
    Message
  107. final def setContentString(value: String): Unit

    Permalink

    Set the content as a string.

    Set the content as a string.

    Definition Classes
    Message
  108. def setContentType(mediaType: String, charset: String = "utf-8"): Unit

    Permalink

    Set Content-Type header by media-type and charset

    Set Content-Type header by media-type and charset

    Definition Classes
    Message
  109. def setContentTypeJson(): Unit

    Permalink

    Set Content-Type header to application/json;charset=utf-8

    Set Content-Type header to application/json;charset=utf-8

    Definition Classes
    Message
  110. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  111. def toString(): String

    Permalink
    Definition Classes
    Request → AnyRef → Any
  112. final def uri(value: String): Request.this.type

    Permalink

    Set the URI of this request.

    Set the URI of this request.

    See also

    uri_=(String) for Scala users.

  113. def userAgent: Option[String]

    Permalink

    Get User-Agent header

    Get User-Agent header

    Definition Classes
    Message
  114. def userAgent_=(value: String): Unit

    Permalink

    Set User-Agent header

    Set User-Agent header

    Definition Classes
    Message
  115. final def version(version: Version): Request.this.type

    Permalink

    Set the HTTP version

    Set the HTTP version

    * @see version_=(Version) for Scala users

    Definition Classes
    Message
  116. def version: Version

    Permalink

    Get the HTTP version

    Get the HTTP version

    Definition Classes
    Message
  117. def version_=(version: Version): Unit

    Permalink

    Set the HTTP version

    Set the HTTP version

    Definition Classes
    Message
    See also

    version(Version) for Java users

  118. final def wait(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  119. final def wait(arg0: Long, arg1: Int): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  120. final def wait(arg0: Long): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  121. def withInputStream[T](f: (InputStream) ⇒ T): T

    Permalink

    Use content as InputStream.

    Use content as InputStream. The underlying channel buffer's reader index is advanced. (Scala interface. Java users can use getInputStream().)

    Definition Classes
    Message
  122. final def withOutputStream[T](f: (OutputStream) ⇒ T): T

    Permalink

    Append content via an OutputStream.

    Append content via an OutputStream.

    An IllegalStateException is thrown if this message is chunked.

    Definition Classes
    Message
    Annotations
    @throws( classOf[IllegalStateException] )
  123. final def withReader[T](f: (Reader) ⇒ T): T

    Permalink

    Use content as Reader.

    Use content as Reader. (Scala interface. Java users can use getReader().)

    Definition Classes
    Message
  124. final def withWriter[T](f: (Writer) ⇒ T): T

    Permalink

    Append content via a Writer.

    Append content via a Writer.

    An IllegalStateException is thrown if this message is chunked.

    Definition Classes
    Message
    Annotations
    @throws( classOf[IllegalStateException] )
  125. final def write(bytes: Array[Byte]): Unit

    Permalink

    Append bytes to content.

    Append bytes to content.

    This method makes a defensive copy of the provided byte array. This can be avoided by wrapping the byte array via Buf.ByteArray.Owned and using the write(Buf) method.

    An IllegalStateException is thrown if this message is chunked.

    Definition Classes
    Message
    Annotations
    @throws( classOf[IllegalStateException] )
  126. final def write(buf: Buf): Unit

    Permalink

    Append a Buf to content.

    Append a Buf to content.

    An IllegalStateException is thrown if this message is chunked.

    Definition Classes
    Message
    Annotations
    @throws( classOf[IllegalStateException] )
  127. final def write(string: String): Unit

    Permalink

    Append string to content.

    Append string to content.

    An IllegalStateException is thrown if this message is chunked.

    Definition Classes
    Message
    Annotations
    @throws( classOf[IllegalStateException] )
  128. def wwwAuthenticate: Option[String]

    Permalink

    Get WWW-Authenticate header

    Get WWW-Authenticate header

    Definition Classes
    Message
  129. def wwwAuthenticate_=(value: String): Unit

    Permalink

    Set WWW-Authenticate header

    Set WWW-Authenticate header

    Definition Classes
    Message
  130. def xForwardedFor: Option[String]

    Permalink

    Get X-Forwarded-For header

    Get X-Forwarded-For header

    Definition Classes
    Message
  131. def xForwardedFor_=(value: String): Unit

    Permalink

    Set X-Forwarded-For header

    Set X-Forwarded-For header

    Definition Classes
    Message

Deprecated Value Members

  1. def getResponse(): Response

    Permalink

    Get response associated with request.

    Get response associated with request.

    Annotations
    @deprecated
    Deprecated

    (Since version 2016-12-29) Use the Response constructor functions

  2. lazy val response: Response

    Permalink

    Response associated with request.

    Response associated with request.

    Annotations
    @deprecated
    Deprecated

    (Since version 2016-12-29) Use the Response constructor functions

Inherited from Message

Inherited from AnyRef

Inherited from Any

Ungrouped