com.sun.grizzly.rcm
Class ResourceAllocationFilter

java.lang.Object
  com.sun.grizzly.filter.ReadFilter
      com.sun.grizzly.filter.ParserProtocolFilter
          com.sun.grizzly.rcm.ResourceAllocationFilter

All Implemented Interfaces:

ProtocolFilter, ReinvokeAware

public class ResourceAllocationFilter
extends ParserProtocolFilter

This ProtocolFilter is an implementation of a Resource Consumption Management (RCM) system. RCM system are allowing you to enable virtualization of system resources per web application, similar to Solaris 10 Zone or the outcome of the upcoming JSR 284. This ProtocolFiler uses a ProtocolParser to determine which token to use to enable virtualization. As an example, configuring this class to use the ContextRootAlgorithm will allow virtualization and isolation of http request. As an example, if you define: -Dcom.sun.grizzly.rcm.policyMetric="/myApplication|0.9" This ProtocolFilter will allocate 90% of the current threads count to application myApplication, and the remaining 10% to any other context-root (or application). See com.sun.grizzly.rcm.RCM for an example.

Author:

Jeanfrancois Arcand

Field Summary

protected static java.lang.String	ALLOCATION_MODE
protected static java.lang.String	allocationPolicy The allocation mode used: celling or Reserve.
protected static java.lang.String	ASTERISK_STRING
static java.lang.String	BYTE_BUFFER
static java.lang.String	BYTEBUFFER_INPUTSTREAM
protected static java.lang.String	CEILING
static java.lang.String	INVOKE_NEXT
protected static double	leftRatio The thread ratio used when an application isn't listed as a privileged application.
protected static java.lang.String	PATH_STRING
protected static java.util.concurrent.ConcurrentHashMap<java.lang.String,java.lang.Double>	privilegedTokens The list of privileged token used to decide if a request can be serviced by the privileged ExecutorService.
protected static java.lang.String	QUERY_STRING
protected static java.lang.String	RESERVE
protected static java.lang.String	RULE_TOKENS
protected static java.util.concurrent.ConcurrentHashMap<java.lang.String,java.util.concurrent.ExecutorService>	threadPools The ExecutorService configured based on the threadRatio.

Fields inherited from class com.sun.grizzly.filter.ParserProtocolFilter

isSkipRead

Fields inherited from class com.sun.grizzly.filter.ReadFilter

continousExecution, DELAYED_CLOSE_NOTIFICATION, readAttempts, UDP_SOCKETADDRESS

Fields inherited from interface com.sun.grizzly.ProtocolFilter

SUCCESSFUL_READ

Constructor Summary

ResourceAllocationFilter()

Method Summary

void	closeConnection(Context ctx) Close the connection.
boolean	execute(Context ctx)
java.util.concurrent.ExecutorService	filterRequest(java.lang.String token, java.util.concurrent.ExecutorService p) Filter the request and decide which thread pool to use.
protected java.lang.String	getContextRoot(java.nio.ByteBuffer byteBuffer) Get the context-root from the ByteBuffer
boolean	invokeProtocolParser(Context ctx, ProtocolParser protocolParser) Invoke the ProtocolParser.
protected boolean	isThreadPoolInUse() Check to see if the privileged thread pool are in-use right now.
ProtocolParser	newProtocolParser() Return a new ProtocolParser>/code> or a cached
protected java.util.concurrent.ExecutorService	newThreadPool(int threadCount, java.util.concurrent.ExecutorService p) Creates a new ExecutorService

Methods inherited from class com.sun.grizzly.filter.ParserProtocolFilter

isSkipRead, postExecute, setSkipRead, setSSLConfig

Methods inherited from class com.sun.grizzly.filter.ReadFilter

checkEmptyRead, execute, getReadAttempts, isContinuousExecution, log, setContinuousExecution, setReadAttempts

Methods inherited from class java.lang.Object

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

Field Detail

BYTE_BUFFER

public static final java.lang.String BYTE_BUFFER

See Also:

Constant Field Values

RESERVE

protected static final java.lang.String RESERVE

See Also:

Constant Field Values

CEILING

protected static final java.lang.String CEILING

See Also:

Constant Field Values

ALLOCATION_MODE

protected static final java.lang.String ALLOCATION_MODE

See Also:

Constant Field Values

RULE_TOKENS

protected static final java.lang.String RULE_TOKENS

See Also:

Constant Field Values

QUERY_STRING

protected static final java.lang.String QUERY_STRING

See Also:

Constant Field Values

PATH_STRING

protected static final java.lang.String PATH_STRING

See Also:

Constant Field Values

ASTERISK_STRING

protected static final java.lang.String ASTERISK_STRING

See Also:

Constant Field Values

BYTEBUFFER_INPUTSTREAM

public static final java.lang.String BYTEBUFFER_INPUTSTREAM

See Also:

Constant Field Values

INVOKE_NEXT

public static final java.lang.String INVOKE_NEXT

See Also:

Constant Field Values

threadPools

protected static final java.util.concurrent.ConcurrentHashMap<java.lang.String,java.util.concurrent.ExecutorService> threadPools

The ExecutorService configured based on the threadRatio. This ExecutorService is only used by privileged application.

privilegedTokens

protected static final java.util.concurrent.ConcurrentHashMap<java.lang.String,java.lang.Double> privilegedTokens

The list of privileged token used to decide if a request can be serviced by the privileged ExecutorService.

leftRatio

protected static double leftRatio

The thread ratio used when an application isn't listed as a privileged application.

allocationPolicy

protected static java.lang.String allocationPolicy

The allocation mode used: celling or Reserve. With Ceiling policy, the strategy is to wait until all apps queus are showing some slack. With Reserve policiy, if 100% reservation is made by other apps, cancel the request processing.

Constructor Detail

ResourceAllocationFilter

public ResourceAllocationFilter()

Method Detail

execute

public boolean execute(Context ctx)
                throws java.io.IOException

Specified by:

execute in interface ProtocolFilter

Overrides:

execute in class ParserProtocolFilter

Throws:

java.io.IOException

invokeProtocolParser

public boolean invokeProtocolParser(Context ctx,
                                    ProtocolParser protocolParser)

Invoke the ProtocolParser. If more bytes are required, register the SelectionKey back to its associated SelectorHandler

Overrides:

invokeProtocolParser in class ParserProtocolFilter

Parameters:

ctx - the Context object.

Returns:

true if no more bytes are needed.

filterRequest

public java.util.concurrent.ExecutorService filterRequest(java.lang.String token,
                                                          java.util.concurrent.ExecutorService p)

Filter the request and decide which thread pool to use.

newThreadPool

protected java.util.concurrent.ExecutorService newThreadPool(int threadCount,
                                                             java.util.concurrent.ExecutorService p)

Creates a new ExecutorService

isThreadPoolInUse

protected boolean isThreadPoolInUse()

Check to see if the privileged thread pool are in-use right now.

getContextRoot

protected java.lang.String getContextRoot(java.nio.ByteBuffer byteBuffer)

Get the context-root from the ByteBuffer

closeConnection

public void closeConnection(Context ctx)

Close the connection.

newProtocolParser

public ProtocolParser newProtocolParser()

Return a new ProtocolParser>/code> or a cached

Specified by:

newProtocolParser in class ParserProtocolFilter