Spring Boot基础

news/2024/10/9 8:32:33/

项目创建

项目启动

请求响应

RestController

1.返回值处理

@RestController:这个注解结合了@Controller和@ResponseBody的功能。它默认将所有处理请求的方法的返回值直接作为响应体内容返回,主要用于构建RESTful API。返回的数据格式通常是JSON或XML,这取决于请求中的Accept头部或配置的消息转换器。
Controller:这个注解的返回值通常会经过视图解析器解析,然后返回给用户一个渲染后的HTML页面。如果需要在Controller中返回JSON或XML数据,需要在方法上额外添加@ResponseBody注解。
2. 用途和场景

@RestController:主要用于构建RESTful Web服务,它简化了开发RESTful风格的控制器的代码,使得开发者能够更加专注于业务逻辑的实现,而无需关注底层的请求-响应处理细节。它支持get、post、put、delete等HTTP方法,适用于前后端分离的架构。
@Controller:更多地与视图渲染和页面跳转相关,适用于传统的MVC(Model-View-Controller)架构。通过页面模板引擎(如JSP、Thymeleaf等)将数据渲染成HTML页面返回给用户。
 

创建 HelloController.java

java">package org.example.myspringboot;import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;// @RequestMapping("/api")
@RestController
public class HelloController {@RequestMapping("/hello")public String hello() {return "hello";}
}

请求 http://127.0.0.1:8080/hello 访问接口

增加 @RequestMapping("/api") 访问变成:http://127.0.0.1:8080/api/hello

RequestMapping

参数:

  • value 路由 默认 /
  • method 请求方式:默认GET
    RequestMethod.GET,RequestMethod.POST, RequestMethod.PUT, RequestMethod.DELETE
    java">    @RequestMapping(value = "/hello", method = RequestMethod.DELETE)
    

RequestParam

 @RequestParam注解用于将HTTP请求中的参数绑定到方法的参数上

参数:

  • value 获取的字段名
  • required 字段值是否为必须,false为非必须
  • defaultValue 字段默认值

例如url: http://127.0.0.1:8080/api/hello?name=xx ,获取name的值

java">package org.example.myspringboot;import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;@RequestMapping("/api")
@RestController
public class HelloController {@RequestMapping(value = "/hello", method = RequestMethod.GET)public String hello(@RequestParam(value = "name", required = false, defaultValue = "Alex") String name) {System.out.println(name);return "hello";}
}

处理多个参数

http://127.0.0.1:8080/api/hello?name=xx&age=18

java">package org.example.myspringboot;import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;@RequestMapping("/api")
@RestController
public class HelloController {@RequestMapping(value = "/hello", method = RequestMethod.GET)public String hello(@RequestParam(value = "name") String name,@RequestParam(value = "age") Integer age) {System.out.println(name + " " + age);return "hello";}
}

使用Map处理多个参数

java">package org.example.myspringboot;import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;import java.util.Map;@RequestMapping("/api")
@RestController
public class HelloController {@RequestMapping(value = "/hello", method = RequestMethod.GET)public String hello(Map<String, String> params) {String name = params.get("name");String age = params.get("age");System.out.println(name + " " + age);return "hello";}
}

使用List处理多个相同参数

http://127.0.0.1:8080/api/hello?name=xx&name=yy

java">package org.example.myspringboot;import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;import java.util.List;
import java.util.Map;@RequestMapping("/api")
@RestController
public class HelloController {@RequestMapping(value = "/hello", method = RequestMethod.GET)public String hello(@RequestParam List<String> name) {System.out.println(name);return "hello";}
}

PathVariable

@PathVariable注解获取url中的参数

http://127.0.0.1:8080/api/hello/100/Alex

java">package org.example.myspringboot;import org.springframework.web.bind.annotation.*;import java.util.List;
import java.util.Map;@RequestMapping("/api")
@RestController
public class HelloController {@RequestMapping(value = "/hello/{id}/{name}", method = RequestMethod.GET)public String hello(@PathVariable String id, @PathVariable String name) {System.out.println(id);System.out.println(name);return "hello";}
}

