This is the home page for the HAPI project. HAPI (HL7 application programming interface; pronounced "happy") is an open-source, object-oriented HL7 2.x parser for Java. HL7 ( http://hl7.org ) is a messaging specification for healthcare information systems. This project is not affiliated with the HL7 organization; we are just writing some software that conforms to their specification. The project was initiated by University Health Network (a large multi-site teaching hospital in Toronto, Canada).
A new beta of HAPI (Core library, HL7 over HTTP, and Structures) has been uploaded to Sourceforge and the central Maven repo.
This new release is packed with new features. Read about them in the Changelog. There are also a number of upgrades to the base API.
We are aiming to release this soon! Please help us out by testing and reporting any issues. Download it here or use version "2.2-beta1" in Maven.
After a much-too-long wait, HAPI 2.1 has been released. Once again, this relasse is packed with new features. Most importantly it begins a transition to a simplified API where everything is centered around a HapiContext that acts as a kind of "gateway" into the whole API, and a start down the road to eventually merging the powerful parts of the .protocol.* hierarchy with the easy to use .app.* hierarchy.
The API changes are non-breaking, so existing applications will work without modification, but we would encourage developers to migrate their code where possible to use the new APIs, since this will make code more readable. Information on how to migrate is found here.
As always, a complete changelog is available here. The website has also been enhanced with a new page outlining the Maven plugins available. This means that we finally have a good document explaning how one might generate their own custom message structure classes using Message Workbench (something we have been doing for years at UHN but have never documented).
The new release has been uploaded to Sourceforge, and has also had time to synchronize to the global Maven repos, so it should be fully available now. Thanks to everyone who contributed!
A number of suggestions, comments, and other feedback have been worked into the draft specification which has now been posted.
In addition, a completely functional Java based implementation of the specification has been developed and is now available for download (in alpha form) and testing.
See the HL7 over HTTP page for more information!
Today marks a big milestone for HAPI, with the release of version 2.0 of both the HAPI Java API and the HAPI TestPanel.
The new release comes packed with tons of bugfixes, plenty of new features, and improvements. See the Changelog for information on everything that is new.
One thing to note: Migrating to the new version of the Java API should be very straightforward, but there is one notable difference to watch out for: As of version 2.0 the logging abstraction layer has changes from commons-logging to SLF4J, so you will need to include the SLf4J API JAR on your classpath. You will probably want to include an adaptor to an underlying logging framework as well. Maven users can copy the updated POM dependency snippets from here. Non-Maven users will find the new requirements in the "hapi-all" bundle on the Download area.
Thanks to everyone who contributed! In particular, this release features a huge set of contributions from Christian Ohr, who cleaned up a lot of old codebase, modernized the SimpleServer, and replaced the logging framework. It's great to see that the HAPI community continues to gain traction after a decade!
The new year brings three new developments to HAPI!
First, a new beta release of HAPI has bee posted to the download pages, as well as to the Maven central repo. HAPI 2.0-beta1 brings with it a number of exciting new features, and a number of bug fixes, which you can read about in the Changelog. In particular, a huge refactoring of the .app package (containing ConnectionHub, SimpleServer, etc.) to overhaul the thread management was committed by Christian Ohr.
This release contains a number of contributions from all over the world. Thanks to everyone who got involved!
Please be aware that this is still a beta release, and hasn't yet been thoroughly tested. In particular, several unit tests are still not passing.
Secondly, hUnit and the HAPI TestPanel have been combined, to make a fantastic new HL7 testing tool, "TestPanel 2.0". The new panel is a full featured testing and editing suite with support for all kinds of useful things including SSL, MLLP packet capture, validation, conformance profiles, and more.
Last, and probably least interesting, a new online tool has been added to the site which can be used to colourise ER7 encoded messages. This is mainly useful to people who want to embed HL7 messages or snippets in documentation, emails, web pages, etc. and have them look readable.
On October 30 2001. Bryan Tripp and a team at University Health Network registered the HAPI project with Sourceforge, and a new project was born. On November 15 2001 HAPI 0.1 was released, and 10 releases later HAPI is probably the most widely used HL7 v2 library there is.
A few stats:
Over the last five years, the number of visitors to the HAPI website has doubled, and it continues to grow. The graph below shows the number of unique visitors to our online documentation each month between 2006 and 2011.
Here are the top 100 cities this year in terms of visits to our online help.
Here are the responses from the 2011 community survey, to date.
|Describe your Organization of Company||Percentage of responses|
|None / not applicable||1.11%|
|University / college / other school||12.22%|
|Government Department, Agency, etc||6.67%|
|Public Hospital, Clinic, or other health provider||12.22%|
|Private Hospital, Clinic, or other health provider||8.89%|
|Insurer, HMO, etc.||0|
|Small software development company (under 20 developers)||23.33%|
|Medium software development company (21-100 developers)||15.56%|
|Large software development company (101+ developers)||16.67%|
This is just a sample of the companies, hospitals, governments, and educational facilities who have let us know they are using HAPI over the years. Please contact us if we can add (or remove) your company from this list!