如何在微服务应用程序中注入 PlatformApi？

Question

我需要构建一个小型微服务，它接收 REST 请求并在 Cumulocity 中存储数据（设备、测量等）。

对我来说，从文档中不太清楚如何将 platformApi 轻松注入到我的 Spring Boot 应用程序中。尤其是Scope（TenantScope & UserScope）用法不清楚。

您能否举一个非常简单的“hello-world”示例，如何自动连接 platformApi（例如库存）并在应用程序启动时在租户范围内做某事（打印出所有设备）并使用 RestControler RequestMapping 在用户内做某事范围？

这是一个代码片段：

package c8y.example;

import com.cumulocity.microservice.autoconfigure.MicroserviceApplication;  
import com.cumulocity.microservice.context.inject.TenantScope;
import com.cumulocity.sdk.client.inventory.InventoryApi;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.SpringApplication;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.annotation.PostConstruct;

@MicroserviceApplication
@RestController
public class App{

@Autowired
InventoryApi inventoryApi;

public static void main(String[] args) {
    SpringApplication.run(App.class, args);
}

@PostConstruct
public void init() {
    System.out.println("Devices: " + inventoryApi.getManagedObjects());
}

@RequestMapping("devices")
public String greeting() {
    return "Devices: " + inventoryApi.getManagedObjects();
}
}

到目前为止，我尝试的所有操作都会导致启动时出现错误，即无法注入 bean，或者它们不在所需的范围内或不在上下文中。 我有一个包含引导凭据的 application.properties。

Answer 1

我找到了第一个解决方案，但我仍然不确定租户和用户范围之间的区别以及何时使用范围。但也许这会有所帮助。

我无法自动连接库存 API，但我能够自动连接平台 API，您可以从中使用库存 API。

package c8y.example;

import org.slf4j.Logger;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.boot.SpringApplication;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import com.cumulocity.microservice.autoconfigure.MicroserviceApplication;
import com.cumulocity.model.idtype.GId;
import com.cumulocity.rest.representation.inventory.ManagedObjectRepresentation;
import com.cumulocity.sdk.client.Platform;
import com.cumulocity.sdk.client.inventory.InventoryApi;

@MicroserviceApplication
@RestController
public class App {
    private static final Logger log = org.slf4j.LoggerFactory.getLogger(App.class);

    @Autowired(required = true)
    @Qualifier("userPlatform")
    private Platform platformApi;

    public static void main(String[] args) {
        SpringApplication.run(App.class, args);
    }

    @RequestMapping("/")
    public String greeting() {
        if (platformApi != null && platformApi.getInventoryApi() != null) {
            final InventoryApi inventoryApi = platformApi.getInventoryApi();
            final ManagedObjectRepresentation managedObjectRepresentation = inventoryApi.get(new GId("5749"));

            log.info(managedObjectRepresentation.toString());
            return "device: " + managedObjectRepresentation.getName();
        }

        return "hello world";
    }
}

最初有一个可用的范围是 UserScope，但是当您查看 CumulocityClientFeature 类时，您可以看到该类将租户范围的 PlatformImpl 设置为主要。这意味着当您自动连接 PlatformApi 时，它将自动使用 TenantScoped Platform 而不是 UserScoped。这将失败，因为当前范围是 UserScope。要自动连接正确的 PlatformApi，您必须使用值为 userPlatform 的限定符，以便自动连接 UserScoped PlatformAPI。您可以从平台 API 访问库存 API。

尝试自动装配 Inventory API 对我不起作用，因为该应用找不到 UserScoped Inventory API。不知道为什么。