Server

Servers implement RPC servers with Req-typed requests and Rep-typed responses. Servers dispatch requests to a com.twitter.finagle.Service or com.twitter.finagle.ServiceFactory provided through serve.

Servers are implemented by the various protocol packages in finagle, for example com.twitter.finagle.Http:

object Http extends Server[HttpRequest, HttpResponse] ...

val server = Http.serve(":*", new Service[HttpRequest, HttpResponse] {
  def apply(req: HttpRequest): Future[HttpResponse] = ...
})

Will bind to an ephemeral port (":*") and dispatch request to server.boundAddress to the provided com.twitter.finagle.Service instance.

The serve method has two variants: one for instances of Service, and another for ServiceFactory. The ServiceFactory variants are used for protocols in which connection state is significant: a new Service is requested from the ServiceFactory for each new connection, and requests on that connection are dispatched to the supplied service. The service is also closed when the client disconnects or the connection is otherwise terminated.

Linear Supertypes

AnyRef, Any

Known Subclasses

DefaultServer

Abstract Value Members

abstract def serve(addr: SocketAddress, service: ServiceFactory[Req, Rep]): ListeningServer

Serve service on addr

Concrete Value Members

final def !=(arg0: AnyRef): Boolean

Definition Classes
AnyRef
final def !=(arg0: Any): Boolean

Definition Classes
Any
final def ##(): Int

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

Definition Classes
AnyRef
final def ==(arg0: Any): Boolean

Definition Classes
Any
final def asInstanceOf[T0]: T0

Definition Classes
Any
def clone(): AnyRef

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws()
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()
final def getClass(): Class[_]

Definition Classes
AnyRef → Any
def hashCode(): Int

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

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

Definition Classes
AnyRef
final def notify(): Unit

Definition Classes
AnyRef
final def notifyAll(): Unit

Definition Classes
AnyRef
def serve(target: String, service: Service[Req, Rep]): ListeningServer

Serve service on target.
def serve(target: String, service: ServiceFactory[Req, Rep]): ListeningServer

Serve service on target.
def serve(addr: SocketAddress, service: Service[Req, Rep]): ListeningServer

Serve service on addr
def serveAndAnnounce(name: String, service: Service[Req, Rep]): ListeningServer

Serve service on target and announce with name.
Serve service on target and announce with name. Announcements will be removed when the service is closed. Omitting the target will bind to an ephemeral port.
def serveAndAnnounce(name: String, service: ServiceFactory[Req, Rep]): ListeningServer

Serve service on target and announce with name.
Serve service on target and announce with name. Announcements will be removed when the service is closed. Omitting the target will bind to an ephemeral port.
def serveAndAnnounce(name: String, target: String, service: Service[Req, Rep]): ListeningServer

Serve service on target and announce with name.
Serve service on target and announce with name. Announcements will be removed when the service is closed. Omitting the target will bind to an ephemeral port.
def serveAndAnnounce(forum: String, target: String, service: ServiceFactory[Req, Rep]): ListeningServer

Serve service on target and announce with name.
Serve service on target and announce with name. Announcements will be removed when the service is closed. Omitting the target will bind to an ephemeral port.
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()

trait Server[Req, Rep] extends AnyRef

Abstract Value Members

abstract def serve(addr: SocketAddress, service: ServiceFactory[Req, Rep]): ListeningServer

Concrete Value Members

final def !=(arg0: AnyRef): Boolean

final def !=(arg0: Any): Boolean

final def ##(): Int

final def ==(arg0: AnyRef): Boolean

final def ==(arg0: Any): Boolean

final def asInstanceOf[T0]: T0

def clone(): AnyRef

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

final def ne(arg0: AnyRef): Boolean

final def notify(): Unit

final def notifyAll(): Unit

def serve(target: String, service: Service[Req, Rep]): ListeningServer

def serve(target: String, service: ServiceFactory[Req, Rep]): ListeningServer

def serve(addr: SocketAddress, service: Service[Req, Rep]): ListeningServer

def serveAndAnnounce(name: String, service: Service[Req, Rep]): ListeningServer

def serveAndAnnounce(name: String, service: ServiceFactory[Req, Rep]): ListeningServer

def serveAndAnnounce(name: String, target: String, service: Service[Req, Rep]): ListeningServer

def serveAndAnnounce(forum: String, target: String, service: ServiceFactory[Req, Rep]): ListeningServer

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

Inherited from AnyRef

Inherited from Any

Ungrouped