仓颉编程语言入门 -- Socket 编程与HTTP 编程概述

仓颉的 Socket 编程概述

在网络通信的广阔天地中，仓颉的Socket编程如同一座桥梁，连接着不同的计算设备，实现了基于传输层协议的数据传输。无论是追求稳定可靠的TCP，还是偏好轻量级、无连接的UDP，Socket都扮演着不可或缺的角色。

可靠传输：TCP

在TCP的舞台上，客户端与服务端精心编排着一场连接与通信的舞蹈。服务端首先优雅地登台，创建并绑定一个监听特定端口的Socket，然后静待有缘人的连接请求。客户端则怀揣着明确的目标地址与端口，创建Socket并发起连接请求。一旦双方牵手成功，这场舞蹈便正式拉开序幕，数据报文的收发变得如丝般顺滑。

TCP服务端示例：

// 假设我们有一个伪代码环境  
let serverPort = 8080  
  
function startTcpServer() {  
    // 创建并绑定服务端Socket  
    let serverSocket = createTcpServerSocket(serverPort)  
    serverSocket.bind()  
  
    // 等待并接受客户端连接  
    let clientSocket = serverSocket.accept()  
  
    // 读取并处理数据  
    let buffer = allocateBuffer(10)  
    let bytesRead = clientSocket.read(buffer)  
    print("Server received: ", buffer.slice(0, bytesRead))  
  
    // 后续可以继续与客户端通信或关闭连接  
}  
  
// 调用函数启动服务器  
startTcpServer()

TCP客户端示例：

let serverIp = "127.0.0.1"  
let serverPort = 8080  
  
function connectToTcpServer() {  
    // 创建客户端Socket并连接到服务器  
    let clientSocket = createTcpSocket(serverIp, serverPort)  
    clientSocket.connect()  
  
    // 发送数据  
    let dataToSend = [1, 2, 3]  
    clientSocket.write(dataToSend)  
  
    // 关闭连接（在实际应用中，根据需求决定是否立即关闭）  
    // clientSocket.close()  
}  
  
// 调用函数连接到服务器  
connectToTcpServer()

不可靠传输：UDP

相比之下，UDP的通信方式则显得更为随性不羁。无需建立连接，数据报文的发送与接收都更加直接且高效，但代价是牺牲了可靠性。在UDP的世界里，服务端与客户端的角色不再那么泾渭分明，每个套接字都是独立的舞者，自由地发送与接收来自四面八方的数据。

UDP服务端示例：

let serverPort = 8080  
  
function startUdpServer() {  
    // 创建并绑定UDP Socket  
    let serverSocket = createUdpSocket(serverPort)  
    serverSocket.bind()  
  
    // 接收数据  
    let buffer = allocateBuffer(3)  
    let (senderAddress, bytesRead) = serverSocket.receiveFrom(buffer)  
    print("Received from ", senderAddress, ": ", buffer.slice(0, bytesRead))  
}  
  
// 异步启动UDP服务器  
asyncStart(startUdpServer)

UDP客户端示例：

let serverIp = "127.0.0.1"  
let serverPort = 8080  
  
function sendUdpData() {  
    // 创建UDP Socket并绑定（有时可以省略绑定步骤）  
    let clientSocket = createUdpSocket()  
    // 客户端通常不需要显式绑定，除非有特定需求  
    // clientSocket.bind(anyLocalPort)  
  
    // 发送数据到服务器  
    let dataToSend = [1, 2, 3]  
    clientSocket.sendTo(serverIp, serverPort, dataToSend)  
  
    // 无需关闭连接，UDP是无连接的  
}  
  
// 调用函数发送数据  
sendUdpData()

HTTP 编程

HTTP 协议，作为互联网上的通用语言，通过请求与响应的交互模式，在客户端与服务端之间架起了一座数据传输的桥梁。每当用户通过浏览器或其他客户端软件访问网络资源时，都会发送一个HTTP请求给服务器，而服务器则根据请求的内容返回相应的HTTP响应。这些请求和响应都遵循着固定的格式，包括报文头和报文体，确保了数据传输的准确性和完整性。

在HTTP的请求类型中，GET和POST是最为常用的两种。GET请求主要用于从服务器请求数据，其特点是在请求行中直接包含要访问的资源路径，且请求体中不包含数据（尽管实际上GET请求也可能带有查询字符串，但这通常不被视为请求体的一部分）。而POST请求则用于向服务器提交数据，这些数据被放置在请求体中，并通过一个空行与请求头分隔开。

仓颉框架，作为一款强大的网络开发工具，支持HTTP 1.0、1.1及2.0等多个协议版本，让开发者能够轻松构建高性能的客户端和服务端应用。通过利用仓颉提供的HttpRequestBuilder和HttpResponseBuilder类，开发者可以灵活地构造符合RFC 9110、9112、9113、9218、7541等标准规范的HTTP请求和响应报文。

下面是一个使用仓颉框架进行客户端和服务端编程的示例。在这个示例中，服务端将监听本地8080端口，并注册了一个处理"/hello"路径的请求处理器。当客户端发送GET请求到"/hello"时，服务端将返回"Hello Cangjie!"作为响应体。

服务端代码：

import 'net.http.dart';  
import 'std.time.dart';  
import 'std.sync.dart';  
  
void startServer() {  
    // 1. 初始化并配置Server实例  
    var server = ServerBuilder()  
                    .address("127.0.0.1")  
                    .port(8080)  
                    .build();  
      
    // 2. 注册路由处理函数  
    server.router.addRoute("/hello", (HttpContext httpContext) {  
        httpContext.response.body = "Hello Cangjie!";  
    });  
      
    // 3. 启动服务器监听  
    server.listen();  
}  
  
void main() {  
    spawn(startServer);  
    sleep(Duration.seconds(1));  
    startClient(); // 假设startClient在后续调用，实际中可能需要其他方式触发  
}  
  
// 注意：这里假设了startClient函数已经定义，并且会在服务端启动后适当时间被调用  
// 实际情况下，你可能需要在另一个脚本或程序中启动客户端，或者使用某种形式的同步/异步机制