akka.io

SslTlsSupport

class SslTlsSupport extends PipelineStage[HasLogging, Command, Command, Event, Event]

This pipeline stage implements SSL / TLS support, using an externally configured javax.net.ssl.SSLEngine. It operates on the level of Tcp.Event and Tcp.Command messages, which means that it will typically be one of the lowest stages in a protocol stack. Since SSLEngine relies on contiguous transmission of a data stream you will need to handle backpressure from the TCP connection actor, for example by using a BackpressureBuffer underneath the SSL stage.

Each instance of this stage has a scratch ByteBuffer of approx. 18kiB allocated which is used by the SSLEngine.

One thing to keep in mind is that there's no support for half-closed connections in SSL (but SSL on the other side requires half-closed connections from its transport layer).

This means: 1. keepOpenOnPeerClosed is not supported on top of SSL (once you receive PeerClosed the connection is closed, further CloseCommands are ignored) 2. keepOpenOnPeerClosed should always be enabled on the transport layer beneath SSL so that one can wait for the other side's SSL level close_notify message without barfing RST to the peer because this socket is already gone

Linear Supertypes
Type Hierarchy Learn more about scaladoc diagrams
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. SslTlsSupport
  2. PipelineStage
  3. AnyRef
  4. Any
Implicitly
  1. by any2stringadd
  2. by any2stringfmt
  3. by any2ArrowAssoc
  4. by any2Ensuring
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Instance Constructors

  1. new SslTlsSupport(engine: SSLEngine)

Value Members

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

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

    Definition Classes
    Any
  3. final def ##(): Int

    Definition Classes
    AnyRef → Any
  4. def +(other: String): String

    Implicit information
    This member is added by an implicit conversion from SslTlsSupport to StringAdd performed by method any2stringadd in scala.Predef.
    Definition Classes
    StringAdd
  5. def ->[B](y: B): (SslTlsSupport, B)

    Implicit information
    This member is added by an implicit conversion from SslTlsSupport to ArrowAssoc[SslTlsSupport] performed by method any2ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @inline()
  6. final def ==(arg0: AnyRef): Boolean

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

    Definition Classes
    Any
  8. def >>[CmdBelowBelow, EvtBelowBelow, BelowContext <: HasLogging](right: PipelineStage[_ >: BelowContext, Command, CmdBelowBelow, Event, EvtBelowBelow]): PipelineStage[BelowContext, Command, CmdBelowBelow, Event, EvtBelowBelow]

    Scala API: attach the two given stages such that the command output of the first is fed into the command input of the second, and the event output of the second is fed into the event input of the first.

    Scala API: attach the two given stages such that the command output of the first is fed into the command input of the second, and the event output of the second is fed into the event input of the first. In other words: sequence the stages such that the left one is on top of the right one.

    right

    the right or lower pipeline stage

    returns

    a pipeline stage representing the sequence of the two stages

    Definition Classes
    PipelineStage
  9. def apply(ctx: HasLogging): PipePair[Command, Command, Event, Event] { ... /* 6 definitions in type refinement */ }

    Implement this method to generate this stage’s pair of command and event functions.

    Implement this method to generate this stage’s pair of command and event functions.

    INTERNAL API: do not use this method to instantiate a pipeline!

    Definition Classes
    SslTlsSupportPipelineStage
    See also

    AbstractSymmetricPipePair

    AbstractPipePair

    PipelineFactory

  10. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  11. def clone(): AnyRef

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  12. def ensuring(cond: (SslTlsSupport) ⇒ Boolean, msg: ⇒ Any): SslTlsSupport

    Implicit information
    This member is added by an implicit conversion from SslTlsSupport to Ensuring[SslTlsSupport] performed by method any2Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  13. def ensuring(cond: (SslTlsSupport) ⇒ Boolean): SslTlsSupport

    Implicit information
    This member is added by an implicit conversion from SslTlsSupport to Ensuring[SslTlsSupport] performed by method any2Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  14. def ensuring(cond: Boolean, msg: ⇒ Any): SslTlsSupport

    Implicit information
    This member is added by an implicit conversion from SslTlsSupport to Ensuring[SslTlsSupport] performed by method any2Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  15. def ensuring(cond: Boolean): SslTlsSupport

    Implicit information
    This member is added by an implicit conversion from SslTlsSupport to Ensuring[SslTlsSupport] performed by method any2Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  16. final def eq(arg0: AnyRef): Boolean

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

    Definition Classes
    AnyRef → Any
  18. def finalize(): Unit

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  19. def formatted(fmtstr: String): String

    Implicit information
    This member is added by an implicit conversion from SslTlsSupport to StringFormat performed by method any2stringfmt in scala.Predef.
    Definition Classes
    StringFormat
    Annotations
    @inline()
  20. final def getClass(): Class[_]

    Definition Classes
    AnyRef → Any
  21. def hashCode(): Int

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

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

    Definition Classes
    AnyRef
  24. final def notify(): Unit

    Definition Classes
    AnyRef
  25. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  26. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef
  27. def toString(): String

    Definition Classes
    AnyRef → Any
  28. final def wait(): Unit

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

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

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  31. def |[RightContext <: HasLogging](right: PipelineStage[_ >: RightContext, Command, Command, Event, Event]): PipelineStage[RightContext, Command, Command, Event, Event]

    Scala API: combine the two stages such that the command pipeline of the left stage is used and the event pipeline of the right, discarding the other two sub-pipelines.

    Scala API: combine the two stages such that the command pipeline of the left stage is used and the event pipeline of the right, discarding the other two sub-pipelines.

    right

    the event pipeline

    returns

    a pipeline stage using the left command pipeline and the right event pipeline

    Definition Classes
    PipelineStage
  32. def [B](y: B): (SslTlsSupport, B)

    Implicit information
    This member is added by an implicit conversion from SslTlsSupport to ArrowAssoc[SslTlsSupport] performed by method any2ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc

