前面的MVC介绍只有view和controller,还没有涉及数据,所以没有model的部分。本篇增加数据,介绍Model以及数据绑定,展示一个完整的MVC示例。我们将要实现的示例是在页面中显示供应商的列表,每个供应商含有ID和Name两个字段。
首先介绍几个相关的知识点。因为我们打算在表格(Table)中显示供应商,所以我们选择sap.ui.table.Table
控件,这个控件对PC和Tablet有很好的适应,界面漂亮,功能强大。
知识点介绍
sap.ui.table.Table
Table以行和列的方式显示数据,这种样式我相信大家都很熟悉,展示方法就像Excel,有行和列构成。本篇将使用sap.ui.table.Table
的如下属性:
width : sap.ui.core.CSSSize (default: auto)。表格的宽度可以是百分百,或者基于像素。
visibleRowCount : int (default: 10)。默认显示10行,可以自定义。
firstVisibleRow : int (default: 0)
selectionMode : sap.ui.table.SelectionMode (default: MultiToggle)。包括单行(sap.ui.table.SelectionMode.Single
)、多行(sap.ui.table.SelectionMode.MultiToggle
)和不能选择行(sap.ui.table.SelectionMode.None
)。
editable : boolean (default: true)。默认可以编辑,如果只是显示,将此属性设置为false。
Table的聚合(Aggregation):
title : sap.ui.core.Control|string
columns : sap.ui.table.Column[] (default)
sap.ui.table.Column
定义Table的列。本篇要用到的属性:
width : sap.ui.core.CSSSize
sortProperty : string。指定按哪个字段进行排序。
聚合:
label : sap.ui.core.Control|string (default)
template : sap.ui.core.Control。template聚合属性是一个控件,通过控件来绑定数据。
Models
MVC的Model代表应用程序的数据,如果数据来自客户端(client),有JSON model、XML model和Resource model三种; 如果数据来自服务器端(server),有oData model。不管这些数据来自何处,sapui5都需要进行加载和使用。我们第一个例子,使用JSON model,JSON数据采取硬编码方式。为了方便介绍,先贴出完整代码。
不用MVC方式的代码
<!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, sap.ui.table"
data-sap-ui-theme="sap_bluecrystal">
</script>
<script>
// application data
var oAppData =
{
"CountSuppliers" : 2,
"Suppliers" : [{
"ID": 1,
"Name": "中国图书进出口公司"
}, {
"ID": 2,
"Name": "东莞少儿玩具制造厂"
}
]
};
var oModel = sap.ui.model.json.JSONModel();
oModel.setData(oAppData);
// setting the model to the core
// so that it's available to the whole application
sap.ui.getCore().setModel(oModel);
// define columns and table
var oIdCol = new sap.ui.table.Column({
label: new sap.m.Label({text:"ID"}),
template: new sap.m.Text().bindProperty("text", "ID"),
sortProperty: "ID",
width: "100px"
});
var oNameCol = new sap.ui.table.Column({
label: new sap.m.Label({text:"Name"}),
template: new sap.m.Text().bindProperty("text", "Name"),
sortProperty: "Name",
width: "150px"
});
var oTable = new sap.ui.table.Table({
width: "100%",
title: "供应商列表",
visibleRowCount: 2,
firstVisibleRow: 0,
editable: false,
selectionMode: sap.ui.table.SelectionMode.Single,
columns: [oIdCol, oNameCol]
});
oTable.setModel(oModel);
oTable.bindRows("/Suppliers");
// define page & app
var oPage = new sap.m.Page("masterpage", {
title: "供应商",
content: [oTable]
});
var oApp = new sap.m.App("myApp");
oApp.addPage(oPage);
oApp.placeAt("content");
</script>
</head>
<body class="sapUiBody SapUiResponsiveMargin" role="application">
<div id="content"></div>
</body>
</html>
代码分为三个部分,第一个部分是定义JSON数据,并加载。JSON数据包含两个供应商的数据,每个供应商有ID和Name两个字段。var oModel = sap.ui.model.json.JSONModel();
声明一个JSONModel,oModel.setData(oAppData);
语句设置JSON model的数据为刚刚定义的JSON数据;sap.ui.getCore().setModel(oModel);
语句设置core对象的Model为oModel,这样oModel对整个应用程序可见。
第二部分是声明sap.ui.Table
类的对象,以及绑定数据。
// define columns and table
var oIdCol = new sap.ui.table.Column({
label: new sap.m.Label({text:"ID"}),
template: new sap.m.Text().bindProperty("text", "ID"),
sortProperty: "ID",
width: "100px"
});
var oNameCol = new sap.ui.table.Column({
label: new sap.m.Label({text:"Name"}),
template: new sap.m.Text().bindProperty("text", "Name"),
sortProperty: "Name",
width: "150px"
});
var oTable = new sap.ui.table.Table({
width: "100%",
title: "供应商列表",
visibleRowCount: 2,
firstVisibleRow: 0,
editable: false,
selectionMode: sap.ui.table.SelectionMode.Single,
columns: [oIdCol, oNameCol]
});
oTable.setModel(oModel);
oTable.bindRows("/Suppliers");
先定义两个sap.ui.table.Column
对象,sap.ui.table.Column
对象的template
设置为sap.m.Text
对象,并与JSON model的ID和Name两列绑定。我们暂且不用管数据绑定的细节,后面会详细介绍。
var oTable = ...
语句声明一个sap.ui.table.Table
对象,Table包含刚刚申明的两个列对象。
oTable.setModel(oModel);
实现Table与JSONModel的绑定,也就是View和Model的绑定。oTable.bindRows("/Suppliers");
语句实现Table与JSON数据的绑定,JSON数据是层次化的数据,如本例,JSON数据的根目录下有两个值:CountSuppliers和Suppliers,Table绑定Suppliers。
第三个部分代码就是申明App和Page,不多说。程序运行界面:
MVC实现
仍然使用javascript view。项目的文件结构如下:
index.html
<!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, sap.ui.table"
data-sap-ui-theme="sap_bluecrystal">
</script>
<script>
jQuery.sap.registerModulePath("suppliers", "./suppliers");
var oApp = new sap.m.App({initialPage: "firstPage"});
var oFirstPage = sap.ui.view({
id: "firstPage",
viewName: "suppliers.supplieroverview",
type: "JS"
});
oApp.addPage(oFirstPage);
oApp.placeAt("content");
</script>
</head>
<body class="sapUiBody SapUiResponsiveMargin" role="application">
<div id="content"></div>
</body>
</html>
jQuery.sap.registerModulePath("suppliers", "./suppliers");
将suppliers注册为当前文件夹下的suppliers子文件夹。定义一个
sap.m.App
和sap.ui.view
,view加载到App,App放置在div中。
suppliers.json
将json数据放在一个单独的文件中,文件内容如下:
{
"CountSuppliers" : 2,
"Suppliers" : [{
"ID": 1,
"Name": "中国图书进出口公司"
}, {
"ID": 2,
"Name": "东莞少儿玩具制造厂"
}
]
}
supplieroverview.view.js
sap.ui.jsview("suppliers.supplieroverview", {
/** Specifies the Controller belonging to this View.
* In the case that it is not implemented, or that "null" is returned, this View does not have a Controller.
* @memberOf suppliers.supplieroverview
*/
getControllerName : function() {
return "suppliers.supplieroverview";
},
/** Is initially called once after the Controller has been instantiated. It is the place where the UI is constructed.
* Since the Controller is given to this method, its event handlers can be attached right away.
* @memberOf suppliers.supplieroverview
*/
createContent : function(oController) {
// define columns and table
var oColumns = [
new sap.ui.table.Column({
label: new sap.m.Label({text:"ID"}),
template: new sap.m.Text().bindProperty("text", "ID"),
sortProperty: "ID",
width: "50px"
}),
new sap.ui.table.Column({
label: new sap.m.Label({text:"Name"}),
template: new sap.m.Text().bindProperty("text", "Name"),
sortProperty: "ID",
width: "100px"
})
];
var oTable = new sap.ui.table.Table({
width: "100%",
title: "供应商列表",
visibleRowCount: 2,
firstVisibleRow: 0,
editable: false,
selectionMode: sap.ui.table.SelectionMode.Single,
columns: oColumns
});
oTable.bindRows("/Suppliers");
var oPage = new sap.m.Page({
title: "供应商",
content: [oTable]
});
return oPage;
}
});
每个javascript view都有getControllerName
和createContent
两个函数。显示的内容写在createContent
函数中。主要结构如下:
var oColumns = ...;
var oTable = new sap.ui.table.Table({...});
oTable.bindRows("/Suppliers");
var oPage = new sap.m.Page({content: [oTable]});
return oPage;
supplieroverview.controller.js
sap.ui.controller("suppliers.supplieroverview", {
/**
* Called when a controller is instantiated and its View controls (if available) are already created.
* Can be used to modify the View before it is displayed, to bind event handlers and do other one-time initialization.
* @memberOf suppliers.supplieroverview
*/
onInit: function() {
var oModel = sap.ui.model.json.JSONModel('models/suppliers.json');
this.getView().setModel(oModel);
}
});
sap.ui.core.mvc.Controller
对象的getView()
方法获得与之关联的View,然后设置View与Model的关联。
今天是2017年第一天,坚持!