io.redlink.sdk.impl.data

Class RedLinkDataImpl

java.lang.Object

io.redlink.sdk.impl.RedLinkAbstractImpl

io.redlink.sdk.impl.data.RedLinkDataImpl

All Implemented Interfaces:

RedLink, RedLink.Data

public class RedLinkDataImpl
extends RedLinkAbstractImpl
implements RedLink.Data

RedLink's Data services implementation. To be instantiated, this implementation needs a valid Credentials object that must contain a RedLink API key which will be used in each request to the server.

Author:

sergio.fernandez@redlink.co

Nested Class Summary

Nested classes/interfaces inherited from interface io.redlink.sdk.RedLink

RedLink.Analysis, RedLink.Data, RedLink.Search

Field Summary

Fields inherited from interface io.redlink.sdk.RedLink.Data

LDPATH, PATH, QUERY, RESOURCE, SELECT, SPARQL, UPDATE

Fields inherited from interface io.redlink.sdk.RedLink

IN, OUT, URI

Constructor Summary

Constructors

Constructor and Description
RedLinkDataImpl(Credentials credentials)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	cleanDataset(String dataset) Clean (delete all the data) user's dataset.
boolean	deleteResource(String resource, String dataset) Delete a Resource identified by its URI in the user dataset passed by parameter.
org.openrdf.model.Model	exportDataset(String dataset) Export the user dataset at his RedLink application to a local RDF Model.
org.openrdf.model.Model	getResource(String resource) Get resource data by its URI as RDF Model
org.openrdf.model.Model	getResource(String resource, String dataset) Get resource data by its URI as RDF Model from the user dataset passed by parameter.
boolean	importDataset(File file, String dataset) Import the Model contained in the passed File into the selected Dataset.
boolean	importDataset(File file, String dataset, boolean cleanBefore) Import the Model contained in the passed File into the selected Dataset.
boolean	importDataset(InputStream in, org.openrdf.rio.RDFFormat format, String dataset) Import the Model contained in the passed InputStream into the selected Dataset.
boolean	importDataset(InputStream in, org.openrdf.rio.RDFFormat format, String dataset, boolean cleanBefore) Import the Model contained in the passed InputStream into the selected Dataset.
boolean	importDataset(org.openrdf.model.Model data, String dataset) Import an RDF Model into the selected Dataset.
boolean	importDataset(org.openrdf.model.Model data, String dataset, boolean cleanBefore) Import an RDF Model into the selected Dataset.
boolean	importResource(String resource, org.openrdf.model.Model data, String dataset) Import a resource represented by an RDF Model into the selected Dataset.
boolean	importResource(String resource, org.openrdf.model.Model data, String dataset, boolean cleanBefore) Import a resource represented by an RDF Model into the selected Dataset.
LDPathResult	ldpath(String uri, String program) Execute a LDPath program using as context all the configured datasets at user's RedLink application
LDPathResult	ldpath(String uri, String dataset, String program) Execute a LDPath program using the dataset passed by paramater as context.
org.openrdf.model.Model	sparqlGraphQuery(String query) Execute a SPARQL graph query using as context all the configured datasets at user's RedLink application
org.openrdf.model.Model	sparqlGraphQuery(String query, String dataset) Execute a SPARQL graph query using the dataset passed by paramater as context.
org.apache.marmotta.client.model.sparql.SPARQLResult	sparqlSelect(String query) Deprecated.
org.apache.marmotta.client.model.sparql.SPARQLResult	sparqlSelect(String query, String dataset) Deprecated.
org.apache.marmotta.client.model.sparql.SPARQLResult	sparqlTupleQuery(String query) Execute a SPARQL tuple query using as context all the configured datasets at user's RedLink application
org.apache.marmotta.client.model.sparql.SPARQLResult	sparqlTupleQuery(String query, String dataset) Execute a SPARQL tuple query using the dataset passed by paramater as context.
boolean	sparqlUpdate(String query, String dataset) Update dataset's resources using an SPARQL update query.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RedLinkDataImpl

public RedLinkDataImpl(Credentials credentials)

Method Detail

importDataset

public boolean importDataset(org.openrdf.model.Model data,
                    String dataset)
                      throws IOException,
                             org.openrdf.rio.RDFHandlerException

Description copied from interface: RedLink.Data

Import an RDF Model into the selected Dataset. The Dataset must exist at the user RedLink account and must be configured for the user's RedLink application used in the request.

Specified by:

importDataset in interface RedLink.Data

Parameters:

data - RDF Model to be imported

dataset - Name of the dataset where the data will be imported

Returns:

Flag indicating if the importation has been performed successfully

Throws:

IOException

org.openrdf.rio.RDFHandlerException

importDataset

public boolean importDataset(org.openrdf.model.Model data,
                    String dataset,
                    boolean cleanBefore)
                      throws org.openrdf.rio.RDFHandlerException,
                             IOException

Description copied from interface: RedLink.Data

Import an RDF Model into the selected Dataset. The Dataset must exist at the user RedLink account and must be configured for the user's RedLink application used in the request. If cleanBefore value is true, current dataset at user's RedLink application will be cleaned first

