Package org.refcodes.runtime

Enum SystemContext

java.lang.Object

java.lang.Enum<SystemContext>

org.refcodes.runtime.SystemContext

All Implemented Interfaces:

Serializable, Comparable<SystemContext>

public enum SystemContext
extends Enum<SystemContext>

Describes the context within a system's environment regarding host, user and application contexts.

Enum Constant Summary

Enum Constants

Enum Constant	Description
APPLICATION	Specifies an application specific granularity.
HOST	Specifies a host specific granularity.
HOST_APPLICATION	Specifies an application on a host specific granularity.
HOST_USER	Specifies a user on a host specific granularity.
HOST_USER_APPLICATION	Specifies an application for a user specific granularity.
USER	Specifies a user specific granularity.
USER_APPLICATION	Specifies a user specific granularity.

Method Summary

Modifier and Type	Method	Description
boolean	isApplicationLevel()	Determines whether the granularity is on an application level.
boolean	isHostLevel()	Determines whether the granularity is on a host level.
boolean	isUserLevel()	Determines whether the granularity is on a user level.
int	toSystemId()	Creates an ID most probably unique as specified by the provided argument this method is invoked on.Succeeding calls of this method on the same machine returns the same value.
int	toSystemId(String aSeed)	Creates an ID most probably unique as specified by the provided argument this method is invoked on.
int[]	toSystemIds(int aIdLength)	Creates an array of IDs most probably unique as specified by the provided argument this method is invoked on.
int[]	toSystemIds(int aIdLength, String aSeed)	Creates an array of IDs most probably unique as specified by the provided argument this method is invoked on.
String	toSystemSequence()	Creates a String most probably unique as specified by the provided argument this method is invoked on.
String	toSystemSequence(String aSeed)	Creates a String most probably unique as specified by the provided argument this method is invoked on.
static SystemContext	valueOf(String name)	Returns the enum constant of this type with the specified name.
static SystemContext[]	values()	Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

APPLICATION

public static final SystemContext APPLICATION

Specifies an application specific granularity.

USER_APPLICATION

public static final SystemContext USER_APPLICATION

Specifies a user specific granularity.

HOST_USER_APPLICATION

public static final SystemContext HOST_USER_APPLICATION

Specifies an application for a user specific granularity.

HOST_APPLICATION

public static final SystemContext HOST_APPLICATION

Specifies an application on a host specific granularity.

USER

public static final SystemContext USER

Specifies a user specific granularity.

HOST_USER

public static final SystemContext HOST_USER

Specifies a user on a host specific granularity.

HOST

public static final SystemContext HOST

Specifies a host specific granularity.

Method Detail

values

public static SystemContext[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (SystemContext c : SystemContext.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static SystemContext valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

isHostLevel

public boolean isHostLevel()

Determines whether the granularity is on a host level.

Returns:

True in case of being on a host level, else false.

isUserLevel

public boolean isUserLevel()

Determines whether the granularity is on a user level.

Returns:

True in case of being on a user level, else false.

isApplicationLevel

public boolean isApplicationLevel()

Determines whether the granularity is on an application level.

Returns:

True in case of being on an application level, else false.

toSystemSequence

public String toSystemSequence()

Creates a String most probably unique as specified by the provided argument this method is invoked on. Attention: The result my vary depending on the user under which the application is being executed! Supports the environment variable EnvironmentVariable.HOST_SEED as well as the system property SystemProperty.HOST_SEED. The enumeration value specifies the context for the created ID, e.g. which system properties to take into account.

Returns:

The calculated system's String.

toSystemSequence

public String toSystemSequence(String aSeed)

Creates a String most probably unique as specified by the provided argument this method is invoked on. Attention: The result my vary depending on the user under which the application is being executed! Supports the environment variable EnvironmentVariable.HOST_SEED as well as the system property SystemProperty.HOST_SEED. The enumeration value specifies the context for the created ID, e.g. which system properties to take into account.

Parameters:

aSeed - A seed to alter the ID individually.

Returns:

The calculated system's String.

toSystemId

public int toSystemId()

Creates an ID most probably unique as specified by the provided argument this method is invoked on.Succeeding calls of this method on the same machine returns the same value. Attention: The result my vary depending on the user under which the application is being executed! Supports the environment variable EnvironmentVariable.HOST_SEED as well as the system property SystemProperty.HOST_SEED. The enumeration value specifies the context for the created ID, e.g. which system properties to take into account.

Returns:

The calculated system's ID.

toSystemId

public int toSystemId(String aSeed)

Creates an ID most probably unique as specified by the provided argument this method is invoked on. Succeeding calls of this method on the same machine with the same arguments returns the same value. Attention: The result my vary depending on the user under which the application is being executed! Supports the environment variable EnvironmentVariable.HOST_SEED as well as the system property SystemProperty.HOST_SEED. System.out.println(System.getenv("PROCESSOR_ARCHITECTURE")); System.out.println(System.getenv("PROCESSOR_ARCHITEW6432")); System.getProperty("os.arch"); The enumeration value specifies the context for the created ID, e.g. which system properties to take into account.

Parameters:

aSeed - A seed to alter the ID individually.

Returns:

The calculated system's ID.

toSystemIds

public int[] toSystemIds(int aIdLength)

Creates an array of IDs most probably unique as specified by the provided argument this method is invoked on. Succeeding calls of this method on the same machine with the same arguments returns the same values. Attention: The result my vary depending on the user under which the application is being executed! Supports the environment variable EnvironmentVariable.HOST_SEED as well as the system property SystemProperty.HOST_SEED. The enumeration value specifies the context for the created ID, e.g. which system properties to take into account.

Parameters:

aIdLength - The number of IDs to be generated.

Returns:

The calculated system's ID.

toSystemIds

public int[] toSystemIds(int aIdLength,
                         String aSeed)

Creates an array of IDs most probably unique as specified by the provided argument this method is invoked on. Succeeding calls of this method on the same machine with the same arguments returns the same values. Attention: The result my vary depending on the user under which the application is being executed! Supports the environment variable EnvironmentVariable.HOST_SEED as well as the system property SystemProperty.HOST_SEED. The enumeration value specifies the context for the created ID, e.g. which system properties to take into account.

Parameters:

aIdLength - The number of IDs to be generated.

aSeed - A seed to alter the ID individually.

Returns:

The calculated system's ID.