h5海报怎么制作/网站seo招聘

h5海报怎么制作,网站seo招聘,天津专门做企业网站公司,营销推广的方案目录 一、在本地部署并启动Nginx服务1. 解压Nginx压缩包2. 启动Nginx服务3. 验证Nginx是否启动成功: 二、导入接口文档1. 黑马程序员提供的YApi平台2. YApi Pro平台3. 推荐工具:Apifox 三、Swagger1. 常用注解1.1 Api与ApiModel1.2 ApiModelProperty与Ap…

目录

  • 一、在本地部署并启动Nginx服务
    • 1. 解压Nginx压缩包
    • 2. 启动Nginx服务
    • 3. 验证Nginx是否启动成功:
  • 二、导入接口文档
    • 1. 黑马程序员提供的YApi平台
    • 2. YApi Pro平台
    • 3. 推荐工具:Apifox
  • 三、Swagger
    • 1. 常用注解
      • 1.1 @Api与@ApiModel
      • 1.2 @ApiModelProperty与@ApiOperation
  • 四、基于JWT和ThreadLocal动态获取员工ID
    • 1. 在pom.xml中引入JWT依赖
    • 2. 在application.yaml中配置JWT参数
    • 3. 使用JWT获取当前登录员工ID
    • 4. 通过拦截器解析JWT
    • 5. 使用ThreadLocal传递员工ID
    • 6. 在Service中获取员工ID
  • 五、DTO的使用原因
    • 1. 实体类 Employee
    • 2. DTO EmployeeDTO
    • 3. 使用 DTO 的场景
      • 3.1 查询员工信息
      • 3.2 更新员工信息
      • 3.3 新增员工
    • 4. DTO、VO和实体类的区别
  • 六、为什么使用 XML 注解而不是 MyBatis 注解
    • 1. 使用 XML 注解的原因
      • 1.1 动态 SQL 支持
      • 1.2 SQL 与代码分离
      • 1.3 复用性
      • 1.4 工具支持
    • 2. MyBatis 注解的局限性
      • 2.1 动态 SQL 支持有限
      • 2.2 可读性差
      • 2.3 维护困难
  • 七、Spring Boot 的请求映射规则
    • 1. 类级别路径
    • 2. 方法级别路径
      • 2.1 分页查询
      • 2.2 根据 ID 查询菜品
      • 2.3 修改菜品
      • 2.4 新增菜品
      • 2.5 批量删除菜品
    • 3. 如何区分不同的功能
    • 4. 示例请求
      • 4.1 新增菜品
      • 4.2 修改菜品
      • 4.3 批量删除菜品
      • 4.4 分页查询菜品
      • 4.5 根据 ID 查询菜品
  • 八、接口设计中的是否必须原则
    • 1. 请求参数说明
      • 1.1 Java代码分析
        • 1.1.1 必需参数
      • 1.2 XML映射文件分析
        • 1.2.1 可选参数
    • 2. 返回响应说明
      • 2.1 Java代码分析
        • 2.1.1 必需参数
        • 2.1.2 可选参数
      • 2.2 返回响应示例
        • 2.2.1 成功响应(带数据)
        • 2.2.2 成功响应(不带数据)
        • 2.2.3 失败响应
  • 九、阿里云OSS配置指南
    • 1. 注册阿里云OSS账号
    • 2. 获取关键信息
    • 3. 更新配置文件
    • 4, 重新运行服务
  • 十、SpringBoot配置类详解
    • 1. 生产环境与开发环境配置
      • 1.1 配置文件命名规则
      • 1.2 激活环境配置
      • 1.3 占位符替换
        • 示例
    • 2. Spring 前缀与自定义前缀配置
      • 2.1 Spring 内置配置
      • 2.2 自定义配置
    • 3. 自定义配置类的注册与使用
      • 3.1 创建配置类
        • 3.1.1 JWT 配置类
        • 3.1.2 阿里云 OSS 配置类
      • 3.2 使用配置类
        • 3.2.1 在 Service 中使用配置类
      • 3.3 配置类的注册
  • 十一、SpringBoot注解汇总
    • 1. Spring MVC 相关注解
    • 2. Swagger 相关注解
    • 3. Spring 核心注解
    • 4. AOP 相关注解
    • 5. Lombok 相关注解
    • 6. MyBatis 相关注解
    • 7. 配置相关注解


视频链接:黑马程序员Java项目实战《苍穹外卖》,最适合新手的SpringBoot+SSM的企业级Java项目实战
网盘资料:苍穹外卖讲义&前后端源码


一、在本地部署并启动Nginx服务

在开发过程中,我们经常需要使用Nginx来部署前端项目或作为反向代理服务器。

1. 解压Nginx压缩包

首先,确保你已经从黑马程序员资料中下载了Nginx的压缩包。接下来,按照以下步骤解压:

选择解压路径

  • 将Nginx压缩包解压到一个全英文路径中。例如:
    D:\nginx
    
  • 注意:路径中不要包含中文或特殊字符,否则可能会导致Nginx无法正常运行。

2. 启动Nginx服务

解压完成后,按照以下步骤启动Nginx:

进入Nginx目录

  • 打开解压后的Nginx文件夹,找到nginx.exe文件。路径通常为:
    C:\nginx\nginx.exe
    

启动Nginx

  • 双击nginx.exe文件,启动Nginx服务。
  • 启动后,Nginx会在后台运行,你可以在任务管理器中看到nginx.exe进程。

