ThriftMux

Type Members

case class Client(muxer: StackClient[Request, Response] = ...) extends StackBasedClient[ThriftClientRequest, Array[Byte]] with Parameterized[Client] with Transformable[Client] with ThriftRichClient with Product with Serializable
case class Server(muxer: StackServer[Request, Response] = serverMuxer) extends StackBasedServer[Array[Byte], Array[Byte]] with ThriftRichServer with Parameterized[Server] with Product with Serializable
case class ServerMuxer(stack: Stack[ServiceFactory[Request, Response]] = BaseServerStack, params: Params = ...) extends StdStackServer[Request, Response, ServerMuxer] with Product with Serializable

A server for the Thrift protocol served over com.twitter.finagle.mux.
A server for the Thrift protocol served over com.twitter.finagle.mux. ThriftMuxServer is backwards-compatible with Thrift clients that use the framed transport and binary protocol. It switches to the backward-compatible mode when the first request is not recognized as a valid Mux message but can be successfully handled by the underlying Thrift service. Since a Thrift message that is encoded with the binary protocol starts with a header value of 0x800100xx, Mux does not confuse it with a valid Mux message (0x80 = -128 is an invalid Mux message type) and the server can reliably detect the non-Mux Thrift client and switch to the backwards-compatible mode.
Note that the server is also compatible with non-Mux finagle-thrift clients. It correctly responds to the protocol up-negotiation request and passes the tracing information embedded in the thrift requests to Mux (which has native tracing support).

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
object Server extends Serializable
final def asInstanceOf[T0]: T0

Definition Classes
Any
val client: Client
def clone(): AnyRef

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( ... )
lazy val defaultClientName: String

Attributes
protected
Definition Classes
ThriftMux → ThriftRichClient
final def eq(arg0: AnyRef): Boolean

Definition Classes
AnyRef
def equals(arg0: Any): Boolean

Definition Classes
AnyRef → Any
def finalize(): Unit

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( classOf[java.lang.Throwable] )
final def getClass(): Class[_]

Definition Classes
AnyRef → Any
def hashCode(): Int

Definition Classes
AnyRef → Any
final def isInstanceOf[T0]: Boolean

Definition Classes
Any
val maxThriftBufferSize: Int

Definition Classes
ThriftRichServer
final def ne(arg0: AnyRef): Boolean

Definition Classes
AnyRef
def newClient(dest: Name, label: String): ServiceFactory[ThriftClientRequest, Array[Byte]]

Definition Classes
ThriftMux → Client
final def newClient(dest: String, label: String): ServiceFactory[ThriftClientRequest, Array[Byte]]

Definition Classes
Client
final def newClient(dest: String): ServiceFactory[ThriftClientRequest, Array[Byte]]

Definition Classes
Client
def newIface[Iface](name: Name, label: String, cls: Class[_]): Iface

Definition Classes
ThriftRichClient
def newIface[Iface](dest: Name, label: String)(implicit arg0: ClassTag[Iface]): Iface

Definition Classes
ThriftRichClient
def newIface[Iface](dest: String, label: String)(implicit arg0: ClassTag[Iface]): Iface

Definition Classes
ThriftRichClient
def newIface[Iface](dest: String)(implicit arg0: ClassTag[Iface]): Iface

Definition Classes
ThriftRichClient
def newIface[Iface](dest: String, label: String, cls: Class[_]): Iface

Definition Classes
ThriftRichClient
def newIface[Iface](dest: String, cls: Class[_]): Iface

Definition Classes
ThriftRichClient
def newMethodIface[ServiceIface, FutureIface](serviceIface: ServiceIface)(implicit builder: MethodIfaceBuilder[ServiceIface, FutureIface]): FutureIface

Definition Classes
ThriftRichClient
def newService(dest: Name, label: String): Service[ThriftClientRequest, Array[Byte]]

Definition Classes
ThriftMux → Client
final def newService(dest: String, label: String): Service[ThriftClientRequest, Array[Byte]]

Definition Classes
Client
final def newService(dest: String): Service[ThriftClientRequest, Array[Byte]]

Definition Classes
Client
def newServiceIface[ServiceIface](dest: Name, label: String)(implicit builder: ServiceIfaceBuilder[ServiceIface]): ServiceIface

Definition Classes
ThriftRichClient
def newServiceIface[ServiceIface](dest: String, label: String)(implicit builder: ServiceIfaceBuilder[ServiceIface]): ServiceIface

Definition Classes
ThriftRichClient
final def notify(): Unit

Definition Classes
AnyRef
final def notifyAll(): Unit

Definition Classes
AnyRef
val protocolFactory: TProtocolFactory

Attributes
protected
Definition Classes
ThriftMux → ThriftRichServer → ThriftRichClient
def serve(addr: SocketAddress, factory: ServiceFactory[Array[Byte], Array[Byte]]): ListeningServer

Definition Classes
ThriftMux → Server
def serve(addr: String, service: Service[Array[Byte], Array[Byte]]): ListeningServer

