超时

示例: timeout

超时机制可以保护服务调用陷入无限的等待之中。超时定义了服务的最长等待时间，如果在给定的时间没有相应，服务调用就进入下一个状态，或者重试、或者立即返回错误。

Server

你可以使用OptionFn设置服务器的 readTimeout 和 writeTimeout。

  1. type Server struct {
  2.     ……
  3.     readTimeout  time.Duration
  4.     writeTimeout time.Duration
  5.     ……
  6. }

设置超时的OptionFn是 :

  1. func WithReadTimeout(readTimeout time.Duration) OptionFn
  2. func WithWriteTimeout(writeTimeout time.Duration) OptionFn

Client

客户端有两种方式可是超时。

一种是设置连接的 read/write deadline, 一种是使用 context.Context.

read/write deadline

Client的 Option 可以设置连接的超时值:

  2. type Option struct {
  3.     ……
  4.     //ConnectTimeout sets timeout for dialing
  5.     ConnectTimeout time.Duration
  6.     // ReadTimeout sets readdeadline for underlying net.Conns
  7.     ReadTimeout time.Duration
  8.     // WriteTimeout sets writedeadline for underlying net.Conns
  9.     WriteTimeout time.Duration
  10.     ……
  11. }

DefaultOption 设置连接超时值为 10 秒，但是没有设置 ReadTimeout 和 WriteTimeout。 如果没有设置，则不会有超时限制。

由于多个服务可能共用同一个节点，有可能出现多个服务调用互相影响的状况。

context.Context

context.Context 也可以用来控制超时。

你可以使用context.WithTimeout 来设置超时时间，这是推荐的设置超时的方式。

  1. func WithTimeout(parent Context, timeout time.Duration) (Context, CancelFunc)