AppFramework1.0数据库访问组件使用说明(四)基础数据类型

最新推荐文章于 2024-12-20 17:16:19 发布

AppFramework

最新推荐文章于 2024-12-20 17:16:19 发布

阅读量1.3k

点赞数

文章标签：数据库 string dao object session c#

本文链接：https://blog.csdn.net/AppFramework/article/details/1944478

版权

本文介绍了AppFramework1.0中的DBValue和DBField类，用于解决IBatisNet的空值问题。DBValue是对C#基本类型的封装，增加了HasValue属性，而DBField用于表达字段的“空值”、“默认值”和“表达式”。通过DBField和IDBSession，可以高效地实现数据库的插入和更新操作。文章还展示了如何使用DBField和DAO进行数据操作。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1.1 基础数据类型

1.1.1 有关DBValue

为了规避IBatisNet的空值问题，AppFramework不使用C#基本类型来构造实体类。AppFramework对C#基本类型作了简单封装，增加了一个是否有值的属性来标志字段值是否非空。

每一种基本的C#类型都有对应的DBValue对其进行封装。

C#类型	DBValue类型	数据库类型
byte	ByteValue	数字类型
short	ShortValue	数字类型
int	IntValue	数字类型
long	LongValue	数字类型
sbyte	SByteValue	数字类型
ushort	UShortValue	数字类型
ulong	ULongValue	数字类型
uint	UIntValue	数字类型
DateTime	DateTimeValue	日期时间
string	StringValue	Varchar/NVarchar 或 Text/CLOB类型
float	FloatValue	数字类型
double	DoubleValue	数字类型
decimal	DecimalValue	数字类型、金额
byte[]	BLOBValue	BLOB类型

1.1.2 DBValue的属性方法

在AppFramework 里， DBValue 主要用于构造数据库的表实体类。代码生成器为每个数据表生成一个实体类，为每个表字段生成一个子类化的DBValue 属性，并自动实现实体类的构造、赋值。测试数据表明，虽然DBValue 构造的实体类比用C# 基本类型构造的实体类要“重”一些，但其构造对象的性能比IBatis 用反射的方式构造对象的性能还是高很多。

下表简单列举了DBValue 的基本属性和方法：

属性/ 方法	类型	说明
HasValue	Bool	标志字段是否有值，构造时初始化为false
Object	Object	获取或设置字段内部封装的值，如果 HasValue 为 false, 获取时得到 null
DBObject	Object	获取或设置字段内部封装的值，如果 HasValue 为 false, 获取时得到 DBNull.Value; 如果设置 DBNull ，则 HasValue 改变为 false;
Value	封装的C# 类型	获取字段值，HasValue 为 false 时获取 Value 值将获得所封装类型的默认值
ToString()	String	显示为文本，如果HasValue 为false ，则返回string.Empty
Clear()	Void	把HasValue 设置为false ，但清除Value 值

例如，IntValue 封装了 int 类型的数据库字段，IntValue.HasValue 表示是否有值，如果没有值访问IntValue.Value 属性会得到int 的默认值。对无值的IntValue 调用ToString() 会得到空字符串。

正确的用法应该是先通过HasValue 判断是否有值，然后在访问Value 获取值。

public BasUser GetUser(string fields, int id)

{

// 获得 dao

IBasUserDAO dao = DAOManager.Default.GetDAO<IBasUserDAO>();

// 获得数据库会话

using (IDBSession session = DBSessionManager.Default.GetSession())

{

return dao.Get(session, fields, id);// 返回得到的实体，如果未找到记录，返回 null

}

public void ShowUser(int userID)

{

BasUser user = GetUser(userID);

if (user != null)

{

txtName.Text = user.Name.ToString();

txtAge.Text = user.Age.ToString();

}
}

1.1.3 有关DBField

DBField封装的基本目的是表达C#原始类型的所不能表达的“空值”、“默认值”、“表达式”等信息，其结构为“字段名—操作符—表达式”，在AppFramework中主要用于插入和更新数据库记录时为数据库字段赋值或表达式。经过扩展，也适用于各一些表达 “字段名—操作符—表达式”结构的SQL语句片段，例如“字段名 in (select … from)”这样的子查询。

DBField封装了各种通用的数据库字段类型，如下表：

C#类型	DBField类型	数据库类型
Object	DBField	通用类型
Byte	ByteField	数字类型
Short	ShortField	数字类型
Int	IntField	数字类型
Long	LongField	数字类型
Sbyte	SByteField	数字类型
Ushort	UShortField	数字类型
Ulong	ULongField	数字类型
uint	UIntField	数字类型
DateTime	DateTimeField	日期时间
string	StringField	Varchar/NVarchar
string	TextField	Text/CLOB类型
float	FloatField	数字类型
double	DoubleField	数字类型
decimal	DecimalField	数字类型、金额
byte[]	BLOBField	BLOB类型

注意：DBField比DBValue多了对两种基础类型的封装，一个是DBField对object的封装，另一个是TextField对CLOB/TEXT大文本字段的封装。

1.1.4 DBField的属性方法

下表简单列举了DBField的基本用法：

属性/方法	类型	说明
FieldName	string	获取或设置字段名
Operator	DBOperator	获取或设置字段操作符，例如大于、小于、等于、in、like……等常用操作符，默认为 Equal
Value	封装的C#类型	获取字段值，HasValue 为 false 时获取 Value 值将获得所封装类型的默认值
Expression	string	获取或设置字段表达式
Flag	DBFieldFlag	获取字段值状态标志，当标志值为NotSet时表示未设置值，标志值为Value 表示此对象的Value属性有效; Expression表示此对象的Expression有效。默认为 NotSet。
DataType	DataType	获取或设置字段值类型
AsObject	object	以 object 方式获取或设置字段值，如果 Flag为 NotSet, 获取时得到 null
SelectStatement	SelectStatement	获取或设置字段的子查询表达式
SetDefault()	void	设置字段为其默认值
SetNull()	void	设置字段为空值
Clear()	void	清除字段值或表达式，把Flag设置为NotSet
ToString()	string	已重载。若Flag为NotSet，返回string.Empty。若Flag为Value，则返回Value.ToString()。若Flag为Expression，则返回Expression。

为了方便使用，提供了几个静态方法快速创建各种DBField：

方法	返回值	说明
CreateExpression	DBField	创建一个表达式，有多个重载，可以对各个属性进行设置。 string fieldName：字段名 DataType t：字段类型 DBOperator op：表达式的操作符 string expression：表达式
CreateDefault	DBField	创建一个默认值字段
CreateNull	DBField	创建一个空值字段
Create	DBField	虚方法，子类将重载，创建一个子类DBField