使用wangEditor实现富文本编辑(后端为Java)

2024-06-15 01:08

本文主要是介绍使用wangEditor实现富文本编辑(后端为Java),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

  富文本编辑器,Rich Text Editor, 简称 RTE, 是一种可内嵌于浏览器,所见即所得的文本编辑器.
CSDN的markdown编辑器便是一种富文本编辑器.

  蓝莓商城商品详情这一部分的编辑需要使用富文本编辑器.本来想使用百度的ueditor的,但是弄了好久依然还是有问题.所以就放弃了.ueditor配置确实比较复杂,官方的文档也没有很好的说清楚,错误提示不够明了,出错时未提示具体的原因.

  最后找到这个wangEditor.相比ueditor,配置更加简单,使用更加方便.其功能虽不及ueditor多,但是应付一般的需求足够了.
 

流程说明

 由于对于图片上传整个流程比较复杂,所以本文仅对其进行说明.
 图片上传的流程是,当页面选择图片后,将会创建XMLHttpRequest请求,将图片数据发送给服务端,服务端接收后将图片保存到本地,再将图片路径返回给客户端,客户端接收到图片路径后,创建 元素,并将图片路径赋给src,最后再把该元素插入到编辑器中.
 

 // 定义 xhr 发送请求给服务端var xhr = new XMLHttpRequest();xhr.open('POST', uploadImgServer);

客户端配置说明

下载

直接下载:https://github.com/wangfupeng1988/wangEditor/releases
使用npm下载:npm install wangeditor (注意 wangeditor 全部是小写字母)
使用bower下载:bower install wangEditor (前提保证电脑已安装了bower)
使用CDN://unpkg.com/wangeditor/release/wangEditor.min.js

调试阶段推荐使用方式1中的未压缩版本,因为如果出现问题也好调试和查找.
下载后将目录里的wangEditor.js放入工程目录中.只需要这个文件,其他的不需要.
这里写图片描述
我放在webapp下的wangEditor路径下.
这里写图片描述

前端配置

引入js文件
contextPathOfStatic这里是我的项目路径下的static文件夹:http://localhost:8080/lanmei-os/static

<script type="text/javascript" src="${contextPathOfStatic}/wangEditor/wangEditor.js"></script>

jsp页面添加

<div id="editor"><!-- 默认显示 --><p>欢迎使用 <b>wangEditor</b> 富文本编辑器</p>
</div>

这里我创建3个按钮进行测试

<button id="editorSetBtn">设置内容</button>
<button id="editorGetBtn1">获取内容1</button>
<button id="editorGetBtn2">获取内容2</button>
js文件编写
$(function(){var E = window.wangEditor;//这里的id为<div id="editor"中的id.var editor = new E('#editor');// 配置服务器端地址,也就是controller的请求路径,不带项目路径,前面没有/editor.customConfig.uploadImgServer = 'commodity/upload/editor/img';//配置属性名称,绑定请求的图片数据//controller会用到,可以随便设置,但是一定要与controller一致editor.customConfig.uploadFileName = 'img';//创建编辑器editor.create();$("#editorSetBtn").click(function(){//这是设置编辑器内容editor.txt.html("dsafdfadsfdafdsfds");})$("#editorGetBtn1").click(function(){//获取编辑器的内容,带样式//一般使用这个获取数据,通过ajax发送给服务端 ,然后服务端以String接收,保存到数据库.alert(editor.txt.html());})$("#editorGetBtn2").click(function(){//获取编辑器的内容,不带样式,纯文本alert(editor.txt.text());})
})

程序加载完之后页面就会出现编辑器.
这里写图片描述

客户端设置完成

服务端配置

