New Features

• finagle-base-http: Add Message.httpDateFormat(millis) to format the epoch millis into
  an RFC 7231 formatted String representation. eb9bec0e
• finagle-core: Introduce an StackClient.withStack overload that
  makes modifying the existing Stack easier when using method chaining.
  8f69e833
• finagle-mysql: Introduce session to be able to perform multiple operations that require
  session state on a guaranteed single connection. a06f7d67
• finagle-netty4: When using the native epoll transport, finagle now publishes the TCP window size
  and number of retransmits based on the tcpInfo provided by from the channel. These stats are
  published with a debug verbosity level. 16071088
• finagle-http: HTTP clients and servers now accept fixedLengthStreamedAfter param in their
  withStreaming configuration (default: 5 MB when streaming is enabled). This new parameter
  controls the limit after which Finagle will stop aggregating messages with known Content-Length
  (payload will be available at .content) and switch into a streaming mode (payload will be
  available at .reader). Note messages with Transfer-Encoding: chunked never aggregated.
  842e5e1a

Breaking API Changes

• finagle-http: c.t.f.http.param.MaxChunkSize has been removed. There is no good reason to
  configure it with anything but Int.MaxValue (unlimited). 990c8650
• finagle-exp: Update DarkTrafficFilter#handleFailedInvocation to accept the request type
  for more fidelity in handling the failure. b247f941

Runtime Behavior Changes

• finagle-http: Unset maxChunkSize limit in Netty HTTP codecs. Now both clients and servers
  emit all available data as a single chunk so we can put it into use quicker.
  990c8650
• finagle-http: Streaming clients (withStreaming(true)) now aggregate inbound messages with known
  Content-Length if their payloads are less than 5mb (8k before). Use withStreaming(true, 32.kb)
  to override it with a different value. 24271b29
• finagle-http2: HTTP/2 servers perform a more graceful shutdown where an initial
  GOAWAY is sent with the maximum possible stream id and waits for either the client
  to hang up or for the close deadline, at which time a second GOAWAY is sent with
  the true last processed stream and the connection is then closed.
  93fee499

Deprecations

• finagle-core: Deprecate
  EndpointerStackClient.transformed(Stack[ServiceFactory[Req, Rep]] => Stack[ServiceFactory[Req, Rep]])
  in favor of the withStack variant. 8f69e833

Deprecations

• finagle-core: Deprecation warnings have been removed from the 'status', 'onClose',
  and 'close' methods on c.t.f.t.Transport, and added to the corresponding methods
  on c.t.f.t.TransportContext. 9ae6d978

Runtime Behavior Changes

• finagle-netty3: Implementations for 'status', 'onClose', and 'close' methods have
  been moved from c.t.f.n.t.ChannelTransportContext to c.t.f.n.t.ChannelTransport.
  9ae6d978

18.8.0

New Features

• finagle-core: Introducing the new c.t.f.tracing.Tracing API for more efficient tracing
  (dramatically reduces the number of context lookups; see scaladoc for c.t.f.tracing.Trace).
  547cd864

• finagle-core: c.t.f.tracing.Trace facade API now provides forwarding record methods for
  all kinds of annotations and is a preffered way of recording traces. 50c00d88

• finagle-thriftmux: Promote the push-based ThriftMux implementation out of experimental
  status.eedd1fd8

Breaking API Changes

• finagle-base-http: c.t.f.http.cookie.exp.supportSameSiteCodec has been moved out of the
  exp package to c.t.f.http.cookie.supportSameSiteCodec. 5e5ea390

• finagle-core: Parameter-less annotation classes (c.t.f.tracing.Annotation) have been
  promoted to objects for efficiency reasons. 50c00d88

• finagle-core: c.t.f.tracing.Trace.record(Record) now accepts the record argument by
  value (previously by name). 33841d21

• finagle-core: c.t.f.Failure.{Restartable, Interrupted, Ignorable, DeadlineExceeded, Wrapped, Rejected, NonRetryable} are deprecated in favor of the c.t.f.FailureFlags
  analogs. 0e0c7b43

• finagle-core: c.t.f.Leaf and c.t.f.Node are now private; use Stack.leaf and
  Stack.node instead. cc49ee83

• finagle-core: Marked transform in com.twitter.finagle.Stack as protected. It is too
  powerful and unnecessary for users, and should be for implementor use only. 99479f32

• finagle-mysql: c.t.f.mysql.CanBeParameter's implicit conversions timestampCanBeParameter,
  sqlDateCanBeParameter, and javaDateCanBeParameter have been consolidated into a single
  implicit, dateCanBeParameter. b486772d

Bug Fixes

• finagle-http2: Fixed a race condition caused by c.t.f.http.transport.StreamTransports being
  closed, but that status not being reflected right away, causing a second request to fail.
  68f1035f

Runtime Behavior Changes

• finagle-core: c.t.f.tracing.Trace API is no longer guarding Trace.record calls behind
  Trace.isActivelyTracing. Add Trace.isActivelyTracing guards on the call sites if
  materializing tracing annotations is a performance concern. 33841d21

• finagle-mysql: Clients will now issue a ROLLBACK each time a service is checked back
  into the connection pool. This can be disabled via Mysql.Client.withNoRollback.
  e3221597

• finagle-thriftmux: The push-based server muxer is now the default. In both synthetic tests
  and production it has shown signifcant performance benefits and is simpler to maintain.
  735a6bae

• finagle-mysql: Remove deprecated TimestampValue.apply(Timestamp) and
  TimestampValue.unapply(value) methods. Use TimestampValue.apply(TimeZone, TimeZone)
  instead. e01f02f5

Deprecations

• finagle-mux: The pull based mux implementation, c.t.f.Mux, has been deprecated in favor of
  the push-based mux implementation, c.t.f.pushsession.MuxPush. 735a6bae

New Features

• finagle-core: There is now an implicit instance for Finagle's default timer:
  DefaultTimer.Implicit. 64963bd8

• finagle-core: Introduce new command-line flag c.t.f.tracing.enabled to entirely
  disable/enable tracing for a given process (default: true). 5a5ceb63

• finagle-mysql: com.twitter.util.Time can now be used with
  PreparedStatements without converting the ctu.Time to a java.sql.Timestamp.
  bbca48c7

• finagle-stats: Adds a lint rule to detect when metrics with colliding names are used.
  26a2c3bd

Breaking API Changes

• finagle-core: c.t.f.dispatch.ClientDispatcher.wrapWriteException has been turned from a
  partial function instance into a static total function. 9a3c9070

• finagle-mux: ClientDiscardedRequestException now extends FailureFlags and is no longer
  a case class. fe8c6496

Runtime Behavior Changes

• finagle-core: Server-side rejections from c.t.f.filter.RequestSempahoreFilter.module are now
  captured by c.t.f.service.StatsFilter. They will roll up under "/failures",
  "/failures/rejected", and "/failures/restartable" in stats. 3b755c8a

• finagle-core: c.t.f.tracing.Trace.tracers now returns only distinct tracers stored in
  the local context (returned all tracers before). b96bb137

• finagle-http: HTTP param decoding is no longer truncated to 1024 params.
  24662bea

• finagle-mux: When mux propagates an interrupt started by BackupRequestFilter over the
  network, the FailureFlags.Ignorable status is propagated with it. fe8c6496

Runtime Behavior Changes

• finagle-core: By default, the deterministic aperture load balancer doesn't expand
  based on the loadband. This is because the loadband is influenced by a degree of
  randomness, and this breaks the deterministic part of deterministic aperture and
  can lead to aggressive banding on backends. 3d84e297

• finagle-http2: Unprocessed streams are retryable in case of GOAWAY.
  2c89cb9e

New Features

• finagle-core: Add PropagateDeadlines Stack.Param to TimeoutFilter for
  disabling propagation of deadlines to outbound requests.
  8041fbb9

