ThingManager (x-meta 1.4.3 API)

所有已知实现类:

AbstractThingManager, ClassThingManager, FileThingManager, JarThingManager, JdbcThingManager, RedisThingManager, TransientThingManager
```
public interface ThingManager
```
事物管理者是对事物的二级分类，一个事物管理者一般具体提供了如何按照某种格式保存和读取事物，事物管理者包含目录和事物。

作者:

zyx

方法概要

所有方法实例方法抽象方法
修饰符和类型	方法	说明
`void`	`addThingManagerListener(ThingManagerListener listener)`	添加事物管理者事件。
`void`	`clearCache()`	清空缓存。
`boolean`	`createCategory(String categoryName)`	创建新的目录。
`URL`	`findResource(String name)`	查找资源。
`Category`	`getCategory(String name)`	通过指定的目录名称获取目录。
`List<Category>`	`getCategorys()`	返回事物管理者定义的根目录列表。
`ThingClassLoader`	`getClassLoader()`	返回事物管理器的类装载器。
`String`	`getClassPath()`	获取事物管理器所依赖的类库的路径。
`String`	`getName()`	获得事物管理者的名称。
`InputStream`	`getResourceAsStream(String name)`	获取资源当作输入流，如果没有返回null。
`File`	`getRootDir()`	返回项目所在的根目录。
`Thing`	`getThing(String thingName)`	通过事物的名称取得事物。
`List<ThingIndex>`	`getThingIndexs(String categoryName)`	返回指定目录下的事物索引列表。
`List<ThingIndex>`	`getThingIndexs(String categoryName, String descriptorPath)`	根据描述者获取指定目录下的事物索引列表。
`List<Thing>`	`getThings(String categoryName)`	取得指定目录下的事物列表。
`List<Thing>`	`getThings(String categoryName, String descriptorPath)`	根据事物描述者取得指定目录下的事物列表。
`void`	`init(Properties properties)`	初始化事物管理器。
`boolean`	`isSaveable()`	事物是否是可以保存的，如果不能保存，那么即使事物在内存中改变了，也不能同步到存储上。
`Iterator<Thing>`	`iterator(String categoryName, boolean includeChildCategory)`	指定目录遍历该目录下的事物。
`Iterator<Thing>`	`iterator(String categoryName, String descriptorPath, boolean includeChildCategory)`	指定事物的描述者遍历指定目录下的事物。
`void`	`refresh()`	刷新事物管理者。
`void`	`refresh(String categoryName, boolean includeChildCategory)`	刷新指定目录。
`boolean`	`remove()`	删除此事物管理者，在此方法里实现清除此事物管理者的相关内容。
`boolean`	`remove(Thing thing)`	从事物管理者中移除一个事物。
`boolean`	`removeCategory(String categoryName)`	删除一个目录。
`boolean`	`removeThingManagerListener(ThingManagerListener listener)`	删除事物管理者的监听事件。
`boolean`	`save(Thing athing)`	保存一个事物。
`void`	`setName(String name)`	设置事物管理器的名称。
`void`	`setRootDir(File root)`	设置项目的所在根目录。

- 方法详细资料
  - addThingManagerListener
```
void addThingManagerListener(ThingManagerListener listener)
```
    添加事物管理者事件。
    
    参数:
    
    listener - 事物管理者的事件
  - clearCache
```
void clearCache()
```
    清空缓存。
  - createCategory
```
boolean createCategory(String categoryName)
```
    创建新的目录。
    
    参数:
    
    categoryName - 目录名称
    
    返回:
    
    已创建或已存在的目录
  - getCategory
```
Category getCategory(String name)
```
    通过指定的目录名称获取目录。
    
    参数:
    
    name - 目录的名称
    
    返回:
    
    目录，如果不存在返回null
  - getCategorys
```
List<Category> getCategorys()
```
    返回事物管理者定义的根目录列表。
    
    返回:
    
    事物管理者的所有目录
  - getName
```
String getName()
```
    获得事物管理者的名称。
    
    返回:
    
    事物管理者的名称
  - setName
```
void setName(String name)
```
    设置事物管理器的名称。
    
    参数:
    
    name - 事物管理器的名称
  - getThing
```
Thing getThing(String thingName)
```
    通过事物的名称取得事物。比方法一般是World调用的，应用中取事物请通过World，World负责缓存。
    
    参数:
    
    thingName - 事物的名称，此名称为全名（包含目录）
    
    返回:
    
    事物
  - getThingIndexs
