org.openrdf.sesame.repository
Interface SesameService

All Known Implementing Classes:

HTTPService, LocalService, ServicesInterfaceImpl

public interface SesameService

The main interface for all Sesame services. A Sesame service administers a number of Sesame repositories and allows you to get an overview of all available repositories and to retrieve objects representing specific repositories.

Version:

$Revision: 1.7.4.2 $

Author:

Jeen Broekstra, Arjohn Kampman

Method Summary

SesameRepository	getRepository(String repositoryID) Gets a SesameRepository object for the specified repository ID.
RepositoryList	getRepositoryList() Gets a list of all repositories that are accessible by the currently logged in user.
void	login(String username, String password) Log in to a Sesame service.
void	logout() Log out from a Sesame service.

Method Detail

getRepositoryList

public RepositoryList getRepositoryList()
                                 throws IOException

Gets a list of all repositories that are accessible by the currently logged in user. If no user is logged in, all repositories that are world-accessible are retrieved.

Returns:

A RepositoryListImpl

Throws:

IOException - If an I/O error occurred while fetching information about the available repositories.

getRepository

public SesameRepository getRepository(String repositoryID)
                               throws UnknownRepositoryException,
                                      ConfigurationException,
                                      IOException

Gets a SesameRepository object for the specified repository ID.

Parameters:

repositoryID - A repository ID.

Throws:

UnknownRepositoryException - If the specified repository ID is unknown.

ConfigurationException - If the requested repository was not configured properly.

IOException

login

public void login(String username,
                  String password)
           throws AccessDeniedException,
                  IOException

Log in to a Sesame service.

Throws:

AccessDeniedException - If the attempt to log in failed.

IOException - If an I/O error occurred.

IllegalArgumentException - If the supplied username is not a legal username.

logout

public void logout()
            throws IOException

Log out from a Sesame service.

Throws:

IOException - If an I/O error occurred.