我的第一个python web开发框架（38）——管理员管理功能

　　后台管理员的管理功能，它主要用来管理后台的登录账号，绑定权限，当然如果想将后台管理扩展成企业相关管理系统，比如用于公司人事管理，在这个基础上进行适当扩展就可以了。

　　我们先看看界面效果（也可以看着数据字典来写页面和接口）

　　看起来功能项还是不少，管理员也可以直接改为员工管理。列表没有什么特别的地方，所以接口也比较简单，不详细讲解。当然你也可以在这个基础上增加一下按姓名、手机、账号、部门和职位等查询条件上去

 @get('/api/system/manager/')
 def callback():
     """
     获取列表数据
     """
     # 页面索引
     page_number = convert_helper.to_int1(web_helper.get_query('page', '', is_check_null=False))
     # 页面页码与显示记录数量
     page_size = convert_helper.to_int0(web_helper.get_query('rows', '', is_check_null=False))
     sidx = web_helper.get_query('sidx', '', is_check_null=False)
     sord = web_helper.get_query('sord', '', is_check_null=False)
     # 初始化排序字段
     order_by = 'id asc'
     if sidx:
         order_by = sidx + ' ' + sord

     _manager_logic = manager_logic.ManagerLogic()
     # 读取记录
     result = _manager_logic.get_list('*', '', page_number, page_size, order_by)
     if result:
         return json.dumps(result, cls=json_helper.CJsonEncoder)
     else:
         return web_helper.return_msg(-1, "查询失败")

　　由于在设计管理员数据表时，字段也有不少，所以我们在管理新增与编辑页面上，可以改为标签分类方式查看，这样会比较容易找到自己想要的东西，而不是全部罗列下来一大堆

　　我们将管理员信息分为基本信息、权限信息和账户安全设置三类，这样看起来会清晰很多。

