【问题】如题所示，在我们使用hibernate框架而又需要将对象转化为json的时候，如果配置了双向的关联关系，就会出现这个死循环问题

　　异常信息：

XML/HTML代码
  1. Method public java.lang.String org.apache.commons.lang.exception.NestableRuntimeException.getMessage(int) threw an exception when invoked on net.sf.json.JSONException: There is a cycle in the hierarchy!  
  2. The problematic instruction:  
  3. ----------  
  4. ==> ${msgs[0][0]} [on line 76, column 25 in org/apache/struts2/dispatcher/error.ftl]  
  5. ----------  
  6.   
  7. Java backtrace for programmers:  
  8. ----------  
  9. freemarker.template.TemplateModelException: Method public java.lang.String org.apache.commons.lang.exception.NestableRuntimeException.getMessage(int) threw an exception when invoked on net.sf.json.JSONException: There is a cycle in the hierarchy!  
  10.     at freemarker.ext.beans.SimpleMethodModel.exec(SimpleMethodModel.java:130)  
  11.     at freemarker.ext.beans.SimpleMethodModel.get(SimpleMethodModel.java:138)  
  12.     at freemarker.core.DynamicKeyName.dealWithNumericalKey(DynamicKeyName.java:111)  
  13.     at freemarker.core.DynamicKeyName._getAsTemplateModel(DynamicKeyName.java:90)  
  14.     at freemarker.core.Expression.getAsTemplateModel(Expression.java:89)  
  15.     at freemarker.core.Expression.getStringValue(Expression.java:93)  
  16.     at freemarker.core.DollarVariable.accept(DollarVariable.java:76)  
  17.     at freemarker.core.Environment.visit(Environment.java:209)  
  18.     at freemarker.core.MixedContent.accept(MixedContent.java:92)  
  19.     at freemarker.core.Environment.visit(Environment.java:209)  
  20.     at freemarker.core.IfBlock.accept(IfBlock.java:82)  
  21.     at freemarker.core.Environment.visit(Environment.java:209)  
  22.     at freemarker.core.IfBlock.accept(IfBlock.java:82)  
  23.     at freemarker.core.Environment.visit(Environment.java:209)  
  24.     at freemarker.core.MixedContent.accept(MixedContent.java:92)  
  25.     at freemarker.core.Environment.visit(Environment.java:209)  
  26.     at freemarker.core.Environment.process(Environment.java:189)  
  27.     at freemarker.template.Template.process(Template.java:237)  
  28.     at org.apache.struts2.dispatcher.Dispatcher.sendError(Dispatcher.java:748)  
  29.     at org.apache.struts2.dispatcher.Dispatcher.serviceAction(Dispatcher.java:505)  
  30.     at org.apache.struts2.dispatcher.ng.ExecuteOperations.executeAction(ExecuteOperations.java:77)  
  31.     at org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter.doFilter(StrutsPrepareAndExecuteFilter.java:91)  
  32.     at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:235)  
  33.     at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)  
  34.     at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:233)  
  35.     at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:191)  
  36.     at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:127)  
  37.     at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:103)  
  38.     at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:109)  
  39.     at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:293)  
  40.     at org.apache.coyote.http11.Http11Processor.process(Http11Processor.java:861)  
  41.     at org.apache.coyote.http11.Http11Protocol$Http11ConnectionHandler.process(Http11Protocol.java:606)  
  42.     at org.apache.tomcat.util.net.JIoEndpoint$Worker.run(JIoEndpoint.java:489)  
  43.     at java.lang.Thread.run(Thread.java:619)  
  44. Caused by: java.lang.NullPointerException  
  45.     at freemarker.ext.beans.SimpleMemberModel.unwrapArguments(SimpleMemberModel.java:85)  
  46.     at freemarker.ext.beans.SimpleMethodModel.exec(SimpleMethodModel.java:106)  
  47.     ... 33 more  

　　关键字是net.sf.json.JSONException: There is a cycle in the hierarchy!，意思是在层次关系里有一个循环

