i3.dragos.core
Class Kernel

java.lang.Object
  i3.dragos.core.Kernel

public final class Kernel
extends java.lang.Object

The DRAGOS kernel is the component that holds everything together.

The kernel consists of a couple of kernel modules and light-weight tasks. Tasks are used for jobs which must be executed at specific intervals (like garbage collection). Kernel modules are used to make up different components of the database like event handling or transaction managment.

Author:

Boris Boehlen <boehlen@cs.rwth-aachen.de>, Thorsten Hermes <thermes@i3.informatik.rwth-aachen.de>

Method Summary

static Kernel	getInstance() Returns the one and only instance of the DRAGOS Kernel.
java.lang.String	getName() Gets the kernel's name.
TaskScheduler	getScheduler() Returns the task scheduler.
void	setName(java.lang.String name) Sets the kernel's name; may only be called once (by ConfigurationLoader during initialization).
static void	startup() Starts the kernel and configures it using the configuration file stored in the standard location.
static void	startup(java.io.File configFile) Starts the kernel and configures it using the specified configuration file.
static void	startup(java.lang.String configFile) Deprecated. Use startup(File) to pass a file locator as configuration.
static void	startup(java.net.URL config) Starts the kernel and configures it using the specified configuration file.

Methods inherited from class java.lang.Object

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

Method Detail

startup

public static void startup()

Starts the kernel and configures it using the configuration file stored in the standard location.

startup

public static void startup(java.io.File configFile)

Starts the kernel and configures it using the specified configuration file.

Parameters:

configFile - The configuration file for the kernel.

startup

public static void startup(java.net.URL config)

Starts the kernel and configures it using the specified configuration file.

Parameters:

config - The configuration file for the kernel.

startup

@Deprecated
public static void startup(java.lang.String configFile)

Deprecated. Use startup(File) to pass a file locator as configuration.

Starts the kernel and configures it using the specified configuration file.

Parameters:

configFile - The configuration file for the kernel.

getScheduler

public TaskScheduler getScheduler()

Returns the task scheduler.

Returns:

the task scheduler.

getInstance

public static Kernel getInstance()

Returns the one and only instance of the DRAGOS Kernel. If null is returned the kernel must be started by using the method startup.

Returns:

The one and only instance of the DRAGOS Kernel.

getName

public java.lang.String getName()

Gets the kernel's name.

Returns:

the kernel's name (null if not set yet).

setName

public void setName(java.lang.String name)
             throws DragosException

Sets the kernel's name; may only be called once (by ConfigurationLoader during initialization).

Parameters:

name - the kernel's name (must not be null and must not contain any of the following characters:

:/&?

).

Throws:

DragosException - if the parameter is null or a name was already set.