com.alibaba.csp.sentinel

Class CtSph

java.lang.Object

com.alibaba.csp.sentinel.CtSph

All Implemented Interfaces:

Sph, SphResourceTypeSupport

public class CtSph
extends Object
implements Sph

Author:

jialiang.linjl, leyou(lihao), Eric Zhao

See Also:

Sph

Constructor Summary

Constructors

Constructor and Description
CtSph()

Method Summary

Modifier and Type	Method and Description
AsyncEntry	asyncEntry(String name, EntryType type, int count, Object... args) Create a protected asynchronous resource.
AsyncEntry	asyncEntryWithType(String name, int resourceType, EntryType entryType, int count, boolean prioritized, Object[] args) Create an asynchronous resource with provided classification.
Entry	entry(Method method) Create a protected method.
Entry	entry(Method method, EntryType type) Create a protected method.
Entry	entry(Method method, EntryType type, int count) Create a protected method.
Entry	entry(Method method, EntryType type, int count, Object... args) Create a protected resource.
Entry	entry(Method method, int count) Create a protected method.
Entry	entry(ResourceWrapper resourceWrapper, int count, Object... args) Do all Rules checking about the resource.
Entry	entry(String name) Create a protected resource.
Entry	entry(String name, EntryType type) Create a protected resource.
Entry	entry(String name, EntryType type, int count) Create a protected resource.
Entry	entry(String name, EntryType type, int count, Object... args) Create a protected resource.
Entry	entry(String name, int count) Create a protected resource.
static int	entrySize() Get current size of created slot chains.
Entry	entryWithPriority(String name, EntryType type, int count, boolean prioritized) Create a protected resource with priority.
Entry	entryWithPriority(String name, EntryType type, int count, boolean prioritized, Object... args) Create a protected resource with priority.
Entry	entryWithType(String name, int resourceType, EntryType entryType, int count, boolean prioritized, Object[] args) Create a protected resource with provided classification.
Entry	entryWithType(String name, int resourceType, EntryType entryType, int count, Object[] args) Create a protected resource with provided classification.

Methods inherited from class java.lang.Object

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

Constructor Detail

CtSph

public CtSph()

Method Detail

entry

public Entry entry(ResourceWrapper resourceWrapper,
                   int count,
                   Object... args)
            throws BlockException

Do all Rules checking about the resource.

Each distinct resource will use a ProcessorSlot to do rules checking. Same resource will use same ProcessorSlot globally.

Note that total ProcessorSlot count must not exceed Constants.MAX_SLOT_CHAIN_SIZE, otherwise no rules checking will do. In this condition, all requests will pass directly, with no checking or exception.

Parameters:

resourceWrapper - resource name

count - tokens needed

args - arguments of user method call

Returns:

Entry represents this call

Throws:

BlockException - if any rule's threshold is exceeded

entrySize

public static int entrySize()

Get current size of created slot chains.

Returns:

size of created slot chains

Since:

0.2.0

entry

public Entry entry(String name)
            throws BlockException

Description copied from interface: Sph

Create a protected resource.

Specified by:

entry in interface Sph

Parameters:

name - the unique name of the protected resource

Returns:

entry get.

Throws:

BlockException - if the block criteria is met

entry

public Entry entry(Method method)
            throws BlockException

Description copied from interface: Sph

Create a protected method.

Specified by:

entry in interface Sph

Parameters:

method - the protected method

Returns:

entry get.

Throws:

BlockException - if the block criteria is met

entry

public Entry entry(Method method,
                   EntryType type)
            throws BlockException

Description copied from interface: Sph

Create a protected method.

Specified by:

entry in interface Sph

Parameters:

method - the protected method

type - the resource is an inbound or an outbound method. This is used to mark whether it can be blocked when the system is unstable

Returns:

entry get.

Throws:

BlockException - if the block criteria is met

entry

public Entry entry(String name,
                   EntryType type)
            throws BlockException

Description copied from interface: Sph

Create a protected resource.

Specified by:

entry in interface Sph

Parameters:

name - the unique name for the protected resource

type - the resource is an inbound or an outbound method. This is used to mark whether it can be blocked when the system is unstable

Returns:

entry get.

Throws:

BlockException - if the block criteria is met

entry

public Entry entry(Method method,
                   EntryType type,
                   int count)
            throws BlockException

Description copied from interface: Sph

Create a protected method.

Specified by:

entry in interface Sph

Parameters:

method - the protected method

type - the resource is an inbound or an outbound method. This is used to mark whether it can be blocked when the system is unstable

count - the count that the resource requires

Returns:

entry get.

Throws:

BlockException - if the block criteria is met

entry

public Entry entry(String name,
                   EntryType type,
                   int count)
            throws BlockException

Description copied from interface: Sph

Create a protected resource.

Specified by:

entry in interface Sph

Parameters:

name - the unique name for the protected resource

type - the resource is an inbound or an outbound method. This is used to mark whether it can be blocked when the system is unstable

count - the count that the resource requires

Returns:

entry get.

Throws:

BlockException - if the block criteria is met

entry

public Entry entry(Method method,
                   int count)
            throws BlockException

Description copied from interface: Sph

