Thing (x-meta 1.4.3 API)

java.lang.Object
- org.xmeta.Thing

直接已知子类:

MetaThing
```
public class Thing
extends Object
```
在X-Meta引擎里用事物表示任何东西。

事物有状态和行为，可以通过set和get、getxx方法来设置和获取事物的状态，可以通过doAction(String actionName) 或doAction(String actionName, ActionContext actionContext)方法来执行事物。

事物之间有描述和继承关系，一个事物可以继承它的描述者行为以及继承继承者的属性和行为。

作者:

zyx

字段概要

字段
修饰符和类型	字段	说明
`protected Action`	`action`	每一个事物都有动作的形态
`protected Map<String,LinkedThingEntry>`	`actionCaches`	动作事物的缓存
`static String`	`ATTRIBUTE`	属性的名字
`protected Map<String,Object>`	`attributes`	事物的属性集合。
`protected List<Thing>`	`childs`	子事物列表
`protected Map<String,Object>`	`datas`	附加于事物的用户数据
`static String`	`DESCRIPTION`	描述属性的名字
`static String`	`DESCRIPTORS`	描述者属性的名字
`protected ThingEntry[]`	`descriptorsCaches`	描述者列表的缓存
`static String`	`EXTENDS`	继承者属性的名字
`protected ThingEntry[]`	`extendsCaches`	继承列表的缓存
`protected boolean`	`isTransient`	是否是瞬态的事物
`static String`	`LABEL`	标签的名字
`protected ThingMetadata`	`metadata`	事物的元数据，用于存放此事物在系统中的一些属性。
`static String`	`NAME`	名字的名字
`static String`	`ORIGIN_THING_PATH`	原始事物的路径，尤其是在做detach时
`protected Thing`	`parent`	父事物，包含此事物的父事物。
`static String`	`THING`	事物的名字
`protected List<String>`	`thingNames`	事物的名称（类名）的缓存列表

构造器概要

构造器
构造器	说明
`Thing()`	默认构造函数，构造一个空的瞬态事物。
`Thing(String descriptorPath)`	通过描述者的路径来构造一个瞬态事物。
`Thing(String name, String label)`	通过名称和标签创建一个瞬态事物。
`Thing(String name, String label, String descriptorPath)`	通过名称、标签和描述者的路径来构造一个瞬态事物。
`Thing(String name, String label, String descriptorPath, boolean isTransient)`	指定名称、标签、描述者和是否是瞬态的来构造一个事物。

方法概要

