SAPUI5 (28) - 基于 ODataModel 的排序和分组

OData 如何排序

OData 支持使用 $orderby 参数实现数据排序。排序的时候有两种顺序:升序 (asc) 和降序 (desc),默认是升序。我们以 Northwind OData 数据服务为例:

http://services.odata.org/V3/Northwind/Northwind.svc/Products?$orderby=ProductName

查询所有的产品,按 ProductName 排序。在浏览器中输入上面的请求,或者使用 Chrome 的插件 Postman , 可以查看服务器返回的数据。常用的排序参数:

  • 单字段排序,默认升序:/Products?$orderby=ProductName
  • 单字段排序,显式使用升序:/Products?$orderby=ProductName asc
  • 多字段排序, 产品名称升序,类别名称降序:/Products?$ordery=ProductName, Category/CategoryName desc

oDataModel 的实现数据排序

oDataModel 是服务器端模型,排序采用的方法是 sap.ui.model.ListBinding 对象的 sort() 方法触发向服务器端发送 http 请求,服务器端将排序后的数据返回给客户端显示。一般代码如下:

var oListBinding = xxx;
oListBinding.sort(aSorters);

oListBinding.sort() 方法的参数可以是一个 sap.ui.model.Sorter 对象,或者 sap.ui.model.Sorter 的数组。若为单个对象,表示按单一条件排序,如果为数组,表示按多个条件排序。接下来给出示例。要实现的功能如下图:

点击 “供应商ID” 和 “供应商名称”,对相应字段进行排序。因为代码全部放在同一个 html 文件中,所以只贴出 javascript 代码:

// Application model
var sServiceUrl = "https://cors-anywhere.herokuapp.com/" 
                + "http://services.odata.org/V3/Northwind/Northwind.svc/";
var oModel = new sap.ui.model.odata.v2.ODataModel(sServiceUrl);
oModel.setUseBatch(false);
sap.ui.getCore().setModel(oModel);

// 定义两个 Sorter 对象,第二个参数表示是否 Descending
var oIDSorter = new sap.ui.model.Sorter("SupplierID", false);
var oNameSorter = new sap.ui.model.Sorter("CompanyName", false);

// 按 SupplierID 排序
var onSortByID = function(oEvent){
    oIDSorter.bDescending = !oIDSorter.bDescending;
    
    var oTable = sap.ui.getCore().byId("suppliersTable");
    var oListBinding = oTable.getBinding("items"); 				
    oListBinding.sort(oIDSorter);	 
};

// 按 CompanyName 排序
var onSortByName = function(oEvent){
    oNameSorter.bDescending = !oNameSorter.bDescending;
    
    var oTable = sap.ui.getCore().byId("suppliersTable");
    var oListBinding = oTable.getBinding("items"); 				
    oListBinding.sort(oNameSorter); 	
};		

sap.ui.getCore().attachInit(function(){		
    
    var oTable = new sap.m.Table("suppliersTable", {
        width: "auto",
        noDataText: "Loading...",					
        
        // header toolbar
        headerToolbar: new sap.m.Toolbar({
            content: [
                new sap.m.Title({text: "供应商清单"}),
                new sap.m.ToolbarSpacer()
            ]
        }),
        
        // columns
        columns: [
            new sap.m.Column({
                header: new sap.m.Toolbar({
                    content: [
                        new sap.m.Text({text: "供应商ID"}),
                        new sap.m.Button({
                            icon: "sap-icon://sort",
                            press: onSortByID
                        })
                    ]
                })
            }),
            new sap.m.Column({
                header: new sap.m.Toolbar({
                    content: [
                        new sap.m.Text({text: "供应商名称"}),
                        new sap.m.Button({
                            icon: "sap-icon://sort",
                            press: onSortByName
                        })
                    ]
                })
            }),
            new sap.m.Column({
                header: new sap.m.Toolbar({ 
                    content: [new sap.m.Text({text: "城市"})]
                })
            }), 
            new sap.m.Column({
                header: new sap.m.Toolbar({
                    content: [new sap.m.Label({text: "国家"})]
                })
            }),
        ],
        
        // items
        items: {
            path: "/Suppliers",
            sorter: oIDSorter,						
            template: new sap.m.ColumnListItem({
                cells: [
                    new sap.m.Text({text: "{SupplierID}"}),
                    new sap.m.Text({text: "{CompanyName}"}),
                    new sap.m.Text({text: "{City}"}),
                    new sap.m.Text({text: "{Country}"})
                ]
            })						
        }
    });			
    
    var oApp = new sap.m.App({
        pages: [
            new sap.m.Page({
                title: "oDataModel 排序",
                content: [oTable]
            })  
        ]
    });
    
    oApp.placeAt("content");
});		

解释一下排序相关的代码:

  • 定义两个 sap.ui.model.Sorter对象,分别按 供应商ID供应商名称 进行升序排列:
