node-red教程3.1 inject介绍

蔚落 2022-05-22 07:54 43阅读 0赞

Node-red控件很多，我们可以根据自己的需要来选择。每个控件官方都带有详细的说明，接下来介绍一个典型的输入控件——inject。

## 3.1.1 inject的说明信息 ##

前边helloworld的例子中，我们已经认识了输入节点，接下来详细介绍它。  
　　Node-red内部自带了对控件的介绍。鼠标悬停在某个控件上，就会出现一些提示信息，例如：  
![这里写图片描述][70]  
　　点击节点时，页面右侧也会出现提示信息  
![这里写图片描述][70 1]  
　　阅读这些信息，就能对节点的使用有大概的了解。不过由于信息都是英文的，为了方便读者，我们会把常用控件的英文提示翻译过来  
　　以下是Inject的节点帮助信息  
手动或定期地将消息注入到流中。消息有效负载可以是多种类型，包括字符串、JavaScript对象或当前时间。  
输出  
1 多种多样的载荷  
消息需要配置载荷  
2 string类型的topic  
节点主题的配置是可选的。（可以配置topic，也可以不配置）  
详细说明  
注入节点可以启动带有特定载荷的流。默认的载荷是时间戳，时间戳的意思是从1970年1月1日到当前时间，经历了多少毫秒。  
该节点还支持注入字符串、数字、布尔值、JavaScript对象或流/全局上下文值。  
默认情况下，通过单击编辑器中的按钮来手动触发节点。它也可以被设置为定期注入或根据时间表（在特定的时间段内）进行注入。  
它还可以配置为在每次启动流时注入一次。  
可以指定的最大时间间隔是596小时/24天。但是，如果您查看的时间间隔超过一天，您应该考虑使用一个调度器节点来处理断电和重新启动。  
注意：“时间间隔”和“在特定时间”选项使用标准CRON系统。这意味着如果填写的是20分钟，那么这20分钟会在整点20分以后，例如1：20，1:40，而不是从程序开始运行的20分钟，例如程序是2:11开始运行的，那么不使用CRON系统的话，下个20分钟就是2：31。如果你想从现在开始每20分钟-使用“间隔”选项。  
注意：要在一个字符串中包含一个换行符，您必须使用一个函数节点来创建有效负载。(意思就是注入节点的字符串没办法包含换行符)  
　　帮助信息已经说得很清楚了，不过由于输入节点非常常用，且其它的输入节点跟它的原理都一样，所以我还是啰嗦一下，举常用的例子来说明。

## 3.1.2 输入时间戳 ##

