jQuery Datatable后台分页

jQuery Datatable 实用简单实例

目标:

使用 jQuery Datatable 构造数据列表,并且增加或者隐藏相应的列,已达到数据显示要求。同时, jQuery Datatable 强大的功能支持:排序,分页,搜索等。

Query Datatable 能良好支持数据完全加载到本地后构建数据列表,排序、分页、搜索等功能就会自带,不需要我们去关心,在此主要说明通过后台动态的加载数据,已达到在大数据面前提高效率的效果。

1. 通过后台进行分页

2. 通过后台进行排序

3. 通过后台进行搜索

具体使用方法:

1. 首先构建我们需要的数据列表,以及页面显示表格。

<table id="datatable" width="100%" border="1">
  <thead>
    <tr>
      <th>IDth>
      <th>First Nameth>
      <th>Last Nameth>
      <th>Operationth>
    tr>
  <thead>
table>

表格建立很简单,只需用将表格定义好 id ,以及表头定义好。

2. 我们可以到 jQuery Datatable 官网上去下载一份 jQuery 和 jQuery Datatable 的 js库。 https://datatables.net/examples/server_side/simple.html 。

wKiom1Nq7d3BrrQmAACVHW5gAbY810.jpg

3. 然后将这两个文件引入到页面文件中,注意 jQuery 的库一定要在最前面,因为页面加载的有顺序,保证后面的扩展库能使用到 jQuery 。同时,请下载最新的 jQuery Datatable 版本,因为它的写法以及参数更加简洁,功能更加多。【注:参数区别会在附录写明】

4. 编写前端代码。我们是要使用 Ajax 对后台进行请求,因此在配置 datatable 时,加上 { "serverSide" : true } ,已保证页面在加载时就请求后台,以及每次对 datatable进行操作时也是请求后台。【附:如果想加上一点加载效果,可以增加 { "processing": true } 】。

配置请求后台 URL : { "ajax" : "load" }

5. 配置数据返回对应具体的列。在 Datatable 中,属性 columns 用来配置具体列的属性,包括对应的数据列名,是否支持搜索,是否显示,是否支持排序等。根据上述页面配置我们具体的列。如下:

$(document).ready(function() {
    $("#datatable").dataTable({
      "processing": true,
      "serverSide": true,
      "ajax" : "load",
      "columns": [
        {"data": "id", "bSortable": false},
        {"data": "firstName"},
        {"data": "lastName"}
      ]
    });
  });

第一列 ID ,设置为不允许排序。也可以增加不显示: { "visible" : false }

6. 此时对于后台而言,返回的数据一定要按照一定规范。如下:

{
  "draw": 2,
  "recordsTotal": 11,
  "recordsFiltered": 11,
  "data": [
    {
      "id": 1,
      "firstName": "Troy",
      "lastName": "Young"
    },
    {
      "id": 2,
      "firstName": "Alice",
      "lastName": "LL"
    },
    {
      "id": 3,
      "firstName": "Larry",
      "lastName": "Bird"
    }
    // ......
  ]
}

参数解释:

draw: 表示请求次数

recordsTotal: 总记录数

recordsFiltered: 过滤后的总记录数

data: 具体的数据对象数组

7. 最后一列 Operation ,我们没有任何数据,用来放我们的通用操作列,如修改链接。 Datatable 提供了自定义列 columnDef s 属性,他的值为数组对象,具体代码如下:

$(document).ready(function() {
    $("#datatable").dataTable({
      "processing": true,
      "serverSide": true,
      "ajax" : "load",
      "columns": [
        {"data": "id", "bSortable": false},
        {"data": "firstName"},
        {"data": "lastName"}
      ],
      "columnDefs": [
        {
          "targets": [3],
          "data": "id",
          "render": function(data, type, full) {
            return "<a href='/update?id=" + data + "'>Updatea>";
          }
        }
      ]
    });
  });

targets : 表示具体需要操作的目标列,下标从 0 开始

data: 表示我们需要的某一列数据对应的属性名

