org.apache.jena.query

Class DatasetFactory

java.lang.Object

org.apache.jena.query.DatasetFactory

public class DatasetFactory
extends Object

Makes Datasets in various ways.

Constructor Summary

Constructors

Constructor and Description
DatasetFactory()

Method Summary

Modifier and Type	Method and Description
static Dataset	assemble(Model model) Assemble a dataset from the model
static Dataset	assemble(Resource resource) Assemble a dataset from a resource
static Dataset	assemble(String filename) Assemble a dataset from the model in a file
static Dataset	assemble(String filename, String resourceURI) Assemble a dataset from the model in a file
static Dataset	create() Create an in-memory Dataset.
static Dataset	create(Dataset dataset) Deprecated. This operation may be removed.
static Dataset	create(DatasetGraph dataset) Deprecated. Use wrap(org.apache.jena.sparql.core.DatasetGraph)
static Dataset	create(List<String> uriList)
static Dataset	create(List<String> uriList, List<String> namedSourceList) Create a dataset based on two list of URIs.
static Dataset	create(List<String> uriList, List<String> namedSourceList, String baseURI) Create a named graph container based on two list of URIs.
static Dataset	create(Model model) Create a dataset, starting with the model argument as the default graph of the dataset.
static Dataset	create(String uri)
static Dataset	create(String uri, List<String> namedSourceList) Create a dataset container based on two list of URIs.
static Dataset	create(String uri, List<String> namedSourceList, String baseURI) Create a named graph container based on two list of URIs.
static Dataset	createGeneral() Create a general-purpose Dataset. Any graphs needed are in-memory unless explicitly added with Dataset.addNamedModel(java.lang.String, org.apache.jena.rdf.model.Model).
static Dataset	createMem() Deprecated. Prefer createTxnMem() or create() or, for special cases, createGeneral().
static Dataset	createNamed(List<String> namedSourceList)
static Dataset	createTxnMem() Create an in-memory.
static Dataset	wrap(DatasetGraph dataset) Wrap a DatasetGraph to make a dataset
static Dataset	wrap(Model model) Wrap a Model to make a dataset; the model is the default graph of the RDF Dataset.

Methods inherited from class java.lang.Object

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

Constructor Detail

DatasetFactory

public DatasetFactory()

Method Detail

create

public static Dataset create()

Create an in-memory Dataset.

See also createTxnMem() for a transactional dataset.

This implementation copies models when Dataset.addNamedModel(String, Model) is called.

This implementation does not support serialized transactions (it only provides MRSW locking).

See Also:

createTxnMem()

createTxnMem

public static Dataset createTxnMem()

Create an in-memory. transactional Dataset.

This fully supports transactions, including abort to roll-back changes. It provides "autocommit" if operations are performed outside a transaction but with a performance impact (the implementation adds a begin/commit around each add or delete so overheads can accumulate).

Returns:

a transactional, in-memory, modifiable Dataset

createGeneral

public static Dataset createGeneral()

Create a general-purpose Dataset.
Any graphs needed are in-memory unless explicitly added with Dataset.addNamedModel(java.lang.String, org.apache.jena.rdf.model.Model).

This dataset type can contain graphs from any source when added via Dataset.addNamedModel(java.lang.String, org.apache.jena.rdf.model.Model). These are held as links to the supplied graph and not copied.

This dataset does not support the graph indexing feature of jena-text.

This dataset does not support serialized transactions (it only provides MRSW locking).

Returns:

a general-purpose Dataset

See Also:

createTxnMem()

createMem

@Deprecated
public static Dataset createMem()

Deprecated. Prefer createTxnMem() or create() or, for special cases, createGeneral().

Create an in-memory Dataset.

See also createTxnMem() for a transactional dataset.

Use createGeneral() when needing to add graphs with mixed characteristics, e.g. inference graphs, or specific graphs from TDB.

It does not support the graph indexing feature of jena-text.

This factory operation is marked "deprecated" because the general purpose "add named graph of any implementation" feature will be removed; this feature is now provided by createGeneral().

See Also:

createTxnMem()

create

public static Dataset create(Model model)

