ej.bon

Class Util

java.lang.Object

ej.bon.Util

public class Util
extends Object

This class offers basic services for B-ON implementation.

Constructor Summary

Constructors

Constructor and Description
Util()

Method Summary

Modifier and Type	Method and Description
static long	currentTimeMillis() Gets the application time in milliseconds.
static boolean	dynamicCodeAllowed() Deprecated. Please consider Kernel & Features specification instead.
static boolean	isInInitialization() Indicates whether the current code is part of the initialization phase.
static boolean	isInMission() Indicates whether the system has entered the mission phase, i.e.
static <T> T[]	newArray(Class<T[]> type, int length) Allocates a new array of object references from the given array type and length.
static long	platformTimeMillis() Gets an arbitrary time in milliseconds.
static long	platformTimeNanos() Gets an arbitrary time in nanoseconds.
static void	setCurrentTimeMillis(Date d) Sets the application time.
static void	setCurrentTimeMillis(long t) Sets the application time.
static void	throwExceptionInThread(RuntimeException e, Thread t) Deprecated. Please consider Kernel & Features specification instead.
static void	throwHardExceptionInThread(RuntimeException e, Thread t) Deprecated. Please consider Kernel & Features specification instead.

Methods inherited from class java.lang.Object

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

Constructor Detail

Util

public Util()

Method Detail

isInMission

public static boolean isInMission()

Indicates whether the system has entered the mission phase, i.e. it is initialized.

Returns:

true if the initialization is done

See Also:

Immortals

isInInitialization

public static boolean isInInitialization()

Indicates whether the current code is part of the initialization phase.

When Class.forName(String) triggers classes to be loaded at runtime dynamically, class initializations are done in a context where isInInitialization() is true and isInMission() is true.

Returns:

true if the initialization is ongoing

See Also:

Immortals

dynamicCodeAllowed

@Deprecated
public static boolean dynamicCodeAllowed()

Deprecated. Please consider Kernel & Features specification instead.

Tests the ability of the system to download code through Class.forName(String)

Returns:

true if the system allows dynamic code to be loaded, false otherwise

throwExceptionInThread

@Deprecated
public static void throwExceptionInThread(RuntimeException e,
                                                       Thread t)

Deprecated. Please consider Kernel & Features specification instead.

Throws an exception in a specified thread.

• If the thread is either sleeping or waiting, the thread is unblocked and the exception is thrown as soon as possible.
• If the thread is running, the exception is thrown just as if a throw statement was the next instruction to execute.
• If the thread is not started yet or is terminated, nothing is done.
• If the thread has entered one or more critical sections (i.e. it holds some object's monitor) the exception is not thrown until the thread has exited all the critical sections.
• If an exception thrown via throwExceptionInThread(RuntimeException, Thread) or throwHardExceptionInThread(RuntimeException, Thread) is already pending for the thread, nothing is done.

If any of the arguments is null, an IllegalArgumentException is thrown.

Parameters:

e - the exception to throw

t - the thread in which the exception is thrown

Throws:

IllegalArgumentException - if any of the arguments is null.

throwHardExceptionInThread

@Deprecated
public static void throwHardExceptionInThread(RuntimeException e,
                                                           Thread t)

Deprecated. Please consider Kernel & Features specification instead.

Throws an exception in a specified thread.

• If the thread is either sleeping or waiting, the thread is unblocked and the exception is thrown as soon as possible.
• If the thread is running, the exception is thrown just as if a throw statement was the next instruction to execute.
• If the thread is not started yet or is terminated, nothing is done.
• If the thread has entered one or more critical sections, it does not wait the critical sections to finish and the exception is thrown as soon as possible.
• If an exception thrown via throwHardExceptionInThread(RuntimeException, Thread) is already pending for the thread, nothing is done.
• If an exception thrown via throwExceptionInThread(RuntimeException, Thread) is already pending for the thread, this exception is replaced by the given exception.

Parameters:

e - the exception to throw

t - the thread in which the exception is thrown

Throws:

IllegalArgumentException - if any of the arguments is null.

currentTimeMillis

public static long currentTimeMillis()

Gets the application time in milliseconds.

The result of this method is the same as the System.currentTimeMillis() method one.

Returns:

the application time in milliseconds

platformTimeMillis

public static long platformTimeMillis()

Gets an arbitrary time in milliseconds.

Only elapsed time between two calls is meaningful.

Returns:

the platform time in milliseconds

platformTimeNanos

public static long platformTimeNanos()

Gets an arbitrary time in nanoseconds.

Only elapsed time between two calls is meaningful.

Returns:

the platform time in nanoseconds

setCurrentTimeMillis

public static void setCurrentTimeMillis(long t)

Sets the application time.

This time does not change the platform time.

Parameters:

t - the application time to set in milliseconds

Throws:

IllegalArgumentException - if t is negative

setCurrentTimeMillis

public static void setCurrentTimeMillis(Date d)

Sets the application time.

This time does not change the platform time. The Util.setCurrentTimeMillis(d) method has the same effect as Util.setCurrentTimeMillis(d.getTime()).

Parameters:

d - the application time to set

newArray

public static <T> T[] newArray(Class<T[]> type,
                               int length)

Allocates a new array of object references from the given array type and length.

Type Parameters:

T - the type of the array elements

Parameters:

type - the type of the array to allocate

length - the length of the array to allocate

Returns:

the new allocated array

Throws:

NullPointerException - if the type is null

OutOfMemoryError - if the array could not be allocated