render: 返回需要显示的内容。在此我们可以修改列中样式,增加具体内容

  属性列表: data , 之前属性定义中对应的属性值

                                t ype , 未知

    full ,    全部数据值可以通过属性列名获取 

具体效果图如下:

jQuery Datatable后台分页_第1张图片

8. 我们再来看具体如何进行搜索、排序、分页。由于只是为了做 demo ,因此使用最简单的 JDBC+Servlet 的方式来实现。

首先我们来看, datatable 给我们在做请求是传递过来的参数:

=============== Request Paramerters ================
draw: 1
columns[0][data]: id
columns[0][name]:
columns[0][searchable]: true
columns[0][orderable]: true
columns[0][search][value]:
columns[0][search][regex]: false
columns[1][data]: firstName
columns[1][name]:
columns[1][searchable]: true
columns[1][orderable]: true
columns[1][search][value]:
columns[1][search][regex]: false
columns[2][data]: lastName
columns[2][name]:
columns[2][searchable]: true
columns[2][orderable]: true
columns[2][search][value]:
columns[2][search][regex]: false
order[0][column]: 0
order[0][dir]: asc
start: 0
length: 10
search[value]:
search[regex]: false
_: 1399345292266
=============== Request Paramerters ================

其中有用的数据就是 start, length, order[0][column], order[0][dir], search[value] 。具体参数意思:

start: 其实记录位置

length: 页面显示数量

order[0][column]: 因为是二维的表格,因此只有一维需要排序,所以 order 的下标未0. 该属性表示第几列需要排序。

order[0][dir]: 排序方式 ASC | DESC

search[value]: search 输入框中的值

9. 这几个属性对后台进行排序、搜索、分页很有用。【注:因为是二维表,并且只是对一列进行操作,自然就是一维的,所以 order 下标始终为 1 。以后操作二维表有待研究。】

首先来看包含这几个功能的 DAO 层代码:

/**
   * This method includes the search, sort, pagination
   * @param pageSize
   * @param startRecord
   * @param sortColumn
   * @param sortDir
   * @param searchValue
   * @return
   */
  public List loadDataList(int pageSize, int startRecord, String sortColumn, String sortDir, String searchValue) {
    List results = new ArrayList();
    StringBuffer sql = new StringBuffer("select * from data ");
               
    // for search
    String[] columnsName = { "id", "firstName", "lastName" };
    boolean searchAble = false;
    if(searchValue != null && !"".equals(searchValue)) {
      sql.append("where ");
      searchAble = true;
    }
               
    if(searchAble) {
      StringBuffer temp = new StringBuffer();
      for (String column : columnsName) {
        temp.append( column+ " like '%" + searchValue + "%' or ");
      }
      sql.append(temp.substring(0, temp.length() - 3));
    }
               
    // for order
    sql.append(" order by " + sortColumn + " " + sortDir + " ");
               
    // for pagination
    sql.append(" limit ?,? ");
    System.out.println(sql.toString());
               
    try {
      stmt = conn.prepareStatement(sql.toString());
      stmt.setInt(1, startRecord);
      stmt.setInt(2, startRecord + pageSize);
                 
      ResultSet rs = stmt.executeQuery();
      while(rs.next()) {
        Data data = new Data();
        data.setId(rs.getInt(1));
        data.setFirstName(rs.getString(2));
        data.setLastName(rs.getString(3));
                   
        results.add(data);
      }
                 
    } catch (SQLException e) {
      // TODO Auto-generated catch block
      e.printStackTrace();
    }
               
    return results;
  }

DAO 层中,统计代码类似,只用把分页和排序的 SQL 拼接去掉即可。

我们需要将我们的数据转换成 JSON 返回给前端,并且还要显示总记录数,过滤后总记录数。因此我们需要一个统一的类来将这些数据进行封装。由于在一个系统中不只一个对象需要展示到前端,因此统一的做一个为 datatable 封装类。

package com.web.vo;
import java.util.List;
/**
 * This VO used to generate the JSON data for data table, so please ensure that the attribute name is correct.
 * If you want to define the fields name by yourself, please visit: https://datatables.net
 * @author troyyang
 *
 * @param 
 */
