【亲测免费】 HAPI FHIR 快速入门指南

1. 项目目录结构及介绍

在HAPI FHIR项目中，主要目录结构如下：

• src/main/java: 存放Java源代码，包括核心库、服务器端实现、客户端工具等。
• src/main/resources: 包含配置文件和其他资源，如SQL脚本、消息模板等。
• pom.xml: Maven构建文件，定义了依赖关系和构建指令。
• docs: 项目文档存放地，包括开发者指南、API参考等。
• .github: GitHub操作相关的设置和自动化工作流程文件。

这个结构反映了典型的Java Maven工程组织方式，用于开发、测试和打包应用。

2. 项目的启动文件介绍

HAPI FHIR 项目通常通过运行主类来启动服务器。对于使用JPA服务器的示例，启动类可能类似于ca.uhn.fhir.jpa.mdm.run.MdmServer或ca.uhn.fhir.jpa.demo.FhirServerStarterDstu3。具体取决于你的部署需求和FHIR版本。在命令行或者IDE中，你可以使用如下命令启动服务器（假设你已正确设置了环境）：

mvn compile exec:java -Dexec.mainClass="ca.uhn.fhir.jpa.mdm.run.MdmServer"

请注意，这只是一个例子，实际的启动类名应根据你克隆的分支或使用的子项目进行调整。

3. 项目的配置文件介绍

HAPI FHIR 的配置主要通过以下几种方式进行：

• application.properties: 这是Spring Boot风格的应用配置文件，包含了数据库连接、服务器端口、日志级别等设置。例如：

  server.port=8080
  spring.datasource.url=jdbc:mysql://localhost/fhirdb
  spring.datasource.username=root
  spring.datasource.password=root
  

• fhir-server-config.json: 定义FHIR服务器的行为，包括资源处理策略、搜索参数、订阅等。例如：

  {
    "id": "example",
    "server": {
      "baseURL": "/fhir",
      "publish": false,
      "version": "r4",
      ...
    },
    "resources": {
      "Patient": {
        ...
      }
    },
    ...
  }
  

• fhir-jpa-searchparam-cache.properties: 配置FHIR JPA服务器的搜索参数缓存行为。

根据你的具体需求，可能还需要其他配置文件，如数据库迁移脚本（位于db/migration下）或定制的安全配置。

要修改默认配置，可以将上述配置文件中的值替换为你自己的值，并确保在启动时这些文件被正确加载。在某些情况下，还可以通过命令行参数传递配置项以覆盖默认值。

---

以上内容概括了HAPI FHIR项目的目录结构、启动方式以及主要配置文件。要深入了解并使用HAPI FHIR，请查阅官方文档和示例代码，以便充分利用其功能。