红包雨的架构设计及源码实现中奖代码设计一般有用看1-526互联

1.项目介绍

学习目标

系统的功能、背景、场景及需求

在架构角度思索系统可能面临的问题以及解决方案

运用中间件特性，完成架构设计

主业务源码分析

微服务的部署与动态扩容

1.1项目概述

1.1.1概述

京东的红包雨大家可能都参与过，在某段时间内随机发放不同的红包，如果公司让你设计类似系统，如

何做？

本项目扩展为一个通用的红包雨模式抽奖系统，兼容多种规则。

由管理后台配置相关活动和奖品等信息，前端用户通过参与活动，完成抽奖。

1.1.2应用场景

1）时间随机

在一段时间内，设置一批礼品，这些礼品不定时的出现，尽量在这段时间内均匀抛出，一旦出现，就可

以被抓走。类似抓红包。

2）瞬间秒杀

用于抢单或者秒杀场景，到点后，用户一起抽奖，机会均等，谁抢的快算谁的。这个并发比较高。但是

活动时间相对较短。

3）机会随机

常见于转盘类活动。不同等级的用户，设定不同的中奖概率，一般配合设置用户最大可抽奖次数，比如

5次机会，能不能中奖，根据概率判定。一般活动时间设置的较长，比如几天。

1.1.3系统要求

1) 并发性

抽奖系统比如涉及到访问量大的问题。系统涉及所面临的第一关，即活动开始的瞬间，大批用户点击的

涌入。怎样设计系统以达到如此高并发情况下的及时响应是本项目的重中之重。

2) 库存控制

抽奖面临的必然是奖品。数量控制是必须要做到精准吻合。不允许出现设置了5个奖品，最终6人中奖这

种类似的问题出现。其中的本质是奖品库存的控制。

3) 投放策略

在活动时间段内，管理员设置好的一堆奖品如何投放？红包何时出现？什么时候可以被抽中？这些都涉

及到投放策略。

4) 边界控制

活动何时开始？何时结束？倒计时如何控制。这涉及到活动的边界。开始前要提防用户提前进入抽奖。

结束后要即使反馈结果给用户，告知活动已结束。

5) 活动自由配置

活动的配置由后台管理员完成，可以自由配置活动的开始结束时间，主题、活动简介、有哪些奖品、不

同等级的用户中奖的策略。这就要求系统必须具备足够的业务灵活度。

6) 中奖策略

每个用户参与抽奖后，要遵从后台管理员所设定的中奖策略，典型的场景是最大抽奖次数和最大中奖次

数。

1.2功能展示

1.2.1管理后台

1) 会员管理

功能：用户查询、用户新增、删除、修改密码

用户管理为管理员提供基本的用户录入。本项目可参与抽奖的用户由管理员后台直接录入，不允许私自

注册其他非法账号。已录入的账号可以在抽奖前端页面中登录，参与抽奖。

在电商面向C端用户的情况下，新增一个注册接口，允许用户自行注册参与抽奖。

2) 会员等级

功能：等级新增、删除、编辑

不同等级的会员有不同的中奖策略设置。比如高级别的会员中奖次数更多。详细会涉及下面活动配置中

策略配置一节

3) 活动管理

基础信息配置

功能：新增活动，修改活动，删除活动，配置活动基本信息（开始结束时间，标题，说明）

活动的基本信息管理功能

策略配置

功能：新增，修改，删除策略

策略涉及到用户的中奖次数，可以为不同等级的用户设置不同的最大中奖机会。不设置或者设置为0表

示次数不限。

奖品配置

功能：添加，删除，编辑奖品

为活动配置响应的奖品，可以添加多个不同的奖品，并为每个奖品设置单独的数量。

4) 奖品管理

奖品管理

功能：奖品增加，编辑，删除

录入奖品的基本信息，可以供多个活动引用。

5) 信息管理

中奖统计

功能：只有按条件查询，不涉及其他操作

统计每个活动的奖品总数，以及被抽走的数量。该功能只涉及数据的统计，不涉及新增修改删除，属于

只读操作。

中奖列表

