org.eclipse.lyo.ldp.server

Interface ILDPContainer

All Superinterfaces:

ILDPRDFSource, ILDPResource

All Known Subinterfaces:

ILDPBasicContainer, ILDPDirectContainer

All Known Implementing Classes:

JenaLDPBasicContainer, JenaLDPContainer, JenaLDPDirectContainer, LDPBasicContainer, LDPContainer, LDPDirectContainer

public interface ILDPContainer
extends ILDPRDFSource

Method Summary

Modifier and Type	Method and Description
String	post(InputStream stream, String contentType, String user, String nameHint, boolean isResourceInteractionModel) Post a new member to the container.
javax.ws.rs.core.Response	postNonRDFSource(InputStream content, String stripCharset, String user, String slug) Post a new LDP-NR (non-RDF source) to the container.
boolean	putCreate(String resourceURI, InputStream stream, String contentType, String user, javax.ws.rs.core.HttpHeaders requestHeaders) Creates a new resource at resourceURI with the contents of the specified stream.
void	query(OutputStream outStream, String queryString, String resultsFormat) Execute the specified SPARQL query over the container and its entries, specifying the output format.

Methods inherited from interface org.eclipse.lyo.ldp.server.ILDPResource

delete, get, getAllowedMethods, getModel, getTypeURI, getURI, options, patch, putUpdate, setModel, setURI

Method Detail

query

void query(OutputStream outStream,
           String queryString,
           String resultsFormat)

Execute the specified SPARQL query over the container and its entries, specifying the output format. Supported formats are "application/sparql-results+xml" and "application/sparql-results+json".

Parameters:

outStream - the output stream in which to write the query result.

queryString - the SPARQL query to execute.

resultsFormat - the desired result format content type ; if null or not supported, the format will be XML.

post

String post(InputStream stream,
            String contentType,
            String user,
            String nameHint,
            boolean isResourceInteractionModel)

Post a new member to the container.

The Content-Type of the input stream is specified by the contentType argument. Supported values are "application/rdf+xml", "text/turtle", and "application/x-turtle".

Parameters:

stream - the input stream containing the posted resource representation.

contentType - the Content-Type of the input stream.

user - The user URI to use for dcterms:creator

nameHint - Value from Slug header or other source, used to determine the newly created resource's URL

isResourceInteractionModel - If true, treat container as resource (don't allow POST)

Returns:

the new resource URI

postNonRDFSource

javax.ws.rs.core.Response postNonRDFSource(InputStream content,
                                           String stripCharset,
                                           String user,
                                           String slug)

Post a new LDP-NR (non-RDF source) to the container.

Parameters:

stream - the input stream containing the posted resource representation.

contentType - the Content-Type of the input stream.

nameHint - Value from Slug header or other source, used to determine the newly created resource's URL

Returns:

the new resource URI

putCreate

boolean putCreate(String resourceURI,
                  InputStream stream,
                  String contentType,
                  String user,
                  javax.ws.rs.core.HttpHeaders requestHeaders)

Creates a new resource at resourceURI with the contents of the specified stream.

The Content-Type of the input stream is specified by the contentType argument.

Parameters:

resourceURI - the URI of to-be-created resource.

stream - the input stream containing the resource representation.

contentType - the Content-Type of the input stream.

requestHeaders - the HTTP request headers

Returns:

true if a new resource was created or false if the resource already existed