ExtJs十(ExtJs Mvc用户管理之二)

前言

为了防止意外情况，这里添加了try模块，在错误的时候会将错误信息作为Msg关键字的值返回。

而在客户端脚本，目前是没有处理错误信息的代码的，因而在这里返回的错误信息，客户端是看不到。如果要处理这样的错误信息，就要在Store的Proxy中监听exception事件。因为exception事件的回调函数是一致的，因而可以统一到一个函数中处理，就不用复制再复制了。

先切换到Index.cshtml，在Ext.ns下添加以下代码定义处理exception事件的回调：

            ExtMVCOne.ProxyException = function (proxy, response, opts) {
                Ext.Msg.alert("错误信息", opts.error);
            }

在exception事件的回调函数的第三个参数返回的是Operation对象，当success为false时，它会将Msg关键字的值复制到对象的error属性，因而直接调用该属性就可获得错误信息了。在这里要处理的意外情况其实还有很多，大家可根据API的说明完善该函数。

接着，切换到Users的Store，在proxy定义内添加listeners配置项来监听exception事件，代码如下：

        listeners: {
            exception: ExtMVCOne.ProxyException
        }

要测试exception事件是否能正常执行，在pagesize的定义代码前添加以下代码抛出一个异常：

throw new Exception("发生错误了。");

F5运行后到用户管理标签

 

 上一节中还有一个错误就是，CheckColumn的样式和图片没复制过来，造成最后一列的Checkbox显示不正确。在Ext JS包的examples\ux\css目录下打开CheckHeader.css文件，将文件里的全部样式定义复制到app.css中。然后修改将带背景图片的路径修改为“../images”。最后将image目录下的check.gif和uncheck.gif文件复制到scripts\app\resources\images目录下。

用户管理添加修改删除重置密码

 首先切换到用户视图脚本文件，为Grid添加一个RowEditing插件，这不难，创建RowEditing的实例，并添加到plugins就行了，代码如下：

        me.rowEditing = Ext.create('Ext.grid.plugin.RowEditing', {
            autoCancel: false,
            saveBtnText: '保存',
            cancelBtnText: '取消',
            errorsText: '错误',
            dirtyText: "你要确认或取消更改"
        });

        me.plugins = [me.rowEditing];

现在，要为用户名、电子邮件、角色和禁用列添加编辑控件了，这个只要定义好editor配置项就可以了，修改后的代码如下：

        me.columns = [
            { text: '用户名', dataIndex: 'Username', flex: 1,
                editor: { allowBlank: false }
            },
            { text: '电子邮件', dataIndex: 'Email', flex: 1 ,
                editor: { allowBlank: false, vtype: 'email' }
            },
            { text: '角色', dataIndex: 'Roles', flex: 1 ,
                editor: {
                    xtype: 'combo', store: 'Roles', multiSelect: true, allowBlank: false, editable: false,
                    emptyText: "请选择角色", forceSelection: true
                }
            },
            { xtype: "datecolumn", text: '创建时间', dataIndex: 'Created', format: "Y-m-d H:i:s",  150 },
            { xtype: "datecolumn", text: '最后登录时间', dataIndex: 'Created', format: "Y-m-d H:i:s",  150 },
            { xtype: 'checkcolumn', dataIndex: "IsApproved", text: "允许登录", winth: 150 ,
                editor: { xtype: 'checkbox', cls: 'x-grid-checkheader-editor' }
            }
        ]

代码中，用户名只是简单的不允许为空；电子邮件除了不允许为空外，还要符合电子邮件格式（vtype为email）；角色则使用Combobox，数据来自之前定义的Roles Store；禁用列则使用了Checkbox控件，样式使用x-grid-checkheader-editor，这样好看点。

接着在分页工具栏添加3个按钮，其中添加用户、删除用户使用图标显示，而重置密码则直接使用文字按钮。要在按钮显示图标，最好的方式使用样式，因而，先切换到app.css，添加以下样式：

.user-add{
     background:url("../images/user-add-16.png")!important;
}
.user-delete{
     background:url("../images/user-delete-16.png")!important;
}

复制后，切换回用户视图脚本文件，在分页工具栏定义中加入items配置项来添加按钮，代码如下：

            items: [
                '-',
                { iconCls: "user-add", tooltip: '添加用户', id: "buttonUserAdd" },
                { iconCls: "user-delete", tooltip: '删除用户', id: "buttonUserDelete", disabled: true },
                '-',
               { text: "重置密码", id: "buttonUserResetPassword", disabled: true }
            ]