所有方法实例方法具体方法已过时的方法
修饰符和类型	方法	说明
`void`	`addChild(String xml)`
`void`	`addChild(Thing childThing)`	添加一个子事物。
`void`	`addChild(Thing childThing, boolean changeParen)`
`void`	`addChild(Thing childThing, int index)`
`void`	`addChild(Thing childThing, int index, boolean changeParent)`	在指定的索引位置添加一个子事物。
`void`	`addDescriptor(int index, Thing descriptor)`	在指定位置添加一个描述者。
`void`	`addDescritpor(int index, String descriptorPath)`	通过描述者的路径加入描述者，可以加入多个，中间使用','号隔开。
`void`	`addExtend(int index, Thing extendThing)`	在指定位置添加一个继承事物。
`void`	`beginModify()`	beginBigModifiy必须和endBigModify成对出现。
`void`	`changeChildIndex(Thing child, int index, int moveStep)`	改变一个子事物的位置索引。
`void`	`cognize(String xmlData)`	从一个XML数据认知并把认知结果保存到自身。
`void`	`cognize(Map<String,Object> adata)`	从一个Map数据认知并把认知结果保存到自身。
`void`	`cognize(Thing thing)`	认知另一事物并把认知结果作为自己的一部分。
`Thing`	`copyTo(String thingManager, String category)`	把自己拷贝一个新的事物到指定的事物管理器的指定目录下。
`Thing`	`detach()`	克隆一个新事物，新的事物是瞬态的。
`Thing`	`detach(boolean detachToTransient)`	已过时。
`<T> T`	`doAction(String name)`	执行一个动作，把自己作为self变量放入动作上下文中。
`<T> T`	`doAction(String name, Map<String,Object> parameters)`	执行一个动作，把自己作为self变量放入动作上下文中，使用新的动作上下文和传入参数。
`<T> T`	`doAction(String name, ActionContext actionContext)`	执行一个动作，把自己作为self变量放入动作上下文中。
`<T> T`	`doAction(String name, ActionContext actionContext, Object... parameters)`
`<T> T`	`doAction(String name, ActionContext actionContext, Map<String,Object> parameters)`	执行一个动作，把自己作为self变量放入动作上下文中。
`<T> T`	`doAction(String name, ActionContext actionContext, Map<String,Object> parameters, boolean isSubAction)`	执行一个动作，把自己作为self变量放入动作上下文中。
`<T> T`	`doExec(String name, Object... params)`
`<T> T`	`doExec(String name, ActionContext context, Object... params)`
`void`	`endModify(boolean change)`
`<T> T`	`exec(String name, Object... params)`
`<T> T`	`exec(String name, ActionContext context, Object... params)`
`protected void`	`finalize()`
`Object`	`get(String path)`	通过路径获得事物的属性或者子事物，可返回属性值、子事物或者子事物列表。
`Object`	`get(Path path)`
`Action`	`getAction()`
`List<Thing>`	`getActionsThings()`
`Thing`	`getActionThing(String name)`	获得指定动作的事物定义。
`List<Thing>`	`getActionThings()`	返回本事物的所有的动作定义，包括自身定义的、描述者定义的和继承定义的。
`List<Thing>`	`getAllAttributesDescriptors()`	取本事物的所有描述者所定义属性描述列表。
`List<Thing>`	`getAllChilds()`	获得所有的直接第一级子事物，包括继承的事物的子事物。
`List<Thing>`	`getAllChilds(String thingName)`	根据描述者的名称来获取所有符合的子事物，包括继承的子事物。
`List<Thing>`	`getAllChildsDescriptors()`	获取子事物的描述者列表，返回本事物的所有描述者所定义的子事物的描述列表。
`List<Thing>`	`getAllDescriptors()`	返回本事物所有的描述者列表，包括描述者继承的事物。
`List<Thing>`	`getAllExtends()`	返回事物的所有继承事物列表，包括继承的继承...。
`Object`	`getAttribute(String name)`	获得属性值。
`Thing`	`getAttributeDescriptor(String name)`	根据指定的属性名称获取该属性的描述者。
`Map<String,Object>`	`getAttributes()`	获得属性集合。
`List<Thing>`	`getAttributesDescriptors()`	根获取事物属性描述列表，只返回第一个描述者的属性描述列表。
`BigDecimal`	`getBigDecimal(String name)`
`BigDecimal`	`getBigDecimal(String name, BigDecimal defaultValue)`
`BigDecimal`	`getBigDecimal(String name, BigDecimal defaultValue, ActionContext actionContext)`
`BigInteger`	`getBigInteger(String name)`
`BigInteger`	`getBigInteger(String name, BigInteger defaultValue)`
`BigInteger`	`getBigInteger(String name, BigInteger defaultValue, ActionContext actionContext)`
`boolean`	`getBoolean(String name)`
`boolean`	`getBoolean(String name, boolean defaultValue)`
`boolean`	`getBoolean(String name, boolean defaultValue, ActionContext actionContext)`
`byte`	`getByte(String name)`
`byte`	`getByte(String name, byte defaultValue)`
`byte`	`getByte(String name, byte defaultValue, ActionContext actionContext)`
`byte[]`	`getBytes(String name)`
`byte[]`	`getBytes(String name, byte[] defaultValue)`
`byte[]`	`getBytes(String name, byte[] defaultValue, ActionContext actionContext)`
`Object`	`getCachedData(String key)`	获取缓存的数据。
`Callable<Object>`	`getCallable(ActionContext actionContext)`	把当前事物转化为一个Callable。
`Callable<Object>`	`getCallable(ActionContext actionContext, Map<String,Object> params)`	把当前事物转化为一个Callable。
`char`	`getChar(String name)`
`char`	`getChar(String name, char defaultValue)`
`char`	`getChar(String name, char defaultValue, ActionContext actionContext)`
`Thing`	`getChildAt(int index)`	返回指定索引位置的子节点，如果超出范围返回null。
`Thing`	`getChildBy(Thing refChild, int index)`	获取参考子节点的相对位置的子节点，首先找到参考子节点的位置索引，然后和目标index相加获得最终的索引位置。
`List<Thing>`	`getChilds()`	返回本事物的直接子事物，不包含继承的子事物。
`List<Thing>`	`getChilds(String thingName)`	根据描述者的名称来获取所有符合的子事物，不包括继承的子事物。
`List<Thing>`	`getChildsDescriptors()`	获取子事物的描述者列表，只返回第一个描述者所定义的子事物的描述列表。
`Iterator<Thing>`	`getChildsIterator()`	返回遍历所有的子节点遍历器。
`List<Thing>`	`getClasses()`
`Thing`	`getClassThing()`
`Object`	`getData(String key)`
`Map<String,Object>`	`getDatas()`	返回保存Data数据的Map，有可能返回null，如果没有初始化（放过数据）。
`Date`	`getDate(String name)`
`Date`	`getDate(String name, Date defaultValue)`
`Date`	`getDate(String name, Date defaultValue, ActionContext actionContext)`
`Thing`	`getDescriptor()`	返回事物的主要的描述者。
`List<Thing>`	`getDescriptors()`	返回本事物定义的的所有描述者的列表。
`double`	`getDouble(String name)`
`double`	`getDouble(String name, double defaultValue)`
`double`	`getDouble(String name, double defaultValue, ActionContext actionContext)`
`List<Thing>`	`getExtends()`	返回本事物的继承事物列表。
`float`	`getFloat(String name)`
`float`	`getFloat(String name, float defaultValue)`
`float`	`getFloat(String name, float defaultValue, ActionContext actionContext)`
`int`	`getInt(String name)`
`int`	`getInt(String name, int defaultValue)`
`int`	`getInt(String name, int defaultValue, ActionContext actionContext)`
`long`	`getLong(String name)`
`long`	`getLong(String name, long defaultValue)`
`long`	`getLong(String name, long defaultValue, ActionContext actionContext)`
`ThingMetadata`	`getMetadata()`	获得本事物的元数据。
`<T> T`	`getObject(String key)`
`Object`	`getObject(String name, ActionContext actionContext)`	从事物中取指定的属性的字符串的值作为变量名，然后从ActionContext中取变量，支持var:或ognl:，默认相当于 var:。
`Thing`	`getParent()`	返回本事物的父事物。
`Thing`	`getQuotedThing(String attribute)`	返回属性所指向的引用的事物，如果不存在替换为根事物的路径当前的根事物开始寻找。
`Thing`	`getRoot()`	返回本事物的最根级（顶层）父事物，如果当前事物已经是根事物，那么返回自身。
`Runnable`	`getRunnable(ActionContext actionContext)`	把当前事物转化为一个Runnable。
`Runnable`	`getRunnable(ActionContext actionContext, Map<String,Object> params)`	把当前事物转化为一个Runnable。
`short`	`getShort(String name)`
`short`	`getShort(String name, short defaultValue)`
`short`	`getShort(String name, short defaultValue, ActionContext actionContext)`
`String`	`getString(String name)`
`String`	`getString(String name, String defaultValue)`
`String`	`getString(String name, String defaultValue, ActionContext actionContext)`	通过属性值从上下文中取字符串，通过UtilString获取字符串，如果返回null或空，那么返回defaultValue。
`String`	`getStringBlankAsNull(String name)`	获取字符串，trim()后的空字符串也返回null。
`Thing`	`getThing(String childThingPath)`	通过指定的子事物的路径获取一个子事物。
`String`	`getThingName()`	返回事物的事物名，相当于Java对象的类名。
`List<String>`	`getThingNames()`	返回事物的所有事物名。
`protected void`	`initChildMetadata(Thing child)`	初始化子事物的元数据。
`void`	`initChildPath()`	重新初始化所有子事物的路径。
`void`	`initDefaultValue()`	初始化事物属性的默认值。
`void`	`initDefaultValue(boolean forece)`	初始化事物属性的默认值。
`boolean`	`isThing(String descriptorPath)`	根据指定的描述者来判断该事物是否是这个指定描述者的所描述的事物。
`boolean`	`isThing(Thing descriptor)`	根据指定的描述者来判断该事物是否这个指定描述者所描述的事物。
`boolean`	`isThingByName(String descriptorName)`	根据描述者的名称返回当前事物是否是指定的事物，此判定方法并非严格。
`boolean`	`isTransient()`	返回本事物是否是瞬态的。
`void`	`parseXML(String xml)`
`void`	`paste(String data)`
`void`	`paste(Map<String,Object> data)`
`void`	`paste(Thing data)`
`Object`	`put(Object name, Object value)`	设置属性的值。
`void`	`putAll(Map<String,Object> values)`	放入Map的全部值，但不触发descriptor和extends的改变事件，同时也会更新日期。
`boolean`	`remove()`	删除调用自身的事物管理者删除自己，设置自身的状态为已删除。
`void`	`removeChild(int index)`
`void`	`removeChild(Thing child)`	删除指定的子事物。
`void`	`removeDescriptor(Thing descriptor)`	从本事物的描述者列表中移除指定的描述者。
`void`	`removeExtend(Thing extend)`	从本事物的继承列表中移除指定的继承事物。
`void`	`replace(Thing thing)`	使用新的事物来覆盖当前事物。
`<T> T`	`run(String name)`	执行一个动作，不把自己放入动作上下文中。
`<T> T`	`run(String name, Map<String,Object> parameters)`	执行一个动作，不把自己放入动作上下文中，使用新的动作上下文和传入的参数。
`<T> T`	`run(String name, ActionContext context)`	执行一个动作，不把自己放入动作上下文中。
`<T> T`	`run(String name, ActionContext context, Object[] parameters, boolean isSubAction, boolean includeSelf)`	按普通参数的方式执行。
`<T> T`	`run(String name, ActionContext context, Map<String,Object> parameters)`	执行一个动作，不把自己放入动作上下文中。
`<T> T`	`run(String name, ActionContext context, Map<String,Object> parameters, boolean isSubAction)`	执行一个动作，不把自己放入动作上下文中。
`<T> T`	`run(String name, ActionContext context, Map<String,Object> parameters, boolean isSubAction, boolean includeSelf)`	执行一个动作。
`boolean`	`save()`	保存自己，通常是调用事物所在的事物管理者来保存。
`void`	`saveAs(String thingManager, String path)`	把自己按照指定的路径保存到指定的目录下，如果目标事物存在那么会替换目标事物。
`void`	`set(Object name, Object value)`	设置属性。
`void`	`setCachedData(String key, Object data)`	设置缓存数据，如果事物在后面修改了，那么缓存失效。
`void`	`setData(String key, Object data)`
`void`	`setParent(Thing parent)`
`void`	`setTransient(boolean isTransient)`
`String`	`toString()`

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