　　在新增与编辑页面，由于我们的管理员权限需要绑定部门与职位，所以页面上需要增加部门树列表获取与职位列表获取接口的访问，在添加菜单时大家也要记得将这两个调用接口加上，不然等底层权限加上以后，这些页面数据都获取不了。

 @get('/api/system/manager/<id:int>/')
 def callback(id):
     """
     获取指定记录
     """
     _manager_logic = manager_logic.ManagerLogic()
     # 读取记录
     result = _manager_logic.get_model_for_cache(id)
     if result:
         return web_helper.return_msg(0, '成功', result)
     else:
         return web_helper.return_msg(-1, "查询失败")

 @post('/api/system/manager/')
 def callback():
     """
     新增记录
     """
     name = web_helper.get_form('name', '管理员名称')
     sex = web_helper.get_form('sex', '性别', is_check_null=False)
     if sex != '男':
         sex = '女'
     mobile = web_helper.get_form('mobile', '手机号码', is_check_null=False)
     if mobile and not string_helper.is_mobile(mobile):
         return web_helper.return_msg(-1, '手机号码格式不正确')
     birthday = web_helper.get_form('birthday', '出生日期', is_check_null=False)
     if birthday:
         birthday = convert_helper.to_date(birthday)
     email = web_helper.get_form('email', 'email', is_check_null=False)
     if email and not string_helper.is_email(email):
         return web_helper.return_msg(-1, 'Email格式不正确')
     remark = web_helper.get_form('remark', '备注', is_check_null=False)
     department_id = convert_helper.to_int0(web_helper.get_form('department_id', '所属部门'))
     positions_id = convert_helper.to_int0(web_helper.get_form('positions_id', '所属职位'))
     is_work = convert_helper.to_int0(web_helper.get_form('is_work', '工作状态'))
     is_enabled = web_helper.get_form('is_enabled', '是否启用', is_check_null=False)
     login_name = web_helper.get_form('login_name', '登录账号')
     login_password = web_helper.get_form('login_password1', '登录密码', is_check_special_char=False)
     if len(login_password) < 6:
         return web_helper.return_msg(-1, '登录密码长度必须大于等于6位')
     login_password = encrypt_helper.md5(encrypt_helper.md5(login_password)[2:24])

     # 判断提交的部门id是否正确
     _department_logic = department_logic.DepartmentLogic()
     department_result = _department_logic.get_model_for_cache(department_id)
     if not department_result:
         return web_helper.return_msg(-1, '所属部门不存在')
     # 判断提交的职位id是否正确
     _positions_logic = positions_logic.PositionsLogic()
     positions_result = _positions_logic.get_model_for_cache(positions_id)
     if not positions_result or positions_result.get('department_id') != department_id:
         return web_helper.return_msg(-1, '所属职位不存在')

     _manager_logic = manager_logic.ManagerLogic()
     # 组合更新字段
     fields = {
         'name': string(name),
         'sex': string(sex),
         'mobile': string(mobile),
         'email': string(email),
         'remark': string(remark),
         'department_id': department_id,
         'department_code': string(department_result.get('code', '')),
         'department_name': string(department_result.get('name', '')),
         'positions_id': positions_id,
         'positions_name': string(positions_result.get('name', '')),
         'is_work': is_work,
         'is_enabled': is_enabled,
         'login_name': string(login_name),
         'login_password': string(login_password),
     }
     if birthday:
         fields['birthday'] = string(str(birthday))
     # 添加记录
     result = _manager_logic.add_model(fields)
     if result:
         return web_helper.return_msg(0, '成功')
     else:
         return web_helper.return_msg(-1, "提交失败")

 @put('/api/system/manager/<id:int>/')
 def callback(id):
     """
     修改记录
     """
     name = web_helper.get_form('name', '管理员名称')
     sex = web_helper.get_form('sex', '性别', is_check_null=False)
     if sex != '男':
         sex = '女'
     mobile = web_helper.get_form('mobile', '手机号码', is_check_null=False)
     if mobile and not string_helper.is_mobile(mobile):
         return web_helper.return_msg(-1, '手机号码格式不正确')
     birthday = web_helper.get_form('birthday', '出生日期', is_check_null=False)
     if birthday:
         birthday = convert_helper.to_date(birthday)
     email = web_helper.get_form('email', 'email', is_check_null=False)
     if email and not string_helper.is_email(email):
         return web_helper.return_msg(-1, 'Email格式不正确')
     remark = web_helper.get_form('remark', '备注', is_check_null=False)
     department_id = convert_helper.to_int0(web_helper.get_form('department_id', '所属部门'))
     positions_id = convert_helper.to_int0(web_helper.get_form('positions_id', '所属职位'))
     is_work = web_helper.get_form('is_work', '工作状态')
     is_enabled = web_helper.get_form('is_enabled', '是否启用', is_check_null=False)
     login_name = web_helper.get_form('login_name', '登录账号')
     login_password1 = web_helper.get_form('login_password1', '新密码', is_check_null=False, is_check_special_char=False)
     # 判断用户是否修改密码
     if login_password1:
         if len(login_password1) < 6:
             return web_helper.return_msg(-1, '新密码长度必须大于等于6位')
         login_password1 = encrypt_helper.md5(encrypt_helper.md5(login_password1)[2:24])

     # 判断提交的部门id是否正确
     _department_logic = department_logic.DepartmentLogic()
     department_result = _department_logic.get_model_for_cache(department_id)
     if not department_result:
         return web_helper.return_msg(-1, '所属部门不存在')
     # 判断提交的职位id是否正确
     _positions_logic = positions_logic.PositionsLogic()
     positions_result = _positions_logic.get_model_for_cache(positions_id)
     if not positions_result or positions_result.get('department_id') != department_id:
         return web_helper.return_msg(-1, '所属职位不存在')

     _manager_logic = manager_logic.ManagerLogic()
     result = _manager_logic.get_model_for_cache(id)
     if not result:
         return web_helper.return_msg(-1, '管理员账号不存在')

     # 组合更新字段
     fields = {
         'name': string(name),
         'sex': string(sex),
         'mobile': string(mobile),
         'email': string(email),
         'remark': string(remark),
         'department_id': department_id,
         'department_code': string(department_result.get('code', '')),
         'department_name': string(department_result.get('name', '')),
         'positions_id': positions_id,
         'positions_name': string(positions_result.get('name', '')),
         'is_work': is_work,
         'is_enabled': is_enabled,
         'login_name': string(login_name),
     }
     if birthday:
         fields['birthday'] = string(str(birthday))
     if login_password1:
         fields['login_password'] = string(login_password1)
     # 修改记录
     result = _manager_logic.edit_model(id, fields)
     if result:
         return web_helper.return_msg(0, '成功', result)
     else:
         return web_helper.return_msg(-1, "提交失败")