注意，按钮全部都添加了id，目的就是在控制器中使用id查找按钮。删除用户和重置密码默认状态为disabled状态，只有在Grid选择行后才会启用。

然后可以F5运行，然后点击Grid数据行，效果如下

 现在，要在控制器完成各种视图操作了。切换到Users控制器，先添加一些引用来获取视图和按钮，代码如下：

    refs: [
        { ref: "UserPanel", selector: "#userPanel" },
        { ref: "UserView", selector: "#usersView" },
        { ref: "ButtonUserAdd", selector: "#buttonUserAdd" },
        { ref: "ButtonUserDelete", selector: "#buttonUserDelete" },
        { ref: "ButtonUserResetPassword", selector: "#buttonUserResetPassword" },
    ],

这样，就可通过get方法获得各控件了。

首先来完成选择一条记录后，启用删除和重置密码按钮。实现相当简单，利用引用，使用getUserView返回用户视图后，调用on方法绑定selectionchange事件就行了。当然也可以在control方法内定义，不过笔者感觉再用id获取一次对象，有点多余。在panel.add这句下加入以下代码：

me.getUserView().on("selectionchange", me.onUserSelect, me);

在onUserSelect方法内，利用get方法返回两个按钮后，调用对象的setDisabled方法设置其开启状态就可以了，代码如下：

    onUserSelect:function(model, rs){
        var me=this,
        length=rs.length;
       me.getButtonUserDelete().setDisabled(length==0);
       me.getButtonUserResetPassword().setDisabled(length == 0);
    },

事件selectionchange会在第二个参数以数组形式返回所有选择的记录，只要数组的长度不为0，就启用按钮的，为0则禁用按钮。

接着完成添加操作，在绑定selectionchange事件的代码下添加以下代码绑定click事件：

me.getButtonUserAdd().on("click", me.onAddUser, me);

在onAddUser方法内，要做的操作是先调用cancelEdit取消当前编辑操作，以避免在编辑过程中单击了添加按钮出现问题。接着在Store中添加一条记录。最后调用startEdit方法进入编辑状态。具体代码如下：

   onAddUser: function () {
       var me = this
       edit = me.getUserView().plugins[0],
       User = me.getUserModel();
       edit.cancelEdit();
       me.getUsersStore().insert(0, new User);
       edit.startEdit(0, 0);
   },

代码中，getUserModel是定义models配置项时自动生成的方法，可返回模型。同理，getUsersStore方法也是自动生成的，用于返回Store。要注意plugins中的索引，因为当前示例只有一个插件，因而使用0就可以返回RowEditing实例了，如果有多个插件，要注意索引值。

接下来要考虑怎么保存数据了，在RowEditing有一个Edit事件，它会在编辑完成后触发，非常适合用来进行数据保存操作。而且该事件会把事件冒泡到Grid，因而在Grid绑定该事件就行了，代码如下：

me.getUserView().on("edit",me.onEditcomplete, me);

在onEditcomplete方法内，调用Store的sync方法将数据同步到服务器就行了，代码如下：

   onEditcomplete: function (editor, e) {
       var me = this;
       me.getUsersStore().sync({
           success: function (e, opt) {
               var me = this;
               me.getUsersStore().commitChanges();
           },
           failure: function (e, opt) {
               var me = this, msg = "";
               me.getUsersStore().rejectChanges()
               Ext.Msg.alert("错误", e.exceptions[0].error);
           },
           scope: me
       });
   }

如果同步操作，服务器返回success为true，则调用commitChanges方法确认修改，如果失败，则调用rejectChanges方法取消修改，并显示错误信息。错误信息的处理与上文的处理差不多，只是返回的对象不同，自己根据需要做好定义就行了。

还有考虑用户取消编辑时，要调用rejectChanges方法取消更改，这个通过监听canceledit事件就可以实现，代码如下：

me.getUserView().on("canceledit", me.onCancelEdit, me);

方法onCancelEdit的代码如下：

   onCancelEdit: function () {
       var me = this;
       me.getUsersStore().rejectChanges();
   }

