alma.acs.util

Class AcsLocations

java.lang.Object

alma.acs.util.AcsLocations

public class AcsLocations
extends java.lang.Object

Provides some support for dealing with manager references and corbalocs.

Author:

mschilli

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CDB_SYMBOL The suffix for a cdb-dal location.
static java.lang.String	CONTAINERDAEMON_SYMBOL The suffix for a ContainerDaemon location.
static java.lang.String	INTERFACEREPOSITORY_SYMBOL The suffix for a InterfaceRepository location.
static java.lang.String	MANAGER_SYMBOL The suffix for a Manager location.
static java.lang.String	NAMESERVICE_SYMBOL The suffix for a NameService location.
static java.lang.String	SERVICESDAEMON_SYMBOL The suffix for a ServicesDaemon location.

Constructor Summary

Constructors

Constructor and Description
AcsLocations()

Method Summary

Modifier and Type	Method and Description
static java.lang.String[]	convert(java.lang.String loc) Extracts host and port from a location string (either a corbaloc or an IOR).
static java.lang.String	convertToCdbLocation(java.lang.String host, java.lang.String port) Composes a CDB corbaloc for the specified host and port.
static java.lang.String	convertToCdbLocation(java.lang.String host, java.lang.String port, java.lang.String protocol) Composes a CDB corbaloc for the specified host, port, and protocol.
static java.lang.String	convertToContainerDaemonLocation(java.lang.String host) Composes a ContainerDaemon corbaloc for the specified host.
static java.lang.String	convertToInterfaceRepositoryLocation(java.lang.String host, java.lang.String port) Composes a InterfaceRepository corbaloc for the specified host and port.
static java.lang.String	convertToInterfaceRepositoryLocation(java.lang.String host, java.lang.String port, java.lang.String protocol) Composes a InterfaceRepository corbaloc for the specified host, port, and protocol.
static java.lang.String	convertToManagerLocation(java.lang.String host, java.lang.String port) Composes a Manager corbaloc for the specified host and port.
static java.lang.String	convertToManagerLocation(java.lang.String host, java.lang.String port, java.lang.String protocol) Composes a Manager corbaloc for the specified host, port, and protocol.
static java.lang.String	convertToNameServiceLocation(java.lang.String host, java.lang.String port) Composes a NameService corbaloc for the specified host and port.
static java.lang.String	convertToNameServiceLocation(java.lang.String host, java.lang.String port, java.lang.String protocol) Composes a NameService corbaloc for the specified host, port, and protocol.
static java.lang.String	convertToServicesDaemonLocation(java.lang.String host) Composes a ServicesDaemon corbaloc for the specified host.
static java.lang.String	figureOutManagerLocation() Figures out the manager location by reading the related system properties, otherwise falls back to a default value.
static java.lang.String	getLocalIP() Returns the stringified IP or "localhost" if an error were to occur.

Methods inherited from class java.lang.Object

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

Field Detail

MANAGER_SYMBOL

public static java.lang.String MANAGER_SYMBOL

The suffix for a Manager location. Note: Not a constant, to allow for changes at runtime in case this might be needed.

NAMESERVICE_SYMBOL

public static java.lang.String NAMESERVICE_SYMBOL

The suffix for a NameService location. Note: Not a constant, to allow for changes at runtime in case this might be needed.

INTERFACEREPOSITORY_SYMBOL

public static java.lang.String INTERFACEREPOSITORY_SYMBOL

The suffix for a InterfaceRepository location. Note: Not a constant, to allow for changes at runtime in case this might be needed.

CDB_SYMBOL

public static java.lang.String CDB_SYMBOL

The suffix for a cdb-dal location. Note: Not a constant, to allow for changes at runtime in case this might be needed.

SERVICESDAEMON_SYMBOL

public static final java.lang.String SERVICESDAEMON_SYMBOL

The suffix for a ServicesDaemon location.

