使用Netty4实现基本的消息分发

示例工程代码

可从附件下载

具体的说明和用法在后面介绍

需求与目的

一个游戏服务端需要处理各种业务逻辑，每一种业务逻辑都对应着一个请求消息和一个响应消息。那么服务端需要把这些不同的消息自动分发到对应的业务逻辑中处理。

最简单的处理方式就是根据请求消息中的type字段，使用switch case来进行分别处理，但这种方式随着消息的增多，显现了一些坏味道：长长的一大坨不太好看；如果要添加新的消息、新的逻辑，或者去掉新的消息、新的逻辑，在代码上不但要修改这些消息和逻辑，还不得不修改这长长的一坨swtich case，这样的修改显得很多余。

所以我们的目的就是把消息分发这块的代码自动化，在增加、修改、删除消息和逻辑的时候不需要再对消息分发的代码再做修改，从而使得修改的代码最小化。

实现原理

在实现中，使用了注解（annotation）

1. package com.company.game.dispatcher.annotation;
2. import java.lang.annotation.ElementType;
3. import java.lang.annotation.Retention;
4. import java.lang.annotation.RetentionPolicy;
5. import java.lang.annotation.Target;
6. /**
7. * 修饰消息类和业务逻辑执行类
8. * msgType指定对应的类型，从1开始计数
9. * @author xingchencheng
10. *
11. */
12. @Target(ElementType.TYPE)
13. @Retention(RetentionPolicy.RUNTIME)
14. public @interface UserMsgAndExecAnnotation {
15. short msgType();
16. }

唯一的字段msgType代表了消息类型，这是客户端与服务端的约定，这里我们从1开始计数。

当我们要增加一个加法消息时，就使用这个注解来修饰我们的请求消息类：

1. package com.company.game.dispatcher.msg;
2. import com.company.game.dispatcher.annotation.UserMsgAndExecAnnotation;
3. /**
4. * 加法请求消息类
5. *
6. * @author xingchencheng
7. *
8. */
9. @UserMsgAndExecAnnotation(msgType = MsgType.ADD)
10. public class UserAddRequest extends RequestMsgBase {
11. private double leftNumber;
12. private double RightNumber;
13. public UserAddRequest() {
14. super(MsgType.ADD);
15. }
16. public double getLeftNumber() {
17. return leftNumber;
18. }
19. public void setLeftNumber(double leftNumber) {
20. this.leftNumber = leftNumber;
21. }
22. public double getRightNumber() {
23. return RightNumber;
24. }
25. public void setRightNumber(double rightNumber) {
26. RightNumber = rightNumber;
27. }
28. }

为什么要这样修饰呢？先从服务端的解码（decode）说起，实例代码中，一个请求消息是这样规定的：

0-1字节表示整个消息的长度（单位：字节）

2-3字节代表消息类型，对应annotation的msgType

余下的是消息的json字符串（UTF-8编码）

我们需要根据2-3字节表示的msgType得到对应请求消息类的class对象，用这个class对象来序列化json字符串，得到具体的请求对象。那么怎么根据msgType得到class对象呢？这就是为什么要使用annotation的原因。

在服务端程序启动前，会执行下面的处理：

1. // msgType->请求、响应类的class对象
2. private static Map<Short, Class<?>> typeToMsgClassMap;
3. // 根据类型得到对应的消息类的class对象
4. public static Class<?> getMsgClassByType(short type) {
5. return typeToMsgClassMap.get(type);
6. }
7. /**
8. * 初始化typeToMsgClassMap
9. * 遍历包com.company.game.dispatcher.msg
10. * 取得消息类的class文件
11. *
12. * @throws ClassNotFoundException
13. * @throws IOException
14. */
15. public static void initTypeToMsgClassMap()
16. throws ClassNotFoundException, IOException {
17. Map<Short, Class<?>> tmpMap = new HashMap<Short, Class<?>>();
18. Set<Class<?>> classSet = getClasses("com.company.game.dispatcher.msg");
19. if (classSet != null) {
20. for (Class<?> clazz : classSet) {
21. if (clazz.isAnnotationPresent(UserMsgAndExecAnnotation.class)) {
22. UserMsgAndExecAnnotation annotation = clazz.getAnnotation(UserMsgAndExecAnnotation.class);
23. tmpMap.put(annotation.msgType(), clazz);
24. }
25. }
26. }
27. typeToMsgClassMap = Collections.unmodifiableMap(tmpMap);
28. }

程序初始化了一个映射，在指定的包找到请求的消息类的class，读取class上的annotation，保存到一个Map中，这样在后续就可以根据这个Map来根据msgType得到class对象了。

再给出解码器的实现：

