garystafford/candidate-service

Candidate Service

镜像概述

Candidate Service是基于Spring Boot框架开发的RESTful Web服务，以MongoDB为数据存储，提供候选人数据管理接口。该服务可与Voter Service配合，支持HTTP同步通信、RabbitMQ RPC及最终一致性等微服务间通信方式，适用于学习微服务架构和API开发。

核心功能

1. 候选人数据管理：支持新增、查询候选人列表及按选举名称筛选摘要。
2. 模拟数据生成：通过/simulation端点生成2016美国总统选举候选样本数据。
3. 服务监控：提供健康检查、指标统计等Spring Actuator端点。
4. 多通信模式：与Voter Service集成时，支持HTTP同步、RabbitMQ RPC和事件最终一致性三种IPC方式。

使用场景

• 学习Spring Boot与MongoDB的集成开发。
• 实践RESTful API设计与实现。
• 测试微服务间不同通信模式的效果。
• 演示基于消息队列的微服务架构。

配置说明

服务支持多个Spring Boot Profile（default/docker-local/docker-production/aws-production），可通过spring.profiles.active指定激活配置。主要配置项包括MongoDB地址、RabbitMQ地址、服务端口等，可通过命令行参数或环境变量覆盖默认值。

Docker部署示例

Docker Run命令

bash
# 启动MongoDB
docker run -d --name mongodb -p 27017:27017 mongo
# 启动RabbitMQ（带管理界面）
docker run -d --name rabbitmq -p 5672:5672 -p 15672:15672 rabbitmq:3-management
# 启动Candidate Service
docker run -d --name candidate-service --link mongodb:mongodb --link rabbitmq:rabbitmq -p 8097:8097 garystafford/candidate-service

Docker Compose配置

yaml
version: '3'
services:
  mongodb:
    image: mongo
    ports: ["27017:27017"]
  rabbitmq:
    image: rabbitmq:3-management
    ports: ["5672:5672", "15672:15672"]
  candidate-service:
    image: garystafford/candidate-service
    ports: ["8097:8097"]
    depends_on: [mongodb, rabbitmq]
    environment: 
      - SPRING_DATA_MONGODB_HOST=mongodb
      - SPRING_RABBITMQ_HOST=rabbitmq

API使用示例

1. 生成模拟数据：
   http http://localhost:8097/candidate/simulation
2. 查询2016选举候选人摘要：
   http http://localhost:8097/candidate/candidates/summary/2016%20Presidential%20Election
3. 新增候选人：

bash
http POST http://localhost:8097/candidate/candidates \
  firstName='Mary' lastName='Smith' politicalParty='Test Party' election='2016 Presidential Election'