Create a dataset, starting with the model argument as the default graph of the dataset. Named graphs can be added.

Use wrap(Model) to put dataset functionality around a single model when named graphs will not be added.

Parameters:

model - The model for the default graph

Returns:

a dataset with the given model as the default graph

create

@Deprecated
public static Dataset create(Dataset dataset)

Deprecated. This operation may be removed.

Parameters:

dataset - Dataset to clone structure from.

Returns:

a dataset: clone the dataset structure of named graphs, and share the graphs themselves.

wrap

public static Dataset wrap(DatasetGraph dataset)

Wrap a DatasetGraph to make a dataset

Parameters:

dataset - DatasetGraph

Returns:

Dataset

wrap

public static Dataset wrap(Model model)

Wrap a Model to make a dataset; the model is the default graph of the RDF Dataset. This dataset can not have additional models added to it, including indirectly through SPARQL Update adding new graphs.

Parameters:

model -

Returns:

Dataset

create

@Deprecated
public static Dataset create(DatasetGraph dataset)

Deprecated. Use wrap(org.apache.jena.sparql.core.DatasetGraph)

Wrap a DatasetGraph to make a dataset

Parameters:

dataset - DatasetGraph

Returns:

Dataset

create

public static Dataset create(List<String> uriList)

Parameters:

uriList - URIs merged to form the default dataset

Returns:

a dataset based on a list of URIs : these are merged into the default graph of the dataset.

create

public static Dataset create(String uri)

Parameters:

uri - URIs merged to form the default dataset

Returns:

a dataset with a default graph and no named graphs

createNamed

public static Dataset createNamed(List<String> namedSourceList)

Parameters:

namedSourceList -

Returns:

a named graph container of graphs based on a list of URIs.

create

public static Dataset create(List<String> uriList,
                             List<String> namedSourceList)

Create a dataset based on two list of URIs. The first lists is used to create the background (unnamed graph) by merging, the second is used to create the collection of named graphs. (Jena calls graphs "Models" and triples "Statements")

Parameters:

uriList - graphs to be loaded into the unnamed, default graph

namedSourceList - graphs to be attached as named graphs

Returns:

Dataset

create

public static Dataset create(String uri,
                             List<String> namedSourceList)

Create a dataset container based on two list of URIs. The first is used to create the background (unnamed graph), the second is used to create the collection of named graphs. (Jena calls graphs "Models" and triples "Statements")

Parameters:

uri - graph to be loaded into the unnamed, default graph

namedSourceList - graphs to be attached as named graphs

Returns:

Dataset

create

public static Dataset create(String uri,
                             List<String> namedSourceList,
                             String baseURI)

Create a named graph container based on two list of URIs. The first is used to create the background (unnamed graph), the second is used to create the collection of named graphs. (Jena calls graphs "Models" and triples "Statements")

Parameters:

uri - graph to be loaded into the unnamed, default graph

namedSourceList - graphs to be attached as named graphs

baseURI - baseURI for relative URI expansion

Returns:

Dataset

create

public static Dataset create(List<String> uriList,
                             List<String> namedSourceList,
                             String baseURI)

Create a named graph container based on two list of URIs. The first is used to create the background (unnamed graph), the second is used to create the collection of named graphs. (Jena calls graphs "Models" and triples "Statements")

Parameters:

uriList - graphs to be loaded into the unnamed, default graph

namedSourceList - graphs to be attached as named graphs

baseURI - baseURI for relative URI expansion

Returns:

Dataset

assemble

public static Dataset assemble(String filename)

Assemble a dataset from the model in a file

Parameters:

filename - The filename

Returns:

Dataset

assemble

public static Dataset assemble(String filename,
                               String resourceURI)

Assemble a dataset from the model in a file

Parameters:

filename - The filename

resourceURI - URI for the dataset to assembler

Returns:

Dataset

assemble

public static Dataset assemble(Model model)

Assemble a dataset from the model

Parameters:

model -

Returns:

Dataset

assemble

public static Dataset assemble(Resource resource)

Assemble a dataset from a resource

Parameters:

resource - The resource for the dataset

Returns:

Dataset