This page presents straw man data models for objects that may not need Linked Data Platform Containers (LDPCs).
The defining characteristics of this class of objects:
- They do not contain bitstreams, but rather, metadata about bitstreams held elsewhere
- They may contain pointer(s) to the referenced bitstreams (or bitstream objects)
The related concept in LDP (Linked Data Platform) terms: Non-LDPC LDPRs
- LDPR: Linked Data Platform Resource
- LDPC: Linked Data Platform Container
To what extent can/should this class of objects be modeled as LDPRs not contained within a LDPC?
What are the benefits of such a model?
What are the drawbacks or limitations?
Background: LDP and its mapping to Fedora objects
The LDP specification lays out the following concepts, interaction modes, and constraints on content:
| LDP Concept | LDP Interaction Modes | Constraints on Content |
|---|---|---|
| Container (LDPC) | LDPC, LDP-RS | RDF, must contain LDP membership triples for all members |
| Non-RDF Source (LDP-NR) | LDPR, LDP-NR | none |
| Non-Container RDF Source (LDP-RS-NC) | LDPR, LDP-RS | RDF |
The last concept "Non-Container RDF Source" isn't given a specific name in the LDP spec, so we call it an LDP-RS-NC for the sake of discussion.
The defining characteristics of the interaction modes described in LDP are briefly summarized as follows
- LDPC interaction mode defines ability to create resources within the container via HTTP POST, remove them via HTTP DELETE, and places requirements on the HTTP headers of the LDPC resource to advertise its role as a container.
- LDPR interaction mode does not imply the creation new resources with HTTP POST on an LDPR
- LDP-NR interaction mode implies POST, PUT, and PATCH do not have any special semantics; a resource is nothing more than a binary blob with a media type
- LDP-RS interaction mode implies that POST, PUT, GET, and PATCH are logical RDF operations with enhanced semantics and behaviour:
- LDP servers must interpret relative URIs as relative to the resource (for example, allowing null relative URIs "<>" to refer to the to-be-created resource URI)
- LDP Servers may adopt standards such as SPARQL/Update for update semantics via methods such as PATCH
- LDP Servers must provide, at minimum, text/turtle and application/ld+json representations when requested via GET.
At present, the mapping of Fedora concepts to LDP Concepts are as follows
| LDP Concept | Fedora Concept | LDP Interaction Modes | Constraints on Content |
|---|---|---|---|
| LDPC | Object | LDPC, LDP-RS | RDF, must contain LDP membership triples, subjects must be repository objects, subjects must be the URI of the object |
| LDP-NR | Datastream | LDPR, LDP-NR | none |
| LDP-RS-NC | - | - | - |
The issue at hand is whether Fedora should support the LDP construct of an RDF source that is not also a container (LDP-RS-NC), and how such an resource in LDP would map to a concept in Fedora.
Proposal: Fedora container object with a child resource at a specified path redirecting to external content
Request 1: create container object
curl -i -X PUT "http://localhost:8080/rest/my_external_datastream_obj"
HTTP/1.1 201 Created
ETag: "f93bbf77fee0fa16da4872102a54240e7135eaf2"
Last-Modified: Thu, 12 Mar 2015 20:56:08 GMT
Content-Length: 53
Location: http://localhost:8080/rest/my_external_datastream_obj
Content-Type: text/plain
Server: Jetty(8.1.12.v20130726)
curl -H "Accept: text/turtle" "http://localhost:8080/rest/my_external_datastream_obj"
<http://localhost:8080/rest/my_external_datastream_obj> a ldp:RDFSource , ldp:Container , <http://www.jcp.org/jcr/nt/1.0folder> , <http://www.jcp.org/jcr/nt/1.0hierarchyNode> , <http://www.jcp.org/jcr/nt/1.0base> , <http://www.jcp.org/jcr/mix/1.0created> , fedora:Container , fedora:Resource , fedora:Resource , <http://www.jcp.org/jcr/mix/1.0created> , <http://www.jcp.org/jcr/mix/1.0lastModified> , <http://www.jcp.org/jcr/mix/1.0referenceable> ;
fedora:lastModifiedBy "bypassAdmin"^^<http://www.w3.org/2001/XMLSchema#string> ;
fedora:uuid "fe7a8497-d826-490d-a786-ba601e039055"^^<http://www.w3.org/2001/XMLSchema#string> ;
fedora:createdBy "bypassAdmin"^^<http://www.w3.org/2001/XMLSchema#string> ;
fedora:primaryType "nt:folder"^^<http://www.w3.org/2001/XMLSchema#string> ;
fedora:created "2015-03-12T20:56:08.468Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> ;
fedora:mixinTypes "fedora:Container"^^<http://www.w3.org/2001/XMLSchema#string> , "fedora:Resource"^^<http://www.w3.org/2001/XMLSchema#string> ;
fedora:lastModified "2015-03-12T20:56:08.468Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> ;
fedora:writable "true"^^<http://www.w3.org/2001/XMLSchema#boolean> ;
fedora:hasParent <http://localhost:8080/rest/> ;
fedora:exportsAs <http://localhost:8080/rest/my_external_datastream_obj/fcr:export?format=jcr/xml> .
<http://localhost:8080/rest/my_external_datastream_obj/fcr:export?format=jcr/xml> dc:format <http://fedora.info/definitions/v4/repository#jcr/xml> .
<http://fedora.info/definitions/v4/repository#jcr/xml> rdfs:label "jcr/xml"^^<http://www.w3.org/2001/XMLSchema#string> .
Request 2: create child external content object
curl -i -X PUT -H"Content-Type: message/external-body; access-type=URL; URL=\"http://en.wikipedia.org/wiki/File:Harry_Whittier_Frees_-_What%27s_Delaying_My_Dinner.jpg\"" "http://localhost:8080/rest/my_external_datastream_obj/extds" HTTP/1.1 201 Created ETag: "cbc2d06dd76fe1b3f6379e5dc0b8212ab056443e" Last-Modified: Thu, 12 Mar 2015 21:08:33 GMT Link: <http://localhost:8080/rest/my_external_datastream_obj/extds/fcr:metadata>; rel="describedby" Content-Length: 59 Location: http://localhost:8080/rest/my_external_datastream_obj/extds Content-Type: text/plain Server: Jetty(8.1.12.v20130726) http://localhost:8080/rest/my_external_datastream_obj/extds curl -i "http://localhost:8080/rest/my_external_datastream_obj/extds" HTTP/1.1 307 Temporary Redirect ETag: "cbc2d06dd76fe1b3f6379e5dc0b8212ab056443e" Last-Modified: Thu, 12 Mar 2015 21:08:33 GMT Content-Type: message/external-body; access-type=URL; url="http://en.wikipedia.org/wiki/File:Harry_Whittier_Frees_-_What%27s_Delaying_My_Dinner.jpg" Content-Length: 0 Accept-Ranges: bytes Content-Disposition: attachment; filename=""; creation-date="Thu, 12 Mar 2015 21:08:33 GMT"; modification-date="Thu, 12 Mar 2015 21:08:33 GMT"; size=0 Link: <http://www.w3.org/ns/ldp#Resource>;rel="type" Link: <http://www.w3.org/ns/ldp#NonRDFSource>;rel="type" Link: <http://localhost:8080/rest/my_external_datastream_obj/extds/fcr:metadata>; rel="describedby" Allow: DELETE,HEAD,GET,PUT,OPTIONS Location: http://en.wikipedia.org/wiki/File:Harry_Whittier_Frees_-_What%27s_Delaying_My_Dinner.jpg Server: Jetty(8.1.12.v20130726)
The complete thing
curl -H "Accept: text/turtle" -H "Prefer: return=representation; include=\"http://fedora.info/definitions/v4/repository#EmbedResources\";" "http://localhost:8080/rest/my_external_datastream_obj"
<http://localhost:8080/rest/my_external_datastream_obj> a ldp:RDFSource , ldp:Container , <http://www.jcp.org/jcr/nt/1.0folder> , <http://www.jcp.org/jcr/nt/1.0hierarchyNode> , <http://www.jcp.org/jcr/nt/1.0base> , <http://www.jcp.org/jcr/mix/1.0created> , fedora:Container , fedora:Resource , fedora:Resource , <http://www.jcp.org/jcr/mix/1.0created> , <http://www.jcp.org/jcr/mix/1.0lastModified> , <http://www.jcp.org/jcr/mix/1.0referenceable> ;
fedora:lastModifiedBy "bypassAdmin"^^<http://www.w3.org/2001/XMLSchema#string> ;
fedora:uuid "fe7a8497-d826-490d-a786-ba601e039055"^^<http://www.w3.org/2001/XMLSchema#string> ;
fedora:createdBy "bypassAdmin"^^<http://www.w3.org/2001/XMLSchema#string> ;
fedora:primaryType "nt:folder"^^<http://www.w3.org/2001/XMLSchema#string> ;
fedora:created "2015-03-12T20:56:08.468Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> ;
fedora:mixinTypes "fedora:Container"^^<http://www.w3.org/2001/XMLSchema#string> , "fedora:Resource"^^<http://www.w3.org/2001/XMLSchema#string> ;
fedora:lastModified "2015-03-12T21:08:33.787Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> ;
fedora:writable "true"^^<http://www.w3.org/2001/XMLSchema#boolean> ;
fedora:hasParent <http://localhost:8080/rest/> ;
ldp:contains <http://localhost:8080/rest/my_external_datastream_obj/extds> .
<http://localhost:8080/rest/my_external_datastream_obj/extds> a <http://www.jcp.org/jcr/nt/1.0resource> , <http://www.jcp.org/jcr/nt/1.0base> , <http://www.jcp.org/jcr/mix/1.0mimeType> , <http://www.jcp.org/jcr/mix/1.0lastModified> , fedora:Binary , fedora:Resource , <http://www.jcp.org/jcr/mix/1.0created> , <http://www.jcp.org/jcr/mix/1.0lastModified> , <http://www.jcp.org/jcr/mix/1.0referenceable> ;
fedora:lastModifiedBy "bypassAdmin"^^<http://www.w3.org/2001/XMLSchema#string> ;
fedora:uuid "86aa4107-768d-4e2d-9064-78be072c0888"^^<http://www.w3.org/2001/XMLSchema#string> ;
fedora:mimeType "message/external-body; access-type=URL; url=\"http://en.wikipedia.org/wiki/File:Harry_Whittier_Frees_-_What%27s_Delaying_My_Dinner.jpg\""^^<http://www.w3.org/2001/XMLSchema#string> ;
fedora:digest <urn:sha1:da39a3ee5e6b4b0d3255bfef95601890afd80709> ;
premis:hasSize "0"^^<http://www.w3.org/2001/XMLSchema#long> ;
fedora:createdBy "bypassAdmin"^^<http://www.w3.org/2001/XMLSchema#string> ;
fedora:primaryType "nt:resource"^^<http://www.w3.org/2001/XMLSchema#string> ;
fedora:created "2015-03-12T21:08:33.787Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> ;
fedora:mixinTypes "fedora:Binary"^^<http://www.w3.org/2001/XMLSchema#string> ;
fedora:lastModified "2015-03-12T21:08:33.787Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> ;
premis:hasOriginalName ""^^<http://www.w3.org/2001/XMLSchema#string> .
<http://localhost:8080/rest/my_external_datastream_obj> fedora:exportsAs <http://localhost:8080/rest/my_external_datastream_obj/fcr:export?format=jcr/xml> .
<http://localhost:8080/rest/my_external_datastream_obj/fcr:export?format=jcr/xml> dc:format <http://fedora.info/definitions/v4/repository#jcr/xml> .
<http://fedora.info/definitions/v4/repository#jcr/xml> rdfs:label "jcr/xml"^^<http://www.w3.org/2001/XMLSchema#string> .
LDP to Fedora mapping
| LDP Concept | Fedora Concept | LDP Interaction Modes | Constraints on Content |
|---|---|---|---|
| LDPC | Object | LDPC, LDP-RS | RDF, must contain LDP membership triples, subjects must be repository objects, subjects must be the URI of the object |
| LDP-NR | Datastream | LDPR, LDP-NR | none |
| LDP-RS-NC | - | - | - |
Note that this proposal maintains the current behaviour in that LDP-RS-NC is not supported.
Proposal: LDP-RS as datastreams
In this proposal, an LDP-RS-NC maps to a Fedora datastream. In the fedora object model, they are no different from the datastreams that already exist, and have no inherent characteristics that make them different in any way. The difference lies in the HTTP API, in that they support the LDP-RS interaction mode as described in the background section of this document.
An LDP-RS-NC (datastream) shall be created when the client specifies an LDPR interaction model for newly created resources as per section 5.2.3.4 of the LDP spec.
LDP to Fedora mapping
| LDP Concept | Fedora Concept | LDP Interaction Modes | Constraints on Content |
|---|---|---|---|
| LDPC | Object | LDPC, LDP-RS | RDF, must contain LDP membership triples, subjects must be repository objects, subjects must be the URI of the object |
| LDP-NR | Datastream | LDPR, LDP-NR | none |
| LDP-RS-NC | Datastream | LDPR, LDP-RS | RDF |
Note that 'Objects' in the Fedora model map to the LDPC interaction model, while 'Datastreams' in Fedora map to the LDPR interaction model. The distinguishing factor of a Fedora object, as exposed by LDP, is that it is a container. The distinguishing factor of a datastream, exposed in LDP, is that it is not a container (i.e. it is a leaf node in the LDP model).
Discussion
Mapping the LDP-RS-NC (non-container RDF source resources) to datastreams has several consequences as a result of the LDP-RS interaction mode defined by LDP, or as a result of their nature as a datastream
- The Fedora object model does not change at all with this proposal
- The LDP-RS-NCs created by Fedora may contain arbitrary RDF. This is a consequence of their 'datastream' nature, in that their content is largely opaque to the Fedora model. They are blobs, so there is no inherent need to constrain their content other than to verify that they contain RDF as implied by an LDP-RS.
- No inherent restriction on allowable subjects, predicates, or objects in the triples
- No inherent restriction on constructs such as blank nodes
- The LDP-RS-NCs created to by Fedora may be 'pure' in that they are logically unmodified from client requests. Again, this is due to their nature as an opaque datastream as far as the fedora model is concerned.
- No server managed triples are added by Fedora
- The LDP-RS-NCs benefit from the LDP-RS interaction model as defined by LDP on these resources:
- Retrieve triples in specified representation (xml, turtle, ntriples, etc); as per LDP spec text/turtle and application/ld+json representations are always available.
- SPARQL Update semantics (PATCH)
- Interpretation of relative URIs in RDF content as per the LDP spec (for example, allowing null relative URIs "<>" to refer to the to-be-created resource URI)
If it helps, this proposal can be also be conceptualized as a kind of 'service' provided on top of a datastream to provide an enhanced RDF CRUD API that neatly maps to an LDP concept that Fedora does not currently support, but most LDP servers do.
Use cases
- Arbitrary RDF documents as 'assets' managed by Fedora, yet accessible via the LDP-RS API. For example, Tim Berners-Lee's FOAF file.
- It contains multiple subjects, for example when providing details of linked blog posts, papers, or conferences.
- Named-graph provenance
- A place to put statements that are not allowable in Fedora objects, as a pragmatic workaround (e.g. assertions about an external resource)
Implementation notes
- Fedora may describe these resources using slightly different metadata in their corresponding 'fcr:metadata' resources.
- For example, "fedora:mixinTypes "fedora:NonRdfSourceDescription"^^<http://www.w3.org/2001/XMLSchema#string>" is probably not appropriate.
- Basic validation as well-formed RDF or SPARQL/update statements is a prerequisite for accepting content.
- The binary representation of an LDP-RS-NC as persisted in Fedora as datastream content may potentially be opaque (a decision would need to be made on this)
- The serialization format may be specified in advance. For example, Fedora may chose to serialize as turtle, always
- Fedora may perhaps chose to store the exact binary content supplied by the client via PUT, and record metadata indicating which RDF serialization had been persisted.
- Likewise, the content may be entirely opaque, leaving it an implementation decision that can change at any time.
Proposal: LDPRs as "Pointlike objects"
In this view, LDP-RS-NCs appear in the repository as objects without datastreams or contained objects. They would possess all the functions of other objects, except that attempts to add children to them (datastreams or child objects) would fail under all circumstances. They could support the interaction described in section 5.2.3.4 of the LDP specification, if a client so specifies in the appropriate way when creating one. Their serializations would be no different from those of any other object, nor would they offer a special binary representation of any kind, other than as provided for by any object in the repository.
LDP to Fedora mapping
| LDP Concept | Fedora Concept | LDP Interaction Modes | Constraints on Content |
|---|---|---|---|
| LDPC | Object | LDPC, LDP-RS | RDF, must contain LDP membership triples, subjects must be repository objects, subjects must be the URI of the object |
| LDP-NR | Datastream | LDPR, LDP-NR | none |
| LDP-RS-NC | Object | LDPR, LDP-RS | RDF, subjects must be repository objects, subjects must be the URI of the object |
Note that 'Objects' in the Fedora model map to the LDP-RS interaction model, while 'Datastreams' in Fedora map to the LDP-NR interaction model. The distinguishing factor of a Fedora object, as exposed by LDP, is that is an RDF source. The distinguishing factor of a datastream is that it is a non-RDF source.
