diff -r 000000000000 -r 6474c204b198 rdf/base/idl/nsIRDFCompositeDataSource.idl --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/rdf/base/idl/nsIRDFCompositeDataSource.idl Wed Dec 31 06:09:35 2014 +0100 @@ -0,0 +1,68 @@ +/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ +/* This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ + +#include "nsIRDFDataSource.idl" + +interface nsISimpleEnumerator; + +/** + * An nsIRDFCompositeDataSource composes individual data sources, providing + * the illusion of a single, coherent RDF graph. + */ +[scriptable, uuid(96343820-307C-11D2-BC15-00805F912FE7)] +interface nsIRDFCompositeDataSource : nsIRDFDataSource { + + /** + * + * Set this value to true if the composite datasource + * may contains at least one datasource that has negative + * assertions. (This is the default.) + * + * Set this value to false if none of the datasources + * being composed contains a negative assertion. This allows the + * composite datasource to perform some query optimizations. + * + * By default, this value is true. + */ + attribute boolean allowNegativeAssertions; + + /** + * Set to true if the composite datasource should + * take care to coalesce duplicate arcs when returning values from + * queries. (This is the default.) + * + * Set to false if the composite datasource shouldn't + * bother to check for duplicates. This allows the composite + * datasource to more efficiently answer queries. + * + * By default, this value is true. + */ + attribute boolean coalesceDuplicateArcs; + + /** + * Add a datasource the the composite data source. + * @param aDataSource the datasource to add to composite + */ + void AddDataSource(in nsIRDFDataSource aDataSource); + + /** + * Remove a datasource from the composite data source. + * @param aDataSource the datasource to remove from the composite + */ + void RemoveDataSource(in nsIRDFDataSource aDataSource); + + /** + * Retrieve the datasources in the composite data source. + * @return an nsISimpleEnumerator that will enumerate each + * of the datasources in the composite + */ + nsISimpleEnumerator GetDataSources(); +}; + +%{C++ +extern nsresult +NS_NewRDFCompositeDataSource(nsIRDFCompositeDataSource** result); +%} +