功能：基于各种条件查询中奖详情

可以根据所需条件，查询到相关的中奖信息，中奖人信息，奖品信息，中奖时间等。该功能只涉及数据

的统计，不涉及新增修改删除，属于只读操作。

6) 系统管理

操作日志

功能：查询管理员的操作日志

该功能用于记录管理员的操作。可以根据ip，操作时间内容，以及操作人查询到在后台中的行为。只涉

及数据的统计，不涉及新增修改删除，属于只读操作。1.2.2前台展示

1) 活动列表

2) 活动详情

3) 抽奖展示

4) 个人中心

字段

类型

备注

int(10) unsigned

name

varchar(255)

奖品名称

pic

varchar(255)

图片

info

varchar(1000)

简介

price

decimal(10,2)

市场价

2.系统设计

2.1建模

2.1.1 ER图

2.1.2 数据表

1）奖品表

card_product

2）活动表

字段

类型

备注

int(10) unsigned

title

varchar(255)

活动主题

info

varchar(1000)

活动简介

starttime

datetime

开始时间

endtime

datetime

结束时间

type

tinyint(2)

类型（1=时间随机，2=瞬间秒杀，3 = 机会随机）

status

tinyint(1)

状态（0=新建，1=已加载）

字段

类型

备注

int(11) unsigned

uname

varchar(20)

用户名

passwd

varchar(50)

密码

realname

varchar(10)

姓名

idcard

varchar(18)

身份证号

phone

varchar(15)

手机号码

level

smallint(6)

等级

createtime

datetime

注册时间

updatetime

datetime

更新时间

字段

类型

备注

int(11) unsigned

gameid

int(11) unsigned

活动id

userlevel

smallint(6)

会员等级

enter_times

smallint(6)

可抽奖次数（0为不限）

goal_times

smallint(6)

最大中奖次数（0为不限）

random_rate

tinyint(4)

用户中奖概率

card_game

3）会员表

card_user

4）策略表

card_game_rules

字段

类型

备注

int(10) unsigned

gameid

int(10) unsigned

活动

userid

int(10) unsigned

用户

productid

int(10) unsigned

奖品

hittime

datetime

中奖时间

字段

类型

备注

int(10) unsigned

gameid

int(11) unsigned

活动id

productid

int(11)

奖品id

amount

smallint(6)

数量

5）中奖记录

card_user_hit

6）奖品活动关联

card_game_product

2.1.3 视图

1）中奖信息

view_card_user_hit

字段

类型

备注

int(10) unsigned

title

varchar(255)

活动主题

type

varchar(100)

值

uname

varchar(20)

用户名

realname

varchar(10)

姓名

idcard

varchar(18)

身份证号

phone

varchar(15)

手机号码

level

varchar(100)

值

name

varchar(255)

奖品名称

price

decimal(10,2)

市场价

gameid

int(10) unsigned

活动

userid

int(10) unsigned

用户

productid

int(10) unsigned

奖品

hittime

datetime

中奖时间

字段

类型

备注

int(10) unsigned

title

varchar(255)

活动主题

starttime

datetime

开始时间

endtime

datetime

结束时间

type

varchar(100)

值

total

decimal(27,0)

hit

bigint(21)

2）奖品数统计

view_game_curinfo

2.2概要设计

2.2.1系统拓扑

1）业务架构

2）软件架构

2.2.2设计原则

开工前，可能想到的一些思想和规划……

1）动静分离

1·后台springboot启动微服务模块

2.静态文件分离，nginx直接响应，不要再绕后台应用机器

2）微服务化

1·将模块细粒度拆分，微服务化

2·借助docker swarm

的容器管理功能，实现不同服务的副本部署，滚动更新

3·在本项目中，

api模块就部署了

3份，以适应前端的高并发

3）负载均衡

1·多个实例之间通过nginx做负载均衡，提升并发性能

2·本项目为大家展示的模块均部署在1台节点。生产环境涉及多台机器，用upstream实现。

4）异步消息

1·中奖后，中奖人及奖品信息要持久化到数据库。引入rabbitmq，将抽奖操作与数据库操作异步隔离。