1. package com.company.game.dispatcher.codec;
2. import java.util.List;
3. import com.company.game.dispatcher.util.ClassUtil;
4. import com.company.game.dispatcher.util.GsonUtil;
5. import com.google.gson.Gson;
6. import io.netty.buffer.ByteBuf;
7. import io.netty.channel.ChannelHandlerContext;
8. import io.netty.handler.codec.ByteToMessageDecoder;
9. /**
10. * 解码器
11. * 客户端和服务端均有使用
12. * 0-1字节表示整个消息的长度（单位：字节）
13. * 2-3字节代表消息类型，对应annotation
14. * 余下的是消息的json字符串（UTF-8编码）
15. *
16. * @author xingchencheng
17. *
18. */
19. public class MsgDecoder extends ByteToMessageDecoder {
20. @Override
21. protected void decode(ChannelHandlerContext ctx, ByteBuf buf,
22. List<Object> list) throws Exception {
23. if (buf.readableBytes() < 2) {
24. return;
25. }
26. Gson gson = GsonUtil.getGson();
27. short jsonBytesLength = (short) (buf.readShort() - 2);
28. short type = buf.readShort();
29. byte[] tmp = new byte[jsonBytesLength];
30. buf.readBytes(tmp);
31. String json = new String(tmp, "UTF-8");
32. Class<?> clazz = ClassUtil.getMsgClassByType(type);
33. Object msgObj = gson.fromJson(json, clazz);
34. list.add(msgObj);
35. }
36. }

解码完成后，程序进入到服务端的handler中：

1. @Override
2. protected void channelRead0(ChannelHandlerContext ctx, Object msgObject)
3. throws Exception {
4. // 分发消息给对应的消息处理器
5. Dispatcher.submit(ctx.channel(), msgObject);
6. }

Dispatcher代码如下：

1. package com.company.game.dispatcher;
2. import io.netty.channel.Channel;
3. import java.util.concurrent.ExecutorService;
4. import java.util.concurrent.Executors;
5. import com.company.game.dispatcher.exec.BusinessLogicExecutorBase;
6. import com.company.game.dispatcher.msg.RequestMsgBase;
7. import com.company.game.dispatcher.util.ClassUtil;
8. /**
9. * 抽象了分发器
10. * 多线程执行
11. * 某个消息对象msgObject指定某个业务逻辑对象executor
12. * submit到线程池中
13. * @author xingchencheng
14. *
15. */
16. public class Dispatcher {
17. private static final int MAX_THREAD_NUM = 50;
18. private static ExecutorService executorService =
19. Executors.newFixedThreadPool(MAX_THREAD_NUM);
20. public static void submit(Channel channel, Object msgObject)
21. throws InstantiationException, IllegalAccessException {
22. RequestMsgBase msg = (RequestMsgBase) msgObject;
23. Class<?> executorClass = ClassUtil.getExecutorClassByType(msg.getType());
24. BusinessLogicExecutorBase executor =
25. (BusinessLogicExecutorBase) executorClass.newInstance();
26. executor.setChannel(channel);
27. executor.setMsgObject(msgObject);
28. executorService.submit(executor);
29. }
30. }

我们看到，在代码中也是根据msgType取得了对应的一个class对象，并new了一个对象出来，交给了线程池进行并发执行，这个对象就是业务逻辑处理器对象，它实现了Runnable接口，进行一些业务逻辑上的处理。根据msgType取得class对象的映射过程跟前面提到的映射原理是相同的，可以参见代码。贴出业务逻辑处理器对象的代码：

1. package com.company.game.dispatcher.exec;
2. import com.company.game.dispatcher.annotation.UserMsgAndExecAnnotation;
3. import com.company.game.dispatcher.msg.MsgType;
4. import com.company.game.dispatcher.msg.UserAddRequest;
5. import com.company.game.dispatcher.msg.UserAddResponse;
6. /**
7. * 具体的业务逻辑
8. * 实现加法
9. *
10. * @author xingchencheng
11. *
12. */
13. @UserMsgAndExecAnnotation(msgType = MsgType.ADD)
14. public class UserAddExecutor extends BusinessLogicExecutorBase {
15. public void run() {
16. UserAddResponse response = new UserAddResponse();
17. if (this.msgObject instanceof UserAddRequest) {
18. UserAddRequest request = (UserAddRequest) this.msgObject;
19. double result = request.getLeftNumber() + request.getRightNumber();
20. response.setResult(result);
21. response.setSuccess(true);
22. } else {
23. response.setSuccess(false);
24. }
25. System.out.println("服务端处理结果：" + response.getResult());
26. channel.writeAndFlush(response);
27. }
28. }

注意，它也得用annotation来修饰。

思路大致就是如此，如果要增加一个请求，在示例代码中，需要做3件事情：

• 在MsgType添加一个类型
• 添加请求相应消息类
• 添加业务逻辑处理器类

而不需要修改消息分发的代码。

示例项目的说明和使用

• 工程可在文章开头的github中或附件得到
• 项目使用Maven3构建，构建的结果是一个jar，可通过命令行分别运行服务端和客户端
• 仅仅是个示例，并没有过多的考虑异常处理，性能等方面
• 没有单元测试和其他测试

提供了命令行工具，帮助信息如下：

服务端启动命令：

客户端启动命令：

结语

本文的描述未必清晰，更好的方法是直接看代码。

关于消息分发想必还有更好的方法，这里只是抛砖引玉，希望路过的各位能提供更好的方法一起参考。