Definition Classes
Server
def serve(addr: String, service: ServiceFactory[Array[Byte], Array[Byte]]): ListeningServer

Definition Classes
Server
def serve(addr: SocketAddress, service: Service[Array[Byte], Array[Byte]]): ListeningServer

Definition Classes
Server
def serveAndAnnounce(name: String, service: Service[Array[Byte], Array[Byte]]): ListeningServer

Definition Classes
Server
def serveAndAnnounce(name: String, service: ServiceFactory[Array[Byte], Array[Byte]]): ListeningServer

Definition Classes
Server
def serveAndAnnounce(name: String, addr: String, service: Service[Array[Byte], Array[Byte]]): ListeningServer

Definition Classes
Server
def serveAndAnnounce(name: String, addr: String, service: ServiceFactory[Array[Byte], Array[Byte]]): ListeningServer

Definition Classes
Server
def serveAndAnnounce(name: String, addr: SocketAddress, service: Service[Array[Byte], Array[Byte]]): ListeningServer

Definition Classes
Server
def serveAndAnnounce(name: String, addr: SocketAddress, service: ServiceFactory[Array[Byte], Array[Byte]]): ListeningServer

Definition Classes
Server
def serveIface(addr: SocketAddress, iface: AnyRef): ListeningServer

Definition Classes
ThriftRichServer
def serveIface(addr: String, iface: AnyRef): ListeningServer

Definition Classes
ThriftRichServer
val server: Server
val serverLabel: String

Attributes
protected
Definition Classes
ThriftRichServer
val serverMuxer: ServerMuxer
lazy val serverStats: StatsReceiver

Attributes
protected
Definition Classes
ThriftRichServer
lazy val stats: StatsReceiver

Attributes
protected
Definition Classes
ThriftMux → ThriftRichClient
final def synchronized[T0](arg0: ⇒ T0): T0

Definition Classes
AnyRef
def toString(): String

Definition Classes
AnyRef → Any
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( ... )

Deprecated Value Members

final def newClient(dest: Group[SocketAddress]): ServiceFactory[ThriftClientRequest, Array[Byte]]

Definition Classes
Client
Annotations
@deprecated
Deprecated
(Since version 6.7.x) Use destination names
def newIface[Iface](group: Group[SocketAddress], cls: Class[_]): Iface

Definition Classes
ThriftRichClient
Annotations
@deprecated
Deprecated
(Since version 6.7.x) Use destination names via newIface(String) or newIface(Name)
def newIface[Iface](group: Group[SocketAddress])(implicit arg0: ClassTag[Iface]): Iface

Definition Classes
ThriftRichClient
Annotations
@deprecated
Deprecated
(Since version 6.7.x) Use destination names via newIface(String) or newIface(Name)
final def newService(dest: Group[SocketAddress]): Service[ThriftClientRequest, Array[Byte]]

Definition Classes
Client
Annotations
@deprecated
Deprecated
(Since version 6.7.x) Use destination names
def newServiceIface[ServiceIface](dest: Name)(implicit builder: ServiceIfaceBuilder[ServiceIface]): ServiceIface

Definition Classes
ThriftRichClient
Annotations
@deprecated
Deprecated
(Since version 2015-10-26) Must provide service label
def newServiceIface[ServiceIface](dest: String)(implicit builder: ServiceIfaceBuilder[ServiceIface]): ServiceIface

Definition Classes
ThriftRichClient
Annotations
@deprecated
Deprecated
(Since version 2015-10-26) Must provide service label
def withClientId(clientId: ClientId): Client

Produce a com.twitter.finagle.ThriftMux.Client using the provided client ID.
Produce a com.twitter.finagle.ThriftMux.Client using the provided client ID.

Annotations
@deprecated
Deprecated
(Since version 6.22.0) Use ThriftMux.client.withClientId
def withProtocolFactory(pf: TProtocolFactory): Client

Produce a com.twitter.finagle.ThriftMux.Client using the provided protocolFactory.
Produce a com.twitter.finagle.ThriftMux.Client using the provided protocolFactory.

Annotations
@deprecated
Deprecated
(Since version 6.22.0) Use ThriftMux.client.withProtocolFactory

Related Doc: package finagle

object ThriftMux extends Client[ThriftClientRequest, Array[Byte]] with ThriftRichClient with Server[Array[Byte], Array[Byte]] with ThriftRichServer

Type Members

case class Client(muxer: StackClient[Request, Response] = ...) extends StackBasedClient[ThriftClientRequest, Array[Byte]] with Parameterized[Client] with Transformable[Client] with ThriftRichClient with Product with Serializable

case class Server(muxer: StackServer[Request, Response] = serverMuxer) extends StackBasedServer[Array[Byte], Array[Byte]] with ThriftRichServer with Parameterized[Server] with Product with Serializable

case class ServerMuxer(stack: Stack[ServiceFactory[Request, Response]] = BaseServerStack, params: Params = ...) extends StdStackServer[Request, Response, ServerMuxer] with Product with Serializable

Value Members

final def !=(arg0: Any): Boolean

