Documentation updates

This commit is contained in:
James Agnew 2014-10-23 12:32:54 -04:00
parent 8f02bd734e
commit 69ee8a4777
4 changed files with 72 additions and 10 deletions

View File

@ -0,0 +1,36 @@
package example;
import ca.uhn.fhir.context.FhirContext;
import ca.uhn.fhir.model.dstu.resource.Organization;
import ca.uhn.fhir.model.dstu.resource.Patient;
public class ResourceRefs {
private static FhirContext ourCtx = new FhirContext();
public static void main(String[] args) {
manualContained();
}
public static void manualContained() {
// START SNIPPET: manualContained
// Create an organization, and give it a local ID
Organization org = new Organization();
org.setId("#localOrganization");
org.getName().setValue("Contained Test Organization");
// Create a patient
Patient patient = new Patient();
patient.setId("Patient/1333");
patient.addIdentifier("urn:mrns", "253345");
// Set the reference, and manually add the contained resource
patient.getManagingOrganization().setReference("#localOrganization");
patient.getContained().getContainedResources().add(org);
String encoded = ourCtx.newXmlParser().setPrettyPrint(true).encodeResourceToString(patient);
System.out.println(encoded);
// END SNIPPET: manualContained
}
}

View File

@ -6,7 +6,7 @@
<title>HAPI FHIR Changelog</title> <title>HAPI FHIR Changelog</title>
</properties> </properties>
<body> <body>
<release version="0.7" date="TBD"> <release version="0.7" date="2014-Oct-23">
<action type="add" issue="30"> <action type="add" issue="30">
<![CDATA[<b>API CHANGE:</b>]]> The TagList class previously implemented ArrayList semantics, <![CDATA[<b>API CHANGE:</b>]]> The TagList class previously implemented ArrayList semantics,
but this has been replaced with LinkedHashMap semantics. This means that the list of but this has been replaced with LinkedHashMap semantics. This means that the list of

View File

@ -209,6 +209,17 @@ System.out.println(encoded);]]></source>
</subsection> </subsection>
<p>
Note that you may also "contain" resources manually in your own code if you
prefer. The following example show how to do this:
</p>
<macro name="snippet">
<param name="id" value="manualContained" />
<param name="file" value="examples/src/main/java/example/ResourceRefs.java" />
</macro>
</section> </section>

View File

@ -40,15 +40,30 @@
<section name="Announcements"> <section name="Announcements">
<p> <p>
<b>Oct 22, 2014 - HAPI FHIR 0.7 Released</b> - A new build has been uploaded, <b>Oct 23, 2014 - HAPI FHIR 0.7 Released</b> - HAPI 0.7 has been released!
containing a number of new features and bug fixes. See the changelog This release contains a number of contributions and bugfixes from all over
for a complete list of what has changed. Of particular note, the way the FHIR community. Thanks to everyone who contributed!
that contained resources are automatically serialized has been adjusted. This was </p>
technically a bugfix, as the previous version was often repeating encoded <p>
resources as top-level resources in returned bundles, but it is possible that In particular, note that this release corrects an issue where contained resources
implementations have been relying on this b sometimes got encoded as both contained and top-level resources, and top level
the TagList resources sometimes got encoded as contained resources. It is possible that some
class has been switched from a List to a Set based on discussion existing applications depended on the buggy behaviour, so please do a bit of extra
testing on your server applications if you use contained resources at all. See
the <a href="http://jamesagnew.github.io/hapi-fhir/doc_resource_references.html">resource references</a>
documentation for a bit more information on how these work, and please feel free to
post to the <a href="https://groups.google.com/d/forum/hapi-fhir">google group</a>
if things aren't working as expected.
</p>
<p>
This release also introduces a fascinating <a href="https://www.vagrantup.com/">Vagrant</a>
based development environment contributed by Preston Lee which should allow you
to try out a fully functional, database backed HAPI server in a virtual server
on your own development box.
</p>
<p>
See the <a href="http://jamesagnew.github.io/hapi-fhir/changes-report.html">changelog</a>
for a complete list of what's new!
<br/> <br/>
- <a href="mailto:jamesagnew@users.sourceforge.net">James Agnew</a> - <a href="mailto:jamesagnew@users.sourceforge.net">James Agnew</a>
</p> </p>