现在要在服务器端完成用户的添加功能了，这里要注意的是数据的提交方式。如果不清楚，可在页面单击添加按钮，然后单击保存按钮，在Firebug中就可以看到如图28所示的提交数据。 在服务器端的处理过程就是通过data提取数据，然后转换为JSON数组，从数组中把数据提取出来。对于添加操作，调用Membership的CreateUser方法添加用户就可以了，具体代码如下：

public JObject Add()
        {
            bool success = false;
            string msg = "";
            JArray ja = null;
            try
            {
                string data = Request["data"] ?? "";
                if (string.IsNullOrEmpty(data))
                {
                    msg = "错误的提交数据。";
                }
                else
                {
                    ja = JArray.Parse(data);
                    if (ja.Count > 0)
                    {
                        JObject jo = (JObject)ja[0];
                        MembershipCreateStatus createStatus;
                        MembershipUser user = Membership.CreateUser((string)jo["Username"], "123456", (string)jo["Email"], null, null, (bool)jo["IsApproved"], out createStatus);
                        if (createStatus == MembershipCreateStatus.Success)
                        {
                            success = true;
                            string[] roles = ((JArray)jo["Roles"]).Values<string>().ToArray<string>();
                            jo["id"] = user.ProviderUserKey.ToString();
                            jo["Created"] = user.CreationDate.ToString("yyyy-MM-dd hh:mm:ss");
                            jo["LastLoginDate"] = user.LastLoginDate.ToString("yyyy-MM-dd hh:mm:ss");
                            Roles.AddUserToRoles(user.UserName, roles);
                        }
                        else
                        {
                            msg = MyFunction.ErrorCodeToString(createStatus);
                        }
                    }
                    else
                    {
                        msg = "错误的提交数据。";
                    }
                }
            }
            catch (Exception e)
            {
                msg = e.Message;
            }
            return MyFunction.WriteJObjectResult(success, 0, msg, ja);
        }

还要在相应的MyFunction类中添加方法

        public static string ErrorCodeToString(MembershipCreateStatus createStatus)
        {
            // See http://go.microsoft.com/fwlink/?LinkID=177550 for
            // a full list of status codes.
            switch (createStatus)
            {
                case MembershipCreateStatus.DuplicateUserName:
                    return "当前用户名已被注册，请使用其他用户名。";

                case MembershipCreateStatus.DuplicateEmail:
                    return "当前电子邮件已被注册，请使用其他电子邮件。";

                case MembershipCreateStatus.InvalidPassword:
                    return "密码错误，请输入正确的密码。";

                case MembershipCreateStatus.InvalidEmail:
                    return "电子邮件地址错误，请重新输入。";

                case MembershipCreateStatus.InvalidAnswer:
                    return "The password retrieval answer provided is invalid. Please check the value and try again.";

                case MembershipCreateStatus.InvalidQuestion:
                    return "The password retrieval question provided is invalid. Please check the value and try again.";

                case MembershipCreateStatus.InvalidUserName:
                    return "用户名错误，请输入正确的用户名。";

                case MembershipCreateStatus.ProviderError:
                    return "系统错误，请联系管理员。";

                case MembershipCreateStatus.UserRejected:
                    return "当前请求已被取消，请重新输入并再次尝试提交。如果还存在问题，请与管理员联系。";

                default:
                    return "未知错误，请重新输入并再次尝试提交。如果问题依然存在，请与管理员联系。";
            }
        }

编辑用户的操作过程与添加操作雷同，不过Membership不允许修改用户名，因为最好在编辑的时候，不允许用户修改用户名。这个需要在RowEditing进入编辑之前来控制编辑控件的状态，也就是在beforeedit事件中实现。先在Grid绑定beforeedit事件，代码如下：

me.getUserView().on("beforeedit", me.onBeforeEdit, me);

在onBeforeEdit方法内，要对用户名的编辑组件进行操作，因而要为它添加一个引用，那就要先为编辑控件添加一个id，在用户视图脚本文件内，为用户名的编辑控件添加一个id：

            { text: '用户名', dataIndex: 'Username', flex: 1,
                editor: { allowBlank: false, id: "editorUserName" }
            },

然后在控制器中引用：

现在完成onBeforeEdit方法，代码如下：

   onBeforeEdit: function (editor, e) {
       var me = this;
       if (e.record.data.id) {
           me.getEditorUsername().setDisabled(true);
       } 
       else {
           me.getEditorUsername().setDisabled(false);
       }
   }