Create a protected method.

Specified by:

entry in interface Sph

Parameters:

method - the protected method

count - the count that the resource requires

Returns:

entry get.

Throws:

BlockException - if the block criteria is met

entry

public Entry entry(String name,
                   int count)
            throws BlockException

Description copied from interface: Sph

Create a protected resource.

Specified by:

entry in interface Sph

Parameters:

name - the unique string for the resource

count - the count that the resource requires

Returns:

entry get.

Throws:

BlockException - if the block criteria is met

entry

public Entry entry(Method method,
                   EntryType type,
                   int count,
                   Object... args)
            throws BlockException

Description copied from interface: Sph

Create a protected resource.

Specified by:

entry in interface Sph

Parameters:

method - the protected method

type - the resource is an inbound or an outbound method. This is used to mark whether it can be blocked when the system is unstable

count - the count that the resource requires

args - the parameters of the method. It can also be counted by setting hot parameter rule

Returns:

entry get.

Throws:

BlockException - if the block criteria is met

entry

public Entry entry(String name,
                   EntryType type,
                   int count,
                   Object... args)
            throws BlockException

Description copied from interface: Sph

Create a protected resource.

Specified by:

entry in interface Sph

Parameters:

name - the unique name for the protected resource

type - the resource is an inbound or an outbound method. This is used to mark whether it can be blocked when the system is unstable

count - the count that the resource requires

args - the parameters of the method. It can also be counted by setting hot parameter rule

Returns:

entry get

Throws:

BlockException - if the block criteria is met

asyncEntry

public AsyncEntry asyncEntry(String name,
                             EntryType type,
                             int count,
                             Object... args)
                      throws BlockException

Description copied from interface: Sph

Create a protected asynchronous resource.

Specified by:

asyncEntry in interface Sph

Parameters:

name - the unique name for the protected resource

type - the resource is an inbound or an outbound method. This is used to mark whether it can be blocked when the system is unstable

count - the count that the resource requires

args - the parameters of the method. It can also be counted by setting hot parameter rule

Returns:

created asynchronous entry

Throws:

BlockException - if the block criteria is met

entryWithPriority

public Entry entryWithPriority(String name,
                               EntryType type,
                               int count,
                               boolean prioritized)
                        throws BlockException

Description copied from interface: Sph

Create a protected resource with priority.

Specified by:

entryWithPriority in interface Sph

Parameters:

name - the unique name for the protected resource

type - the resource is an inbound or an outbound method. This is used to mark whether it can be blocked when the system is unstable

count - the count that the resource requires

prioritized - whether the entry is prioritized

Returns:

entry get

Throws:

BlockException - if the block criteria is met

entryWithPriority

public Entry entryWithPriority(String name,
                               EntryType type,
                               int count,
                               boolean prioritized,
                               Object... args)
                        throws BlockException

Description copied from interface: Sph

Create a protected resource with priority.

Specified by:

entryWithPriority in interface Sph

Parameters:

name - the unique name for the protected resource

type - the resource is an inbound or an outbound method. This is used to mark whether it can be blocked when the system is unstable

count - the count that the resource requires

prioritized - whether the entry is prioritized

args - the parameters of the method. It can also be counted by setting hot parameter rule

Returns:

entry get

Throws:

BlockException - if the block criteria is met

entryWithType

public Entry entryWithType(String name,
                           int resourceType,
                           EntryType entryType,
                           int count,
                           Object[] args)
                    throws BlockException

Description copied from interface: SphResourceTypeSupport

Create a protected resource with provided classification.

Specified by:

entryWithType in interface SphResourceTypeSupport

Parameters:

name - the unique name of the protected resource

resourceType - the classification of the resource

entryType - the traffic entry type (IN/OUT) of the resource

count - tokens required

args - extra parameters

Returns:

new entry of the resource

Throws:

BlockException - if the block criteria is met

entryWithType

public Entry entryWithType(String name,
                           int resourceType,
                           EntryType entryType,
                           int count,
                           boolean prioritized,
                           Object[] args)
                    throws BlockException

Description copied from interface: SphResourceTypeSupport

Create a protected resource with provided classification.

Specified by:

entryWithType in interface SphResourceTypeSupport

Parameters:

name - the unique name of the protected resource

resourceType - the classification of the resource

entryType - the traffic entry type (IN/OUT) of the resource

count - tokens required

prioritized - whether the entry is prioritized

args - extra parameters

Returns:

new entry of the resource

Throws:

BlockException - if the block criteria is met

asyncEntryWithType

public AsyncEntry asyncEntryWithType(String name,
                                     int resourceType,
                                     EntryType entryType,
                                     int count,
                                     boolean prioritized,
                                     Object[] args)
                              throws BlockException

Description copied from interface: SphResourceTypeSupport

Create an asynchronous resource with provided classification.

Specified by:

asyncEntryWithType in interface SphResourceTypeSupport

Parameters:

name - the unique name of the protected resource

resourceType - the classification of the resource

entryType - the traffic entry type (IN/OUT) of the resource

count - tokens required

prioritized - whether the entry is prioritized

args - extra parameters

Returns:

new entry of the resource

Throws:

BlockException - if the block criteria is met