3. 验证Nginx是否启动成功:

  • 打开浏览器,访问以下地址(其中80是默认端口可省略不写):
    http://localhost:80
    
  • 如果看到此页面,说明Nginx已成功启动。
    在这里插入图片描述
  • 注意:Nginx默认不会随系统自动启动,因此每次重启电脑后,都需要手动启动Nginx

二、导入接口文档

在开发过程中,接口管理平台是团队协作和项目管理的重要工具。以下是几个常用平台的对比:

1. 黑马程序员提供的YApi平台

  • 地址:http://yapi.smart-xwork.cn/
  • 状态:已弃用
  • 功能:适合用于接口管理和文档生成。

2. YApi Pro平台

  • 地址:https://yapi.pro/
  • 问题:需要挂梯子才能访问,且极易卡顿,使用体验不佳。

3. 推荐工具:Apifox

  • 地址:https://apifox.com/
  • 优势:
    • 无需梯子即可访问。
    • 性能流畅,支持接口文档、Mock数据、自动化测试等功能。
    • 支持导入YApi数据格式的接口文档,方便无缝迁移现有项目。

在这里插入图片描述


三、Swagger

Swagger 是一种用于设计、构建、记录和使用 RESTful Web 服务的开源框架。它提供了一套工具,帮助开发者设计、构建、文档化和测试 API。

启动服务:访问 http://localhost:8080/doc.html
在这里插入图片描述

1. 常用注解

通过注解可以控制生成的接口文档,使接口文档拥有更好的可读性,常用注解如下:

注解说明
@Api用在类上,例如Controller,表示对类的说明
@ApiModel用在类上,例如entity、DTO、VO
@ApiModelProperty用在属性上,描述属性信息
@ApiOperation用在方法上,例如Controller的方法,说明方法的用途、作用

1.1 @Api与@ApiModel

在这里插入图片描述

在这里插入图片描述

1.2 @ApiModelProperty与@ApiOperation

在这里插入图片描述
在这里插入图片描述


四、基于JWT和ThreadLocal动态获取员工ID

在开发员工管理系统时,新增员工时需要记录创建人和修改人的ID。如果直接使用固定值,会导致数据不准确,无法真实反映操作者。

public void save(EmployeeDTO employeeDTO) {Employee employee = new Employee();employee.setCreateUser(10L); // 固定值employee.setUpdateUser(10L); // 固定值employeeMapper.insert(employee);
}

因此我们要通过JWT和ThreadLocal动态获取当前登录员工的ID,并实现数据的准确记录。在使用 JWT(JSON Web Token)进行身份验证时,通常需要在项目中引入相关的依赖库,并在配置文件中设置 JWT 的参数。以下是如何在 Spring Boot 项目中引入 JWT 并进行配置的简单说明:

1. 在pom.xml中引入JWT依赖

为了使用 JWT,我们需要引入一个 JWT 库,比如 java-jwt(由 Auth0 提供)。

<dependency><groupId>com.auth0</groupId><artifactId>java-jwt</artifactId><version>4.4.0</version> <!-- 使用最新版本 -->
</dependency>

2. 在application.yaml中配置JWT参数

application.yaml 文件中定义 JWT 的相关配置,例如密钥、过期时间和令牌名称。

sky:jwt:# 设置 JWT 签名加密时使用的秘钥admin-secret-key: itcast# 设置 JWT 过期时间(单位:毫秒)admin-ttl: 7200000 # 2小时# 设置前端传递过来的令牌名称admin-token-name: token
  • admin-secret-key:用于签名和验证 JWT 的密钥。必须保密,且长度足够复杂以确保安全性。
  • admin-ttl:JWT 的有效期(以毫秒为单位)。例如,7200000 表示 2 小时。
  • admin-token-name:前端传递 JWT 时使用的参数名称。例如,前端可能会在请求头或请求参数中传递 token=xxx

3. 使用JWT获取当前登录员工ID

员工登录成功后,系统会生成JWT令牌并返回给前端。JWT中包含了当前登录员工的ID信息。