2·抽奖中奖后，只需要将中奖信息放入rabbitmq，并立即返回中奖信息给前端用户。

3·后端msg模块消费rabbitmq消息，缓慢处理。

5）缓存预热

1·每隔1分钟扫描一次活动表，查询未来1分钟内将要开始的活动。

2·将扫到的活动加载进redis，包括活动详细信息，中奖策略信息，奖品信息，抽奖令牌。

3·活动正式开始后，基于redis数据做查询，不必再与数据库打交道。

2.2.3缓存体系

开始我们的设计……

1）活动基本信息

k-v，以活动id为key，活动对象为value，永不超时

2）活动策略信息

hset，以活动id为group，用户等级为key，策略值为value

3）抽奖令牌桶

双端队列，以活动id为key，在活动时间段内，随机生成时间戳做令牌，有多少个奖品就生成多少个令

牌。令牌即奖品发放的时间点。从小到大排序后从右侧入队。

4）奖品映射信息

k-v , 以活动id_令牌为key，奖品信息为value，会员获取到令牌后，如果令牌有效，则用令牌token值，

来这里获取奖品详细信息

5）令牌设计技巧

假设活动时间间隔太短，奖品数量太多。那么极有可能产生的时间戳发生重复。

解决技巧：额外再附加一个随机因子。将（时间戳 * 1000 + 3位随机数）作为令牌。抽奖时，将抽中的

令牌/1000 ，还原真实的时间戳。

redisUtil.set(RedisKeys.INFO+game.getId(),game,-1);

redisUtil.hset(RedisKeys.MAXGOAL +

game.getId(),r.getUserlevel()+"",r.getGoalTimes());

redisUtil.hset(RedisKeys.MAXENTER +

game.getId(),r.getUserlevel()+"",r.getEnterTimes());

redisUtil.rightPushAll(RedisKeys.TOKENS + game.getId(),tokenList);

redisUtil.set(RedisKeys.TOKEN + game.getId()

+"_"+token,productMap.get(cgp.getProductid()),expire);

6）中奖计数

k-v，以活动id_用户

id作为key，中奖数为value，利用redis原子性，中奖后incr增加计数。

抽奖次数计数也是同样的道理

7）中奖逻辑判断

抽奖时，从令牌桶左侧出队和当前时间比较，如果令牌时间戳小于等于当前时间，令牌有效，表示中

奖。大于当前时间，则令牌无效，将令牌还回，从左侧压入队列。

2.2.4业务时序图

2.3框架选型

2.3.1 管理后台

借助开源快速开发平台，完成后台基本的增删改查。（课外拓展）

2.3.2 微服务模块

1）公共pom

//活动持续时间（ms）

long duration = end - start;

long rnd = start + new Random().nextInt((int)duration);

//为什么乘1000，再额外加一个随机数呢？ - 防止时间段奖品多时重复

long token = rnd * 1000 + new Random().nextInt(999);

redisUtil.incr(RedisKeys.USERHIT+gameid+"_"+user.getId(),1);

所有项目共用的依赖及版本定义。继承自springboot-2.2.4.RELEASE

文档：swagger2

数据源：mysql，mybatis，pagehelper

缓存：redis

消息队列：rabbitmq

工具包：fastjson，commos-lang3，commons-collections

2）公共模块commons

分页、密码、统一结果

dto等工具类，mybatis生成的实体，mapper，redis及rabbit的配置bean

3）接口模块api

提供给前端页面的rest接口，如：抽奖接口，活动查询接口，中奖信息接口等

注意！需要比父pom多出 spring-web，session-redis

4）后台任务msg

调度任务：执行缓存预热

异步消息：rabbitmq消费端，接收中奖消息入库

备注（拓展）：

可以将job与msg剥离为两个独立微服务，利于分开部署与扩容。

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-web</artifactId>

</dependency>

<groupId>org.springframework.session</groupId>

<artifactId>spring-session-data-redis</artifactId>

</dependency>

job可以集成分布式job服务，比如elastic-job

2.3.3 微服务框架集成

2.3.4 工具

2）mybatis-generator