- 字段详细资料
  - THING
```
public static final String THING
```
    事物的名字
    
    另请参阅:
    
    常量字段值
  - ATTRIBUTE
```
public static final String ATTRIBUTE
```
    属性的名字
    
    另请参阅:
    
    常量字段值
  - NAME
```
public static final String NAME
```
    名字的名字
    
    另请参阅:
    
    常量字段值
  - LABEL
```
public static final String LABEL
```
    标签的名字
    
    另请参阅:
    
    常量字段值
  - DESCRIPTORS
```
public static final String DESCRIPTORS
```
    描述者属性的名字
    
    另请参阅:
    
    常量字段值
  - EXTENDS
```
public static final String EXTENDS
```
    继承者属性的名字
    
    另请参阅:
    
    常量字段值
  - DESCRIPTION
```
public static final String DESCRIPTION
```
    描述属性的名字
    
    另请参阅:
    
    常量字段值
  - ORIGIN_THING_PATH
```
public static final String ORIGIN_THING_PATH
```
    原始事物的路径，尤其是在做detach时
    
    另请参阅:
    
    常量字段值
  - attributes
```
protected Map<String,Object> attributes
```
    事物的属性集合。
  - parent
```
protected Thing parent
```
    父事物，包含此事物的父事物。
  - metadata
```
protected ThingMetadata metadata
```
    事物的元数据，用于存放此事物在系统中的一些属性。
  - childs
```
protected List<Thing> childs
```
    子事物列表
  - thingNames
```
protected List<String> thingNames
```
    事物的名称（类名）的缓存列表
  - extendsCaches
```
protected ThingEntry[] extendsCaches
```
    继承列表的缓存
  - descriptorsCaches
```
protected ThingEntry[] descriptorsCaches
```
    描述者列表的缓存
  - actionCaches
```
protected Map<String,LinkedThingEntry> actionCaches
```
    动作事物的缓存
  - isTransient
```
protected boolean isTransient
```
    是否是瞬态的事物
  - action
```
protected Action action
```
    每一个事物都有动作的形态
  - datas
```
protected Map<String,Object> datas
```
    附加于事物的用户数据
- 构造器详细资料
  - Thing
