基于【 springBoot +springCloud+vue】的项目之一 || 后端搭建
缘起
本项目是基于之前学习的一个dubbo+ssm分布式项目进行升级,基于此项目对前后端分离项目、微服务项目进一步深入学习。之前学习了vue、springboot、springcloud后,没有进行更多实战练习,借助此机会,整合之前所学知识,搭建一套微服务电商系统。本项目纯属个人学习总结,如有错误之处,还希望大家能指出,共同讨论学习。
正文
1、项目依赖环境
工具:idea+vscode
数据库:mysql
缓存:redis
消息中间件:activemq
2、项目架构图(暂时留个位置)
3、整体框架结构
-parent 聚合工程
-api 各模块提供服务的接口
-eurekaserver 服务注册中心
-pojo 通用实体类层
-dao 通用数据访问层
-common 通用方法
-xxxxx-interface 某服务层接口
-xxxxx-service 某服务层实现
-xxxxx-web 某web工程
4、数据库表
(后期上传)
一、搭建框架
1、创建父工程
至于如何创建聚合工程,此处不在详细说明,网上有更多详细的教程。
创建maven工程pinyougou-parent (pom) ,groupid 为com.pinyougou ,artifactid 为pinyougou-parent 。
添加依赖(后期根据需求有所变更)
<dependencies> <!--安全框架--> <!--<dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-security</artifactid> </dependency>--> <!-- springboot整合activemq --> <dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-activemq</artifactid> </dependency> <!-- springboot整合amqp --> <!--<dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-amqp</artifactid> </dependency>--> <!--数据库jdbc连接池--> <dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-jdbc</artifactid> </dependency> <!-- 集成web--> <dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-web</artifactid> </dependency> <!--整合mybatis--> <dependency> <groupid>org.mybatis.spring.boot</groupid> <artifactid>mybatis-spring-boot-starter</artifactid> <version>2.0.0</version> </dependency> <!--集成springcloud--> <dependency> <groupid>org.springframework.cloud</groupid> <artifactid>spring-cloud-starter-netflix-eureka-server</artifactid> </dependency> <dependency> <groupid>org.springframework.cloud</groupid> <artifactid>spring-cloud-starter-openfeign</artifactid> </dependency> <dependency> <groupid>org.springframework.cloud</groupid> <artifactid>spring-cloud-starter-netflix-zuul</artifactid> </dependency> <!--集成热部署--> <dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-devtools</artifactid> <scope>runtime</scope> </dependency> <!--mysql连接驱动--> <dependency> <groupid>mysql</groupid> <artifactid>mysql-connector-java</artifactid> <scope>runtime</scope> </dependency> <!-- 集成lombok 框架 --> <dependency> <groupid>org.projectlombok</groupid> <artifactid>lombok</artifactid> <optional>true</optional> </dependency> <!--springboot测试--> <dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-test</artifactid> <scope>test</scope> </dependency> <!-- 集成redis --> <dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-data-redis</artifactid> </dependency> <!-- jedis客户端 --> <dependency> <groupid>redis.clients</groupid> <artifactid>jedis</artifactid> </dependency> <!-- spring2.x集成redis所需common-pool2,使用jedis必须依赖它--> <dependency> <groupid>org.apache.commons</groupid> <artifactid>commons-pool2</artifactid> <version>2.5.0</version> </dependency> <!-- 集成aop --> <dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-aop</artifactid> </dependency> <!-- 集成commons工具类 --> <dependency> <groupid>org.apache.commons</groupid> <artifactid>commons-lang3</artifactid> <version>3.4</version> </dependency> <!-- 集成发送邮件--> <dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-mail</artifactid> </dependency> <!-- 阿里巴巴数据源 --> <dependency> <groupid>com.alibaba</groupid> <artifactid>druid</artifactid> <version>1.1.14</version> </dependency> <!-- httpclient --> <dependency> <groupid>commons-httpclient</groupid> <artifactid>commons-httpclient</artifactid> <version>3.1</version> </dependency> <dependency> <groupid>org.apache.httpcomponents</groupid> <artifactid>httpclient</artifactid> </dependency> <dependency> <groupid>com.alibaba</groupid> <artifactid>fastjson</artifactid> <version>1.2.30</version> </dependency> <dependency> <groupid>org.springframework</groupid> <artifactid>spring-context-support</artifactid> </dependency> <dependency> <groupid>commons-net</groupid> <artifactid>commons-net</artifactid> <version>3.3</version> </dependency> <!--<dependency> <groupid>org.springframework.security</groupid> <artifactid>spring-security-test</artifactid> <scope>test</scope> </dependency>--> </dependencies>
2、服务注册中心模块
创建服务注册中心模块-pinyougou-eurekaserver
配置注册中心,端口号设置为8761
server: port: 8761 eureka: instance: hostname: localhost # eureka实例的主机名 client: register-with-eureka: false #不把自己注册到eureka上 fetch-registry: false #不从eureka上来获取服务的注册信息 service-url: defaultzone: http://${eureka.instance.hostname}:${server.port}/eureka/ #服务的注册地址
添加启动类,开启eureka server服务
@springbootapplication(exclude = {datasourceautoconfiguration.class}) @enableeurekaserver //开启eureka server public class eurekaserverapplication { public static void main(string[] args){ springapplication.run(eurekaserverapplication.class,args); } }
测试:启动eureka server服务,浏览器输入,
能访问springeureka说明服务注册中心配置成功.
3、通用实体类模块
创建通用实体类模块-pinyougou-pojo
pojo:数据库实体类
entity:统一返回数据实体类
pojogroup:封装的实体类数据
4、通用数据访问模块
创建通用数据访问模块pinyougou-dao .添加依赖pinyougou-pojo
新建包com.pinyougou.mapper,写需要的mapper接口,注意:需要在加注释@mapper
在resource下,写mapper映射文件
5、通用工具类模块
创建通用工具类模块pinyougou-common
6、商家商品服务接口模块
创建模块pinyougou-sellergoods-interface,添加依赖pinyougou-pojo
新建包com.pinyougou.sellergoods.service,写service层接口
7、服务接口提供模块
创建pinyougou-api(pom)
说明:该模块提供各模块所需提供的接口,为api父工程,各模块需要提供接口服务时,在该父工程下新建各自的子模块.
本项目实现流程:该模块提供的接口,在对应service模块编写逻辑,调用方调用服务的时候,继承api提供的接口,使用@feignclient(‘service模块的名称’)注解调用服务.
8、商品服务api
创建pinyougou-sellergoods-api模块,依赖pinyougou-pojo
创建包com.pinyougou.pojo.tbbrand,编写一个测试类:
@requestmapping("/brand") public interface brandapiservice { @requestmapping("/findall") public list<tbbrand> findall(); }
9、商家商品服务模块
创建pinyougou-sellergoods-service,
添加依赖pinyougou-sellergoods-interface,pinyougou-dao,pinyougou-sellergoods-api
配置文件:
server: port: 9001 eureka: client: service-url: defaultzone: http://localhost:8761/eureka/ spring: application: name: sellergoods datasource: name: pinyougoudb #?useunicode=true&characterencoding=utf8 url: jdbc:mysql://localhost:3306/pinyougoudb?useunicode=true&characterencoding=utf8&servertimezone=utc username: root password: root # 使用druid数据源 type: com.alibaba.druid.pool.druiddatasource driver-class-name: com.mysql.cj.jdbc.driver # 数据源其他配置 initialsize: 5 minidle: 5 maxactive: 20 maxwait: 60000 timebetweenevictionrunsmillis: 60000 minevictableidletimemillis: 300000 validationquery: select 1 from dual testwhileidle: true testonborrow: false testonreturn: false poolpreparedstatements: true # 配置监控统计拦截的filters,去掉后监控界面sql无法统计,'wall'用于防火墙 filters: stat,wall,log4j maxpoolpreparedstatementperconnectionsize: 20 useglobaldatasourcestat: true connectionproperties: druid.stat.mergesql=true;druid.stat.slowsqlmillis=500 mybatis: # 指定全局配置文件位置 #config-location: classpath:mybatis/mybatis-config.xml mapper-locations: classpath*:/mapper/*mapper.xml #实体扫描,多个package用逗号或者分号分隔 type-aliases-package: com.pinyougou.pojo configuration: #配置返回数据库(column下划线命名&&返回java实体是驼峰命名),自动匹配无需as(没开启这个,sql需要写as: select user_id as userid) map-underscore-to-camel-case: true #配置jdbctypefornull, oracle数据库必须配置 jdbc-type-for-null: 'null'
编写启动类,添加扫描mapper类的注解,将服务注册到注册中心
@mapperscan(value = "com.pinyougou.mapper") @springbootapplication @enableeurekaclient public class sellergoodsserviceapplication { public static void main(string[] args) { springapplication.run(sellergoodsserviceapplication.class, args); } }
创建包com.pinyougou.sellergoods.service.impl,作用:实现interface模块,编写数据访问层业务逻辑.注意:该类上要加@service注解.
创建包com.pinyougou.sellergoods.api.service.impl,作用:实现服务提供者api接口,编写暴露接口的业务逻辑,注意:该类上要添加@restcontroller注解.
10、运营商管理后台
创建包pinyougou-manager-web,依赖pinyougou-sellergoods-api
在resources下创建配置文件:
server: port: 9101 eureka: client: service-url: defaultzone: http://localhost:8761/eureka/ spring: freemarker: suffix: .html templateloaderpath: classpath:/templates/ cache: false #禁用模板缓存,正式环境取消 application: name: managerweb main: allow-bean-definition-overriding: true
创建包com.pinyougou.manager.feign,用于服务的调用
@feignclient("sellergoods") //写service层的名称 public interface brandfeign extends brandapiservice { }
此时,就可以使用brandfeign调用brandapiservice的接口
创建包com.pinyougou.manager.controller,进行测试
@restcontroller @requestmapping("/brands") public class brandcontroller { @autowired private brandfeign brandfeign; @requestmapping("/findall") public list<tbbrand> findall(){ list<tbbrand> lists=null; lists=brandfeign.findall(); return lists; } }
启动服务:
启动pinyougou-eurekaserver
启动pinyougou-sellergoods-service
启动pinyougou-manager-web
在浏览器输入:http://localhost:9101/brands/findall,如果能获取到数据库数据,说明服务调用成功.
此时,浏览器中输入,能看到刚启动的两个服务已经注册到eureka注册中心了.
目前的项目框架如下: