IRIS 2021 技术文档 First Look 12--技术概要：.NET Object Persistence with XEP

using System; namespace xep.samples

{

public class SingleStringSample { public string name;

public SingleStringSample() { }

       internal SingleStringSample(string str) { name = str;}

public static SingleStringSample[] generateSampleData(int objectCount) { SingleStringSample[] data = new SingleStringSample[objectCount];  for (int i = 0; i < objectCount; i++)

{

data[i] = new SingleStringSample("single string test");

}

return data;

}

}

}

因为这个类非常简单，所以 XEP 不需要任何注释就可以从中生成有效的模式。对于真实应用程序中更复杂的类，您可以使用各种选项来优化导入。

创建 XEP 演示程序

现在您可以创建 XEPSimple 演示程序了。在 Visual Studio 中，找到您在创建项目时创建的默认 program.cs 文件。删除该文件的默认内容，并粘贴下面的代码，用connection information for your InterSystems IRIS instance（您的 InterSystems IRIS 实例的连接信息）替换主机、端口、irisnamespace、用户名和密码变量的值。您可以指定所示的 USERnamespace，也可以选择在实例上创建的另一个命名空间。

using System;

using InterSystems.XEP; using xep.samples;

namespace XepSimpleNamespace

{

public class XepSimple

{

public static void Main(string[] args)

{

// Generate 12 SingleStringSample objects for use as test data SingleStringSample[] sampleArray = SingleStringSample.generateSampleData(12);

// EventPersister

EventPersister xepPersister = PersisterFactory.CreatePersister();

String host = "127.0.0.1"; // InterSystems IRIS host int port = 51774; // InterSystems IRIS Superserver port

String irisnamespace = "USER"; // InterSystems IRIS namespace String username = "_system"; // Credentials for InterSystems IRIS String password = "SYS"; //Credentials for InterSystems IRIS

xepPersister.Connect(host,port,irisnamespace,username,password); // connect to localhost xepPersister.DeleteExtent("xep.samples.SingleStringSample");   // remove old test data xepPersister.ImportSchema("xep.samples.SingleStringSample");   // import flat schema

// Event

Event xepEvent = xepPersister.GetEvent("xep.samples.SingleStringSample");

long[] itemIdList = xepEvent.Store(sampleArray); int itemCount = 0;

for (int i = 0; i < itemIdList.Length; i++)

{

if (itemIdList[i] > 0) itemCount++;

}

Console.WriteLine("Stored " + itemCount + " of " + sampleArray.Length + " events");



// EventQuery

EventQuery<SingleStringSample> xepQuery = null;

String sqlQuery = "SELECT * FROM xep_samples.SingleStringSample WHERE %ID BETWEEN ? AND ?";

xepQuery = xepEvent.CreateQuery<SingleStringSample>(sqlQuery); xepQuery.AddParameter(3); // assign value 3 to first SQL parameter xepQuery.AddParameter(12); // assign value 12 to second SQL parameter xepQuery.Execute();   // get resultset for IDs between 3 and 12

xepQuery.Close(); xepEvent.Close(); xepPersister.Close();

} // end main()

} // end class xepSimple

}

演示程序分为三个部分，每个部分演示了 XEP 三个主要类——EventPersister、 Event 和 EventQuery 中的一个。运行时，XepSimple 演示程序执行以下任务：

• 首先，通过调用示例数据类（sample data class） xep.samples.SingleStringSample 这一方法生成一些示例对象。
• EventPersister 是 XEP 的主要入口点（main entry point），并提供到数据库的连接。

它创建一个名为 xepPersister 的实例，该实例在数据库中建立到 User 命名空间的 TCP/IP 连接，并删除任何现有的示例数据。然后调用 ImportSchema() 来分析示例类并将模式发送到数据库，从而创建相应的 ObjectScript 模式来保存持久化 SingleStringSample 对象。

• Event 封装了（encapsulate） .NET 对象和相应的数据库对象之间的接口。

一旦生成了模式(schema)，xepPersister 就可以为示例类创建一个名为 xepEvent 的 Event 对象。Store() 方法将 .NET 对象数组存储为持久化事件。

• EventQuery 用于准备和执行 SQL 查询的有限子集。

名为 xepQuery 的 EventQuery<SingleStringSample> 对象是通过将查询字符串传递给 xepEvent 对象的 CreateQuery() 方法创建的。 该字符串定义了一个接受两个参数（? 字符）的 SQL 查询。 参数值是通过调用 AddParameter() 定义的，调用 Execute() 来获取查询结果集。

• 当处理完成后，它通过调用 XEP 对象的 close() 方法进行清理。

1. 运行 XEPSimple 程序

现在您可以构建和运行 XEPSimple 演示程序了。按 Ctrl + F5 运行程序，以便当程序结束时命令提示符保持打开状态。

1. 下一步

XepSimple 演示的目的是让您体验 XEP，而又不陷入细节困境，它不是用于实际生产代码的模型——它甚至没有进行异常检查。最重要的简化是在示例数据中。您从一个不需要注释或其他机制来帮助模式（schema）生成和优化的类中持久化了一些很小的 .NET 对象。虽然在实际应用程序中通常需要注释和其他选项，但这些选项非常简单易用。API 也同样简单易用。

有关所有 XEP 功能的全面描述，请参见 Persisting .NET Objects with InterSystems XEP（《使用 InterSystems XEP 持久化 .NET 对象》）。

了解有关 .NET 支持的更多信息

InterSystems IRIS 提供了 .NET API，通过 SQL 表、对象和多维存储轻松访问数据库。有关每种类型的访问的详细信息，请参见以下书籍：

• Using the Native API for .NET（《使用 Native API for .NET》），了解从 .NET 应用程序访问 InterSystems IRIS globals。
• Using ADO.NET Managed Provider Classes（《使用 ADO.NET Managed Provider Classes》），了解SQL 表访问。允许您的 .NET 项目使用完全兼容的通用 ADO.NET Managed Provider 版本访问 InterSystems IRIS 数据库。
• Using the InterSystems ODBC Driver（《使用 InterSystems ODBC Driver》），了解 SQL 表访问。InterSystems ODBC 驱动程序允许 InterSystems IRIS 建立到外部应用程序的 ODBC 连接，并通过 SQL 提供对外部数据源的访问。
• Persisting .NET Objects with InterSystems XEP（《使用 InterSystems XEP 持久化 .NET 对象》），了解对象访问。XEP 对事务处理应用程序进行了优化，这类程序使用复杂度从简单到中等的对象层次结构，且要求极高的对象数据持久化和检索速度。
• Using the Entity Framework Provider（《使用 Entity Framework Provider》），了解对象-关系映射。提供有关使用实体框架（Entity Framework）技术访问 InterSystems IRIS 数据库的信息。