# snails-api **Repository Path**: kuzank/snails-api ## Basic Information - **Project Name**: snails-api - **Description**: 一个基于 Spring-Boot + Ng-Alain 前后端分离的简单实现 - **Primary Language**: Java - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 5 - **Forks**: 6 - **Created**: 2020-02-10 - **Last Updated**: 2023-08-26 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # snails-api `snails-api` 为 `snails-web` 提供后台 `REST API` 接口 - `Snails 框架`：是一个基于 Spring-Boot + Angular + Ng-Zorro 前后端分离项目的简单实现 - `snails-web 前端`：[Angular](https://angular.cn/) + [Ng-Zorro](https://ng.ant.design/docs/introduce/zh) + [Ng-Alain](https://ng-alain.com) - `snails-api 后台`：[SpringBoot](https://spring.io/projects/spring-boot) + [JPA ](https://spring.io/guides/gs/accessing-data-jpa/)+ [lombok](https://projectlombok.org/) + [Java8](https://zhuanlan.zhihu.com/java8) + Mysql | `框架源码` | Gitee | GitHub | | -------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | | **Snails** 框架 | [https://gitee.com/kuzank/snails](https://gitee.com/kuzank/snails) | [https://github.com/kuzank/snails](https://github.com/kuzank/snails) | | **Snails-web** 前端 | [https://gitee.com/kuzank/snails-web](https://gitee.com/kuzank/snails-web) | [https://github.com/kuzank/snails-web](https://github.com/kuzank/snails-web) | | **Snails-api** 后台 | [https://gitee.com/kuzank/snails-api](https://gitee.com/kuzank/snails-api) | [https://github.com/kuzank/snails-api](https://github.com/kuzank/snails-api) | ## 开发环境要求 - Java 8 - Maven - Mysql ## Mysql 数据库初始化 ```sql CREATE DATABASE IF NOT EXISTS snails DEFAULT CHARSET utf8 COLLATE utf8_general_ci; grant all privileges on snails.* to 'root'@'%' identified by '123456'; flush privileges; ``` ## 启动程序 - 方法一 前提：系统已安装 docker 注意：若 mysql 运行在 docker 中，会出现错误，docker 两个实例之间不能互相访问，需要进行配置处理 ```shell script # maven 清理 mvn clean; # 打包为 docker 镜像 mvn package docker:build # 启动程序 docker run -d --name snails-api -p 8081:8081 -t snails-api # 查看运行中的 docker 实例 docker ps -a ``` ## 启动程序 - 方法二 ```shell script maven clean; # maven 清理 maven package # 打包 # 启动程序 java -jar target/snails-0.1.jar ``` ## 启动程序 - 方法三 ![](https://tva1.sinaimg.cn/large/006tNbRwgy1gal7od3eqfj30oq0c3tat.jpg) ```shell script . ____ _ __ _ _ /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \ ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \ \\/ ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_\__, | / / / / =========|_|==============|___/=/_/_/_/ :: Spring Boot :: (v2.2.2.RELEASE) 2020-01-14 15:27:32.381 WARN 29267 --- [ restartedMain] o.s.boot.StartupInfoLogger : InetAddress.getLocalHost().getHostName() took 5006 milliseconds to respond. Please verify your network configuration (macOS machines may need to add entries to /etc/hosts). 2020-01-14 15:27:37.387 INFO 29267 --- [ restartedMain] com.kuzank.snails.SnailsApplication : Starting SnailsApplication on fanghaoshengdeMacBook-Pro.local with PID 29267 (/Users/kuzan/Documents/snails/snails-api/target/classes started by kuzan in /Users/kuzan/Documents/snails/snails-api) 2020-01-14 15:27:37.388 INFO 29267 --- [ restartedMain] com.kuzank.snails.SnailsApplication : No active profile set, falling back to default profiles: default 2020-01-14 15:27:37.460 INFO 29267 --- [ restartedMain] o.s.b.devtools.restart.ChangeableUrls : The Class-Path manifest attribute in /Users/kuzan/.m2/repository/org/glassfish/jaxb/jaxb-runtime/2.3.2/jaxb-runtime-2.3.2.jar referenced one or more files that do not exist: file:/Users/kuzan/.m2/repository/org/glassfish/jaxb/jaxb-runtime/2.3.2/jakarta.xml.bind-api-2.3.2.jar,file:/Users/kuzan/.m2/repository/org/glassfish/jaxb/jaxb-runtime/2.3.2/txw2-2.3.2.jar,file:/Users/kuzan/.m2/repository/org/glassfish/jaxb/jaxb-runtime/2.3.2/istack-commons-runtime-3.0.8.jar,file:/Users/kuzan/.m2/repository/org/glassfish/jaxb/jaxb-runtime/2.3.2/stax-ex-1.8.1.jar,file:/Users/kuzan/.m2/repository/org/glassfish/jaxb/jaxb-runtime/2.3.2/FastInfoset-1.2.16.jar,file:/Users/kuzan/.m2/repository/org/glassfish/jaxb/jaxb-runtime/2.3.2/jakarta.activation-api-1.2.1.jar 2020-01-14 15:27:37.460 INFO 29267 --- [ restartedMain] .e.DevToolsPropertyDefaultsPostProcessor : Devtools property defaults active! Set 'spring.devtools.add-properties' to 'false' to disable 2020-01-14 15:27:37.460 INFO 29267 --- [ restartedMain] .e.DevToolsPropertyDefaultsPostProcessor : For additional web related logging consider setting the 'logging.level.web' property to 'DEBUG' 2020-01-14 15:27:37.974 INFO 29267 --- [ restartedMain] .s.d.r.c.RepositoryConfigurationDelegate : Bootstrapping Spring Data JPA repositories in DEFAULT mode. 2020-01-14 15:27:38.055 INFO 29267 --- [ restartedMain] .s.d.r.c.RepositoryConfigurationDelegate : Finished Spring Data repository scanning in 74ms. Found 6 JPA repository interfaces. 2020-01-14 15:27:38.322 INFO 29267 --- [ restartedMain] trationDelegate$BeanPostProcessorChecker : Bean 'org.springframework.transaction.annotation.ProxyTransactionManagementConfiguration' of type [org.springframework.transaction.annotation.ProxyTransactionManagementConfiguration] is not eligible for getting processed by all BeanPostProcessors (for example: not eligible for auto-proxying) 2020-01-14 15:27:38.586 INFO 29267 --- [ restartedMain] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port(s): 8081 (http) 2020-01-14 15:27:38.594 INFO 29267 --- [ restartedMain] o.apache.catalina.core.StandardService : Starting service [Tomcat] 2020-01-14 15:27:38.594 INFO 29267 --- [ restartedMain] org.apache.catalina.core.StandardEngine : Starting Servlet engine: [Apache Tomcat/9.0.29] 2020-01-14 15:27:38.661 INFO 29267 --- [ restartedMain] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring embedded WebApplicationContext 2020-01-14 15:27:38.662 INFO 29267 --- [ restartedMain] o.s.web.context.ContextLoader : Root WebApplicationContext: initialization completed in 1201 ms 2020-01-14 15:27:38.821 INFO 29267 --- [ restartedMain] o.hibernate.jpa.internal.util.LogHelper : HHH000204: Processing PersistenceUnitInfo [name: default] 2020-01-14 15:27:38.973 INFO 29267 --- [ restartedMain] org.hibernate.Version : HHH000412: Hibernate Core {5.4.9.Final} 2020-01-14 15:27:39.071 INFO 29267 --- [ restartedMain] o.hibernate.annotations.common.Version : HCANN000001: Hibernate Commons Annotations {5.1.0.Final} 2020-01-14 15:27:39.151 INFO 29267 --- [ restartedMain] com.zaxxer.hikari.HikariDataSource : HikariPool-1 - Starting... 2020-01-14 15:27:39.263 INFO 29267 --- [ restartedMain] com.zaxxer.hikari.HikariDataSource : HikariPool-1 - Start completed. 2020-01-14 15:27:39.274 INFO 29267 --- [ restartedMain] org.hibernate.dialect.Dialect : HHH000400: Using dialect: org.hibernate.dialect.MySQL5InnoDBDialect 2020-01-14 15:27:40.028 INFO 29267 --- [ restartedMain] o.h.e.t.j.p.i.JtaPlatformInitiator : HHH000490: Using JtaPlatform implementation: [org.hibernate.engine.transaction.jta.platform.internal.NoJtaPlatform] 2020-01-14 15:27:40.033 INFO 29267 --- [ restartedMain] j.LocalContainerEntityManagerFactoryBean : Initialized JPA EntityManagerFactory for persistence unit 'default' 2020-01-14 15:27:40.058 INFO 29267 --- [ restartedMain] o.s.b.d.a.OptionalLiveReloadServer : LiveReload server is running on port 35729 2020-01-14 15:27:40.699 WARN 29267 --- [ restartedMain] JpaBaseConfiguration$JpaWebConfiguration : spring.jpa.open-in-view is enabled by default. Therefore, database queries may be performed during view rendering. Explicitly configure spring.jpa.open-in-view to disable this warning 2020-01-14 15:27:40.881 INFO 29267 --- [ restartedMain] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port(s): 8081 (http) with context path '' 2020-01-14 15:27:40.884 INFO 29267 --- [ restartedMain] com.kuzank.snails.SnailsApplication : Started SnailsApplication in 18.837 seconds (JVM running for 24.498) 2020-01-14 15:27:41.029 INFO 29267 --- [ restartedMain] com.kuzank.snails.init.DBInit : ApplicationReadyEvent : init DB successful ! ``` ## 学习资源 - [Angular快速上手](https://angular.cn/guide/quickstart) - [Ng-Zorro](https://ng.ant.design/docs/introduce/zh) - [Ng-Alain](https://ng-alain.com/) - [Sprint系列-程序员DD](http://blog.didispace.com/) - [Sprint系列-纯洁的微笑](http://www.ityouknow.com/spring-boot.html) - [Java8](https://zhuanlan.zhihu.com/java8) - [lombok](https://www.jianshu.com/p/365ea41b3573) - [SpringBoot 中 JPA 的使用](https://www.jianshu.com/p/c14640b63653)