/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.hp.hpl.jena.query;
import java.util.List ;
import com.hp.hpl.jena.assembler.Assembler ;
import com.hp.hpl.jena.rdf.model.Model ;
import com.hp.hpl.jena.rdf.model.Resource ;
import com.hp.hpl.jena.sparql.ARQException ;
import com.hp.hpl.jena.sparql.core.DatasetGraph ;
import com.hp.hpl.jena.sparql.core.DatasetGraphFactory ;
import com.hp.hpl.jena.sparql.core.DatasetImpl ;
import com.hp.hpl.jena.sparql.core.assembler.DatasetAssembler ;
import com.hp.hpl.jena.sparql.util.DatasetUtils ;
import com.hp.hpl.jena.sparql.util.graph.GraphUtils ;
import com.hp.hpl.jena.util.FileManager ;
/** Make Datasets and DataSources in various ways */
public class DatasetFactory
{
/** Create an in-memory, modifiable Dataset */
public static Dataset createMem() { return create(DatasetGraphFactory.createMem()) ; }
/** Create an in-memory, modifiable Dataset.
* New graphs must be explicitly added using .addGraph.
*/
public static Dataset createMemFixed() { return create(DatasetGraphFactory.createMemFixed()) ; }
/** Create an in-memory, modifyable Dataset
* @deprecated Use createMem
*/
@Deprecated
public static Dataset create() { return createMem() ; }
/** Create a dataset with the given model as the default graph
* @param model The model for the default graph
* @return Dataset
*/
public static Dataset create(Model model)
{ return new DatasetImpl(model) ; }
/** Create a dataset: clone the dataset structure of named graohs, and share the graphs themselves.
* @param dataset Dataset to clone structure from.
* @return Dataset
*/
public static Dataset create(Dataset dataset)
{ return new DatasetImpl(dataset) ; }
/** Wrap a datasetgraph to make a mutable dataset
* @param dataset DatasetGraph
* @return Dataset
*/
public static Dataset create(DatasetGraph dataset)
{ return DatasetImpl.wrap(dataset) ; }
/** Create a dataset based on a list of URIs : these are merged into the default graph of the dataset.
*
* @param uriList URIs merged to form the default dataset
* @return Dataset
*/
public static Dataset create(List<String> uriList)
{ return create(uriList, null, null, null) ; }
/** Create a dataset with a default graph and no named graphs
*
* @param uri URIs merged to form the default dataset
* @return Dataset
*/
public static Dataset create(String uri)
{ return create(uri, null, null, null) ; }
/** Create a dataset based on a list of URIs : these are merged into the default graph of the dataset.
*
* @param uriList URIs merged to form the default dataset
* @param fileManager
* @return Dataset
*/
public static Dataset create(List<String> uriList, FileManager fileManager)
{ return create(uriList, null, fileManager, null) ; }
/** Create a dataset based on a list of URIs : these are merged into the default graph of the dataset.
*
* @param uri graph to be loaded into the unnamed, default graph
* @param fileManager
* @return Dataset
*/
public static Dataset create(String uri, FileManager fileManager)
{ return create(uri, null, fileManager, null) ; }
/** Create a named graph container of graphs based on a list of URIs.
*
* @param namedSourceList
* @param fileManager
* @return Dataset
*/
public static Dataset createNamed(List<String> namedSourceList, FileManager fileManager)
{ return create((List<String>)null, namedSourceList, fileManager, null) ; }
/** 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")
*
* @param uriList graphs to be loaded into the unnamed, default graph
* @param namedSourceList graphs to be atatched as named graphs
* @return Dataset
*/
public static Dataset create(List<String> uriList, List<String> namedSourceList)
{
return create(uriList, namedSourceList, null, null) ;
}
/** 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")
*
* @param uri graph to be loaded into the unnamed, default graph
* @param namedSourceList graphs to be attached as named graphs
* @return Dataset
*/
public static Dataset create(String uri, List<String> namedSourceList)
{
return create(uri, namedSourceList, null, null) ;
}
/** 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")
*
* @param uri graph to be loaded into the unnamed, default graph
* @param namedSourceList graphs to be atatched as named graphs
* @param fileManager
* @param baseURI baseURI for relative URI expansion
* @return Dataset
*/
public static Dataset create(String uri, List<String> namedSourceList,
FileManager fileManager, String baseURI)
{
return DatasetUtils.createDataset(uri, namedSourceList, 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")
*
* @param uriList graphs to be loaded into the unnamed, default graph
* @param namedSourceList graphs to be atatched as named graphs
* @param fileManager
* @param baseURI baseURI for relative URI expansion
* @return Dataset
* @deprecated FileManager argument has no effect
*/
@Deprecated
public static Dataset create(List<String> uriList, List<String> namedSourceList,
FileManager fileManager, String baseURI)
{
return DatasetUtils.createDataset(uriList, namedSourceList, baseURI) ;
}
// public static Dataset make(Dataset ds)
// {
// DataSourceImpl ds2 = new DataSourceImpl(ds) ;
// return ds2 ;
// }
// public static Dataset make(Dataset ds, Graph defaultGraph)
// {
// DataSourceImpl ds2 = new DataSourceImpl(ds) ;
// ds2.setDefaultGraph(defaultGraph) ;
// return ds2 ;
// }
public static Dataset make(Dataset ds, Model defaultModel)
{
Dataset ds2 = new DatasetImpl(ds) ;
ds2.setDefaultModel(defaultModel) ;
return ds2 ;
}
// Assembler.
/** Assembler a dataset from the model in a file
*
* @param filename The filename
* @return Dataset
*/
public static Dataset assemble(String filename)
{
Model model = FileManager.get().loadModel(filename) ;
return assemble(model) ;
}
/** Assembler a dataset from the model in a file
*
* @param filename The filename
* @param resourceURI URI for the dataset to assembler
* @return Dataset
*/
public static Dataset assemble(String filename, String resourceURI)
{
Model model = FileManager.get().loadModel(filename) ;
Resource r = model.createResource(resourceURI) ;
return assemble(r) ;
}
/** Assembler a dataset from the model
*
* @param model
* @return Dataset
*/
public static Dataset assemble(Model model)
{
Resource r = GraphUtils.findRootByType(model, DatasetAssembler.getType()) ;
if ( r == null )
throw new ARQException("No root found for type <"+DatasetAssembler.getType()+">") ;
return assemble(r) ;
}
/** Assembler a dataset from a resource
*
* @param resource The resource for the dataset
* @return Dataset
*/
public static Dataset assemble(Resource resource)
{
Dataset ds = (Dataset)Assembler.general.open(resource) ;
return ds ;
}
}