• finagle-core: Add toString implementations to c.t.finagle.Service and
  c.t.finagle.Filter. Update in Filter#andThen composition to expose a
  useful toString for composed Filters and a composed Service (a Filter chain
  with a terminal Service or ServiceFactory).

  The default implementation for Filter and Service is getClass.getName. When
  composing filters, the andThen composition method correctly tracks the composed
  parts to produce a useful toString, e.g.,

  package com.foo

  import com.twitter.finagle.{Filter, Service}
  import com.twitter.util.Future

  class MyFilter1 extends Filter[Int, Int, Int, Int] {
     def apply(request: Int, service: Service[Int, Int]): Future[Int] = ???
  }

  ...

  package com.foo

  import com.twitter.finagle.{Filter, Service}
  import com.twitter.util.Future

  class MyFilter2 extends Filter[Int, Int, Int, Int] {
    def apply(request: Int, service: Service[Int, Int]): Future[Int] = ???
  }

  val filters = (new MyFilter1).andThen(new MyFilter2)

filters.toString would emit the String "com.foo.MyFilter1.andThen(com.foo.MyFilter2)"

If a Service (or ServiceFactory) were then added:

  import com.twitter.finagle.{Filter, Service}
  import com.twitter.finagle.service.ConstantService
  import com.twitter.util.Future

  ...

  val svc: Service[Int, Int] = filters.andThen(new ConstantService[Int, Int](Future.value(2)))

Then, svc.toString would thus return the String:
"com.foo.MyFilter1.andThen(com.foo.MyFilter2).andThen(com.twitter.finagle.service.ConstantService(ConstFuture(2)))"

Filter implementations are permitted to override their toString implementations which would
replace the default of getClass.getName. 25474da1

• finagle-core: Make Filter.TypeAgnostic an abstract class for Java usability.
  6534e459

• finagle-core: c.t.f.filter.NackAdmissionFilter is now public. 1855566d

• finagle-core: Extended c.t.f.ssl.KeyCredentials and c.t.f.ssl.TrustCredentials to work
  with javax.net.ssl.KeyManagerFactory and javax.net.ssl.TrustManagerFactory respectively.
  c863ca0b

Breaking API Changes

• finagle-core: Rename DeadlineFilter.Param(maxRejectFraction) to
  DeadlineFilter.MaxRejectFraction(maxRejectFraction) to reduce confusion
  when adding additional params.
  cb6975af

Bug Fixes

• finagle-http2: StreamTransportFactory now marks itself as dead/closed when it runs out of
  HTTP/2 stream IDs instead of stalling. This allows the connection to be closed/reestablished in
  accordance with the spec c5554673

• finagle-netty4: SslServerSessionVerifier is now supplied with the proper peer address
  rather than Address.failing. 263e9786

• finagle-thrift/thriftmux: Disabled client side per-endpoint stats by default for client
  ServicePerEndpoint. It can be set via c.t.f.thrift.RichClientParam or a with-method
  as Thrift{Mux}.client.withPerEndpointStats. 0f1ff3eb

• finagle-netty4: Avoid NoClassDefFoundError if netty-transport-native-epoll is not available
  on the classpath. 940809af

New Features

• finagle-base-http: Added ability to add SameSite attribute to Cookies to
  comply with https://tools.ietf.org/html/draft-west-first-party-cookies-07.
  The attribute may be set in the constructor via the c.t.f.http.Cookie
sameSite param or via the c.t.f.http.Cookie.sameSite method.

  • Pass SameSite.Lax to the Cookie to add the "Lax" attribute.
  • Pass SameSite.Strict to the Cookie to add the "Strict" attribute.
    4b0a58b0

• finagle-base-http: Introduced an API to extract query string params from a
  c.t.f.http.Request, c.t.f.http.Uri.fromRequest and c.t.f.http.Uri#params.
  0dd0a425

• finagle-mysql: Added APIs to Row which simplify the common access pattern.
  For example, Row.stringOrNull(columnName: String): String and
  Row.getString(columnName: String): Option[String].
  f3676d31, f3676d31

• finagle-mysql: Added read and modify APIs to c.t.f.mysql.Client and
  c.t.f.mysql.PreparedStatement for that return the specific type of
  Result for those operations, ResultSet and OK respectively.
  2f3650cf

