Chain (Nutz 1.r.61.r2 API)

java.lang.Object
- org.nutz.dao.Chain

直接已知子类:

Chain.DefaultChain
```
public abstract class Chain
extends Object
```
名值链。
通过 add 方法，建立一条名值对的链表

作者:

zozoh(zozohtnt@gmail.com), Wendal(wendal1985@gmail.com), lzxz1234

嵌套类概要

嵌套类
限定符和类型类和说明

static class Chain.DefaultChain

static class Chain.Entry

嵌套类
限定符和类型	类和说明
`static class`	`Chain.DefaultChain`
`static class`	`Chain.Entry`

构造器概要

构造器
构造器和说明

Chain()

构造器
构造器和说明
`Chain()`

方法概要

所有方法静态方法实例方法抽象方法具体方法
限定符和类型	方法和说明
`abstract ValueAdaptor`	`adaptor()`
`abstract Chain`	`adaptor(ValueAdaptor adaptor)` 设置节点的参考适配器
`abstract Chain`	`add(String name, Object value)` 将一个名值对，添加为本链节点的下一环
`abstract Chain`	`addSpecial(String name, Object value)` 添加一个特殊节点, 如果value非空而且是String类型,则有3个情况: +1 效果如age=age+1 -1 效果如count=count-1 支持的运算符有 + - *\/ % & ^ \| 其他值, 则对value.toString() `Chain chain = Chain.makeSpecial("age", "+1");//输出的SQL会是 age=age+1` `Chain chain = Chain.makeSpecial("ct", "now()");//输出的SQL会是 ct=now(),但不建议用依赖特定数据库的now(),仅供演示.`
`static Chain`	`from(Object obj)` 根据一个 POJO 对象的字段生成一个 Chain 对象相当于 Chain.from(obj,null)
`static Chain`	`from(Object obj, FieldMatcher fm)` 根据一个对象的字段生成一个 Chain 对象这个对象可以是一个 POJO 或者是一个 Map。
`static Chain`	`from(Object obj, FieldMatcher fm, Dao dao)`
`abstract Chain`	`head()`
`abstract boolean`	`isSpecial()` 整个Chain是否为特殊Chain，只要有一个特殊结点，就是特殊Chain
`static Chain`	`make(String name, Object value)` 建立一条名值链开始的一环
`static Chain`	`makeSpecial(String name, Object value)`
`abstract String`	`name()`
`abstract Chain`	`name(String name)` 改变当前节点的名称
`abstract Chain`	`next()`
`abstract int`	`size()`
`abstract boolean`	`special()` 当前结点是不是特殊结点
`Map<String,Object>`	`toEntityMap(String tableName)` 由当前的值链生成一个可被实体化的 Map。
`abstract Map<String,Object>`	`toMap()` 由当前名值链，生成一个 Map
`abstract <T> T`	`toObject(Class<T> classOfT)` 由当前的名值链，生成一个对象
`String`	`toString()` 生成一个 JSON 字符串
`abstract Chain`	`updateBy(Entity<?> entity)` 根据 Entity 里的设定，更新整个链所有节点的名称。
`abstract Object`	`value()`
`abstract Chain`	`value(Object value)` 改变当前节点的值

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造器详细资料
  - Chain
```
public Chain()
```
- 方法详细资料
  - make
```
public static Chain make(String name,
                         Object value)
```
    建立一条名值链开始的一环
    
    参数:
    
    name - 名称
    
    value - 值
    
    返回:
    
    链头
  - size
```
public abstract int size()
```
    返回:
    
    链的长度
  - name
```
public abstract Chain name(String name)
```
    改变当前节点的名称
    
    参数:
    
    name - 新名称
    
    返回:
    
    当前节点
  - value
```
public abstract Chain value(Object value)
```
    改变当前节点的值
    
    参数:
    
    value - 新值
    
    返回:
    
    当前节点
  - adaptor
```
public abstract Chain adaptor(ValueAdaptor adaptor)
```
    设置节点的参考适配器
    
    参数:
    
    adaptor - 适配器
    
    返回:
    
    当前节点
  - adaptor