```
public Thing()
```
    默认构造函数，构造一个空的瞬态事物。
  - Thing
```
public Thing(String descriptorPath)
```
    通过描述者的路径来构造一个瞬态事物。
    
    参数:
    
    descriptorPath - 描述者的路径
  - Thing
```
public Thing(String name,
             String label)
```
    通过名称和标签创建一个瞬态事物。
    
    参数:
    
    name - 事物的名称
    
    label - 事物的标签
  - Thing
```
public Thing(String name,
             String label,
             String descriptorPath)
```
    通过名称、标签和描述者的路径来构造一个瞬态事物。
    
    参数:
    
    name - 事物的名称
    
    label - 事物的标签
    
    descriptorPath - 事物的路径
  - Thing
```
public Thing(String name,
             String label,
             String descriptorPath,
             boolean isTransient)
```
    指定名称、标签、描述者和是否是瞬态的来构造一个事物。非瞬态的事物一般有事物管理者创建。
    
    参数:
    
    name - 事物的名称
    
    label - 事物的标签
    
    descriptorPath - 事物的描述者
    
    isTransient - 是否是瞬态的
- 方法详细资料
  - addChild
```
public void addChild(String xml)
              throws ParserConfigurationException,
                     SAXException,
                     IOException
```
    抛出:
    
    ParserConfigurationException
    
    SAXException
    
    IOException
  - addChild
```
public void addChild(Thing childThing)
```
    添加一个子事物。
    
    参数:
    
    childThing - 子事物
  - addChild
```
public void addChild(Thing childThing,
                     int index)
```
  - addChild
```
public void addChild(Thing childThing,
                     boolean changeParen)
```
  - addChild
```
public void addChild(Thing childThing,
                     int index,
                     boolean changeParent)
```
    在指定的索引位置添加一个子事物。如果指定索引不存在，那么尽量添加在最后面。
    
    参数:
    
    childThing - 子事物
    
    index - 位置索引
    
    changeParent - 是否改变子事物的父事物为本事物
  - addDescriptor
```
public void addDescriptor(int index,
                          Thing descriptor)
```
    在指定位置添加一个描述者。
    如果描述者已经存在且位置不同，那么会切换到新的位置，如果index为-1那么添加至结尾。
    
    参数:
    
    index - 描述者的位置
    
    descriptor - 描述者
  - addDescritpor
```
public void addDescritpor(int index,
                          String descriptorPath)
```
    通过描述者的路径加入描述者，可以加入多个，中间使用','号隔开。
    
    参数:
    
    index - 位置索引
    
    descriptorPath - 描述者的路径
  - addExtend
```
public void addExtend(int index,
                      Thing extendThing)
```
    在指定位置添加一个继承事物。
    如果继承已经存在且位置不同，那么会切换到新的位置，如果index为-1那么添加至结尾。
    
    参数:
    
    extendThing - 要继承的事物
    
    index - 参数位置
  - changeChildIndex
```
public void changeChildIndex(Thing child,
                             int index,
                             int moveStep)
```
    改变一个子事物的位置索引。
    
    参数:
    
    child - 子事物
    
    index - 要移动的位置，如果为-1，那么通过moveStep来上移或下移
    
    moveStep - 小于0表示上移，大于0表示下移，步伐为其绝对值
  - cognize
```
public void cognize(Map<String,Object> adata)
```
    从一个Map数据认知并把认知结果保存到自身。
    
    参数:
    
    adata - 一个Map数据
  - cognize
```
public void cognize(String xmlData)
             throws ParserConfigurationException,
                    SAXException,
                    IOException
```
    从一个XML数据认知并把认知结果保存到自身。
    
    参数:
    
    xmlData - 一个XML数据（字符串）
    
    抛出:
    
    IOException - IO异常
    
    SAXException - SAX异常
    
    ParserConfigurationException - 分析异常
  - cognize
```
public void cognize(Thing thing)
```
    认知另一事物并把认知结果作为自己的一部分。
    认识另一事物和认识非事物的对象的区别是，认识其他事物是把另一事物的所有内容保存到自身，而认识非事物物时是根据自身的描述者所描述的属性和子事物去从认知对象上取值的。
    
    参数:
    
    thing - 另一事物
  - paste
```
public void paste(Map<String,Object> data)
```
  - paste
```
public void paste(String data)
           throws ParserConfigurationException,
                  SAXException,
                  IOException
```
    抛出:
    
    ParserConfigurationException
    
    SAXException
    
    IOException
  - parseXML
```
public void parseXML(String xml)
              throws ParserConfigurationException,
                     SAXException,
                     IOException
```
    抛出:
    
    ParserConfigurationException
    
    SAXException
    
    IOException
  - paste
```
public void paste(Thing data)
```
  - detach
```
public Thing detach()
```
    克隆一个新事物，新的事物是瞬态的。不会克隆事物的继承和描述，仅仅是克隆事物本身。
    
    返回:
    
    克隆的新事物
  - detach
```
public Thing detach(boolean detachToTransient)
```
    已过时。
    
    使用detach()。
    
    参数:
    
    detachToTransient - 是否detach到瞬态
    
    返回:
    
    事物
  - doAction
```
public <T> T doAction(String name)
```
    执行一个动作，把自己作为self变量放入动作上下文中。
    
    参数:
    
    name - 动作名称
    
    返回:
    
    执行后的返回结果
  - doAction
```
public <T> T doAction(String name,
                      Map<String,Object> parameters)
```
    执行一个动作，把自己作为self变量放入动作上下文中，使用新的动作上下文和传入参数。
    
    参数:
    
    name - 动作名
    
    parameters - 参数
    
    返回:
    
    执行结果
  - doAction