引入坐标：

配置pom插件：

#服务名

spring.ap

on.name=api

server.po

#分布式se

spring.s

n.store-type=redis

server.servlet.session.timeout=36000

#以下部分，msg与api通用

spring.datasource.type=com.alibaba.druid.pool.DruidDataSource

spring.datasource.driver-class-name=com.mysql.jdbc.Driver

spring.datasource.url=jdbc:mysql://1.1.1.1/prize?

useUnicode=true&characterEncoding=utf-8

spring.datasource.username=prize

spring.datasource.password=prize

mybatis.mapper-locations=classpath:mapper/*.xml

spring.jackson.date-format=yyyy-MM-dd HH:mm:ss

spring.jackson.time-zone=GMT+8

spring.rabbitmq.host=1.1.1.1

spring.rabbitmq.port=5672

spring.rabbitmq.username=guest

spring.rabbitmq.password=guest

spring.rabbitmq.virtual-host=/

spring.redis.host=1.1.1.1

spring.redis.port=9010

<groupId>org.mybatis.generator</groupId>

<artifactId>mybatis-generator-core</artifactId>

</dependency>

配置表映射关系：

<groupId>org.mybatis.generator</groupId>

<artifactId>mybatis-generator-maven-plugin</artifactId>

<groupId>mysql</groupId>

<artifactId>mysql-connector-java</artifactId>

roupId>

>0.0.1-SNAPSHOT</version>

</dependencies>

<outputDirectory>${project.build.directory}

</outputDirectory>

</configuration>

</plugin>

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE generatorConfiguration

PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"

"http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">

</plugin>

</commentGenerator>

<jdbcConnection driverClass="com.mysql.jdbc.Driver"

connectionURL="jdbc:mysql://1.1.1.1/prize?

tinyInt1isBit=false"

userId="root"

tinyint会映射为bit，习惯上使用Integer更方便。自己定义一个type映射类并配置到上面的confifig xml

中

3）分页PageHelper

坐标：

定义一个pagebean：

password="root">

</jdbcConnection>

</javaTypeResolver>

<javaModelGenerator targetPackage="com.itheima.prize.commons.db.entity"

targetProject="MAVEN">

trimStrings" value="true"/>

</jav

!-- xml 路径-->

or targetPackage="com.itheima.prize.commons.db.xml.mapper"

targetPr

<javaClientGenerator type="MIXEDMAPPER"

targetPackage="com.itheima.prize.commons.db.mapper" targetProject="MAVEN"/>

</table>

</context>

</generatorConfiguration>

public class JavaTypeResolverDefaultImpl implements JavaTypeResolver {

....

public JavaTypeResolverDefaultImpl() {

.....

this.typeMap.put(-6, new

JavaTypeResolverDefaultImpl.JdbcTypeInformation("TINYINT", new

FullyQualifiedJavaType(Integer.class.getName())));

.....

}

....

｝

<groupId>com.github.pagehelper</groupId>

<artifactId>pagehelper</artifactId>

</dependency>

@ApiModel("分页信息")

使用：

查询的sql会被自动拼接limit

返回的数据体：

public class PageBean<T> {

@ApiModelProperty(value = "当前页，1开始")

private Integer currentPage = 1;

@ApiModelProperty(value = "每页条数，默认10")

private Integer pageSize = 10;

@ApiModelProperty(value = "总条数")

private Long totalNum;

@ApiModelProperty(value = "是否有下一页")

private Integer isMore;

@ApiModel

"总页数")

private I

;

@ApiMo

开始索引")

privat

;

@Api

e = "本页数据")

priv

;

...

｝

// 在查询之前，调用startPage，设置页码及条数

PageHelper.startPage(curpage, limit);

List<ViewCardUserHit> all = hitMapper.selectByExample(example);

{

"code": 1,

"msg": "成功",

"data": {

"currentPage": 1,

"pageSize": 2,

"totalNum": 5,

"isMore": 1,

"totalPage": 3,

"startIndex": 0,

"items": [

{

"id": 1,

"title": "10周年庆典",

"type": "随机类",

"uname": "2",

"realname": "2",

"idcard": "2",

"phone": "2",

"level": "二级会员",

"name": "iPhoneX一部",

"price": 5000,

"gameid": 1,

"userid": 8,

2.3.2 前端页面

h5+jquery实现抽奖界面（前端开发，非重点，了解即可）

3.代码实现

"productid": 1,

"hittime": "2019-09-24 15:26:45"

{

"id": 2,

"title": "10周年庆典",

"type": "随机类",

"uname": "2",

"realname": "2",

"idca

"phon

"二

级

会

员

一

部

"userid": 8,

"productid": 1,

"hittime": "2019-09-24 15:26:46"

}

]

}

缓存结构设计回顾：

活动开始前1分钟扫描将要开始的活动

将活动信息加载进redis

将活动策略信息加载进redis

按活动奖品信息，生成对应个数的时间戳做令牌，从小到大排好序，右侧入队

以令牌为key，对应的奖品为value，建立映射关系，为中奖后获取奖品做准备

抽奖开始时，从令牌队列左侧获取令牌

如果令牌小于当前时间，说明中奖，找到令牌对应的奖品，抽走

如果令牌大于当前时间，说明未中奖，从左侧将令牌还回队列

3.1活动预热

3.1.1 源码实现

根据缓存结构设计，初始化redis活动相关信息

3.1.2 过期时间

活动结束时间 - 当前时间 = 有效时长，

活动结束则缓存自动失效

3.1.3 调度策略

每隔1分钟扫描一遍活动表，查询未来1分钟内要开始的活动进行预热。

3.2抽奖业务

3.2.1 源码实现

按时序图设计实现业务流程

3.2.2 并发与原子性

业务下沉到lua脚本：

local token = redis.call('lpop',KEYS[1])

local curtime = tonumber(KEYS[2])

if token ~= false then

if ( tonumber(token)/1000 > tonumber(KEYS[2]) ) then

redis.call('lpush',KEYS[1],token)

return 1

else

return tonumber(token)

end

else

return 0

end

调用部分：

3.3中奖处理

3.3.1 rabbit配置

RabbitConfifig实现rabbit的队列与消费消息配置

3.3.2 异步处理

中奖主流程中，将中奖信息放入消息队列，立刻返回结果响应前台。

3.3.3 msg模块消费

3.4缓存监控

3.4.1 客户端工具

Long token = luaScript.tokenCheck("game_"+gameid,String.valueOf(new

Date().getTime()));

if(token == 0){

return new ApiResult(-1,"奖品已抽光",null);

}else if(token == 1){

return new ApiResult(0,"未中奖",null);

}

//投放消息给队列，中奖后的耗时业务，交给消息模块处理

Map map = new HashMap(2);

map.put("gameid",gameid);

map.put("userid",user.getId());

map.put("productid",product.getId());

map.put("hittime",now.getTime());

rabbitTemplate.convertAndSend(RabbitKeys.EXCHANGE_DIRECT,RabbitKeys.QUEUE_HIT,

map);

@RabbitHandler

public void processMessage3(Map message) {

logger.info("user hit : " + message);

CardUserHit hit = new CardUserHit();

hit.setGameid(MapUtils.getIntValue(message,"gameid"));

hit.setUserid(MapUtils.getIntValue(message,"userid"));

hit.setProductid(MapUtils.getIntValue(message,"productid"));

hit.setHittime(new Date(MapUtils.getLongValue(message,"hittime")));

// 入库

hitMapper.insert(hit);

}

查看缓存信息，可以借助redis-manager客户端工具，便捷，但日期格式不够直观

3.4.2 编码查看

写rest接口，通过swagger查看，需要编码，但是可以自由格式化输出json

3.5代码启动

启动中间件：

mysql，redis，rabbitmq

启动msg / job

启动api

启动管理后台，创建活动

查看job日志，是否在开始前的1分钟，将活动预热成功

请求抽奖接口，查看是否提示活动未开始

开始时间后，请求抽奖接口，调试api，看是否可以正常抽奖

中奖后，看msg日志，是否有中奖消息发送到消息模块

查看数据库，确认中奖信息是否正常写入db

3.6上线部署

3.6.1 部署拓扑

3.6.2 镜像

1）脚本

docker build -t $app:$BUILD_NUMBER .

2）Dockerfifile

build阶段需要的基础镜像及模板。

3.6.3 中间件部署

redis，mysql，nginx 均采用docker方式部署

3.6.4弹性扩容

FROM daocloud.io/library/java:openjdk-8u40-jdk

#语言字符，解决乱码问题

ENV LC_ALL C.UTF-8

ENV LANG C.UT

F-

ENV LANGUAGE

TF-8

#时区及时间

，

不

设

置

会

影

响活动的开始结束

ENV TZ=As

RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

#将spring

的

包

打

入

镜

像

COPY ROO

WORKDIR /opt

#启动命令，注意环境配置 prod

CMD ["java", "-jar", "ROOT.jar", "--spring.profiles.active=prod"]

docker service rm $app

docker service create --name $app -p $port:8080 --hostname localhost

$app:$version

#获取镜像

docker pull daocloud.io/library/redis:latest

docker pull daocloud.io/library/rabbitmq:3.6.10-management

docker pull daocloud.io/mysql:5.7.4

docker pull daocloud.io/nginx:latest

#启动镜像

docker run --name redis -p 6379:6379 -d daocloud.io/library/redis

docker run --name mysql -v /opt/data/mysql:/var/lib/mysql -p3306:3306 -e

MYSQL_ROOT_PASSWORD=password -d daocloud.io/mysql:5.7.4

docker run -d --hostname my-rabbit --name rabbit -p 15672:15672 -p 5672:5672

daocloud.io/library/rabbitmq:3.6.10-management

docker run --name nginx -v /opt/data/nginx/html:/usr/share/nginx/html:ro -v

/opt/app/back/upload:/usr/share/nginx/upload:ro -v

/opt/data/nginx/nginx.conf:/etc/nginx/nginx.conf:ro -p 80:80 -d

daocloud.io/nginx

采用微服务架构的初衷之一就是实现服务单元的快速独立扩容，借助docker-swarm的功能，变得很容

易实现。以本项目为例，api模块在部署完成后，扩容到3个实例，以负载前端的并发请求：

3.6.5 管理后台部署

因为是开发平台，打出的war包，这里使用jetty启动即可

java -jar /opt/app/jetty-runner.jar --port 7070 /opt/app/back/

3.6.6 静态页面与nginx

/api的请求代理到微服务api模块，其他静态文件由nginx本地访问，配置如下：

3.7发散思维与总结

3.7.1 发散思维（拓展）

1）lua脚本的运用

使用lua脚本，将抽奖的逻辑从java端移入redis服务器端，作为一个整体函数暴露给java调用，减少了

java服务器与redis服务器之间的通信次数，性能会得到提升。

docker service scale api=3

http {

include mime.types;

default_type application/octet-stream;

sendfile on;

keepalive_timeout 65;

server {

listen 80;

server_name localhost;

location ^~ /api/ {

proxy_pass http://172.17.0.1:9004;

}

location ^~ /upload/ {

alias /usr/share/nginx/upload/;

}

location / {

root /usr/share/nginx/html;

}

2）怎么实现活动暂停功能？

要实现活动随时暂停，可以新增一个接口，该接口修改redis缓存中的活动状态。

抽奖接口逻辑中增加暂停状态判断。如果是暂停，返回给前台以提示。

3）怎么实现多种投放策略？

投放策略即令牌的生成策略不同。可以修改令牌生成部分代码。按递增，递减，正态分布等多种函数生

成时间戳。

3.7.2 总结

通过本项目我们接触到了以下知识点：

如何分析需求做软件架构设计

中间件的运用，rabbitmq，尤其是redis的数据结构

一些工具：分页PageHelper，swagger2，mybatis-generator

微服务思想及持续集成，动态扩容

基于docker swarm的发布与部署

526互联

红包雨的架构设计及源码实现 中奖代码设计 一般有用 看1

红包雨的架构设计及源码实现中奖代码设计一般有用看1