Specified by:

importDataset in interface RedLink.Data

Parameters:

data - RDF Model to be imported

dataset - Name of the dataset where the data will be imported

cleanBefore - Flag indicating if the dataset must be cleaned before

Returns:

Flag indicating if the importation has been performed successfully

Throws:

org.openrdf.rio.RDFHandlerException

IOException

importDataset

public boolean importDataset(File file,
                    String dataset)
                      throws FileNotFoundException

Description copied from interface: RedLink.Data

Import the Model contained in the passed File into the selected Dataset. The Dataset must exist at the user RedLink account and must be configured for the user's RedLink application used in the request

Specified by:

importDataset in interface RedLink.Data

Parameters:

file - File containing the RDF Model to be imported

dataset - Name of the dataset where the data will be imported

Returns:

Flag indicating if the importation has been performed successfully

Throws:

FileNotFoundException

importDataset

public boolean importDataset(File file,
                    String dataset,
                    boolean cleanBefore)
                      throws FileNotFoundException

Description copied from interface: RedLink.Data

Import the Model contained in the passed File into the selected Dataset. The Dataset must exist at the user RedLink account and must be configured for the user's RedLink application used in the request. If cleanBefore value is true, current dataset at user's RedLink application will be cleaned first

Specified by:

importDataset in interface RedLink.Data

Parameters:

file - File containing the RDF Model to be imported

dataset - Name of the dataset where the data will be imported

cleanBefore - Flag indicating if the dataset must be cleaned before

Returns:

Flag indicating if the importation has been performed successfully

Throws:

FileNotFoundException

importDataset

public boolean importDataset(InputStream in,
                    org.openrdf.rio.RDFFormat format,
                    String dataset)

Description copied from interface: RedLink.Data

Import the Model contained in the passed InputStream into the selected Dataset. The Dataset must exist at the user RedLink account and must be configured for the user's RedLink application used in the request

Specified by:

importDataset in interface RedLink.Data

Parameters:

in - InputStream containing the RDF Model to be imported

format - RDFFormat indicating the format of the model contained in the InputStream

dataset - Name of the dataset where the data will be imported

Returns:

Flag indicating if the importation has been performed successfully

importDataset

public boolean importDataset(InputStream in,
                    org.openrdf.rio.RDFFormat format,
                    String dataset,
                    boolean cleanBefore)

Description copied from interface: RedLink.Data

Import the Model contained in the passed InputStream into the selected Dataset. The Dataset must exist at the user RedLink account and must be configured for the user's RedLink application used in the request. If cleanBefore value is true, current dataset at user's RedLink application will be cleaned first

Specified by:

importDataset in interface RedLink.Data

Parameters:

in - InputStream containing the RDF Model to be imported

format - RDFFormat indicating the format of the model contained in the InputStream

dataset - Name of the dataset where the data will be imported

cleanBefore - Flag indicating if the dataset must be cleaned before

Returns:

Flag indicating if the importation has been performed successfully

exportDataset

public org.openrdf.model.Model exportDataset(String dataset)

Description copied from interface: RedLink.Data

Export the user dataset at his RedLink application to a local RDF Model. The Dataset must exist at the user RedLink account and must be configured for the user's RedLink application used in the request

Specified by:

exportDataset in interface RedLink.Data

Parameters:

dataset - Name of the dataset at user's RedLink application to be exported

Returns:

RDF Model representing the dataset

cleanDataset

public boolean cleanDataset(String dataset)

Description copied from interface: RedLink.Data

Clean (delete all the data) user's dataset. The Dataset must exist at the user RedLink account and must be configured for the user's RedLink application used in the request

Specified by:

cleanDataset in interface RedLink.Data

Parameters:

dataset - Name of the dataset at user's RedLink application to be cleaned

Returns:

Flag indicating if the dataset has been cleaned correctly

getResource

public org.openrdf.model.Model getResource(String resource)

Description copied from interface: RedLink.Data

Get resource data by its URI as RDF Model

Specified by:

getResource in interface RedLink.Data

Parameters:

resource - URI (identifier) of the resource

Returns:

Model representing the resource and all its properties or null if the resource is not found

getResource

public org.openrdf.model.Model getResource(String resource,
                                  String dataset)

Description copied from interface: RedLink.Data

Get resource data by its URI as RDF Model from the user dataset passed by parameter. The Dataset must exist at the user RedLink account and must be configured for the user's RedLink application used in the request

Specified by:

getResource in interface RedLink.Data

Parameters:

resource - URI (identifier) of the resource

dataset - Name of the dataset at user's RedLink application where the resource will be lookup

Returns:

importResource

public boolean importResource(String resource,
                     org.openrdf.model.Model data,
                     String dataset)

Description copied from interface: RedLink.Data

Import a resource represented by an RDF Model into the selected Dataset. The Dataset must exist at the user RedLink account and must be configured for the user's RedLink application used in the request.

Specified by:

importResource in interface RedLink.Data

Parameters:

resource - URI (identifier) of the resource

data - Resource data as RDF Model

dataset - Name of the dataset at user's RedLink application where the resource will be imported