RequestBody

@RequestBody注解:将JSON数据映射到形参的实体类对象中(JSON中的key和实体类中的属性名保持一致)

java">package org.example.myspringboot;import org.springframework.web.bind.annotation.*;@RestController
public class DataController {public static class Address{public String street;public String city;//        public Address() {} // 添加无参构造函数}public static class User{public Integer id;public String name;public Integer age;public Address address;//        public User() {}  // 添加无参构造函数}@RequestMapping(value = "user/{id}", method = {RequestMethod.POST, RequestMethod.GET})public String data(@RequestBody User user, @PathVariable Integer id){System.out.println(user.name);return "Hello World";}
}

 

@RequestBody User user 可以将 请求体中json数据映射到 User中

上传文件

java">package org.example.myspringboot;import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;import java.awt.*;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;@RestController
public class FilesController {private static final String UPLOAD_PATH = "uploads" ;@RequestMapping(value = "file", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)public String files(@RequestParam("file") MultipartFile file) {try {Path uploadPath = Paths.get(UPLOAD_PATH);// 路径是否存在,不存在创建if (!Files.exists(uploadPath)) {Files.createDirectories(uploadPath);}String fileName = file.getOriginalFilename();// 保存文件Files.copy(file.getInputStream(), uploadPath.resolve(fileName));return UPLOAD_PATH + "/" + fileName;} catch (IOException e) {e.printStackTrace();}return "上传失败";}
}
private static final String UPLOAD_PATH = "uploads";

UPLOAD_DIR 是一个静态常量,其值为 "uploads"。这个变量用来指示文件上传的目标目录。让我们详细解释一下这段代码及其各个部分的意义:

常量定义

  • private: 这个关键字表示这个变量只能在定义它的类内部被访问。这是封装的一个体现,有助于保护数据不被外部直接修改。
  • static: 表示这是一个静态变量,即它是属于类的而不是实例的。这意味着所有该类的实例都将共享同一个UPLOAD_DIR的值。
  • final: 这个关键字表示这个变量是最终的,不可改变的。一旦赋值,就不能再重新赋值。在这个场景中,我们希望上传目录的路径是一次性设定好的,并且在整个应用程序运行期间保持不变。

作用

  1. 路径确定性: 使用常量可以确保上传目录的路径在应用启动时就被确定下来,这样每次上传操作都能知道文件应该保存在哪里。
  2. 可维护性: 如果将来需要更改上传目录,只需要修改这一个地方即可,不需要在整个应用中搜索并替换所有的路径字符串。
  3. 易读性和易理解: 声明为常量使得其他开发人员更容易理解这个字符串是用来做什么的,同时也使得代码更加清晰和易于维护。

使用final关键字有几个好处:

  1. 不可变性: 它保证了一旦给定一个值之后,这个值就不会被改变。这对于配置信息特别有用,因为配置项通常是固定的,在程序运行期间不应该改变。
  2. 线程安全性: 在多线程环境下,final变量提供了天然的可见性保证,因为它们在初始化后不会被修改,所有线程看到的都是相同的值。
  3. 性能优化: 编译器和JVM能够对final字段进行一些优化,因为它们知道这些字段的值不会改变。
consumes = MediaType.MULTIPART_FORM_DATA_VALUE

consumes属性的作用

consumes属性用于指定该方法能够消费(接受)哪种类型的HTTP请求体内容。这里MediaType.MULTIPART_FORM_DATA_VALUE指定了该方法期望接收的数据类型为multipart/form-data,这是一种常见的用于上传文件的媒体类型。

