isis - 如何使用域对象参数调用rest api

Question

我写了一个服务动作看起来像

@DomainService(
        nature = NatureOfService.VIEW_REST_ONLY,
        objectType = "rest.oneService"
)
onepackage.OneService{
   @Action(semantics = SemanticsOf.SAFE)
   public List<Data> findDataByPerson(Person person, LocalDate start, LocalDate end){
   ...
   }
}

在 SwaggerUI 中暴露为

get /services/rest.oneService/actions/findDataByPerson/invoke  

我找不到如何将域对象作为参数发送到 rest api；

我怎样才能做到这一点？

谢谢。

Answer 1

对域对象的引用使用这种格式：

{
  "person": {
    "value": {
      "href": "http://~/objects/person.Person/123"
    }
  }
}

其中person.Person是引用类型的对象类型（根据@DomainObject(objectType=...)）。

如果使用 PUT (@Action(semantics=IDEMPOTENT)) 或 POST (@Action(semantics=NON_IDEMPOTENT)) 调用操作，那么上面的内容就是主体。

如果使用 GET (@Action(semantics=SAFE)) 调用，则需要对该 json 进行 URL 编码和附加。

规范第 2.10 节中的更多详细信息，也可在此处在线获取