com.franz.agraph.repository
Class AGCatalog

java.lang.Object
  com.franz.agraph.repository.AGCatalog

public class AGCatalog
extends Object

Catalogs are locations on disk where AllegroGraph Server keeps its repositories.

Catalogs are created by the catalog server configuration.

A catalog is a grouping of repositories. The root catalog is the default, unnamed catalog that is available with every server. It is also possible to create any number of named catalogs.

See Also:

AGServer.getCatalog(String)

Field Summary

static int	NAMED_CATALOG
static int	ROOT_CATALOG

Constructor Summary

AGCatalog(AGServer server, int catalogType)
Creates an AGCatalog instance for a special catalog in the given server, such as the root catalog.

AGCatalog(AGServer server, String catalogName)
Creates an AGCatalog instance for a named catalog having catalogName in the given server.

Method Summary

AGRepository	createRepository(String repositoryID) Returns an uninitialized AGRepository instance for the given repository id.
AGRepository	createRepository(String repositoryID, boolean strict) Returns an uninitialized AGRepository instance for the given repository id.
void	deleteRepository(String repositoryID) Deletes the repository with the given repository id.
String	getCatalogName() The name of this catalog.
int	getCatalogType() The type of this catalog.
String	getCatalogURL() URL of this catalog.
com.franz.agraph.http.AGHTTPClient	getHTTPClient()
String	getRepositoriesURL() URL for accessing the repositories of this catalog.
String	getRepositoryURL(String repositoryID)
AGServer	getServer() The AGServer instance for this catalog.
boolean	hasRepository(String repoId) Returns true if the repository id is contained in this catalog.
static boolean	isRootID(String catalogID) Returns true iff the id identifies the root catalog.
List<String>	listRepositories() Returns a List of repository ids contained in this catalog.
AGRepository	openRepository(String repositoryID) Returns an uninitialized AGRepository instance for the given repository id.

Methods inherited from class java.lang.Object

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

Field Detail

ROOT_CATALOG

public static final int ROOT_CATALOG

See Also:

getCatalogType(), Constant Field Values

NAMED_CATALOG

public static final int NAMED_CATALOG

See Also:

getCatalogType(), Constant Field Values

Constructor Detail

AGCatalog

public AGCatalog(AGServer server,
                 String catalogName)

Creates an AGCatalog instance for a named catalog having catalogName in the given server.

Parameters:

server - the server housing this named catalog.

catalogName - the name for this named catalog.

See Also:

AGServer.getCatalog(String)

AGCatalog

public AGCatalog(AGServer server,
                 int catalogType)

Creates an AGCatalog instance for a special catalog in the given server, such as the root catalog.

Parameters:

server - the server housing the catalog.

catalogType - the type of the special catalog.

See Also:

AGServer.getCatalog()

Method Detail

getServer

public AGServer getServer()

The AGServer instance for this catalog.

Returns:

the AGServer instance for this catalog.

getCatalogName

public String getCatalogName()

The name of this catalog. The root catalog has the name "/".

Returns:

the name of this catalog.

getCatalogType

public int getCatalogType()

The type of this catalog.

Returns:

the type of this catalog, ROOT_CATALOG or NAMED_CATALOG

getCatalogURL

public String getCatalogURL()

URL of this catalog.

Returns:

the URL of this catalog.

getRepositoriesURL

public String getRepositoriesURL()

URL for accessing the repositories of this catalog.

Returns:

the URL for accessing the repositories of this catalog.

getRepositoryURL

public String getRepositoryURL(String repositoryID)

getHTTPClient

public com.franz.agraph.http.AGHTTPClient getHTTPClient()

listRepositories

public List<String> listRepositories()
                              throws OpenRDFException

Returns a List of repository ids contained in this catalog.

Returns:

a List of repository ids contained in this catalog.

Throws:

OpenRDFException

hasRepository

public boolean hasRepository(String repoId)
                      throws OpenRDFException

Returns true if the repository id is contained in this catalog.

Returns:

true if the repository id is contained in this catalog.

Throws:

OpenRDFException

createRepository

public AGRepository createRepository(String repositoryID)
                              throws RepositoryException

Returns an uninitialized AGRepository instance for the given repository id. The repository is created if it does not exist. If the repository already exists, it is simply opened.

Parameters:

repositoryID - the id (the name) of the repository.

Returns:

an uninitialized AGRepository instance.

Throws:

RepositoryException

See Also:

createRepository(String, boolean)

createRepository

public AGRepository createRepository(String repositoryID,
                                     boolean strict)
                              throws RepositoryException

Returns an uninitialized AGRepository instance for the given repository id. The repository is created if it does not exist. If the repository already exists, it is simply opened, or an exception is thrown if strict=true.

Parameters:

repositoryID - the id (the name) of the repository

strict - if true and the repository already exists, throw an exception

Returns:

an uninitialized AGRepository instance.

Throws:

RepositoryException

See Also:

createRepository(String), listRepositories(), openRepository(String)

openRepository

public AGRepository openRepository(String repositoryID)
                            throws RepositoryException

Returns an uninitialized AGRepository instance for the given repository id. If the repository already exists, it is simply opened.

Parameters:

repositoryID - the id (the name) of the repository.

Returns:

an uninitialized AGRepository instance.

Throws:

RepositoryException - if the repositoryID does not exist

See Also:

createRepository(String, boolean)

deleteRepository

public void deleteRepository(String repositoryID)
                      throws RepositoryException

Deletes the repository with the given repository id.

Parameters:

repositoryID - the name of the repository to delete.

Throws:

RepositoryException

See Also:

listRepositories()

isRootID

public static boolean isRootID(String catalogID)

Returns true iff the id identifies the root catalog. Currently null, the empty string, and "/" are all considered to identify the root catalog.

Returns:

true iff the id identifies the root catalog.