```
public <T> T doAction(String name,
                      ActionContext actionContext)
```
    执行一个动作，把自己作为self变量放入动作上下文中。
    
    参数:
    
    name - 动作名称
    
    actionContext - 变量容器
    
    返回:
    
    执行后的返回结果
  - doAction
```
public <T> T doAction(String name,
                      ActionContext actionContext,
                      Map<String,Object> parameters)
```
    执行一个动作，把自己作为self变量放入动作上下文中。
    
    参数:
    
    name - 动作名称
    
    actionContext - 变量容器
    
    parameters - 参数
    
    返回:
    
    执行后的返回结果
  - doAction
```
public <T> T doAction(String name,
                      ActionContext actionContext,
                      Object... parameters)
```
  - doAction
```
public <T> T doAction(String name,
                      ActionContext actionContext,
                      Map<String,Object> parameters,
                      boolean isSubAction)
```
    执行一个动作，把自己作为self变量放入动作上下文中。
    
    参数:
    
    name - 动作名
    
    actionContext - 变量上下文
    
    parameters - 参数
    
    isSubAction - 是否是子动作
    
    返回:
    
    执行结果
  - run
```
public <T> T run(String name,
                 ActionContext context,
                 Map<String,Object> parameters,
                 boolean isSubAction,
                 boolean includeSelf)
```
    执行一个动作。
    
    参数:
    
    name - 动作名
    
    context - 变量上下文
    
    parameters - 参数
    
    isSubAction - 是否是子动作
    
    includeSelf - 是否包含自己
    
    返回:
    
    执行结果
  - exec
```
public <T> T exec(String name,
                  ActionContext context,
                  Object... params)
```
  - exec
```
public <T> T exec(String name,
                  Object... params)
```
  - doExec
```
public <T> T doExec(String name,
                    ActionContext context,
                    Object... params)
```
  - doExec
```
public <T> T doExec(String name,
                    Object... params)
```
  - run
```
public <T> T run(String name,
                 ActionContext context,
                 Object[] parameters,
                 boolean isSubAction,
                 boolean includeSelf)
```
    按普通参数的方式执行。
    
    参数:
    
    name - 动作名
    
    context - 变量上下文
    
    parameters - 参数列表
    
    isSubAction - 是否是子动作
    
    includeSelf - 是否包含自己
    
    返回:
    
    执行结果
  - run
```
public <T> T run(String name,
                 ActionContext context,
                 Map<String,Object> parameters,
                 boolean isSubAction)
```
    执行一个动作，不把自己放入动作上下文中。
    
    参数:
    
    name - 动作名
    
    context - 变量上下文
    
    parameters - 参数
    
    isSubAction - 是否是子动作
    
    返回:
    
    执行结果
  - run
```
public <T> T run(String name,
                 ActionContext context,
                 Map<String,Object> parameters)
```
    执行一个动作，不把自己放入动作上下文中。
    
    参数:
    
    name - 动作名
    
    context - 变量上下文
    
    parameters - 参数
    
    返回:
    
    执行结果
  - run
```
public <T> T run(String name,
                 ActionContext context)
```
    执行一个动作，不把自己放入动作上下文中。
    
    参数:
    
    name - 动作名
    
    context - 变量上下文
    
    返回:
    
    执行结果
  - run
```
public <T> T run(String name,
                 Map<String,Object> parameters)
```
    执行一个动作，不把自己放入动作上下文中，使用新的动作上下文和传入的参数。
    
    参数:
    
    name - 动作名
    
    parameters - 参数
    
    返回:
    
    执行结果
  - run
```
public <T> T run(String name)
```
    执行一个动作，不把自己放入动作上下文中。
    
    参数:
    
    name - 动作名
    
    返回:
    
    执行结果
  - get
```
public Object get(Path path)
```
  - get
```
public Object get(String path)
```
    通过路径获得事物的属性或者子事物，可返回属性值、子事物或者子事物列表。
    路径遵从事物的路径规则。
    
    参数:
    
    path - 路径
    
    返回:
    
    路径对应的对象，找不到返回null
  - getActionThing
```
public Thing getActionThing(String name)
```
    获得指定动作的事物定义。
    搜寻事物动作的规则是：如果不是super的动作，那么先搜寻事物本身定义的动作。依次搜寻描述者和描述者的继承定义的动作。依次搜索事物的描述者的继承者定义的动作。
    
    参数:
    
    name - 动作名称
    
    返回:
    
    动作事物，如果不存在返回null
  - getAction
```
public Action getAction()
```
  - getRunnable
```
public Runnable getRunnable(ActionContext actionContext)
```
    把当前事物转化为一个Runnable。
    
    参数:
    
    actionContext - 变量上下文
    
    返回:
    
    runnable
  - getRunnable
```
public Runnable getRunnable(ActionContext actionContext,
                            Map<String,Object> params)
```
    把当前事物转化为一个Runnable。
    
    参数:
    
    actionContext - 变量上下文
    
    params - 参数
    
    返回:
    
    runnable
  - getCallable
```
public Callable<Object> getCallable(ActionContext actionContext)
```
    把当前事物转化为一个Callable。
    
    参数:
    
    actionContext - 变量上下文
    
    返回:
    
    callable
  - getCallable
```
public Callable<Object> getCallable(ActionContext actionContext,
                                    Map<String,Object> params)
```
    把当前事物转化为一个Callable。
    
    参数:
    
    actionContext - 变量上下文
    
    params - 参数
    
    返回:
    
    callable
  - getActionsThings
```
public List<Thing> getActionsThings()
```
  - getActionThings
```
public List<Thing> getActionThings()
```
    返回本事物的所有的动作定义，包括自身定义的、描述者定义的和继承定义的。
    
    返回:
    
    动作定义列表
  - getAllAttributesDescriptors
```
public List<Thing> getAllAttributesDescriptors()
```
    取本事物的所有描述者所定义属性描述列表。
    
    返回:
    
    属性描述列表
  - getAllChilds