```
public abstract ValueAdaptor adaptor()
```
    返回:
    
    当前节点的参考适配器
  - add
```
public abstract Chain add(String name,
                          Object value)
```
    将一个名值对，添加为本链节点的下一环
    
    参数:
    
    name - 名
    
    value - 值
    
    返回:
    
    新增加的节点
  - name
```
public abstract String name()
```
    返回:
    
    当前节点的名称
  - value
```
public abstract Object value()
```
    返回:
    
    当前节点的值
  - next
```
public abstract Chain next()
```
    返回:
    
    往后移动一个结点，到达末尾返回空，否则返回当前对象
  - head
```
public abstract Chain head()
```
    返回:
    
    整个链的第一环（头节点）
  - updateBy
```
public abstract Chain updateBy(Entity<?> entity)
```
    根据 Entity 里的设定，更新整个链所有节点的名称。
    如果节点的名称是 Entity 的一个字段，则采用数据库字段的名称
    
    参数:
    
    entity - 实体
    
    返回:
    
    链头节点
  - toObject
```
public abstract <T> T toObject(Class<T> classOfT)
```
    由当前的名值链，生成一个对象
    
    参数:
    
    classOfT - 对象类型
    
    返回:
    
    对象实例
  - toMap
```
public abstract Map<String,Object> toMap()
```
    由当前名值链，生成一个 Map
    
    返回:
    
    Map
  - isSpecial
```
public abstract boolean isSpecial()
```
    整个Chain是否为特殊Chain，只要有一个特殊结点，就是特殊Chain
    
    从以下版本开始:
    
    1.b.44
    
    另请参阅:
    
    addSpecial(String, Object)
  - special
```
public abstract boolean special()
```
    当前结点是不是特殊结点
    
    返回:
    
    是不是特殊结点
  - toEntityMap
```
public Map<String,Object> toEntityMap(String tableName)
```
    由当前的值链生成一个可被实体化的 Map。即有 '.table' 属性
    
    参数:
    
    tableName - 表名
    
    返回:
    
    可被实体化的 Map
  - toString
```
public String toString()
```
    生成一个 JSON 字符串
    
    覆盖:
    
    toString 在类中 Object
  - from
```
public static Chain from(Object obj,
                         FieldMatcher fm)
```
    根据一个对象的字段生成一个 Chain 对象
    这个对象可以是一个 POJO 或者是一个 Map。
    支持 FieldMatcher，即你可以通过 FieldMatcher 来指定你需要哪些字段加入 Chain
    
    参数:
    
    obj - 对象，可以是一个 POJO 或者是一个 Map
    
    fm - 指明可用字段，null 表示全部字段可用
    
    返回:
    
    Chain 对象，null 表示对象中没有可用字段
    
    另请参阅:
    
    FieldMatcher
  - from
```
public static Chain from(Object obj)
```
    根据一个 POJO 对象的字段生成一个 Chain 对象
    相当于 Chain.from(obj,null)
    
    参数:
    
    obj - POJO 对象
    
    返回:
    
    Chain 对象
  - from
```
public static Chain from(Object obj,
                         FieldMatcher fm,
                         Dao dao)
```
  - addSpecial
```
public abstract Chain addSpecial(String name,
                                 Object value)
```
    添加一个特殊节点, 如果value非空而且是String类型,则有3个情况:
  - +1 效果如age=age+1
  - -1 效果如count=count-1
  - 支持的运算符有 + - *\/ % & ^ |
  - 其他值, 则对value.toString()

从以下版本开始:: 1.b.44

makeSpecial

public static Chain makeSpecial(String name,
                                Object value)

从以下版本开始:: 1.b.44
另请参阅:: addSpecial(String, Object)

类 Chain

嵌套类概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

Chain

方法详细资料

make

size

name

value

adaptor

adaptor

add

name

value

next

head

updateBy

toObject

toMap

isSpecial

special

toEntityMap

toString

from

from

from

addSpecial

makeSpecial