Module org.refcodes.runtime

Package org.refcodes.runtime

Enum Class SystemContext

java.lang.Object

java.lang.Enum<SystemContext>

org.refcodes.runtime.SystemContext

All Implemented Interfaces:

Serializable, Comparable<SystemContext>, Constable

public enum SystemContext
extends Enum<SystemContext>

Describes the context within a system's environment regarding host, user and application contexts as well as the currently invoked Java runtime session.

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Enum

Enum.EnumDesc<E extends Enum<E>>

Enum Constant Summary

Enum Constants

Enum Constant	Description
APPLICATION	Specifies an application specific granularity.
APPLICATION_SESSION	Specifies a Java runtime invokcation's session and an application specific granularity.
HOST	Specifies a host specific granularity.
HOST_APPLICATION	Specifies an application on a host specific granularity.
HOST_APPLICATION_SESSION	Specifies a Java runtime invokcation's session for an application on a host specific granularity.
HOST_SESSION	Specifies a Java runtime invokcation's session for a host specific granularity.
HOST_USER	Specifies a user on a host specific granularity.
HOST_USER_APPLICATION	Specifies an application for a user on a host specific granularity.
HOST_USER_APPLICATION_SESSION	Specifies a Java runtime invokcation's session for an application for a user on a host specific granularity.
HOST_USER_SESSION	Specifies a Java runtime invokcation's session for a user on a host specific granularity.
SESSION	Specifies a Java runtime invokcation's session specific granularity, valid just for the current invocation of the Java runtime.
USER	Specifies a user specific granularity.
USER_APPLICATION	Specifies a user specific granularity.
USER_APPLICATION_SESSION	Specifies a Java runtime invokcation's session and a user specific granularity.
USER_SESSION	Specifies a Java runtime invokcation's session for 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	isSessionLevel()	Determines whether the granularity is on a session level, e.g. valid just for the lifetime of the current runtime Java's invocation.
boolean	isUserLevel()	Determines whether the granularity is on a user level.
int	toContextId()	Creates an TID most probably unique as specified by the enumeration instance this method is invoked on.
int	toContextId(String aSeed)	Creates an TID most probably unique as specified by the enumeration instance this method is invoked on.
int[]	toContextIds(int aIdLength)	Creates an array of IDs most probably unique as specified by the provided argument this method is invoked on.
int[]	toContextIds(int aIdLength, String aSeed)	Creates an array of IDs most probably unique as specified by the provided argument this method is invoked on.
char[]	toContextSequence()	Creates a String most probably unique as specified by the enumeration instance this method is invoked on.
char[]	toContextSequence(char[] aSeed)	Creates a String most probably unique as specified by the enumeration instance this method is invoked on.
char[]	toContextSequence(String aSeed)	Creates a String most probably unique as specified by the enumeration instance this method is invoked on.
String	toContextString()	Creates a String most probably unique as specified by the enumeration instance this method is invoked on.
String	toContextString(char[] aSeed)	Creates a String most probably unique as specified by the enumeration instance this method is invoked on.
String	toContextString(String aSeed)	Creates a String most probably unique as specified by the enumeration instance this method is invoked on.
char[]	toInvertible(char[] aText)	Obfuscates (applies a simple invertible XOR function on) the given text with the SystemContext element's context String (as of toContextString()).
char[]	toObfuscated(String aText)	Obfuscates (applies a simple invertible XOR function on) the given text with the SystemContext element's context String (as of toContextString()).
static SystemContext	valueOf(String name)	Returns the enum constant of this class with the specified name.
static SystemContext[]	values()	Returns an array containing the constants of this enum class, in the order they are declared.

Methods inherited from class java.lang.Enum

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

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Details

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 on a host 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.

SESSION

public static final SystemContext SESSION

Specifies a Java runtime invokcation's session specific granularity, valid just for the current invocation of the Java runtime.

APPLICATION_SESSION

public static final SystemContext APPLICATION_SESSION

Specifies a Java runtime invokcation's session and an application specific granularity.

USER_APPLICATION_SESSION

public static final SystemContext USER_APPLICATION_SESSION

