PeonyFramwork是一个优秀的java后端框架，上手简单，使用灵活方便。可以应用于网络游戏，网络应用的服务端开发。目前已经应用于10余款网络游戏的服务端开发，并正在被更过的游戏使用
- 最大限度的减少和业务逻辑无关的工作，确保开发者把更多的精力放在业务逻辑上
- 组件式开发，更多的通用型功能性组件，以service的方式复用
- 容易上手，简单的了解之后即可应用于生产，对技术积累较少的企业，创业团队，学生党，独立开发者更加友好
- all in one，将更多服务器周边工具集成进来，包括集群，部署，统计，GM等，将该框架扩展为java后端解决方案
- 注解驱动：通过注解来完成服务器中很多的功能或实现特定效果
- 服务层事务：提供方法级别的事务机制，确保方法的原子性
- 框架层解决缓存问题：用户无需考虑自己为功能做缓存，框架的数据管理机制包含了数据的缓存
- 框架层解决并发一致性问题：用户无需考虑并发一致性问题，框架的事务机制和数据管理机制解决了并发一致性问题
- 数据库异步更新：数据的增加，删除和修改是通过异步方式实现的
- 数据库表自动更新：数据库中的表可以根据业务中的数据对象自动创建，修改，无需手动写sql进行数据库表的创建修改等操作
- Service组件规范与定制型配置[倡导通用型组件]（还未实现）
下面是如何下载和启动PeonyFramwork，以及基本的使用；如需了解更详细框架使用和原理，请转到PeonyFramwork Wiki
1、用idea，Open->选择根目录的build.gradle文件->把项目作为gradle项目打开
2、找到src->main->resources->mmserver.properties文件，修改里面的数据库配置，包括数据库连接jdbc.url，用户名jdbc.username和密码jdbc.password。（不用创建表）
当MySQL的版本小于6时，需要修改jdbc.driver=com.mysql.jdbc.Driver，否则，使用jdbc.driver=com.mysql.cj.jdbc.Driver
3、找到启动类com.peony.engine.framework.server.Server，运行。
成功启动的标志为：
-------------------------------------------------------------
| Congratulations |
| server(ID: 1) startup success! |
-------------------------------------------------------------
以下以框架提供的消息入口WebSocketEntrance和json协议为例，实现一个简单的背包功能
- 在com包(位于src/main/java下面)下面创建应用包myApp
- 打开resources（位于src/main下面）的应用配置文件mmserver.properties，修改appPackage属性的值为com.myApp
- 在com.myApp下面创建背包功能的包bag
package com.myApp.bag;
import com.alibaba.fastjson.JSONObject;
import com.peony.engine.framework.data.persistence.orm.annotation.DBEntity;
import java.io.Serializable;
@DBEntity(tableName = "bag",pks = {"uid","itemId"})
public class BagItem implements Serializable {
private String uid; // 玩家id
private int itemId; // 物品id
private int num; // 物品数量
public JSONObject toJson(){
JSONObject ret = new JSONObject();
ret.put("itemId",itemId);
ret.put("num",num);
return ret;
}
// get set 方法
public String getUid() {
return uid;
}
public void setUid(String uid) {
this.uid = uid;
}
public int getItemId() {
return itemId;
}
public void setItemId(int itemId) {
this.itemId = itemId;
}
public int getNum() {
return num;
}
public void setNum(int num) {
this.num = num;
}
}
- 注解@DBEntity声明一个类为背包类，对应数据库中一张表，其参数tableName对应表名，pks对应表的主键，可以为多个。
- @DBEntity声明的类必须继承Serializable接口，并对参数实现get set方法
- 表不用手动创建，系统启动时会自动在数据库中创建，大多数的修改也会进行同步，所以不要声明不需要存储数据库的字段
package com.myApp.bag;
import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import com.peony.engine.framework.control.annotation.Request;
import com.peony.engine.framework.control.annotation.Service;
import com.peony.engine.framework.data.DataService;
import com.peony.engine.framework.data.entity.session.Session;
import com.peony.engine.framework.data.tx.Tx;
import com.peony.engine.framework.security.exception.ToClientException;
import com.peony.engine.framework.server.SysConstantDefine;
import java.util.List;
@Service
public class BagService {
private DataService dataService;
/**
* 协议，获取背包列表
*/
@Request(opcode = 20011)
public JSONObject BagInfo(JSONObject req, Session session) {
List<BagItem> bagItemList = dataService.selectList(BagItem.class,"uid=?",session.getUid());
JSONObject ret = new JSONObject();
JSONArray array = new JSONArray();
for(BagItem bagItem : bagItemList){
array.add(bagItem.toJson());
}
ret.put("bagItems",array);
return ret;
}
/**
* 添加物品到背包
*/
@Tx
public int addItem(String uid,int itemId,int num){
BagItem bagItem = dataService.selectObject(BagItem.class,"uid=? and itemId=?",uid,itemId);
if(bagItem == null){
bagItem = new BagItem();
bagItem.setUid(uid);
bagItem.setItemId(itemId);
bagItem.setNum(num);
dataService.insert(bagItem);
}else{
bagItem.setNum(bagItem.getNum()+num);
dataService.update(bagItem);
}
return bagItem.getNum();
}
/**
* 从背包中删除物品
*/
@Tx
public int decItem(String uid,int itemId,int num){
BagItem bagItem = dataService.selectObject(BagItem.class,"uid=? and itemId=?",uid,itemId);
if(bagItem == null){
throw new ToClientException(SysConstantDefine.InvalidParam,"item is not enough1,itemId={}",itemId);
}else{
if(bagItem.getNum()<num){
throw new ToClientException(SysConstantDefine.InvalidParam,"item is not enough2,itemId={}",itemId);
}
bagItem.setNum(bagItem.getNum()-num);
dataService.update(bagItem);
}
return bagItem.getNum();
}
}
- 注解@Service声明一个类为一个服务类
- 声明了数据服务类DataService，该类中提供了对数据操作的所有接口。 引用其他服务类时，声明即可使用，系统启动时会进行依赖注入
- @Request声明一个方法为处理客户端协议的方法，其中opcode为协议号(整型)，因为使用的是json协议，
参数类型必须为JSONObject和Session，返回值类型为JSONObject。其中参数JSONObject为客户端发送过来的消息
Session中有玩家基本信息，包括玩家账号
session.getUid() - 注解@Tx可以确保整个方法的执行在服务层事务中，确保业务失败的数据回滚和并发情况下的数据一致问题
- 本地启动服务器
- 打开websocket在线工具：http://www.blue-zero.com/WebSocket/
- 在地址输入框中输入：ws://localhost:9002/websocket，点击连接。如果出现"连接已建立，正在等待数据..."，说明websocket连接成功
- 在发送消息框中输入登录消息如下：
{
"id": "102",
"data": {
"accountId": "test1"
}
}
其中，id为登录消息协议号，accountId为登录的账号
点击发送，可得到登录成功的返回：
{
"data": {
"accountId": "test2",
"newUser": 1,
"serverTime": 1540206073929
},
"id": 102
}
其中newUser标识为新用户，serverTime为服务器时间，id和accountId同上
- 登录完成后，就可以进行背包信息的获取了，发送消息
{
"id": "20011",
"data": {
}
}
可收到消息：
{
"data": {
"bagItems": [ ]
},
"id": 20011
}
由于背包中为空，所以bagItems返回一个空数据，您可自行实现一个添加物品到背包的协议进行测试
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent