mixaverross88/java-restfull-api
mixaverross88
该Docker镜像提供基于JAX-RS的RESTful API实现，支持CRUD操作，遵循Richardson成熟度模型，可通过Docker或Docker Compose快速部署，适用于API开发与测试场景。
1 次收藏下载次数: 0状态：社区镜像维护者：mixaverross88仓库类型：镜像最近更新：5 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
https://sonarcloud.io/api/project_badges/measure?project=mixaverros88_dockerized-java-api&metric=alert_status](https://sonarcloud.io/dashboard?id=mixaverros88_dockerized-java-api) https://travis-ci.com/mixaverros88/dockerized-java-api.svg?branch=master](https://travis-ci.com/mixaverros88/dockerized-java-api) !https://img.shields.io/github/followers/mixaverros88?label=Follow&style=plastic !https://img.shields.io/github/forks/mixaverros88/java-api?style=plastic !https://img.shields.io/github/stars/mixaverros88/java-api?style=plastic !https://img.shields.io/github/watchers/mixaverros88/java-api?style=plastic https://snyk.io/test/github/mixaverros88/java-api/badge.svg?targetFile=pom.xml](https://snyk.io/test/github/mixaverros88/java-api?targetFile=pom.xml)
JAX-RS 实现的 RESTful API
!https://raw.githubusercontent.com/mixaverros88/java-api/master/icons/java_rest_api.jpg
Docker 使用说明
!https://github.com/mixaverros88/java-api/blob/master/icons/dockerIcon.png 您可以通过以下步骤快速启动容器：
- 下载应用包：
bashcurl -LOk https://github.com/mixaverros88/java-api/raw/master/target/demorest.war
- 启动容器：
bashdocker run -it -p 80:8080 -v /$(pwd):/usr/local/tomcat/webapps mixaverross88/java-restfull-api:1.1
- 或使用 Docker Compose：
bashdocker-compose up
- 访问地址：
[docker-machine ip]:80/demorest/
Docker Hub 镜像地址
https://hub.docker.com/r/mixaverross88/java-restfull-api
CRUD 操作状态码
| 操作 | URI | 方法 | 结果 | 状态码 |
|---|---|---|---|---|
| 获取消息 | messages/{messageId} | GET | 成功 | 200 |
| 未找到 | 404 | |||
| 失败 | 500 | |||
| 删除消息 | messages/{messageId} | DELETE | 成功 | 200/204 |
| 未找到 | 404 | |||
| 失败 | 500 | |||
| 编辑消息 | messages/{messageId} | PUT | 成功 | 201 |
| 格式错误 | 400/415 | |||
| 未找到 | 404 | |||
| 失败 | 500 | |||
| 创建消息 | messages | POST | 成功 | 201 |
| 格式错误 | 400/415 | |||
| 未找到 | 404 | |||
| 失败 | 500 |
本地部署说明
使用 Maven 的 tomcat7-maven-plugin 可自动部署到本地 Tomcat 服务器。需修改 pom.xml 中的插件配置，并在 settings.xml 中添加 Tomcat 凭据：
xml<servers> <server> <id>TomcatServer</id> <username>admin</username> <password>password</password> </server> </servers>
执行部署命令：
bashmvn clean tomcat7:deploy
遵循 Richardson 成熟度模型
!https://raw.githubusercontent.com/mixaverros88/java-api/master/icons/The-Richardson-Maturity-Model-Nordic-APIs.png
- 资源独立 URI
- 标准 HTTP 方法（GET/POST/PUT/DELETE）
- HATEOAS 响应（包含客户端可访问的链接）
Postman 测试支持
!https://raw.githubusercontent.com/mixaverros88/java-api/master/icons/postman2.png 可使用 postman 文件夹中的 JSON 文件，通过 Newman 运行自动化测试。
Jenkins 流水线
提供 Jenkinsfile，可直接用于创建 Jenkins 持续集成流水线。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 java-restfull-api 镜像标签
docker pull docker.xuanyuan.run/mixaverross88/java-restfull-api:<标签>
DockerHub 原生拉取命令
docker pull mixaverross88/java-restfull-api:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"