var oIDSorter = new sap.ui.model.Sorter("SupplierID", false);
var oNameSorter = new sap.ui.model.Sorter("CompanyName", false);
  • 初始按 供应商ID 进行排序:
var oTable = new sap.m.Table("productTable", {
    ...
    items: {
        path: "/Suppliers",
        sorter: oIDSorter,						
        template: new sap.m.ColumnListItem({
            cells: [
                ...
            ]
        })						
    }
})
  • 如果用户点击 供应商ID 旁边的按钮,则对该字段进行排序:
// 按 SupplierID 排序
var onSortByID = function(oEvent){
    oIDSorter.bDescending = !oIDSorter.bDescending;
    
    var oTable = sap.ui.getCore().byId("suppliersTable");
    var oListBinding = oTable.getBinding("items"); 				
    oListBinding.sort(oIDSorter);	 
};

按供应商名称排序类似。

在 Chrome 浏览器中运行,F12 查看 Network trace,每次排序都向服务器端发送一个 http 请求, Query String Parameter 为 $orderby= XXX:

客户端排序

oData Model是服务器端 Model,按 SAP Help, 不可以在客户端进行排序和筛选:

https://help.sap.com/saphelp_nw74/helpdata/en/e1/b625940c104b558e52f47afe5ddb4f/content.htm

The OData model enables binding of controls to data from OData services. The OData model is a server-side model: the dataset is only available on the server and the client only knows the currently visible rows and fields. This also means that sorting and filtering on the client is not possible. For this, the client has to send a request to the server. The OData model currently supports OData version 2.0.

但每一次排序或者筛选,都需要向服务器提交请求,导致性能比较低,所以 SAP 后来又支持 oData Model (v2) 在客户端的排序和筛选。通过设置 ListBinding 的 OperationMode 来实现。默认情况下,OperationMode 是服务器端模式。

将上面的代码稍作变更:

