sesamerepository.java

这是外国一个开源推理机

	 * write access on this repository.
	 * @exception UnsupportedOperationException If this repository does not
	 * support the specified action.
	 * @see RDFFormat
	 */
	public void addData(SesameRepository repository, AdminListener listener)
		throws IOException, AccessDeniedException;

	/**
	 * Adds RDF data from a Reader to the repository. <b>Note: uploading
	 * XML-encoded RDF using a Reader can destroy the character encoding
	 * of the data. Using an InputStream can prevent this.</b>
	 *
	 * @param data a Reader from which RDF data can be read.
	 * @param baseURI the base URI to resolve any relative URIs against.
	 * @param format the serialization format of the data (one of
	 * RDFFormat.RDFXML, RDFFormat.NTRIPLES).
	 * @param verifyData if set to 'true', the RDF parser will verify the
	 * data before adding it to the repository.
	 * @param listener an AdminListener that will receive error- and
	 * progress messages.
	 *
	 * @exception IOException In case an I/O error occurs.
	 * @exception AccessDeniedException In case the current user does not have
	 * write access on this repository.
	 * @exception UnsupportedOperationException If this repository does not
	 * support the specified action.
	 * @see RDFFormat
	 */
	public void addData(Reader data, String baseURI, RDFFormat format, boolean verifyData, AdminListener listener)
		throws IOException, AccessDeniedException;

	/**
	 * Adds RDF data from an InputStream to the repository.
	 *
	 * @param data an InputStream from which RDF data can be read.
	 * @param baseURI the base URI to resolve any relative URIs against.
	 * @param format the serialization format of the data (one of
	 * RDFFormat.RDFXML, RDFFormat.NTRIPLES).
	 * @param verifyData if set to 'true', the RDF parser will verify the
	 * data before adding it to the repository.
	 * @param listener an AdminListener that will receive error- and
	 * progress messages.
	 *
	 * @exception IOException In case an I/O error occurs.
	 * @exception AccessDeniedException In case the current user does not have
	 * write access on this repository.
	 * @exception UnsupportedOperationException If this repository does not
	 * support the specified action.
	 * @see RDFFormat
	 */
	public void addData(InputStream data, String baseURI, RDFFormat format, boolean verifyData, AdminListener listener)
		throws IOException, AccessDeniedException;

	
	/**
	 * Adds the contents of the supplied graph to the repository. Blank nodes
	 * in the supplied graph that originate from this repository are reused.
	 * 
	 * @param graph a Graph containing the RDF statements to be added. 
	 * 
	 * @throws IOException in case an I/O error occurs.
	 * @throws AccessDeniedException In case the current user does not have write access on 
	 * this repository.
	 * @exception UnsupportedOperationException If this repository does not support the 
	 * specified action.
	 * @see Graph
	 */
	public void addGraph(Graph graph) throws IOException, AccessDeniedException;
	
	/**
	 * Adds the contents of the supplied graph to the repository.
	 * 
	 * @param graph a Graph containing the RDF statements to be added.
	 * @param joinBlankNodes indicates adding behavior. If set to true, blank nodes
	 * in the supplied graph that originate from this repository are reused. If set to false,
	 * new blank nodes are created for each blank node in the supplied graph.
	 * 
	 * @throws IOException in case an I/O error occurs.
	 * @throws AccessDeniedException In case the current user does not have write access on 
	 * this repository.
	 * @exception UnsupportedOperationException If this repository does not support the 
	 * specified action.
	 * @see Graph
	 */
	public void addGraph(Graph graph, boolean joinBlankNodes) throws IOException, AccessDeniedException;
	
	
	/**
	 * Adds the contents of the graph specified by the supplied graph query to
	 * the repository. Blank nodes
	 * in the supplied graph that originate from this repository are reused.
	 * 
	 * @param language the query language in which the query is formulated.
	 * @param query the query. Note that the query must be of a form that has
	 * an RDF graph as its result (e.g. a SeRQL CONSTRUCT query)
	 * @throws IOException in case an I/O error occurs
	 * @throws AccessDeniedException in case the current user does not have write access on
	 * this repository.
	 * @throws MalformedQueryException In case the supplied query is incorrect.
	 * @throws QueryEvaluationException In case an error occurs during query evaluation.
	 */
	public void addGraph(QueryLanguage language, String query)
			throws IOException, AccessDeniedException;
	
	/**
	 * Adds the contents of the graph specified by the supplied graph query to
	 * the repository.
	 * 
	 * @param language the query language in which the query is formulated.
	 * @param query the query. Note that the query must be of a form that has
	 * an RDF graph as its result (e.g. a SeRQL CONSTRUCT query)
	 * @param joinBlankNodes indicates adding behavior. If set to true, blank nodes
	 * in the supplied graph that originate from this repository are reused. If set to false,
	 * new blank nodes are created for each blank node in the supplied graph.
	 * 
	 * @throws IOException in case an I/O error occurs
	 * @throws AccessDeniedException in case the current user does not have write access on
	 * this repository.
	 * @throws MalformedQueryException In case the supplied query is incorrect.
	 * @throws QueryEvaluationException In case an error occurs during query evaluation.
	 */
	public void addGraph(QueryLanguage language, String query, boolean joinBlankNodes)
			throws IOException, AccessDeniedException;
	
	/**
	 * Removes the contents of the supplied graph from the repository. All statements in 
	 * the graph are removed from the repository. Blank nodes in the supplied graph that 
	 * originate from this repository are reused.
	 * 
	 * @param graph a Graph containing RDF statements that are to be removed.
	 * 
	 * @throws IOException in case an I/O error occurs. 
	 * @throws AccessDeniedException In case the current user does not have write access on
	 * this repository.
	 * @exception UnsupportedOperationException If this repository does not support the 
	 * specified action.
	 * @see Graph
	 */
	public void removeGraph(Graph graph) throws IOException, AccessDeniedException;
	
	/**
	 * Removes the contents of the graph specified by the supplied graph query from
	 * the repository. Blank nodes in the supplied graph that originate from this 
	 * repository are reused.
	 * 
	 * @param language the query language in which the query is formulated.
	 * @param query the query. Note that the query must be of a form that has
	 * an RDF graph as its result (e.g. a SeRQL CONSTRUCT query)
	 * @throws IOException in case an I/O error occurs
	 * @throws AccessDeniedException in case the current user does not have write access on
	 * this repository.
	 */
	public void removeGraph(QueryLanguage language, String query)
			throws IOException, AccessDeniedException;
	
	/**
	 * Extracts data from the repository and returns it in the requested
	 * format. You can either extract the ontological data, the instance
	 * data, or both. For any of these, you can specify whether you want
	 * to extract all statements, or only the ones that were explicitly
	 * added.
	 *
	 * @param format The serialization format that should be used (one of
	 * RDFFormat.RDFXML, RDFFormat.NTRIPLES, RDFFormat.N3).
	 * @param ontology If true, the ontological part of the data will be
	 * extracted.
	 * @param instances If true, the instances part of the data will be
	 * extracted.
	 * @param explicitOnly If true, only explicitely added statements will
	 * be extracted, i.e. the inferred statements will be skipped.
	 * @param niceOutput If true, the server will try its best to make the
	 * data as much readable for humans as possible. Note that this will
	 * cost extra processing time, and it should be set to 'false' if not
	 * necessary.
	 *
	 * @exception IOException In case an I/O error occurs.
	 * @exception AccessDeniedException In case the current user does not have
	 * read access on this repository.
	 * @exception UnsupportedOperationException If this repository does not
	 * support the specified action.
	 * @see RDFFormat
	 **/
	public InputStream extractRDF(
		RDFFormat format, boolean ontology, boolean instances, boolean explicitOnly, boolean niceOutput)
		throws IOException, AccessDeniedException;


	/**
	 * Removes statements from the repository. Statements that match the pattern
	 * specified by the parameters <tt>subject</tt>, <tt>predicate</tt> and
	 * <tt>object</tt> will be removed from the repository. <tt>null</tt> values
	 * for these parameters indicate wildcards. So calling
	 * <tt>removeStatements(mySubject, null, null, l)</tt> will remove all
	 * statements with a subject equal to <tt>mySubject</tt>.
	 *
	 * @param subject The subject of the statements that should be removed, or
	 * <tt>null</tt> if the subject is allowed to be anything.
	 * @param predicate The predicate of the statements that should be removed, or
	 * <tt>null</tt> if the predicate is allowed to be anything.
	 * @param object The object of the statements that should be removed, or
	 * <tt>null</tt> if the object is allowed to be anything.
	 * @param listener An AdminListener that will receive error- and progress
	 * messages.
	 * @exception IOException In case an I/O error occurs.
	 * @exception AccessDeniedException In case the current user does not have
	 * write access on this repository.
	 * @exception UnsupportedOperationException If this repository does not
	 * support the specified action.
	 */
	public void removeStatements(Resource subject, URI predicate, Value object, AdminListener listener)
		throws IOException, AccessDeniedException;

	/**
	 * Clears the repository. All statements will be removed.
	 *
	 * @param listener An AdminListener that will receive error- and
	 * progress messages.
	 *
	 * @exception IOException In case an I/O error occurs.
	 * @exception AccessDeniedException In case the current user does not have
	 * write access on this repository.
	 * @exception UnsupportedOperationException If this repository does not
	 * support the specified action.
	 */
	public void clear(AdminListener listener)
		throws IOException, AccessDeniedException;
	
	
	/**
	 * retrieves the repository id string for this repository.
	 * 
	 * @return the id of the repository.
	 */
	public String getRepositoryId();
}