Documentation updates
This commit is contained in:
parent
8f02bd734e
commit
69ee8a4777
|
@ -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
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
|
@ -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
|
||||||
|
|
|
@ -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>
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -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>
|
||||||
|
|
Loading…
Reference in New Issue