完善README

This commit is contained in:
zhangzc@shuhua.com
2017-06-18 19:14:56 +08:00
parent a4cf3200e5
commit 7d8c9d394a
4 changed files with 49 additions and 9 deletions

View File

@@ -1,22 +1,57 @@
# ZZC-SERVER
## 基于netty的开源tcp服务器开发包
=====
### 目的:
基于netty的开源tcp服务器开发包
## 目的&&功能
快速打造通信服务器,帮助用户快速开发出(游戏,硬件,聊天)服务器
### 特点:
* 依赖少 基于netty和spring等基础库
## 特点:
* 依赖少,基于netty和spring等基础库
* 使用户将注意集中与业务开发,无需过多关注配置
* 使用简便无需懂网络编程和netty也可使用
### 如何使用
## 环境依赖
* jdk1.7+
* maven3.0以上版本
## 如何使用:
* maven引入
```
<!-- zzc-server -->
<dependency>
<groupId>cn.94zichao</groupId>
<artifactId>server</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
```
* 编写自己的业务处理类,标记@ZzcService注解
* 业务类中编写对应的各种方法,默认参数为[SocketModel]
```
@ZzcService("test")
public class MyTestZzcService {
public void test(SocketModel sk){
sk.getData();
}
}
```
* 在Spring自动扫描包后面配置服务启动类[ZzcServer]
```
<context:component-scan base-package="com.youdomain.xx">
</context:component-scan>
<!-- 通信服务器启动类 -->
<bean id="xxxxxx" class="cn._94zichao.server.bootstrap.ZzcServer">
</bean>
```
[ZzcServer]: http://example.com/ "ZzcServer 的启动类"
[SocketModel]: http://example.com/ "SocketModel 类"
### 教程:
[ZzcServer]: ZzcServer.md "ZzcServer 的启动类"
[SocketModel]: SocketModel.md "SocketModel 类"
## 教程(未完成,先填个坑)
1. 与spring集成的demo
2. 与spring boot集成的demo
3. 一个简单的聊天服务器
## 文档(坑先占好):
## 缺陷(待完善部分):
1. 项目启动时为了配合公司产品的快速开发写死了端口、防止粘包拆包的分隔符、eventloop线程数量后期这些都要可配置化。
2. 未集成日志。
3. 缺少其他防粘包策略,后面提供。
4. 待补充。。。。。。

0
SocketModel.md Normal file
View File

2
ZzcServer.md Normal file
View File

@@ -0,0 +1,2 @@

View File

@@ -15,16 +15,19 @@
<groupId>io.netty</groupId>
<artifactId>netty-all</artifactId>
<version>4.1.1.Final</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>4.3.5.RELEASE</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>3.4</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>junit</groupId>