Jersey端点调用机制及Guacamole中两个REST方法的关联疑问

这两个方法的关联核心是**Jersey的子资源定位器（Subresource Locator）**机制，并非Java代码层面的直接方法调用，所以你在堆栈跟踪中看不到两者的直接调用链，下面详细拆解：

1. 第一个方法：子资源定位器 #

UserContextResource中的getActiveConnectionDirectoryResource()是Jersey的子资源定位器，它的作用是：

• 当请求匹配到父资源UserContextResource的路径（对应/api/session/data/postgresql部分），且路径后缀为activeConnections时，Jersey会调用这个方法，获取DirectoryResource的实例。
• 代码中的@Path("activeConnections")标记了这个定位器对应的子路径，方法返回的DirectoryResource实例会作为后续请求处理的实际资源对象，同时该方法还完成了依赖注入——把authenticatedUser、userContext和连接目录对象传入子资源实例。

代码片段：

@Path("activeConnections")
public DirectoryResource<ActiveConnection, APIActiveConnection>
    getActiveConnectionDirectoryResource() throws GuacamoleException {
    return activeConnectionDirectoryResourceFactory.create(authenticatedUser,
            userContext, userContext.getActiveConnectionDirectory());
}

2. 第二个方法：实际请求处理的资源方法 #

DirectoryResource中的getObjects()是HTTP GET请求的处理方法，它的作用是：

• 当Jersey拿到DirectoryResource实例后，会根据请求的HTTP方法（这里是GET），匹配到带有@GET注解的getObjects()方法，执行它来处理权限校验、数据过滤和格式转换，最终返回响应数据。
• 这个方法能直接使用userContext等依赖，是因为子资源定位器在创建DirectoryResource实例时已经完成了这些依赖的注入。

代码片段：

@GET
public Map<String, ExternalType> getObjects(
        @QueryParam("permission") List<ObjectPermission.Type> permissions)
        throws GuacamoleException {

    // An admin user has access to all objects
    Permissions effective = userContext.self().getEffectivePermissions();
    SystemPermissionSet systemPermissions = effective.getSystemPermissions();
    boolean isAdmin = systemPermissions.hasPermission(SystemPermission.Type.ADMINISTER);

    // Filter objects, if requested
    Collection<String> identifiers = directory.getIdentifiers();
    if (!isAdmin && permissions != null && !permissions.isEmpty()) {
        ObjectPermissionSet objectPermissions = getObjectPermissions(effective);
        identifiers = objectPermissions.getAccessibleObjects(permissions, identifiers);
    }

    // Translate each retrieved object into the corresponding external object
    Map<String, ExternalType> apiObjects = new HashMap<String, ExternalType>();
    for (InternalType object : directory.getAll(identifiers))
        apiObjects.put(object.getIdentifier(), translator.toExternalObject(object));

    return apiObjects;

}

3. 为什么堆栈中看不到直接关联？ #

这两个方法的调用是由Jersey框架在运行时串联的：

1. 框架先解析请求路径，匹配到父资源和对应的子资源定位器，调用getActiveConnectionDirectoryResource()获取子资源实例。
2. 框架再根据HTTP方法（GET），调用子资源实例上的getObjects()方法。
   两者之间的调用逻辑是Jersey内部的资源定位和反射调用代码，并非业务代码直接调用，所以堆栈跟踪中不会显示两个方法的直接调用关系。

内容的提问来源于stack exchange，提问作者gstackoverflow