JustAuth 项目教程

1. 项目的目录结构及介绍

JustAuth 项目的目录结构如下：

JustAuth/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── me/
│   │   │       └── zhyd/
│   │   │           └── oauth/
│   │   │               ├── config/
│   │   │               ├── enums/
│   │   │               ├── exception/
│   │   │               ├── model/
│   │   │               ├── request/
│   │   │               ├── source/
│   │   │               ├── state/
│   │   │               ├── util/
│   │   │               └── AuthRequest.java
│   │   └── resources/
│   │       └── application.properties
│   └── test/
│       └── java/
│           └── me/
│               └── zhyd/
│                   └── oauth/
│                       └── JustAuthTest.java
├── .gitignore
├── .travis.yml
├── CHANGELOGS.md
├── CODE_OF_CONDUCT.md
├── LICENSE
├── README.md
├── README_en-US.md
├── example.md
├── ja.sh
├── pom.xml

目录结构介绍

• src/main/java/me/zhyd/oauth/：包含项目的主要代码，分为多个子包，如 config、enums、exception 等。
• src/main/resources/：包含项目的配置文件 application.properties。
• src/test/java/me/zhyd/oauth/：包含项目的测试代码。
• .gitignore：Git 忽略文件配置。
• .travis.yml：Travis CI 配置文件。
• CHANGELOGS.md：项目变更日志。
• CODE_OF_CONDUCT.md：行为准则。
• LICENSE：项目许可证。
• README.md 和 README_en-US.md：项目说明文档。
• example.md：使用示例文档。
• ja.sh：脚本文件。
• pom.xml：Maven 项目配置文件。

2. 项目的启动文件介绍

JustAuth 项目的启动文件是 AuthRequest.java，位于 src/main/java/me/zhyd/oauth/ 目录下。该文件是第三方授权登录的核心类，负责处理授权请求和响应。

AuthRequest.java 主要功能

• 初始化第三方授权登录请求。
• 处理授权回调，获取用户信息。
• 支持多种第三方平台，如 GitHub、Gitee、微博等。

3. 项目的配置文件介绍

JustAuth 项目的配置文件是 application.properties，位于 src/main/resources/ 目录下。该文件包含了项目的各种配置信息。

application.properties 主要配置项

# 第三方平台配置
justauth.oauth.github.client-id=your_github_client_id
justauth.oauth.github.client-secret=your_github_client_secret
justauth.oauth.github.redirect-uri=your_github_redirect_uri

justauth.oauth.gitee.client-id=your_gitee_client_id
justauth.oauth.gitee.client-secret=your_gitee_client_secret
justauth.oauth.gitee.redirect-uri=your_gitee_redirect_uri

# 其他第三方平台配置...

# 缓存配置
justauth.cache.type=redis
justauth.cache.redis.host=your_redis_host
justauth.cache.redis.port=your_redis_port
justauth.cache.redis.password=your_redis_password

配置项介绍

• justauth.oauth.github.client-id：GitHub 应用的客户端 ID。
• justauth.oauth.github.client-secret：GitHub 应用的客户端密钥。
• justauth.oauth.github.redirect-uri：GitHub 应用的重定向 URI。
• justauth.oauth.gitee.client-id：Gitee 应用的客户端 ID。
• justauth.oauth.gitee.client-secret：Gite