循序渐进VUE+Element 前端应用开发(15）--- 用户管理模块的处理

在前面随笔介绍了ABP+Vue前后端的整合处理，包括介绍了ABP的后端设计，以及前端对ABP接口API的ES6的封装，通过JS的继承类处理，极大减少了重复臃肿的代码，可以简化对后端API接口的封装，而且前端使用Element组件，很好展示API获得的数据，通过在界面中展示树状列表，以及表格列表数据，可以构建一个很好的列表展示界面，而常规的界面，通过也包括了新增、编辑、查看等展示场景，一般我们通过对话框的方式进行展示处理。本篇随笔以权限管理模块中的用户管理为媒介，进行相关功能的介绍和界面设计的处理。

1、权限管理模块的设计

我们知道，权限管理一般都会涉及到用户、组织机构、角色，以及权限功能等方面的内容，ABP框架的基础内容也是涉及到这几方面的内容，其中它们之间的关系基本上是多对多的关系，它们的关系如下所示。

权限模块里面包含的一些主对象表和中间表，中间表主要用来存储两个对象之间的多对多关系，如角色包含多个用户，用户属于多个机构，机构包含多个角色等等。

结合ABP后端提供的接口，Vue前端我们要实现基础的用户、组织机构、角色、功能权限等内容的管理，以及维护它们之间的关系。Vue前端对于权限管理模块的菜单列表如下所示。

上图权限管理模块中，包括用户管理、机构管理、角色管理、菜单管理、功能管理、审计日志、登录日志等内容模块的管理。

其中用户管理模块，主要用来展示用户信息列表，以及查看对应用户权限、维护密码等处理。

用户列表界面如下所示，包括对应条件的查询和列表展示、以及查看、添加、编辑、删除、重置密码等功能入口。

用户信息查看界面如下所示

主要展示用户基础信息，和所属的关系信息，其中权限部分列出对应用户包含的功能点，用于界面按钮等方面的控制处理。

用户添加界面，则主要用来处理录入用户基础信息部分即可，如下界面所示。

用户信息录入，对用户基础表单数据进行校验，符合格式要求才能录入。

用户编辑界面，基本上和上面的类似了，不在赘述。

另外，删除用户或者重置密码，一般需对确认后再行操作，弹出一个对话框用户确认再继续。

ABP+Vue的框架参考的是已完成的ABP+Winform的功能界面进行开发，具体也可以了解下Winform版本框架《ABP开发框架前后端开发系列---（14）基于Winform的ABP快速开发框架》

2、用户管理界面功能

以上我们介绍了权限管理模块涉及的内容和关系，并着重介绍了用户管理界面中的内容展示，下面介绍在Element中如何实现对上面界面的处理的。

首先我们需要根据ABP后端的接口进行前端JS端的类的封装处理，其中前面说过，常规的Get/GetAll/Create/Update/Delete/Count等接口，我们放在BaseApi基类里面定义，其他子类继承它即可。

权限模块我们涉及到的用户管理、机构管理、角色管理、菜单管理、功能管理、审计日志、登录日志等业务类，那么这些类继承BaseApi，就会具有相关的接口了，如下所示继承关系。

我们这里以UserAPI的JS类定义介绍，如下所示。

我们以其中一个接口为例进行介绍实现代码，可以看到主要就是简单封装的调用即可。

  GetGrantedFunctionsByUser(id) { // 获取用户权限列表
    return request({
      url: this.baseurl + 'GetGrantedFunctionsByUser',
      method: 'get',
      params: { id }
    })
  }

有了这些业务类的准备，那么我们和后端ABP的API接口对接，就很容易了，如下图所示。

剩下的就是对Vue + Element前端的界面处理事情了。

我们先来看看查询的处理，常规的查询涉及日期区间的查询处理，这里我们用一个一个查询日期的处理操作，如下图所示。

表单的界面代码如下所示

    <el-form ref="searchForm" :model="searchForm" label-width="80" :inline="true">
      <el-form-item label="创建时间">
        <el-date-picker
          v-model="searchForm.creationTime"
          type="daterange"
          align="right"
          unlink-panels
          range-separator="至"
          start-placeholder="开始日期"
          end-placeholder="结束日期"
          :picker-options="pickerOptions"
        />
      </el-form-item>
      <el-form-item label="用户名" prop="UserName">
        <el-input v-model="searchForm.UserName" />
      </el-form-item>
      <el-form-item label="手机" prop="PhoneNumber">
        <el-input v-model="searchForm.PhoneNumber" />
      </el-form-item>
    </el-form>

其中定义了一个pickerOptions 属性，用于快速选择日期的，在data里面增加一个这样的属性即可。

      pickerOptions: {
        shortcuts: [{
          text: '最近一周',
          onClick(picker) {
            const end = new Date();
            const start = new Date();
            start.setTime(start.getTime() - 3600 * 1000 * 24 * 7);
            picker.$emit('pick', [start, end]);
          }
        }, {
          text: '最近一个月',
          onClick(picker) {
            const end = new Date();
            const start = new Date();
            start.setTime(start.getTime() - 3600 * 1000 * 24 * 30);
            picker.$emit('pick', [start, end]);
          }
        }, {
          text: '最近三个月',
          onClick(picker) {
            const end = new Date();
            const start = new Date();
            start.setTime(start.getTime() - 3600 * 1000 * 24 * 90);
            picker.$emit('pick', [start, end]);
          }
        }]
      },

在页面里面，我们定义了一些分页查询的处理条件和对象，如下所示。

查询表单则定义一个单独的表单对象，如下代码所示

      searchForm: { // 查询表单
        UserName: '',
        PhoneNumber: '',
        creationTime: ''
      },

页面加载准备好，我们就调用获取列表的数据即可。

  created() { // 页面加载后，加载列表数据
    this.getlist()
  },

获取列表的处理操作如下代码所示，主要就是准备构建好对应的查询参数，然后调用UserApi类的接口查询列表即可。

    getlist() { // 列表数据获取
      var CreationTimeStart = ''
      if (this.searchForm.creationTime && this.searchForm.creationTime.length > 0) {
        CreationTimeStart = this.parseTime(this.searchForm.creationTime[0], '{y}-{m}-{d}')
      }
      var CreationTimeEnd = ''
      if (this.searchForm.creationTime && this.searchForm.creationTime.length > 1) {
        CreationTimeEnd = this.parseTime(this.searchForm.creationTime[1], '{y}-{m}-{d}')
      }

      var param = { // 构造常规的分页查询条件
        SkipCount: (this.pageinfo.pageindex - 1) * this.pageinfo.pagesize,
        MaxResultCount: this.pageinfo.pagesize,
        // 过滤条件
        UserName: this.searchForm.UserName,
        PhoneNumber: this.searchForm.PhoneNumber,
        CreationTimeStart: CreationTimeStart,
        CreationTimeEnd: CreationTimeEnd
      };

      // 获取列表，绑定到模型上，并修改分页数量
      this.listLoading = true
      user.GetAll(param).then(data => {
        this.list = data.result.items
        this.pageinfo.total = data.result.totalCount
        this.listLoading = false
      })
    },
    search() { // 查询列表处理
      this.pageinfo.pageindex = 1;// 重置为第一页=
      this.getlist()
    },

通过列表的查询操作，我们就可以把数据获取到，界面就会得到及时的更新显示了

      // 获取列表，绑定到模型上，并修改分页数量
      this.listLoading = true
      user.GetAll(param).then(data => {
        this.list = data.result.items
        this.pageinfo.total = data.result.totalCount
        this.listLoading = false
      })

而列表主要就是在界面使用el-table组件进行展示的了，如下图所示代码。

el-table绑定了对应的数据，并设置好显示的格式以及选择操作事件、行双击事件等操作。

而el-table里面的显示的列，需要根据我们返回数据的属性名称进行显示，如下代码所示。

而如果我们需要对属性进行特殊的展示，我们就需要使用v-if条件或者过滤器进行处理了。如下是根据不同内容，构建标签显示内容。

      <el-table-column align="center" label="账号激活" width="80">
        <template slot-scope="scope">
          <el-tag v-if="scope.row.isActive === true" type="success" effect="dark">已激活</el-tag>
          <el-tag v-else type="danger" effect="dark">未激活</el-tag>
        </template>
      </el-table-column>

而对于时间，我们则可以使用格式化函数或者过滤器规范显示的格式内容。

<el-table-column align="center" label="创建时间" width="120" prop="creationTime" :formatter="dateFormat" />

其中 :formatter="dateFormat" 指定了对应的格式化处理函数。

    dateFormat(row, column, cellValue) {
      // this.parseTime是在main.js中的全局挂载函数
      return cellValue ? this.parseTime(cellValue, '{y}-{m}-{d}') : '' // 完整格式：{y}-{m}-{d} {h}-{i}-{s}
    },
    timeFormat(row, column, cellValue) {
      // this.parseTime是在main.js中的全局挂载函数
      return cellValue ? this.parseTime(cellValue, '{y}-{m}-{d} {h}:{i}:{s}') : '' // 完整格式：{y}-{m}-{d} {h}-{i}-{s}
    }

另外，操作列的代码，主要就是构建一些方法操作的入口，并传递对应的变量，如ID值即可。

      <el-table-column align="center" label="操作" width="190">
        <template scope="scope">
          <el-row>
            <el-tooltip effect="light" content="查看" placement="top-start">
              <el-button icon="el-icon-search" type="success" circle size="mini" @click="showView(scope.row.id)" />
            </el-tooltip>
            <el-tooltip effect="light" content="编辑" placement="top-start">
              <el-button icon="el-icon-edit" type="primary" circle size="mini" @click="showEdit(scope.row.id)" />
            </el-tooltip>
            <el-tooltip effect="light" content="删除" placement="top-start">
              <el-button icon="el-icon-delete" type="danger" circle size="mini" @click="showDelete(scope.row.id)" />
            </el-tooltip>
            <el-tooltip effect="light" content="重置密码" placement="top-start">
              <el-button icon="el-icon-setting" type="warning" circle size="mini" @click="showSetPass(scope.row.id)" />
            </el-tooltip>
          </el-row>
        </template>
      </el-table-column>

列表的底部分页处理，也是利用对应的属性进行显示即可，并处理分页变化的事件。

    <div class="block" style="height:70px;">
      <el-pagination
        :current-page="pageinfo.pageindex"
        :page-size="pageinfo.pagesize"
        :total="pageinfo.total"
        :page-sizes="[10,20,30,40]"
        layout="total, sizes, prev, pager, next"
        @size-change="sizeChange"
        @current-change="currentChange"
      />
    </div>

最后完成列表界面代码，显示列表界面如下所示。

而对于查看、编辑、新增等对话框，一般我们需要创建对应的表单属性，用来承载对应的信息的，如我们为了查看信息的需要，创建一个viewForm的对象，如下所示。

      viewForm: { // 查看表单
        id: '',
        userName: '',
        surname: '',
        name: '',
        emailAddress: '',
        phoneNumber: '',
        ouNames: ''
      },

在查看信息对话框里面，我们展示对应的用户信息，包括基础信息和相关的关系，如下界面代码所示。

界面组件通过v-modal进行绑定对应的ViewForm属性对象即可。

最后，我们在触发showView函数里面，获取对应的用户信息，然后展示在界面上即可，showView函数代码如下所示。

    showView(id) { // 显示查看对话框处理
      var param = { id: id }
      user.Get(param).then(data => {
        // console.log(data.result)
        Object.assign(this.viewForm, data.result);

        this.getOuName(id).then(result => {
          this.viewForm.ouNames = result
        })
      })
      this.getFunctionsByUser(id)

      this.isView = true
    },

查看界面效果如下所示。

在新增或者编辑处理界面中，我们修改了数据，都会提交到ABP后端进行录入或者更新，因此就涉及到数据的回写处理，然后提示客户端状态即可。

下面是保存编辑界面的内容操作。

    saveEdit() { // 保存数据处理
      this.$refs['editForm'].validate(valid => {
        if (valid) {
          // 保存数据
          const form = this.editForm
          user.Update(form).then(data => {
            // console.log(data)
            if (data.success) {
              // 提示信息
              this.msgSuccess('更新成功!')
              // 刷新数据
              this.getlist()
            } else {
              this.msgError('更新失败：' + data.error)
            }

            this.$refs['editForm'].resetFields()
            // 重置窗口状态
            this.closeDialog()
          })
        }
      })
    },