Go to file
dotasek f9561f2685 Testing Part 1 2022-01-21 15:29:17 -05:00
.github Create bidi-checker.yml 2021-11-24 16:39:41 -05:00
.mvn/wrapper Add maven wrapper 2019-01-13 15:55:51 -06:00
org.hl7.fhir.convertors Make additional caches to cover NativeHostService and ValidationService 2022-01-19 18:36:39 -05:00
org.hl7.fhir.core.generator Fix issue with comparer not rendering properly and add explicit checks around cardinality 2022-01-12 17:43:39 +11:00
org.hl7.fhir.dstu2 Updating version to: 5.6.26-SNAPSHOT and incrementing test cases dependency. 2022-01-17 22:42:22 +00:00
org.hl7.fhir.dstu3 Make additional caches to cover NativeHostService and ValidationService 2022-01-19 18:36:39 -05:00
org.hl7.fhir.dstu2016may Updating version to: 5.6.26-SNAPSHOT and incrementing test cases dependency. 2022-01-17 22:42:22 +00:00
org.hl7.fhir.r4 Make additional caches to cover NativeHostService and ValidationService 2022-01-19 18:36:39 -05:00
org.hl7.fhir.r4b Updating version to: 5.6.26-SNAPSHOT and incrementing test cases dependency. 2022-01-17 22:42:22 +00:00
org.hl7.fhir.r5 Testing Part 1 2022-01-21 15:29:17 -05:00
org.hl7.fhir.report Updating version to: 5.6.26-SNAPSHOT and incrementing test cases dependency. 2022-01-17 22:42:22 +00:00
org.hl7.fhir.utilities Make additional caches to cover NativeHostService and ValidationService 2022-01-19 18:36:39 -05:00
org.hl7.fhir.validation Testing Part 1 2022-01-21 15:29:17 -05:00
org.hl7.fhir.validation.cli Updating version to: 5.6.26-SNAPSHOT and incrementing test cases dependency. 2022-01-17 22:42:22 +00:00
.editorconfig Get this test working (#4) 2019-01-31 13:41:05 -05:00
.gitignore Fix issue with comparer not rendering properly and add explicit checks around cardinality 2022-01-12 17:43:39 +11:00
LICENSE.txt Externalized code now committed 2019-01-13 14:33:14 -06:00
README.md Merge branch 'master' into tx-server-cache-analysis 2022-01-18 16:10:21 -05:00
RELEASE_NOTES.md Updating version to: 5.6.26-SNAPSHOT and incrementing test cases dependency. 2022-01-17 22:42:22 +00:00
compare updated code.bat generated patterns + improved package cache errors 2019-05-10 00:08:18 +10:00
master-branch-pipeline.yml Update master-branch-pipeline.yml for Azure Pipelines 2021-10-12 12:26:52 -04:00
mvnw Use HTTP instead of HTTPS on maven wrapper 2019-01-28 11:17:15 -05:00
mvnw.cmd Use HTTP instead of HTTPS on maven wrapper 2019-01-28 11:17:15 -05:00
pom.xml Merge branch 'master' into tx-server-cache-analysis 2022-01-18 16:10:21 -05:00
pull-request-pipeline-parameterized.yml Update maven config and tests to allow Java 8, 11 and 17 builds (#653) 2021-11-16 09:26:53 -05:00
pull-request-pipeline.yml Update maven config and tests to allow Java 8, 11 and 17 builds (#653) 2021-11-16 09:26:53 -05:00
r4 test resources.lnk fix bug validating unknown code system 2019-01-29 21:46:02 +11:00
release-branch-pipeline.yml release branch pipeline update to ubuntu-latest 2021-10-08 13:24:33 -04:00
validation test resources.lnk fix bug validating unknown code system 2019-01-29 21:46:02 +11:00

README.md

HAPI FHIR - HL7 FHIR Core Artifacts

CI Status (master)
Build Status

This is the java core object handling code, with utilities (including validator), for the FHIR specification. included in this repo:

  • org.fhir.fhir.utilities: Shared code used by all the other projects - including the internationalization code
  • org.fhir.fhir.r5: Object models and utilities for R5 candidate (will change regularly as new R5 candidates are released)
  • org.fhir.fhir.r4b: Object models and utilities for R4B
  • org.fhir.fhir.r4: Object models and utilities for R4
  • org.fhir.fhir.dstu3: Object models and utilities for STU3
  • org.fhir.fhir.dstu2: Object models and utilities for STU2
  • org.fhir.fhir.dstu2016may: Object models and utilities for an early STU3 candidate still used by some implementers
  • org.fhir.fhir.convertors: Code to convert between versions, and other version independence code - uses all the above projects
  • org.fhir.fhir.validation: The FHIR Java validator (note: based on R5 internally, but validates all the above versions)
  • org.fhir.fhir.validation.cli: Holder project for releasing the FHIR validator as as single fat jar (will be removed in the future)

This code is used in all HAPI servers and clients, and also is the HL7 maintained FHIR Validator. In addition, this is the core code for the HL7 maintained IG publisher and FHIR main build publisher. As such, this code is considered an authoritatively correct implementation of the core FHIR specification that it implements.

CI/CD

All integration and delivery done on Azure pipelines. Azure project can be viewed here.

Current Versions

Project Current Release Latest SNAPSHOT
org.hl7.fhir.validation.cli Release Artifacts Snapshot Artifact
org.hl7.fhir.validation Release Artifacts Snapshot Artifact
org.hl7.fhir.dstu2 Release Artifacts Snapshot Artifact
org.hl7.fhir.dstu2016may Release Artifacts Snapshot Artifact
org.hl7.fhir.dstu3 Release Artifacts Snapshot Artifact
org.hl7.fhir.r4 Release Artifacts Snapshot Artifact
org.hl7.fhir.r5 Release Artifacts Snapshot Artifact

Building this Project

This project uses Apache Maven to build. To build:

mvn install

Note that unit tests will run, but are currently not set to fail the build as they do not all pass. This is being worked on.

To skip unit tests:

mvn -Dmaven.test.skip install

To clean terminology server caches.

mvn clean -Dfhir.txcache.clean=true   

The source contains cached terminology server responses for testing. If the expected responses have changed in any way, this cache should be cleaned with the above so that subsequent mvn test calls will rebuild the cache.

Publishing Binaries

An brief overview of our publishing process is here.

For more detailed instructions on cutting a release, please read the wiki

Download

All binaries are published on OSS Sonatype. You will need to add the proper dependency to your pom.xml file, or your build.gradle.kts file.

pom.xml
<repositories>
    <repository>
        <id>oss-snapshot</id>
        <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
    </repository>
    <repository>
        <id>oss-releases</id>
        <url>https://oss.sonatype.org/service/local/staging/deploy/maven2/</url>
    </repository>
</repositories> 
build.gradle.kts
repositories {
    maven {
        url = uri("https://oss.sonatype.org/content/repositories/snapshots")
    }
    maven {
        url = uri("https://oss.sonatype.org/service/local/staging/deploy/maven2/")
    }
}

After adding the necessary repositories, you can include the libraries as follows:

org.hl7.fhir.validation.cli
Maven
<dependency>
    <groupId>ca.uhn.hapi.fhir</groupId>
    <artifactId>org.hl7.fhir.validation.cli</artifactId>
    <version>(latest version)</version>
</dependency>
Gradle
compile group: 'ca.uhn.hapi.fhir', name: 'org.hl7.fhir.validation.cli', version: '(latest version)'
org.hl7.fhir.dstu2
Maven
<dependency>
    <groupId>ca.uhn.hapi.fhir</groupId>
    <artifactId>hapi-fhir-structures-dstu2</artifactId>
    <version>(latest version)</version>
</dependency>
Gradle
compile group: 'ca.uhn.hapi.fhir', name: 'hapi-fhir-structures-dstu2', version: '(latest version)'
org.hl7.fhir.dstu3
Maven
<dependency>
    <groupId>ca.uhn.hapi.fhir</groupId>
    <artifactId>hapi-fhir-structures-dstu3</artifactId>
    <version>(latest version)</version>
</dependency>
Gradle
compile group: 'ca.uhn.hapi.fhir', name: 'hapi-fhir-structures-dstu3', version: '(latest version)'
org.hl7.fhir.r4
Maven
<dependency>
    <groupId>ca.uhn.hapi.fhir</groupId>
    <artifactId>hapi-fhir-structures-r4</artifactId>
    <version>(latest version)</version>
</dependency>
Gradle
compile group: 'ca.uhn.hapi.fhir', name: 'hapi-fhir-structures-r4', version: '(latest version)'
org.hl7.fhir.r5
Maven
<dependency>
    <groupId>ca.uhn.hapi.fhir</groupId>
    <artifactId>hapi-fhir-structures-r5</artifactId>
    <version>(latest version)</version>
</dependency>
Gradle
compile group: 'ca.uhn.hapi.fhir', name: 'hapi-fhir-structures-r5', version: '(latest version)'

Note that the built binary validator is released through GitHub releases.

Maintenance

This project is maintained by Grahame Grieve, James Agnew and Mark Iantorno on behalf of the FHIR community.