com.db4o.ext

Interface ExtObjectServer

All Superinterfaces:

ObjectServer

public interface ExtObjectServer
extends ObjectServer

extended functionality for the ObjectServer interface.

Every ObjectServer also always is an ExtObjectServer so a cast is possible.

ObjectServer.ext() is a convenient method to perform the cast.

The functionality is split to two interfaces to allow newcomers to focus on the essential methods.

Method Summary

Methods

Modifier and Type	Method and Description
void	backup(java.lang.String path) backs up the database file used by the ObjectServer.
int	clientCount() returns the number of connected clients.
Configuration	configure() returns the Configuration context for this ObjectServer.
ObjectContainer	objectContainer() returns the ObjectContainer used by the server.
int	port()
void	revokeAccess(java.lang.String userName) removes client access permissions for the specified user.

Methods inherited from interface com.db4o.ObjectServer

close, ext, grantAccess, openClient

Method Detail

backup

void backup(java.lang.String path)
            throws java.io.IOException

backs up the database file used by the ObjectServer.

While the backup is running, the ObjectServer can continue to be used. Changes that are made while the backup is in progress, will be applied to the open ObjectServer and to the backup.

While the backup is running, the ObjectContainer should not be closed.

If a file already exists at the specified path, it will be overwritten.

Parameters:

path - a fully qualified path

Throws:

java.io.IOException

clientCount

int clientCount()

returns the number of connected clients.

configure

Configuration configure()

returns the Configuration context for this ObjectServer.

Upon opening an ObjectServer with any of the factory methods in the Db4o class, the global Configuration context is copied into the ObjectServer. The Configuration can be modified individually for each ObjectServer without any effects on the global settings.

Returns:

the Configuration context for this ObjectServer

See Also:

Db4o.configure()

objectContainer

ObjectContainer objectContainer()

returns the ObjectContainer used by the server.

Returns:

the ObjectContainer used by the server

revokeAccess

void revokeAccess(java.lang.String userName)

removes client access permissions for the specified user.

Parameters:

userName - the name of the user

port

int port()

Returns:

The local port this server uses, 0 if disconnected or in embedded mode