　　这里有三个接口，第一个是管理员记录实体获取接口，用于编辑管理员时，要先从接口读取管理员的相关信息。

　　第二个是新增管理员接口，代码看起来很多，其实有一半是处理AJAX提交上来的数据的，大家如果熟悉common工具函数的话，会觉得这些代码非常熟悉，可以直接阅读，当然如果你对工具函数不熟的话，看起来可能会有点蒙，所以说要学好一个陌生框架，最好先熟悉它的工具函数有什么功能。前面让大家一定要反复使用单元测试和手打代码，就是让大家能更容易熟悉这些函数，在后面查看代码时一点都不会吃力。

　　第三个是编辑管理员信息接口，代码同新增接口只有很小的差别。

　　然后是删除接口，在删除管理员时，我们需要做个限制，判断它是否在职，在职的不能直接删除，以避免误操作。对于管理员账号，如果离职了，最好不要删除，可以留着有需要时查询，当然如果离职员工很多，相关人员又有强迫症不想查看到的话，可以将管理员管理分为两部分（两个单独的页面），一个是在职员工管理，一个是离职页面管理。

 @delete('/api/system/manager/<id:int>/')
 def callback(id):
     """
     删除指定记录
     """
     _manager_logic = manager_logic.ManagerLogic()
     # 删除记录
     result = _manager_logic.get_model_for_cache(id)
     if result:
         # 未离职管理员不能直接删除
         if result.get('is_work') == 1:
             return web_helper.return_msg(-1, '未离职管理员不能直接删除')

         result = _manager_logic.delete_model(id)
         if result:
             return web_helper.return_msg(0, '删除成功')

     return web_helper.return_msg(-1, "删除失败")

　　除了增改删之外，对于管理员来说还会存在离职和复职的情况，所以我们还需要这两个接口，它们相对来说比较简单，离职就是将管理员的账号状态和工作状态都设置为false，复职就将它们改为true就可以了

　　可能有人会问，为什么还要增加工作状态和账号状态，用一个来管理不就可以了。如果后台管理系统做的简单的话，一个账号状态就够用了，如果将它拿来管理员工的话，有可能会出现有的员工在职中，但不给它登录系统，所以就需要两个不同的状态来进行管理。

 @put('/api/system/manager/<id:int>/dimission/')
 def callback(id):
     """
     设置用户离职
     """
     _manager_logic = manager_logic.ManagerLogic()
     fields = {
         'is_work': False,
         'is_enabled': False,
     }
     # 读取记录
     result = _manager_logic.edit_model(id, fields)
     if result:
         return web_helper.return_msg(0, '成功')
     else:
         return web_helper.return_msg(-1, "管理员不存在")

 @put('/api/system/manager/<id:int>/reinstated/')
 def callback(id):
     """
     设置用户复职
     """
     _manager_logic = manager_logic.ManagerLogic()
     # 读取记录
     result = _manager_logic.get_model_for_cache(id)
     if result:
         if result.get('is_work'):
             return web_helper.return_msg(-1, '该管理员工作状态正常，不需要复职')

         fields = {
             'is_work': True,
             'is_enabled': True,
         }
         # 读取记录
         result = _manager_logic.edit_model(id, fields)
         if result:
             return web_helper.return_msg(0, '成功')

     return web_helper.return_msg(-1, "管理员不存在")

　　完成以上代码后，记得在菜单管理中添加对应的菜单项哦。

　　本文对应的源码下载 

版权声明：本文原创发表于 博客园，作者为 AllEmpty 本文欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则视为侵权。

python开发QQ群：669058475（本群已满）、733466321（可以加2群）    作者博客：http://www.cnblogs.com/EmptyFS/