XMPP协议与ClaysterIoT服务平台应用指南

### 物联网开发：XMPP 协议与 Clayster 平台应用指南 #### 1. XMPP 协议基础 XMPP 协议在物联网开发中具有重要作用。它可以作为创建物联网应用的简单手段，应用于传感器、执行器和控制器项目。其灵活性允许通过委托信任模式为每个项目增加额外的安全层。同时，普通聊天客户端也能连接到所有设备，因为所有设备都有聊天接口。 |协议特性|详情| | ---- | ---- | |优势|可用于多种物联网项目，增加安全层| |不足|文档未明确提及，但可参考相关对比文档| |应用场景|传感器、执行器和控制器项目| #### 2. 选择物联网平台 开发者可下载和使用众多物联网平台，这些平台在功能和开发支持方面差异很大。可访问[物联网平台列表](http://postscapes.com/internet-of-things-platforms)查看可用平台，并访问其对应网页了解具体功能。不过，目前缺乏简单比较平台和全面分类其功能的方法。本文选择 Clayster 物联网平台，以便更好地评估和选择适合项目的平台。 选择 Clayster 平台的原因在于它能帮助完成许多重要任务，可对比独立开发应用和在该平台上开发服务的工作量及成果，了解在已有最终产品所需环境中运行服务的额外好处。 #### 3. 下载 Clayster 平台 从[Clayster 下载页面](http://www.clayster.com/downloads)下载供私人使用的版本。下载前需填写个人信息和有效电子邮件地址，填写表单后会收到确认邮件。确认邮箱后，平台会为你构建包含个人信息的发行版，并发送包含下载链接和不同操作系统安装说明的第二封邮件。 ```mermaid graph LR A[访问下载页面] --> B[填写个人信息和邮箱] B --> C[收到确认邮件] C --> D[确认邮箱] D --> E[构建发行版] E --> F[收到下载链接和安装说明邮件] ``` #### 4. 创建服务项目 创建服务项目与之前创建项目有所不同。由于服务平台已有可执行的 EXE 文件，因此需创建库项目，并确保目标框架与 Clayster 发行版版本（编写本文时为 .NET 3.5）对应。此类项目将生成动态链接库（DLL）文件，Clayster 可执行文件在启动时会加载安装文件夹或其子文件夹中标记为 Clayster 模块的 DLL 文件。 #### 5. 添加引用 Clayster 发行版和运行时环境包含所有必要的库。添加引用时，应使用安装文件夹中的 Clayster 库，而非之前使用的库，以确保项目使用正确的库。除之前使用的库外，还需添加以下新库和服务模块引用： |引用类型|名称|详情| | ---- | ---- | ---- | |库|Clayster.AppServer.Infrastructure|包含平台的应用引擎，提供多种管理和支持功能| |库|Clayster.Library.Abstract|包含数据抽象层，用于系统对象的高效管理| |库|Clayster.Library.Installation|定义包的概念| |库|Clayster.Library.Meters|包含传感器、执行器等的抽象模型| |服务模块|Clayster.HomeApp.MomentaryValues|用于显示传感器值的仪表| |服务模块|Clayster.Metering.Xmpp|基于抽象模型实现 XMPP 协议| #### 6. 制作 Clayster 模块 并非所有 DLL 文件都会被 Clayster 加载，只有标记为 Clayster 模块的 DLL 才会被加载。成为 Clayster 模块需满足以下三个要求： - 模块必须符合 CLS 规范。 - 必须标记为 Clayster 模块。 - 必须包含带有开发者信息的公共证书。 可通过每个 .NET 项目中的 AssemblyInfo.cs 文件实现这些要求。例如，添加以下代码确保 CLS 合规： ```csharp using System; [assembly: CLSCompliant(true)] ``` 通过添加公共证书并使用 Certificate 程序集属性引用它： ```csharp [assembly: Certificate("LearningIoT.cer")] ``` 此证书仅用于标记模块和提供开发者信息，不用于身份识别或安全目的。 #### 7. 执行服务 服务有多种执行方式，商业安装中可由不同类型的主机托管，如 Web 服务器主机、Windows 服务主机或独立可执行主机。前两种类型在生产环境中更易监控和维护，而独立可执行主机在开发过程中更便于使用，服务也可在服务器集群中托管。 下载的小型 Clayster 发行版包含可在 Mono 上运行的独立可执行主机，在终端窗口执行时会显示日志事件，并加载安装文件夹或其子文件夹中的 Clayster 模块。 - **Windows 系统**：将生成的 DLL 文件复制到 Clayster 安装文件夹后，可通过以下命令启动独立服务器执行服务： ``` Clayster.AppServer.Mono.Standalone ``` - **Linux 系统**：使用以下命令执行： ``` $ sudo mono Clayster.AppServer.Mono.Standalone.exe ``` #### 8. 使用包清单 开发者可创建包清单文件描述包中包含的文件，避免手动复制服务文件和相关项目文件，使包更易于安装和分发。示例中，创建名为 `Controller2.packagemanifest` 的文件，内容如下： ```xml <?xml version="1.0" encoding="utf-8" ?> <ServicePackageManifest xmlns="http://clayster.com/schema/ServicePackageManifest/v1.xsd"> <ApplicationFiles> <ApplicationFile file="Controller2.dll"/> </ApplicationFiles> </ServicePackageManifest> ``` 有了包清单文件后，可通过以下命令在 Windows 和 Linux 系统上一键安装包并执行独立服务器： - **Windows 系统**： ``` Clayster.AppServer.Mono.Standalone –i Controller2.packagemanifest ``` - **Linux 系统**： ``` $ sudo mono Clayster.AppServer.Mono.Standalone.exe –i Contr ```