3.1 Eureka的核心类

3.1.1 InstanceInfo

Eureka使用InstanceInfo（com/netflix/appinfo/InstanceInfo.java）来代表注册的服务实例，其主要字段如表3-1所示。

表3-1 InstanceInfo类字段说明

可以看到InstanceInfo里既有metadata，也有dataCenterInfo，还有一个比较重要的leaseInfo，用来标识该应用实例的租约信息。

3.1.2 LeaseInfo

Eureka使用LeaseInfo（com/netflix/appinfo/LeaseInfo.java）来标识应用实例的租约信息，其字段如表3-2所示。

表3-2 LeaseInfo类字段说明

这些参数主要用于标识应用实例的心跳情况，比如约定的心跳周期，租约有效期，最近一次续约的时间等。

3.1.3 ServiceInstance

ServiceInstance（org/springframework/cloud/client/ServiceInstance.java）是Spring Cloud对service discovery的实例信息的抽象接口，约定了服务发现的实例应用有哪些通用的信息，其方法如表3-3所示。

表3-3 ServiceInstance接口方法列表

由于Spring Cloud Discovery适配了Zookeeper、Consul、Netflix Eureka等注册中心，因此其ServiceInstance定义更为抽象和通用，而且采取的是定义方法的方式。Spring Cloud对该接口的实现类为EurekaRegistration（org/springframework/cloud/netflix/eureka/serviceregistry/EurekaRegistration.java）, EurekaRegistration实现了ServiceInstance接口，同时还实现了Closeable接口，它的作用之一就是在close的时候调用eurekaClient.shutdown()方法，实现优雅关闭Eureka Client。

3.1.4 InstanceStatus

InstanceStatus用于标识服务实例的状态，它是一个枚举，定义如下：

        public enum InstanceStatus {
            UP, // Ready to receive traffic
            DOWN, // Do not send traffic- healthcheck callback failed
            STARTING, // Just about starting- initializations to be done - do not
            // send traffic
            OUT_OF_SERVICE, // Intentionally shutdown for traffic
            UNKNOWN;
            public static InstanceStatus toEnum(String s) {
                if (s ! = null) {
                    try {
                        return InstanceStatus.valueOf(s.toUpperCase());
                    } catch (IllegalArgumentException e) {
                        // ignore and fall through to unknown

                        logger.debug("illegal  argument  supplied  to  InstanceStatus.
                            valueOf: {}, defaulting to {}", s, UNKNOWN);
                    }
                }
                return UNKNOWN;
            }
        }

从定义可以看出，服务实例主要有UP、DOWN、STARTING、OUT_OF_SERVICE、UNKNOWN这几个状态。其中OUT_OF_SERVICE标识停止服务，即停止接收请求，处于这个状态的服务实例将不会被路由到，经常用于升级部署的场景。