var oTable = new sap.m.Table("suppliersTable", {
    width: "auto",
    noDataText: "Loading...",	
    ...	

    items: {
        path: "/Suppliers",
        sorter: oIDSorter,
        parameters: {
                operationMode: sap.ui.model.odata.OperationMode.Client
        },
        template: new sap.m.ColumnListItem({
            cells: [...]
        })						
    }		

再点击一下排序按钮,是不是快多了呢?

多字段排序

多字段排序,只需要 ListBinding.sort() 的参数为 Sorter 对象的数组即可。比如,下面的示例,在之前代码的基础上,按照国家+公司名的方式进行排序:

var oIDSorter = new sap.ui.model.Sorter("SupplierID", false);
var oNameSorter = new sap.ui.model.Sorter("CompanyName", false);
var oCountrySorter = new sap.ui.model.Sorter("Country", false);

var onMultipleSort = function(oEvent){
    var oTable = sap.ui.getCore().byId("suppliersTable");
        var oListBinding = oTable.getBinding("items"); 	
        oListBinding.sort([oCountrySorter, oNameSorter]);
}

数据分组

new sap.ui.model.Sorter(sPath, bDescending?, vGroup?, fnComparator?)

数据分组 (Grouping) 是一种特殊类型的排序,在 sap.ui.modelSorter 对象实例化时,第三个参数为 true 则,按这个排序的 Path 分组。也可以是一个函数,这个函数获取上下文 (Context) 的值,并按这个上下文的值进行分组。比如,oContext.getProperty("date").getYear() 实现按年度排序。

下面的示例在 UI 中增加一个按钮,点击的时候按国家进行分组,再次点击取消分组:

<!DOCTYPE HTML>
<html>
	<head>
		<meta http-equiv="X-UA-Compatible" content="IE=edge">
		<meta http-equiv='Content-Type' content='text/html;charset=UTF-8'/>

		<script src="../../resources/sap-ui-core.js"
				id="sap-ui-bootstrap"
				data-sap-ui-libs="sap.m"
				data-sap-ui-theme="sap_bluecrystal">
		</script>

		<script>
		
			// Application model
			var sServiceUrl = "https://cors-anywhere.herokuapp.com/" 
			                + "http://services.odata.org/V3/Northwind/Northwind.svc/";
			var oModel = new sap.ui.model.odata.v2.ODataModel(sServiceUrl);
			oModel.setUseBatch(false);
			sap.ui.getCore().setModel(oModel);
			
			// 定义两个 Sorter 对象,第二个参数表示是否 Descending
			var oIDSorter = new sap.ui.model.Sorter("SupplierID", false);
			var oNameSorter = new sap.ui.model.Sorter("CompanyName", false);
			
			// 按 SupplierID 排序
			var onSortByID = function(oEvent){
				oIDSorter.bDescending = !oIDSorter.bDescending;
				
				var oTable = sap.ui.getCore().byId("suppliersTable");
 				var oListBinding = oTable.getBinding("items"); 				
 				oListBinding.sort(oIDSorter);
			};
			
			// 按 CompanyName 排序
			var onSortByName = function(oEvent){
				oNameSorter.bDescending = !oNameSorter.bDescending;
				
				var oTable = sap.ui.getCore().byId("suppliersTable");
 				var oListBinding = oTable.getBinding("items"); 				
 				oListBinding.sort(oNameSorter); 	
			};		
			
			// 按国家分组
			var onGroupByCountry = function(oEvent){
				var oButton = sap.ui.getCore().byId("groupByCountryBtn");
				var action; // 1: 执行分组; 2: 取消分组
								
				if (oButton.getText()=="按国家分组"){
					oButton.setText("取消分组");
					action = 1;
				}else{
					oButton.setText("按国家分组");
					action = 2;
				}
				
				var aSorters = [];
				
				if (action == 1){
				    var vGroup = function(oContext) {
					    var name = oContext.getProperty("Country");
						return {
						     key: name,
						     text: name
						};
				    };
				    
				    var oCountrySorter = new sap.ui.model.Sorter("Country", false, vGroup);
					aSorters.push(oCountrySorter);
				}
				
				// apply sort
				var oTable = sap.ui.getCore().byId("suppliersTable");
 				var oListBinding = oTable.getBinding("items"); 				
 				oListBinding.sort(aSorters); 	
			};
			
			sap.ui.getCore().attachInit(function(){		
				
				var oTable = new sap.m.Table("suppliersTable", {
					width: "auto",
					noDataText: "Loading...",					
					
					// header toolbar
					headerToolbar: new sap.m.Toolbar({
						content: [
							new sap.m.Title({text: "供应商清单"}),
							new sap.m.ToolbarSpacer(),
							new sap.m.Button({
								id: "groupByCountryBtn",
								text: "按国家分组",
								press: onGroupByCountry
							})
						]
					}),
					
					// columns
					columns: [
						new sap.m.Column({
							header: new sap.m.Toolbar({
								content: [
								    new sap.m.Text({text: "供应商ID"}),
								    new sap.m.Button({
								    	icon: "sap-icon://sort",
								    	press: onSortByID
								    })
								]
							})
						}),
						new sap.m.Column({
                			header: new sap.m.Toolbar({
                				content: [
    								new sap.m.Text({text: "供应商名称"}),
    								new sap.m.Button({
    								   icon: "sap-icon://sort",
    								   press: onSortByName
    								})
    							]
							})
            			}),
            			new sap.m.Column({
                			header: new sap.m.Toolbar({ 
                				content: [new sap.m.Text({text: "城市"})]
                			})
            			}), 
            			new sap.m.Column({
                			header: new sap.m.Toolbar({
                				content: [new sap.m.Label({text: "国家"})]
                			})
            			}),
					],
					
					// items
					items: {
						path: "/Suppliers",
						sorter: oIDSorter,
						parameters: {
						      operationMode: sap.ui.model.odata.OperationMode.Client
						},
						template: new sap.m.ColumnListItem({
							cells: [
							    new sap.m.Text({text: "{SupplierID}"}),
								new sap.m.Text({text: "{CompanyName}"}),
								new sap.m.Text({text: "{City}"}),
								new sap.m.Text({text: "{Country}"})
							]
						})						
					}
				});			
				
				var oApp = new sap.m.App({
					pages: [
						new sap.m.Page({
							title: "oDataModel 排序和分组",
							content: [oTable]
						})  
					]
				});
				
				oApp.placeAt("content");
			});			
			
		</script>

	</head>
	<body class="sapUiBody" role="application">
		<div id="content"></div>
	</body>
</html>

按国家分组的关键代码如下:

// 按国家分组
var onGroupByCountry = function(oEvent){
    var oButton = sap.ui.getCore().byId("groupByCountryBtn");
    var action; // 1: 执行分组; 2: 取消分组
                    
    if (oButton.getText()=="按国家分组"){
        oButton.setText("取消分组");
        action = 1;
    }else{
        oButton.setText("按国家分组");
        action = 2;
    }
    
    var aSorters = [];
    
    if (action == 1){
        var vGroup = function(oContext) {
            var name = oContext.getProperty("Country");
            return {
                    key: name,
                    text: name
            };
        };
        
        var oCountrySorter = new sap.ui.model.Sorter("Country", false, vGroup);
        aSorters.push(oCountrySorter);
    }
    
    // apply sort
    var oTable = sap.ui.getCore().byId("suppliersTable");
    var oListBinding = oTable.getBinding("items"); 				
    oListBinding.sort(aSorters); 	
};

源代码

28_zui5_odata_filter_sort_group

References

  • 1
    点赞
  • 5
    收藏
    觉得还不错? 一键收藏
  • 1
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值