SpringCloud工程部署启动

简介: 本教程介绍SpringCloud微服务项目搭建与部署,支持完整工程导入或从零构建。涵盖父工程、子模块创建,POM依赖管理,user-service与order-service模块开发,数据库配置及业务代码编写。通过RestTemplate实现服务间远程调用,解决跨服务数据获取问题,帮助理解微服务拆分与通信机制,为后续深入学习打下基础。

1.工程搭建部署
方案一:完整工程导入
● ,如无法运行尝试换未编译版:
● 下载解压上述工程,ide工具导入
方案二:从零开始搭建
1.工程与module创建
1.1 父工程创建

1.2 子module创建
● module名称:order-service、user-service
● 无效文件夹删除,整体结构如图2

1.3 父pom资源引入

粘贴以下资源依赖,粘贴后maven会自动拉取依赖,如未拉取请手动刷新


org.springframework.boot
spring-boot-starter-parent
2.3.9.RELEASE


UTF-8
UTF-8
1.8
Hoxton.SR10
5.1.47
2.1.1
1.18.20





org.springframework.cloud
spring-cloud-dependencies
${spring-cloud.version}
pom
import



mysql
mysql-connector-java
${mysql.version}



org.mybatis.spring.boot
mybatis-spring-boot-starter
${mybatis.version}


org.projectlombok
lombok
${lombok.version}



1.4 子module资源引入
user-service



org.springframework.boot
spring-boot-starter-web


mysql
mysql-connector-java



org.mybatis.spring.boot
mybatis-spring-boot-starter


org.projectlombok
lombok


app


org.springframework.boot
spring-boot-maven-plugin



order-service



org.springframework.boot
spring-boot-starter-web


mysql
mysql-connector-java



org.mybatis.spring.boot
mybatis-spring-boot-starter


org.projectlombok
lombok




org.springframework.boot
spring-boot-maven-plugin



1.5 业务代码编写
1.user-service
application.yml配置文件
server:
port: 8081
spring:
datasource:
url: jdbc:mysql://localhost:3306/cloud_user?useSSL=false
username: root
password: root123456
driver-class-name: com.mysql.jdbc.Driver
mybatis:
type-aliases-package: cn.itcast.user.pojo
configuration:
map-underscore-to-camel-case: true
logging:
level:
cn.itcast: debug
pattern:
dateformat: MM-dd HH:mm:ss:SSS
|--mapper
|-- UserMapper
package cn.itcast.user.mapper;

import cn.itcast.user.pojo.User;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;

