快速开始
CoAP.NET简介、下载与使用。
下载 CoAP.NET
通过 NuGet 安装 CoAP.NET。
PM> Install-Package CoAP
或者从 版本页面 下载预编译的二进制文件。
当前版本 v1.1.0.
使用 CoAP 客户端
// 创建一个新的客户端实例
var client = new CoapClient();
// 设置目标访问资源的Uri地址
client.Uri = new Uri("coap://SERVER_ADDRESS/helloworld");
// 发送GET请求
var response = client.Get();
Console.WriteLine(response.PayloadString); // Hello World!
使用 CoAP 服务端
首先,创建一个新的服务端资源:
class HelloWorldResource : Resource
{
// 设置当前资源的路径为 "helloworld"
public HelloWorldResource() : base("helloworld")
{
// 设置资源的标题
Attributes.Title = "GET a friendly greeting!";
}
// 重写 DoGet 方法来处理 GET 请求
protected override void DoGet(CoapExchange exchange)
{
// 收到一次请求,回复 "Hello World!"
exchange.Respond("Hello World!");
}
}
接下来,将这个资源添加到一个服务端实例,然后启动服务端:
// 创建一个新的服务端实例
var server = new CoapServer();
// 添加资源
server.Add(new HelloWorldResource());
// 启动服务端
server.Start();
现在可以通过 coap://SERVER_ADDRESS/helloworld
来访问这个资源了。
构建源码
CoAP.NET 工程定义了一些条件编译符号来构建不同版本的 CoAP 草案,支持的版本如下:
COAP03
– draft-ietf-core-coap-03COAP08
– draft-ietf-core-coap-08COAP12
– draft-ietf-core-coap-12COAP13
– draft-ietf-core-coap-13COAP18
– draft-ietf-core-coap-18RFC7252
– RFC7252COAPALL
– 以上所有的支持草案
默认条件下(不定义任何条件编译符号),CoAP.NET 将构建为最新的 CoAP 草案。
如果需要启用特定版本的 CoAP 协议草案,定义相应的条件编译符号即可。
例如,定义 COAP03
将启用 CoAP Draft 03。定义 COAPALL
将启用所有支持的 CoAP 草案。
Next: 帮助文档