```
public List<Thing> getAllChilds()
```
    获得所有的直接第一级子事物，包括继承的事物的子事物。
    
    返回:
    
    所有的子事物
  - getAllChilds
```
public List<Thing> getAllChilds(String thingName)
```
    根据描述者的名称来获取所有符合的子事物，包括继承的子事物。
    注：这里是描述者的名，不是描述者的路径。
    
    参数:
    
    thingName - 描述者的名称
    
    返回:
    
    描述者的名称为指定名称的子事物
  - getAllChildsDescriptors
```
public List<Thing> getAllChildsDescriptors()
```
    获取子事物的描述者列表，返回本事物的所有描述者所定义的子事物的描述列表。
    
    返回:
    
    描述者列表
  - getAllExtends
```
public List<Thing> getAllExtends()
```
    返回事物的所有继承事物列表，包括继承的继承...。
    
    返回:
    
    所有继承的事物列表
  - getAttribute
```
public Object getAttribute(String name)
```
    获得属性值。
    
    参数:
    
    name - 属性名称
    
    返回:
    
    属性的值。
  - getAttributeDescriptor
```
public Thing getAttributeDescriptor(String name)
```
    根据指定的属性名称获取该属性的描述者。
    
    参数:
    
    name - 属性名称
    
    返回:
    
    属性的描述者
  - getAttributes
```
public Map<String,Object> getAttributes()
```
    获得属性集合。
    
    返回:
    
    属性集合
  - getAttributesDescriptors
```
public List<Thing> getAttributesDescriptors()
```
    根获取事物属性描述列表，只返回第一个描述者的属性描述列表。
    
    返回:
    
    事物的属性描述列表
  - getBigDecimal
```
public BigDecimal getBigDecimal(String name)
```
  - getBigDecimal
```
public BigDecimal getBigDecimal(String name,
                                BigDecimal defaultValue)
```
  - getBigDecimal
```
public BigDecimal getBigDecimal(String name,
                                BigDecimal defaultValue,
                                ActionContext actionContext)
                         throws ognl.OgnlException
```
    抛出:
    
    ognl.OgnlException
  - getBigInteger
```
public BigInteger getBigInteger(String name)
```
  - getBigInteger
```
public BigInteger getBigInteger(String name,
                                BigInteger defaultValue)
```
  - getBigInteger
```
public BigInteger getBigInteger(String name,
                                BigInteger defaultValue,
                                ActionContext actionContext)
                         throws ognl.OgnlException
```
    抛出:
    
    ognl.OgnlException
  - getBoolean
```
public boolean getBoolean(String name)
```
  - getBoolean
```
public boolean getBoolean(String name,
                          boolean defaultValue)
```
  - getBoolean
```
public boolean getBoolean(String name,
                          boolean defaultValue,
                          ActionContext actionContext)
                   throws ognl.OgnlException
```
    抛出:
    
    ognl.OgnlException
  - getByte
```
public byte getByte(String name)
```
  - getByte
```
public byte getByte(String name,
                    byte defaultValue)
```
  - getByte
```
public byte getByte(String name,
                    byte defaultValue,
                    ActionContext actionContext)
             throws ognl.OgnlException
```
    抛出:
    
    ognl.OgnlException
  - getBytes
```
public byte[] getBytes(String name)
```
  - getBytes
```
public byte[] getBytes(String name,
                       byte[] defaultValue)
```
  - getBytes
```
public byte[] getBytes(String name,
                       byte[] defaultValue,
                       ActionContext actionContext)
                throws ognl.OgnlException
```
    抛出:
    
    ognl.OgnlException
  - getChar
```
public char getChar(String name)
```
  - getChar
```
public char getChar(String name,
                    char defaultValue)
```
  - getChar
```
public char getChar(String name,
                    char defaultValue,
                    ActionContext actionContext)
             throws ognl.OgnlException
```
    抛出:
    
    ognl.OgnlException
  - getChilds
```
public List<Thing> getChilds()
```
    返回本事物的直接子事物，不包含继承的子事物。
    
    返回:
    
    本事物的直接子事物
  - getChilds
```
public List<Thing> getChilds(String thingName)
```
    根据描述者的名称来获取所有符合的子事物，不包括继承的子事物。
    
    参数:
    
    thingName - 描述者的名称
    
    返回:
    
    描述者的名称为指定名称的子事物
  - getChildsDescriptors
```
public List<Thing> getChildsDescriptors()
```
    获取子事物的描述者列表，只返回第一个描述者所定义的子事物的描述列表。
    
    返回:
    
    子事物的描述者列表
  - getDate
```
public Date getDate(String name)
```
  - getDate
```
public Date getDate(String name,
                    Date defaultValue)
```
  - getDate
```
public Date getDate(String name,
                    Date defaultValue,
                    ActionContext actionContext)
             throws ognl.OgnlException
```
    抛出:
    
    ognl.OgnlException
  - getClassThing
```
public Thing getClassThing()
```
  - getClasses
```
public List<Thing> getClasses()
```
  - getDescriptor
```
public Thing getDescriptor()
```
    返回事物的主要的描述者。
    
    返回:
    
    第一个描述者
  - getDescriptors
```
public List<Thing> getDescriptors()
```
    返回本事物定义的的所有描述者的列表。
    
    一个事物的描述者列表是在属性descriptors里定义的，如果有多个那么之间用,号隔开。另外元事物是所有的事物的基本描述，一般在描述者列表中元事物被放到了列表的末端
    
    如果事物的一个描述者继承了其他事物，那么继承的其他事物也是这个事物的描述者，这样的描述者在此方法里不能获得，如想取得事物的所有包含描述者继承的描述者，那么可以是用getAllDescriptors()方法。
    
    返回:
    
    本事物的所有描述者的列表
    
    另请参阅:
    
    getAllDescriptors()
  - getAllDescriptors
