Skip to main content
TCP Server 端口支援託管通用介面,透過 TCP 接收任意資料。

核心功能

  • 通用 TCP/IP 伺服器端點,支援 TLS/SSL 和明文傳輸,適用於任意資料流
  • 可配置的訊息分隔,支援使用靜態分隔符號或基於長度的解析
  • 具備雙向通訊能力,支援基於連線 ID 的路由和連線事件訊息

概觀

每個 TCP Server 端口都會在指定的端口上監聽傳入的 TCP 流量,可以是 TLS/SSL 加密,也可以是純文字。該端口適用於 需要接收不一定符合其它標準協議提供的約束的任意資料時的情況。 由於 TCP 流量是一個恆定的流,本質上沒有”開始”或”結束”點,因此必須對端口進行配置,以確定一個訊息的結束點和下一個訊息的開始點。端口支援兩種方法:
  • 一個靜態的字串/字元分隔符號,用於結束當前訊息或開始下一個訊息。
  • 讀取傳入的 TCP 資料中的一個值,以確定資訊的長度。
對於第二種方式,端口需要一個偏移量(從第一個位元組後多少個位元組開始讀取訊息長度)和一個大小(從偏移量開始讀取長度值,要讀取多少個位元組)。如果訊息的長度是訊息的”頭”中的第一個值,那麼偏移量應該是 0。 一旦達到分隔符號或長度,端口將向 工作流程推送包含透過 TCP 接收的原始資料的訊息。 TCP Server 端口還可以在用戶端連線或斷開連線時生成 訊息,以提醒工作流程中的其它處理程序。更多資訊可參見連線和斷開訊息部分。 有關向 TCP 用戶端傳送回應的資訊,請參見傳送訊息部分。

端口配置

設定索引標籤

配置

與端口關鍵配置有關的設定。

訊息解碼

與區分 TCP 流中的單個訊息有關的設定。

TLS 設定

與 TLS/SSL 傳輸安全相關的設定。

進階設定索引標籤

保持活動

與伺服器傳送 keep-alive 資料包以保持空閒連線有關的設定。

進階設定

先前目錄中未包含的設定。

訊息

日誌

雜項設定

伺服器索引標籤

受信任的 IP 地址

自動化索引標籤

自動化

與端口自動處理檔案相關的設定。

效能

告警索引標籤

SLA 索引標籤

日誌索引標籤

連線和斷開訊息

預設情況下,TCP Server 端口僅在用戶端傳輸資料時生成 訊息,以便端口識別完整的訊息(根據訊息解碼部分的設定)。當用戶端連線到伺服器(如果在進階設定索引標籤中啟用了連線訊息)或斷開與伺服器的連線(如果在進階設定索引標籤中啟用了斷開訊息)時,端口也可以生成 訊息。 當這些特殊訊息生成後, 訊息中會新增一個特殊的標頭: x-tcpserver-event 用戶端連線時,此標頭設定為值 connected,而用戶端斷開連線時,此標頭設定為 disconnected 該標頭必須由工作流程中之後的端口檢查,以檢測寫入 TCP Server 端口輸出資料夾的訊息是否屬於這些特殊訊息。

傳送訊息

TCP Server 端口還使用一個特殊的標頭值來向連線的用戶端傳送訊息: x-tcpserver-connectionid 該標頭被新增到端口生成的任何輸出訊息中,設定為 “Connection ID” 值,以唯一標識所連線的用戶端之一。為了確保訊息被傳送到正確的用戶端,被傳送回此用戶端的訊息 必須 將此相同的標頭設定為相同的值。 由於該標頭已經存在於端口寫出的任何訊息中,因此如果訊息透過 工作流程並傳回 TCP Server 端口的交易索引標籤,它仍將具有相同的 “Connection ID” 值,並將傳回給傳送原始訊息的同一個用戶端。如果訊息不能直接路由回 TCP Server 端口,那麼必須儲存 “Connection ID” 值,並將其作為一個標頭(與上面列出的名稱相同)應用到任何傳回給用戶端的新訊息中。

範例