# 服务端写数据到客户端 - 问题解答

## 问题

1. 服务端如何写数据到客户端？
2. 是否支持any类型？
3. 通过协议自动匹配编码器？

## 答案

### 1. 服务端如何写数据到客户端？

nnet库提供了多种方式将数据从服务端写入到客户端：

#### 方式一：直接写入字节数据
```go
func handler(ctx ctxpkg.Context) error {
    data := []byte("Hello, World!")
    return ctx.Write(data)
}
```

#### 方式二：写入字符串
```go
func handler(ctx ctxpkg.Context) error {
    return ctx.WriteString("Hello, World!")
}
```

#### 方式三：写入任意类型（自动编码）⭐ **推荐**
```go
type Response struct {
    Code    int    `json:"code"`
    Message string `json:"message"`
    Data    interface{} `json:"data"`
}

func handler(ctx ctxpkg.Context) error {
    resp := Response{
        Code:    200,
        Message: "success",
        Data:    map[string]interface{}{"user_id": 123},
    }
    // 自动使用配置的默认编解码器（库默认是 binary）
    return ctx.WriteAny(resp)
}
```

### 2. 是否支持any类型？

**是的，完全支持！**

nnet库支持写入任意Go类型：
- ✅ 结构体（struct）
- ✅ 映射（map）
- ✅ 切片（slice）
- ✅ 数组（array）
- ✅ 基本类型（int, string, bool等）
- ✅ 接口类型（interface{}）

使用`ctx.WriteAny(data)`方法，nnet会自动：
1. 检测数据类型
2. 选择合适的编解码器
3. 编码数据
4. 写入客户端

### 3. 通过协议自动匹配编码器？

**是的，完全支持！**

nnet库提供了**自动编解码器匹配**功能：

#### 自动匹配机制

1. **默认编解码器**：根据配置自动选择默认编解码器（库默认 binary）
   ```go
   cfg := &nnet.Config{
       Codec: &nnet.CodecConfig{
          DefaultCodec: "json",  // 显式使用JSON
       },
   }
   ```

2. **自动编码**：使用`WriteAny`时，自动使用默认编解码器（默认 binary）
   ```go
   ctx.WriteAny(data)  // 自动使用JSON编码
   ```

3. **指定编解码器**：可以指定使用哪个编解码器
   ```go
   ctx.WriteAnyWithCodec(data, "json")      // 使用JSON
   ctx.WriteAnyWithCodec(data, "msgpack")   // 使用MessagePack
   ctx.WriteAnyWithCodec(data, "protobuf")  // 使用Protobuf
   ```

#### 协议层编码（可选）

nnet还支持**协议层编码**，可以在编解码器编码的基础上，再进行协议层编码：

```go
cfg := &nnet.Config{
    Codec: &nnet.CodecConfig{
        DefaultCodec:         "json",
        EnableProtocolEncode: true,  // 启用协议层编码
    },
}
```

启用后，数据会经过：
1. **编解码器编码**：Go对象 → JSON字节数组
2. **协议编码**：JSON字节数组 → nnet协议格式（包含Magic、长度、校验和等）

## 完整示例

```go
package main

import (
    "github.com/noahlann/nnet"
    ctxpkg "github.com/noahlann/nnet/pkg/context"
)

type User struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
}

type Response struct {
    Code int         `json:"code"`
    Data interface{} `json:"data"`
}

func main() {
    // 配置服务器（启用自动编解码器匹配）
    cfg := &nnet.Config{
        Addr: "tcp://:8080",
        Codec: &nnet.CodecConfig{
            DefaultCodec:         "json",  // 显式使用JSON
            EnableProtocolEncode: false,   // 不启用协议层编码
        },
    }

    // 创建服务器
    server, err := nnet.NewServer(cfg)
    if err != nil {
        panic(err)
    }

    // 注册路由处理器
    server.Router().RegisterString("get_user", func(ctx ctxpkg.Context) error {
        user := User{ID: 1, Name: "Alice"}
        resp := Response{Code: 200, Data: user}
        
        // 方式1：自动使用JSON编码（推荐）
        return ctx.WriteAny(resp)
        
        // 方式2：指定使用MessagePack编码
        // return ctx.WriteAnyWithCodec(resp, "msgpack")
        
        // 方式3：直接写入字符串
        // return ctx.WriteString("Hello, World!")
    })

    // 启动服务器
    server.Start()
}
```

## 支持的编解码器

nnet库自动注册以下编解码器：
- **JSON**（可选，默认 binary）：支持所有可序列化的Go类型
- **Binary**：支持基本数值类型和字节数组
- **Protobuf**：需要实现`proto.Message`接口
- **MessagePack**：支持所有可序列化的Go类型

## 自定义编解码器

```go
// 注册自定义编解码器
server.CodecRegistry().Register("mycodec", myCodec)

// 使用自定义编解码器
ctx.WriteAnyWithCodec(data, "mycodec")
```

## 总结

✅ **服务端写数据**：支持`Write`、`WriteString`、`WriteAny`三种方式
✅ **支持any类型**：完全支持任意Go类型
✅ **自动匹配编码器**：根据配置自动选择编解码器，也可以手动指定
✅ **协议层编码**：可选地支持协议层编码（如nnet协议）

所有功能已实现并测试通过！