/**

  • 用户持久层
    *
  • @author
  • @date 2022-12-22 14:12
    */
    public interface UserMapper {

    /**

    • 根据ID查找用户
    • @param id 用户ID
    • @return 用户实体信息
      /
      @Select("select
      from tb_user where id=#{id}")
      User findById(@Param("id") Long id);
      }
      |--pojo
      |-- User
      package cn.itcast.user.pojo;

import lombok.Data;

/**

  • 用户实体
    *
  • @author
  • @date 2022-12-22 14:07
    */
    @Data
    public class User {

    /**

    • 主键ID
      */
      private Long id;

      /**

    • 用户姓名
      */
      private String username;

      /**

    • 用户地址
      */
      private String address;
      }
      |--service
      |-- UserService
      package cn.itcast.user.service;

import cn.itcast.user.mapper.UserMapper;
import cn.itcast.user.pojo.User;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.Objects;

/**

  • 用户业务层
    *
  • @author
  • @date 2022-12-22 14:13
    */
    @Service
    public class UserService {

    @Autowired
    private UserMapper userMapper;

    /**

    • 根据ID查找用户
    • @param id 用户ID
    • @return 用户实体信息
      */
      public User findById(Long id) {
      if (Objects.isNull(id)) {
       return null;
      
      }
      return userMapper.findById(id);
      }

}
|--web
|-- UserController
package cn.itcast.user.web;

import cn.itcast.user.pojo.User;
import cn.itcast.user.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**

  • 用户控制层
    *
  • @author
  • @date 2022-12-22 14:15
    */
    @RestController
    @RequestMapping("/user")
    public class UserController {

    @Autowired
    private UserService userService;

    /**

    • 根据ID查找用户
    • @param id ID
    • @return 用户信息
      */
      @GetMapping("/{id}")
      public User findById(@PathVariable("id") Long id) {
      return userService.findById(id);
      }
      }
      |--UserApplication
      package cn.itcast.user;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

/**

  • 启动类
    *
  • @author
  • @date 2022-12-22 14:00
    */
    @MapperScan("cn.itcast.user.mapper")
    @SpringBootApplication
    public class UserApplication {

    public static void main(String[] args) {

     SpringApplication.run(UserApplication.class, args);
     System.out.println("用户工程启动成功");
    

    }
    }

2.order-service
application.yml配置文件
server:
port: 8080
spring:
datasource:
url: jdbc:mysql://localhost:3306/cloud_order?useSSL=false
username: root
password: root123456
driver-class-name: com.mysql.jdbc.Driver
mybatis:
type-aliases-package: cn.itcast.order.pojo
configuration:
map-underscore-to-camel-case: true
logging:
level:
cn.itcast: debug
pattern:
dateformat: MM-dd HH:mm:ss:SSS
|--mapper
|-- OrderMapper
package cn.itcast.order.mapper;

import cn.itcast.order.pojo.Order;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;

/**

  • 订单持久层
    *
  • @author
  • @date 2022-12-22 14:22
    */
    public interface OrderMapper {

    /**

    • 根据ID查找订单
    • @param id 订单ID
    • @return 订单对象
      /
      @Select("select
      from tb_order where id=#{id}")
      Order findById(@Param("id")Long id);
      }

|--pojo
|-- Order
package cn.itcast.order.pojo;

import lombok.Data;

/**

  • 订单实体(vo并非dto)
    *
  • @author
  • @date 2022-12-22 14:19
    */
    @Data
    public class Order {

    /**

    • 主键ID
      */
      private Long id;

      /**

    • 用户主键ID
      */
      private Long userId;

      /**

    • 商品名称
      */
      private String name;

      /**

    • 商品价格
      */
      private Long price;

      /**

    • 商品数量
      */
      private Integer num;

      /**

    • 用户信息
      */
      private User user;
      }

|-- User
package cn.itcast.order.pojo;

import lombok.Data;

/**

  • 用户实体
    *
  • @author
  • @date 2022-12-22 14:07
    */
    @Data
    public class User {

    /**

    • 主键ID
      */
      private Long id;

      /**

    • 用户姓名
      */
      private String username;

      /**

    • 用户地址
      */
      private String address;
      }

|--service
|-- OrderService
package cn.itcast.order.service;

import cn.itcast.order.mapper.OrderMapper;
import cn.itcast.order.pojo.Order;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

/**

  • 订单业务层
    *
  • @author
  • @date 2022-12-22 14:24
    */
    @Service
    public class OrderService {

    @Autowired
    private OrderMapper orderMapper;

    /**

    • 根据ID查找订单
    • @param id 订单ID
    • @return 订单对象
      */
      public Order findById(Long id) {
      Order order = orderMapper.findById(id);
      return order;
      }
      }

|--web
|-- OrderController
package cn.itcast.order.web;

import cn.itcast.order.pojo.Order;
import cn.itcast.order.service.OrderService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**

  • 订单控制层
    *
  • @author
  • @date 2022-12-22 14:25
    */
    @RestController
    @RequestMapping("/order")
    public class OrderController {

    @Autowired
    private OrderService orderService;

    /**

    • 根据ID查找订单
    • @param orderId 订单ID
    • @return 订单对象
      */
      @GetMapping("/{orderId}")
      public Order findById(@PathVariable("orderId")Long orderId) {
      return orderService.findById(orderId);
      }
      }

|--OrderApplication
package cn.itcast.order;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

/**

  • 启动类
    *
  • @author
  • @date 2022-12-22 14:05
    */
    @MapperScan("cn.itcast.order.mapper")
    @SpringBootApplication
    public class OrderApplication {

    public static void main(String[] args) {

     SpringApplication.run(OrderApplication.class, args);
     System.out.println("订单工程启动成功");
    

    }
    }

2.数据库导入

● 需参见上图新建两个数据库,然后导入DDL语句


导完如下

3.项目启动
3.1 启动并访问user-service

3.2 启动并访问order-service

观察发现,虽然order-service服务调用成功,但是里面的user对象却是空的。原因我们应该也可以了解到是因为User对象数据数存储在数据库:tb_user,而此工程连接数据库是:tb_order,查询此数据库时无法获取对应的User数据,怎么获取?获取的具体实现我们将在下一章节进一步铺开。
4.服务远程调用
分析现有链路调用关系可以发现:
http://localhost:8081/user/{id} 可以获取用户信息
http://localhost:8081/order/{orderId} 可以获取订单信息,但是用户信息为空
想要订单信息中返回用户信息,只要在获取订单链路中追加对用户信息的获取、返回值的组装即可,由此引申出微服务之间的远程服务调用,具体调整可见下图。

时序图说明
上述图形为时序图,一般用来描述系统与系统之间的交互流程,主要是交互API、代码顺序、参数一般忽略,时序图不同于业务流程,更关注业务实现过程中系统前后依赖,数据请求与返回,以下为笔者实际工作场景示例:

服务远程调用实现
注入RestTemplate
此处推荐一个小的优雅工具:https://carbon.now.sh/

RestTemplate完成远程服务调用
在此笔者除了完成远程服务调用,同时对代码做了结构化、异常校验、函数封装。虽然此处逻辑并不复杂,但是对于主干逻辑简化和代码风格,希望能起到一个引导作用。
package cn.itcast.order.service;

import cn.itcast.order.mapper.OrderMapper;
import cn.itcast.order.pojo.Order;
import cn.itcast.order.pojo.User;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;

import java.util.Objects;

/**

  • 订单业务层
    *
  • @author
  • @date 2022-12-22 14:24
    */
    @Service
    public class OrderService {

    @Autowired
    private OrderMapper orderMapper;

    @Autowired
    private RestTemplate restTemplate;

    /**

    • 根据ID查找订单
    • @param id 订单ID
    • @return 订单对象
      */
      public Order findById(Long id) {

      // step 1 : 查询订单原始数据
      Order order = orderMapper.findById(id);
      if (Objects.isNull(order)) {

       return null;
      

      }

      // step 2 : 查询用户数据
      User user = queryUserInfoById(order.getUserId());

      // step 3 : 组装用户数据
      if (Objects.nonNull(user)) {

       order.setUser(user);
      

      }

      // step 4: 数据返回
      return order;
      }

      /**

    • 根据用户ID查找用户信息
    • @param userId 用户ID
    • @return 用户信息
      */
      private User queryUserInfoById(Long userId) {
      String url = "http://localhost:8081/user/" + userId;
      return restTemplate.getForObject(url, User.class);
      }
      }
      重启并访问order-service

RestTemplate如何实现远程服务调用

5.总结
本节笔者带领大家完成了SpringCloud工程从0->1的搭建,当然你不想搭建也可以直接采用方案一,二者等效,至此读者们完成了一个微服务工程的搭建、部署、访问。同时在本节最后一章,笔者基于RestTemplate发起的http请求实现远程调用,实现当A系统想要获取B系统数据时的跨系统数据交互。然而RESTful API(进一步了解可移步:链接)访问并不是微服务的唯一解决方案,如Dubbo的交互一样可以实现,希望读者们能不限于此。
在本章节,笔者希望大家对于微服务的拆分,服务调用关系有个初步认知,本例中当order-service调用user-service时,前者就充当了服务调用方,后者则是服务提供方,这种调用关系在后续我们将会大量使用。

思考问题
● 如何实现服务远程调用?
● 服务远程调用解决了什么问题?
● 还有哪些技术可以实现远程服务调用?

6.推荐阅读资料
● 了解时序图绘制:https://www.cnblogs.com/liuyitan/p/16631240.html

相关文章
|
NoSQL fastjson Redis
自定义限流注解@RateLimiter
自定义限流注解@RateLimiter
475 2
|
2月前
|
XML Java 数据库
SpringCloud工程部署启动
本文介绍SpringCloud微服务工程的搭建与部署,涵盖项目创建、模块配置、数据库导入及服务远程调用实现。通过RestTemplate完成服务间HTTP通信,解决跨服务数据获取问题,并引导读者理解微服务拆分与调用关系,为后续深入学习奠定基础。(239字)
 SpringCloud工程部署启动
|
存储 关系型数据库 MySQL
Linux的dev/vda1文件满了导致MySQL无法写入
今天查看两个月前上线的小项目,发现运行非常慢,而且增删改查失效了(吓我一大跳),急急忙忙的就开始了我的线上问题排查之路。/dev/vda1是 Linux 系统中的一个设备文件,它表示第一个虚拟磁盘(vda)的第一个分区(1)。在大多数 Linux 发行版中,这是系统根分区的默认位置。如果您要对/dev/vda1进行操作(例如挂载、格式化、备份等),则需要具有足够的权限。一般来说,只有 root 用户或具有 sudo 权限的用户才能进行这些操作。当Linux的/dev/vda1。
1029 0
|
机器学习/深度学习 自然语言处理 算法
深度学习算法概念介绍
深度学习算法概念介绍
|
7月前
|
缓存 Java 数据库
Java 项目分层架构实操指南及长尾关键词优化方案
本指南详解基于Spring Boot与Spring Cloud的Java微服务分层架构,以用户管理系统为例,涵盖技术选型、核心代码实现、服务治理及部署实践,助力掌握现代化Java企业级开发方案。
353 2
|
Web App开发 前端开发 JavaScript
前端开发必备神器大公开,用过的人都哭了:效率翻倍不是梦!
前端开发结合了创意与技术,本文介绍了几个提升开发效率的工具:Visual Studio Code、Webpack、Postman、GitHub 和 Chrome DevTools。这些工具分别在代码编辑、模块打包、API 测试、版本控制和网页调试等方面发挥重要作用,帮助开发者提高工作效率,优化项目管理。
297 4
|
Java Linux Shell
Nacos安装指南
`Nacos`安装指南包括Windows和Linux两部分。在Windows上,下载Nacos服务端安装包,解压到非中文目录,修改配置文件(如需)并启动服务。通过`startup.cmd -m standalone`启动,然后在浏览器访问`http://127.0.0.1:8848/nacos`。Linux安装涉及安装JDK,上传Nacos安装包,解压并启动服务,使用`sh startup.sh -m standalone`命令。Nacos作为Spring Cloud Alibaba的依赖,需要在项目中引入相关依赖。
973 1
|
消息中间件 Java Nacos
第三章 Spring Cloud简介
第三章 Spring Cloud简介
536 0
|
移动开发 前端开发 Java
Flowable 任务监听器与执行监听器的介绍
Flowable 任务监听器与执行监听器的介绍
3561 1
|
监控 Dubbo 应用服务中间件
启动Dubbo项目注册Zookeeper时提示zookeeper not connected异常原理解析
启动Dubbo项目注册Zookeeper时提示zookeeper not connected异常原理解析
611 0