在现代Web开发中，富文本编辑器是一个至关重要的组件，尤其是在需要输入丰富文本内容的场景中，例如博客、新闻发布系统等。在Spring Boot项目中集成富文本编辑器（如CKEditor、TinyMCE等）可以极大地方便用户输入和编辑内容。本文将以CKEditor为例，讲解如何在Spring Boot项目中添加富文本编辑器。
创建Spring Boot项目
首先，我们使用Spring Initializr创建一个新的Spring Boot项目，添加所需的依赖。其中包括Spring Web和Spring Data JPA等基本依赖。项目结构大致如下：
/my-spring-boot-app
├── src
│ ├── main
│ │ ├── java
│ │ │ └── com
│ │ │ └── example
│ │ │ └── myapp
│ │ │ └── MySpringBootAppApplication.java
│ │ └── resources
│ │ ├── static
│ │ ├── templates
│ │ └── application.properties
添加CKEditor
在src/main/resources/static目录下，我们需要添加CKEditor的相关脚本，可以直接从CKEditor的官网（https://ckeditor.com/ckeditor-5/download/）下载最新版本，或者通过CDN引入：
<!-- src/main/resources/templates/editor.html -->
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<script src="https://cdn.ckeditor.com/ckeditor5/34.2.0/classic/ckeditor.js"></script>
<title>富文本编辑器</title>
</head>
<body>
<h1>使用CKEditor的富文本编辑器示例</h1>
<form action="/submit" method="POST">
<textarea name="content" id="editor"></textarea>
<button type="submit">提交</button>
</form>
<script>
ClassicEditor
.create(document.querySelector('#editor'))
.then(editor => {
console.log(editor);
})
.catch(error => {
console.error(error);
});
</script>
</body>
</html>
建立Controller
接下来，我们需要创建一个Controller来处理请求并渲染我们的HTML页面。同时，我们还需要处理表单提交的内容。以下是示例代码：
// src/main/java/com/example/myapp/controller/EditorController.java
package com.example.myapp.controller;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
@Controller
public class EditorController {
@GetMapping("/editor")
public String showEditor(Model model) {
return "editor"; // 返回上面创建的editor.html页面
}
@PostMapping("/submit")
public String handleFormSubmit(String content, Model model) {
// 在这里处理提交的内容，可以保存到数据库或处理其他逻辑
model.addAttribute("content", content);
return "success"; // 返回成功页面
}
}
添加成功页面
为了展示提交成功的内容，我们也需要添加一个成功页面：
<!-- src/main/resources/templates/success.html -->
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<title>提交成功</title>
</head>
<body>
<h1>提交成功</h1>
<div>${content}</div>
<a href="/editor">返回编辑</a>
</body>
</html>
配置应用启动类
最后，我们确保Spring Boot应用的启动类正确配置：
// src/main/java/com/example/myapp/MySpringBootAppApplication.java
package com.example.myapp;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class MySpringBootAppApplication {
public static void main(String[] args) {
SpringApplication.run(MySpringBootAppApplication.class, args);
}
}
运行应用
现在，我们可以启动Spring Boot应用，访问http://localhost:8080/editor，就可以看到并使用CKEditor进行文本输入。提交后将展示成功页面，内容可在页面上显示。
总结
在Spring Boot项目中集成富文本编辑器是一个相对简单的流程。通过上述步骤，我们成功地将CKEditor集成到了Spring Boot应用中，并处理了表单的提交。根据具体需要，我们可以扩展更多功能，例如将编辑内容保存到数据库等。如此一来，用户可以以更友好的方式编辑富文本内容，提高了用户体验。
