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

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

Direct Known Subclasses:

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

Author:

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

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class Chain.DefaultChain

static class Chain.Entry

Nested Classes
Modifier and Type	Class and Description
`static class`	`Chain.DefaultChain`
`static class`	`Chain.Entry`

Constructor Summary

Constructors
Constructor and Description

Chain()

Constructors
Constructor and Description
`Chain()`

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`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个情况:
`static Chain`	`from(Object obj)` 根据一个 POJO 对象的字段生成一个 Chain 对象
`static Chain`	`from(Object obj, FieldMatcher fm)` 根据一个对象的字段生成一个 Chain 对象
`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。即有 '.table' 属性
`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)` 改变当前节点的值

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - Chain
```
public Chain()
```
- Method Detail
  - make
```
public static Chain make(String name,
                         Object value)
```
    建立一条名值链开始的一环
    
    Parameters:
    
    name - 名称
    
    value - 值
    
    Returns:
    
    链头
  - size
```
public abstract int size()
```
    Returns:
    
    链的长度
  - name
```
public abstract Chain name(String name)
```
    改变当前节点的名称
    
    Parameters:
    
    name - 新名称
    
    Returns:
    
    当前节点
  - value
```
public abstract Chain value(Object value)
```
    改变当前节点的值
    
    Parameters:
    
    value - 新值
    
    Returns:
    
    当前节点
  - adaptor
```
public abstract Chain adaptor(ValueAdaptor adaptor)
```
    设置节点的参考适配器
    
    Parameters:
    
    adaptor - 适配器
    
    Returns:
    
    当前节点
  - adaptor
```
public abstract ValueAdaptor adaptor()
```
    Returns:
    
    当前节点的参考适配器
  - add
```
public abstract Chain add(String name,
                          Object value)
```
    将一个名值对，添加为本链节点的下一环
    
    Parameters:
    
    name - 名
    
    value - 值
    
    Returns:
    
    新增加的节点
  - name
```
public abstract String name()
```
    Returns:
    
    当前节点的名称
  - value
```
public abstract Object value()
```
    Returns:
    
    当前节点的值
  - next
```
public abstract Chain next()
```
    Returns:
    
    往后移动一个结点，到达末尾返回空，否则返回当前对象
  - head
```
public abstract Chain head()
```
    Returns:
    
    整个链的第一环（头节点）
  - updateBy
```
public abstract Chain updateBy(Entity<?> entity)
```
    根据 Entity 里的设定，更新整个链所有节点的名称。
    如果节点的名称是 Entity 的一个字段，则采用数据库字段的名称
    
    Parameters:
    
    entity - 实体
    
    Returns:
    
    链头节点
  - toObject
```
public abstract <T> T toObject(Class<T> classOfT)
```
    由当前的名值链，生成一个对象
    
    Parameters:
    
    classOfT - 对象类型
    
    Returns:
    
    对象实例
  - toMap
```
public abstract Map<String,Object> toMap()
```
    由当前名值链，生成一个 Map
    
    Returns:
    
    Map
  - isSpecial
```
public abstract boolean isSpecial()
```
    整个Chain是否为特殊Chain，只要有一个特殊结点，就是特殊Chain
    
    Since:
    
    1.b.44
    
    See Also:
    
    addSpecial(String, Object)
  - special
```
public abstract boolean special()
```
    当前结点是不是特殊结点
    
    Returns:
    
    是不是特殊结点
  - toEntityMap
```
public Map<String,Object> toEntityMap(String tableName)
```
    由当前的值链生成一个可被实体化的 Map。即有 '.table' 属性
    
    Parameters:
    
    tableName - 表名
    
    Returns:
    
    可被实体化的 Map
  - toString
```
public String toString()
```
    生成一个 JSON 字符串
    
    Overrides:
    
    toString in class Object
  - from
```
public static Chain from(Object obj,
                         FieldMatcher fm)
```
    根据一个对象的字段生成一个 Chain 对象
    这个对象可以是一个 POJO 或者是一个 Map。
    支持 FieldMatcher，即你可以通过 FieldMatcher 来指定你需要哪些字段加入 Chain
    
    Parameters:
    
    obj - 对象，可以是一个 POJO 或者是一个 Map
    
    fm - 指明可用字段，null 表示全部字段可用
    
    Returns:
    
    Chain 对象，null 表示对象中没有可用字段
    
    See Also:
    
    FieldMatcher
  - from
```
public static Chain from(Object obj)
```
    根据一个 POJO 对象的字段生成一个 Chain 对象
    相当于 Chain.from(obj,null)
    
    Parameters:
    
    obj - POJO 对象
    
    Returns:
    
    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()

Since:: 1.b.44

makeSpecial

public static Chain makeSpecial(String name,
                                Object value)

Since:: 1.b.44
See Also:: addSpecial(String, Object)

Class Chain

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Chain

Method Detail

make

size

name

value

adaptor

adaptor

add

name

value

next

head

updateBy

toObject

toMap

isSpecial

special

toEntityMap

toString

from

from

from

addSpecial

makeSpecial