幻灯片 1

Transcription

1 Geodatabase 高效编程 Esri 中国 ( 北京 ) 有限公司 李圣虎

2 内容概要 单例对象与多线程 游标与使用 Geodatabase API 编辑数据 Geodatabase 开发常见错误

3 单例对象与多线程

4 单例对象与多线程 ArcObjects 的线程模型 Geodatabase 中的单实例对象 简单的多线程应用示例 (C#)

5 COM 的线程模型 COM 支持三种套间模型 :STA MTA NA(COM+) 套间外线程调用

6 使用线程套间模型 STA Thread CoInitialize 创建一个 STA 套间, 并将当前的调用线程和这个套间相关联, 被调用 COM 对象也会和该套间关联, 实现套间内的对象调用 当使用一个 MTA 线程去调用注册为 STA 的 COM 对象时, 则 COM 运行时会首先创建一个 STA 线程, 然后使用该线程创建 STA 套间, 并与此关联, 在里面创建类的实例 这将导致跨套间的调用!

7 ArcObjects 的线程模型 所有的 ArcObjects 对象都注册为 STA 线程模型 Apartment Free Neutral Both STA MTA NA STA or MTA

8 Geodatabase API 中的单实例对象 在一个线程中只有一个对象被实例化 例如 :Table FeatureClass FeatureDataset Worksapce Version 在一个线程中的所有获得的单例对象都指向一个引用 True

9 简单的多线程应用示例 (C#)

10 游标与使用 Geodatabase API 编辑数据

11 游标与使用 Geodatabase API 编辑数据 游标 编辑会话 使用游标进行 Geodatabase 编辑

12 游标 (Cursor) 游标类型 类游标 : SearchCursor UpdateCursor InsertCursor 自定义查询游标 :QueryDef Cursor 获取并使用游标

13 类游标与自定义查询游标 True 对 COM 组件的调用返回了错误 HRESULT E_FAIL

14 Recycling Cursor 和 No-Recycling Cursor Row Object Row Object Recycling Cursor Row Object No-Recycling Cursor NextRow() NextRow() True

15 使用 Recycling Cursor 数据情况 : 简单的线要素类, 条记录测试环境 : 硬件 (T9600 CPU 4G 内存 ) 软件 (Windows 7 Oracle 11g ArcGIS 10) 测试场景 : 取出所有要素备注 : 测试结果中时间单位为毫秒 Recycling=true Recycling=false 60M~ 185M~

16 InsertCursor 与 ArcSDE Geodatabase 缓存 Insert Cursor InsertRow Store in Transmission Buffer T-Buffer Filled? No Return Result Client Flush Flush Transmission Buffer Yes Server Store in Server Buffer Yes Store in DBMS Yes Was Flush Called? No S-Buffer Filled? No

17 游标使用注意事项 查询游标 (Search Cursor) 在编辑会话中初始化 SearchCursor 可能导致缓存记录提交到数据库 ( 触发 DBMS 写操作 ) 通过 SearchCursor 获得的行支持 Store 和 Delete 操作 更新游标 (Update Cursor) 必须使用 UpdateCursor 提供的的 UpdateRow 和 DeleteRow 方法对通过 UpdateCursor 获得的行进行更新和删除操作 UpdateCursor 提供的 UpdateRow 方法只能针对通过 UpdateCursor 获得的当前行进行操作 UpdateCursor 不支持跨编辑操作使用, 打开一个新的编辑操作时必须初始化一个新的更新游标 使用 UpdateCursor 对复杂要类类进行更新时必须处于一个编辑会话中 插入游标 (Insert Cursor) 主要用于批量要素插入 使用缓存, 定时调用 Flush 将缓存写入数据库, 调用 InsertRow 和 Flush 方法时要捕捉异常 使用 InsertCursor 时关闭空间缓存 QueryDef 游标 不能针对通过 QueryDef Cursor 获得的行进行 Store 和 Delete 操作 在编辑会话中使用 QueryDef Cursor 会导致缓存提交到数据库

18 编辑会话 (Edit Session) 使用编辑会话的优势 必须使用编辑会话的场景 在 Geodatabase 编辑中使用编辑会话

19 使用编辑会话的优势 将编辑操作置于原子事务中, 在所有的编辑提交之前发生错误时可以回滚 Geodatabase 维护一个 Undo 和 Redo 栈, 当一个编辑操作完成后, 可以使用 UndoEditOperation 和 RedoEditOperation 来访问 使用编辑会话编辑 ArcSDE Geodatabase 中的数据时, 允许通过批量提交来提升速度 在多用户同时编辑 Geodatabase 中的数据时, 编辑会话可以起到隔离作用, 一个编辑会话中的修改只有在该会话结束后才能反应到 Geodatabase 中 在编辑会话中 Geodatabase 维护行对象的单例性, 即同一条记录在一个编辑会话中只会被实例化一次, 所有对该记录的访问都指向相同的引用

20 必须使用编辑会话的场景 参与拓扑的要素类 参与几何网络的要素类 ArcSDE Geodatabase 中注册为版本的数据 带有类扩展的对象或要素 True False 不需要使用 EditSession 需要使用 EditSession

21 在 Geodatabase 编辑中使用编辑会话 StartEditing() Begins an edit session StartEditOperation() Begins an edit operation Yes StopEditOperation() Execute edits Representing a Single transaction Save the edits? No AbortEditOperation() Commit the Edit session? Yes No StopEditing(true) Commit the edit session StopEditing(false) Discards the edit session Save the transaction Cancels the transaction Yes More edits required? No

22 使用编辑会话编辑 ArcSDE Geodatabase 中的非版本数据 Method StartMultiuserEditing (esrimultiusereditsessionmode.esrimesmnonversi oned) StopEditing(true) StopEditing(false) DBMS behavior Start a transaction Commit the transaction Abort the transaction 只能是非版本数据

23 在编辑会话中编辑 ArcSDE Geodatabase 中的版本数据 Method StartMultiuserEditing (esrimultiusereditsessionmode.esrimesmversio ned) StartEditOperation() StopEditOperation() AbortEditOperation() 一个编辑操作单元对应一个独立事务 StopEditing(true) 使用编辑会话编辑 ArcSDE Geodatabase 中注册为版本的数据时, 注意 : 只能编辑注册为版本的数据 DBMS behavior Start a edit session Start a transaction Commit the transaction Abort the transaction Save edits and stop the edit session 多个编辑会话同时编辑一个版本, 保存编辑结果之前需要协调 不要在编辑会话中执行 DBMS 的 DDL 操作

24 ArcSDE Geodatabase 版本数据编辑示例 使用 SearchCursor 进行数据更新时注意不要使用 Recycling 类型游标

25 使用游标进行 Geodatabase 编辑 新建要素 更新要素

26 新建要素 新建要素的两种方式 单个创建 :IFeatureClass.CreateFeature() + IFeature.Store() 批量创建 :IFeatureCursor.InsertFeature(IFeatureBuffer) 使用插入游标批量创建要素 高效的使用插入游标

27 使用插入游标批量创建要素

28 使用插入游标注意事项 插入游标是用来实现要素批量插入功能的, 单个要素的编辑尽量不使用插入游标 插入游标既可以在编辑会话中使用, 也可以在编辑会话外使用, 当使用插入游标向复杂要素类插入新要素时必须将其置于编辑会话中独立的编辑操作内 :EditSession{EditOperation(InsertCursor)} 使用插入游标向复杂要素类中插入新要素时, 其内部会调用 Store 方法 ; 向简单要素类中插入新要素时不会调用 Store 方法, 因此, 依托 Store 方法触发的事件将不会被触发, 可以通过 IWorkspaceEditControl.SetStoreEventsRequired 属性来强制其调用 Store 方法, 会降低效率 调用插入游标的 Flush 方法时要捕捉异常

29 效率对比 测试场景 : 从本地 File Geodatabase 中读取数据, 向 ArcSDE Geodatabase 要素类中插入读取的数数据情况 : 简单的线要素类, 条记录测试环境 : 硬件 (T9600 CPU 4G 内存 ) 软件 (Windows 7 Oracle 11g ArcGIS 10) 备注 : 测试结果中时间单位为毫秒 Outside of edit session Inside of edit session InsertCursor CreateFeature + Store InsertCursor CreateFeature +Store 内存 60M~ 180M~ 58M~ 160M~ 时间

30 高效地使用插入游标

31 更新要素 更新要素的两种方式 单个更新 :IFeatureClass.GetFeature(OID) + IFeature.Store() 批量更新 :IFeatureCursor.UpdateFeature(IFeature) 使用游标实现要素批量更新 删除要素

32 使用游标实现要素批量更新 ArcMap Engine(Simple) Engine(Complex) Inside edit session Outside edit session Search Cursor Search Cursor Search Cursor Search Cursor Update Cursor Search Cursor

33 使用游标实现要素批量更新 (Update Cursor)

34 使用游标实现要素批量更新 (Search Cursor)

35 使用游标进行批量要素更新注意事项 根据具体的应用环境与数据类型选择合适的游标类型 使用 Update Cursor 时用 UpdateFeature 和 DeleteFeature 替代 Store 和 Delete 方法 使用 Update Cursor 时注意其位置有效性 使用 Search Cursor 时选择 No-Recycling 类型 使用游标更新复杂要素类时注意其作用范围 (EditOperation)

36 删除要素 删除要素的两种方式 单个删除 :IFeatureClass.GetFeature(OID) + IFeature.Delete() 批量删除 : 使用 Search Cursor 或 Update Cursor

37 删除要素类中的所有要素 Truncate 方法使用注意事项 : 只针对非版本的简单要素类使用 保证只有当前用户在连接到 Geodatabase

38 Geodatabase 开发常见错误

39 错误使用 Recycling 类型的游标

40 正确使用 Recycling 类型游标求所有要素长度之和 数据情况 : 简单的线要素类, 条记录测试环境 : 硬件 (T9600 CPU 4G 内存 ) 软件 (Windows 7 Oracle 11g ArcGIS 10) 备注 : 测试结果中时间单位为毫秒 Recycling No-Recycling CPU 48% 55% Memory 47680K K Time

41 在循环中调用 FindField 方法

42 使用 GetFeature() 与 GetFeatures() 数据情况 : 简单的线要素类, 条记录测试环境 : 硬件 (T9600 CPU 4G 内存 ) 软件 (Windows 7 Oracle 11g ArcGIS 10) 测试场景 : 从所有要素中取出 条要素备注 : 测试结果中时间单位为毫秒 GetFeature() GetFeatures() 时间 内存 126M~ 67M~

43 错误复用临时变量 ( 一 ) 错误用法 一种正确用法

44 错误复用临时变量 ( 二 ) COM 对象与其基础 RCW 分开后就不能再使用 正确访问

45 错误复用临时变量 ( 二 ) 正确访问 COM 对象与其基础 RCW 分开后就不能再使用

46 在编辑操作 (EditOperation) 内使用外部初始化的游标 The cursor has been invalidated because the edit operation has stopped

47 在编辑会话中调用会触发 DDL 命令的方法 提交事务 无法回滚

48 在 Store 方法触发的事件中调用 Store 方法 导致循环调用, 程序异常

49 修改内存中的 Schema 对象 ( 一 ) Geodatabase 中的对象类可以分两类 : 修改结果自动保存到 Geodatabase 中的 修改结果保存在内存中的 内存修改导致的错误用法举例 使用 IFieldEdit 接口修改 Geodatabase 中已存在的要素类字段 使用 IIndexeEdit 接口修改 Geodatabase 中已存在的索引 使用 IWorkspaceDomains 接口向 Workspace 中添加 Domain

50 修改内存中的 Schema 对象 ( 二 ) 自动添加到 Geodatabase 中

51 修改内存中的 Schema 对象 ( 三 ) 添加到当前上下文中

52