要想轻松驾驭t-io，提高编程效率，学习示范工程很重要

技术控 - 2021-11-11 03:48:54

t-io作为国内知名的开源网络编程框架，受到业界的广泛赞誉和使用，要一个想要学习或者想要使用t-io的人员，最快的了解t-io的方法就是学习t-io相关的工程文档，主要包含五个部分：
tio-study工程
tio-websocket-showcase工程
tio-http-server-showcase工程
tio-udp-showcase工程
tio-websocket-client 工程
具体请参考：https://www.wanetech.com/doc/...
分别介绍如下：
tio-study工程简介
用于学习t-io的示范工程，目前包含3个工程：Hello world、Showcase、IM
下面分别对这三个工程进行讲解
一、helloworld
helloworld是入门t-io最好的方式！而作者也是用心写了一个对生产项目有参考价值的hello tio，而不是仅仅是show hello而hello
在以前没有文档的日子，t-io第一批用户就是通过这个工程掌握t-io的
服务器端入口程序：org.tio.study.helloworld.server.HelloServerStarter
客户端入口程序：org.tio.study.helloworld.client.HelloClientStarter
本例子演示的是一个典型的TCP长连接应用，大体业务简介如下。
分为server和client工程，server和client共用common工程
服务端和客户端的消息协议比较简单，消息头为4个字节，用以表示消息体的长度，消息体为一个字符串的byte[]
服务端先启动，监听6789端口
客户端连接到服务端后，会主动向服务器发送一条消息
服务器收到消息后会回应一条消息
之后，框架层会自动从客户端发心跳到服务器，服务器也会检测心跳有没有超时（这些事都是框架做的，业务层只需要配一个心跳超时参数即可）
框架层会在断链后自动重连（这些事都是框架做的，业务层只需要配一个重连配置对象即可）
客户端界面

服务器端界面

二、showcase
showcase工程用于进一步掌握t-io，甚至可以用作你项目的脚手架（@精灵007 同学已经用这个工程完成了3个项目）
这里有一篇博客，可以参考：ShowCase设计分析
服务器端入口程序：org.tio.study.showcase.server.ShowcaseServerStarter
客户端入口程序：org.tio.study.showcase.client.ShowcaseClientStarter
客户端界面

服务器端界面

三、IM
im项目在1.7.0版本前一直都开放的，考虑到im的复杂性，这会给作者带来一些额外的咨询工作，所以在后面的版本没有放出来，现在重新放出来
j-im项目是在本项目的基础上改造而来的，有兴趣的可以看看j-im最早的fork版本
服务器端入口程序：org.tio.study.im.server.starter.ImServerStarter
客户端入口程序：org.tio.study.im.client.starter.ImClientStarter
看看爆裂的性能数据吧

tio-websocket-showcase工程简介
引言
tio-websocket-server是基于tio-core实现的websocket服务器，自带t-io提供的各项API以及一流的性能和稳定性
tio-websocket-showcase工程简介
用于学习tio-websocket-server的示范工程
包括wss和流量监控及处理等高级特性
还包括t-io作者写的一个用于连接websocket服务器的js小框架——tiows.js（内置断链重连、定时主动发心跳等功能，使用API极其简单）
效果图

学习步骤
把工程以maven的形式导入到eclipse后
修改\src\main\resources\page\im.js，把127.0.0.1改成你自己的ip地址（如果只是本机访问，可以不用修改）
运行org.tio.showcase.Starter
用chrome打开http://127.0.0.1/index.html（说明：本工程不仅会启动websocket服务器，还会启动一个http服务器用于访问websocket服务器）
这是个用iframe嵌入了两个im.html的页面，方便在一个窗口查看群聊效果
可以愉快地聊天了
说明
服务器端，大家看代码就好，用起来比较简单
客户端（js），page/tio/tiows.js是和业务无关的websocket js小框架，主要是实现了重连、定时发心跳等和业务无关的功能
**tio-http-server-showcase工程
引言**
tio-http-server是基于tio-core实现的http服务器，自带t-io提供的各项API以及一流的性能和稳定性
tio-http-server-showcase工程简介
**用于学习tio-http-server的示范工程
入口程序**

控制器

启动成功日志

访问
用浏览器打开：http://127.0.0.1

**tio-udp-showcase工程
引言**
tio-udp是包含在tio-core的一个功能子集
tio-udp-showcase工程简介
用于学习tio-udp-server的示范工程
学习步骤
把工程以maven的形式导入到eclipse后
运行org.tio.showcase.udp.server.ShowcaseUdpServerStarter启动udp服务器，启动成功后，日志如下

运行org.tio.showcase.udp.client.UdpClientStarter
观察服务器端的console，会看到如下日志

整个工程才3个类，简单到极致
tio-websocket-client 工程
tio-websocket-client的API风格接近浏览器端的WebSocket API
1、引用dependence，如maven：

2、创建WebSocket Client：
调用WsClient.create方法创建WsClient:

additionalHttpHeaders将添加到HTTP握手包的Header中，主要用于添加token等鉴权行为
例如：

3、调用client.connect()连接到服务器
4、像前端一样使用WebSocket

使用https://www.websocket.org/ech...的echo服务的完整示例：