Project Loom C5M 使用指南

项目概述

本指南旨在提供关于如何操作和理解名为“Project Loom C5M”的开源项目，它利用了Project Loom的虚拟线程技术来达成在Java应用中建立5百万个持久连接的目标。该实验灵感来源于经典的“C10k”问题，展示的是现代并发技术在处理大规模连接场景中的能力。

1. 目录结构及介绍

project-loom-c5m/
├── src                        # 源代码目录
│   └── main                  # 主要源代码
│       └── java               # Java源码位置
│           └── loomtest        # 实验的核心包
│               ├── EchoClient.java  # 客户端类，负责建立连接并发送/接收消息
│               └── EchoServer.java  # 服务端类，用于监听端口并回应收到的消息
├── .gitignore                # Git忽略文件配置
├── LICENSE                   # 项目的MIT授权协议文件
├── README.md                 # 项目的主要说明文档
├── pom.xml                   # Maven构建文件，定义依赖和构建步骤
└── 更多支持和配置文件...

项目的核心在于src/main/java/loomtest目录下的EchoClient和EchoServer，这两个类是实现实验的关键部分。

2. 启动文件介绍

2.1 EchoServer启动

服务端通过执行Java命令并指定相关参数来启动，示例如下：

/jdk-19/bin/java --enable-preview -ea -cp project-loom-scale-1.0.0-SNAPSHOT.jar loomtest.EchoServer <host> <port> <portCount> <backlog> <bufferSize>

其中参数意义分别为：

• <host>: 服务器地址，默认可为空以监听所有网络接口。
• <port>: 开始监听的TCP端口。
• <portCount>: 将要监听的端口数量。
• <backlog>: 链接队列大小。
• <bufferSize>: 缓冲区大小。

2.2 EchoClient启动

客户端同样通过类似的Java命令启动，其参数更具挑战性，用于模拟大量连接并发送消息：

/jdk-19/bin/java --enable-preview -ea -cp project-loom-scale-1.0.0-SNAPSHOT.jar loomtest.EchoClient <host> <port> <portCount> <numConnections> <socketTimeout> <warmUp> <sleep>

参数解释：

• <host>: 目标服务器地址。
• <port>: 目标端口范围的起始点。
• <portCount>: 要尝试连接的端口数。
• <numConnections>: 单一客户端要建立的连接数。
• <socketTimeout>: 套接字超时时间。
• <warmUp>: 预热时间（准备阶段）。
• <sleep>: 发送消息之间的休眠时间。

3. 配置文件介绍

本项目主要依赖Maven的pom.xml作为构建配置文件，不直接含有传统意义上的独立配置文件。所有的环境配置和依赖管理都包含在pom.xml中。开发者可通过编辑此文件添加额外的依赖、调整编译设置等。此外，启动服务或客户端时使用的命令行参数，可以视为运行时配置的一部分，需手动输入，而非来自预设的配置文件。

---

请注意，在实际操作前，确保你的开发环境已准备好OpenJDK Project Loom的相应版本，并且熟悉Java的最新并发特性和启用预览功能的使用。