## org.openorb.CORBA.kernel
Interface ORBLoader

All Known Implementing Classes:
  DefaultLoader, OpenORBLoader

public interface ORBLoader

This interface describes what are the operations to implement in order to provide an ORB loader.

Version:
  $Revision: 1.11 $ $Date: 2002/07/15 14:53:41 $
Author:
  Jerome Daniel

Method Summary
`java.lang.reflect.Constructor` `classConstructor(java.lang.String prop_key, java.lang.String defl, java.lang.Class[] args_t)`
`java.lang.Object` `constructClass(java.lang.String prop_key, java.lang.String defl, java.lang.Object[] args)` This operation is used to load a class with the given property name and default class name.
`java.lang.Object` `constructClass(java.lang.String prop_key, java.lang.String defl, java.lang.Object[] args, java.lang.Class[] args_t)` This operation is used to load a class with the given property name and default class name.
`void` `display_configuration()` This operation is used to display an OpenORB configuration.
`boolean` `getBooleanProperty(java.lang.String name)` Get the boolean property with the given name.
`boolean` `getBooleanProperty(java.lang.String name, boolean defl)` Get the boolean property with the given name.
`java.lang.Class` `getClassProperty(java.lang.String name)` Get the integer property with the given name.
`java.lang.Class` `getClassProperty(java.lang.String name, java.lang.Class defl)` Get the Class object property with the given name.
`java.lang.Class` `getClassProperty(java.lang.String name, java.lang.String defl)` Get the Class object property with the given name.
`int` `getIntProperty(java.lang.String name)` Get the integer property with the given name.
`int` `getIntProperty(java.lang.String name, int defl)` Get the integer property with the given name.
`Property` `getProperty(java.lang.String name)` Get the Property object with the given name.
`java.lang.String` `getStringProperty(java.lang.String name)` Get the string property with the given name.
`java.lang.String` `getStringProperty(java.lang.String name, java.lang.String defl)` Get the string property with the given name.
`java.net.URL` `getURLProperty(java.lang.String name)` Get the URL property with the given name.
`java.net.URL` `getURLProperty(java.lang.String name, java.net.URL defl)` Get the URL property with the given name.
`void` `init(java.lang.String[] args, java.util.Properties properties, ORB orb)` This operation is called on the ORB to initialize it.
`java.util.Iterator` `properties(java.lang.String name)` Iterate over property values with the specified prefix.

Method Detail

### init

    public void init(java.lang.String[] args,
                     java.util.Properties properties,
                     ORB orb)

  This operation is called on the ORB to initialize it. This operation can be called only once.

### display_configuration

    public void display_configuration()

  This operation is used to display an OpenORB configuration.

### properties

    public java.util.Iterator properties(java.lang.String name)

  Iterate over property values with the specified prefix.

  Parameters:
    `name` - parent of properties. Properies of the form name + "." + xxx are returned, where xxx can be anything. May be null to iterate over all properies.
  Returns:
    unmodifiable iterator over the name's decendants. This iterator returns objects of type Property.

### getProperty

    public Property getProperty(java.lang.String name)

  Get the Property object with the given name.
  Parameters:
    `name` - the property name.

### getStringProperty

    public java.lang.String getStringProperty(java.lang.String name,
                                              java.lang.String defl)

  Get the string property with the given name.
  Parameters:
    `name` - the property name.
    `defl` - default value to use if property not found.

### getStringProperty

    public java.lang.String getStringProperty(java.lang.String name)
                                       throws PropertyNotFoundException

  Get the string property with the given name.
  Parameters:
    `name` - the property name.
  Throws:
    `PropertyNotFoundException` - the property cannot be found.

### getIntProperty

    public int getIntProperty(java.lang.String name,
                              int defl)

  Get the integer property with the given name.
  Parameters:
    `name` - the property name.
    `defl` - default value to use if property not found.
  Throws:
    `INITIALIZE` - The property value is not parsable to an int.

### getIntProperty

    public int getIntProperty(java.lang.String name)
                       throws PropertyNotFoundException

  Get the integer property with the given name.
  Parameters:
    `name` - the property name.
  Throws:
    `PropertyNotFoundException` - the property cannot be found.
    `INITIALIZE` - The property value is not parsable to an int.