Returns:

Flag indicating if the importation has been performed successfully

importResource

public boolean importResource(String resource,
                     org.openrdf.model.Model data,
                     String dataset,
                     boolean cleanBefore)

Description copied from interface: RedLink.Data

Import a resource represented by an RDF Model into the selected Dataset. The Dataset must exist at the user RedLink account and must be configured for the user's RedLink application used in the request. If cleanBefore value is true, current resource at user's dataset will be deleted first

Specified by:

importResource in interface RedLink.Data

Parameters:

resource - URI (identifier) of the resource

data - Resource data as RDF Model

dataset - Name of the dataset at user's RedLink application where the resource will be imported

cleanBefore - Flag indicating if the resource must be deleted before

Returns:

Flag indicating if the importation has been performed successfully

deleteResource

public boolean deleteResource(String resource,
                     String dataset)

Description copied from interface: RedLink.Data

Delete a Resource identified by its URI in the user dataset passed by parameter. The Dataset must exist at the user RedLink account and must be configured for the user's RedLink application used in the request

Specified by:

deleteResource in interface RedLink.Data

Parameters:

resource - URI (identifier) of the resource

dataset - Name of the dataset at user's RedLink application where the resource will be deleted

Returns:

Flag indicating if the deletion has been performed successfully

sparqlTupleQuery

public org.apache.marmotta.client.model.sparql.SPARQLResult sparqlTupleQuery(String query)

Description copied from interface: RedLink.Data

Execute a SPARQL tuple query using as context all the configured datasets at user's RedLink application

Specified by:

sparqlTupleQuery in interface RedLink.Data

Parameters:

query - SPARQL tuple query to be executed

Returns:

Result of the query as SPARQLResult object

sparqlSelect

@Deprecated
public org.apache.marmotta.client.model.sparql.SPARQLResult sparqlSelect(String query)

Deprecated.

Description copied from interface: RedLink.Data

use sparqlTupleQuery() instead

Specified by:

sparqlSelect in interface RedLink.Data

sparqlTupleQuery

public org.apache.marmotta.client.model.sparql.SPARQLResult sparqlTupleQuery(String query,
                                                                    String dataset)

Description copied from interface: RedLink.Data

Execute a SPARQL tuple query using the dataset passed by paramater as context. The Dataset must exist at the user RedLink account and must be configured for the user's RedLink application used in the request

Specified by:

sparqlTupleQuery in interface RedLink.Data

Parameters:

query - SPARQL tuple query to be executed

dataset - Name of the dataset at user's RedLink application where the query will be executed

Returns:

Result of the query as SPARQLResult object

sparqlSelect

@Deprecated
public org.apache.marmotta.client.model.sparql.SPARQLResult sparqlSelect(String query,
                                                                           String dataset)

Deprecated.

Description copied from interface: RedLink.Data

use sparqlTupleQuery() instead

Specified by:

sparqlSelect in interface RedLink.Data

sparqlGraphQuery

public org.openrdf.model.Model sparqlGraphQuery(String query)

Description copied from interface: RedLink.Data

Execute a SPARQL graph query using as context all the configured datasets at user's RedLink application

Specified by:

sparqlGraphQuery in interface RedLink.Data

Parameters:

query - SPARQL graph query to be executed

Returns:

Result of the query as Model object

sparqlGraphQuery

public org.openrdf.model.Model sparqlGraphQuery(String query,
                                       String dataset)

Description copied from interface: RedLink.Data

Execute a SPARQL graph query using the dataset passed by paramater as context. The Dataset must exist at the user RedLink account and must be configured for the user's RedLink application used in the request

Specified by:

sparqlGraphQuery in interface RedLink.Data

Parameters:

query - SPARQL graph query to be executed

dataset - ame of the dataset at user's RedLink application where the query will be executed

Returns:

Result of the query as Model object

sparqlUpdate

public boolean sparqlUpdate(String query,
                   String dataset)

Description copied from interface: RedLink.Data

Update dataset's resources using an SPARQL update query. The Dataset must exist at the user RedLink account and must be configured for the user's RedLink application used in the request

Specified by:

sparqlUpdate in interface RedLink.Data

Parameters:

query - SPARQL query to be executed

dataset - Name of the dataset at user's RedLink application where the query will be executed

Returns:

Flag indicating whether the update has performed successfully

ldpath

public LDPathResult ldpath(String uri,
                  String dataset,
                  String program)

Description copied from interface: RedLink.Data

Execute a LDPath program using the dataset passed by paramater as context. The Dataset must exist at the user RedLink account and must be configured for the user's RedLink application used in the request

Specified by:

ldpath in interface RedLink.Data

dataset - Name of the dataset at user's RedLink application where the query will be executed

program - LDPath program to be executed

Returns:

Result of the program execution as LDPathResult object

ldpath

public LDPathResult ldpath(String uri,
                  String program)

Description copied from interface: RedLink.Data

Execute a LDPath program using as context all the configured datasets at user's RedLink application

Specified by:

ldpath in interface RedLink.Data

program - LDPath program to be executed

Returns:

Result of the program execution as LDPathResult object