下面我将为您详细讲解“springboot-controller的使用详解”的完整攻略。

Spring Boot Controller的使用详解

什么是Controller

Controller是Spring Boot中的一个非常重要的组件，它主要负责处理客户端请求并返回响应。在Web应用中，客户端一般是浏览器，在RESTful API中可以是各种各样的客户端。

如何创建一个简单的Controller

创建Controller非常简单，只需要在Spring Boot应用程序中创建一个类并在该类上标注@Controller注解，然后再为该类添加处理请求的方法。

下面是一个非常简单的Controller示例：

@Controller
public class HelloController {

    @RequestMapping("/hello")
    public String hello() {
        return "Hello World!";
    }
}

在上面的代码中，我们定义了一个名为HelloController的Controller，并定义了一个处理名为/hello的请求的方法。该方法返回一个字符串Hello World!。

一些常用的注解

@Controller

@Controller是一个用来定义Controller类的注解。在Spring Boot中，使用@Controller注解的类会被自动扫描并且注册为一个Bean。

@RestController

@RestController是一个用来定义RESTful API控制器类的注解。在Spring Boot中，使用@RestController注解的类会将所有方法返回的对象都转换为JSON格式，并且不会跳转到任何视图页面，这种做法非常适合于处理客户端请求。

@RequestMapping

@RequestMapping注解用来映射一个请求和请求的方法。在Spring Boot中，使用@RequestMapping注解的方法会被处理方法拦截器拦截，并根据注解中定义的URI、请求方法、请求头等条件进行匹配。

下面是一个使用@RequestMapping注解的示例：

@Controller
@RequestMapping("/hello")
public class HelloController {

    @RequestMapping(method = RequestMethod.GET)
    public String hello() {
        return "Hello World!";
    }

    @RequestMapping(value = "/{name}", method = RequestMethod.GET)
    public String hello(@PathVariable String name) {
        return "Hello " + name + "!";
    }
}

在上面的代码中，我们使用@RequestMapping注解定义了处理请求的方法。其中，第一个方法处理GET请求，并返回字符串Hello World!；第二个方法处理GET请求，其中URI为/hello/{name}，在方法参数中使用了@PathVariable注解。

@GetMapping、@PostMapping、@PutMapping、@DeleteMapping

@GetMapping、@PostMapping、@PutMapping、@DeleteMapping这些注解是@RequestMapping注解的缩写形式，它们分别用来定义处理GET、POST、PUT和DELETE请求的方法。

下面是一个使用@GetMapping注解的示例：

@RestController
public class UserController {

    @GetMapping(value = "/users")
    public List<User> getUsers() {
        List<User> users = new ArrayList<>();
        // add some users to list
        return users;
    }
}

在上面的代码中，我们使用@GetMapping注解定义了处理GET请求的方法。该方法返回一个用户列表。

示例说明

示例1：获取用户信息

我们可以使用Spring Boot来创建一个简单的RESTful API，用于获取用户信息。为了实现此功能，我们需要定义一个UserController控制器类，如下所示：

@RestController
@RequestMapping("/users")
public class UserController {

    private List<User> users = Arrays.asList(
            new User(1, "Alice", 20),
            new User(2, "Bob", 22),
            new User(3, "Charlie", 24));

    @GetMapping
    public List<User> getUsers() {
        return users;
    }

    @GetMapping("/{id}")
    public User getUserById(@PathVariable("id") int id) {
        for (User user : users) {
            if (user.getId() == id) {
                return user;
            }
        }
        return null;
    }

    @PostMapping
    public String addUser(@RequestBody User user) {
        // add user to database
        return "ok";
    }

    @PutMapping("/{id}")
    public String updateUser(@PathVariable("id") int id, @RequestBody User newUser) {
        // update user in database
        return "ok";
    }

    @DeleteMapping("/{id}")
    public String deleteUser(@PathVariable("id") int id) {
        // delete user from database
        return "ok";
    }
}

在上面的代码中，我们定义了一个UserController控制器类，并使用@RestController注解将其标注为RESTful API控制器类。我们还使用@RequestMapping注解来定义了处理所有请求的根URI为/users。接下来，我们定义了几个方法用于获取、添加、更新和删除用户信息。所有这些方法都使用各种@RequestMapping注解来定义其URI和HTTP请求方法。例如，@GetMapping注解用于定义返回用户列表信息的方法；@GetMapping注解同时也用于定义根据用户ID返回特定用户信息的方法。同样地，我们使用@PostMapping、@PutMapping、@DeleteMapping注解分别定义添加、更新和删除用户信息的方法。

示例2：文件上传和下载

Spring Boot可以很容易地支持文件上传和下载功能，只需要在Controller中添加MultipartFile和InputStreamResource等类型的参数即可。下面是一个文件上传和下载示例：

@RestController
@RequestMapping("/file")
public class FileController {

    private static final String BASE_DIR = "/path/to/upload/dir";

    @PostMapping("/upload")
    public String uploadFile(@RequestParam("file") MultipartFile file) {
        Path path = Paths.get(BASE_DIR, file.getOriginalFilename());
        try (OutputStream os = new BufferedOutputStream(Files.newOutputStream(path, StandardOpenOption.CREATE))) {
            byte[] bytes = file.getBytes();
            os.write(bytes);
        } catch (IOException e) {
            e.printStackTrace();
            return "failed";
        }
        return "ok";
    }

    @GetMapping("/download")
    public ResponseEntity<InputStreamResource> downloadFile(@RequestParam("file") String filename) throws IOException {
        Path path = Paths.get(BASE_DIR, filename);
        byte[] bytes = Files.readAllBytes(path);
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);
        headers.setContentDispositionFormData("attachment", filename);
        headers.setContentLength(bytes.length);
        InputStreamResource isr = new InputStreamResource(new ByteArrayInputStream(bytes));
        return new ResponseEntity<>(isr, headers, HttpStatus.OK);
    }
}

在上面的代码中，我们定义了一个RestController类，用于处理文件上传和下载请求。在上传文件时，我们使用POST方法并将文件作为MultipartFile类型的参数传递给方法。在方法内部，我们将文件数据写入磁盘文件。在下载文件时，我们使用GET方法并将文件名作为@RequestParam参数传递给方法。在方法内部，我们将文件数据读入内存，并使用ResponseEntity对象将其返回给客户端。 ResponseEntity对象是一个Spring Boot提供的用于处理HTTP响应的对象，它包含了响应数据和响应头等信息。