　　【原因】为什么会这样呢？原因在于你要转化的对象里配置了对另外一个对象的关联，而那个对象里又配置了对你这个对象的关联。比如我的两个类叫做Shop(商店)和Staff(员工)，一个商店可以有多个员工，所以我给这两个对象配置了双向的一对多和多对一的关联关系。这时候问题就出现了，JSON lib在把shop对象转化为json字符串的时候，发现shop里有个Set<Staff>，它就会去级联的把Set<Staff>转化为json字符串，在它遍历Set的时候，发现Staff里又有一个Shop对象，这时候它又会去尝试把shop转化为json字符串，然后就发现shop里又有Set<Staff>，如此周而复始，就形成了死循环。

　　【解决一】如果你的业务单向关联就可以满足，比如查shop里面的staff员工信息，那么我们在类对象建立的时候在，Staff类里面的shop属性上面使用注解@JsonIgnore即可，在后台的controller我们可以查到staff对象中的shop属性，但是在页面json转化的时候会被忽略掉，从而切断递归，避免死循环；

　　【解决二】如果你的业务必须使用双向关联，如何解决呢？我百度了一下，也找到了数十条的资料，但大都只是都说明了要用jsonConfig.setJsonPropertyFilter(new PropertyFilter()｛｝),而对于其中的参数和if语句该如何写，并没有一个说的很明白的。为此我查看了json-lib的源码，并进行了尝试，总结如下：

　　1，思路是在JSONObject把Shop对象转化为json字符串的时候，在中间加一道过滤，如果当前要转化的属性是Set并且属性名是staffs，那么就进行过滤

　　2，代码如下：

Java代码
  1. Map<String, Object> map=new HashMap<String, Object>();  
  2. map.put("shops", list);  
  3. map.put("total", total);  
  4.           
  5. JsonConfig jsonConfig = new JsonConfig();  
  6. jsonConfig.setJsonPropertyFilter(new PropertyFilter() {  
  7.     public boolean apply(Object obj, String name, Object value) {  
  8.     if(obj instanceof Set||name.equals("staffs")){  
  9.         return true;  
  10.     }else{  
  11.         return false;  
  12.     }  
  13.    }  
  14. });  
  15.           
  16. return JSONObject.fromObject(map,jsonConfig);  

　　如上，PropertyFilter是json-lib提供的进行属性过滤的一个接口，具体的实现是由apply方法做的，那么我们就需要重写apply方法。

　　此方法有三个参数，第一个是Object类型的，是你要过滤的属性的类型；第二个参数是String类型，是你要过滤的属性的名称；第三个参数是Object类型的，是你要过滤的属性的值(值可能是String或其它类型的，所以用Object)。 返回值是boolean类型的，返回true；就是进行过滤，返回false，就是不进行过滤。

　　if语句的写法就要根据实际的需要了，比如说我这里要解决死循环，就要实现把Shop里的Set<Staff> staffs属性过滤掉，那我的if语句就应该如上面那样写。总而言之就是JSON-lib在转化的时候，会对每个属性都调用这个apply方法，这样我们就要根据实际的业务需要，如果当前属性符合你的if条件，那你就要返回true，进行过滤。是使用||还是&&也要根据实际而定，比如你的Shop里有两个Set，那你就要使用&&。

　　这样配置后，再测试，就发现获取Shop的时候死循环问题已经不再出现了。

　　3，同理，Staff端也应该进行类似的配置

Java代码
  1. Map<String,Object> map=new HashMap<String, Object>();  
  2. map.put("staffs", list);  
  3. map.put("total", total);  
  4.           
  5. JsonConfig jsonConfig = new JsonConfig();    
  6. jsonConfig.setExcludes(new String[]{"handler","hibernateLazyInitializer"});  
  7. jsonConfig.setJsonPropertyFilter(new PropertyFilter() {  
  8.     public boolean apply(Object obj, String name, Object value) {  
  9.         if(obj instanceof Shop&&name.equals("shop")){  
  10.             return true;  
  11.         }else{  
  12.             return false;  
  13.         }  
  14.     }  
  15. });  
  16.           
  17. return JSONObject.fromObject(map,jsonConfig);  