/*** 员工管理*/
@RestController
@RequestMapping("/admin/employee")
@Api(tags = "员工相关接口")
@Slf4j
public class EmployeeController {@Autowiredprivate EmployeeService employeeService;@Autowiredprivate JwtProperties jwtProperties;/*** 登录** @param employeeLoginDTO* @return*/@PostMapping("/login")public Result<EmployeeLoginVO> login(@RequestBody EmployeeLoginDTO employeeLoginDTO) {log.info("员工登录:{}", employeeLoginDTO);Employee employee = employeeService.login(employeeLoginDTO);//登录成功后,生成jwt令牌Map<String, Object> claims = new HashMap<>();claims.put(JwtClaimsConstant.EMP_ID, employee.getId());String token = JwtUtil.createJWT(jwtProperties.getAdminSecretKey(),jwtProperties.getAdminTtl(),claims);EmployeeLoginVO employeeLoginVO = EmployeeLoginVO.builder().id(employee.getId()).userName(employee.getUsername()).name(employee.getName()).token(token).build();return Result.success(employeeLoginVO);}...
}

4. 通过拦截器解析JWT

在每次请求时,前端会携带JWT令牌。通过拦截器解析JWT,获取当前登录员工的ID。

/*** jwt令牌校验的拦截器*/
@Component
@Slf4j
public class JwtTokenAdminInterceptor implements HandlerInterceptor {@Autowiredprivate JwtProperties jwtProperties;/*** 校验jwt** @param request* @param response* @param handler* @return* @throws Exception*/public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {//判断当前拦截到的是Controller的方法还是其他资源if (!(handler instanceof HandlerMethod)) {//当前拦截到的不是动态方法,直接放行return true;}//1、从请求头中获取令牌String token = request.getHeader(jwtProperties.getAdminTokenName());//2、校验令牌try {log.info("jwt校验:{}", token);Claims claims = JwtUtil.parseJWT(jwtProperties.getAdminSecretKey(), token);Long empId = Long.valueOf(claims.get(JwtClaimsConstant.EMP_ID).toString());log.info("当前员工id:", empId);BaseContext.setCurrentId(empId);//3、通过,放行return true;} catch (Exception ex) {//4、不通过,响应401状态码response.setStatus(401);return false;}}
}

5. 使用ThreadLocal传递员工ID

通过ThreadLocal实现线程隔离,将当前登录员工的ID传递给Service层。

public class BaseContext {public static ThreadLocal<Long> threadLocal = new ThreadLocal<>();public static void setCurrentId(Long id) {threadLocal.set(id);}public static Long getCurrentId() {return threadLocal.get();}public static void removeCurrentId() {threadLocal.remove();}
}

6. 在Service中获取员工ID

在Service层中,从ThreadLocal中获取当前登录员工的ID,并设置为创建人和修改人。

public void save(EmployeeDTO employeeDTO) {Employee employee = new Employee();employee.setCreateUser(BaseContext.getCurrentId()); // 动态获取当前登录员工IDemployee.setUpdateUser(BaseContext.getCurrentId()); // 动态获取当前登录员工IDemployeeMapper.insert(employee);
}

五、DTO的使用原因

在项目中,Employee 是实体类(Entity),用于表示数据库中的员工记录,而 EmployeeDTO 是数据传输对象(DTO),用于在不同层之间传递数据。以下是使用 DTO 的主要原因和优势:

1. 实体类 Employee

package com.sky.entity;import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;import java.io.Serializable;
import java.time.LocalDateTime;@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class Employee implements Serializable {private static final long serialVersionUID = 1L;private Long id;           // 员工IDprivate String username;   // 用户名private String name;       // 姓名private String password;   // 密码(敏感字段)private String phone;      // 手机号private String sex;        // 性别private String idNumber;   // 身份证号private Integer status;    // 状态private LocalDateTime createTime; // 创建时间(内部字段)private LocalDateTime updateTime; // 更新时间(内部字段)private Long createUser;   // 创建人(内部字段)private Long updateUser;   // 更新人(内部字段)
}

2. DTO EmployeeDTO

package com.sky.dto;import lombok.Data;
import java.io.Serializable;@Data
public class EmployeeDTO implements Serializable {private Long id;           // 员工IDprivate String username;   // 用户名private String name;       // 姓名private String phone;      // 手机号private String sex;        // 性别private String idNumber;   // 身份证号
}

3. 使用 DTO 的场景

3.1 查询员工信息

  • 前端只需要员工的基本信息(如 idusernamenamephonesexidNumber)。
  • 后端返回 EmployeeDTO,过滤掉敏感字段(如 password)和内部字段(如 createTime)。

3.2 更新员工信息

  • 前端传递 EmployeeDTO 作为请求体,后端根据 DTO 更新员工信息。
  • 避免前端传递不必要的字段(如 passwordcreateTime)。

3.3 新增员工

  • 前端传递 EmployeeDTO 作为请求体,后端将 DTO 转换为实体类并保存到数据库。
  • 避免前端传递内部字段(如 createTimeupdateTime)。

4. DTO、VO和实体类的区别

特性DTOVOEntity
目的数据传输数据展示或封装值表示数据库中的数据结构
使用场景跨层数据传输(如Controller-Service)展示层或领域模型数据库操作、业务逻辑
可变性可变(通常有setter)通常不可变(无setter)可变(用于持久化和业务逻辑)
字段与传输需求相关与展示或业务逻辑相关与数据库表字段严格对应
行为通常无行为可能包含简单行为(如格式化)包含业务逻辑和验证规则
示例UserDTOUserVOUserEntity

六、为什么使用 XML 注解而不是 MyBatis 注解

1. 使用 XML 注解的原因

1.1 动态 SQL 支持

  • XML 提供了强大的动态 SQL 支持,例如 <if><foreach><choose> 等标签。
  • 在复杂的查询场景中,动态 SQL 可以更灵活地构建 SQL 语句。

1.2 SQL 与代码分离

  • 将 SQL 语句写在 XML 文件中,可以使 SQL 与 Java 代码分离,便于维护和管理。
  • 对于复杂的 SQL 语句,XML 文件的可读性更高。

1.3 复用性

  • XML 文件中的 SQL 语句可以在多个 Mapper 接口中复用。
  • 例如,可以在不同的 Mapper 接口中引用同一个 SQL 片段。

1.4 工具支持

  • MyBatis 提供了丰富的工具支持 XML 文件的编写和调试。
  • 例如,MyBatis Generator 可以自动生成 XML 映射文件。

2. MyBatis 注解的局限性

2.1 动态 SQL 支持有限

  • MyBatis 注解对动态 SQL 的支持较弱,复杂的 SQL 语句难以用注解实现。
  • 例如,@Select 注解无法直接实现 <foreach> 这样的动态 SQL。
<select id="getSetmealIdsByDishIds" resultType="java.lang.Long">select setmeal_id from setmeal_dish where dish_id in<foreach collection="dishIds" item="dishId" separator="," open="(" close=")">#{dishId}</foreach>
</select>

2.2 可读性差

