garystafford/voter-service

Voter Service

概述

Voter Service是基于Spring Boot的RESTful Web服务，以MongoDB为数据存储后端，提供候选人管理、投票提交、结果查询等功能。它可通过HTTP同步调用、RabbitMQ RPC或最终一致性方式与Candidate Service交互，适用于微服务架构演示与学习实践。

核心功能

• 生成随机投票模拟数据（支持HTTP、RPC、最终一致性三种方式）
• 查询候选人列表（支持HTTP、RPC、最终一致性三种方式）
• 提交投票记录
• 查看选举结果、总票数、获胜者及获胜票数
• 提供服务信息、健康状态、指标等监控端点
• 支持HAL Browser API浏览

使用场景

• 本地开发测试：快速搭建投票服务及依赖组件（MongoDB、RabbitMQ、Candidate Service）
• 微服务演示：展示不同IPC方式在微服务间的应用
• 技术学习：实践Spring Boot与MongoDB、RabbitMQ的集成开发

配置说明

Spring Profiles

服务包含多环境配置（src/main/resources/application.yml）：

• default：本地默认配置
• docker-local：Docker本地开发配置
• docker-production：Docker生产配置
• aws-production：AWS生产配置

可通过命令行覆盖配置，例如使用AWS生产环境并修改MongoDB地址：

bash
java -jar voter-service-0.3.0.jar \
  --spring.profiles.active=aws-production \
  --spring.data.mongodb.host=<新地址> \
  -Dlogging.level.root=DEBUG

Docker部署示例

本地一键启动

使用项目提供的docker-compose-local.yml启动所有依赖：

bash
sh ./stack-deploy-local.sh

启动后包含Voter API Gateway、Candidate Service、Voter Service、Election Service、RabbitMQ、MongoDB容器。

API使用示例

1. 创建模拟候选人：

bash
http http://localhost:8097/candidate/simulation

2. 生成模拟投票（HTTP方式）：

bash
http http://localhost:8099/voter/simulation/http/2016%20Presidential%20Election

3. 查看投票结果：

bash
http http://localhost:8099/voter/results/2016%20Presidential%20Election

4. 提交投票：

bash
http POST http://localhost:8099/voter/votes candidate="Jill Stein" election="2016 Presidential Election"