目录
1️⃣JSON
一、什么是json?
二、与javascript的关系
三、语法格式
四、注意事项
五、总结
六,使用json
1导入pom.xml依赖
2.配置spring-mvc.xml
3. @ResponseBody注解使用
创建一个web层控制器
编写ClazzBiz
实现接口
测试:
2.异常处理机制
1.为什么要全局异常处理?
2.异常处理思路
3.SpringMVC异常分类
4.异常处理方法
方法一
方法二
方法三
1️⃣JSON
一、什么是json?
json的全称为:JavaScript Object Notation,是一种轻量级的数据交互格式。它基于 ECMAScript (欧洲计算机协会制定的js规范)的一个子集,采用完全独立于编程语言的文本格式来存储和表示数据。【以上来自于百度百科】
简单来说:json就是一种在各个编程语言中流通的数据格式,负责不同编程语言中的数据传递和交互。
类似于:
- 国际通用语言-英语
- 中国56个民族不同地区的通用语言-普通话。
但真要说json到底是什么,以及json的作用,我们总是难以描述,下面我将从各个方面来进行说明:
二、与javascript的关系
相信很多程序员只要一提到json总会想到js,因为json不仅含有js的名字,其格式也与js中对象(object)的格式并无一二。
这里我们要进行一个说明,首先json是基于ECMAScript语法,但这并不意味着json必须在js中使用,或者必须要产生什么联系,json在js中的处理也并没有比其他语言占有更多优势。只是因为语法相似,而使得js开发者能更快的上手json而已。
事实上几乎所有编程语言中都有对json数据转换的支持:
js中,json与对象的转换:JSON.parse()
/JSON.stringify()
;
php中,json与数组的转换:json_encode()
/json_decode()
;
java中,json与对象的转换:fromJson()
/toJson()
;
python中,json与对象的转换:json.dumps()
/json.loads()
;
三、语法格式
那么json的语法格式到底是怎样的呢?我们先来看一段json数据:{"name":"admin","age":18}
这就是一种最简单的json,如果有学过js的开发者是不是发现json的语法与js中object的语法几乎相同。
但是,注意:
- json是一种纯字符数据,不属于编程语言
- json的语法与js中object的语法几乎一致(下一部分说明不同)
- json数据以键值对形式存在,多个键值对之间用逗号
,
隔开,键值对的键和值之间用冒号:
连接 - json数据在js对象的基础上做了严格化
- json数据中的键值对可以使用编程语言中所谓的关键字(*见注意事项)
- json的数据可以用花括号
{}
或中括号[]
包裹,对应js中的object和array
四、注意事项
为什么说几乎相同,而不是完全相同呢?接下来我们要说的就是json与js中对象的不同点,也是json严格要求的部分:
- json的键值对的键部分,必须用双引号
"
包裹,单引号都不行(所以如果在键中出现了关键字,也被字符化了),而js中对象没有强制要求(所以在键中不允许出现关键字) - json的键值对的值部分,不允许出现函数
function
,undefined
,NaN
,但是可以有null
,js中对象的值中可以出现 - json数据结束后,不允许出现没有意义的逗号
,
如:{"name":"admin","age":18,}
,注意看数据结尾部分18的后面的逗号,不允许出现
五、总结
所以,json数据的格式可以是:{"name":"admin","age":18}
也可以是:["hello",3.1415,"json"]
还可以是:[{"name":"admin","age":18},{"name":"root","age":16},{"name":"张三","age":20}]
不能是:(key没有双引号){"name":"admin",age:18}
不能是:(无意义的逗号){"name":"admin","age":18,}
不能是:(不允许出现函数){"name":"admin","age":18,"show":function()()}
不能是:(不允许出现undefined){"name":"admin","age":18,"show":undefined}
不能是:(不允许出现NaN){"name":"admin","age":18,"strong":NaN}
不能是:(无意义的逗号)["hello",3.1415,"json",]
不能是:(无意义的逗号)[{"name":"admin","age":18},{"name":"root","age":16},{"name":"张三","age":20},]
以上内容,希望能对以后使用json有所帮助,简单来说json处理的是
对象{},数值[ ] , 混合 {rows: [ ]}以及 json转换的注解
其实作为通用数据,xml也是一种不错的选择,但是随着json的出现,xml的使用场景正慢慢被json蚕食,相对来说json在某些方面下的体现还是比xml稍具优势,后期可再开一篇文档说明json和xml的区别。
六,使用json
1导入pom.xml依赖
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.9.3</version>
</dependency>
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-core</artifactId><version>2.9.3</version>
</dependency>
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-annotations</artifactId><version>2.9.3</version>
</dependency>
2.配置spring-mvc.xml
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"><property name="messageConverters"><list><ref bean="mappingJackson2HttpMessageConverter"/></list></property></bean><bean id="mappingJackson2HttpMessageConverter"class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"><!--处理中文乱码以及避免IE执行AJAX时,返回JSON出现下载文件--><property name="supportedMediaTypes"><list><value>text/html;charset=UTF-8</value><value>text/json;charset=UTF-8</value><value>application/json;charset=UTF-8</value></list></property></bean>
3. @ResponseBody注解使用
@ResponseBody
注解的作用是将Controller的方法返回的对象通过适当的转换器转换为指定的格式之后,写入到response对象的body区,通常用来返回JSON
数据或者是XML数据。注意:在使用此注解之后不会再走视图解析器,而是直接将数据写入到输入流中,他的效果等同于通过response对象输出指定格式的数据。
创建一个web层控制器
package com.xzs.web;import com.xzs.Biz.ClazzBiz;
import com.xzs.model.Clazz;
import com.xzs.utils.PageBean;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;import javax.servlet.http.HttpServletRequest;
import java.util.HashMap;
import java.util.List;
import java.util.Map;@Controller
@RequestMapping("/clz/json")
public class JsonController {@Autowiredprivate ClazzBiz clazzBiz;/*** 返回List<T>* @param req* @param clazz* @return*/@ResponseBody@RequestMapping("/list")public List<Clazz> list(HttpServletRequest req, Clazz clazz){PageBean pageBean = new PageBean();pageBean.setRequest(req);List<Clazz> lst = this.clazzBiz.listPager(clazz, pageBean);return lst;}/*** 返回T* @param req* @param clazz* @return*/@ResponseBody@RequestMapping("/load")public Clazz load(HttpServletRequest req, Clazz clazz){if(clazz.getCid() != null){List<Clazz> lst = this.clazzBiz.listPager(clazz, null);return lst.get(0);}return null;}/*** 返回List<Map>* @param req* @param clazz* @return*/@ResponseBody@RequestMapping("/mapList")public List<Map> mapList(HttpServletRequest req, Clazz clazz){PageBean pageBean = new PageBean();pageBean.setRequest(req);List<Map> lst = this.clazzBiz.mapListPager(clazz, pageBean);return lst;}/*** 返回Map* @param req* @param clazz* @return*/@ResponseBody@RequestMapping("/mapLoad")public Map mapLoad(HttpServletRequest req, Clazz clazz){if(clazz.getCid() != null){List<Map> lst = this.clazzBiz.mapListPager(clazz, null);return lst.get(0);}return null;}@ResponseBody@RequestMapping("/all")public Map all(HttpServletRequest req, Clazz clazz){PageBean pageBean = new PageBean();pageBean.setRequest(req);List<Clazz> lst = this.clazzBiz.listPager(clazz, pageBean);Map map = new HashMap();map.put("lst",lst);map.put("pageBean",pageBean);return map;}@ResponseBody@RequestMapping("/jsonStr")public String jsonStr(HttpServletRequest req, Clazz clazz){return "clzEdit";}}
在ClazzMapper.xml中创建
<select id="mapListPager" resultType="java.util.Map" parameterType="java.lang.Integer" >select<include refid="Base_Column_List" />from t_struts_class<where><if test="cname !=null">and cname like concat('%',#{cname},'%')</if></where>
</select>
注意!!!这里方法返回的是map值所以resultType中的属性值要填java.util.Map
在ClazzMapper中实现该方法
package com.xzs.mapper;import com.xzs.model.Clazz;
import com.xzs.utils.PageBean;import java.util.List;
import java.util.Map;public interface ClazzMapper {int deleteByPrimaryKey(Integer cid);int insert(Clazz record);int insertSelective(Clazz record);Clazz selectByPrimaryKey(Integer cid);int updateByPrimaryKeySelective(Clazz record);int updateByPrimaryKey(Clazz record);List<Clazz> listPger(Clazz clazz);List<Map> mapListPager(Clazz clazz);
}
编写ClazzBiz
package com.xzs.Biz;import com.xzs.model.Clazz;
import com.xzs.utils.PageBean;
import org.springframework.stereotype.Repository;import java.util.List;
import java.util.Map;@Repository
public interface ClazzBiz {int deleteByPrimaryKey(Integer cid);int insert(Clazz record);int insertSelective(Clazz record);Clazz selectByPrimaryKey(Integer cid);int updateByPrimaryKeySelective(Clazz record);int updateByPrimaryKey(Clazz record);List<Clazz> listPager(Clazz clazz, PageBean page);List<Map> mapListPager(Clazz clazz, PageBean page);
}
实现接口
package com.xzs.Impl;import com.xzs.Biz.ClazzBiz;
import com.xzs.mapper.ClazzMapper;
import com.xzs.model.Clazz;
import com.xzs.utils.PageBean;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;import java.util.List;
import java.util.Map;@Service
public class ClazzBizImpl implements ClazzBiz {
@Autowiredprivate ClazzMapper clazzMapper;@Overridepublic int deleteByPrimaryKey(Integer cid) {return clazzMapper.deleteByPrimaryKey(cid);}@Overridepublic int insert(Clazz record) {return clazzMapper.insert(record);}@Overridepublic int insertSelective(Clazz record) {return clazzMapper.insertSelective(record);}@Overridepublic Clazz selectByPrimaryKey(Integer cid) {return clazzMapper.selectByPrimaryKey(cid);}@Overridepublic int updateByPrimaryKeySelective(Clazz record) {return clazzMapper.updateByPrimaryKeySelective(record);}@Overridepublic int updateByPrimaryKey(Clazz record) {return clazzMapper.updateByPrimaryKey(record);}@Overridepublic List<Clazz> listPager(Clazz clazz, PageBean pageBean) {return clazzMapper.listPger(clazz);}@Overridepublic List<Map> mapListPager(Clazz clazz, PageBean pageBean) {return clazzMapper.mapListPager(clazz);}}
测试:
public List<Clazz> list方法
public Clazz load 方法
public List<Map> mapList方法
public Map mapLoad方法
public Map all方法
public String jsonStr方法
注意:当我们的方法全部都是返SON对象时 @ResponseBody可以放在只写一个但是必须得是上述JsonController中@Controller的上方并且( @ResponseBody,@Controller)等于@RestController如果在JsonController中将 public String jsonStr方法上的@ResponseBody给注释掉那么将不再返回json数据而是进行页面跳转
证明:
import com.xzs.utils.PageBean;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;import javax.servlet.http.HttpServletRequest;
import java.util.HashMap;
import java.util.List;
import java.util.Map;@Controller
@RequestMapping("/clz/json")
public class JsonController {@Autowiredprivate ClazzBiz clazzBiz;/*** 返回List<T>* @param req* @param clazz* @return*/@ResponseBody@RequestMapping("/list")public List<Clazz> list(HttpServletRequest req, Clazz clazz){PageBean pageBean = new PageBean();pageBean.setRequest(req);List<Clazz> lst = this.clazzBiz.listPager(clazz, pageBean);return lst;}/*** 返回T* @param req* @param clazz* @return*/@ResponseBody@RequestMapping("/load")public Clazz load(HttpServletRequest req, Clazz clazz){if(clazz.getCid() != null){List<Clazz> lst = this.clazzBiz.listPager(clazz, null);return lst.get(0);}return null;}/*** 返回List<Map>* @param req* @param clazz* @return*/@ResponseBody@RequestMapping("/mapList")public List<Map> mapList(HttpServletRequest req, Clazz clazz){PageBean pageBean = new PageBean();pageBean.setRequest(req);List<Map> lst = this.clazzBiz.mapListPager(clazz, pageBean);return lst;}/*** 返回Map* @param req* @param clazz* @return*/@ResponseBody@RequestMapping("/mapLoad")public Map mapLoad(HttpServletRequest req, Clazz clazz){if(clazz.getCid() != null){List<Map> lst = this.clazzBiz.mapListPager(clazz, null);return lst.get(0);}return null;}@ResponseBody@RequestMapping("/all")public Map all(HttpServletRequest req, Clazz clazz){PageBean pageBean = new PageBean();pageBean.setRequest(req);List<Clazz> lst = this.clazzBiz.listPager(clazz, pageBean);Map map = new HashMap();map.put("lst",lst);map.put("pageBean",pageBean);return map;}// @ResponseBody@RequestMapping("/jsonStr")public String jsonStr(HttpServletRequest req, Clazz clazz){return "clzEdit";}}
package com.xzs.web;import com.xzs.Biz.ClazzBiz;
import com.xzs.model.Clazz;
import com.xzs.utils.PageBean;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;import javax.servlet.http.HttpServletRequest;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
@ResponseBody
@Controller
@RequestMapping("/clz/json")
public class JsonController {@Autowiredprivate ClazzBiz clazzBiz;/*** 返回List<T>* @param req* @param clazz* @return*/
// @ResponseBody@RequestMapping("/list")public List<Clazz> list(HttpServletRequest req, Clazz clazz){PageBean pageBean = new PageBean();pageBean.setRequest(req);List<Clazz> lst = this.clazzBiz.listPager(clazz, pageBean);return lst;}/*** 返回T* @param req* @param clazz* @return*/
// @ResponseBody@RequestMapping("/load")public Clazz load(HttpServletRequest req, Clazz clazz){if(clazz.getCid() != null){List<Clazz> lst = this.clazzBiz.listPager(clazz, null);return lst.get(0);}return null;}/*** 返回List<Map>* @param req* @param clazz* @return*/
// @ResponseBody@RequestMapping("/mapList")public List<Map> mapList(HttpServletRequest req, Clazz clazz){PageBean pageBean = new PageBean();pageBean.setRequest(req);List<Map> lst = this.clazzBiz.mapListPager(clazz, pageBean);return lst;}/*** 返回Map* @param req* @param clazz* @return*/@ResponseBody@RequestMapping("/mapLoad")public Map mapLoad(HttpServletRequest req, Clazz clazz){if(clazz.getCid() != null){List<Map> lst = this.clazzBiz.mapListPager(clazz, null);return lst.get(0);}return null;}@ResponseBody@RequestMapping("/all")public Map all(HttpServletRequest req, Clazz clazz){PageBean pageBean = new PageBean();pageBean.setRequest(req);List<Clazz> lst = this.clazzBiz.listPager(clazz, pageBean);Map map = new HashMap();map.put("lst",lst);map.put("pageBean",pageBean);return map;}// @ResponseBody@RequestMapping("/jsonStr")public String jsonStr(HttpServletRequest req, Clazz clazz){return "clzEdit";}}
隐藏数据
在实体类中在要隐藏的属性上添加@JsonIgnore即可
package com.xzs.model;import com.fasterxml.jackson.annotation.JsonIgnore;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.hibernate.validator.constraints.NotBlank;import javax.validation.constraints.NotNull;@Data//相当于set get toString方法
@AllArgsConstructor //有参构造器
@NoArgsConstructor
public class Clazz {@NotNull(message = "班级编号不能为空")
// @Size(max = 100,min = 10,message = "大小必须在10至100之间")protected Integer cid;@NotBlank(message = "班级名不能为空")protected String cname;@NotBlank(message = "班级教员老师不能为空")protected String cteacher;
@JsonIgnoreprivate String pic="暂无图片";}
2.异常处理机制
1.为什么要全局异常处理?
我们知道,系统中异常包括:编译时异常和运行时异常RuntimeException,前者通过捕获异常从而获取异常信息,后者主要通过规范代码开发、测试通过手段减少运行时异常的发生。在开发中,不管是dao层、service层还是controller层,都有可能抛出异常,在springmvc中,能将所有类型的异常处理从各处理过程解耦出来,既保证了相关处理过程的功能较单一,也实现了异常信息的统一处理和维护。
2.异常处理思路
系统的dao、service、controller出现异常都通过throws Exception向上抛出,最后由springmvc前端控制器交由异常处理器进行异常处理。springmvc提供全局异常处理器(一个系统只有一个异常处理器)进行统一异常处理。
3.SpringMVC异常分类
-
使用Spring MVC提供的简单异常处理器SimpleMappingExceptionResolver;
-
实现Spring的异常处理接口HandlerExceptionResolver自定义自己的异常处理器;
-
使用@ControllerAdvice + @ExceptionHandler
4.异常处理方法
@RequestMapping("/mapList")public List<Map> mapList(HttpServletRequest req, Clazz clazz){System.out.println((1 / 0));PageBean pageBean = new PageBean();pageBean.setRequest(req);List<Map> lst = this.clazzBiz.mapListPager(clazz, pageBean);return lst;}
方法一
<!-- springmvc提供的简单异常处理器 -->
<bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver"><!-- 定义默认的异常处理页面 --><property name="defaultErrorView" value="error"/><!-- 定义异常处理页面用来获取异常信息的变量名,也可不定义,默认名为exception --> <property name="exceptionAttribute" value="ex"/><!-- 定义需要特殊处理的异常,这是重要点 --> <property name="exceptionMappings"><props><prop key="java.lang.RuntimeException">error</prop></props><!-- 还可以定义其他的自定义异常 --></property>
</bean>
编写错误界面error.jsp
<%--Created by IntelliJ IDEA.User: xzsDate: 2023/9/13Time: 16:48To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head><title>Title</title>
</head>
<body>
网络异常
</body>
</html>
方法二
package com.xzs.exception;public class GlobalException extends RuntimeException {public GlobalException() {}public GlobalException(String message) {super(message);}public GlobalException(String message, Throwable cause) {super(message, cause);}public GlobalException(Throwable cause) {super(cause);}public GlobalException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {super(message, cause, enableSuppression, writableStackTrace);}
}
package com.xzs.component;import com.xzs.exception.GlobalException;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerExceptionResolver;
import org.springframework.web.servlet.ModelAndView;import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;@Component
public class GlobalExceptionHandler implements HandlerExceptionResolver {@Overridepublic ModelAndView resolveException(HttpServletRequest httpServletRequest,HttpServletResponse httpServletResponse,Object o, Exception e) {ModelAndView mv = new ModelAndView();mv.setViewName("error");if (e instanceof GlobalException){GlobalException globalException = (GlobalException) e;mv.addObject("ex",globalException.getMessage());mv.addObject("msg","全局异常....");}else if (e instanceof RuntimeException){RuntimeException runtimeException = (RuntimeException) e;mv.addObject("ex",runtimeException.getMessage());mv.addObject("msg","运行时异常....");}else {RuntimeException runtimeException = (RuntimeException) e;mv.addObject("ex",runtimeException.getMessage());mv.addObject("msg","其他时异常....");}return mv;}
}
编写错误界面
<%--Created by IntelliJ IDEA.User: xzsDate: 2023/9/13Time: 16:48To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head><title>Title</title>
</head>
<body>
网络异常
${msg}
</body>
</html>
运行结果
方法三
package com.xzs.component;import com.xzs.exception.GlobalException;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;import java.util.HashMap;
import java.util.Map;@ControllerAdvice
public class GlobalExceptionResolver {// 跳转错误页面
// @ExceptionHandler
// public ModelAndView handler(Exception e){
// ModelAndView mv = new ModelAndView();
// mv.setViewName("error");
// if (e instanceof GlobalException){
// GlobalException globalException = (GlobalException) e;
// mv.addObject("ex",globalException.getMessage());
// mv.addObject("msg","全局异常....");
// }else if (e instanceof RuntimeException){
// RuntimeException runtimeException = (RuntimeException) e;
// mv.addObject("ex",runtimeException.getMessage());
// mv.addObject("msg","运行时异常....");
// }
// return mv;
// }// 返回错误json数据@ResponseBody@ExceptionHandlerpublic Map handler(Exception e){Map map = new HashMap();if (e instanceof GlobalException){GlobalException globalException = (GlobalException) e;map.put("ex",globalException.getMessage());map.put("msg","全局异常....");}else if (e instanceof RuntimeException){RuntimeException runtimeException = (RuntimeException) e;map.put("ex",runtimeException.getMessage());map.put("msg","运行时异常....");}else {map.put("ex",e.getMessage());map.put("msg","其它异常....");}return map;}
}
返回json数据
package com.xzs.component;import com.xzs.exception.GlobalException;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.servlet.ModelAndView;import java.util.HashMap;
import java.util.Map;@ControllerAdvice
public class GlobalExceptionResolver {//跳转错误页面@ExceptionHandlerpublic ModelAndView handler(Exception e){ModelAndView mv = new ModelAndView();mv.setViewName("error");if (e instanceof GlobalException){GlobalException globalException = (GlobalException) e;mv.addObject("ex",globalException.getMessage());mv.addObject("msg","全局异常....");}else if (e instanceof RuntimeException){RuntimeException runtimeException = (RuntimeException) e;mv.addObject("ex",runtimeException.getMessage());mv.addObject("msg","运行时异常....");}return mv;}// 返回错误json数据
// @ResponseBody
// @ExceptionHandler
// public Map handler(Exception e){
// Map map = new HashMap();
// if (e instanceof GlobalException){
// GlobalException globalException = (GlobalException) e;
// map.put("ex",globalException.getMessage());
// map.put("msg","全局异常....");
// }else if (e instanceof RuntimeException){
// RuntimeException runtimeException = (RuntimeException) e;
// map.put("ex",runtimeException.getMessage());
// map.put("msg","运行时异常....");
// }else {
// map.put("ex",e.getMessage());
// map.put("msg","其它异常....");
// }
// return map;
// }
}