org.glassfish.hk2.runlevel.internal

Class RunLevelControllerImpl

java.lang.Object

org.glassfish.hk2.runlevel.internal.RunLevelControllerImpl

All Implemented Interfaces:

RunLevelController

@Service
@ContractsProvided(value=RunLevelController.class)
public class RunLevelControllerImpl
extends java.lang.Object
implements RunLevelController

This is the implementation of the RunLevelController

Author:

jwells

Nested Class Summary

Nested classes/interfaces inherited from interface org.glassfish.hk2.runlevel.RunLevelController

RunLevelController.ThreadingPolicy

Constructor Summary

Constructors

Constructor and Description
RunLevelControllerImpl()

Method Summary

Methods

Modifier and Type	Method and Description
void	cancel() If there is a current procedure in process this method will get it and cancel it
RunLevelFuture	getCurrentProceeding() This method will return the current proceedTo that the RunLevelController is working on, or it will return null if the controller is not currently moving up or down
int	getCurrentRunLevel() The current run level state.
int	getMaximumUseableThreads() Returns the current number of maximum useable threads
RunLevelController.ThreadingPolicy	getThreadingPolicy() Returns the threading policy currently being used by this controller
void	proceedTo(int runLevel) This method will move to the given run level synchronously as per RunLevelController.proceedToAsync(int).
RunLevelFuture	proceedToAsync(int runLevel) Causes this RunLevelController to move to the specified run level for all RunLevel instances, orchestrating the appropriate lifecycle events.
void	setMaximumUseableThreads(int maximumThreads) This sets the maximum number of threads that the system can create for creation and/or destruction of threads.
void	setThreadingPolicy(RunLevelController.ThreadingPolicy policy) Sets the threading policy that will be used by this controller.

Methods inherited from class java.lang.Object

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

Constructor Detail

RunLevelControllerImpl

public RunLevelControllerImpl()

Method Detail

proceedTo

public void proceedTo(int runLevel)

Description copied from interface: RunLevelController

This method will move to the given run level synchronously as per RunLevelController.proceedToAsync(int).

Specified by:

proceedTo in interface RunLevelController

Parameters:

runLevel - The level that should be proceeded to

proceedToAsync

public RunLevelFuture proceedToAsync(int runLevel)
                              throws CurrentlyRunningException,
                                     java.lang.IllegalStateException

Description copied from interface: RunLevelController

Causes this RunLevelController to move to the specified run level for all RunLevel instances, orchestrating the appropriate lifecycle events.

If the run level specified is the same as the current run level then the RunLevelController may return immediately

Specified by:

proceedToAsync in interface RunLevelController

Parameters:

runLevel - the run level to move to

Returns:

The future that can be used to wait for this object

Throws:

CurrentlyRunningException - if there is currently a job running this exception will be thrown with the currently running job

java.lang.IllegalStateException - if this method is called when the USE_NO_THREADS policy is in effect

getCurrentProceeding

public RunLevelFuture getCurrentProceeding()

Description copied from interface: RunLevelController

This method will return the current proceedTo that the RunLevelController is working on, or it will return null if the controller is not currently moving up or down

Specified by:

getCurrentProceeding in interface RunLevelController

Returns:

the current job the run level controller is working on or null if the system is not currently in flight

cancel

public void cancel()

Description copied from interface: RunLevelController

If there is a current procedure in process this method will get it and cancel it

Specified by:

cancel in interface RunLevelController

getCurrentRunLevel

public int getCurrentRunLevel()

Description copied from interface: RunLevelController

The current run level state. This represents the last run level successfully achieved by the underlying RunLevelController responsible for this scope.

Specified by:

getCurrentRunLevel in interface RunLevelController

Returns:

the current run level, or null if no run level has been been achieved

setMaximumUseableThreads

public void setMaximumUseableThreads(int maximumThreads)

Description copied from interface: RunLevelController

This sets the maximum number of threads that the system can create for creation and/or destruction of threads. This number must be one or greater

Specified by:

setMaximumUseableThreads in interface RunLevelController

Parameters:

maximumThreads - The maximum number of threads that can be used by the system for creation or destruction of services

getMaximumUseableThreads

public int getMaximumUseableThreads()

Description copied from interface: RunLevelController

Returns the current number of maximum useable threads

Specified by:

getMaximumUseableThreads in interface RunLevelController

Returns:

the current number of maximum useable threads

setThreadingPolicy

public void setThreadingPolicy(RunLevelController.ThreadingPolicy policy)

Description copied from interface: RunLevelController

Sets the threading policy that will be used by this controller. The values can be:

1. FULLY_THREADED: Use maximumUseableThreads to complete any task
2. USE_NO_THREADS: Never create a thread, use the callers thread always

Specified by:

setThreadingPolicy in interface RunLevelController

Parameters:

policy - The policy that should be used by this controller

getThreadingPolicy

public RunLevelController.ThreadingPolicy getThreadingPolicy()

Description copied from interface: RunLevelController

Returns the threading policy currently being used by this controller

Specified by:

getThreadingPolicy in interface RunLevelController

Returns:

The threading policy currently in use with this controller