  • 复杂的 SQL 语句写在注解中会导致代码冗长,可读性差。
  • 例如,一个包含多个条件的查询语句会显得非常混乱。

2.3 维护困难

  • SQL 语句与 Java 代码混合在一起,维护起来不如 XML 文件方便。
  • 修改 SQL 语句时需要重新编译 Java 代码。

你提到的代码中有两个 @PutMapping 注解没有指定路径,这意味着它们默认映射到类级别的路径 /admin/dish。以下是对这个问题的详细解释:


七、Spring Boot 的请求映射规则

在 Spring Boot 中,请求的映射是通过 类级别的 @RequestMapping方法级别的 @PutMapping@GetMapping 等注解 共同决定的。

  • 类级别的 @RequestMapping
    • 定义了该类中所有方法的公共路径前缀。
    • 例如,@RequestMapping("/admin/dish") 表示该类中的所有方法都映射到 /admin/dish 路径下。
    • 管理端发出的请求,统一使用/admin作为前缀。
    • 用户端发出的请求,统一使用/user作为前缀。
  • 方法级别的 @PutMapping@GetMapping
    • 定义了具体的 HTTP 方法和路径。
    • 如果方法级别的注解没有指定路径,则默认使用类级别的路径。

1. 类级别路径

@RestController
@RequestMapping("/admin/dish")
public class DishController {// 方法定义...
}
  • 所有方法的公共路径前缀是 /admin/dish

2. 方法级别路径

2.1 分页查询

@GetMapping("/page")
public Result<PageResult> page(DishPageQueryDTO dishPageQueryDTO) {// 方法实现...
}
  • 完整路径是 /admin/dish/page

2.2 根据 ID 查询菜品

@GetMapping("/{id}")
public Result<DishVO> getById(@PathVariable Long id) {// 方法实现...
}
  • 完整路径是 /admin/dish/{id}

2.3 修改菜品

@PutMapping
public Result update(@RequestBody DishDTO dishDTO) {// 方法实现...
}
  • 由于 @PutMapping 没有指定路径,默认使用类级别的路径 /admin/dish

2.4 新增菜品

@PostMapping
public Result save(@RequestBody DishDTO dishDTO) {// 方法实现...
}
  • 由于 @PostMapping 没有指定路径,默认使用类级别的路径 /admin/dish

2.5 批量删除菜品

@DeleteMapping
public Result delete(@RequestParam List<Long> ids) {// 方法实现...
}
  • 由于 @DeleteMapping 没有指定路径,默认使用类级别的路径 /admin/dish

3. 如何区分不同的功能

Spring Boot 通过 HTTP 方法 来区分不同的功能。例如:

HTTP 方法路径功能
POST/admin/dish新增菜品
PUT/admin/dish修改菜品
DELETE/admin/dish批量删除菜品
GET/admin/dish/page分页查询菜品
GET/admin/dish/{id}根据 ID 查询菜品

4. 示例请求

4.1 新增菜品

  • HTTP 方法POST
  • URL/admin/dish
  • 请求体
    {"name": "宫保鸡丁","price": 38.0,"flavors": [{"name": "微辣","value": "少辣"}]
    }
    

4.2 修改菜品

  • HTTP 方法PUT
  • URL/admin/dish
  • 请求体
    {"id": 1,"name": "宫保鸡丁","price": 40.0,"flavors": [{"name": "微辣","value": "少辣"}]
    }
    

4.3 批量删除菜品

  • HTTP 方法DELETE
  • URL/admin/dish?ids=1,2,3
  • 请求参数ids=1,2,3

4.4 分页查询菜品

  • HTTP 方法GET
  • URL/admin/dish/page?page=1&pageSize=10
  • 请求参数page=1&pageSize=10

4.5 根据 ID 查询菜品

  • HTTP 方法GET
  • URL/admin/dish/1
  • 路径参数id=1

八、接口设计中的是否必须原则

参数的必需与非必需性是通过不同的方式来体现的,以下是具体案例

1. 请求参数说明

在这里插入图片描述

从接口文档中可以看到,请求参数包括以下几项:

参数名类型说明必需性示例值
categoryIdstring分类id可选101
namestring菜品名称可选官保鸡丁
pagestring页码必需1
pageSizestring每页记录数必需10
statusstring分类状态可选1
  • 必需参数

    • pagepageSize 是分页查询的必需参数,用于指定查询的页码和每页的记录数。
  • 可选参数

