通信

HTTP服务器

在指定端口启动本地 HTTP 服务，按固定响应体、状态码与内容类型应答每个请求，支持启动、停止与查看最近请求，输出执行状态、活动连接数、累计请求数与最近请求内容
HttpServerTool · v1.0 · by system

输入参数 6

名称	keyId	类型	默认值	可连接	说明
通信通道ID	`commId`	enum	（空）	否	非空时按该标识复用由通信中心托管的常驻服务器，响应配置写入共享接收状态，启动与停止作用于整个共享实例；留空则使用本工具自管的服务器，此时监听端口等参数由下方输入直接提供
监听端口	`port`	int	8080	否	服务器监听的 TCP 端口，默认 8080，合法范围为 1 至 65535；取值缺失、为 0、为负或超过 65535 时返回 -1 并在运行信息提示端口缺失或非法，启动时按该端口绑定，常驻模式下还会用它匹配共享实例
操作	`operation`	enum	start	否	本次调用执行的动作，默认 start；start 在指定端口启动监听并以固定配置应答，服务器已在运行时不会重复启动，stop 停止监听并清零连接与请求计数，request 用于取回最近一次收到的请求，未识别的操作返回 -1
响应体	`response`	string	{}	否	服务对每个请求原样返回的固定响应正文，默认 {}；启动时读入并在应答回调中作为响应体写出，留空即返回空正文，常驻模式下该值也会写入共享接收状态供后续请求使用
状态码	`status`	int	200	否	服务应答时使用的固定 HTTP 状态码，默认 200；启动时读入并随每个请求的响应一并回送，不随实际请求内容变化，常驻模式下该值同样写入共享接收状态
Content-Type	`contentType`	string	application/json	否	服务应答时写入响应头的固定内容类型，默认 application/json；启动时读入并用于每个请求的 Content-Type 应答头，常驻模式下也会同步到共享接收状态，与响应体和状态码配套

输出参数 5

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=成功启动、停止或确认服务器已在运行；-1=端口缺失或非法、启动失败、常驻服务器建立失败、共享接收态不可用或操作无法识别，运行信息写明具体原因
运行信息	`resultInfo`	string	—	否	本次操作的文字描述，成功时提示已在运行无需重复启动、服务器已启动、已停止或常驻服务器已就绪，失败时给出端口缺失或非法、启动失败、常驻启动失败或未知操作等原因
活动连接数	`active_count`	int	—	否	当前与服务器保持的活动连接数量，停止服务后归零；使用常驻服务器时该值固定为 0，因为连接由通信中心统一管理，可据此区分自管与共享两种运行方式
累计请求数	`total_requests`	int	—	否	服务器启动以来累计收到的请求次数，停止服务后清零；常驻模式下该值固定为 0，由共享接收状态接管计数，每次调用都会随执行结果一并输出
最近请求	`last_request`	string	—	否	最近一次收到请求的 JSON 文本，依次记录请求方法、路径与正文三个字段；每次调用都会输出当前记录，自管服务器在启动时会清空该记录，常驻模式下沿用共享接收状态中的记录

接入方式

在 FlowDesigner 中将「HTTP服务器」节点加入流程画布，把上游图像或数据连接至「通信通道ID」，并将「运行结果」接至下游节点。运行后可通过 VisionQuick 的数据绑定将结果呈现在界面组件上。

完整操作步骤参见使用文档；安装与使用问题可通过联系页反馈。

← gRPC客户端返回通信 gRPC服务器 →

联系与反馈

获取安装包与技术反馈

安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。

安装包获取与部署说明
界面组态与工具配置
功能建议与问题反馈

微信扫码 · 安装包与问题反馈