https://github.com/huahuai23/unionpay3060
对接银联3060，基于 Javalin 框架构建的企业认证服务，适用于需要企业认证和授权能力的微服务环境，也可以作为普通 web 服务初始的脚手架。
https://github.com/huahuai23/unionpay3060
authentication java javalin swagger unionpay
Last synced: about 2 months ago
JSON representation
对接银联3060，基于 Javalin 框架构建的企业认证服务，适用于需要企业认证和授权能力的微服务环境，也可以作为普通 web 服务初始的脚手架。
- Host: GitHub
- URL: https://github.com/huahuai23/unionpay3060
- Owner: HUAHUAI23
- Created: 2025-01-08T06:24:32.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-02-26T03:50:27.000Z (3 months ago)
- Last Synced: 2025-03-27T14:21:50.471Z (2 months ago)
- Topics: authentication, java, javalin, swagger, unionpay
- Language: Java
- Homepage:
- Size: 3.8 MB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Enterprise Authentication Service
[English](readme.en.md)
---
### 项目简介
基于 Javalin 框架开发的企业认证服务，对接银联 3060 接口，提供 RESTful API 接口，支持 Swagger 文档，使用 Bearer Token 进行身份验证。
### 环境要求
- OpenJDK 17.0.2+
- Maven
### 项目结构
```
.
├── conf/ # 配置文件目录
│ ├── cert/ # 证书文件
│ └── security.properties # 银联 3060 加密配置文件
├── src/
│ └── main/
│ ├── java/ # 源代码
│ └── resources/ # 资源文件
├── .env.example # 环境变量文件
└── pom.xml # Maven 配置文件
```
### 核心模块
- **Config**: 应用配置管理，包含环境变量、错误处理和 Swagger 配置
- **Exception**: 全局统一异常处理
- **Model**: 数据模型定义，包含 POJO 类和统一响应格式
- **Middleware**: 中间件组件，如认证中间件
- **Router**: 路由注册管理
- **Handler**: 请求处理器，负责调用 Service 处理业务逻辑
- **Service**: 无状态的业务逻辑实现层
### 设计原则
- Handler 负责状态管理（如维持数据库连接等有状态维护）
- Service 保持无状态设计
- 统一的错误处理和响应格式
- 模块化的项目结构
### 使用方法
1. 复制 .env.example 文件为 .env 文件，并配置相关环境变量
2. 运行 `mvn clean package assembly:single` 进行编译和打包
3. 运行 `java -jar target/unionpay3060-1.0-SNAPSHOT-with-dependencies.jar` 启动应用