```
public List<Thing> getAllDescriptors()
```
    返回本事物所有的描述者列表，包括描述者继承的事物。
    与getDescriptors方法不同的是getDescriptors方法只返回自身定义的描述者的列表。
    
    返回:
    
    包含描述者继承的事物所有的描述者列表
    
    另请参阅:
    
    getDescriptors()
  - getDouble
```
public double getDouble(String name)
```
  - getDouble
```
public double getDouble(String name,
                        double defaultValue)
```
  - getDouble
```
public double getDouble(String name,
                        double defaultValue,
                        ActionContext actionContext)
                 throws ognl.OgnlException
```
    抛出:
    
    ognl.OgnlException
  - getExtends
```
public List<Thing> getExtends()
```
    返回本事物的继承事物列表。
    
    返回:
    
    继承事物列表
  - getFloat
```
public float getFloat(String name)
```
  - getFloat
```
public float getFloat(String name,
                      float defaultValue)
```
  - getFloat
```
public float getFloat(String name,
                      float defaultValue,
                      ActionContext actionContext)
               throws ognl.OgnlException
```
    抛出:
    
    ognl.OgnlException
  - getInt
```
public int getInt(String name)
```
  - getInt
```
public int getInt(String name,
                  int defaultValue)
```
  - getInt
```
public int getInt(String name,
                  int defaultValue,
                  ActionContext actionContext)
           throws ognl.OgnlException
```
    抛出:
    
    ognl.OgnlException
  - getObject
```
public Object getObject(String name,
                        ActionContext actionContext)
                 throws ognl.OgnlException
```
    从事物中取指定的属性的字符串的值作为变量名，然后从ActionContext中取变量，支持var:或ognl:，默认相当于 var:。
    
    参数:
    
    name - 属性名
    
    actionContext - 变量上下文
    
    返回:
    
    值
    
    抛出:
    
    ognl.OgnlException - 异常
  - getLong
```
public long getLong(String name)
```
  - getLong
```
public long getLong(String name,
                    long defaultValue)
```
  - getLong
```
public long getLong(String name,
                    long defaultValue,
                    ActionContext actionContext)
             throws ognl.OgnlException
```
    抛出:
    
    ognl.OgnlException
  - getMetadata
```
public ThingMetadata getMetadata()
```
    获得本事物的元数据。
    
    返回:
    
    当前事物的元数据
  - getParent
```
public Thing getParent()
```
    返回本事物的父事物。
    
    返回:
    
    父事物，如果没有返回null
  - getRoot
```
public Thing getRoot()
```
    返回本事物的最根级（顶层）父事物，如果当前事物已经是根事物，那么返回自身。
    
    返回:
    
    根父事物
  - getShort
```
public short getShort(String name)
```
  - getShort
```
public short getShort(String name,
                      short defaultValue)
```
  - getShort
```
public short getShort(String name,
                      short defaultValue,
                      ActionContext actionContext)
               throws ognl.OgnlException
```
    抛出:
    
    ognl.OgnlException
  - getString
```
public String getString(String name)
```
  - getStringBlankAsNull
```
public String getStringBlankAsNull(String name)
```
    获取字符串，trim()后的空字符串也返回null。
    
    参数:
    
    name - 属性名
    
    返回:
    
    结果
  - getString
```
public String getString(String name,
                        String defaultValue)
```
  - getString
```
public String getString(String name,
                        String defaultValue,
                        ActionContext actionContext)
```
    通过属性值从上下文中取字符串，通过UtilString获取字符串，如果返回null或空，那么返回defaultValue。
    
    参数:
    
    name - 属性名
    
    defaultValue - 默认值
    
    actionContext - 变量上下文
    
    返回:
    
    值
  - getThing
```
public Thing getThing(String childThingPath)
```
    通过指定的子事物的路径获取一个子事物。
    
    参数:
    
    childThingPath - 子事物的路径
    
    返回:
    
    子事物
  - getQuotedThing
```
public Thing getQuotedThing(String attribute)
```
    返回属性所指向的引用的事物，如果不存在替换为根事物的路径当前的根事物开始寻找。有的时候一个属性的值是一个所引用的事物的路径，由于模型引擎总是使用全路径，这样如果引用时本事物根事物的某个字事物，并且根事物拷贝到了其它目录下或改名了，那么这个引用就会失效。通过使用此方法可以避免这个问题，并且属性的值会重设，如果引用的事物同属一个根事物的话。
    
    参数:
    
    attribute - 属性名称
    
    返回:
    
    所引用的事物
  - getThingName
```
public String getThingName()
```
    返回事物的事物名，相当于Java对象的类名。
    
    返回:
    
    事物名
  - getThingNames
```
public List<String> getThingNames()
```
    返回事物的所有事物名。
    
    返回:
    
    事物名
  - initDefaultValue
```
public void initDefaultValue()
```
    初始化事物属性的默认值。
  - initDefaultValue
```
public void initDefaultValue(boolean forece)
```
    初始化事物属性的默认值。
    
    参数:
    
    forece - 如果为ture，那么即使事物的属性已经设置过了，也会被默认值代替，如果描述者设置了默认值。
  - initChildPath
```
public void initChildPath()
```
    重新初始化所有子事物的路径。
  - initChildMetadata
```
protected void initChildMetadata(Thing child)
```
    初始化子事物的元数据。
    
    参数:
    
    child - 子事物
  - isThing
```
public boolean isThing(String descriptorPath)
```
    根据指定的描述者来判断该事物是否是这个指定描述者的所描述的事物。类似Java的instanceof的作用。
    
    参数:
    
    descriptorPath - 描述者的路径
    
    返回:
    
    是否是描述者所描述的事物
  - isThing
