如何为 Hapi Fhir 服务器的观察资源提供者实现搜索操作？

Question

我正在尝试了解 Hapi Fhir 中的 RESTful 服务器是如何工作的，并且我想为观察资源实现一些 @Search 方法。

目前，我有这个@Read 操作，它在尝试从浏览器访问资源（如：http://localhost:8080/NewFHIRServer/fhir）时成功：

@Read()
public Observation readObservationById(@IdParam IdDt theId) {
    for (Entry<Long, Deque<Observation>> entry : myPatientIdToObservations.entrySet())
    {
        for (Observation obs : entry.getValue()) {
            if (obs.getId().equals(theId)) {
                return obs;
            }
        }
    }

    throw new ResourceNotFoundException(theId);
}    

但是，当我尝试对 @Search 操作执行类似操作时，我遇到了错误。我希望能够通过像这样（或类似）运行搜索来获得响应：

Bundle response = client
        .search()
        .forResource(Observation.class)
        .where(Observation.SUBJECT.hasId("Patient/1"))
        .execute();   

为了使这成为可能，我的@Read 方法中需要哪些参数？我现在遇到的错误如下：

此服务器上的 FHIR 端点不知道如何处理 GET 操作[Observation]，带参数[[subject]]

很明显为什么它不起作用，因为我的标题看起来像这样：

public Observation searchObservationById(@IdParam IdDt theId)     

我一直在查看示例以试图弄清楚这一点，但我不太明白这个参数中的语法是什么意思：

public List<Patient> getPatient(@RequiredParam(name = Patient.SP_FAMILY) StringParam theFamilyName)...

为了使用最后一个示例，您将如何进行查询？

谢谢

Answer 1

要实现一个搜索方法，你需要在方法上使用@Search而不是@Read。然后，您可以使用带有 @OptionalParam 或 @RequiredParam 注释的零个或多个参数。

要使您的特定示例正常工作，您需要一个实现 _id 搜索参数的搜索方法，例如

@Search public List<Patient> getPatient(@RequiredParam(name = Patient.SP_RES_ID) StringParam theId) { }