garystafford/election-service

Election Service

镜像概述

Election Service是一个基于Spring Boot的RESTful Web服务，依赖MongoDB存储数据，是Voter API项目的核心组件之一。它提供了丰富的HTTP API端点，支持选举数据的全生命周期管理、模拟选举生成及服务运行状态监控等功能。

核心功能

• 选举数据的创建、查询、更新与删除
• 生成模拟选举数据用于测试
• 提供服务信息、健康状态及性能指标查询
• 支持HAL Browser API可视化浏览
• 与RabbitMQ集成实现服务间通信

使用场景

• 本地开发环境中快速搭建选举服务及依赖组件（MongoDB、RabbitMQ）
• 通过Docker Compose部署完整的Voter API栈（包含选举、选民、候选人服务等）
• 测试RESTful API设计及服务间消息传递机制

配置说明

Spring Profiles

服务内置多环境配置文件（application.yml），支持以下Profiles：

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

可通过命令行覆盖配置参数，示例：

bash
java -jar election-service-0.3.0.jar \
  --spring.profiles.active=aws-production \
  --spring.data.mongodb.host=新MongoDB主机地址 \
  -Dlogging.level.root=DEBUG

Docker部署示例

完整Voter API栈部署

使用项目提供的脚本启动所有组件：

bash
sh ./stack-deploy-local.sh

单独运行选举服务

需先启动MongoDB和RabbitMQ容器：

bash
docker run -d \
  -p 8095:8095 \
  --name election-service \
  --link mongodb:mongodb \
  --link rabbitmq:rabbitmq \
  garystafford/election-service:rabbitmq

快速开始

本地开发

1. 克隆仓库：

bash
git clone --depth 1 --branch rabbitmq https://github.com/garystafford/election-service.git
cd election-service

2. 构建并运行：

bash
./gradlew clean build
java -jar build/libs/election-service-0.3.0.jar

API使用示例（HTTPie）

1. 创建模拟选举：

bash
http http://localhost:8095/election/simulation

2. 查看所有选举：

bash
http http://localhost:8095/election/elections

3. 创建新选举：

bash
http POST http://localhost:8095/election/elections \
  date='2008-11-04' \
  electionType='FEDERAL' \
  title='2008 Presidential Election'

服务端点列表

所有端点前缀为/election：

HAL Browser访问地址：http://localhost:8095/election/actuator/