final def ##(): Int

final def ==(arg0: Any): Boolean

object Server extends Serializable

final def asInstanceOf[T0]: T0

val client: Client

def clone(): AnyRef

lazy val defaultClientName: String

final def eq(arg0: AnyRef): Boolean

def equals(arg0: Any): Boolean

def finalize(): Unit

final def getClass(): Class[_]

def hashCode(): Int

final def isInstanceOf[T0]: Boolean

val maxThriftBufferSize: Int

final def ne(arg0: AnyRef): Boolean

def newClient(dest: Name, label: String): ServiceFactory[ThriftClientRequest, Array[Byte]]

final def newClient(dest: String, label: String): ServiceFactory[ThriftClientRequest, Array[Byte]]

final def newClient(dest: String): ServiceFactory[ThriftClientRequest, Array[Byte]]

def newIface[Iface](name: Name, label: String, cls: Class[_]): Iface

def newIface[Iface](dest: Name, label: String)(implicit arg0: ClassTag[Iface]): Iface

def newIface[Iface](dest: String, label: String)(implicit arg0: ClassTag[Iface]): Iface

def newIface[Iface](dest: String)(implicit arg0: ClassTag[Iface]): Iface

def newIface[Iface](dest: String, label: String, cls: Class[_]): Iface

def newIface[Iface](dest: String, cls: Class[_]): Iface

def newMethodIface[ServiceIface, FutureIface](serviceIface: ServiceIface)(implicit builder: MethodIfaceBuilder[ServiceIface, FutureIface]): FutureIface

def newService(dest: Name, label: String): Service[ThriftClientRequest, Array[Byte]]

final def newService(dest: String, label: String): Service[ThriftClientRequest, Array[Byte]]

final def newService(dest: String): Service[ThriftClientRequest, Array[Byte]]

def newServiceIface[ServiceIface](dest: Name, label: String)(implicit builder: ServiceIfaceBuilder[ServiceIface]): ServiceIface

def newServiceIface[ServiceIface](dest: String, label: String)(implicit builder: ServiceIfaceBuilder[ServiceIface]): ServiceIface

final def notify(): Unit

final def notifyAll(): Unit

val protocolFactory: TProtocolFactory

def serve(addr: SocketAddress, factory: ServiceFactory[Array[Byte], Array[Byte]]): ListeningServer

def serve(addr: String, service: Service[Array[Byte], Array[Byte]]): ListeningServer

def serve(addr: String, service: ServiceFactory[Array[Byte], Array[Byte]]): ListeningServer

def serve(addr: SocketAddress, service: Service[Array[Byte], Array[Byte]]): ListeningServer

def serveAndAnnounce(name: String, service: Service[Array[Byte], Array[Byte]]): ListeningServer

def serveAndAnnounce(name: String, service: ServiceFactory[Array[Byte], Array[Byte]]): ListeningServer

def serveAndAnnounce(name: String, addr: String, service: Service[Array[Byte], Array[Byte]]): ListeningServer

def serveAndAnnounce(name: String, addr: String, service: ServiceFactory[Array[Byte], Array[Byte]]): ListeningServer

def serveAndAnnounce(name: String, addr: SocketAddress, service: Service[Array[Byte], Array[Byte]]): ListeningServer

def serveAndAnnounce(name: String, addr: SocketAddress, service: ServiceFactory[Array[Byte], Array[Byte]]): ListeningServer

def serveIface(addr: SocketAddress, iface: AnyRef): ListeningServer

def serveIface(addr: String, iface: AnyRef): ListeningServer

val server: Server

val serverLabel: String

val serverMuxer: ServerMuxer

lazy val serverStats: StatsReceiver

lazy val stats: StatsReceiver

final def synchronized[T0](arg0: ⇒ T0): T0

def toString(): String

final def wait(): Unit

final def wait(arg0: Long, arg1: Int): Unit

final def wait(arg0: Long): Unit

Deprecated Value Members

final def newClient(dest: Group[SocketAddress]): ServiceFactory[ThriftClientRequest, Array[Byte]]

def newIface[Iface](group: Group[SocketAddress], cls: Class[_]): Iface

def newIface[Iface](group: Group[SocketAddress])(implicit arg0: ClassTag[Iface]): Iface

final def newService(dest: Group[SocketAddress]): Service[ThriftClientRequest, Array[Byte]]

def newServiceIface[ServiceIface](dest: Name)(implicit builder: ServiceIfaceBuilder[ServiceIface]): ServiceIface

def newServiceIface[ServiceIface](dest: String)(implicit builder: ServiceIfaceBuilder[ServiceIface]): ServiceIface

def withClientId(clientId: ClientId): Client

def withProtocolFactory(pf: TProtocolFactory): Client

Inherited from ThriftRichServer

Inherited from finagle.Server[Array[Byte], Array[Byte]]

Inherited from ThriftRichClient

Inherited from finagle.Client[ThriftClientRequest, Array[Byte]]

Inherited from AnyRef

Inherited from Any

Ungrouped