diff --git a/docx/CHANGELOG.md b/docx/CHANGELOG.md index 865d368..c79419a 100644 --- a/docx/CHANGELOG.md +++ b/docx/CHANGELOG.md @@ -5,7 +5,7 @@ 1. *工作线程* 动作支持选择是否立即运行。 2. *监听鼠标* 动作支持鼠标侧键。 3. *For*(循环)动作名称变更为 *ForEach*(迭代)动作,功能不变。 -4. *IterParam*(迭代参数)动作名称变更为 *IterValue*(迭代数据)动作,并支持设置默认参数,功能不变。 +4. *IterParam*(迭代参数)动作名称变更为 *ParamGet*(参数获取)动作,并支持设置默认参数,功能不变。 5. 增加 *StandardPath*(标准路径)动作,用来表示系统常用路径。 ### Deprecated: diff --git a/docx/_sidebar.md b/docx/_sidebar.md index 45e12a3..033b94b 100644 --- a/docx/_sidebar.md +++ b/docx/_sidebar.md @@ -122,10 +122,10 @@ - [HEAD 请求](./actions/network/HttpHead.md) - [GET 请求](./actions/network/HttpGet.md) - [POST 请求](./actions/network/HttpPost.md) - - [监听](./actions/network/TcpListen.md) - - [发送](./actions/network/TcpSend.md) - - [接收](./actions/network/TcpReceive.md) - - [连接](./actions/network/TcpConnect.md) + - [商品监听](./actions/network/TcpListen.md) + - [数据发送](./actions/network/TcpSend.md) + - [数据接收](./actions/network/TcpReceive.md) + - [服务连接](./actions/network/TcpConnect.md) - 统计分析 - [文档](./actions/xml/XmlLoadDocument.md) - [获取节点](./actions/xml/XmlGetNodeList.md) @@ -150,7 +150,7 @@ - [算术运行](./actions/control/ArithmeticCalculate.md) - [逻辑运算](./actions/control/LogicalOperator.md) - [关系运算](./actions/control/RelationalOperator.md) - - [传入参数](./actions/control/InputParam.md) + - [参数获取](./actions/control/ParamGet.md) - 算法 - [分割字符串](./actions/algorithm/SplitString.md) - [非零像素点](./actions/algorithm/FindNonZero.md) diff --git a/docx/actions/control/InputParam.md b/docx/actions/control/InputParam.md deleted file mode 100644 index 7a5e163..0000000 --- a/docx/actions/control/InputParam.md +++ /dev/null @@ -1,29 +0,0 @@ -# 传入参数 -通常做为子动作,其值由相应的父动作传入。通常列表都会支持子动作,列表的每个元素都会传递给该动作。 - -![action](./images/2022-11-17_184608.png ':size=90%') - -## 子流程 - -> 不支持 - -## 运行参数 - - - - -## 输出 - -> 无 - - -## 脚本调用 - -```python -import simple - - -``` - -## 示例 - diff --git a/docx/actions/control/ParamGet.md b/docx/actions/control/ParamGet.md new file mode 100644 index 0000000..286eb9e --- /dev/null +++ b/docx/actions/control/ParamGet.md @@ -0,0 +1,29 @@ +# 参数获取 +通常做为子动作,其值由相应的父动作传入。例如在返回列表的子动作中添加该动作,则列表的每个元素都会传递给该动作。 + +![action](./images/2022-11-17_184608.png ':size=90%') + +## 子流程 + +> 不支持 + +## 运行参数 + + + + +## 输出 + +> 无 + + +## 脚本调用 + +```python +import simple + + +``` + +## 示例 + diff --git a/docx/actions/network/TcpConnect.md b/docx/actions/network/TcpConnect.md index 236e7e2..48b305b 100644 --- a/docx/actions/network/TcpConnect.md +++ b/docx/actions/network/TcpConnect.md @@ -1,5 +1,7 @@ -# 连接 -此动作通过TCP或者UDP连接服务端。 +# 服务连接 +连接网络服务端。 + +* *UDP* 是无连接协议,因此 基于*UDP* 协议的网络,直接发送或者接收数据即可,无需连接服务。 ![action](./images/07.png ':size=90%') @@ -9,13 +11,17 @@ ## 运行参数 +* 主机 +> 服务器 IP 地址。 -* Host Address: 监听的IP, 默认`127.0.0.1` -* Port Number: 监听的端口 -* Type: 类型,分为`TCP` 或者`UDP` +* 端口 +> 远程端口 -## 输出 `Socket` +* 类型 +> 网络协议,`TCP`。 +## 输出 +> 套接字,可用于读取或者发送数据,参考:[Socket](../types/Socket.md)。 ## 脚本调用 @@ -26,6 +32,6 @@ import simple; ### 示例 -[https://github.com/shelllet/WinUi/blob/main/network/connect.simple](https://github.com/shelllet/WinUi/blob/main/network/connect.simple) +示例: https://github.com/shelllet/WinUi/blob/main/network/TcpListen.simple diff --git a/docx/actions/network/TcpListen.md b/docx/actions/network/TcpListen.md index bcd26aa..d344841 100644 --- a/docx/actions/network/TcpListen.md +++ b/docx/actions/network/TcpListen.md @@ -1,20 +1,24 @@ -# 监听 -此动作用来创建TCP或者UDP服务端。 +# 端口监听 +创建一个网络服务端。 -![action](./images/01.png ':size=90%') +* *UDP* 是无连接协议,因此 基于*UDP* 协议的网络,直接发送或者接收数据即可,无需监听端口。 + +![TcpListen](./images/01.png ':size=90%') ## 子动作 -> 不支持 +> 不支持,客户端连接的 *套接字*会传入子流程中。 ## 运行参数 -* Host Address: 监听的IP, 可忽略,默认`127.0.0.1` -* Port Number: 监听的端口 -* Type: 类型,分为`TCP` 或者`UDP` +* 端口 +> 监听的本地端口 +* 类型 +> 网络协议,支持 `TCP`协议。 -## 输出 无 +## 输出 +> 参考[IOContext](../types/IOContext.md)。 ### 脚本调用 @@ -23,7 +27,7 @@ import simple; ``` -### 示例 +### 资源 -[https://github.com/shelllet/WinUi/blob/main/network/listen.simple](https://github.com/shelllet/WinUi/blob/main/network/listen.simple) +示例: https://github.com/shelllet/WinUi/blob/main/network/TcpListen.simple diff --git a/docx/actions/network/TcpReceive.md b/docx/actions/network/TcpReceive.md index edf3a2c..bdcb993 100644 --- a/docx/actions/network/TcpReceive.md +++ b/docx/actions/network/TcpReceive.md @@ -1,5 +1,5 @@ -# 接收 -此动作通过TCP或者UDP接收数据。 +# 数据接收 +接收网络数据。 ![action](./images/05.png ':size=90%') @@ -8,11 +8,14 @@ ## 运行参数 -* Socket: 套接字, 可以通过`监听`动作的子动作获取, 或者由`连接`动作获取。 +* 主机 + +> 如果是 *TCP* 协议, 参考 [`TcpListen`(监听)](../actions/network/TcpListen.md) 动作的子动作获取, 或者由[`TcpConnect`(连接)](../actions/network/TcpConnect.md)动作获取。如果是*UDP* 协议,该参数是主机地址,参考:[主机地址](../types/ScocketAddress.md)。 + ## 输出 -> 由`发送`动作所发送的数据。 +> 收到的数据,参考:[字符串](../types/String.md)。 ## 脚本调用 @@ -24,5 +27,5 @@ import simple; ## 示例 -[https://github.com/shelllet/WinUi/blob/main/network/receive.simple](https://github.com/shelllet/WinUi/blob/main/network/receive.simple) +示例: https://github.com/shelllet/WinUi/blob/main/network/TcpListen.simple diff --git a/docx/actions/network/TcpSend.md b/docx/actions/network/TcpSend.md index 0000248..558c9c3 100644 --- a/docx/actions/network/TcpSend.md +++ b/docx/actions/network/TcpSend.md @@ -1,5 +1,5 @@ -# 发送 -此动作通过TCP或者UDP发送数据。 +# 数据发送 +通过网络,发送数据。 ![action](./images/03.png ':size=90%') @@ -10,11 +10,15 @@ -* Socket: 套接字, 可以通过`监听`动作的子动作获取, 或者由`连接`动作获取。 -* Value: 发送的数据。 +* 主机 +>> 如果是 *TCP* 协议, 参考 [`TcpListen`(监听)](../actions/network/TcpListen.md) 动作的子动作获取, 或者由[`TcpConnect`(连接)](../actions/network/TcpConnect.md)动作获取。如果是*UDP* 协议,该参数是主机地址,参考:[主机地址](../types/ScocketAddress.md)。 -## 输出 无 +* 数据 +> 发送的数据。该数据会被序列化成[字符串](../types/String.md)发送。 +## 输出 + +> 无 ### 脚本调用 @@ -25,5 +29,5 @@ import simple; ### 示例 -[https://github.com/shelllet/WinUi/blob/main/network/send.simple](https://github.com/shelllet/WinUi/blob/main/network/send.simple) +示例: https://github.com/shelllet/WinUi/blob/main/network/TcpListen.simple diff --git a/docx/types/IOContext.md b/docx/types/IOContext.md new file mode 100644 index 0000000..7b346b1 --- /dev/null +++ b/docx/types/IOContext.md @@ -0,0 +1,3 @@ +# IOContext + +Class `IOContext` \ No newline at end of file diff --git a/docx/types/SocketAddress.md b/docx/types/SocketAddress.md new file mode 100644 index 0000000..76601f5 --- /dev/null +++ b/docx/types/SocketAddress.md @@ -0,0 +1,3 @@ +# SocketAddress + +Class `SocketAddress`, 代表 Internet(IP)端点/套接字地址。该地址可以属于IPv4或IPv6地址家族,由主机地址和端口号组成。 \ No newline at end of file