Note that this string constant is also defined in acsdaemon.idl and would be accessible as "alma.acsdaemon.servicesDaemonServiceName.value" if module acsdaemonidl would not come after jacsutil.

See Also:

Constant Field Values

CONTAINERDAEMON_SYMBOL

public static final java.lang.String CONTAINERDAEMON_SYMBOL

The suffix for a ContainerDaemon location.

Note that this string constant is also defined in acsdaemon.idl and would be accessible as "alma.acsdaemon.containerDaemonServiceName.value" if module acsdaemonidl would not come after jacsutil.

See Also:

Constant Field Values

Constructor Detail

AcsLocations

public AcsLocations()

Method Detail

getLocalIP

public static java.lang.String getLocalIP()

Returns the stringified IP or "localhost" if an error were to occur. This method forwards to ACSPorts.getIP().

Returns:

the stringified IP or "localhost" if an error were to occur.

figureOutManagerLocation

public static java.lang.String figureOutManagerLocation()

Figures out the manager location by reading the related system properties, otherwise falls back to a default value. The strategy uses the following order:

1. if it exists, use property ACS.manager
2. if it exists, use ACS.baseport together with local IP
3. use port 3000 together with local IP

Returns:

our best guess for a valid manager location (something like corbaloc::134.171.27.234:3000/Manager)

convert

public static java.lang.String[] convert(java.lang.String loc)
                                  throws java.lang.IllegalArgumentException

Extracts host and port from a location string (either a corbaloc or an IOR).

This method is the counterpart to all the convertTo... methods defined in this class.

The location string's format is recognized by the prefix (case insensitive). If the format is unknown, an exception will be thrown.

Parameters:

loc - a CORBALOC or an IOR

Returns:

an array {host, port}

Throws:

java.lang.IllegalArgumentException - If the location has an unknown format or is otherwise invalid

convertToManagerLocation

public static java.lang.String convertToManagerLocation(java.lang.String host,
                                                        java.lang.String port)

Composes a Manager corbaloc for the specified host and port.

convertToManagerLocation

public static java.lang.String convertToManagerLocation(java.lang.String host,
                                                        java.lang.String port,
                                                        java.lang.String protocol)

Composes a Manager corbaloc for the specified host, port, and protocol.

convertToNameServiceLocation

public static java.lang.String convertToNameServiceLocation(java.lang.String host,
                                                            java.lang.String port)

Composes a NameService corbaloc for the specified host and port.

convertToNameServiceLocation

public static java.lang.String convertToNameServiceLocation(java.lang.String host,
                                                            java.lang.String port,
                                                            java.lang.String protocol)

Composes a NameService corbaloc for the specified host, port, and protocol.

convertToInterfaceRepositoryLocation

public static java.lang.String convertToInterfaceRepositoryLocation(java.lang.String host,
                                                                    java.lang.String port)

Composes a InterfaceRepository corbaloc for the specified host and port.

convertToInterfaceRepositoryLocation

public static java.lang.String convertToInterfaceRepositoryLocation(java.lang.String host,
                                                                    java.lang.String port,
                                                                    java.lang.String protocol)

Composes a InterfaceRepository corbaloc for the specified host, port, and protocol.

convertToCdbLocation

public static java.lang.String convertToCdbLocation(java.lang.String host,
                                                    java.lang.String port)

Composes a CDB corbaloc for the specified host and port.

convertToCdbLocation

public static java.lang.String convertToCdbLocation(java.lang.String host,
                                                    java.lang.String port,
                                                    java.lang.String protocol)

Composes a CDB corbaloc for the specified host, port, and protocol.

convertToServicesDaemonLocation

public static java.lang.String convertToServicesDaemonLocation(java.lang.String host)

Composes a ServicesDaemon corbaloc for the specified host.

convertToContainerDaemonLocation

public static java.lang.String convertToContainerDaemonLocation(java.lang.String host)

Composes a ContainerDaemon corbaloc for the specified host.