编辑的数据都有id，而新增的数据id为null，因而通过判断id就可判断是编辑数据还是新增数据，从而可控制用户名是否允许编辑了。这也是为什么在添加数据后必须返回正确的id的一个重要原因。

现在可完成服务器端的编辑操作代码了，具体代码如下：

public JObject Edit()
        {
            bool success = false;
            string msg = "";
            JArray ja = null;
            try
            {
                string data = Request["data"] ?? "";
                if (string.IsNullOrEmpty(data))
                {
                    msg = "错误的提交数据。";
                }
                else
                {
                    ja = JArray.Parse(data);
                    if (ja.Count > 0)
                    {
                        JObject jo = (JObject)ja[0];
                        Guid id = Guid.Parse((string)jo["id"]);
                        MembershipUser user = Membership.GetUser(id);
                        if (user != null)
                        {
                            user.Email = (string)jo["Email"];
                            user.IsApproved = (bool)jo["IsApproved"];
                            Membership.UpdateUser(user);
                            string[] roles = ((JArray)jo["Roles"]).Values<string>().ToArray<string>();
                            string[] oldroles = Roles.GetRolesForUser(user.UserName);
                            string[] rolelist = new string[] { "普通用户", "系统管理员" };
                            foreach (var c in rolelist)
                            {
                                if (roles.Contains(c))
                                {
                                    if (!oldroles.Contains(c))
                                    {
                                        Roles.AddUserToRole(user.UserName, c);
                                    }
                                }
                                else
                                {
                                    if (oldroles.Contains(c))
                                    {
                                        Roles.RemoveUserFromRole(user.UserName, c);
                                    }
                                }
                            }
                            success = true;
                        }
                        else
                        {
                            msg = "要修改的用户不存在或已被删除。";
                        }
                    }
                    else
                    {
                        msg = "错误的提交数据。";
                    }
                }
            }
            catch (Exception e)
            {
                msg = e.Message;
            }
            return MyFunction.WriteJObjectResult(success, 0, msg, ja);
        }

 现在来完成删除功能。目前的Grid，一次只能选择一行，也就是说，一次只能删除一行，不太方便，因而要设置成使用复选框选择，并允许多选的。在用户视图脚本文件中，添加以下配置项实现这个：

    selType: "checkboxmodel",
    selModel: { checkOnly: false, mode: "MULTI" },

打开浏览器刷新

删除用户的方式有2种，一种是先使用remove方法在Store中删除记录，然后调用sync方法同步，一种是提取选择行的id，然后通过Ajax方式提交到服务器进行删除，确认后再在客户端刷新页面。第一种方式必须在proxy的api定义中定义destroy配置项，之前的代码中已经定义了，因而本示例将使用该方式。第二种方式如果也定义了destroy配置项，就千万别用remove删除Store的记录，不然在添加或编辑的时候，调用sync方法进行同步的时候会把删除记录的数据一起提交的。

现在切换到Users控制器的脚本，为删除按钮绑定单击事件，代码如下：

me.getButtonUserDelete().on("click", me.onDeleteUser, me);

在onDeleteUser方法内，要先从Store的选择模型获取选择的记录。如果有选择记录，则先提示用户是否真的删除用户。确认后，调用remove方法删除记录，并调用sync方法同步数据，如果成功，调用commitChanges方法确认修改，否则调用rejectChanges方法取消修改。具体代码如下：

   onDeleteUser: function () {
       var me = this,
       sm = me.getUserView().getSelectionModel();
       if (sm.getCount() > 0) {
           var rs = sm.getSelection();
           content = ["确定删除以下用户？"];
           for (var i = 0; ln = rs.length, i < ln; i++) {
               content.push(rs[i].data.Username);
           }
           Ext.Msg.confirm("删除用户", content.join("<br/>"), function (btn) {
               if (btn == "yes") {
                   varme = this,
                   rs = me.getUserView().getSelectionModel().getSelection()
                   store = me.getUsersStore();
                   store.remove(rs);
                   store.sync({
                       success: function (e, opt) {
                           var me = this;
                           me.getUsersStore().commitChanges();
                       },
                       failure: function (e, opt) {
                           var me = this;
                           me.getUsersStore().rejectChanges()
                           Ext.Msg.alert("发生错误", e.exceptions[0].error);
                       },
                       scope: me
                   });
               }
           }, me)
       } 
       else {
           Ext.Msg.alert('删除用户', '请选择要删除的用户。');
       }
   }