```
List<ThingIndex> getThingIndexs(String categoryName)
```
    返回指定目录下的事物索引列表。
    
    参数:
    
    categoryName - 目录名称
    
    返回:
    
    目录索引列表
  - getThingIndexs
```
List<ThingIndex> getThingIndexs(String categoryName,
                                String descriptorPath)
```
    根据描述者获取指定目录下的事物索引列表。
    
    参数:
    
    categoryName - 目录名称
    
    descriptorPath - 描述者路径
    
    返回:
    
    目录索引列表
  - getThings
```
List<Thing> getThings(String categoryName)
```
    取得指定目录下的事物列表。
    
    参数:
    
    categoryName - 目录名称
    
    返回:
    
    事物列表
  - getThings
```
List<Thing> getThings(String categoryName,
                      String descriptorPath)
```
    根据事物描述者取得指定目录下的事物列表。
    
    参数:
    
    categoryName - 目录名称
    
    descriptorPath - 事物描述者的路径
    
    返回:
    
    事物列表
  - iterator
```
Iterator<Thing> iterator(String categoryName,
                         boolean includeChildCategory)
```
    　指定目录遍历该目录下的事物。
    
    参数:
    
    categoryName - 目录名称
    
    includeChildCategory - 是否包含子目录
    
    返回:
    
    事物遍历器
  - iterator
```
Iterator<Thing> iterator(String categoryName,
                         String descriptorPath,
                         boolean includeChildCategory)
```
    指定事物的描述者遍历指定目录下的事物。
    
    参数:
    
    categoryName - 目录名称
    
    descriptorPath - 描述者的路径
    
    includeChildCategory - 是否包含子目录
    
    返回:
    
    事物遍历器
  - refresh
```
void refresh()
```
    刷新事物管理者。
  - refresh
```
void refresh(String categoryName,
             boolean includeChildCategory)
```
    刷新指定目录。
    
    参数:
    
    categoryName - 目录
    
    includeChildCategory - 是否包含子目录
  - remove
```
boolean remove()
```
    删除此事物管理者，在此方法里实现清除此事物管理者的相关内容。
    
    返回:
    
    是否成功
  - remove
```
boolean remove(Thing thing)
```
    从事物管理者中移除一个事物。
    
    参数:
    
    thing - 要移除的事物
    
    返回:
    
    已经被移除的事物，如果没有则返回null
  - removeCategory
```
boolean removeCategory(String categoryName)
```
    删除一个目录。
    
    参数:
    
    categoryName - 目录名称
    
    返回:
    
    是否删除成功
  - removeThingManagerListener
```
boolean removeThingManagerListener(ThingManagerListener listener)
```
    删除事物管理者的监听事件。
    
    参数:
    
    listener - 事物管理者监听事件
    
    返回:
    
    是否成功
  - save
```
boolean save(Thing athing)
```
    保存一个事物。
    
    参数:
    
    athing - 要保存的事物
    
    返回:
    
    如果保存成功那么返回该事物的根父事物，否则返回null
  - isSaveable
```
boolean isSaveable()
```
    事物是否是可以保存的，如果不能保存，那么即使事物在内存中改变了，也不能同步到存储上。
    
    返回:
  - getClassLoader
```
ThingClassLoader getClassLoader()
```
    返回事物管理器的类装载器。
    
    返回:
    
    类装载器
  - getClassPath
```
String getClassPath()
```
    获取事物管理器所依赖的类库的路径。
    
    返回:
    
    类路径
  - getResourceAsStream
```
InputStream getResourceAsStream(String name)
```
    获取资源当作输入流，如果没有返回null。
    
    参数:
    
    name - 资源名
    
    返回:
    
    资源输入流
  - findResource
```
URL findResource(String name)
```
    查找资源。
    
    参数:
    
    name - 资源名
    
    返回:
    
    资源URL
  - init
```
void init(Properties properties)
```
    初始化事物管理器。
    
    参数:
    
    properties - 参数
  - setRootDir
```
void setRootDir(File root)
```
    设置项目的所在根目录。
    
    参数:
    
    root -
  - getRootDir
```
File getRootDir()
```
    返回项目所在的根目录。
    
    返回:

接口 ThingManager

方法概要

方法详细资料

addThingManagerListener

clearCache

createCategory

getCategory

getCategorys

getName

setName

getThing

getThingIndexs

getThingIndexs

getThings

getThings

iterator

iterator

refresh

refresh

remove

remove

removeCategory

removeThingManagerListener

save

isSaveable

getClassLoader

getClassPath

getResourceAsStream

findResource

init

setRootDir

getRootDir