https://github.com/hcengine/hcnet
rust net wrap, support tcp/websocket/udp 网络层封装, 可以轻松的切换网络
https://github.com/hcengine/hcnet
kcp net tcp udp websocket websocket-client websocket-server
Last synced: 3 months ago
JSON representation
rust net wrap, support tcp/websocket/udp 网络层封装, 可以轻松的切换网络
- Host: GitHub
- URL: https://github.com/hcengine/hcnet
- Owner: hcengine
- License: mit
- Created: 2024-09-26T02:55:00.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-18T09:08:55.000Z (over 1 year ago)
- Last Synced: 2025-10-30T08:57:23.411Z (8 months ago)
- Topics: kcp, net, tcp, udp, websocket, websocket-client, websocket-server
- Language: Rust
- Homepage:
- Size: 113 KB
- Stars: 5
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# hcnet
虚拟化服务端及客户端的底层，可以轻松的切换tcp/tcps/ws/wss/udp等协议， 以方便在任意情况下切换协议。后续例如在线数，流控等需求再来进行处理。
## 回调处理
统一用回调进行处理函数
```rust
/// 连接处理回调函数
#[async_trait]
pub trait Handler {
/// 此接口只有在服务端接受服务时进行触发
/// 接收新的端口连接, 如果处理将在此触发
async fn on_accept(&mut self, conn: NetConn) -> NetResult<()> {
let _conn = conn;
unreachable!("Listener must impl accept")
}
/// 此接口在可以发送消息时触发
/// 例如websocket将在握手成功后触发该函数
async fn on_open(&mut self) -> NetResult<()> {
trace!("ws on_open");
Ok(())
}
/// 此接口在远程服务端被关闭时进行触发
async fn on_close(&mut self, code: CloseCode, reason: String) {
trace!(
"on_close code = {}, reason = {reason}",
Into::::into(code)
);
}
/// ping消息收到, 将会自动返回pong消息
async fn on_ping(&mut self, data: Vec) -> NetResult>> {
trace!("on_ping");
Ok(Some(data))
}
/// pong消息
async fn on_pong(&mut self, data: Vec) -> NetResult<()> {
let _data = data;
trace!("on_pong");
Ok(())
}
/// message信息收到
async fn on_message(&mut self, msg: Message) -> NetResult<()> {
let _ = msg;
Ok(())
}
async fn on_request(&mut self, req: Request>) -> NetResult>> {
WsHandshake::build_request(&req)
}
async fn on_response(&mut self, res: Request>) -> NetResult<()> {
let _ = res;
Ok(())
}
}
```
## 服务端监听
#### tcp监听
```rust
NetConn::tcp_bind("0.0.0.0:2003", Settings::default()).await
```
#### ws监听
```rust
NetConn::ws_bind("0.0.0.0:2003", Settings::default()).await
```
#### wss监听
监听时将证书信息配置即可轻松的支持wss协议
```rust
let mut settings = Settings {
domain: Some("test.wmproxy.net".to_string()),
cert: Some("key/example.com.pem".to_string()),
key: Some("key/example.com.key".to_string()),
..Settings::default()
};
NetConn::ws_bind("0.0.0.0:2003", settings).await
```
#### kcp(udp)监听
```rust
NetConn::kcp_bind("0.0.0.0:2003").await
```
基本上监听和一般的socket监听一致，复杂程度类似，即可任意切换任何协议。
### 服务端启动监听
```rust
let h = conn.run_handler(|_| ServerHandler).await.unwrap();
let _ = tokio::join!(h);
```
具体示例可参考[server_echo](./examples/server_echo.rs)
## 客户端连接
#### tcp连接
```rust
NetConn::tcp_connect("127.0.0.1:2003").await
```
#### ws连接
```rust
NetConn::ws_connect("ws://example.com:2003").await
```
#### wss连接
```rust
NetConn::ws_connect("wss://example.com:2003").await
```
#### kcp(udp)连接
```rust
NetConn::kcp_connect("wss://example.com:2003").await
```
### 客户端启动监听
```rust
let (mut sender, receiver) = NetSender::new(10, 1);
let _ = conn.run_with_handler(
ClientHandler {
sender: sender.clone(),
},
receiver,
).await;
```
或者
```rust
let _ = conn.run_handler(|sender| ClientHandler { sender }).await;
```
具体示例可参考[client_echo](./examples/client_echo.rs)
## 启动demo
先启动服务端
```bash
cargo run --example server_echo tcp
```
再启动客户端
```bash
cargo run --example client_echo tcp
```