代码中，使用了数组content来组合确认信息。当用户确认后，就调用remove方法，并调用sync方法。

现在来完成服务器端代码。因为sync方法提交数据的方式是固定的，因而提取删除数据的方式与添加和编辑操作的一样，需要从data中提取数据，然后使用parse方法转换为JArray。余下的工作就是从JArray中提取出删除数据的JObject，通过id或Username去删除用户了，具体代码如下：

        public JObject Delete()
        {
            string msg = "";
            bool success = false;
            JArray ja = null;
            string data = Request["data"] ?? "";
            if (string.IsNullOrEmpty(data))
            {
                msg = "错误的提交数据。";
            }
            try
            {
                ja = JArray.Parse(data);
                if (ja.Count > 0)
                {
                    foreach (JObject jo in ja)
                    {
                        Membership.DeleteUser((string)jo["Username"]);
                    }
                    success = true;
                }
                else
                {
                    msg = "错误的提交数据。";
                }
            }
            catch (Exception e)
            {
                msg = e.Message;
            }
            return MyFunction.WriteJObjectResult(success, 0, msg, ja);
        }

这里要注意的是，和添加编辑操作一样，尽管success返回true，还是要把删除的数据返回。因为删除不需要改变原有的数据，因而直接将ja返回就行了。

还有2个问题要自己考虑清楚。第1个是删除后是否提示用户已删除记录，如果需要，在sync方法内的回调函数success内加入提示信息就可以了。第2个问题是，因为删除数据后，Grid内的数据会减少，是否需要刷新页面？

最后一个功能重置密码与删除用户差不多，也是从选择模型获取选择记录。不过，这次，不能用sync同步，只能通过提取id，然后使用Ajax方法提交数据了。先为重置密码按钮绑定单击事件，代码如下：

me.getButtonUserResetPassword().on("click", me.onResetPassword, me);

接着完成onResetPassword方法，代码如下：

   onResetPassword: function () {
       var me = this,
           rs = me.getUserView().getSelectionModel().getSelection();
       if (rs.length > 0) {
           var idList = [];
           for (var i = rs.length - 1; i >= 0; i--) {
               idList.push(rs[i].data.id);
           }
           Ext.Ajax.request({
               params: { id: idList },
               url: '/Users/ResetPassword',
               scripts: true,
               scope: me,
               success: function (response, opt) {
                   var obj = Ext.JSON.decode(response.responseText);
                   if (obj) {
                       if (obj.success) {
                           Ext.Msg.alert("提示信息", "重置密码成功");
                           return;
                       } else {
                           Ext.Msg.alert("错误", obj.Msg);
                       }
                   }
               },
               failure: function (response, options) {
                   Ext.Msg.alert("错误", "重置密码失败！<br>错误信息：" + response.responseText);
               }
           });
       }
   }

代码中，没有进行确认，如果需要，可自行添加。因为Ajax提交不是根据返回的success值来调用success方法或failure方法的，只要不是页面错误，都会执行回调函数success方法，因而要自己根据返回的数据，调用decode方法将数据转换为对象，然后根据success的值来做处理。

下面，完成服务器端的ResetPassword方法。在这里，有个麻烦，就是ChangePassword方法需要使用旧密码才能修改新买，而ResetPassword方法会随机生成一个密码，都不能直接将密码设置为123456，因而，需要先用ResetPassword方法重置密码后，然后利用这个重置的密码，调用ChangePassword方法将密码修改为123456，具体代码如下：

        public JObject ResetPassword()
        {
            bool success = false;
            string msg = "";
            string idList = Request["id"] ?? "";
            try
            {
                string[] ids = idList.Split(new char[] { ',' }, StringSplitOptions.RemoveEmptyEntries);
                foreach (var c in ids)
                {
                    Guid id = Guid.Parse(c);
                    MembershipUser user = Membership.GetUser(id);
                    if (user != null)
                    {
                        string pwd = user.ResetPassword();
                        user.ChangePassword(pwd, "123456");
                    }
                }
                success = true;
            }
            catch (Exception e)
            {
                msg = e.Message;
            }
            return MyFunction.WriteJObjectResult(success, 0, msg, null);
        }

现在用户管理的基本功能（添加、删除、修改、重置密码）功能都实现了。

示例代码下载链接https://files.cnblogs.com/aehyok/ExtJsUserViewTwo.zip