添加输入节点（inject）与调试节点（debug）。连线，并且部署。  
![这里写图片描述][70 2]  
　　点击时间戳的按钮，然后在调试窗口下应该能看到这样的一串数据  
![这里写图片描述][70 3]  
　　这个就是时间戳的值。关于时间戳的解释，节点帮助信息已经说得很清楚了，时间戳的意思是从1970年1月1日到当前时间，经历了多少毫秒。也就是从1970年1月1日到我写文章的这个时候，经历了1526978229517毫秒。从毫秒到当前时间的换算挺麻烦的，这里提供一个在线计算的工具  
[http://tool.chinaz.com/Tools/unixtime.aspx][http_tool.chinaz.com_Tools_unixtime.aspx]  
![这里写图片描述][70 4]  
　　如此一来就能方便的把毫秒转换为当前时间了。  
　　其实debug控件也很人性化的提供了转换功能，在调试窗口点击数字就能看到当前时间了  
![这里写图片描述][70 5]  
　　再点击一下，能转换为十六进制的数据。虽然这个功能并没有什么用。  
![这里写图片描述][70 6]

## 3.1.3 输入数字与数组 ##

Inject节点的内容可以配置为数字或数组。  
![这里写图片描述][70 7]  
　　数字建议输入十进制，可以是整数也可以是小数。不建议输入十六进制，如果确实要输入十六进制的数可以转换为十进制输入。其实这是同一个数，0xc=12。  
![这里写图片描述][70 8]  
![这里写图片描述][70 9]  
　　如需输入数组，在“内容”一栏，要选择二进制，并且手动添加英文字符中的括号与逗号。注意，是英文字符的“,”。编程语言中几乎不会出现任何中文符号，后边见到的所有的与程序相关的符号都是英文。  
![这里写图片描述][70 10]  
　　使用debug节点观察到的输出的效果如下  
![这里写图片描述][70 11]

## 3.1.4 输入ASCII码 ##

ASCII（American Standard Code for Information Interchange，美国信息交换标准代码）是基于拉丁字母的一套电脑编码系统，主要用于显示现代英语和其他西欧语言。它是现今最通用的单字节编码系统。  
　　在计算机中，所有的数据在存储和运算时都要使用二进制数表示（因为计算机用高电平和低电平分别表示1和0），例如，像a、b、c、d这样的52个字母（包括大写）、以及0、1等数字还有一些常用的符号（例如\*、\#、@等）在计算机中存储时也要使用二进制数来表示，而具体用哪些二进制数字表示哪个符号，当然每个人都可以约定自己的一套（这就叫编码），而大家如果要想互相通信而不造成混乱，那么大家就必须使用相同的编码规则，于是美国有关的标准化组织就出台了ASCII编码，统一规定了上述常用符号用哪些二进制数来表示。  
　　由此可以看出，ASCII码对于英文字符的显示很重要。例如，我们想让电脑显示大写字符H，需要用H对应的ASCII码，也就是72来表示。这个72并不代表数字的72，因为数字的72由数字7与数字2的ASCII码来表示，也就是55与50。  
Inject的二进制流可以很方便的进行ASCII码与字符的转换。在“内容”输入框中输入一个单词，比如Hello。然后点击输入框右边的扩展按钮。可以看到一个新的页面，“缓冲区编辑器”。点击此页面的“完成”按钮。  
![这里写图片描述][70 12]  
![这里写图片描述][70 13]  
　　可以发现内容输入框已经自动转换为一个数组，而数组的内容正好是“Hello”的每个字符相对应的ASCII码。  
![这里写图片描述][70 14]  
　　在debug节点中可以看到这个数组：  
![这里写图片描述][70 15]  
　　点击数组，可以展开并显示为十六进制。  
![这里写图片描述][70 16]  
　　点击可以切换为字符，正是我们输入的“Hello”  
![这里写图片描述][70 17]  
　　从这个例子来看，如果不是因为可以输出数组，那么把字符转为ASCII码，与直接输出文字列的功能是否雷同？不会的。有一些控制符，比如回车、换行，无法在文字列中输出。但是它们有对应的ASCII码，通过查表可以得知：  
![这里写图片描述][70 18]  
　　回车换行对应的ASCII码值分别是13与10，在“内容”输入框中手动输入13与10即可。  
![这里写图片描述][70 19]

## 3.1.5 主题与名称 ##

节点属性中也可以配置主题（topic）与名称（name）。  
　　我们拖进来一个inject节点，并且更改内容为文字列，Hello World  
![这里写图片描述][70 20]  
　　可以工作区中，节点的名字也是Hello World。  
![这里写图片描述][70 21]  
　　双击debug节点，观察输出，默认是msg.payload。通过下拉菜单把它改为完整信息，并部署。  
![这里写图片描述][70 22]  
　　点击inject节点的输入按钮，可以再调试窗口看到以下信息：  
![这里写图片描述][70 23]  
　　其中：  
\_msgid毫无疑问就是节点的ID，既然是ID当然也就是独一无二的。  
Topic就是主题，里边的内容为空，是因为我们没有设置。  
Payload意思是有效负载或载荷，就是inject节点的内容输入框里的东西。这个名词让人感觉怪怪的，但其实很好理解。如果把数据包比喻为一辆货车，那么ID就是车牌号，topic可以是货车的品牌，payload就是货车上的货物。  
通过以上的观察，我们可以发现，一个数据包至少包括了ID，topic与payload三个成员。  
　　接下来编辑inject节点，在“主题”输入框内输入topic  
![这里写图片描述][70 24]  
　　重新部署，并点击inject节点的按钮，对比调试窗口的信息，可以发现， 新的数据包增加了topic的内容。  
![这里写图片描述][70 25]  
　　接下来修改name。在“名称”输入框内填写name。  
![这里写图片描述][70 26]  
　　可以发现工作区中节点的名字发生变化。  
![这里写图片描述][70 27]  
　　部署并点击输入的按钮，可以观察到，name的信息并没有出现在debug窗口。  
　　以上实验说明：name属性只影响了工作区中节点的外观，并没有影响流中数据包的内容。  
　　Topic是数据包本身带的一个属性，其信息会随着数据包下发。在后续的学习中，有时会用到topic来判断数据包的来源。  
　　其它控件的topic与name属性与此类似，明白inject控件的topic与name如何使用以后，你就可以举一反三了。

## 3.1.6 重复发送 ##

到目前为止，我们使用inject节点给流程注入数据包的方法都是点击节点上的小按钮，这一点也不酷，程序根据我们的设定自己就能工作起来才好玩。而inject节点就有这么一个类似于“闹钟”的功能。  
　　双击编辑inject节点，通过下拉菜单选择“重复”输入框后的内容为“间隔”，然后下边一栏会紧接着出现每隔1秒。数字与单位都可以设置。比如设置为每隔5秒，然后点击完成，部署。  
![这里写图片描述][70 28]  
　　会发现调试窗口以5秒为间隔收到了很多消息。  
![这里写图片描述][70 29]  
　　注意，此时即便是关掉了浏览器，消息依旧会发送。在powershell运行了node-red的服务器，只要服务器没有关闭，流程当然会正常运行。  
　　如果需要让这个流停止工作，可以采用以下办法：  
1 关掉服务器。可以选择关掉powershell，或者在powershell里按下ctrl+c，终止批处理操作。不过这种做法会使其它的流也停止工作。  
2 修改流，断开节点之间的连线并部署。  
3 关掉流，双击流的标签，把状态切换成“无效”。  
![这里写图片描述][70 30]  
![这里写图片描述][70 31]  
　　在“重复”的输入框里，还有另外两个选项，“特定时间”与“特定时间内间隔”。  
![这里写图片描述][70 32]  
　　先来解释“特点时间”，如果按下图设置，则每天12点，都会发出去一串数字，就好像手机定了一个闹钟，每天12点响起一样。  
![这里写图片描述][70 33]  
　　在“特定时间内间隔”就是在特定时间段内重复发送。如下图设置，则每天的8:20,8:40与9:00都会发送数据。  
![这里写图片描述][70 34]  
　　编辑页有一个提示消息：注意: “特定时间内间隔” 和 “特定时间” 会使用cron系统。  
　　详情查看信息页。  
　　如果去查找cron系统的概念，并不好理解这句话的意思。这个提示的意思是，使用”特定时间内间隔” 和 “特定时间”这两个选项的时候，发送消息的时间与程序运行的时间并无关系。接下来举例说明。  
　　例如使用“间隔”发送，每隔1分钟发送一次，这是不使用cron系统的。  
![这里写图片描述][70 35]  
　　我们看到数据包发送的时间是10:03:29，时间有零有整，正是因为程序运行的时间是10:02:29，程序运行1分钟以后发送了这个数据。  
![这里写图片描述][70 36]  
　　接下来使用在“特定时间内间隔”，也每隔1分钟发送一次，这是使用cron系统的。  
![这里写图片描述][70 37]  
　　我们可以发现接收数据包的时间是10:09:00，正好是一个“整”的时间。我并没有掐着表按下部署按键。这说明cron系统的时间只看“整”的时间，或者说“标准的”时间，并不关心程序是什么时候开始运行的。  
![这里写图片描述][70 38]  
　　如果希望在程序一开始运行就发送数据包，可以勾选此框：  
![这里写图片描述][70 39]

[70]: /images/20220522/348d2b1b2f7a49dfa27f71dc72b224b7.png
[70 1]: /images/20220522/426d83e2a95743768aa0159378fa172b.png
[70 2]: /images/20220522/2d8a9fe7075e4bb18d42d2a7b1ffa984.png
[70 3]: /images/20220522/e9497648fe484fd9b63a1eca59d7039e.png
[http_tool.chinaz.com_Tools_unixtime.aspx]: http://tool.chinaz.com/Tools/unixtime.aspx
[70 4]: /images/20220522/998156cd4b8f40cfa9418e35acc39f27.png
[70 5]: /images/20220522/0ab383a617d745caae34b345e2ce957a.png
[70 6]: /images/20220522/88f5e7590f9049b6b8384a40b74e8c5a.png
[70 7]: /images/20220522/ef96fd48c82740e5b5edfca0b93fe1e1.png
[70 8]: /images/20220522/8f941700673041f281b44ecb6f56f2e8.png
[70 9]: /images/20220522/cdb890e261bf4f119619aa170bb7edd4.png
[70 10]: /images/20220522/f8ebdf89e134406d9de382a45dd0a321.png
[70 11]: /images/20220522/18b14838780542168f66b7cd2c2b1409.png
[70 12]: /images/20220522/df94d24fc2bf4d1dbf79a0bfb1fd02d5.png
[70 13]: /images/20220522/848680232e894434b2e6e2846ad03539.png
[70 14]: /images/20220522/637fd645afde4217a447fe40d9869980.png
[70 15]: /images/20220522/350a0b0a64a74fbcbcd845fb7dcff449.png
[70 16]: /images/20220522/235115ef6a174b36ae5b695c005666a9.png
[70 17]: /images/20220522/7b635593005c4bfbb7fc9f062560f2ba.png
[70 18]: /images/20220522/c0f89d19b37b42da918c057c2f08961f.png
[70 19]: /images/20220522/1640bccea5514f7ba9db6352db599dca.png
[70 20]: /images/20220522/2cb81edf16b44342afc179c410045b6e.png
[70 21]: /images/20220522/0e7bb1a5fb624cbd92887bee442f785e.png
[70 22]: /images/20220522/a2f3c053331843d791e06c9b7c4c791a.png
[70 23]: /images/20220522/059d2c0518334858a67431f6103d6d66.png
[70 24]: /images/20220522/22b43fc437f54756beda299893b4a255.png
[70 25]: /images/20220522/c09fdc575b4a47cfbe4bbeee6053cbff.png
[70 26]: /images/20220522/0efa65ed1bb24e559f5e2848b0548ae0.png
[70 27]: /images/20220522/10c78377c21148db8d2a693411b5a8c8.png
[70 28]: /images/20220522/d0ae8de9dcca4c51bcc57ae6a8dae768.png
[70 29]: /images/20220522/87370ddc02434fea8f225cd6ab92a8af.png
[70 30]: /images/20220522/683315b11e714bf2a738fecb6f0b45e5.png
[70 31]: /images/20220522/4628f0c1912045d39a468e58f94338b2.png
[70 32]: /images/20220522/f1e6a5a69433415d94d6b7c4ff7cd7cb.png
[70 33]: /images/20220522/f1e35fa66e994e7880956bbca804ed63.png
[70 34]: /images/20220522/248d40485df54ce6a029e72efd9fd267.png
[70 35]: /images/20220522/b7cc1f63f0a047548107038b96fe63ef.png
[70 36]: /images/20220522/2789e0b581154485b049d82c58ffa6d9.png
[70 37]: /images/20220522/27f91245fe3f4d1da9b409ddbeccf70f.png
[70 38]: /images/20220522/61c63e84d22645fda24a63ab8a28593b.png
[70 39]: /images/20220522/51e86e0044934d98bf95b15635ae2d64.png