Class Hierarchy Index
java.lang.Object | +----COM.cloudscape.core.ChannelSystem
Boot mechanism for starting up a Cloudscape system inside a Marimba Castanet channel. Cloudscape systems that run in Castanet channels must use this mechanism to boot.
When running inside a Castanet channel, databases can be located in either the channel directory or the data directory. A given system (and therefore a given channel) can have one or the other, but not both. The location of the databases is specified by the boot method of this class.
If the system is booted without specifying databasesInChannel or if databasesInChannel=true in the boot method's parameters, then all databases are relative to the channel root. That is, the complete database name is the channel root path plus the database name given on the connection URL. Databases located in the channel are read-only (since all files in the channel are read-only).
If the system is booted with databasesInChannel=false, then the default location of databases follows the usual rules, and databases can be written to as well as read. Databases will be located relative to cloudscape.system.home or the current working directory if cloudscape.system.home is not set. Since the current working directory is not likely to be anywhere useful in the Castanet environment, it is advisable to use absolute path names. For example, the following code gives a database URL that connects to a database named "db" in the channel's data directory:
In either case, the cloudscape.properties file is relative to the channel root.
Cloudscape reserves the right to change, rename, or remove this interface at any time.
public ChannelSystem()
public static Driver boot(IApplicationContext context) throws SQLException
The default properties are:
public static Driver boot(IApplicationContext context, boolean databasesInChannel) throws SQLException
public static void shutdownSystem()
Class Hierarchy Index