Máy chủ HAPI FHIR
HAPI-FHIR là một thư viện phần mềm Java, tạo điều kiện cho một cơ chế tích hợp để thêm các chức năng Máy chủ RESTful của FHIR vào một ứng dụng phần mềm. Thư viện HAPI FHIR Java là mã nguồn mở. Máy chủ HAPI RESTful (Chuyển trạng thái đại diện) dựa trên Servlet, vì vậy nó sẽ được triển khai dễ dàng cho bất kỳ vùng chứa tuân thủ nào có thể được cung cấp. Phần lớn có thể sử dụng các chú thích đơn giản để thiết lập máy chủ. Tóm lại, có thể tạo một máy chủ tuân thủ FHIR trong một khoảng thời gian ngắn.
Bước đầu tiên trong quá trình tạo FHIR RESTful Server là xác định một hoặc nhiều nhà cung cấp tài nguyên. “Nhà cung cấp tài nguyên” là một lớp lập trình Java có khả năng cung cấp chính xác một loại tài nguyên mà dịch vụ có thể được cung cấp. Ví dụ: nếu bạn cần kích hoạt máy chủ của mình để xử lý các tài nguyên như Bệnh nhân, Quan sát, Thuốc, Vị trí, nhóm máu, nó sẽ yêu cầu bạn sử dụng năm nhà cung cấp tài nguyên.
Lớp cung cấp tài nguyên nên sử dụng IResourceProvider giao diện. Nên có một hoặc nhiều phương pháp liên quan đến nó. Nó cũng nên được chú thích bằng các chú thích cụ thể, xác định chính xác hoạt động RESTful mà một phương thức cụ thể hỗ trợ.
Bạn có thể thêm một số lượng lớn các phương thức vào nhà cung cấp tài nguyên của mình. Bước tiếp theo là tạo máy chủ để giữ các nhà cung cấp tài nguyên và triển khai chúng.
Sau khi các nhà cung cấp tài nguyên được tạo, bước tiếp theo là khai báo một lớp máy chủ. HAPI cung cấp một lớp dựng sẵn có tên là RestfulServer là một Java Servlet chuyên dụng. Việc tạo máy chủ yêu cầu bạn chỉ cần tạo một lớp mở rộng RestfulServer .
Định nghĩa nhà cung cấp tài nguyên không được vượt quá một định nghĩa cho mỗi tài nguyên. Đó là một chiến lược tuyệt vời để giữ cho mã có thể đọc được và dễ bảo trì. Nó cũng sẽ kích hoạt các phương thức chèn cho nhiều loại tài nguyên trong một lớp trình cung cấp.
Nếu phương thức trả về trực tiếp một tài nguyên hoặc nhiều tài nguyên, thì loại tài nguyên phải được suy ra tự động. Khi phương thức trả về một tài nguyên Gói, điều quan trọng là phải chỉ ra rõ ràng loại tài nguyên trong phương thức được chú thích. Hãy xem ví dụ sau:
Thí dụ
Ví dụ, dữ liệu sẽ được máy chủ trả về ở nhiều nơi sẽ bao gồm “danh tính” hoàn chỉnh của tài nguyên. “Danh tính” trong trường hợp này có nghĩa là địa chỉ web mà người dùng có thể sử dụng để truy cập vào tài nguyên.
Ví dụ: nếu máy chủ của bạn được lưu trữ tại URL (địa chỉ web) http://xyz.com/fhir và nhà cung cấp tài nguyên của bạn trả về tài nguyên Bệnh nhân có ID “01234”, máy chủ sẽ dịch ID đó thành “http: / /xyz.com/fhir/Patology/01234. “
Máy chủ sẽ cố gắng tìm ra địa chỉ web cơ sở phải là gì, dựa trên yêu cầu mà nó nhận được và giao diện của nó, nhưng nếu địa chỉ mong đợi không đạt được, bạn có thể muốn sử dụng “chiến lược địa chỉ” khác. “
Cách dễ nhất để thực hiện việc này là định cấu hình máy chủ với URL cơ sở được mã hóa cứng, điều này ngụ ý rằng máy chủ sẽ không cố gắng xác định phần “http://xyz.com/fhir” của URL, nhưng nó sẽ, thay vào đó, hãy cố gắng sử dụng một giá trị cố định mà lập trình viên sẽ cung cấp.
Phương pháp triển khai máy chủ FHIR
Sau khi hoàn tất việc tạo các nhà cung cấp tài nguyên và lớp máy chủ RESTful, chúng có thể được sắp xếp trong một tệp WAR. Sau đó, nó sẽ được triển khai tới bất kỳ vùng chứa JEE nào (WebSphere, Glassfish, Tomcat, v.v.). Servlet phải được đóng gói thành một tệp WAR.
Máy chủ HAPI FHIR RESTful có thể tự xuất một tuyên bố khả năng (hoặc một tuyên bố tuân thủ), theo các yêu cầu của Thông số kỹ thuật FHIR.
Câu lệnh sẽ được tạo tự động và nó sẽ dựa trên các phương thức chú thích khác nhau đã được cung cấp cho máy chủ. Việc xử lý máy chủ có thể được thay đổi bằng cách tạo một lớp mới, chứa một phương thức được chú thích bằng a @Metadata Operation. Sau khi vượt qua, một thể hiện của lớp đối với setServerConformanceProvider phương thức trên máy chủ sẽ thực hiện công việc.