jquery.treeview使用笔记

         这几天项目中要用到树型结构，正好项目中用到了JQuery,所以就在网上找依赖JQuery的JS树，最终选择了jquery.treeview.js,原因之一,它是JQuery官方发布的JS库，另一方面，看了一下它的文档，使用起来也是很简单的。经过一个小时的研究，终于搞定，现把它的使用方法做个简要的说明，以做笔记。

        要使用jquery.treeview.js，当然第一步是要把它下载下来，放入自己的工程中，然后在页面文件中引进jquery.js,jquery.cookie.js,jquery.treeview.js,jquery.treeview.async.js四个库文件，其中最后一个是要使用异步加载结点的时候，要用到的，我的项目中已经用到了这个功能，在初始化树的时候，只加载顶层的数据，当点击顶层结点的时候，才会去加载下一层的结点，所有的数据都是通过ajax去后台取得到数据。

        将库文件引入后，下一步就是要定义一个列表UL:如这样：

<ul id="categorys"></ul>

 

 树数据将会加载到这个UL里面

<script type="text/javascript">
 $(document).ready(function(){
  $("#categorys").treeview({
   url: "category!ajaxTreeView"
  });
 });
</script>

 

这里面的意思就是当文档加载完成后，向后台CategoryAction获取数据，注意后台输出的数据必须是json格式的数据。

 下一步就是后台CategoryAction的数据输出部分了：

  response.setHeader("Cache-Control", "no-cache");
  response.setContentType("text/json;charset=UTF-8");
  try {
   request.setCharacterEncoding("utf-8");
  } catch (UnsupportedEncodingException e1) {
   e1.printStackTrace();
  }

 

 要将contenttype设置为"text/json"，第一次加载初始数据的时候，会向这个CategoryAction传递一个get参数：root=source,所以后台可以判断root参数是否是source,如果是source,则代表是第一次加载数据，如果不是source,则root参数传递的則是树结点的id.
 
 数据格式如下：

[
 {
  "text": "1. Pre Lunch (120 min)",
  "expanded": true,
  "classes": "important",
  "children":
  [
   {
    "text": "1.1 The State of the Powerdome (30 min)"
   },
    {
    "text": "1.2 The Future of jQuery (30 min)"
   },
    {
    "text": "1.2 jQuery UI - A step to richnessy (60 min)"
   }
  ]
 },
 {
  "text": "2. Lunch  (60 min)"
 },
 {
  "text": "3. After Lunch  (120+ min)",
  "children":
  [
   {
    "text": "3.1 jQuery Calendar Success Story (20 min)"
   },
    {
    "text": "3.2 jQuery and Ruby Web Frameworks (20 min)"
   },
    {
    "text": "3.3 Hey, I Can Do That! (20 min)"
   },
    {
    "text": "3.4 Taconite and Form (20 min)"
   },
    {
    "text": "3.5 Server-side JavaScript with jQuery and AOLserver (20 min)"
   },
    {
    "text": "3.6 The Onion: How to add features without adding features (20 min)",
    "id": "36",
    "hasChildren": true
   },
    {
    "text": "3.7 Visualizations with JavaScript and Canvas (20 min)"
   },
    {
    "text": "3.8 ActiveDOM (20 min)"
   },
    {
    "text": "3.8 Growing jQuery (20 min)"
   }
  ]
 }
]

 

 

格式说明：上面的1. Pre Lunch (120 min) 结点中："expanded": true 代表这个结点下的child是展开的，children则是子结点的数据，节点3. After Lunch  (120+ min)有8个子结点，其中子结点中有一个结点3.6 The Onion: How to add features without adding features (20 min)，有一个id属性，同时hasChildren:true,表示其下面又有子结点，并且会向FetchProductTypeServlet传递参数为：root=id值，具体到这里就是root=36,那么点击这个结点的时候，后台就会接收到root=36这个值，然后我们就在具体应用中，通过数据库查询或者其它方式找到相对应的数据，然后将这些数据构造成treeview所需要的json数据，也即是上面所示格式的数据。

 

 

后台CategoryAction代码如下：

	public String ajaxTreeView(){
		Struts2Utils.renderText(categoryHelper.generateJTVJsonString());
		return null;
	}

 

CategoryHelper代码如下：

package com.prl.action.admin.helper;

import java.util.List;

import javax.servlet.http.HttpServletRequest;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Repository;
import org.springside.modules.web.struts2.Struts2Utils;

import com.prl.entity.Category;
import com.prl.service.CategoryManager;
import com.prl.service.jdbc.CategoryJdbcUtil;

@Repository
public class CategoryHelper {
	private static final Log log = LogFactory.getLog(CategoryHelper.class);
	@Autowired
	public CategoryManager categoryManager;
	@Autowired
	public CategoryJdbcUtil categoryJdbcUtil;

	// ========================= 产生jquery.treeview的jsonstring=================//
	public String generateJTVJsonString() {
		log.info("generateJTVJsonString start .....");
		HttpServletRequest request = Struts2Utils.getRequest();
		String id = request.getParameter("root");
		log.info("id:"+id);
		String output = "";
		if (id == null) {
			return "";
		} else if (id.equalsIgnoreCase("source")) {
			output = generateInitTreeString();
		} else {
			output = generateTreeChildNodeString(Long.parseLong(id));
		}
		log.info("generateJTVJsonString end,return:"+output);
		return output;
	}

	// 产生子节点jsonstring
	private String generateTreeChildNodeString(Long categoryId) {
		StringBuilder jsonString = new StringBuilder();
		jsonString.append("[");

		List<Category> categorys = categoryManager
				.findChildrenCategory(categoryId);
		if (categorys.isEmpty())
			return "";
		int i = 0;
		for (Category category : categorys) {
			if (i > 0) {
				jsonString.append(",");
			}
			jsonString.append(toJSONString(category));
			i++;
		}

		jsonString.append("]");
		return jsonString.toString();
	}

	private String toJSONString(Category category) {
		StringBuilder sb = new StringBuilder();
		sb.append(" {");
		sb.append("  \"text\": \"" + generateLinkString(category) + "\"");

		if (categoryJdbcUtil.hasChild(category)) {
			sb.append(",  \"id\":\"" + category.getCatId() + "\"");
			sb.append(",  \"hasChildren\":true");
		}
		sb.append(" }");
		return sb.toString();
	}

	private String generateLinkString(Category category) {
		String link = "<a href='javascript:on_cat_click("+category.getCatId()+");' >" + category.getCatName() + "</a>";
		//link = category.getCatName();
		return link;
	}

	private String generateInitTreeString() {
		StringBuilder jsonString = new StringBuilder();
		jsonString.append("[");

		List<Category> categorys = categoryManager.getRoot();
		int i = 0;
		for (Category category : categorys) {
			if (i > 0) {
				jsonString.append(",");
			}
			jsonString.append(toJSONString(category));
			i++;
		}

		jsonString.append("]");
		return jsonString.toString();
	}
	// ==================== 产生jquery.treeview的jsonstring 结束=================//
}

 

 

写完收功，希望能帮到正在使用这个treeview的朋友点小忙，自己以后再使用的时候，也可以再翻看一下这篇笔记，不至于搞忘记用法了。