查詢參數(shù)

DataProvider前端向后端發(fā)出ajax請(qǐng)求的時(shí)候，不可避免的會(huì)有一些查詢條件的設(shè)置。

基本使用方法

我們分前端和后端分別加以說(shuō)明。

前端(JavaScript)

//dsBranch和dsDept都是DataSet對(duì)象
var branch = dsBranch.getData();
dsDept.setParameter("branchId", branch.get("id"));
dsDept.flushAsync();//觸發(fā)后端的DataProvider方法查詢數(shù)據(jù)

我們通過(guò)DataSet的parameter屬性設(shè)置查詢參數(shù)，并調(diào)用DataSet的flushAsync方法觸發(fā)后端的DataProvider方法進(jìn)行數(shù)據(jù)查詢。

后端(Java)

@DataProvider
public Collection<Dept> getDeptsByBranchId(String branchId) throws Exception {
    return depttDao.getDeptsByBranchId(branchId);
}

在DataProvider方法中我們通過(guò)一個(gè)String類型的branchId獲取前端傳入的查詢條件branchId。

多個(gè)查詢條件

在前面的例子中，查詢條件只有一個(gè)，比較簡(jiǎn)單，如果查詢條件不止一個(gè)參數(shù)，那么我們可以用一個(gè)JSON定義：

//dsBranch和dsDept都是DataSet對(duì)象
var branch = dsBranch.getData();
dsDept.setParameter({
    "branchId": branch.get("id"),
    "branchName": branch.get("name")
});
dsDept.flushAsync();//觸發(fā)后端的DataProvider方法查詢數(shù)據(jù)

多個(gè)參數(shù) 對(duì)應(yīng)的Java端的處理代碼：

@DataProvider
public Collection<Dept> getDeptsByBranchId(String branchId, String branchName) {
    return depttDao.getDeptsByBranchId(branchId, branchName);
}

在編寫(xiě)Java后端代碼處理的時(shí)候，我們只要保證對(duì)應(yīng)的參數(shù)名一致就可以。 Map參數(shù) 如果參數(shù)特別多情況下，我們也可以在Java端直接使用Map接收數(shù)據(jù)：

@DataProvider
public Collection<Dept> getDeptsByBranchId(Map<String, Object> parameters) throws Exception {
    String branchId = (String)parameters.get("branchId");
    String branchName = (String)parameters.get("branchName");
    return productDao.getDeptsByBranchId(branchId, branchName);
}

對(duì)象參數(shù) 如果我們覺(jué)得上述的多個(gè)參數(shù)在服務(wù)端用Map接收參數(shù)的編程方式不好的話，也可以改用對(duì)象參數(shù)接收。 為了實(shí)現(xiàn)對(duì)象參數(shù)接收，我們首先需要在dorado的model文件中定義一個(gè)全局的DataType: 注意設(shè)置matchType屬性對(duì)應(yīng)為你需要的Java對(duì)象。 之后在客戶端上傳參數(shù)的時(shí)候，你只要添加一個(gè)$dataType屬性指定為Branch就可以：

//dsBranch和dsDept都是DataSet對(duì)象
var branch = dsBranch.getData();
dsDept.setParameter({
    $dataType : "Branch",//設(shè)置json的$dataType屬性
    "id": branch.get("id"),
    "name": branch.get("name")
});
dsDept.flushAsync();//觸發(fā)后端的DataProvider方法查詢數(shù)據(jù)

客戶端設(shè)置了$dataType屬性后上傳到服務(wù)器端dorado引擎查找匹配的DataProvider方法的時(shí)候，就會(huì)自動(dòng)在全局的model配置文件中查找匹配的DataType，并且將相關(guān)數(shù)據(jù)自動(dòng)轉(zhuǎn)換為對(duì)應(yīng)DataType配置好的matchType屬性對(duì)應(yīng)Java類的實(shí)例中，本例就是Branch.java對(duì)象。 這樣我們的DataProvider端的Java代碼就可以改寫(xiě)為：

@DataProvider
public Collection<Dept> getDeptsByBranchId(Branch branch) throws Exception {
    String branchId = branch.getId();
    String branchName = branch.getName();
    return productDao.getDeptsByBranchId(branchId, branchName);
}

通過(guò)上述方法我們就可以多參數(shù)查詢對(duì)象化的處理。

參數(shù)類型處理

查詢參數(shù)除了String類型自然還有其它的數(shù)據(jù)類型，DataProvider的查詢也是支持的，例如：

//dsCategory, dsProduct都是DataSet對(duì)象
var category = dsCategory.getData();
dsProduct.setParameter("categoryId": category.get("id"));
dsProduct.flushAsync();//觸發(fā)后端的DataProvider方法查詢數(shù)據(jù)

對(duì)應(yīng)的Java端的處理代碼：

@DataProvider
public Collection<Product> getProductsByCategoryId(Long categoryId) {
    return productDao.getProductsByCategoryId(categoryId);
}
```# 查詢參數(shù)# 查詢參數(shù)