public class DataVO<T> {
    private int draw; // Client request times
    private int recordsTotal; // Total records number without conditions
    private int recordsFiltered; // Total records number with conditions
    private List data; // The data we should display on the page
    // getter and setter method
}

万事具备,只欠前后交互代码。此处使用最简单的 servlet 。

// For pagination
  int pageSize = 10;
  int startRecord = 0;
  String size = request.getParameter("length");
  if (!"".equals(size) && size != null) {
      pageSize = Integer.parseInt(size);
  }
  String currentRecord = request.getParameter("start");
  if (!"".equals(currentRecord) && currentRecord != null) {
      startRecord = Integer.parseInt(currentRecord);
  }
  // For sortable
  String sortOrder = request.getParameter("order[0][column]");
  String sortDir = request.getParameter("order[0][dir]");
  System.out.println("sortOrder: " + sortOrder);
  System.out.println("sortDir: " + sortDir);
         
  // For search
  String searchValue = request.getParameter("search[value]");
  int count = 0;
  List results = new ArrayList();
  count = dao.count();
  results = dao.loadDataList(pageSize, startRecord, columnsName[Integer.parseInt(sortOrder)], sortDir, searchValue);
  DataVO result = new DataVO();
  result.setDraw(Integer.parseInt(request.getParameter("draw") == null ? "0"
    : request.getParameter("draw")) + 1);
  result.setData(results);
  result.setRecordsTotal(count);
  result.setRecordsFiltered(count);
  Gson gson = new Gson();
  String output = gson.toJson(result);
  System.out.println("Output JSON: \n" + output);
  PrintWriter out = response.getWriter();
  out.write(output);
  out.flush();
  out.close();

附录:

使用 jQuery Datatable 1.10 之前的版本,必须使用 sAjaxSource 进行请求,但是请求数据和现在版本的请求数据不同,如下:

=============== Request Paramerters ================
sEcho: 1
iColumns: 4
sColumns: ,,,
iDisplayStart: 0
iDisplayLength: 10
mDataProp_0: id
sSearch_0:
bRegex_0: false
bSearchable_0: true
bSortable_0: false
mDataProp_1: firstName
sSearch_1:
bRegex_1: false
bSearchable_1: true
bSortable_1: true
mDataProp_2: lastName
sSearch_2:
bRegex_2: false
bSearchable_2: true
bSortable_2: true
mDataProp_3: id
sSearch_3:
bRegex_3: false
bSearchable_3: true
bSortable_3: true
sSearch:
bRegex: false
iSortCol_0: 0
sSortDir_0: asc
iSortingCols: 1
_: 1399515247114
=============== Request Paramerters ================

更过特性,持续更新......

  收藏     纠错
推荐文章
  • 1. Spring两种依赖注入方式的比较
  • 2. NIO学习–缓冲区
  • 3. Java并发编程(20):并发新特性—Lock锁和条件变量(含代码)
  • 4. Java集合类之HashMap原理小结
  • 5. Java 与 CPU 高速缓存
  • 6. 深入理解JAVA I/O系列四:RandomAccessFile
相关推刊
  • by 左次无咎jQuery Datatable后台分页_第2张图片《前端》10
  • by 小崔家的小瘦jQuery Datatable后台分页_第3张图片《默认推刊》4
我来评几句
登录后评论

已发表评论数(1)

愚公楼主 05-08 12:30
有这么好的东西,咋不把自家站内的博客搜索好好整一下呢?

相关站点

51CTO推荐博文
+订阅
热门文章
  • 1. Spring两种依赖注入方式的比较
  • 2. NIO学习–缓冲区
  • 3. Java并发编程(20):并发新特性—Lock锁和条件变量(含代码)
  • 4. Java集合类之HashMap原理小结
  • 5. Java 与 CPU 高速缓存
jQuery Datatable后台分页_第4张图片
jQuery Datatable后台分页_第5张图片
jQuery Datatable后台分页_第6张图片

你可能感兴趣的:(JavaScript)