{title:'URI Properties', updated:'9.0.0'}

Bean properties of type java.net.URI or java.net.URL have special meaning to the RDF serializer. They are interpreted as resource identifiers.

In the following code, we're adding 2 new properties. The first property is annotated with @Beanp to identify that this property is the resource identifier for this bean. The second un-annotated property is interpreted as a reference to another resource.

| public class Person { | | // Bean properties | @Rdf(beanUri=true) | public URI uri; | | public URI addressBookUri; | | ... | | // Normal constructor | public Person(int id, String name, String uri, String addressBookUri) throws URISyntaxException { | this.id = id; | this.name = name; | this.uri = new URI(uri); | this.addressBookUri = new URI(addressBookUri); | } | }

We alter our code to pass in values for these new properties.

| // Create our bean. | Person person = new Person(1, "John Smith", "http://sample/addressBook/person/1", | "http://sample/addressBook");

Now when we run the sample code, we get the following:

| <rdf:RDF | xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" | xmlns:j="http://www.apache.org/juneau/" | xmlns:jp="http://www.apache.org/juneaubp/" | xmlns:per="http://www.apache.org/person/"> | <rdf:Description rdf:about="http://sample/addressBook/person/1"> | <per:addressBookUri rdf:resource="http://sample/addressBook"/> | <per:id>1</per:id> | <per:name>John Smith</per:name> | </rdf:Description> | </rdf:RDF>

The {@link oaj.annotation.Uri @Uri} annotation can also be used on classes and properties to identify them as URLs when they're not instances of java.net.URI or java.net.URL (not needed if @Rdf(beanUri=true) is already specified).

The following properties would have produced the same output as before. Note that the @URI annotation is only needed on the second property.

| public class Person { | | // Bean properties | @Rdf(beanUri=true) public String uri; | | @URI public String addressBookUri;

Also take note of the {@link oaj.serializer.Serializer.Builder#uriResolution(UriResolution)}, {@link oaj.serializer.Serializer.Builder#uriRelativity(UriRelativity)}, and and {@link oaj.serializer.Serializer.Builder#uriContext(UriContext)} settings that can be specified on the serializer to resolve relative and context-root-relative URIs to fully-qualified URIs.

This can be useful if you want to keep the URI authority and context root information out of the bean logic layer.

The following code produces the same output as before, but the URIs on the beans are relative.

| // Create a new serializer with readable output. | RdfSerializer serializer = RdfSerializer.create() | .xmlabbrev() | .rdfxml_tab(3); | .relativeUriBase("http://myhost/sample"); | .absolutePathUriBase("http://myhost") | .build(); | | // Create our bean. | Person person = new Person(1, "John Smith", "person/1", "/"); | | // Serialize the bean to RDF/XML. | String rdfXml = serializer.serialize(person);