Specifies a Java runtime invokcation's session and a user specific granularity.

HOST_USER_APPLICATION_SESSION

public static final SystemContext HOST_USER_APPLICATION_SESSION

Specifies a Java runtime invokcation's session for an application for a user on a host specific granularity.

HOST_APPLICATION_SESSION

public static final SystemContext HOST_APPLICATION_SESSION

Specifies a Java runtime invokcation's session for an application on a host specific granularity.

USER_SESSION

public static final SystemContext USER_SESSION

Specifies a Java runtime invokcation's session for a user specific granularity.

HOST_USER_SESSION

public static final SystemContext HOST_USER_SESSION

Specifies a Java runtime invokcation's session for a user on a host specific granularity.

HOST_SESSION

public static final SystemContext HOST_SESSION

Specifies a Java runtime invokcation's session for a host specific granularity.

Method Details

values

public static SystemContext[] values()

Returns an array containing the constants of this enum class, in the order they are declared.

Returns:

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

valueOf

public static SystemContext valueOf(String name)

Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (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 class 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.

isSessionLevel

public boolean isSessionLevel()

Determines whether the granularity is on a session level, e.g. valid just for the lifetime of the current runtime Java's invocation.

Returns:

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

toContextString

public String toContextString()

Creates a String most probably unique as specified by the enumeration instance 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 TID, e.g. which system properties to take into account.

Returns:

The calculated system's String.

toContextString

public String toContextString(String aSeed)

Creates a String most probably unique as specified by the enumeration instance 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 TID, e.g. which system properties to take into account.

Parameters:

aSeed - A seed to alter the TID individually.

Returns:

The calculated system's String.

toContextString

public String toContextString(char[] aSeed)

Creates a String most probably unique as specified by the enumeration instance 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 TID, e.g. which system properties to take into account.

Parameters:

aSeed - A seed to alter the TID individually.

Returns:

The calculated system's String.

toContextSequence

public char[] toContextSequence()

Creates a String most probably unique as specified by the enumeration instance 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 TID, e.g. which system properties to take into account.

Returns:

The calculated system's String.

toContextSequence

public char[] toContextSequence(String aSeed)

Creates a String most probably unique as specified by the enumeration instance 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 TID, e.g. which system properties to take into account.

Parameters:

aSeed - A seed to alter the TID individually.

Returns:

The calculated system's String.

toContextSequence

public char[] toContextSequence(char[] aSeed)

Creates a String most probably unique as specified by the enumeration instance 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 TID, e.g. which system properties to take into account.

Parameters:

aSeed - A seed to alter the TID individually.

Returns:

The calculated system's String.

toContextId

public int toContextId()

Creates an TID most probably unique as specified by the enumeration instance 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 TID, e.g. which system properties to take into account.

Returns:

The calculated system's TID.

toContextId

public int toContextId(String aSeed)

Creates an TID most probably unique as specified by the enumeration instance 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 TID, e.g. which system properties to take into account.

Parameters:

aSeed - A seed to alter the TID individually.

Returns:

The calculated system's TID.

toContextIds

public int[] toContextIds(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 TID, e.g. which system properties to take into account.

Parameters:

aIdLength - The number of IDs to be generated.

Returns:

The calculated system's TID.

toContextIds

public int[] toContextIds(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 TID, e.g. which system properties to take into account.

Parameters:

aIdLength - The number of IDs to be generated.

aSeed - A seed to alter the TID individually.

Returns:

The calculated system's TID.

toObfuscated

public char[] toObfuscated(String aText)

Obfuscates (applies a simple invertible XOR function on) the given text with the SystemContext element's context String (as of toContextString()). Applying this operation to the result of this operation results in the original text (invertible function).

Parameters:

aText - The text to be obfuscated (inverted).

Returns:

The obfuscated (inverted) text.

toInvertible

public char[] toInvertible(char[] aText)

Obfuscates (applies a simple invertible XOR function on) the given text with the SystemContext element's context String (as of toContextString()). Applying this operation to the result of this operation results in the original text (invertible function).

Parameters:

aText - The text to be obfuscated (inverted).

Returns:

The obfuscated (inverted) text.