    • categoryIdnamestatus 是可选参数,用于过滤查询结果。

1.1 Java代码分析

在此 Java 代码中,DishPageQueryDTO 是一个数据传输对象(DTO),用于封装分页查询的参数。以下是代码的详细分析:

public PageResult pageQuery(DishPageQueryDTO dishPageQueryDTO) {// 1. 使用 PageHelper 进行分页PageHelper.startPage(dishPageQueryDTO.getPage(), dishPageQueryDTO.getPageSize());// 2. 调用 Mapper 进行查询Page<DishVO> page = dishMapper.pageQuery(dishPageQueryDTO);// 3. 返回分页结果return new PageResult(page.getTotal(), page.getResult());
}
1.1.1 必需参数
  • dishPageQueryDTO.getPage()dishPageQueryDTO.getPageSize() 是分页查询的必需参数。
  • 如果这两个参数为空或未提供,分页功能将无法正常工作。

1.2 XML映射文件分析

在 SQL 代码中,动态 SQL 语句根据传入的参数生成查询条件。以下是代码的详细分析:

<select id="pageQuery" resultType="com.sky.vo.DishVO">select d.* , c.name as categoryName from dish d left outer join category c on d.category_id = c.id<where><if test="name != null">and d.name like concat('%',#{name},'%')</if><if test="categoryId != null">and d.category_id = #{categoryId}</if><if test="status != null">and d.status = #{status}</if></where>order by d.create_time desc
</select>
1.2.1 可选参数
  • namecategoryIdstatus 是可选参数,通过 <if> 标签动态生成查询条件。
  • 如果某个参数为 null,则对应的条件不会添加到 SQL 查询中。

通过这种设计,分页查询接口既满足了基本的查询需求,又提供了灵活的过滤选项,适用于不同的业务场景。


2. 返回响应说明

在 API 设计中,返回响应的数据结构通常需要遵循一定的规范,以确保客户端能够准确处理和理解服务器的响应。Result<T> 类是一个典型的统一响应格式,根据不同的设计需求,我们发现 code 一定是必需的,而 msgdata 在某些情况下是可选的,而在某些情况可能是必需的。接下来,我们将详细探讨这种设计背后的原因。

在这里插入图片描述
在这里插入图片描述

2.1 Java代码分析

package com.sky.result;import lombok.Data;import java.io.Serializable;`/*** 后端统一返回结果* @param <T>*/
@Data
public class Result<T> implements Serializable {private Integer code; //编码:1成功,0和其它数字为失败private String msg; //错误信息private T data; //数据public static <T> Result<T> success() {Result<T> result = new Result<T>();result.code = 1;return result;}public static <T> Result<T> success(T object) {Result<T> result = new Result<T>();result.data = object;result.code = 1;return result;}public static <T> Result<T> error(String msg) {Result result = new Result();result.msg = msg;result.code = 0;return result;}}
2.1.1 必需参数

code 是必需的

  • 作用code 用于表示请求的处理结果状态,通常是一个数字。
    • 例如: 1 表示成功,0 或其他数字表示失败。
  • 为什么必需
    • 明确状态:客户端需要知道请求是否成功。code 提供了一个明确的状态标识,客户端可以根据它决定后续操作。
    • 标准化:统一的 code 值可以让客户端以一致的方式处理所有 API 的响应。
    • 错误处理:当请求失败时,code 可以帮助客户端快速定位问题类型(如权限不足、资源不存在等)。
2.1.2 可选参数

msg 是可选的

  • 作用msg 用于提供额外的错误信息或成功提示。
    • 例如:成功时:msg 可以为空或包含提示信息(如“操作成功”),失败时:msg 可以包含具体的错误描述(如“用户未找到”)。
  • 为什么可选
    • 成功时可能不需要:在请求成功的情况下,客户端可能只需要 data,而不需要额外的提示信息。
    • 减少冗余:如果 msg 是必需的,即使没有实际意义的信息(如成功时的默认提示),也需要返回,这会增加响应的冗余。
    • 灵活性:在某些场景下,错误信息可能由其他方式提供(如日志或专门的错误处理机制),因此 msg 可以省略。

data 是可选的

  • 作用data 用于承载实际的响应数据。
    • 例如:查询接口返回的列表或对象,创建接口返回的新创建的资源。
  • 为什么可选
    • 某些操作不需要返回数据:例如,删除操作或简单的状态更新操作可能不需要返回任何数据。
    • 减少冗余:如果 data 是必需的,即使没有数据也需要返回一个空对象或 null,这会增加响应的冗余。
    • 灵活性:某些接口可能只需要返回状态信息(如 codemsg),而不需要额外的数据。

2.2 返回响应示例

2.2.1 成功响应(带数据)
{"code": 1,"msg": "操作成功","data": {"id": 123,"name": "John Doe"}
}
2.2.2 成功响应(不带数据)
{"code": 1
}
2.2.3 失败响应
{"code": 0,"msg": "用户未找到"
}

这种设计符合 API 设计的最佳实践,能够满足大多数场景的需求,同时保持简洁和一致性。


九、阿里云OSS配置指南

在使用对象存储服务时,可能会遇到Bucket失效的情况,从而导致服务无法正常运行。为了解决这个问题,我们需要重新配置一个新的Bucket,并更新相关配置文件。参考教程:Java利用阿里云OSS/本地存储实现文件上传功能

1. 注册阿里云OSS账号

首先,访问阿里云-对象存储OSS官网注册账号。新用户可免费试用20GB存储空间,有效期为3个月。

在这里插入图片描述

2. 获取关键信息

注册完成后,获取以下四个关键信息:

  1. Endpoint:OSS服务的访问地址。
  2. Access Key ID:用于身份验证的访问密钥ID。
  3. Access Key Secret:用于身份验证的访问密钥。
  4. Bucket Name:新创建的Bucket名称。

在这里插入图片描述

3. 更新配置文件

将上述获取的信息填写到对应的YAML配置文件sky-server/src/main/resources/application-dev.yml目录下

sky:datasource:driver-class-name: com.mysql.cj.jdbc.Driverhost: localhostport: 3306database: sky_take_outusername: your_usernamepassword: your_passwordalioss:endpoint: your_endpointaccess-key-id: your_accessKeyIdaccess-key-secret: your_keySecretbucket-name: your_bucketName#    endpoint: oss-cn-hangzhou.aliyuncs.com
#    access-key-id: LTAI5tPeFLzsPPT8gG3LPW64
#    access-key-secret: U6k1brOZ8gaOIXv3nXbulGTUzy6Pd7
#    bucket-name: sky-take-out

4, 重新运行服务

保存配置文件后,重新运行服务并打开前端页面,发现图片能够正常上传了!

在这里插入图片描述
并且我们可以在自己的对象存储OSS文件管理中监控到从前端页面上传的图片文件

在这里插入图片描述


十、SpringBoot配置类详解

在 Spring Boot 项目中,配置文件是管理应用程序行为的关键部分。通过合理使用配置类,我们可以轻松实现多环境配置、自定义配置以及配置的动态注入。

1. 生产环境与开发环境配置

Spring Boot 支持多环境配置,通常我们会为不同环境(如开发、测试、生产)创建不同的配置文件。通过 spring.profiles.active 属性,可以动态切换环境。

1.1 配置文件命名规则

  • 默认配置文件application.yaml(或 application.properties)。
  • 环境特定配置文件application-{profile}.yaml,其中 {profile} 是环境标识,如 devprod

1.2 激活环境配置

application.yaml 中,通过 spring.profiles.active 指定激活的环境:

spring:profiles:active: dev  # 激活开发环境
  • dev 的含义:表示加载 application-dev.yaml 文件。
  • prod 的含义:表示加载 application-prod.yaml 文件。

1.3 占位符替换

在配置文件中,可以使用 ${} 占位符引用其他配置项的值。Spring Boot 会在启动时自动替换这些占位符。

示例
  • application.yaml

    spring:datasource:url: jdbc:mysql://${sky.datasource.host}:${sky.datasource.port}/${sky.datasource.database}
    
  • application-dev.yaml

    sky:datasource:host: localhostport: 3306database: devdb
    
  • 最终替换结果

    spring:datasource:url: jdbc:mysql://localhost:3306/devdb
    

2. Spring 前缀与自定义前缀配置

Spring Boot 的配置文件支持两种类型的配置:Spring 内置配置自定义配置

2.1 Spring 内置配置

Spring Boot 使用 spring 作为内置配置的命名空间,用于配置框架本身的行为,例如:

  • 数据源配置spring.datasource
  • Redis 配置spring.redis
  • Profile 激活spring.profiles.active
spring:datasource:url: jdbc:mysql://localhost:3306/mydbusername: rootpassword: rootredis:host: localhostport: 6379

2.2 自定义配置

自定义配置通常用于业务相关的配置项。我们可以使用自定义前缀(如 sky)来组织这些配置。

sky:jwt:admin-secret-key: itcastadmin-ttl: 7200000alioss:endpoint: oss-cn-shenzhen.aliyuncs.comaccess-key-id: LTAI5tRK6gZ9f6CyHCaWh7e8

3. 自定义配置类的注册与使用

Spring Boot 提供了 @ConfigurationProperties 注解,用于将配置文件中的值绑定到 Java 对象中。

3.1 创建配置类

通过 @ConfigurationProperties 注解,指定配置的前缀,并定义与配置项对应的字段。

3.1.1 JWT 配置类
package com.sky.properties;import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;@Component
@ConfigurationProperties(prefix = "sky.jwt")
@Data
public class JwtProperties {private String adminSecretKey;private long adminTtl;private String adminTokenName;
}
3.1.2 阿里云 OSS 配置类
package com.sky.properties;import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;@Component
@ConfigurationProperties(prefix = "sky.alioss")
@Data
public class AliOssProperties {private String endpoint;private String accessKeyId;private String accessKeySecret;private String bucketName;
}

3.2 使用配置类

在其他组件(如 Service、Controller)中,可以通过 @Autowired 注入配置类,直接使用配置值。

3.2.1 在 Service 中使用配置类
package com.sky.service;import com.sky.properties.AliOssProperties;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;@Service
public class OssService {@Autowiredprivate AliOssProperties aliOssProperties;public void printOssConfig() {System.out.println("Endpoint: " + aliOssProperties.getEndpoint());System.out.println("AccessKeyId: " + aliOssProperties.getAccessKeyId());}
}

3.3 配置类的注册

  • @Component:将配置类注册为 Spring 的 Bean。
  • @ConfigurationProperties:指定配置的前缀,并绑定配置项。

十一、SpringBoot注解汇总

1. Spring MVC 相关注解

  1. @RestController
    标记一个类为 RESTful 控制器,返回值直接作为响应体(通常是 JSON 格式),它结合了 @Controller@ResponseBody 的功能,适用于开发 RESTful API。

  2. @RequestMapping
    映射 HTTP 请求到控制器方法,可以指定请求路径、请求方法(如 GET、POST)等。

  3. @PostMapping
    专门处理 HTTP POST 请求,是 @RequestMapping(method = RequestMethod.POST) 的简写。

  4. @GetMapping
    专门处理 HTTP GET 请求,是 @RequestMapping(method = RequestMethod.GET) 的简写。

  5. @DeleteMapping
    专门处理 HTTP DELETE 请求,是 @RequestMapping(method = RequestMethod.DELETE) 的简写。

  6. @PutMapping
    专门处理 HTTP PUT 请求,是 @RequestMapping(method = RequestMethod.PUT) 的简写。

  7. @RequestBody
    将 HTTP 请求体(通常是 JSON 格式)绑定到方法参数,适用于接收客户端传递的复杂数据。

  8. @ResponseBody
    将方法的返回值直接作为 HTTP 响应体(通常是 JSON 格式),而不是跳转到视图页面。

  9. @PathVariable
    将 URL 路径中的变量绑定到方法参数,适用于 RESTful 风格的 URL。

2. Swagger 相关注解

  1. @Api
    标记一个类为 Swagger 资源,用于生成 API 文档。

  2. @ApiModel
    描述 Swagger 模型类,通常用于实体类,生成文档中的模型信息。

  3. @ApiModelProperty
    描述 Swagger 模型类的属性,用于生成文档中属性的详细信息。

  4. @ApiOperation
    描述 API 接口的操作,用于生成文档中接口的详细信息。

3. Spring 核心注解

  1. @Autowired
    自动注入 Spring Bean,用于依赖注入。

  2. @Bean
    声明一个方法返回的对象为 Spring Bean,通常用于配置类中。

  3. @Configuration
    标记一个类为配置类,用于定义 Bean 或其他配置。

  4. @Service
    标记一个类为服务层组件,通常用于业务逻辑层。

  5. @Component
    标记一个类为 Spring 组件,泛指任何 Spring 管理的 Bean。

  6. @SpringBootApplication
    标记主启动类,包含 @Configuration@EnableAutoConfiguration@ComponentScan,用于启动 Spring Boot 应用。

  7. @EnableTransactionManagement
    启用 Spring 的事务管理,通常用于配置类中。

4. AOP 相关注解

  1. @Aspect
    标记一个类为切面,用于定义横切关注点(如日志、事务)。

  2. @Before
    在目标方法执行前执行切面逻辑。

  3. @Pointcut
    定义切点表达式,用于指定哪些方法需要被切面处理。

5. Lombok 相关注解

  1. @Slf4j
    自动生成日志对象 log,简化日志记录代码。

  2. @Data
    自动生成 gettersettertoStringequalshashCode 等方法。

  3. @Builder
    为类生成 Builder 模式支持,简化对象的创建。

  4. @NoArgsConstructor
    生成无参构造方法。

  5. @AllArgsConstructor
    生成全参构造方法。

6. MyBatis 相关注解

  1. @Mapper
    标记一个接口为 MyBatis 的 Mapper 接口,用于定义数据库操作。

  2. @Delete
    映射 SQL 删除操作。

  3. @Select
    映射 SQL 查询操作。

  4. @Insert
    映射 SQL 插入操作。

  5. @AutoFill
    自定义注解,用于自动填充字段(如创建时间、更新时间)。

7. 配置相关注解

  1. @ConfigurationProperties
    将配置文件中的值绑定到 Java 对象中,通常用于加载自定义配置,其中 prefix:指定配置项的前缀,从配置文件中加载特定部分的配置。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/897541.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

大数据hadoop课程笔记

1.课程导入 柯洁 Alpha Go是人工智能领域的里程碑。 深度学习 大模型deepseek chatgpt 大模型 和 大数据 之间有着非常紧密的关系。可以说&#xff0c;大数据是大模型发展的基石&#xff0c;而大模型是大数据价值挖掘的重要工具。 https://youtu.be/nN-VacxHUH8?sifj7Ltk…

架构学习第八周--Kubernetes博客搭建

目录 一、整体架构 二、部署MySQL主从 三、部署Redis哨兵 四、部署WordPress 五、注意事项 一、整体架构 本项目为在一主三从的Kubernetes集群上部署WordPress博客。因为WordPress部分容器版本自行集成Apache和PHP服务&#xff0c;因此在Kubernetes上部署WordPress只需提供…

网络安全之tcpdump工具

引言 wireshark是一款非常不错的抓包软件&#xff0c;在图形化界面占绝对统治地位&#xff1b;尽管其在字符界面下有些许选项可供使用&#xff0c;但终究不太方便&#xff0c;下面我再介绍一款NB的终端抓包工具 tcpdump 1、混杂模式 linux的网卡有混杂模式一说&#xff0c;当开…

electron+vue+webview内嵌网页并注入js

vue内嵌网页可以使用iframe实现内嵌网页&#xff0c;但是只能通过postMessage间接通信&#xff0c;在electron环境下&#xff0c;vue可以直接使用webview来内嵌网页&#xff0c;支持 executeJavaScript、postMessage、send 等丰富的通信机制。 使用 webview的优势 性能更佳&…

leetcode日记(95)将有序数组转换为二叉搜索树

很简单&#xff0c;感觉自己越来越适应数据结构题目了…… /*** Definition for a binary tree node.* struct TreeNode {* int val;* TreeNode *left;* TreeNode *right;* TreeNode() : val(0), left(nullptr), right(nullptr) {}* TreeNode(int x) : va…

【threejs实战教程一】初识Three.js,场景Scene、相机Camera、渲染器Renderer

Three.js是一个基于WebGL的JavaScript 3D图形库&#xff0c;用于在浏览器中创建和显示3D内容 Three.js中最基础的三个关键要素就是场景Scene、相机Camera、渲染器Renderer 通俗一点理解&#xff0c;场景就是我们生活中一个具体的场景&#xff0c;比如自然环境中的一栋建筑&…

木马查杀之AST初识篇

一、AST 定义 抽象语法树&#xff08;Abstract Syntax Tree&#xff0c;AST&#xff09;是源代码的一种抽象表示形式。它以树状结构描述源代码的语法构成&#xff0c;树上的每个节点都对应源代码中的一个语法结构或元素&#xff0c;像变量声明、函数调用、表达式等。通过这种结…

vscode接入DeepSeek 免费送2000 万 Tokens 解决DeepSeek无法充值问题

1. 在vscode中安装插件 Cline 2.打开硅基流动官网 3. 注册并登陆&#xff0c;邀请码 WpcqcXMs 4.登录后新建秘钥 5. 在vscode中配置cline (1) API Provider 选择 OpenAI Compatible &#xff1b; (2) Base URL设置为 https://api.siliconflow.cn](https://api.siliconfl…

如何在保持安全/合规的同时更快地构建应用程序:DevOps 指南

随着敏捷思维方式的兴起&#xff0c;开发和 DevOps 团队都面临着持续的压力&#xff0c;他们需要以迭代方式缩短发布周期并加快部署速度&#xff0c;以满足不断增长的客户期望。随着这种对速度的追求越来越强烈&#xff0c;维护安全性和合规性标准的复杂性也随之增加。 当今 D…

Java中常见的PO、VO、DAO、BO、DO、DTO、POJO、Query类解释(通俗易懂)

文章目录 先点击收藏和点赞,切勿白嫖,感谢一丶PO(persistant object)持久对象二丶VO(value object)值对象三丶DAO(Data Access Objects) 数据访问对象接口四丶BO/DO(Business Object) 业务对象层五丶DTO(Data Transfer Object) 数据传输对象六丶POJO(Plain Old Java Objects) 简…

MySQL安装及基础操作

以下是基于MySQL 8.4.3版本&#xff08;在Win11上&#xff09;的安装&#xff1a; 1.mysql的获取 官网&#xff1a;www.mysql.com 也可以从Oracle官方进入&#xff1a;https://www.oracle.com/ 下载地址&#xff1a;https://downloads.mysql.com/archives/community/ 两者…

虚拟机新挂载磁盘后磁盘无法使用ssh问题 Permission denied (publickey).

在给vmware虚拟机挂载磁盘后再新磁盘目录里面使用ssh拉取代码一直报错: Permission denied (publickey). fatal: Could not read from remote repository. Please make sure you have the correct access rights and the repository exists. manifests: 虚拟机可以添加硬盘,…

每天五分钟深度学习框架PyTorch:ResNet算法模型完成CAFIR十分类

本文重点 ResNet模型已经搭建完成了&#xff0c;本文我们使用ResNet来跑一下CAFIR10的数据集&#xff0c;看一下分类效果如何&#xff1f; 代码 本文总结 在之前的课程中我们对残差块以及ResNet模型进行了详细的介绍&#xff0c;并且我们对模型训练这些基础的数据集进行了详…

1.3 双指针专题:快乐数(medium)

1.题目链接 202. 快乐数 - 力扣&#xff08;LeetCode&#xff09;https://leetcode.cn/problems/happy-number/submissions/609206400/ 2.题目描述 编写⼀个算法来判断⼀个数 n 是不是快乐数。 「快乐数」 定义为&#xff1a; 对于⼀个正整数&#xff0c;每⼀次将该数替换…

STM32 HAL库 CAN过滤器配置

之前在STM32 f407 CAN收发 基于HAL库和Cubemx配置_stm32f407can收发程序-CSDN博客这篇博文里写了一下配置CAN收发的方法&#xff0c;当时由于并没有使用过滤器的现实需求&#xff0c;所以就也没仔细研究。现在工作中确实需要用到过滤器了&#xff0c;有些项目中控制器和发动机E…

飞搭系列|数据迁移功能全新升级,助力用户实现高效无缝迁移!

前言 飞搭低代码平台&#xff08;FeiDa&#xff0c;以下简称“飞搭”&#xff09;&#xff0c;为企业提供在线化、灵活的业务应用构建工具&#xff0c;支持高低代码融合&#xff0c;助力企业低门槛、高效率和低成本地快速应对市场变化&#xff0c;加速复杂业务场景落地。 在之…

【RabbitMQ】事务

事务的简单配置及使用 配置事务管理器声明队列生产者代码测试 RabbitMQ是基于AMQP协议实现的&#xff0c;该协议实现了事务机制&#xff0c;因此RabbitMQ也支持事务机制. SpringAMQP也提供了对事务相关的操作.RabbitMQ事务允许开发者确保消息的发送和接收是原子性的&#xff0c…

【A2DP】蓝牙A2DP协议剖析:从架构到规范

目录 一、A2DP 协议架构 1.1 A2DP 协议栈结构组成 1.2 协议栈各部分的关系与作用 二、设备配置与角色定义&#xff08;Configurations and roles &#xff09; 2.1 角色定义 2.2 配置示例与角色体现 三、用户需求与场景 3.1 用户需求与场景 3.2 协议限制 3.3 协议要求…

27. Harmonyos Next仿uv-ui 组件NumberBox 步进器组件禁用状态

温馨提示&#xff1a;本篇博客的详细代码已发布到 git : https://gitcode.com/nutpi/HarmonyosNext 可以下载运行哦&#xff01; 文章目录 1. 组件介绍2. 效果展示3. 禁用状态设置3.1 整体禁用3.2 输入框禁用3.3 长按禁用 4. 完整示例代码5. 知识点讲解5.1 禁用状态属性5.2 禁用…

Shardingsphere-jdbc 自定义脱敏规则

添加邮件脱敏规则&#xff1a; // 123123123qq.com&#xff0c;将前4个字符脱敏 12312****qq.com 代码重写MaskAlgorithm相关方法&#xff1a; /** Licensed to the Apache Software Foundation (ASF) under one or more* contributor license agreements. See the NOTICE…