U9研发体系(实体操作API参考手册)

取属性在当前环境下语种的多语信息 参数：
propName 属性名
public MultiLangDataDict GetMultiLangPropDict(string propName)
取得属性所对应的全语种信息 参数：
propName 属性名
返回： MultiLangDataDict 带全语种的多语集合
方法
public IPersistableObject Clone()
新建一个实体，将源实体的所有属性拷贝到这个新建的实体，注意，这个新实体的 ID 与源实体都是一样的
public virtual void CopyTo(Entity target)
将源实体的除了 ID 以外的所有属性拷贝到 target 实体 参数：
EntityKey
这个 EntityKey 是实体基类 UFSoft.UBF.Business.BusinessEntity 的内部类，是强类 型 EntityKey 的基类
方法
public BusinessEntity GetEntity() 通过 EntityKey 加载实体
EntityFinder
List<string> 变化的属性集合
public string GetMultiLangProp(string langType, string propName)
取属性在指定语种所对应的多语言信息 参数：
langType 语种 propName 属性名
public string GetMultiLangProp(string propName)
创建实体全名为 fullName 的实体对象 参数：
fullName 实体的带名空间的全名 parent 上级实体，如果是主实体的创建，这个参数为 null，如果不是，这个参数 需要送入组合它那个实体实例
public List<string> GetChangedAttributes()
取得变化的属性集合 返回：
entity 为删除/移出 session 的对象
public void InList(IEntity entity)
将 entity 加入到当前的 session 中 参数：
entity 为要加入 session 的对象
示例代码： objA = A_Ass1to1.Create(); _A_1to1 = "Test";
将 entity 对象的状态设置为 UFSoft.UBF.PL.Engine.ObjectState. Updated，并 加入到当前的 session 中
参数： entity 为修改的对象
public void Remove(IEntity entity)
如果当前 session 有这个 entity，且状态为 insert，则从当前 session 中移出这 个 对 象 ， 其 他 情 况 下 ， 将 entity 对 象 的 状 态 设 置 为 UFSoft.UBF.PL.Engine.ObjectState. Deleted，并加入到当前的 session 中 参数：
public object GetRelation(object key)
取属性所对应的关联实体/关联实体集合 参数：
key 关联对象属性名 返回：
object 如果是对一，返回关联对象，如果是对多，返回关联对象的集合
public virtual object GetValue(object propName)
属性
public QueryOptions QOptions
查询的扩展条件，目前主要用于多语控制 示例代码：
EntityDataQuery a = new EntityDataQuery("Association.Yel_Ass1to1_A"); //返回指定语种 a.QOptions.MultiLangOption = new GlobalizationContext("zh-CN"); a.FindDataSet(); //返回全语种 a.QOptions.MultiLangOption = GlobalizationOption.Manual; a.FindDataSet(); //返回当前上下文语种 a.QOptions.MultiLangOption = GlobalizationOption.Auto; a.FindDataSet();
public bool CopyTo(IPersistableObject po, bool isCopyKey)
将源实体的属性拷贝到 po 实体 参数：
po 目标实体 isCopyKey 是否带 ID 拷贝
public static Entity Create(IClassKey classKey, IEntity parent)
Session
UFSoft.UBF.Business.dll 下的 Session 主要是定义一个持久化控制的边界，并提交控 制内实体的持久化操作，名空间为：UFSoft.UBF.Business
方法
public static Session Open() 新开一个 Session
public void Commit() 提交 Session 内的将持久化的对象的新建/修改/删除操作
创建 IClassKey 指定类型的实体对象 参数：
classKey 实体的元数据信息 parent 上级实体，如果是主实体的创建，这个参数为 null，如果不是，这个参 数需要送入组合它那个实体实例
public static Entity Create(string fullName, IEntity parent)
叶琳
2008-7-11
加
EntityKey,EntityFinder,EntityV iewQuery,ExtendHelpAPI 的
API 说明
概述
实体操作的对外 API 主要集中在 UFSoft.UBF.Business.dll 中，涉及到实体的新建，修 改，删除，查询等操作，下面将分每个类进行详细说明，某些典型 API 将提供示例代码
属性
public bool NeedPersistable 是否需要持久化标志，为 true 表示需要持久化，可 set/get
public abstract IClassKey ClassKey 实体所对应的元数据信息，只能 get
public IObjectValue Values 实体的值集合，只能 get
public void SetRelation(object key, object value) 设置属性的关联关系 参数：
key 关联属性名 value 关联对象/关联对象集合 public virtual void SetValue(object propName, object value) 设置属性的值 参数： propName 属性名 value 值
将 entity 从 session 中移出 参数：
entity 为移出 session 的对象
示例代码： using (ISession s = Session.Open()) { objA = A_Ass1to1.Create(); objA.Code_A_1to1 = 333; s.DeList(objA);
这个 EntityFinder 是实体基类 UFSoft.UBF.Business.Entity 的内部类，是强类型 EntityFinder 的基类
方法
public bool IsExists(string opath, params OqlParam[] oqlParameters)
看是否存在满足条件的实体 示例：
using (ISession s = Session.Open()) {
s.InList(objA); mit(); } Assert.IsNotNull(A_Ass1to1.Finder.Find("ID = '" + objA.ID + "'"));
public void DeList(IEntity entity)
取属性所对应的值 参数：
propName 属性名
public void SetMultiLangProp(string propName, string value)
设置属性在当前语种的多语言信息 参数：
propName 属性名 value 值
public void SetMultiLangProp(string propName, string value, string langType)
mit(); } Assert.IsNull(A_Ass1to1.Finder.Find("ID = '" + objA.ID + "'"));
Entity
UFSoft.UBF.Business.dll 下的 Entity 是业务实体的基类，主要描述实体对象的基本 结构，实体对象的初始化等工作，名空间为 UFSoft.UBF.Business
target 为目标实体
注意，这个方法源实体和 target 实体的 ID 是不一样的。 目前 CopyTo 方法只完整实现了对基本属性的拷贝，即为浅拷贝，对于关联实体，实 际上是不拷贝的，对于一对一或一对多的情况，会出现关联对象也拷贝的假象，实际 上，对象是懒加载上来的，对于一对多的情况，是空对象，以后根据实际的使用情况， 决定是不是要完整实现关联实体的拷贝 CopyTo 方 法 只 是 将 相 关的 业 务 数 据拷 贝 ， 不 涉及 到 一 些 系统 的 控 制 属性 ， 如 SysState，NeedPersistable 等系统的控制字段,不涉及到 OriginalData 的拷贝