** 第 ** ** 3 ** ** 章 ** ** ** ** 数据库基础 ** ** : ** ** 创建我们自己的 ** ** Employee ** ** 对象 **
打开 Lab3 文件夹下的 Lab3 工程文件,或 或接着 Lab2 的代码。
在这一章中,我们将创建一个 ‘Employee 对象 ’ (包括一个圆,一个椭圆和一个多行文本对象),这个对象属于一个自定义的 EmployeeBlock’ 块(这个块驻留在 ‘EmployeeLayer’ 层,当在模型空间插入这个块的时候, ‘EmployeeLayer’ 层就会拥有这个块的一个块索引)。本章的每一个步骤中的代码都可以运行,这样做的目的可以使你更清楚地知道每一部分代码完成的功能。 第 一步将简要说明一下如何在模型空间创建一个圆。
这一章的重点是在 AutoCAD 中访问数据库的 基础 。主要内容包括事务处理( Transaction )、对象 Id ( ObjectId )、符号表( symbol tables ,如块表 BlockTable 和层表 LayerTable )以及对象引用。使用的其它一些对象如颜色 Color 、三维点 Point3d 和三维向量 Vector3d ,都和各自的步骤有关,但重点应该放在数据库基础上。
** 1) ** 创建一个名为 ‘CREATE’ 的命令,它调用函数 CreateEmployee() 。这个函数用来在模型空间 ( MODELSPACE ) 的( 10 , 10 , 0 )点处创建一个半径为 2.0 的圆:
[CommandMethod("test")]
public void createCircle()
{
// 首先声明我们要使用的对象
Circle circle; // 这个是我们要加入到模型空间的圆
BlockTableRecord btr;// 要加入圆,我们必须打开模型空间
BlockTable bt; // 要打开模型空间,我们必须通过块表 ( BlockTable ) 来访问它
// 我们使用一个名为 ‘Transaction’ 的对象,把函数中有关数据库的操作封装起来
Transaction trans;
// 使用 TransactionManager 的 StartTransaction() 成员来开始事务处理
trans = HostApplicationServices.WorkingDatabase.TransactionManager.StartTransaction();
// 现在创建圆……请仔细看这些参数——注意创建 Point3d 对象的 ‘New’ 和 Vector3d 的静态成员 ZAxis
circle = new Circle( new Point3d(10, 10, 0), Vector3d.ZAxis, 2);
bt = (BlockTable)trans.GetObject(HostApplicationServices.WorkingDatabase.BlockTableId, OpenMode.ForRead);
// 使用当前的空间 Id 来获取块表记录——注意我们是打开它用来写入
btr = (BlockTableRecord)trans.GetObject(HostApplicationServices.WorkingDatabase.CurrentSpaceId,OpenMode.ForWrite );
// 现在使用 btr 对象来加入圆
btr.AppendEntity(circle);
trans.AddNewlyCreatedDBObject(circle, true ); // 并确定事务处理知道要加入圆!
// 一旦完成以上操作,我们就提交事务处理,这样以上所做的改变就被保存了……
trans.Commit();
//… 然后销毁事务处理,因为我们已经完成了相关的操作(事务处理不是数据库驻留对象,可以销毁)
trans.Dispose();
}
请仔细阅读一下上面的代码块的结构,可以通过注释来了解相关的细节。
注意:要编译代码,你必须导入 Autodesk . AutoCAD . DatabaseServices 和 Autodesk . AutoCAD . Geometry 命名空间
_ 运行这个函数来看看它是否可行。应该会在图形中创建一个在 (10,10,0) 处的半径为 2.0 的白色的圆。 _
** 2) ** 我们可以减少代码的输入量,这可以通过声明一个 Database 变量代替 HostApplicationServices.WorkingDatabase 来实现:
Database db = HostApplicationServices.WorkingDatabase;
使用这个变量来代替在代码中出现的 HostApplicationServices.WorkingDatabase 。
** 3) ** 在上面的代码中,我们没有使用任何异常处理,而异常处理对一个正确的 .NET 应用程序来说是非常重要的。我们要养成使用异常处理的好习惯,所以让我们在这个函数中加入 try-catch-finally 。 ** **
** 4) ** 为了使代码紧凑,我们可以把许多变量的声明和初始化放在同一个语句中。现在,你的代码看起来应该是这样的:
[CommandMethod("CREATE")]
public void CREATEEMPLOYEE()
{
Database db = HostApplicationServices.WorkingDatabase;
Transaction trans = db.TransactionManager.StartTransaction();
try
{
Circle circle = new Circle(new Point3d(10, 10, 0), Vector3d.ZAxis, 2);
BlockTable bt = (BlockTable)trans.GetObject(db.BlockTableId, OpenMode.ForRead);
BlockTableRecord btr = (BlockTableRecord)trans.GetObject(HostApplicationServices.WorkingDatabase.CurrentSpaceId,OpenMode.ForWrite);
btr.AppendEntity(circle);
trans.AddNewlyCreatedDBObject(circle, true);
trans.Commit();
}
catch
{
ed.WriteMessage("Error ");
}
finally
{
trans.Dispose();
}
}
End Function
运行你的代码来进行测试……
上面的 catch 块只显示一个错误信息。实际的清理工作是在 finally 块中进行的。这样做的理由是如果在事务处理被提交( Commit() )之前, Dispose() 被调用的话,事务处理会被 销毁。我们认为如果在 trans.Commit() 之前出现任何错误的话,你应该销毁事务处理(因为 Commit 将永远不会被调用)。如果在 Dispose() 之前调用了 Commit() ,也就是说没有任何错误发生,那么事务处理将会被提交给数据库。
所以基于上面的分析, Catch 块其实并不是必须的,因为它只用来通知用户程序出现了一个错误。它将在下面的代码中被去掉。
** 5) ** 现在让我们在 Employee 加入剩下的部分:椭圆和多行文本的实例。
多行文本实体:
中心点应该与圆心的创建一样:
(建议:创建一个名为 ‘center’ 而值为 10,10,0 的 Point3d 变量来表示中心点)
多行文本的内容可以是你的名字。
椭圆(提示:你可以先看一下 Ellipse 的构造函数)
法向量应该沿着 Z 轴(请查看 Vector3d 类型)
主轴设为 Vector3d(3,0,0) (提示:不要忘了用 new )
半径比例设为 0.5
椭圆还必须闭合(也就是说,开始和结束点必须相同)
运行你的代码来进行测试……应该可以生成一个圆、一个椭圆和一个中心点在 10,10,0 的多行文本。 _ _
注意:和事务处理对象有关的 .NET API 中的 Try-Catch-Finally 块结构,应该是异常观察者。实际上我们是在 try 块中实例化对象的,但没有显式地销毁它们。当产生异常的时候可能会产生问题,特别是当观察者注意到我们实际上用的是封装的非托管对象!记住,当资源不再使用的时候,垃圾收集机制就会回收内存。垃圾收集机制会不时的调用封装类的 Dispose() 方法,删除非托管对象。
这里还要注意的是 Dispose() 作用于封装的非托管类对象的方式取决于对象是否是数据库驻留对象。由非数据库驻留对象调用的 Dispose() 会删除非托管对象,而由数据库驻留对象调用的 Dispose() 只是关闭它们。
** 6) ** 接下来让我们来创建一个新的函数,它用来新建一个颜色为黄色,名字为 “EmployeeLayer” 的 AutoCAD 层。
这个函数应该检查是否这个层已经存在,但不管这个层是否存在,函数都应该返回 “EmployeeLayer” 的 ObjectId 。下面是这个函数的代码:
public ObjectId CreateLayer()
{
ObjectId layerId; // 它返回函数的值
Database db = HostApplicationServices.WorkingDatabase;
Transaction trans = db.TransactionManager.StartTransaction();
// 首先取得层表……
LayerTable lt = (LayerTable)trans.GetObject(db.LayerTableId, OpenMode.ForWrite);
// 检查 EmployeeLayer 层是否存在……
if (lt.Has("EmployeeLayer"))
{
layerId = lt["EmployeeLayer"];
}
else
{
// 如果 EmployeeLayer 层不存在,就创建它
LayerTableRecord ltr = new LayerTableRecord();
ltr.Name = "EmployeeLayer"; // 设置层的名字
ltr.Color = Color.FromColorIndex(ColorMethod.ByAci, 2);
layerId = lt.Add(ltr);
trans.AddNewlyCreatedDBObject(ltr, true);
}
trans.Commit();
trans.Dispose();
return layerId;
}
是不是觉得这个函数的基本结构与在模型空间加入实体的代码比较类似?访问数据库的方法都是这样的:使用事务处理来获取数据库对象,在符号表(模型空间所在的块表也是符号表之一)中加入实体,然后让事务处理知道。
** 7) ** 在这个函数中加入异常处理,就像在 CreateEmployee 函数中的一样。
** 8) ** 接下来,改变新建层的颜色。下面是实现的代码片断,请把它加入到你的代码中:
ltr.Color = Color.FromColorIndex(ColorMethod.ByAci, 2)
注意: ColorMethod.ByAci 可以让我们使用 AutoCAD ACI 颜色索引……这里为 2 (表示黄色)。
** 9) ** 回到 CreateEmployee() 函数,加入把上面创建的几个实体设置到 EmployeeLayer 层的代码。声明一个类型为 ObjectId 的变量,用 CreateLayer 函数的返回值给它赋值。使用每个实体(文本、圆和椭圆)的 L ayerId 属性设置它们所在的层。
例如: text.LayerId = empId
运行代码来查看 _ “EmployeeLayer” _ _ 层 _ _ 是否已被创建,所有已创建的实体是否都在这一层上(应该显示为黄色) _
** 10) ** 现在为各个实体设置不同的颜色,可以使用 ColorIndex 属性( ColorIndex 属性表示 AutoCAD 的颜色)
圆为红色- 1
椭圆为绿色- 3
文本为黄色- 2
_ _
运行代码,看看实体的颜色是否为设置的值,即使这些实体是在 _ “EmployeeLayer” _ _ 层上。 _
** 11) ** 接下来,我们要在 AutoCAD 数据库中创建一个独立的块,然后把它插入到块表而不是模型空间中。
首先把 CreateEmployee 函数的名字改为 CreateEmployeeDefinition() 。
加入以下代码来创建一个独立的块:
BlockTableRecord newBtr = new BlockTableRecord();
newBtr.Name = "EmployeeBlock";
newBtrId = bt.Add(newBtr);
trans.AddNewlyCreatedDBObject(newBtr, true );
** 12) ** 现在,请稍微改动一下加入实体到模型空间的代码(改为加入块到块表中,记得加入前要打开块表)。
_ 现在运行代码,然后使用 _ _ INSERT _ _ 命令来检查是否可以正确插入这个块。 _ _ _
** 13) ** 最后,我们要创建一个位于模型空间的块索引,它表示上面创建的块的一个实例。这一步留给大家练习。
下面是你要遵循的最基本的步骤:
A) 创建一个名为 CreateEmployee 新的函数
B) 把命令属性 “CREATE” 移动到 CreateEmployee()
C) 修改 CreateEmployeeDefintion() 来返回新创建的块 “EmployeeBlock” 的 ObjectId ,操作的步骤请参考 CreateLayer() 的作法。
D) 你需要修改 CreateEmployeeDefintion() 来查看块表中是否已包含 “EmployeeBlock” 块,如果包含这个块,则返回它的 ObjectId (做法与 CreateLayer() 一样)。
提示:把 _ ‘bt’ _ 的声