### getBooleanProperty

    public boolean getBooleanProperty(java.lang.String name,
                                      boolean defl)

  Get the boolean property with the given name.
  Parameters:
    `name` - the property name.
    `defl` - default value to use if property not found.
  Throws:
    `java.lang.ClassCastException` - The property value is not parsable to a boolean.

### getBooleanProperty

    public boolean getBooleanProperty(java.lang.String name)
                               throws PropertyNotFoundException

  Get the boolean property with the given name.
  Parameters:
    `name` - the property name.
  Throws:
    `PropertyNotFoundException` - the property cannot be found.
    `java.lang.ClassCastException` - The property value is not parsable to a boolean.

### getURLProperty

    public java.net.URL getURLProperty(java.lang.String name,
                                       java.net.URL defl)

  Get the URL property with the given name.
  Parameters:
    `name` - the property name.
    `defl` - default value to use if property not found.
  Throws:
    `java.lang.ClassCastException` - The property value is not parsable to a URL.

### getURLProperty

    public java.net.URL getURLProperty(java.lang.String name)
                                throws PropertyNotFoundException

  Get the URL property with the given name.
  Parameters:
    `name` - the property name.
  Throws:
    `PropertyNotFoundException` - the property cannot be found.
    `java.lang.ClassCastException` - The property value is not parsable to a URL.

### getClassProperty

    public java.lang.Class getClassProperty(java.lang.String name,
                                            java.lang.Class defl)

  Get the Class object property with the given name.
  Parameters:
    `name` - the property name.
    `defl` - default value to use if property not found.
  Throws:
    `INITIALIZE` - the property value cannot be loaded as a class.

### getClassProperty

    public java.lang.Class getClassProperty(java.lang.String name,
                                            java.lang.String defl)

  Get the Class object property with the given name.
  Parameters:
    `name` - the property name.
    `defl` - String name of default value to use if property not found.
  Throws:
    `INITIALIZE` - the property value or default class cannot be loaded as a class.

### getClassProperty

    public java.lang.Class getClassProperty(java.lang.String name)
                                     throws PropertyNotFoundException

  Get the integer property with the given name.
  Parameters:
    `name` - the property name.
  Throws:
    `PropertyNotFoundException` - the property cannot be found.
    `INITIALIZE` - the property value cannot be loaded as a class.

### constructClass

    public java.lang.Object constructClass(java.lang.String prop_key,
                                           java.lang.String defl,
                                           java.lang.Object[] args)
                                    throws java.lang.reflect.InvocationTargetException

  This operation is used to load a class with the given property name and default class name.
  Parameters:
    `prop_key` - Property name, this string property holds the name of the class. May be null if no property is used.
    `defl` - Default class name. Used if the named property is not found. May be null to indicate no load should be performed if property is missing.
    `args` - arguments to constructor. If any constructor arguments are primitive types then the four argument version of this function must be used.
  Returns:
    the newly constructed object, or null if the property value is set to the empty string.
  Throws:
    `java.lang.reflect.InvocationTargetException` - an exception occoured in the constructor.
    `INITIALIZE` - the property value or default class cannot be loaded as a class.
    `java.lang.IllegalArgumentException` - some other problem occoured.

### constructClass

    public java.lang.Object constructClass(java.lang.String prop_key,
                                           java.lang.String defl,
                                           java.lang.Object[] args,
                                           java.lang.Class[] args_t)
                                    throws java.lang.reflect.InvocationTargetException

  This operation is used to load a class with the given property name and default class name.
  Parameters:
    `prop_key` - Property name, this string property holds the name of the class. May be null if no property is used.
    `defl` - Default class name. Used if the named property is not found. May be null to indicate no load should be performed if property is missing.
    `args` - arguments to constructor. If any constructor arguments are primitive types then the four argument version of this function must be used.
    `args_t` - types of onstructor arguments. If any of these are null they will be determined from getClass on the matching arg. Length must match length of args.
  Returns:
    the newly constructed object, or null if the property value is set to the empty string.
  Throws:
    `java.lang.reflect.InvocationTargetException` - an exception occoured in the constructor.
    `INITIALIZE` - the property value or default class cannot be loaded as a class.
    `java.lang.IllegalArgumentException` - some other problem occoured.

### classConstructor

    public java.lang.reflect.Constructor classConstructor(java.lang.String prop_key,
                                                          java.lang.String defl,
                                                          java.lang.Class[] args_t)