03ebcafdf5
* Initial refactoring to move database matcher out into its own class * MAJOR REFACTOR: Pulled indexing code out of BaseHapiFhirDao into a new class ResourceIndexedSearchParams * Moved calculateHashes * Replaced @Bean definitions in BaseConfig.java with @ComponentScan Annotated bean classes with either @Service (if it's stateless) or @Component (if it's stateful). It doesn't really matter which annotation is used, but it's helpful to see at a glance whether a bean is stateful or stateless. * Move services out of BaseHapiFhirDao Moved services required by ResourceIndexedSearchParams out of BaseHapiFhirDao and into new classes called LogicalReferenceHelper, IdHelperService, MatchUrlService, and DaoProvider. Converted SearchBuilder into Prototype Bean Mark Spring components that depend on daos and entitymanagers with @Lazy so they aren't picked up by hapi-fhir-spring-boot-autoconfigure. * Added SubscriptionMatcherInMemory Moved static data out of BaseHapiFhirDao into ResourceMetaParams Moved translateMatchUrl methods out of BaseHapiFhirDao into MatchUrlService bean Simplified SubscriptionMatcherInMemory to not depend on entity or dao Turned all subscribers into prototype beans * Moved searchParam method out to mySearchParamProvider Also removed dao and contest parameters from of myMatchUrlService methods Moved code out of SearchBuilder into SearchParameterMap.clean() so it can be used by inMemoryMatcher Introduced a new composite subscription matcher that tries to match in memory and if it finds a parameter in the criteria it doesn't support, it falls back to the database matcher. * Added support for references Also fixed a small bug in SearchParameterMap that was missing the ";" after "_has" when creating a normalized query from search params. * Finished implementing all tests from FhirResourceDaoR4SearchNoFtTest * Make in-memory matcher configurable, disabled by default * Validate Subscription criteria when they're submitted Send HTTP 422 UnprocessableEntityException if the criteria fail validation. * fixed Sonar "Blocker" issues. * Don't reload the resource before sending it out Since we can always force a reload using restHookDetails.isDeliverLatestVersion * Added tests to cover Custom Search param. * Split ResourceIndexedSearchParam into separate state and service classes * Cleaned up SearchBuilder. Removed uses of myCallingDao as an injection mechanism. Left // FIXME KHS cookie crumbs to clean up * Reduced dependencies on BaseHapiFhirDao Removed methods from IDao interface that were used for injection * Updated change log |
||
---|---|---|
.. | ||
src | ||
.gitignore | ||
Dockerfile | ||
README.md | ||
build-docker-image.sh | ||
pom.xml |
README.md
Running hapi-fhir-jpaserver-example in Tomcat from IntelliJ
Install Tomcat.
Make sure you have Tomcat set up in IntelliJ.
- File->Settings->Build, Execution, Deployment->Application Servers
- Click +
- Select "Tomcat Server"
- Enter the path to your tomcat deployment for both Tomcat Home (IntelliJ will fill in base directory for you)
Add a Run Configuration for running hapi-fhir-jpaserver-example under Tomcat
- Run->Edit Configurations
- Click the green +
- Select Tomcat Server, Local
- Change the name to whatever you wish
- Uncheck the "After launch" checkbox
- On the "Deployment" tab, click the green +
- Select "Artifact"
- Select "hapi-fhir-jpaserver-example:war"
- In "Application context" type /hapi
Run the configuration.
- You should now have an "Application Servers" in the list of windows at the bottom.
- Click it.
- Select your server, and click the green triangle (or the bug if you want to debug)
- Wait for the console output to stop
Point your browser (or fiddler, or what have you) to http://localhost:8080/hapi/base/Patient
You should get an empty bundle back.
Running hapi-fhir-jpaserver-example in a Docker container
Execute the build-docker-image.sh
script to build the docker image.
Use this command to start the container:
docker run -d --name hapi-fhir-jpaserver-example -p 8080:8080 hapi-fhir/hapi-fhir-jpaserver-example
Note: with this command data is persisted across container restarts, but not after removal of the container. Use a docker volume mapping on /var/lib/jetty/target to achieve this.
Using ElasticSearch as the search engine instead of the default Apache Lucene
- Install ElasticSearch server and the phonetic plugin
- Download ElasticSearch from https://www.elastic.co/downloads/elasticsearch
cd {your elasticsearch directory}
bin/plugin install analysis-phonetic
- start ElasticSearch server:
./bin/elasticsearch
- Replace configuration in web.xml
- replace the configuration class
ca.uhn.fhir.jpa.demo.FhirServerConfig
in web.xml byca.uhn.fhir.jpa.demo.elasticsearch.FhirServerConfig
- replace the configuration class
- Start server by runing:
mvn jetty:run
- Limitations:
- Hibernate search are not compatible with all ElasticSearch version. If you are using Hibernate search: 5.6 or 5.7, the compatible ElasticSearch version is 2.0 - 2.4. If you are using Hibernate search: 5.8 or 5.9, the compatible ElasticSearch version is 2.0 - 5.6.
- Please check all the limitations in the reference documentation: https://docs.jboss.org/hibernate/search/5.7/reference/en-US/html_single/#elasticsearch-limitations before use the integration.