  • 指定支持的媒体类型consumes属性告诉Spring MVC框架,只有当请求的内容类型(Content-Type)与consumes指定的媒体类型匹配时,才会调用该方法来处理请求。
  • 消息转换器:Spring MVC使用消息转换器(Message Converters)来读取和写入请求/响应体。对于multipart/form-data类型的数据,Spring默认使用CommonsMultipartResolver或者StandardServletMultipartResolver来解析这类请求。
  • 自动绑定:当consumes指定为MediaType.MULTIPART_FORM_DATA_VALUE时,Spring可以自动将请求体中的数据绑定到方法参数上。例如,@RequestParam用于获取普通表单字段的值,而@RequestParam("file") MultipartFile则用于接收上传的文件
MultipartFile file

MultipartFile是一个特殊的类型,它扩展了Part接口,并且专门用于处理上传的文件。MultipartFile提供了访问上传文件的方法,如获取文件名、文件类型、读取文件内容等。

@RequestParam("file") MultipartFile file这一行代码的意思是:

  • @RequestParam("file"):这表明HTTP请求中必须包含一个名为"file"的参数。这个参数通常是由HTML表单中的<input type="file" name="file">标签发送过来的。
  • MultipartFile file:这个参数类型表明这个方法期望接收到的是一个上传的文件。Spring MVC会将"file"参数对应的文件内容封装成一个MultipartFile对象,并传递给这个方法参数。

下载文件

java">package org.example.myspringboot;import org.springframework.core.io.InputStreamResource;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.http.HttpHeaders;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;@RestController
public class FilesController {private static final String UPLOAD_PATH = "/Users/apple/Downloads";@GetMapping("file/{fileName}/download")public ResponseEntity<InputStreamResource> downloadFile(@PathVariable String fileName) throws IOException {Path path = Paths.get(UPLOAD_PATH + "/" + fileName);if (!Files.exists(path)) {return ResponseEntity.notFound().build();}File file = new File(String.valueOf(path));InputStreamResource resource = new InputStreamResource(new FileInputStream(file));HttpHeaders headers = new HttpHeaders();headers.add(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + file.getName() + "\"");headers.add(HttpHeaders.CONTENT_TYPE, "application/octet-stream");return ResponseEntity.ok().headers(headers).body(resource);}@RequestMapping("file/{fileName}/preview")public ResponseEntity<Resource> previewFile(@PathVariable String fileName) throws IOException {Path path = Paths.get(UPLOAD_PATH + "/" + fileName);Resource imageFile = new UrlResource(path.toUri());if (!imageFile.exists() && !imageFile.isReadable()) {return ResponseEntity.notFound().build();}String contentType = Files.probeContentType(path);if (contentType == null) {return ResponseEntity.notFound().build();}HttpHeaders headers = new HttpHeaders();headers.setContentType(MediaType.parseMediaType(contentType));return ResponseEntity.ok().headers(headers).body(imageFile);}
}

返回静态页面

java">package org.example.myspringboot;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;@Controller
public class IndexController {@RequestMappingpublic String index() {return "/index.html";}
}

ResponseBody

@responseBody注解的作用是将controller的方法返回的对象通过适当的转换器转换为指定的格式之后,写入到response对象的body区,通常用来返回JSON数据或者是XML数据

ResponseEntity

ResponseEntity可以更灵活地处理HTTP响应,而不仅仅局限于返回简单的数据类型

返回string

java">    @RequestMapping(value = "user", method = {RequestMethod.POST, RequestMethod.GET})public ResponseEntity<String> data(){System.out.println(user.name);return ResponseEntity.ok().header("Content-Type", "application/json").body("提交成功");}

返回自定义类型

java">package org.example.myspringboot;import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;@RestController
public class DataController {public static class Address{public String street;public String city;}public static class User{public Integer id;public String name;public Integer age;public Address address;}@RequestMapping(value = "user/{id}", method = {RequestMethod.POST, RequestMethod.GET})public ResponseEntity<User> data(@RequestBody User user, @PathVariable Integer id){System.out.println(user.name);return ResponseEntity.ok().header("Content-Type", "application/json").body(user);}
}

设置响应状态码

java">    @RequestMapping(value = "user", method = {RequestMethod.POST, RequestMethod.GET})public ResponseEntity<String> data(){System.out.println(user.name);return ResponseEntity.status(HttpStatus.NOT_FOUND).header("Content-Type", "application/json").body("未来找到数据");}

参考

Java Spring Boot 全面教程_java springboot-CSDN博客


http://www.ppmy.cn/news/1527131.html

相关文章

ccfcsp-202112-1、序列查询

202112-1 序列查询 #include <bits/stdc.h> using namespace std; int main(){int n, N;cin >> n >> N;vector<int> A(n 1,0);vector<int> fa(N 1,0);for(int i 1; i < n; i){cin >> A[i];}int j 1;int sum 0;for(int i 1; i &l…

sqlguna靶场get shell

一、打开靶场&#xff0c;发现一个搜索框&#xff0c;尝试sql注入&#xff0c;发现可以注入&#xff0c;爆破数据库&#xff0c;表名&#xff0c;字段名以及 用户名密码 二、发现密码被MD5&#xff0c;解密后得到密码 三、进入后台界面登陆查看 四、发现添加新闻出可以上传图片…

STL相关简介

string 看到这个词&#xff0c;相信大家一定都很好奇什么是string&#xff0c;它有什么作用呢&#xff1f;今天&#xff0c;就让我们一起来了解一下关于string的简介吧~ 目录 string 1. 什么是STL 2. STL的版本 3. STL的六大组件 4. STL的重要性 5. 如何学习STL 6.STL的…

[VMware]ESXI下硬盘的直通方式

ESXI6.7下直通硬盘给群晖步骤&#xff0c;RDM直通方式&#xff01; 参考文章&#xff1a;https://rmbz.net/archives/vmware-esxi-passthrough 1.进入ESXI6.7 web管理后台。开启SSH 2.点击存储&#xff0c;选择默认存储(ESXI安装硬盘)。复制位置地址备用&#xff1b; 3.打开SSH…

构建基于图数据库的问答应用:你的全面指南

构建基于图数据库的问答应用&#xff1a;你的全面指南 在这篇文章中&#xff0c;我们将探讨如何在图数据库上创建一个问答链。这种系统能够根据图数据库中的数据回答自然语言问题。 ⚠️ 安全提示 ⚠️ 在图数据库上构建问答系统需要执行模型生成的图查询。这本质上存在一定的…

[数据集][目标检测]疟疾恶性疟原虫物种目标检测数据集VOC+YOLO格式948张1类别

数据集格式&#xff1a;Pascal VOC格式YOLO格式(不包含分割路径的txt文件&#xff0c;仅仅包含jpg图片以及对应的VOC格式xml文件和yolo格式txt文件) 图片数量(jpg文件个数)&#xff1a;948 标注数量(xml文件个数)&#xff1a;948 标注数量(txt文件个数)&#xff1a;948 标注类别…

虚拟机centos_7 配置教程(镜像源、配置centos、静态ip地址、Finalshell远程操控使用)

文章目录 一、下载镜像源&#xff08;准备工作&#xff09;1、开源网站2、下载 二、VMware配置centos三、配置静态IP地址四、Finalshell使用1、下载Finalshell2、连接虚拟机 五、谢谢观看&#xff01; 一、下载镜像源&#xff08;准备工作&#xff09; 1、开源网站 有许多开源…

SpringCloud-04 OpenFeign服务调用与负载均衡

OpenFeign是一个声明式、模板化的HTTP客户端&#xff0c;它简化了在Java应用程序中调用RESTful API的过程。OpenFeign是Netflix开发的一个开源项目&#xff0c;它构建在Feign的基础上&#xff0c;为开发者提供了更加简单、灵活的方式来实现HTTP请求。OpenFeign的特点包括&#…