WEB层创建Controller
@Controller
@RequestMapping(path="/commodity")
public class CommodityController {@AutowiredAddCommodityService   addCommodityService;@Autowired
private static final Logger logger = LoggerFactory.getLogger("CommodityController.class");@ResponseBody@RequestMapping(path="/upload/editor/img")//RequestParam中的属性名称要和前端定义的一致,上面说明了.所以写"img"//使用List<MultipartFile>进行接收//返回的是一个Dto类,后面会说明,使用@ResponseBody会将其转换为Json格式数据public ImgResultDto uploadEditorImg(@RequestParam("img") List<MultipartFile> list) {    //这里是我在web中定义的两个初始化属性,保存目录的绝对路径和相对路径,你们可以自定义    String imgUploadAbsolutePath = request.getServletContext().getInitParameter("imgUploadAbsolutePath");String imgUploadRelativePath = request.getServletContext().getInitParameter("imgUploadRelativePath");//服务曾处理数据,返回DtoImgResultDto imgResult= addCommodityService.upLoadEditorImg(list, imgUploadAbsolutePath, imgUploadRelativePath,1);return imgResult;           }}
服务层创建Service类
服务层创建Service接口类

public interface AddCommodityService {/*** 上传商品图片* @param files*/ImgResultDto upLoadEditorImg(List<MultipartFile> list,String UploadAbsolutePath,String UploadRelativePath,int commodityId);
}
服务层创建Service接口实现类

这里需要注意的是保存地址,我是保存在项目路径下,有的会保存在文件系统根目录下,比如windows可能是D://xxx/xx,linux是/xx/xx,那么返回给客户端的地址就会不一样.需要根据实际情况设置

public class AddCommodityServiceImpl extends BaseService  implements AddCommodityService{@Autowiredprivate CommodityMapper commodityMapper;@AutowiredCommodityImageMapper commodityImageMapper;@Autowiredprivate DruidDataSource dataSource; @Autowiredprivate SqlSessionFactoryBean sqlSessionFactory;
/*** 图片上传处理*/@Overridepublic ImgResultDto upLoadEditorImg(List<MultipartFile> list,String UploadAbsolutePath,String UploadRelativePath,int commodityId) {//获取当前登录的管理员//CmsAdmin admin = (CmsAdmin) SessionUtils.getSession("currenLogintAdmin");CmsAdmin admin = new CmsAdmin("测试用户");//工程绝对路径String imgUploadAbsolutePath = UploadAbsolutePath;//工程相对路径String imgUploadRelativePath = UploadRelativePath;logger.debug("files.length = " + list.size() );ImgResultDto imgResultDto = new ImgResultDto();//这里定String[] urlData = new String[5];int index = 0;try {for(MultipartFile img : list) {//获取原始文件名,比如你上传的是 图片.jpg,则fileName=图片.jpgString fileName = img.getOriginalFilename();if(fileName == "") {continue;}logger.debug("file  name = " + fileName);String finalPath = imgUploadAbsolutePath + imgUploadRelativePath;  //绝对路径 + 相对路径//为了保证文件名不一致,因此文件名称使用当前的时间戳和4位的随机数,还有原始文件名组成//觉得实际的企业开发不应当使用原始文件名,否则上传者使用一些不好的名字,对于下载者就不好了.//这里为了调试方便,可以加上.String finalFileName =  (new Date().getTime()) + Math.round(Math.random() * 1000)  //文件名动态部分+ fileName; //文件名 原始文件名        File newfile = new File( finalPath + finalFileName);logger.debug("创建文件夹 = " + newfile.mkdirs() +  "  path = " + newfile.getPath());logger.debug("" + newfile.getAbsolutePath());//保存文件到本地img.transferTo(newfile);logger.debug("上传图片成功");//持久化到数据库CommodityImage commodityImage = new  CommodityImage(commodityId, imgUploadRelativePath,finalFileName,(byte)(0),admin.getLoginJobnum(), new Date());commodityImageMapper.insert(commodityImage);logger.debug("数据库写入图片成功");  //这里的路径是项目路径+文件路径+文件名称//这么写不是规范的做法,项目路径应是放在前端处理,只需要发送相对路径和文件名称即可,项目路径由前端加上.urlData[index++] = "http://localhost:8080/lanmei-cms/"+imgUploadRelativePath + finalFileName;logger.debug("index = " + index + "  url = " + urlData[0]);//设置异常代号imgResultDto.setErrno(0);}imgResultDto.setData(urlData);//返回Dtoreturn imgResultDto;} catch (Exception e) {// TODO: handle exceptione.printStackTrace();return imgResultDto;}}}
Dto编写

Dto 只是一个普通的pojo类,没有业务方法,只有属性和构造器,getter and setter.主要用于层间传输数据,更详细的说明自行百度.

public class ImgResultDto<T> {private int  errno;//错误代码private String[] data;//存放数据//构造器//getter and setter
前端接收处理

添加 customInsert: function (insertImg, result, editor)这段程序
result是返回的json数据
因为上面只是上传了一张图片,保存在数组索引0里
因此通过下面获取图片地址.
var url = result.data[0];

    // 上传图片 hook uploadImgHooks: {before: function before(xhr, editor, files) {// 图片上传之前触发// 如果返回的结果是 {prevent: true, msg: 'xxxx'} 则表示用户放弃上传// return {//     prevent: true,//     msg: '放弃上传'// }},success: function success(xhr, editor, result) {// 图片上传并返回结果,图片插入成功之后触发console.log("插入图片成功 success result = " + result.errno + "  path = " + result.data[0] );},fail: function fail(xhr, editor, result) {console.log(" fail result = " + result.errno + "  path = " + result.data[0] );// 图片上传并返回结果,但图片插入错误时触发},error: function error(xhr, editor) {// 图片上传出错时触发console.log("error result = " + result.errno + "  path = " + result.data[0] );},timeout: function timeout(xhr, editor) {// 图片上传超时时触发console.log("timeout result = " + result.errno + "  path = " + result.data );},// 如果服务器端返回的不是 {errno:0, data: [...]} 这种格式,可使用该配置 //--------------添加这段程序------------------customInsert: function (insertImg, result, editor) {// 图片上传并返回结果,自定义插入图片的事件(而不是编辑器自动插入图片!!!)// insertImg 是插入图片的函数,editor 是编辑器对象,result 是服务器端返回的结果// 举例:假如上传图片成功后,服务器端返回的是 {url:'....'} 这种格式,即可这样插入图片://-----------修改这里------------------//获取返回的图片地址var url = result.data[0];insertImg(url);console.log("插入图片 url = " + url );// result 必须是一个 JSON 格式字符串!!!否则报错}},// 是否上传七牛云,默认为 falseqiniu: false};

完成!!!!!!!!!!!!!!!!!

总结

  本文说明了如何在Java WEB项目中使用富文本编辑器wangEditor,包括前端配置和后端处理.仅说明其简单的用法,业务也未考虑的很周详.更多功能扩展请看官方的说明.
  项目的完整程序请看蓝莓商城项目,后面我会陆续完善.

这篇关于使用wangEditor实现富文本编辑(后端为Java)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1062003

相关文章

Java中流式并行操作parallelStream的原理和使用方法

《Java中流式并行操作parallelStream的原理和使用方法》本文详细介绍了Java中的并行流(parallelStream)的原理、正确使用方法以及在实际业务中的应用案例,并指出在使用并行流... 目录Java中流式并行操作parallelStream0. 问题的产生1. 什么是parallelS

C++中unordered_set哈希集合的实现

《C++中unordered_set哈希集合的实现》std::unordered_set是C++标准库中的无序关联容器,基于哈希表实现,具有元素唯一性和无序性特点,本文就来详细的介绍一下unorder... 目录一、概述二、头文件与命名空间三、常用方法与示例1. 构造与析构2. 迭代器与遍历3. 容量相关4

Linux join命令的使用及说明

《Linuxjoin命令的使用及说明》`join`命令用于在Linux中按字段将两个文件进行连接,类似于SQL的JOIN,它需要两个文件按用于匹配的字段排序,并且第一个文件的换行符必须是LF,`jo... 目录一. 基本语法二. 数据准备三. 指定文件的连接key四.-a输出指定文件的所有行五.-o指定输出

Java中Redisson 的原理深度解析

《Java中Redisson的原理深度解析》Redisson是一个高性能的Redis客户端,它通过将Redis数据结构映射为Java对象和分布式对象,实现了在Java应用中方便地使用Redis,本文... 目录前言一、核心设计理念二、核心架构与通信层1. 基于 Netty 的异步非阻塞通信2. 编解码器三、

Linux jq命令的使用解读

《Linuxjq命令的使用解读》jq是一个强大的命令行工具,用于处理JSON数据,它可以用来查看、过滤、修改、格式化JSON数据,通过使用各种选项和过滤器,可以实现复杂的JSON处理任务... 目录一. 简介二. 选项2.1.2.2-c2.3-r2.4-R三. 字段提取3.1 普通字段3.2 数组字段四.

C++中悬垂引用(Dangling Reference) 的实现

《C++中悬垂引用(DanglingReference)的实现》C++中的悬垂引用指引用绑定的对象被销毁后引用仍存在的情况,会导致访问无效内存,下面就来详细的介绍一下产生的原因以及如何避免,感兴趣... 目录悬垂引用的产生原因1. 引用绑定到局部变量,变量超出作用域后销毁2. 引用绑定到动态分配的对象,对象

Linux kill正在执行的后台任务 kill进程组使用详解

《Linuxkill正在执行的后台任务kill进程组使用详解》文章介绍了两个脚本的功能和区别,以及执行这些脚本时遇到的进程管理问题,通过查看进程树、使用`kill`命令和`lsof`命令,分析了子... 目录零. 用到的命令一. 待执行的脚本二. 执行含子进程的脚本,并kill2.1 进程查看2.2 遇到的

SpringBoot基于注解实现数据库字段回填的完整方案

《SpringBoot基于注解实现数据库字段回填的完整方案》这篇文章主要为大家详细介绍了SpringBoot如何基于注解实现数据库字段回填的相关方法,文中的示例代码讲解详细,感兴趣的小伙伴可以了解... 目录数据库表pom.XMLRelationFieldRelationFieldMapping基础的一些代

一篇文章彻底搞懂macOS如何决定java环境

《一篇文章彻底搞懂macOS如何决定java环境》MacOS作为一个功能强大的操作系统,为开发者提供了丰富的开发工具和框架,下面:本文主要介绍macOS如何决定java环境的相关资料,文中通过代码... 目录方法一:使用 which命令方法二:使用 Java_home工具(Apple 官方推荐)那问题来了,

Java HashMap的底层实现原理深度解析

《JavaHashMap的底层实现原理深度解析》HashMap基于数组+链表+红黑树结构,通过哈希算法和扩容机制优化性能,负载因子与树化阈值平衡效率,是Java开发必备的高效数据结构,本文给大家介绍... 目录一、概述:HashMap的宏观结构二、核心数据结构解析1. 数组(桶数组)2. 链表节点(Node