Shadowed Implicit Value Members

  1. val self: Any

    Implicit information
    This member is added by an implicit conversion from SslTlsSupport to StringAdd performed by method any2stringadd in scala.Predef.
    Shadowing
    This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
    To access this member you can use a type ascription:
    (sslTlsSupport: StringAdd).self
    Definition Classes
    StringAdd
  2. val self: Any

    Implicit information
    This member is added by an implicit conversion from SslTlsSupport to StringFormat performed by method any2stringfmt in scala.Predef.
    Shadowing
    This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
    To access this member you can use a type ascription:
    (sslTlsSupport: StringFormat).self
    Definition Classes
    StringFormat

Deprecated Value Members

  1. def x: SslTlsSupport

    Implicit information
    This member is added by an implicit conversion from SslTlsSupport to ArrowAssoc[SslTlsSupport] performed by method any2ArrowAssoc in scala.Predef.
    Shadowing
    This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
    To access this member you can use a type ascription:
    (sslTlsSupport: ArrowAssoc[SslTlsSupport]).x
    Definition Classes
    ArrowAssoc
    Annotations
    @deprecated
    Deprecated

    (Since version 2.10.0) Use leftOfArrow instead

  2. def x: SslTlsSupport

    Implicit information
    This member is added by an implicit conversion from SslTlsSupport to Ensuring[SslTlsSupport] performed by method any2Ensuring in scala.Predef.
    Shadowing
    This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
    To access this member you can use a type ascription:
    (sslTlsSupport: Ensuring[SslTlsSupport]).x
    Definition Classes
    Ensuring
    Annotations
    @deprecated
    Deprecated

    (Since version 2.10.0) Use resultOfEnsuring instead

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion any2stringadd from SslTlsSupport to StringAdd

Inherited by implicit conversion any2stringfmt from SslTlsSupport to StringFormat

Inherited by implicit conversion any2ArrowAssoc from SslTlsSupport to ArrowAssoc[SslTlsSupport]

Inherited by implicit conversion any2Ensuring from SslTlsSupport to Ensuring[SslTlsSupport]

Ungrouped