　　经过测试，也是没有问题的。

　　这里大家也可以看见jsonConfig.setExcludes(new String[]{"handler","hibernateLazyInitializer"});，这一行是为了防止hibernate延迟加载造成的异常而设置的。

　　4，到这里大功告成了吗？不，我在测试的时候发现了一个更严重的问题，如果按照上面做这样配置，那我获取shop的时候，生成的json字符串里staffs的Set不见了；获取Staff的时候，它的属性shop在json字符串里也不见了！稍加分析就可以知道这是上面配置造成的。按上面的配置，Shop里的Set<Staff>被过滤掉了，“过滤掉”的含义不是不级联的转化Staff里的Shop了，而是直接连Set<Staff>都不转化了。这可坏了，我配置双向关联关系就是为了关联显示，你把我的属性过滤掉了，那我还配置双向关联干嘛？我还这么大费周章的来解决死循环干嘛？

　　那么这个问题该如何解决呢？其实仔细一想，也不难，大家看我把Shop的配置改成下面这样

Java代码
  1. Map<String, Object> map=new HashMap<String, Object>();  
  2. map.put("shops", list);  
  3. map.put("total", total);  
  4.           
  5. JsonConfig jsonConfig = new JsonConfig();  
  6. jsonConfig.setJsonPropertyFilter(new PropertyFilter() {  
  7.     public boolean apply(Object obj, String name, Object value) {  
  8.     if(obj instanceof Staff||name.equals("shop")){  
  9.         return true;  
  10.     }else{  
  11.         return false;  
  12.     }  
  13.    }  
  14. });  
  15.           
  16. return JSONObject.fromObject(map,jsonConfig);  

　　这样就可以获取到了，为什么呢？因为这样配置的话，在将Shop里的Set<Staff> staffs转化的时候，我们不过滤；而在将staffs里的每个Staff里的shop转化的时候，我们进行过滤，这样就既解决了死循环问题，又避免了Shop里的staffs被过滤掉的问题。

　　同理，Staff要这样配置

Java代码
  1. Map<String,Object> map=new HashMap<String, Object>();  
  2. map.put("staffs", list);  
  3. map.put("total", total);  
  4.           
  5. JsonConfig jsonConfig = new JsonConfig();    
  6. jsonConfig.setExcludes(new String[]{"handler","hibernateLazyInitializer"});  
  7. jsonConfig.setJsonPropertyFilter(new PropertyFilter() {  
  8.     public boolean apply(Object obj, String name, Object value) {  
  9.         if(obj instanceof Set||name.equals("staffs")){  
  10.             return true;  
  11.         }else{  
  12.             return false;  
  13.         }  
  14.     }  
  15. });  
  16.           
  17. return JSONObject.fromObject(map,jsonConfig);  

　　可是我测试的时候却发现得到的字符串里只有total，staffs没有了？大家可能已经明白了，不仅Shop里的staffs被过滤掉了，map里的staffs也被过滤掉了。解决也很简单，把map.put("staffs",list);改成map.put("list",list);就行了，就是换个名字。

　　【扩展】到这里，应该能解决大家的问题了。另外还有一种方法也要提一下，

Java代码
  1. JsonConfig jsonConfig = new JsonConfig();  
  2. jsonConfig.setIgnoreDefaultExcludes(false); //设置默认忽略   
  3. jsonConfig.setCycleDetectionStrategy(CycleDetectionStrategy.LENIENT);//设置循环策略为忽略    解决json最头疼的问题 死循环  
  4. jsonConfig.setExcludes(new String[] {"staffs"});//此处是亮点，只要将所需忽略字段加到数组中即可  

　　这种配置也是比较好理解的，但也要注意属性过滤问题，Shop过滤shop，Staff过滤staffs。

除非特别注明，鸡啄米文章均为原创
转载请标明本文地址：http://www.jizhuomi.com/software/711.html
2017年3月24日
作者:鸡啄米 分类:软件开发 浏览: 评论:0