Angularjs-springMVC样本启动
使用Anguarjs/Bootstrap作为前端和Spring MVC作为REST API生产者的示例应用程序。
有关源代码的更多详细信息,请阅读在线gitbook:使用Spring MVC构建REST API。
注意:此项目正在维护中,将来没有更多的新功能。如果您正在寻找新的Spring Boot 2和Angular 5,请检查Angular-Spring反应样本。
技术堆栈:
- 春季引导
- 春季MVC
- 春季数据JPA
- JPA
- 冬眠5.2
- 春季安全性
- Swagger/Swagger2markup/Spring Rest文档
- 春季测试/JUNIT/MOCKITO/JBEHAVE/重新安排
- 伦波克
- ModelMapper
- Angularjs
- 引导程序
此版本改进了原始版本(没有弹簧靴),包括:
- 介绍Gulp构建系统以处理静态资源
- 前端UI可以通过nodejs生态系统独立运行
- 提供的选项,允许您作为最终JAR的一部分打包静态资源,并通过
mvn spring-boot:run
要求
-
JDK 8
需要Oracle Java 8,请访问Oracle Java网站下载并安装到系统中。
可选地,您可以设置Java_home环境变量,并在路径环境变量中添加<jdk安装dir>/bin 。
-
Apache Maven
从http://maven.ap***ache.org下载最新的apache maven,然后将其压缩到本地系统中。
可选地,您可以设置M2_HOME环境可变,也不要忘记附加<maven安装dir>/bin your路径环境变量。
-
nodejs
构建前端静态资源需要NODEJS。
下载nodejs并将其安装到本地系统中。
安装后,打开终端并使用
node -v命令确认。node -v >v4.2.2还重新设置了
bower以安装运行时依赖关系,然后选择gulp作为我们的静态资源的构建工具。npm install -g bower npm install -g gulp
获取源代码
将源代码的副本纳入您的本地系统。
git clone https://github.***com/hantsy/angularjs-springmvc-sample-boot
运行项目
您可以使用以下方法之一运行此项目。
分别运行前端UI和后端
-
通过Spring Boot运行后端API服务器。
mvn spring-boot:run后端API将在端口9000上运行。
-
运行前端UI独立。
npm install bower install gulp serve默认情况下,GULP在端口3000上为前端UI静态资源提供服务。
-
转到http:// localhost:3000进行测试。
通过Spring Boot Maven插件运行该项目
-
运行以下命令以清理前端静态资源的依赖关系。
npm install bower install -
使用
spring-boot命令运行后端API服务器。参数-Dstatic-ui将将静态资源和包装复制到JAR存档中。mvn spring-boot:run -Dstatic-ui -
转到http:// localhost:9000进行测试。
如果您想在线探索REST API文档,则配置了一个用于可视化REST API的Swagger UI ,只需访问http:// localhost:9000/Swagger-ui.html。
生成静态REST API参考文档
我已经将其余文档的生成配置移至独立的Maven配置文件中。
执行以下命令,以从Swagger API说明文件和弹簧测试代码段(作为代码示例)中为您的REST API生成HTML和PDF格式文件。
mvn clean package -Drestdocs
API文档部分中解释了详细的配置。
完成后,请检查目标/ASCIIDOC文件夹中的生成的静态文档,其中包括HTML 5文件(在HTML文件夹下)和PDF文件(在PDF文件夹中)。
在Adobe Reader中打开PDF文档,看起来像。
Docker
您可以在多阶段建筑开发环境中运行该项目,检查多阶段构建。
