likes
comments
collection
share

Eureka 服务端是如何暴露HTTP接口的

作者站长头像
站长
· 阅读数 3

我们知道Eureka作为注册中心,客户端可以完成注册节点、通知下线、拉取节点列表、服务续约等功能。那客户端是怎么实现这些功能的呢?简而言之就是服务端提供了一系列的HTTP接口。客户端按照约定调用这些接口就可以完成各种功能。

服务端的HTTP接口

Jersey初探

我们知道SpringMVC暴露HTTP接口,只需要使用RequestMapping注解就可以暴露HTTP接口了。但是很遗憾Eureka并没有选择使用SpringMVC来暴露HTTP接口。而是采用Jersey框架。

先来看一个Jersey示例,示例1:

@Path("/{version}/apps")
@Produces({"application/xml", "application/json"})
public class ApplicationsResource {
  @Path("delta")
  @GET
  public Response getContainerDifferential(){
    // DO SOMETHING
    // return ...
  }
}

示例1的语义表达的很明确,那就是对外提供了一个HTTP接口,请求路径为GET /{version}/apps/delta HTTP1.1且返回值为json或xml。

示例1中的Path注解可以理解为RequestMapping,GET注解可以理解为GetMapping。Produces注解是说返回值可以是xml或json格式。示例1的语义等同于如下使用SpringMVC编写的示例2

@RequestMapping(value = "/{version}/apps", produces = {"application/xml", "application/json"})
public class ApplicationsResource {
    @GetMapping("delta")
    public Response getContainerDifferential() {
        // DO SOMETHING
        // return ...
    }
}

Eureka之HTTP接口

Eureka的HTTP接口都在com.netflix.eureka.resources包下。类名都是*Resource

com.netflix.eureka.resources
  |--AbstractVIPResource
  |--ApplicationResource
  |--ApplicationsResource
  |--ASGResource
  |--CurrentRequestVersion
  |--DefaultServerCodecs
  |--InstanceResource
  |--InstancesResource
  |--PeerReplicationResource
  |--SecureVIPResource
  |--ServerCodecs
  |--ServerInfoResource
  |--StatusResource
  |--VIPResource

Eureka 服务端是如何暴露HTTP接口的

在浅浅的了解了Jersey之后,我们再来看这些*Resource中是如何暴露HTTP接口的。其中比较常用的是这几个

  • ApplicationResource

  • ApplicationsResource

  • InstanceResource

  • InstancesResource

这里我们只分析 ApplicationResource 源码内容 如下(其他的几个都是一样的)。结尾会把这4个Resource暴露的HTTP整理成表格贴出来。

@Path("/{version}/apps")
@Produces({"application/xml", "application/json"})
public class ApplicationsResource {

    @Path("{appId}")
    public ApplicationResource getApplicationResource(
            @PathParam("version") String version,
            @PathParam("appId") String appId) {
    }

    @GET
    public Response getContainers(@PathParam("version") String version,
                                  @HeaderParam(HEADER_ACCEPT) String acceptHeader,
                                  @HeaderParam(HEADER_ACCEPT_ENCODING) String acceptEncoding,
                                  @HeaderParam(EurekaAccept.HTTP_X_EUREKA_ACCEPT) String eurekaAccept,
                                  @Context UriInfo uriInfo,
                                  @Nullable @QueryParam("regions") String regionsStr) {
    }
  
    @Path("delta")
    @GET
    public Response getContainerDifferential(
            @PathParam("version") String version,
            @HeaderParam(HEADER_ACCEPT) String acceptHeader,
            @HeaderParam(HEADER_ACCEPT_ENCODING) String acceptEncoding,
            @HeaderParam(EurekaAccept.HTTP_X_EUREKA_ACCEPT) String eurekaAccept,
            @Context UriInfo uriInfo, @Nullable @QueryParam("regions") String regionsStr) {
    }
}

可以看到使用了Path注解对外提供HTTP接口服务。

Eureka还有一些路由规则,比如URI中以/eureka/apps开头的会被路由到ApplicationsResource,URI以/eureka/instances开头的会被路由到InstancesResource,这里了解即可。

所属类请求类型URI示例作用
1ApplicationResourceGET/http://localhost:11000/eureka/apps/agetApplication 获取所有应用列表
2ApplicationResourceGET/{id}http://localhost:11000/eureka/apps/a/b根据ID(一般ID都是主机ID)获取InstanceResource。会转发到7
3ApplicationResourcePOST/addInstance 注册节点,客户端可以调用此接口把自己注册到服务端
4ApplicationsResourceGET/{version}/apps/{appId}http://localhost:11000/eureka/apps/a最终会转发到1
5ApplicationsResourceGET/{version}/apps/http://localhost:11000/eureka/apps/getContainers 获取所有应用列表
6ApplicationsResourceGET/{version}/apps/deltahttp://localhost:11000/eureka/apps/deltagetContainerDifferential 获取增量信息
7InstanceResourceGET/http://localhost:11000/eureka/apps/a/b获取指定的实例信息
8InstanceResourcePUT/renewLease 服务续约
9InstanceResourcePUT/statusstatusUpdate 更新节点状态
10InstanceResourceDELETE/statusdeleteStatusUpdate 删除节点覆盖状态
11InstanceResourcePUT/metadataupdateMetadata 更新节点元数据
12InstanceResourceDELETE/cancelLease 服务下线
13InstancesResourceGET/{version}/instances/{id}}http://localhost:11000/eureka/instances/agetById 获取服务实例信息

总结

  • Eureka使用Jersey框架提供HTTP服务

  • 客户端通过调用这些HTTP接口可以完成服务注册、服务续约、服务下线等功能

转载自:https://juejin.cn/post/7322730720732708875
评论
请登录