cn.weforward.data.counter

接口 Counter

所有超级接口:

cn.weforward.common.Nameable

所有已知实现类:

AbstractCounter, DbCounter, LabelCounter

public interface Counter
extends cn.weforward.common.Nameable

计数器，系统可能会分布部署，能运行在三种方式下：

1.独立运行（单机）

2.两个对等节点

3.一个主节点与多个（32个以内）从节点

注：分布模式下的计数器只会最终一致，所以不能作为依赖一致性逻辑的实现

作者:

liangyi

字段概要

字段

限定符和类型	字段和说明
static boolean	_DebugEnabled
static boolean	_InfoEnabled
static org.slf4j.Logger	_Logger 日志记录器
static boolean	_TraceEnabled 是否允许trace，通常写法 if(Counter.
static boolean	_WarnEnabled

方法概要

限定符和类型	方法和说明
boolean	compareAndSet(String id, long expect, long value) 比较并改变计数器的值
long	dec(String id) 计数减1
long	get(String id) 取得计数项的值
String	getName() 计数器名（标识）
long	inc(String id) 计数加1
long	inc(String id, int step) 指定ID的计数值加step
boolean	remove(String id) 删除计数项
void	removeAll() 删除所有计数器项
cn.weforward.common.ResultPage<String>	searchRange(String first, String last) 获取ID区间（ID>=first且ID<=last）内的计数项名
long	set(String id, long value) 设置计数项的值
cn.weforward.common.ResultPage<String>	startsWith(String prefix) 查询以指定前缀开始的项

字段详细资料

_Logger

static final org.slf4j.Logger _Logger

日志记录器

_TraceEnabled

static final boolean _TraceEnabled

是否允许trace，通常写法

 if(Counter._TraceEnabled){
        Counter._Logger.trace(...);
 }
 

_DebugEnabled

static final boolean _DebugEnabled

_InfoEnabled

static final boolean _InfoEnabled

_WarnEnabled

static final boolean _WarnEnabled

方法详细资料

getName

String getName()

计数器名（标识）

指定者:

getName 在接口中 cn.weforward.common.Nameable

返回:

计数器名（标识）

get

long get(String id)

取得计数项的值

参数:

id - 计数项

返回:

计数值

inc

long inc(String id)

计数加1

参数:

id - 计数项

返回:

加一后的计数值

inc

long inc(String id,
         int step)

指定ID的计数值加step

参数:

id - 计数项

step - 增加的值（负数为减小）

返回:

增加或减小step后的计数值

dec

long dec(String id)

计数减1

参数:

id - 计数项

返回:

减一后的计数值

set

long set(String id,
         long value)

设置计数项的值

参数:

id - 计数项

value - 计数值

返回:

设置前的计数值

compareAndSet

boolean compareAndSet(String id,
                      long expect,
                      long value)

比较并改变计数器的值

参数:

id - 计数器

expect - 改变时预期的值

value - 改变到的值

返回:

成功则返回true，否则意味着值不是expect

remove

boolean remove(String id)

删除计数项

参数:

id - 计数项

返回:

true/false

removeAll

void removeAll()

删除所有计数器项

startsWith

cn.weforward.common.ResultPage<String> startsWith(String prefix)

查询以指定前缀开始的项

参数:

prefix - 计数项ID前缀

返回:

计数项页结果

searchRange

cn.weforward.common.ResultPage<String> searchRange(String first,
                                                   String last)

获取ID区间（ID>=first且ID<=last）内的计数项名

参数:

first - 计数项名区间的开始，可以为null

last - 计数项名区间的结束，可以为null

返回:

计数项页结果