cn.hutool.core.net

Class LocalPortGenerater

java.lang.Object

cn.hutool.core.net.LocalPortGenerater

All Implemented Interfaces:

Serializable

public class LocalPortGenerater
extends Object
implements Serializable

本地端口生成器（LocalPortGenerator）。

当前类名中“Generater”为拼写错误（正确应为 Generator），为保持兼容性暂未更改。 该问题将在后续大版本中以重命名方式修复，并保留旧类名的弃用（@Deprecated）兼容层。

用于从指定起点开始递增探测一个当前“可用”的本地端口。探测通过短暂绑定 ServerSocket（以及可选 UDP DatagramSocket）完成，但不会真正占用端口。

注意：

• 该方法执行的是端口“探测”，非“分配”，返回端口不保证实际使用时仍然可用。
• 存在 TOCTOU（检测到使用之间）竞态，多线程下可能返回同一端口。
• UDP 探测可能导致误判（TCP 可用但 UDP 被占用）。
• 不适合作为生产级端口分配策略，推荐使用 new ServerSocket(0)。

未来版本计划：

• 修复类名拼写问题：将“Generater”更名为 “Generator”。
• 提供真正可靠的端口获取实现（绑定即占用，避免竞态）。
• 优化探测策略，减少不必要的 UDP 检测。
• 提供更安全的随机端口生成 API。

Since:

4.0.3

Author:

looly

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
LocalPortGenerater(int beginPort) 构造

Method Summary

Modifier and Type	Method and Description
int	generate() 生成一个本地端口，用于远程端口映射

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LocalPortGenerater

public LocalPortGenerater(int beginPort)

构造

Parameters:

beginPort - 起始端口号

Method Detail

generate

public int generate()

生成一个本地端口，用于远程端口映射

Returns:

未被使用的本地端口