• finagle-serversets: Zk2Session's AsyncSemaphore which controls the maximum
  concurrent Zk operations is configurable (GlobalFlag c.t.f.serverset2.zkConcurrentOperations).
  [3160a815](https://github.com/twitter/finagle/commit/3160a815c2552773a67d834841b029dca5ba0122)

• finagle-mysql: Address CursoredStatement usability from Java via
  CursoredStatement.asJava(). Through this, you can use the API with
  varargs and Java 8 lambdas. f67978aa

• finagle-toggle: Improved Java compatiblity for ToggleMap and Toggle. 16dbe170

• finagle-toggle: StandardToggleMap.apply and StandardToggleMap.registeredLibraries now
  use ToggleMap.Mutable to better support mutating the underlying mutable ToggleMap.
  8b136a22

Breaking API Changes

• finagle-mux: With the introduction of the push-based mux client, we've
  removed the need for the optimized c.t.f.Mux.Netty4RefCountingControl
  MuxImpl, which has been removed. 35980463

• finagle-mysql: c.t.f.mysql.Client.ping now returns a Future[Unit]
  instead of the broad Future[Result] ADT. 2f3650cf

• finagle-toggle: Changed ToggleMap.Mutable from a trait to an abstract class, and
  ToggleMap.Proxy no longer extends ToggleMap, but now has a self-type that conforms to
  ToggleMap instead. 16dbe170

Runtime Behavior Changes

• finagle-core: Add c.t.f.SslException to better model exceptions related to SSL/TLS.
  The c.t.f.ChannelException.apply method will now wrap javax.net.ssl.SSLExceptions in
  c.t.f.SslException. 955a0b3e

• finagle-core: MethodBuilder metrics now include failures.
  f58ab46f, f58ab46f

• finagle-http: ServerAdmissionControl is circumvented for HTTP requests that have
  a body unless the request contains the header 'finagle-http-retryable-request' since
  it cannot be known whether the client can actually retry them, potentially resulting
  in depressed success rates during periods of throttling. 4377f02a

• finagle-http2: Clients and servers no longer attempt a cleartext upgrade if the
  first request of the HTTP/1.1 session has a body. bf09dd4c

• finagle-thriftmux: The push-based client muxer is now the default muxer implementation.
  The push-based muxer has better performance and a simpler architecture. cc333151

• finagle-toggle: ToggleMap.Proxy#underlying is now public, and ToggleMap.Proxy
  participates in ToggleMap.components. 8b136a22

Bug Fixes

• finagle-base-http: Concurrent modification of the c.t.f.http.DefaultHeaderMap could
  result in an infinite loop due to HashMap corruption. Access is now synchronized to avoid
  the infinite loop. aa73d24d

• finagle-core: FailureFlags that have their flags set modified will now
  retain the original stack trace, suppressed Throwables, and cause when possible.
  f4543472

• finagle-memcached: Added the missing support for partial success for the batch
  operations in the new PartitioningService based Memcached client. 970af633

• finagle-thrift: Removed copied libthrift files. 9deb18b4

• finagle-thrift/thriftmux: Server side per-endpoint statsFilter by default is disabled now.
  It can be set via c.t.f.thrift.RichServerParam or a with-method as
  Thrift{Mux}.server.withPerEndpointStats. 7b0281c5

New Features

• finagle-core: c.t.f.filter.NackAdmissionFilter can now be disabled via a with-method.
  $Protocol.client.withAdmissionControl.noNackAdmissionControl 323a20f4

• finagle-mysql: Exceptions now include the SQL that was being executed when possible.
  5a54f45d

• finagle-mysql: Address PreparedStatement usability from Java via
  PreparedStatement.asJava(). Through this, you can use the API with
  varargs and Java 8 lambdas. c5bd6b97

• finagle-mysql: Added support for Option\s to Parameter implicits. This
  allows for the natural represention of nullable columns with an Option
  where a None is treated as a null. 48f688d1

• finagle-netty4: Add 'tls/connections' gauge for Finagle on Netty 4 which tracks the number
  of open SSL/TLS connections per Finagle client or server.
  911a01ce

• finagle-redis: Support has been added for a number of new cluster commands
  introduced in Redis 3.0.0. 86b151bf

Bug Fixes

• finagle-mysql: Fix handling of interrupts during transactions. 1b9111eb

Breaking API Changes

• finagle-core: c.t.f.ssl.client.HostnameVerifier has been removed since it was using
  sun.security.util.HostnameChecker which is no longer accessible in JDK 9.
  1313d9ba

• finagle-thrift: Upgraded libthrift to 0.10.0, c.t.f.thrift.Protocols.TFinagleBinaryProtocol
  constructor now takes stringLengthLimit and containerLengthLimit, NO_LENGTH_LIMIT value
  changed from 0 to -1. 61c7a711

• finagle-thrift: Move "stateless" methods in c.t.finagle.thrift.ThriftRichClient
  to c.t.finagle.thrift.ThriftClient. Then mix the ThriftClient trait into the
  ThriftMux and Thrift Client companions to make it clearer that these stateless methods
  are not affected by the changing state of the configured client instance but are instead
  simply utility methods which convert or wrap the incoming argument. 7a175a98

• finagle-base-http: Removed deprecated c.t.f.Cookie.value_=; use c.t.f.Cookie.value
  instead. 4bdd261b

• finagle-base-http: Removed deprecated c.t.f.Cookie.domain_=; use c.t.f.Cookie.domain
  instead. 4bdd261b

• finagle-base-http: Removed deprecated c.t.f.Cookie.path_=; use c.t.f.Cookie.path
  instead. 4bdd261b

Runtime Behavior Changes

• finagle-core: Add minimum request threshold for successRateWithinDuration failure accrual.
  b6caf3dd

• finagle-core: c.t.f.filter.NackAdmissionFilter no longer takes effect when
  the client's request rate is too low to accurately update the EMA value or
  drop requests. 387d87d4

• finagle-core: SSL/TLS client hostname verification is no longer performed by
  c.t.f.ssl.client.HostnameVerifier. The same underlying library
  sun.security.util.HostnameChecker is used to perform the hostname verification.
  However it now occurs before the SSL/TLS handshake has been completed, and the
  exception on failure has changes from a c.t.f.SslHostVerificationException to a
  javax.net.ssl.CertificateException. 1313d9ba

• finagle-core: Closing c.t.f.NullServer is now a no-op. 36aac62c

• finagle-netty4: Netty ByteBuf leak tracking is enabled by default. 24690b13

Deprecations

• finagle-thrift: System property "-Dorg.apache.thrift.readLength" is deprecated. Use
  constructors to set read length limit for TBinaryProtocol.Factory and TCompactProtocol.Factory.
  61c7a711

New Features

• finagle-core: c.t.f.client.BackupRequestFilter.filterService for wrapping raw services in a
  c.t.f.client.BackupRequestFilter is now public. b227d988

• finagle-core: Introduce c.t.f.Stacks.EMPTY_PARAMS for getting an empty Param map from
  Java, and c.t.f.Stack.Params.plus for easily adding Params to a Param map from Java.
  43e0f007

Bug Fixes

• finagle-core: c.t.f.liveness.FailureAccrualFactory takes no action on c.t.f.Failure.Ignorable
  responses. 512894cf

• finagle-core: c.t.f.pool.WatermarkPool is resilient to multiple closes on a service instance.
  37c29e9e

• finagle-core: c.t.f.pool.CachingPool service wrapper instances are resilient to multiple closes.
  ce779ec7

• finagle-core: Requeue module now closes sessions it prevented from propagating up the stack.
  f5cdda14

• finagle-base-http: c.t.f.http.Netty4CookieCodec.encode now wraps Cookie values that would
  be wrapped in c.t.f.http.Netty3CookieCodec.encode. 78fdc9aa

• finagle-base-http: c.t.f.http.Cookie.maxAge returns c.t.f.http.Cookie.DefaultMaxAge
  (instead of null) if maxAge has been set to null or None in the copy constructor
  17a32d44.

• finagle-http: The HTTP client will not attempt to retry nacked requests with streaming
  bodies since it is likely that at least part of the body was already consumed and therefore
  it isn't safe to retry. a787955b

Breaking API Changes

• finagle-base-http: Removed c.t.f.http.Cookie.comment_, c.t.f.http.Cookie.comment_=,
  c.t.f.http.Cookie.commentUrl_, and c.t.f.http.Cookie.commentUrl_=. comment and commentUrl
  per RFC-6265. NOT FOUND: D137538

• finagle-base-http: Removed deprecated c.t.f.http.Cookie.isDiscard and
  c.t.f.http.Cookie.isDiscard_=, per RFC-6265. 0e03b630

• finagle-base-http: Removed deprecated c.t.f.http.Cookie.ports and
  c.t.f.http.Cookie.ports_=, per RFC-6265. 0469f5b1

• finagle-base-http: c.t.f.http.RequestBuilder has been moved to the finagle-http target
  and the implicit evidence, RequestConfig.Yes has been renamed to RequestBuilder.Valid.
  1632856c

• finagle-base-http: Removed deprecated c.t.f.Cookie.isSecure; use c.t.f.Cookie.secure
  instead. Removed deprecated c.t.f.Cookie.isSecure_=. 33d75b95

• finagle-base-http: Removed deprecated c.t.f.http.Cookie.version and
  c.t.f.http.Cookie.version_=, per RFC-6265. 6c9020cc

• finagle-core: c.t.f.pool.WatermarkPool was finalized. 37c29e9e

• finagle-core: c.t.finagle.ssl.Ssl and related classes have been
  removed. They were replaced as the primary way of using SSL/TLS
  within Finagle in release 6.44.0 (April 2017). Please migrate to using
  c.t.f.ssl.client.SslClientEngineFactory or
  c.t.f.ssl.server.SslServerEngineFactory instead. d10a42b8

• finagle-core: Removed newSslEngine and newFinagleSslEngine from
  ServerBuilder. Please implement a class which extends
  c.t.f.ssl.server.SslServerEngineFactory with the previously passed in
  function used as the implementation of the apply method. Then use the
  created engine factory with one of the tls methods instead.
  d10a42b8

• finagle-core: The deprecated c.t.f.loadbalancer.DefaultBalancerFactory has been removed.
  f6971d76

• finagle-exp: The deprecated c.t.f.exp.BackupRequestFilter has been removed. Please use
  c.t.f.client.BackupRequestFilter instead. 350d8821

• finagle-http: Removed the c.t.f.Http.Netty3Impl. Netty4 is now the only
  underlying HTTP implementation available. ef9fedb1

• finagle-zipkin-scribe: Renamed the finagle-zipkin module to finagle-zipkin-scribe, to
  better advertise that this is just the scribe implementation, instead of the default.
  c23ef398

New Features

• finagle-core: Add orElse to allow composition of FailureAccrualPolicys.
  8c1e718e

• finagle-core: c.t.f.http.MethodBuilder now exposes a method newService without a
  methodName to create a client. c.t.f.thriftmux.MethodBuilder now exposes a
  method servicePerEndpoint without a methodName to create a client. d8e010d6

• finagle-thriftmux: Expose the underlying configured client label in the
  c.t.finagle.thriftmux.MethodBuilder. 653e2696

Bug Fixes

• finagle-http2: http2 servers no longer leak ping bodies. 02841dfd

Deprecations

• finagle-core: c.t.finagle.ssl.Ssl and related classes have been
  deprecated. They were replaced as the primary way of using SSL/TLS
  within Finagle in release 6.44.0 (April 2017). Please migrate to using
  c.t.f.ssl.client.SslClientEngineFactory or
  c.t.f.ssl.server.SslServerEngineFactory instead. 0b8a2890

Breaking API Changes

• finagle-base-http: c.t.f.h.codec.HttpCodec has been moved to the finagle-http
  project. 350953ae

• finagle base-http: c.t.f.h.Request.multipart has been removed.
  Use c.t.f.h.exp.MultipartDecoder instead. b9d71e36

• finagle-http: Split the toggle 'c.t.f.h.UseH2C' into a client-side toggle and a
  server-side toggle, named 'c.t.f.h.UseH2CClients', and 'c.t.f.h.UseH2CServers',
  respectively. 0d960398

Runtime Behavior Changes

• finagle-core: Finagle clients with retry budgets or backoffs should no
  longer have infinite hash codes. 88e7bea9

New Features

• finagle-core: FailureDetector has a new method, onClose, which provides
  a Future that is satisfied when the FailureDetector marks a peer as Closed.
  PHAB_ID=D126840

• finagle-core: Introduce trace logging of requests as they flow through a
  Finagle client or server. These logs can be turned on at runtime by setting
  the "com.twitter.finagle.request.Logger" logger to trace level.
  PHAB_ID=D124352

• finagle-http2: HTTP/2 clients now expose the number of currently opened streams under
  the $client/streams gauge. PHAB_ID=D127238

• finagle-http2: HTTP/2 servers now expose the number of currently opened streams under
  the $server/streams gauge. PHAB_ID=D127667

• finagle-memcached: By default, the Memcached client now creates two connections
  to each endpoint, instead of 4. PHAB_ID=D119619

• finagle-redis: Add support for redis Geo Commands. PHAB_ID=D123167 based on the PR
  #628 written by Mura-Mi [https://github.com/Mura-Mi]

• finagle-thrift: Add c.t.f.thrift.service.ThriftServiceBuilder and
  c.t.f.thrift.service.ReqRepThriftServiceBuilder for backwards compatibility
  of creating higher-kinded method-per-endpoint clients. PHAB_ID=D127538

• finagle-core: c.t.f.http.MethodBuilder and c.t.f.thriftmux.MethodBuilder now
  expose idempotent and nonIdempotent methods, which can be used to configure
  retries and the sending of backup requests. PHAB_ID=D122087

Bug Fixes

• finagle-mysql: Fix a bug with transactions where an exception during a rollback
  could leave the connection with a partially committed transaction. PHAB_ID=D122771

• finagle-toggle: c.t.f.toggle.Toggles are independent; that is, applying the same value to
  two different toggles with the same fraction will produce independent true/false
  values. PHAB_ID=D128172

Runtime Behavior Changes

• finagle-core, finagle-netty4: When creating engines, SslClientEngineFactories now use
  SslClientEngineFactory.getHostString instead of SslClientEngineFactory.getHostname.
  This no longer performs an unnecessary reverse lookup when a hostname is not supplied
  as part of the SslClientConfiguration. PHAB_ID=D124369

• finagle-http2: Supplies a dependency on io.netty.netty-tcnative-boringssl-static,
  which adds support for ALPN, which is necessary for encrypted http/2. To use a
  different static ssl dependency, exclude the tcnative-boringssl dependency and
  manually depend on the one you want to use. PHAB_ID=D119555

Breaking API Changes

• finagle-base-http, finagle-http: Removed Apache Commons Lang dependency,
  org.apache.commons.lang3.time.FastDateFormat now is java.time.format.DateTimeFormatter.
  PHAB_ID=D121479

• finagle-base-http: c.t.f.http.Message.headerMap is now an abstract method.
  PHAB_ID=D120931

• finagle-core: c.t.f.ssl.server.SslServerSessionVerifier no longer uses the unauthenticated
  host information from SSLSession. PHAB_ID=D124815

• finagle-memcached: ConcurrentLoadBalancerFactory was removed and its behavior
  was replaced by a Stack.Param inside finagle-core's LoadBalancerFactory.
  PHAB_ID=D119394

• finagle-thrift, finagle-thriftmux: Remove ReqRep specific methods. Since the "ReqRep"
  builders are now subclasses of their non-"ReqRep" counterparts their is no longer a
  need to expose "ReqRep" specific methods. PHAB_ID=D123341

Deprecations

• finagle-exp: c.t.f.exp.BackupRequestFilter has been deprecated. Please use
  c.t.f.client.BackupRequestFilter instead. PHAB_ID=D122344

• finagle-http: c.t.f.http.Request.multipart has been deprecated.
  Use c.t.f.http.exp.MultipartDecoder instead. PHAB_ID=D126013

New Features

• finagle-core: Expose Tunables for MethodBuilder timeout configuration. Update
  the http.MethodBuilder and thriftmux.MethodBuilder to accept Tunables for
  configuring total and per-request timeouts. c912dd4b

• finagle-thrift, finagle-thriftmux: Add support for Scrooge
  ReqRepServicePerEndpoint functionality. df5f10bd

• finagle-thriftmux: Add support for Scrooge ServicePerEndpoint and
  ReqRepServicePerEndpoint functionality to thriftmux.MethodBuilder.
  3abaa524

Breaking API Changes

• finagle-base-http: Remove deprecated [Request|Response].[encode|decode][Bytes|String]
  methods. Use c.t.f.h.codec.HttpCodec methods instead. 006de6a3

• finagle-thrift: Move ThriftRichClient and ThriftRichServer to
  c.t.finagle.thrift package. fcf66bae

Runtime Behavior Changes

• finagle-core: The "pipelining/pending" stat has been removed from protocols
  using c.t.f.dispatch.PipeliningClientDispatcher. Refer to the "pending" stat
  for the number of outstanding requests. 0d162d17

• finagle-thrift,thriftmux: Tracing of RPC method names has been removed. This
  concern has moved into Scrooge. df161758

Deprecations

• finagle-core: c.t.f.BackupRequestLost has been deprecated. Please use a
  c.t.f.Failure flagged c.t.f.Failure.Ignorable instead. fb37aed5

New Features

• finagle-core: Add ResponseClassifiers, RetryOnTimeout and RetryOnChannelClosed,
  for exceptions that are commonly retried when building from ClientBuilder but had
  no MethodBuilder equivalents. 3d292b49

• finagle-netty4: Netty4Transporter and Netty4Listener are now accessible, which
  allows external users to create their own protocols for use with Finagle on Netty 4.
  3ce475db

Bug Fixes

• finagle-exp: Fix race condition in LatencyHistogram which could lead to the wrong
  value returned for quantile. 947884f5

Breaking API Changes

• finagle-core: Numerous overloads of c.t.f.Server.serve have been marked final.
  ea543806

• finagle-thrift: Correctly send mux.Request#contexts in all cases. There were some
  cases in which mux.Request#contexts were not always propagated. The contexts are
  now always written across the transport. Note that there may be duplicated contexts
  between "local" context values and "broadcast" context values. Local values will
  precede broadcast values in sequence. 45832aad

Release Version Format

• From now on, release versions will be based on release date in the format of
  YY.MM.x where x is a patch number. 8efc24b1

New Features

• finagle-core: DeadlineFilter may now be created from the class and used as a
  regular Filter in addition to a stack module as before. b80a1df4

• finagle-mysql: Add ability to toggle the CLIENT_FOUND_ROWS flag. fae2e69d

• finagle-http: Separated the DtabFilter.Extractor from the ServerContextFilter into
  a new module: ServerDtabContextFilter. While this is still enabled in the default
  Http server stack, it can be disabled independently of the ServerContextFilter.
  335d639f

Runtime Behavior Changes

• finagle-netty4: Netty4ClientEngineFactory and Netty4ServerEngineFactory now
  validate loaded certificates in all cases to ensure that the current date
  range is within the validity range specified in the certificate. dc3230e3

• finagle-netty4: TrustCredentials.Insecure now works with native SSL/TLS engines.
  6b822e94

• finagle-http2: Upgraded to the new netty http/2 API in netty version 4.1.16.Final,
  which fixes several long-standing bugs but has some bugs around cleartext http/2.
  One of the work-arounds modifies the visibility of a private field, so it's incompatible
  with security managers. This is only true for http/2--all other protocols will be unaffected.
  bb01393f

• finagle-http: Netty 3 HeaderMap was replaced with our own implementation.
  199dc51c

Deprecations

• finagle-base-http: With the intention to make c.t.f.http.Cookie immutable,
  set methods on c.t.f.http.Cookie have been deprecated:

  • comment_=
  • commentUrl_=
  • domain_=
  • maxAge_=
  • path_=
  • ports_=
  • value_=
  • version_=
  • httpOnly_=
  • isDiscard_=
  • isSecure_=

  Use the c.t.f.http.Cookie constructor to set domain, maxAge, path, value, httpOnly,
  and secure. comment, commentUrl, ports, version, and discard have been removed
  per RFC-6265. 71760096.

  Alternatively, use the domain, maxAge, path, httpOnly, and secure methods to create a
  new Cookie with the existing fields set, and the respective field set to a given value.
  14beb975

• finagle-base-http: c.t.f.http.Cookie.isSecure and c.t.f.http.Cookie.isDiscard
  have been deprecated. Use c.t.f.http.Cookie.secure for c.t.f.http.Cookie.isSecure.
  isDiscard has been removed per RFC-6265. 71760096

Breaking API Changes

• finagle-mysql: Moved Cursors.cursor method to Client trait, and removed Cursors trait.
  This allows cursor queries to used with transactions. 1224721c

• finagle-mux: Expose transport contexts in mux.Request and mux.Response. f0f46785

• finagle-mux: The "leased" gauge has been removed from the mux client implementation since the
  metric is reported as the sum of the value over all clients which is unlikely to be useful.
  1c31e384

New Features

• finagle-core: If a c.t.u.tunable.Tunable request or total timeout has been configured
  on a client which uses a c.t.f.client.DynamicTimeout filter, the current value of tunable will
  be used in the case of no dynamic timeout set for a request. PHAB_ID=D81886

• finagle-core: FailFastException now captures the throwable that caused it. PHAB_ID=D86396

• finagle-redis: finagle interface for redis DBSIZE command. PHAB_ID=D85305

Bug Fixes

• finagle-core: Unregister ServerRegistry entry on StackServer#close. A
  StackServer entry is registered in the ServerRegistry on serve of the
  server but never unregistered. It is now unregistered on close of
  the StackServer. PHAB_ID=D83200

• finagle-netty4: Netty4ClientEngineFactory and Netty4ServerEngineFactory now
  properly load all chain certificates when the SslClientConfiguration or
  SslServerConfiguration uses KeyCredentials.CertKeyAndChain instead of just the
  first one in the file. PHAB_ID=D82414

Runtime Behavior Changes

• finagle-stats: Verbosity levels are now respected: debug-metrics aren't exported
  by default. PHAB_ID=D85278

• finagle-netty4: ChannelTransport no longer considers the Channel.isWritable result
  when determining status. PHAB_ID=D82670

Deprecations

• finagle-base-http: Encoding/decoding methods on c.t.f.http.Request and c.t.f.http.Response
  to/from Strings and arrays of bytes have been deprecated. Use the methods on
  c.t.f.http.codec.HttpCodec instead:
  • For c.t.f.http.Request.encodeString, use c.t.f.Http.codec.HttpCodec.encodeRequestToString
  • For c.t.f.http.Request.encodeBytes, use c.t.f.Http.codec.HttpCodec.encodeRequestToBytes
  • For c.t.f.http.Request.decodeString, use c.t.f.Http.codec.HttpCodec.decodeStringToRequest
  • For c.t.f.http.Request.decodeBytes, usec.t.f.Http.codec.HttpCodec.decodeBytesToRequest`
  • For c.t.f.http.Response.encodeString, use c.t.f.Http.codec.HttpCodec.encodeResponseToString
  • For c.t.f.http.Response.decodeString, use c.t.f.Http.codec.HttpCodec.decodeStringToResponse
  • For c.t.f.http.Response.decodeBytes, use c.t.f.Http.codec.HttpCodec.decodeBytesToResponse
PHAB_ID=D81341

Breaking API Changes

• finagle-core: com.twitter.finagle.loadbalancer.DeterministicOrdering was renamed
  to com.twitter.finagle.loadbalancer.ProcessCoordinate and the internal Coord ADT
  was changed as well. PHAB_ID=D84452

• finagle-core: Remove deprecated method httpProxyTo(String, Option[Transporter.Credentials]).
  Use httpProxyTo(String, Transporter.Credentials] instead. PHAB_ID=D84077

• finagle-*-http: Netty 3 specific HTTP transport related code has been moved into its own
  project, finagle-netty3-http, in preparation for removing it from Finagle.
  PHAB_ID=D84101

• finagle-memcached: Remove deprecated method BaseClient.release(). Use
  BaseClient.close() instead. PHAB_ID=D83168

• finagle-memcached: Move c.t.f.memcached.java.Client to c.t.f.memcached.JavaClient,
  c.t.f.memcached.java.ClientBase to c.t.f.memcached.JavaClientBase, and
  c.t.f.memcached.java.ResultWithCAS to c.t.f.memcached.ResultWithCAS. PHAB_ID=D83719

• finagle-core: Added a new type member Context to Transport, and a method that
  returns a context, which has most of the methods currently directly on Transport.
  Also deprecates most of those methods--please start using the context instead of the
  Transport directly. Also added type parameters to Transporter, Listener, and
  type members to StackClient and StackServer. PHAB_ID=D83972

New Features

• finagle-core: A StackClient can be configured with a c.t.u.tunable.Tunable
  request timeout using .withRequestTimeout(tunable); this facilitates changing
  the timeout at runtime, without server restart. See tunables for details.
  PHAB_ID=D80751.

• finagle-core: SslClientSessionVerifier and SslServerSessionVerifier have been added
  as Stack params for executing custom SSL/TLS Session verification logic on the
  establishment of an SSL/TLS Session. PHAB_ID=D63256

• finagle-core: tls methods which take an SslClientSessionVerifier have
  been added to ClientBuilder and ClientTransportParams
  (withTransport.tls). tls methods which take an SslServerSessionVerifier
  have been added to ServerBuilder and ServerTransportParams
  (withTransport.tls). PHAB_ID=D68645

• finagle-core: Timer tasks submitted to the c.t.f.util.DefaultTimer can have their
  execution time monitored. Slow executing tasks may result in a log message at level WARN
  and a counter of slow tasks is kept under finagle/timer/slow. This can be enabled using
  the global flag c.t.f.util.defaultTimerProbeSlowTasks and the maximum allowed runtime
  and minimum duration between log messages can be tuned using the global flags
  c.t.f.util.defaultTimerSlowTaskMaxRuntime, and
  c.t.f.util.defaultTimerSlowTaskLogMinInterval, respectively. PHAB_ID=D70279

• finagle-core: The JVM metrics for GC, allocations, memory, and more have moved
  here from TwitterServer. See the new JVM section in the user guide.
  PHAB_ID=D80883

• finagle-http, finagle-thriftmux: MethodBuilder has been promoted out of experimental.
  MethodBuilder is a collection of APIs for client configuration at a higher level than
  the Finagle 6 APIs while improving upon the deprecated ClientBuilder.
  See the user guide for details. PHAB_ID=D60032

• finagle-http: add withNoAutomaticContinue api to disable automatically sending 100 CONTINUE
  responses. PHAB_ID=D80017

• finagle-http: The nack related logic in the c.t.f.h.c.HttpClientDispatcher has been
  moved into a filter, c.t.f.h.f.ClientNackFilter which has been added to the client
  stack and can now be removed based on its Stack.Role. PHAB_ID=D78902

• finagle-init: Introduce a module to support service-loading initialization
  code. PHAB_ID=D75950

• finagle-memcached: Added support for partitioned backends in finagle client. Introducing
  the new PartitioningService (PHAB_ID=D75143), KetamaPartitioningService (PHAB_ID=D77499)
  and MemcachedPartitioningService (PHAB_ID=D78927), which provide this support at different
  levels of abstraction. The c.t.f.Memcached util, that is used for creating new memcached
  clients, now creates a new partitioning client that utilizes these new services for the
  Memcached protocol. The new memcached client can be enabled by setting the toggle
  "com.twitter.finagle.memcached.UsePartitioningMemcachedClient" to 1.0. PHAB_ID=D80352

• finagle-mux: Default to new more efficient decoder. PHAB_ID=D80225

• finagle-mysql: IsolationLevel support was added with
  Transactions.transactionWithIsolation method, so the default level can be overridden
  at the transaction level. PHAB_ID=D68944

• finagle-mysql: Add support for unsigned integers. When enabled, unsigned integers that do
  not fit into the existing signed representation are widened. For example an unsigned
  Int32 is represented as a Java Long, etc. Because this changes the c.t.f.mysql.Value
  variant returned by the row, it is disabled by default and must be enabled with the param
  c.t.f.Mysql.param.UnsignedColumns. PHAB_ID=D78721

• finagle-netty4: Adds support for passing a chain file to the default TLS implementation.
  PHAB_ID=D59531

• finagle-netty4: Netty 4 transports now use pooled allocators by default. PHAB_ID=D75014

• finagle-netty4: KeyCredentials.CertKeyAndChain is now available to use with
  Netty4ServerEngineFactory. PHAB_ID=D80494

• finagle-netty4: c.t.f.netty4.trackReferenceLeaks is now a CLI flag (default: disabled)
  rather than a toggle. PHAB_ID=D80654

• finagle-stats: Metrics now report verbosity levels via MetricsView.verbosity.
  PHAB_ID=D78150

• finagle-stats: JsonExporter now respects verbosity levels (current default behavior is
  to keep exporting "debug" metrics). Adjust com.twitter.finagle.stats.verbose tunable
  whitelist to change it. PHAB_ID=D79571

• finagle-tunable: StandardTunableMap is now public. Users can access file-based, in-memory,
  and service-loaded tunable values using the map.
  See tunables for details.
  PHAB_ID=D80751.

• finagle: Changed dependencies of Netty from 4.1.10 to 4.1.12. PHAB_ID=D60438

Bug Fixes

• finagle-mysql: Fix decoding error for medium length integers. PHAB_ID=D78505

Breaking API Changes

• finagle: Finagle is now decoupled from Netty 3. Depend on finagle-netty3
  explicitly if needed. PHAB_ID=D65268

• finagle-base-http: The HTTP message model has been refactored to remove backing
  Netty 3 types. Additionally, the Request and Response classes now have private
  constructors to enforce a more appropriate inheritance model: Request.Proxy and
  Response.Proxy are now the point of entry for extending the HTTP model types. Along
  with the model changes the InputStream generated .getInputStream() method of HTTP
  messages no longer consumes the messages body. PHAB_ID=D74519

• finagle-core: The Framer type has been transformed into a specialized version of a
  more generic abstraction, Decoder[T]. PHAB_ID=D59495

• finagle-core: Replace the c.t.f.context.RemoteInfo.Available constructor
  which takes ClientId in favor of a version taking String. ClientId is
  Twitter's Thrift specific concept and this should be more generic.
  PHAB_ID=D60136

• finagle-core: Remove the ability to set a global address sort. This is no longer
  necessary as setting this per client is sufficient. PHAB_ID=D60698

• finagle-core: Remove global flag com.twitter.finagle.tracing.debugTrace.
  This functionality is better suited as a concrete Tracer implementation instead
  of mixed into the generic code. PHAB_ID=D63252

• finagle-core: PHAB_ID=D63526

  • ClientBuilder.codec and ServerBuilder.codec have been removed. Use .stack instead.
  • ClientBuilder.channelFactory and ServerBuilder.channelFactory have been removed.
    Use .stack instead.

• finagle-core: LoadBalancerFactory now takes Stack.Params which allows a client to
  more easily pass in the stack context. PHAB_ID=D73129

• finagle-memcached: Add c.t.util.Closable trait to c.t.f.memcached.BaseClient.
  PHAB_ID=D63970

• finagle-mysql: A number of implementation details were made private such as specific
  Row implementations and ResultSet builder functions that consume raw packets.
  PHAB_ID=D78721

• finagle-netty4-http: HTTP/1.1 implementation based on Netty 4 is no longer experimental
  and is moved out of the exp package. PHAB_ID=D80181

• finagle-serversets: Remove `ZkMetaData.AddressOrdering, it is no longer used.PHAB_ID=D60698``

• finagle-stats: c.t.f.stats.MetricsStatsReceiver no longer has constructor variants
  which take a c.t.u.events.Sink as util-events is now deprecated. PHAB_ID=D64437

• finagle-thrift: The Netty3 thrift implementation has been removed.
  PHAB_ID=D63670

• finagle-zipkin-core: c.t.f.zipkin.core.SamplingTracer no longer has constructor
  which takes a c.t.u.events.Sink as util-events is now deprecated. PHAB_ID=D64437

• finagle-zipkin: Zipkin Tracer now exports only three counters: requests, failures,
  success. PHAB_ID=D71965

Runtime Behavior Changes

• finagle-core: The AsyncSemaphore which sequences dispatches in GenSerialClientDispatcher
  is now failed with a retryable Failure so that the retry logic knows that requests that
  which failed to acquire the semaphore are safe to retry. PHAB_ID=D78904

• finagle-http: serverErrorsAsFailuresV2 toggle is turned into a flag serverErrorsAsFailures.
  PHAB_ID=D73265

• finagle-http: Dispatcher stats are now exported under the client scope like
  all other client stats.PHAB_ID=D72265

• finagle-http: It's now possible to send a response from the HTTP server that has a
  Content-Length header so long as the 'Transfer-Encoding: chunked' isn't set on the response.
  PHAB_ID=D80087

• finagle-http: Non-streaming servers strip 'expect' headers when a 100 CONTINUE
  response is sent. PHAB_ID=D80017

• finagle-serversets: Stabilizer is no longer exporting pending_tasks and deviation_ms
  stats. See notify_ms instead. PHAB_ID=D65571

• finagle-stats, finagle-zipkin-core: No longer publishing c.t.u.events as util-events
  is now deprecated. PHAB_ID=D64437

• finagle-stats: No longer backed by commons metrics, now its own thing. PHAB_ID=D73497

• finagle-netty4: Unset Netty's default timeout (10 seconds) for SSL handshake on clients.
  Use .withSession.acquisitionTimeout instead. PHAB_ID=D78500

New Features

• finagle: Changed dependencies of Netty from 4.1.9 to 4.1.10 and tcnative
  from 2.0.0 to 2.0.1. RB_ID=916056

• finagle-core: c.t.f.n.ssl.SslConnectHandler is no longer exported publicly.
  It has also been renamed to c.t.f.n.ssl.client.SslClientConnectHandler.
  RB_ID=916932

• finagle-core: c.t.f.factory.ServiceFactoryCache is now exported publicly.
  RB_ID=915064

• finagle-core: Allow customization of load balancer behavior when no nodes
  are Status.Open. See the user guide for details:
  https://twitter.github.io/finagle/guide/Clients.html#behavior-when-no-nodes-are-available
  RB_ID=916145

• finagle-core: The global c.t.f.naming.NameInterpreter can be optionally set using
  service loader. RB_ID=917082

• finagle-redis: Support scanning over sets and sorted sets with SSCAN and ZSCAN.
  RB_ID=916484

Bug Fixes

• finagle-mux: Disable Netty4RefCountingControl decoder when message fragmentation
  is enabled. PHAB_ID=D58153

• finagle: Fixed Java API for withStack for Client and Server implementations.
  Java users now get the correct types for calls such as c.t.f.Http.client().withStack
  and c.t.f.Http.server().withStack. RB_ID=915440

• finagle-thrift, finagle-thriftmux: Clients created using newServiceIface now use the
  configured c.t.f.service.ResponseClassifier (or c.t.f.service.ResponseClassifier.Default if
  not configured) for per-method stats and usage in c.t.f.liveness.FailureAccrualFactory and
  c.t.f.stats.StatsFilter. RB_ID=917010

Runtime Behavior Changes

• finagle: Add a floor of 8 to the default values of the flags c.t.f.netty3.numWorkers
  and c.t.f.netty4.numWorkers. RB_ID=916465

• finagle-core: c.t.f.util.DefaultTimer is decoupled from Netty 3 and is loaded via the
  LoadService machinery. If no timers are available on the class path, the JavaTimer
  instead is used instead. This ony affects direct usages of DefaultTimer as all Finagle
  protocols are using Netty 4 HashedWheelTimer at this point. RB_ID=915924

• finagle-core: The load balancer implementations no longer close the endpoint
  resources when they are closed. Instead, they treat them as externally
  managed resources and expect the layers above to manage them. No change
  is required if using the Balancers in the context of a Finagle client.
  If that's not the case, however, managing the life cycle of the passed
  in endpoints is necessary. RB_ID=916415

• finagle-core: Aperture load balancers now expire idle sessions which fall
  out of the aperture window. RB_ID=916508

• finagle-http: Uses Netty 4 as the default transport implementation.
  Use .configured(Http.Netty3Impl) to switch implementation over to Netty 3.
  PHAB_ID=D58698 RB_ID=917936

• finagle-memcached: If the client decoder detects a protocol failure, the ClientTransport
  will close the connection. RB_ID=917685

• finagle-netty4: poolReceiveBuffers toggle is removed (suppressed by UsePooling).
  RB_ID=917912

• finagle-http: To conform to RFC 2616, a message body is NO LONGER sent when 1xx, 204
  and 304 responses are returned. To conform with RFC 7230, a Content-Length header field
  is NOT sent for 1xx and 204 responses. Both rules are enforced even if users intentionally
  add body data or the header field for these responses. If violation of these rules is
  detected then an error message is logged. RB_ID=917827

Breaking API Changes

• finagle: $protocol.Client.params/stack and $protocol.Server.params/stack are removed,
  use similar methods on instances instead: $protocol.client.params/stack and
  $protocol.server.params/stack instead. RB_ID=915703

• finagle-core: Remove deprecated c.t.f.builder.ClientBuilder.tracerFactory.
  Use c.t.f.builder.ClientBuilder.tracer instead. Remove deprecated
  c.t.f.tracing.Tracer.Factory. Use c.t.f.tracing.Tracer instead.
  RB_ID=915481

• finagle-core: Remove deprecated c.t.f.Deadline. Use c.t.f.context.Deadline instead.
  RB_ID=915550

• finagle-core: Remove deprecated c.t.f.builder.ClientBuilder.cluster and
  c.t.f.builder.ClientBuilder.group. Use c.t.f.builder.ClientBuilder.dest instead.
  RB_ID=915098

• finagle-core: Remove deprecated c.t.f.tracing.Trace.recordRpcName. Use
  c.t.f.tracing.Trace.recordRpc and c.t.f.tracing.Trace.recordServiceName instead.
  RB_ID=916426

• finagle-core: Remove deprecated c.t.f.builder.Cluster. Use com.twitter.finagle.Name to
  represent clusters instead. RB_ID=916162

• finagle-core: LoadBalancerFactory now takes an EndpointFactory which is an
  extension of ServiceFactory that carries an address and has the ability to
  be rebuilt. RB_ID=916956

• finagle-base-http: Remove deprecated c.t.f.http.Message.ContentTypeWwwFrom.
  Use c.t.f.http.Message.ContentTypeWwwForm instead. ``RB_ID=915543`

• finagle-exception: Remove deprecated c.t.f.exception.Reporter.clientReporter and
  c.t.f.exception.Reporter.sourceReporter. Use c.t.f.exception.Reporter.monitorFactory
  instead. RB_ID=916403

• finagle-http: Remove deprecated c.t.f.http.HttpMuxer.pattern. Specify a route
  using c.t.f.http.HttpMuxer.route(pattern, this) instead. RB_ID=915551

• finagle-http: Remove deprecated c.t.f.http.filter.ValidateRequestFilter. Create a custom
  filter if this behavior is needed. RB_ID=915548

• finagle-kestrel: Remove deprecated methods on c.t.f.kestrel.MultiReader:

  • apply(cluster: Cluster[SocketAddress], queueName: String)
  • apply(clients: Seq[Client], queueName: String)
  • apply(handles: ju.Iterator[ReadHandle])
  • newBuilder(cluster: Cluster[SocketAddress], queueName: String)
  • merge(readHandleCluster: Cluster[ReadHandle])
    Use the c.t.f.Var[Addr]-based apply methods on c.t.f.kestrel.MultiReaderMemcache or c.t.f.kestrel.MultiReaderThriftMux instead. RB_ID=914910

• finagle-kestrel: Removed from the project. RB_ID=915221
  https://finagle.github.io/blog/2017/04/06/announce-removals/

• finagle-mdns: Removed from the project. RB_ID=915216
  https://finagle.github.io/blog/2017/04/06/announce-removals/

• finagle-memcached: Remove deprecated c.t.f.memcached.BaseClient.cas methods.
  Use c.t.f.memcached.BaseClient.checkAndSet instead. RB_ID=914678

• finagle-memcached: c.t.f.memcached.protocol.text.Encoder object is now private.
  RB_ID=917214

• finagle-memcached: Make memcached Response subtypes with no fields case objects.
  RB_ID=917137

• finagle-mysql: Remove deprecated methods on c.t.f.Mysql:

  • withCredentials; use c.t.f.Mysql.client.withCredentials instead
  • withDatabase; use c.t.f.Mysql.client.withDatabase instead
  • withCharset; use c.t.f.Mysql.client.withCharset instead
  • configured; use c.t.f.Mysql.client.configured instead
    RB_ID=916418

• finagle-native: Removed from the project. RB_ID=915204
  https://finagle.github.io/blog/2017/04/06/announce-removals/

• finagle-netty4: AnyToHeapInboundHandler is gone. Use BufCodec while designing
  new Finagle protocols. RB_ID=915251

• finagle-ostrich4: Removed from the project. RB_ID=915327
  https://finagle.github.io/blog/2017/04/06/announce-removals/

• finagle-redis: ChannelBuffer methods and converters are removed. Use Buf-based API
  instead. Removed APIs: RB_ID=916015

  • c.t.f.redis.NettyConverters
  • c.t.f.redis.util.StringToChannelBuffer
  • c.t.f.redis.Client.watch(Seq[ChannelBuffer])

• finagle-stream: Removed from the project. RB_ID=915200
  https://finagle.github.io/blog/2017/04/06/announce-removals/

• finagle-thrift: Remove deprecated c.t.f.thrift.transport.netty3.ThriftServerBufferedCodec
  and c.t.f.thrift.transport.netty3.ThriftServerBufferedCodecFactory. Use the c.t.f.Thrift
  object to build a server. RB_ID=915656

• finagle-thriftmux: Remove deprecated c.t.f.ThrifMux.withClientId. Use
  c.t.f.ThriftMux.client.withClientId. Remove deprecated c.t.f.ThrifMux.withProtocolFactory.
  Use c.t.f.ThriftMux.client.withProtocolFactory. RB_ID=915655

New Features

• finagle-core: FailureAccrual is now production ready. It has been promoted out of
  experimental and moved from com.twitter.finagle.service.exp to
  com.twitter.finagle.liveness. RB_ID=914662

• finagle-core: SSL/TLS APIs have been changed to include methods which work
  based on an SSL configuration, and an SSL configuration and an SSL engine factory.
  RB_ID=911209

• finagle-core: LoadBalancerFactory now exposes a mechanism to order the collection
  of endpoints passed to the balancer implementations. This allows a consistent ordering
  of endpoints across process boundaries. RB_ID=910372

• finagle-core: Introduce c.t.f.client.EndpointerStackClient, a mechanism for
  making clients that don't need a transporter and dispatcher. This simplifies
  making non-netty clients. RB_ID=912889

• finagle-http2: Add support for liveness detection via pings. It can be configured
  the same way as it is in mux. RB_ID=913341

• finagle-toggle: Standard toggles now track the last value produced from apply.
  These values are visible via TwitterServer's /admin/toggles endpoint. RB_ID=913925

Breaking API Changes

• finagle-mysql: Support for Netty 3 has been removed, making Netty 4 the only transport
  implementation. RB_ID=914661

• finagle-core: com.twitter.finagle.service.exp.FailureAccrualPolicy has been promoted to
  com.twitter.finagle.liveness.FailureAccrualPolicy

• finagle-commons-stats: Remove finagle-commons-stats, which was a compatibility layer
  for a deprecated stats library. Please move to finagle-stats instead. RB_ID=910964

• finagle-core: SSL/TLS stack params for Finagle running Netty 4 have changed.

  • The TlsConfig param in Transport has been removed.
  • For client engines, the same two parameters as Finagle running Netty 3 are now used:
    • ClientSsl in Transport, which is used for configuring a client Engine's hostname,
      key credentials, trust credentials, cipher suites, protocols, and application protocols.
    • SslClientEngineFactory in SslClientEngineFactory, which determines how the Engine
      is created based off of an Address and an SslClientConfiguration.
  • For server engines, the same two parameters as Finagle running Netty 3 are now used:
    • ServerSsl in Transport, which is used for configuring a server Engine's key
      credentials, trust credentials, cipher suites, protocols, application protocols, and
      where the server supports or requires client authentication.
    • SslServerEngineFactory in SslServerEngineFactory, which determines how the Engine
      is created based off of an SslServerConfiguration.
  • Note: Not all client and server configurations work with all engine factories. Each engine
    factory should document what is not supported by that specific engine factory.
  • Note: By default, Finagle on Netty 4 will use the Netty4ClientEngineFactory and
    Netty4ServerEngineFactory respectively.
    RB_ID=910500

• finagle-core: Change the API to LoadBalancerFactory to a more concrete
  Activity[IndexedSeq[ServiceFactory[Req, Rep]]] since the majority of the
  load balancer implementations don't need the properties of a Set but instead
  need ordering guarantees and efficient random access. RB_ID=910372

• finagle-core: Balancers.aperture now has a new parameter useDeterministicOrdering,
  which is set to false by default. This feature is still experimental and under
  construction. This will break the Java API and require the additional param to
  be passed in explicitly. RB_ID=911541

• finagle-core: The logic for tracking sessions that was in StdStackServer has been lifted into
  a new template, ListeningStackServer where implementations define the creation of a
  ListeningServer from a ServiceFactory, SocketAddress, and a function that tracks accepted
  sessions. RB_ID=914124

• finagle-core: Change the AddressOrdering param to no longer take a StatsReceiver,
  since orderings were simplified and are no longer composite. RB_ID=914113

• finagle-core: Remove deprecated methods on c.t.f.Client:

  • newClient(dest: Group[SocketAddress])
  • newService(dest: Group[SocketAddress])
    RB_ID=914787

• finagle-core: c.t.f.ListeningServer no longer extends c.t.f.Group. Use
  c.t.f.ListeningServer.boundAddress to extract the address from the server.
  RB_ID=914693

• finagle-core: Remove deprecated c.t.f.group.StabilizingGroup. Use
  c.t.f.addr.StabilizingAddr instead. RB_ID=914823

• finagle-core: Constructors for c.t.f.ChannelException and its subclasses now have
  overloads that take Option\s instead of allowing null. While the existing
  constructors remain, and forward to the new ones, this can still cause compilation
  failures when the arguments are ambiguous. RB_ID=914800

• finagle-core: Remove MimimumSetCluster since it has been deperecated for quite
  some time. Instead, use finagle logical destinations via Names. RB_ID=914849

• finagle-core: Remove deprecated c.t.f.Resolver.resolve. Use c.t.f.Resolver.bind
  instead. Remove deprecated c.t.f.BaseResolver.resolve. Use c.t.f.Resolver.eval
  instead. RB_ID=914986

• finagle-http: c.t.f.http.Http codec has disappeared as part of Netty 4 migration. Use
  c.t.f.Http.client or c.t.f.Http.server stacks instead. RB_ID=912427

• finagle-kestrel: Remove c.t.f.kestrel.param.KestrelImpl. Kestrel clients and servers
  now use Netty 4 and cannot be configured for Netty 3. RB_ID=911031

• finagle-memcached: Remove c.t.f.memcached.param.MemcachedImpl. Memcached clients and servers
  now use Netty 4 and cannot be configured for Netty 3. RB_ID=911031

• finagle-kestrel: Remove commands that are not supported by the client:

  • com.twitter.finagle.kestrel.protocol.DumpConfig
  • com.twitter.finagle.kestrel.protocol.DumpStats
  • com.twitter.finagle.kestrel.protocol.FlushAll
  • com.twitter.finagle.kestrel.protocol.Reload
  • com.twitter.finagle.kestrel.protocol.ShutDown
  • com.twitter.finagle.kestrel.protocol.Stats
  • com.twitter.finagle.kestrel.protocol.Version
RB_ID=911206

• finagle-memcached: Remove deprecated c.t.f.memcached.KetamaClientBuilder. Use
  c.t.f.Memcached.client to create a Memcached client. RB_ID=907352

• finagle-memcached: Remove deprecated c.t.f.memcached.replication.ReplicationClient. Use
  c.t.f.memcached.replication.BaseReplicationClient with clients created using
  c.t.f.Memcached.client. RB_ID=907352

• finagle-memcached: Remove deprecated methods on c.t.f.memcached.Client:

  • apply(name: Name)
  • apply(host: String)

  Use c.t.f.Memcached.client to create a Memcached client. RB_ID=908442

• finagle-memcached: Remove deprecated c.t.f.memcached.protocol.text.Memcached object.
  Use c.t.f.Memcached.client to create Memcached clients. RB_ID=908442

• finagle-memcached: Remove deprecated c.t.f.memcached.Server class. Use
  c.t.f.memcached.integration.TestMemcachedServer for a quick test server.
  RB_ID=914827

• Remove deprecated c.t.f.memcached.PartitionedClient object. Use
  c.t.f.memcached.CacheNodeGroup.apply instead of
  c.t.f.memcached.PartitionedClient.parseHostWeights. RB_ID=914827

• Remove deprecated c.t.f.memcached.util.ParserUtils.DIGITS. Use "^\d+$" instead.
  Remove deprecated c.t.f.memcached.util.ParserUtils.DigitsPattern. Use Pattern.compile(^\d+$)
  instead. RB_ID=914827

• finagle-memcached: Remove old c.t.f.memcached.replicated.BaseReplicationClient and
  c.t.f.memcached.migration.MigrationClient, and most c.t.f.memcached.CachePoolCluster
  methods. RB_ID=910986

• finagle-memcached: Remove old c.t.f.memcached.migration.DarkRead, and
  c.t.f.memcached.migration.DarkWrite. RB_ID=911367

• finagle-memcached: Remove c.t.f.memcached.CachePoolConfig. RB_ID=914623

• finagle-mux: Netty 3 implementation of Mux is removed. Default is
  Netty 4. RB_ID=914239

• finagle-netty4: DirectToHeapInboundHandler was renamed to AnyToHeapInboundHandler
  and now copies any inbound buffer (not just directs) on heap. RB_ID=913984

• finagle-thrift, finagle-thriftmux: Remove rich client/server support for prior
  versions of Scrooge generated code. RB_ID=911515

• finagle-core: c.t.f.client.Transporter no longer has a close method, which
  was introduced in 6.43.0. It was sort of a hack, and we saw the opportunity
  to do it properly. RB_ID=912889

• finagle-core, finagle-mux: Move FailureDetector from c.t.f.mux to c.t.f.liveness.
  This also means that the sessionFailureDetector flag is now
  c.t.f.liveness.sessionFailureDetector. RB_ID=912337

Bug Fixes

• finagle-exp: DarkTrafficFilter now respects the log level when HasLogLevel,
  and otherwise defaults the level to warning instead of error. RB_ID=914805

• finagle-netty4: Fixed connection stall on unsuccessful proxy handshakes in Finagle clients
  configured with HTTP proxy (Transporter.HttpProxyTo). RB_ID=913358

Runtime Behavior Changes

• finagle-netty4: Finagle is no longer logging the failed proxy handshake response.
  RB_ID=913358

• finagle-netty4: SOCKS5 proxies are now bypassed if the connect destination is
  localhost. This matches Finagle's prior behavior from when Netty 3 was the default
  transport implementation. RB_ID=914494

Dependencies

• finagle-memcached: Remove dependency on com.twitter.common:io-json. RB_ID=914623