jade.core
Class ProfileImpl

java.lang.Object
  |
  +--jade.core.Profile
        |
        +--jade.core.ProfileImpl

public class ProfileImpl

extends Profile

This class allows the JADE core to retrieve configuration-dependent classes and boot parameters.

Take care of using different instances of this class when launching different containers/main-containers on the same JVM otherwise they would conflict!

Version:

1.0, 22/11/00

Author:

Federico Bergenti, Giovanni Rimassa - Universita' di Parma, Giovanni Caire - TILAB

Field Summary

Fields inherited from class jade.core.Profile

ACLCODECS, AGENTS, CONTAINER_NAME, FILE_DIR, IMTP, LOCAL_HOST, LOCAL_PORT, LOCAL_SERVICE_MANAGER, MAIN, MAIN_HOST, MAIN_PORT, MAIN_PROTO, MTPS, PERSISTENT_DELIVERY_BASEDIR, PERSISTENT_DELIVERY_FILTER, PERSISTENT_DELIVERY_SENDFAILUREPERIOD, PERSISTENT_DELIVERY_STORAGEMETHOD, PLATFORM_ID, REMOTE_SERVICE_MANAGER_ADDRESSES, SERVICES

Constructor Summary

ProfileImpl()
Creates a Profile implementation with the default configuration for launching a main-container on the localhost, RMI internal Message Transport Protocol, port number 1099, iiop MTP.

ProfileImpl(Properties aProp)
Creates a Profile implementation using the given properties to configure the platform startup process.

ProfileImpl(java.lang.String fileName)
Create a Profile object initialized with the settings specified in a given property file

ProfileImpl(java.lang.String host, int port, java.lang.String platformID)
This constructor creates a default Profile for launching a platform.

Method Summary

boolean	getParameter(java.lang.String key, boolean aDefault) Retrieve a boolean value for a configuration property.
java.lang.String	getParameter(java.lang.String key, java.lang.String aDefault) Retrieve a String value from the configuration properties.
Properties	getProperties() Return the underlying properties collection.
List	getSpecifiers(java.lang.String key) Retrieve a list of Specifiers from the configuration properties.
void	setParameter(java.lang.String key, java.lang.String value) Assign the given value to the given property name.
void	setSpecifiers(java.lang.String key, List value) Assign the given property value to the given property name
java.lang.String	toString() Creates a string representation of this profile.

Methods inherited from class java.lang.Object

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

Constructor Detail

ProfileImpl

public ProfileImpl(Properties aProp)

Creates a Profile implementation using the given properties to configure the platform startup process.

Parameters:

aProp - The names and values of the configuration properties to use.

ProfileImpl

public ProfileImpl()

Creates a Profile implementation with the default configuration for launching a main-container on the localhost, RMI internal Message Transport Protocol, port number 1099, iiop MTP.

ProfileImpl

public ProfileImpl(java.lang.String fileName)
            throws ProfileException

Create a Profile object initialized with the settings specified in a given property file

ProfileImpl

public ProfileImpl(java.lang.String host,
                   int port,
                   java.lang.String platformID)

This constructor creates a default Profile for launching a platform.

Parameters:

host - is the name of the host where the main-container should be listen to. A null value means use the default (i.e. localhost)

port - is the port number where the main-container should be listen for other containers. A negative value should be used for using the default port number.

platformID - is the synbolic name of the platform, if different from default. A null value means use the default (i.e. localhost)

Method Detail

getProperties

public Properties getProperties()

Return the underlying properties collection.

Returns:

Properties The properties collection.

setParameter

public void setParameter(java.lang.String key,
                         java.lang.String value)

Assign the given value to the given property name.

Specified by:

setParameter in class Profile

Parameters:

key - is the property name

value - is the property value

setSpecifiers

public void setSpecifiers(java.lang.String key,
                          List value)

Assign the given property value to the given property name

Specified by:

setSpecifiers in class Profile

Parameters:

key - is the property name

value - is the property value

getParameter

public java.lang.String getParameter(java.lang.String key,
                                     java.lang.String aDefault)

Retrieve a String value from the configuration properties. If no parameter corresponding to the specified key is found, aDefault is returned.

Specified by:

getParameter in class Profile

Parameters:

key - The key identifying the parameter to be retrieved among the configuration properties.

aDefault - The value that is returned if the specified key is not found

getParameter

public boolean getParameter(java.lang.String key,
                            boolean aDefault)

Retrieve a boolean value for a configuration property. If no corresponding property is found or if its string value cannot be converted to a boolean one, a default value is returned.

Specified by:

getParameter in class Profile

Parameters:

key - The key identifying the parameter to be retrieved among the configuration properties.

aDefault - The value to return when there is no property set for the given key, or its value cannot be converted to a boolean value.

getSpecifiers

public List getSpecifiers(java.lang.String key)
                   throws ProfileException

Retrieve a list of Specifiers from the configuration properties. Agents, MTPs and other items are specified among the configuration properties in this way. If no list of Specifiers corresponding to the specified key is found, an empty list is returned.

Specified by:

getSpecifiers in class Profile

Parameters:

key - The key identifying the list of Specifires to be retrieved among the configuration properties.

ProfileException

toString

public java.lang.String toString()

Creates a string representation of this profile. The returned string has the format

(profile name1=value1 name2=value2 ... )

Overrides:

toString in class java.lang.Object

Returns:

A string containing a readable representation of this profile object.