```
public boolean isThing(Thing descriptor)
```
    根据指定的描述者来判断该事物是否这个指定描述者所描述的事物。类似Java的instanceof的作用。
    
    参数:
    
    descriptor - 描述者
    
    返回:
    
    是否这个描述者所描述的事物
  - isThingByName
```
public boolean isThingByName(String descriptorName)
```
    根据描述者的名称返回当前事物是否是指定的事物，此判定方法并非严格。类似Java的instanceof的作用。
    
    参数:
    
    descriptorName - 描述者的名称
    
    返回:
    
    是否是该事物
  - replace
```
public void replace(Thing thing)
```
    使用新的事物来覆盖当前事物。
    
    参数:
    
    thing -
  - isTransient
```
public boolean isTransient()
```
    返回本事物是否是瞬态的。
    
    返回:
    
    是否是瞬态的
  - getChildsIterator
```
public Iterator<Thing> getChildsIterator()
```
    返回遍历所有的子节点遍历器。
    
    返回:
    
    子节点遍历器
  - put
```
public Object put(Object name,
                  Object value)
```
    设置属性的值。
    
    参数:
    
    name - 属性名称
    
    value - 属性的值
    
    返回:
    
    值
  - putAll
```
public void putAll(Map<String,Object> values)
```
    放入Map的全部值，但不触发descriptor和extends的改变事件，同时也会更新日期。
    
    参数:
    
    values - 值
  - set
```
public void set(Object name,
                Object value)
```
    设置属性。
    
    参数:
    
    name - 属性名
    
    value - 值
  - setParent
```
public void setParent(Thing parent)
```
  - removeDescriptor
```
public void removeDescriptor(Thing descriptor)
```
    从本事物的描述者列表中移除指定的描述者。
    
    参数:
    
    descriptor - 描述者
  - removeChild
```
public void removeChild(Thing child)
```
    删除指定的子事物。
    
    参数:
    
    child - 要删除的子事物
  - removeChild
```
public void removeChild(int index)
```
  - remove
```
public boolean remove()
```
    删除调用自身的事物管理者删除自己，设置自身的状态为已删除。
    
    返回:
    
    是否成功
  - finalize
```
protected void finalize()
                 throws Throwable
```
    覆盖:
    
    finalize 在类中 Object
    
    抛出:
    
    Throwable
  - removeExtend
```
public void removeExtend(Thing extend)
```
    从本事物的继承列表中移除指定的继承事物。
    
    参数:
    
    extend - 继承的事物
  - save
```
public boolean save()
```
    保存自己，通常是调用事物所在的事物管理者来保存。
    
    返回:
    
    是否成功
  - saveAs
```
public void saveAs(String thingManager,
                   String path)
```
    把自己按照指定的路径保存到指定的目录下，如果目标事物存在那么会替换目标事物。
    
    参数:
    
    thingManager - 事物管理器
    
    path - 事物路径
  - copyTo
```
public Thing copyTo(String thingManager,
                    String category)
```
    把自己拷贝一个新的事物到指定的事物管理器的指定目录下。
    
    参数:
    
    thingManager - 事物管理器
    
    category - 目录
    
    返回:
    
    事物
  - beginModify
```
public void beginModify()
```
    beginBigModifiy必须和endBigModify成对出现。
  - endModify
```
public void endModify(boolean change)
```
  - toString
```
public String toString()
```
    覆盖:
    
    toString 在类中 Object
  - setData
```
public void setData(String key,
                    Object data)
```
  - getData
```
public Object getData(String key)
```
  - getDatas
```
public Map<String,Object> getDatas()
```
    返回保存Data数据的Map，有可能返回null，如果没有初始化（放过数据）。
    
    返回:
    
    保存的值
  - setCachedData
```
public void setCachedData(String key,
                          Object data)
```
    设置缓存数据，如果事物在后面修改了，那么缓存失效。
    
    参数:
    
    key - key
    
    data - 数据
  - getCachedData
```
public Object getCachedData(String key)
```
    获取缓存的数据。
    
    参数:
    
    key - 键
    
    返回:
    
    值
  - setTransient
```
public void setTransient(boolean isTransient)
```
  - getObject
```
public <T> T getObject(String key)
```
  - getChildAt
```
public Thing getChildAt(int index)
```
    返回指定索引位置的子节点，如果超出范围返回null。
    
    参数:
    
    index -
    
    返回:
    
    如果超出子节点的范围，返回null，否则返回对应的子节点。
  - getChildBy
```
public Thing getChildBy(Thing refChild,
                        int index)
```
    获取参考子节点的相对位置的子节点，首先找到参考子节点的位置索引，然后和目标index相加获得最终的索引位置。所以如果index小于0，是指获取参考节点的索引更小的子节点，如果index大于0，则是获取后面的节点。
    
    参数:
    
    refChild -
    
    index -
    
    返回:
    
    如果超出子节点的范围或参考子节点不是当前事物的子节点返回null，否则返回对应的子节点。

类 Thing

字段概要

构造器概要

方法概要

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

字段详细资料

THING

ATTRIBUTE

NAME

LABEL

DESCRIPTORS

EXTENDS

DESCRIPTION

ORIGIN_THING_PATH

attributes

parent

metadata

childs

thingNames

extendsCaches

descriptorsCaches

actionCaches

isTransient

action

datas

构造器详细资料

Thing

Thing

Thing

Thing

Thing

方法详细资料

addChild

addChild

addChild

addChild

addChild

addDescriptor

addDescritpor

addExtend

changeChildIndex

cognize

cognize

cognize

paste

paste

parseXML

paste

detach

detach

doAction

doAction

doAction

doAction

doAction

doAction

run

exec

exec

doExec

doExec

run

run

run

run

run

run

get

get

getActionThing

getAction

getRunnable

getRunnable

getCallable

getCallable

getActionsThings

getActionThings

getAllAttributesDescriptors

getAllChilds

getAllChilds