用户管理详细设计文档(11-12)

26/264.功能模块详细设计对系统功能模块的实现进行定义。4.3用户管理模4.3.11新建员工用户（用例编号-ESM-YHGL-1）基本事件流实现步骤说明：SuperUser在FindImployee.jsp页面，此时系统将所有的员工信息显示在员工信息列表，SuperUser选中需要创建的用户（点击员工前的checkbox），点击创建用户。InputImage.jsp的创建请求提交到UserQueryAction进行处理。请求信息封装到了UserQueryForm对象中，通过excute方法传递到UserQueryAction。UserQueryAction调用UserOperator对象的doInsert方法通过UserDAO调用Hibernate框架完成数据插入。处理完成后，UserDAO将传递一个boolean值回到UserQueryAction，如果为true，那么在UserQueryAction中调用respons方法，返回FindUser.jsp页面。异常事件流实现步骤说明：SuperUser在InputImage.jsp页面输入信息后，点击“创建”。InputImage.jsp的新建请求提交到UserQueryAction进行处理。请求信息封装到了UserQueryForm对象中，传递到UserQueryAction。UserQueryAction调用UserOperator对象的save方法通过UserDAO处理新建请求。UserDAO在数据插入时遇到了系统异常，例如用户已经存在、数据库无法连接，则save方法抛出SysException对象，SysException对象存储代表系统异常信息。UserDAO收到SysException对象后，抛给UserQueryAction。UserQueryAction收到SysException后，将异常信息封装到Struts的Error对象中，然后添加到Struts的Error集合中。InputImage.jsp页面显示Error集合中的错误信息。2用户登录模块（用例编号-ESM-YHGL-2）基本事件流实现步骤说明用户(此模块中包括SuperUser、User、SM和Manage)进入index.jsp页面，并根据页面内容填写，填写完成后，点击“登录”。index.jsp将请求登录信息提交到UserQueryAction，信息被封装到EntryForm中，通过excute传递到UserQueryAction。UserQueryAction调用UserOperator内的doEntry方法通过UserDAO调用Hibernate框架完成数据的匹配当数据匹配返回值为true时，UserOperator将true值返回给UserQueryAction，UserQueryAction调用response方法进入kuangjia.jsp页面，登录完成。其它事件流1实现用户在index.html页面选择“重置”，index.html使用reset脚本清空用户输入的用户名和密码。异常事件流实现 1、用户在index.html页面输入信息后，点击“登录”。2、index.html的登录请求提交到UserQueryAction进行处理。请求信息封装到了UserQueryForm对象中，传递到UserQueryAction。3、UserQueryAction调用UserOperator对象处理登录请求。调用UserOperator对象的doEntry方法。UserOperator调用UserDAO执行数据匹配。4、UserDAO在执行数据匹配时遇到了系统异常，例如用户已经或密码错误、数据库无法连接，则equals方法抛出SysException对象，SysException对象存储代表系统异常信息。5、UserDAO收到SysException对象后，抛给UserQueryAction。6、UserQueryAction收到SysException后，将异常信息封装到Struts的Error对象中，然后添加到Struts的Erros集合中。7、kuangjia.jsp页面显示Errors集合中的错误信息。3、修改密码模块基本事件流实现步骤说明用户(此模块中包括SuperUser、User、SM和Manage)进入kuangjia.jsp页面，点击“更改密码”进入ChangePwd.jsp页面，并根据页面内容填写，填写完成后，点击“创建”。ChangePwd.jsp将请求修改密码信息提交到UserQueryAction，UserQueryAction将信息封装到UserQueryForm中，传递到UserQueryAction。首先UserQueryAction调用UserOperator内的doChangePwd方法验证用户名和密码。UserOperator调用UserDAO来完成数据的匹配。当UserDAO匹配完数据完成后，将信息返回给UserQueryAction，UserQueryAction调用UserOperator对象的doUpdate方法来处理密码的更新。UserOperator的doUpdate方法通过UserDAO调用Hibernate框架完成密码的更新。当数据更新完后，UserOperator将信息返回给UserQueryAction，UserQueryAction调用response方法进入ChangePwdOk.jsp页面，点击确定按钮，返回到ChangePwd.jsp页面。其它事件流1实现用户在ChangePwd.jsp页面选择“取消”，ChangePwd.jsp使用reset清空用户输入的信息。异常事件流实现1、用户在ChangePwd.jsp页面输入信息后，点击“创建”。2、ChangePwd.jsp的密码更新请求提交到UserQueryAction进行处理。请求信息封装到了UserQueryForm对象中，传递到UserQueryAction。3、UserQueryAction调用UserOperator对象处理密码修改请求。调用UserOperator对象的doChangeForm方法。UserOperator调用UserDAO执行数据匹配。4、UserDAO在执行数据匹配时遇到了系统异常，例如用户名和旧密码不匹配、两次输入的密码不一致、数据库无法连接，则equals方法抛出SysException对象，SysException对象存储代表系统异常信息。5、UserDAO收到SysException对象后，抛给UserQueryAction。6、UserQueryAction收到SysException后，将异常信息封装到Struts的Error对象中，然后添加` 到Struts的Erros集合中。7、ChangePwd.jsp页面显示Errors集合中的错误信息。4、更新用户模块基本事件流实现1、SuperUser进入kuangjia.jsp页面，点击“用户管理”，下拉菜单出现“更新用户角色”并且点击，页面跳转至FindUser.jsp页面中。2、SuperUser在用户名、姓名、联系电话和邮件帐号四项中任意中输入一项或者几项，点击“提交”,FindUser.jsp将请求提交到UserQueryAction进行处理。请求信息封装到了UserQueryForm对象中，传递到UserQueryAction。3、UserQueryAction执行execute方法调用UserOperator对象处理查询请求，UserOperator使用doFind方法并且连接UserDAO执行查找。4、UserDAO的doFind方法调用Hibernate框架完成数据库查询。find方法返回java.util.List对象，List对象存储代表用户信息的UserInfo对象。UserOperator的find方法执行完成后，将得到的结果集存储到UserQueryForm传递给UserQueryAction然后提交到FindUser.jsp页面，FindUser.jsp页面从UserQueryForm中读取查询结果，显示查询结果。6、当FindUser.jsp中的“用户信息列表”显示出用户的信息，SuperUser可以点击实例前面的“checkbox”按钮框选中需要更新的用户，并点击“更新角色”，FindUser.jsp将请求信息传递到UserQueryAction进行处理，UserQueryAction内的response方法将页面跳转到changUser.jsp页面。7、在changUser.jsp页面中选择需要变更的类型，点击用户角色前的“checkbox”复选框，并点击“提交”。8、changUser.jsp将请求信息提交到UserQueryAction进行处理。请求信息被封装到UserQueryForm中，传递回UserQueryAction。9、UserQueryAction调用UserOperator对象的doUpdate方法处理更新请求，连接UserDAO对用户的角色类型进行更新。10、UserOperator的doUpdate方法通过UserDAO调用Hibernate框架完成用户的更新。11、当数据更新完后，UserOperator将信息返回给UserQueryAction，UserQueryAction调用response方法进入changeUserOk.jsp页面，点击确定按钮，返回到FindUser.jsp页面。其它事件流1实现SuperUser在第2步提交查询用户信息时，可以不填写任务一项内容，直接点击提交，此时FindUser.jsp页面将清求发送给UserQueryAction进行处理，信息将封装到UserQueryForm中，传递回UserQueryAction，此时UserQueryAction调用UserOperator内的doFind方法，并通过UserDAO和数据库连接完成数据查询，UserDAO.find将得到的信息返回给java.util.List对象存储代表用户信息的Hibernate持久对象UserInfo中，UserOperator将得到的信息存储在UserQueryForm中传递给UserQueryAction然后提交到FindUser.jsp页面，FindUser.jsp页面通过UserQueryAction找到List读取所有用户的信息，此时SU可以点击多少复选框一次性对多个用户进行更新角色。异常事件流实现 步骤说明：1、用户在FindUser.jsp页面输入信息后，点击“提交”。2、FindUser.jsp的查询用户请求提交到UserQueryAction进行处理。请求信息封装到了UserQueryForm对象中，传递到UserQueryAction。3、UserQueryAction执行execute方法调用UserOperator对象处理查询请求，UserOperator使用find方法并且连接UserDAO执行查找。4、UserDAO在查询数据时遇到了系统异常，例如数据库无法连接，则find方法抛出SysException对象，SysException对象存储代表系统异常信息。5、UserDAO收到SysException对象后，抛给UserQueryAction。6、UserDAO收到SysException后，将异常信息封装到Struts的Error对象中，然后添加到Struts的Erros集合中。7、FindUser.jsp页面显示Errors集合中的错误信息。8、当跳转至changUser.jsp页面时,选择用户角色类型后点击“提交”，请求信息被封装到UserQueryForm传递给UserQueryAction，并通过UserOperator的update方法连接UserDAO，UserDAO在连接数据库时遇到了系统异常，例如数据库无法连接，则update将抛出SysException对象，SysException对象存储代表系统异常信息，UserDAO收到SysException后，将异常信息封装到Struts的Error对象中，然后添加到Struts的Erros集合中。此时changUser.jsp通过UserQueryAction从Error集合中读取错误信息。5、删除用户模块基本事件流实现 1、SuperUser进入kuangjia.jsp页面，点击“用户管理”，下拉菜单出现“删除用户”并且点击，页面跳转至FindUser.jsp页面中。2、SuperUser在用户名、姓名、联系电话和邮件帐号四项中任意中输入一项或者几项，点击“提交”,FindUser.jsp将请求提交到UserQueryAction进行处理。请求信息封装到了UserQueryForm对象中，传递到UserQueryAction。3、UserQueryAction执行execute方法调用UserOperator对象处理查询请求，UserOperator使用find方法并且连接UserDAO执行查找。4、UserDAO的doFind方法调用Hibernate框架完成数据库查询。doFind方法返回java.util.List对象，List对象存储代表用户信息的UserInfo对象。5、UserOperator的doFind方法执行完成后，将得到的结果集存储到UserQueryForm传递给UserQueryAction然后提交到FindUser.jsp页面，FindUser.jsp页面从UserQueryForm中读取查询结果，显示查询结果。6、当FindUser.jsp中的“用户信息列表”显示出用户的信息，SuperUser可以点击实例前面的“checkbox”按钮框选中需要删除的用户，并点击“删除”，FindUser.jsp将请求信息传递到UserQueryAction进行处理。请求信息被封装到UserQueryForm中，传递回UserQueryAction。9、UserQueryAction调用UserOperator对象的doDelete方法处理删除请求，连接UserDAO对用户进行删除。10、通过UserDAO调用Hibernate框架完成用户的更新。11、当数据在数据库删除完成后，UserOperator将信息返回给UserQueryAction，UserQueryAction调用response方法进入DeleteUserOk.jsp页面（显示删除用户成功！），点击确定按钮，返回到FindUser.jsp页面。其它事件流1实现SuperUser在第2步提交查询用户信息时，可以不填写任务一项内容，直接点击提交，此时FindUser.jsp页面将清求发送给UserQueryAction进行处理，信息将封装到UserQueryForm中，传递回UserQueryAction，此时UserQueryAction调用UserOperator内的doFind方法，并通过UserDAO和数据库连接完成数据查询，UserDAO.find将得到的信息返回给java.util.List对象存储代表用户信息的Hibernate持久对象UserInfo中，UserOperator将得到的信息存储在UserQueryForm中传递给UserQueryAction然后提交到FindUser.jsp页面，FindUser.jsp页面通过UserQueryAction找到List读取所有用户的信息，此时SuperUser可以点击多少复选框一次性对多个用户进行删除操作。异常事件流实现 步骤说明：1、用户在FindUser.jsp页面输入信息后，点击“提交”。2、FindUser.jsp的查询用户请求提交到FindUserAction进行处理。请求信息封装到了UserQueryForm对象中，传递到UserQueryAction。3、UserQueryAction执行execute方法调用UserOperator对象处理查询请求，UserOperator使用doFind方法并且连接UserDAO执行查找。4、UserDAO在查询数据时遇到了系统异常，例如数据库无法连接，则doFind方法抛出SysException对象，SysException对象存储代表系统异常信息。5、UserDAO收到SysException对象后，抛给UserQueryAction。6、UserDAO收到SysException后，将异常信息封装到Struts的Error对象中，然后添加到Struts的Erros集合中。7、FindUser.jsp页面显示Errors集合中的错误信息。6、查询用户模块基本事件流实现1、SuperUser进入kuangjia.jsp页面，点击“用户管理”，下拉菜单出现“查询员工用户”并且点击，页面跳转至FindUser.jsp页面中。2、SuperUser在用户名、姓名、联系电话和邮件帐号四项中任意中输入一项或者几项，点击“提交”,FindUser.jsp将请求提交到UserQueryAction进行处理。请求信息封装到了UserQueryForm对象中，传递到UserQueryAction。3、UserQueryAction执行execute方法调用UserOperator对象处理查询请求，UserOperator使用doFind方法并且连接UserDAO执行查找。4、UserDAO的doFind方法调用Hibernate框架完成数据库查询。doFind方法返回java.util.List对象，List对象存储代表用户信息的UserInfo对象。5、UserOperator的doFind方法执行完成后，将得到的结果集存储到UserQueryForm传递给UserQueryAction然后提交到FindUser.jsp页面，FindUser.jsp页面从UserQueryForm中读取查询结果，显示查询结果。其它事件流1实现用户在FindUser.jsp页面选择“重置”，FindUser.jsp使用reset清空用户输入的信息。其它事件流2实现SuperUser在第2步提交查询用户信息时，可以不填写任务一项内容，直接点击提交，此时FindUser.jsp页面将清求发送给UserQueryAction进行处理，信息将封装到UserQueryForm中，传递回UserQueryAction，此时UserQueryAction调用UserOperator内的doFind方法，并通过UserDAO和数据库连接完成数据查询，UserDAO.find将得到的信息返回给java.util.List对象存储代表用户信息的Hibernate持久对象UserInfo中，UserOperator将得到的信息存储在UserQueryForm中传递给UserQueryAction然后提交到FindUser.jsp页面，FindUser.jsp页面通过UserQueryAction找到List读取所有用户的信息，显示在用户信息列表中。异常事件流实现 步骤说明：1、用户在FindUser.jsp页面输入信息后，点击“提交”。2、FindUser.jsp的查询用户请求提交到UserQueryAction进行处理。请求信息封装到了UserQueryForm对象中，传递到UserQueryAction。3、UserQueryAction执行execute方法调用UserOperator对象处理查询请求，UserOperator使用find方法并且连接UserDAO执行查找。4、UserDAO在查询数据时遇到了系统异常，例如数据库无法连接，则find方法抛出SysException对象，SysException对象存储代表系统异常信息。5、UserDAO收到SysException对象后，抛给UserQueryAction。6、UserDAO收到SysException后，将异常信息封装到Struts的Error对象中，然后添加到Struts的Erros集合中。7、FindUser.jsp页面显示Errors集合中的错误信息。2.1此功能模块的类图4.3.21、jsp页面说明 1.1登录页面JSP页面说明页面名称index.jsp功能简述用户登录表单定义编号表单成员说明ActionURL说明1input:textuserIdinput:textpasswordhtml:submithtml:reset/UserQueryAction提交登录信息到URL：UserQueryAction进行处理页面外观（用户登录页面） 1．2查询用户界面JSP页面说明页面名称FindUser.jsp功能简述查询用户，删除用户，更新角色表单定义编号表单成员说明ActionURL说明11、input:textname2、input:textuserId4、input:testtelephone5、input:textmailInfo6、html:submit7、html:reset/UserQueryActionn提交查询用户信息到URL：UserQueryAction进行处理页面外观1．3修改密码页面JSP页面说明页面名称ChangePwd.jsp功能简述修改密码表单定义编号表单成员说明ActionURL说明11、input:textuserId2、input:textpassword3、input:textNewPwd4、html:submit5、html:reset/UserQueryAction提交密码修改信息到URL：UserQueryAction进行处理页面外观1．4更新用户页面JSP页面说明页面名称ChangeUser.jsp功能简述更新用户表单定义编号表单成员说明ActionURL说明11、checkbox:普通用户2、checkbox:经理3、checkbox:薪酬管理专员4、checkbox:超级用户/UserQueryAction提交密码修改信息到URL：UserQueryAction进行处理页面外观2UserQueryForm类名称UserQueryForm所属包名称org.qh.view类功能描述持久层的DTO.类静态变量定义名称类型描述无无无类变量定义(先public->protected->private)名称类型描述userIdStringprivatenameStringprivatePasswordStringprivatenewTypeStringprivatenewPwdStringprivatefirstTelephoneStringprivatesecondTelephoneStringprivatemailInfoStringprivateaddressStringprivate方法(先public->protected->private)方法声明参数说明返回值说明方法简单描述publicvoidsetName(Stringname)name：姓名无返回值设置姓名publicStringgetName()无参数返回String类型返回姓名publicvoidsetUserId(StringuserId)userId：用户名无返回值设置用户名publicStringgetUserId()无参数返回String类型返回用户名publicvoidsetPwd(Stringpassword)password：密码无返回值设置密码publicStringgetPwd()无参数返回String类型返回密码publicvoidsetNewType(checkboxnewType)newType：用户角色类型无返回值设置用户角色类型publicStringgetNewType()无参数返回checkbox类型返回用户角色类型publicvoidsetNewPwd(StringnewPwd)newPwd:新密码无返回值设置用户新密码publicStringgetNewPwd()无参数返回String类型返回新密码publicvoidsetFirstTel(StringfirstTelephone)firstTelephone:电话号码1无返回值设置用户电话号码1publicStringgetFirstTel()无参数返回String类型返回用户电话号码1publicvoidsetScondTel(StringfirstTelephone)secondTelephone:电话号码2无返回值设置用户电话号码2publicStringgetScondTel()无参数返回String类型返回用户电话号码2publicvoidsetMailInfo(StringmailInfo)mailInfo:邮件帐号无返回值设置用户邮件帐号publicStringgetMailInfo()无参数返回String类型返回用户邮件帐号publicvoidsetAddress(Stringaddress)address:联系地址无返回值设置用户联系地址publicStringgetAddress()无参数返回String类型返回用户联系地址

3 UserQueryAciton类类名称UserQueryAction所属包名称org.qh.view类功能描述处理相关jsp页面的请求，并关联业务层做数据处理类静态变量定义名称类型描述无无无类变量定义(先Public->protected->private)名称类型描述OperatorUserOperatorprivate方法(先Public->protected->private)方法声明参数说明返回值说明方法简单描述publicActionForwardexecute(ActionMappingactionMapping,ActionFormactionForm,HttpServletRequestrequest,HttpServletResponseresponse)无返回ActionForward类型控制整个业务流程的走向privateActionForwarddoInsert(ActionMappingactionMapping,ActionFormactionForm,HttpServletRequestrequest,HttpServletResponseresponse)无返回ActionForward类型控制新建员工用户业务流程的走向privateActionForwarddoDelete(ActionMappingactionMapping,ActionFormactionForm,HttpServletRequestrequest,HttpServletResponseresponse)无返回ActionForward类型控制删除用户业务流程的走向privateActionForwarddoUpdate(ActionMappingactionMapping,ActionFormactionForm,HttpServletRequestrequest,HttpServletResponseresponse)无返回ActionForward类型控制更新用户业务流程的走向privateActionForwarddoFind(ActionMappingactionMapping,ActionFormactionForm,HttpServletRequestrequest,HttpServletResponseresponse)无返回ActionForward类型控制查询用户业务流程的走向privateActionForwarddoEntry(ActionMappingactionMapping,ActionFormactionForm,HttpServletRequestrequest,HttpServletResponseresponse)无返回ActionForward类型控制用户登录流程的走向业务层说明本部分主要定义本模块中业务层的类。1、UserOperator类类名称UserOperator所属包名称类功能描述封装业务逻辑，处理表示层的数据并将持久层的数据通过DTO传递给表示层。类静态变量定义名称类型描述无无无类变量定义(先Public->protected->private)名称类型描述无无无方法(先Public->protected->private)方法声明参数说明返回值说明方法简单描述publicbooleanequals(UserInfouserInfo)userInfo：业务层DTO返回boolean类型从表示层获得用户名和密码信息，并将数据发送到数据库，完成两者的匹配publicbooleaninsert(UserInfouserInfo)userInfo：业务层DTO返回boolean类型从表示层获得新用户的信息，并将数据保存到数据库，完成新建员工用户publicbooleanupdate(UserInfouserInfo)userInfo：业务层DTO返回boolean类型从表示层获得用户的新密码和用户角色，并将数据库的数据进行更新，完成修改密码和更新用户角色publicbooleandelete(UserInfouserInfo)userInfo：业务层DTO返回boolean类型从表示层获得删除用户信息，并将数据库的数据删除，完成删除用户。publicList[]getAllList()无返回java.util.List数组类型查找数据库所有岗位信息，完成查询所有岗位的业务2.组织机构业务层DTO类-UserInfo类名称UserInfo所属包名称类功能描述业务层的DTO.类静态变量定义名称类型描述无无无类变量定义(先public->protected->private)名称类型描述userIdStringprivatenameStringprivatePasswordStringprivatenewTypeStringprivatenewPwdStringprivatefirstTelephoneStringprivatesecondTelephoneStringprivatemailInfoStringprivateaddressStringprivate方法(先public->protected->private)方法声明参数说明返回值说明方法简单描述publicvoidsetName(Stringname)name：姓名无返回值设置姓名publicStringgetName()无参数返回String类型返回姓名publicvoidsetUserId(StringuserId)userId：用户名无返回值设置用户名publicStringgetUserId()无参数返回String类型返回用户名publicvoidsetPwd(Stringpassword)password：密码无返回值设置密码publicStringgetPwd()无参数返回String类型返回密码publicvoidsetNewType(checkboxnewType)newType：用户角色无返回值设置用户角色publicStringgetNewType()无参数返回checkbox类型返回用户角色publicvoidsetNewPwd(StringnewPwd)newPwd:新密码无返回值设置用户新密码publicStringgetNewPwd()无参数返回String类型返回新密码publicvoidsetFirstTel(StringfirstTelephone)firstTelephone:电话号码1无返回值设置用户电话号码1publicStringgetFirstTel()无参数返回String类型返回用户电话号码1publicvoidsetScondTel(StringfirstTelephone)secondTelephone:电话号码2无返回值设置用户电话号码2publicStringgetScondTel()无参数返回String类型返回用户电话号码2publicvoidsetMailInfo(StringmailInfo)mailInfo:邮件帐号无返回值设置用户邮件帐号publicStringgetMailInfo()无参数返回String类型返回用户邮件帐号publicvoidsetAddress(Stringaddress)address:联系地址无返回值设置用户联系地址publicStringgetAddress()无参数返回String类型返回用户联系地址数据层说明本部分主要定义本模块用到的数据处理相关类。1．用户管理数据操作基础类-DaoBase类名称DaoBase所属包名称org.qh.dao类功能描述为Dao类提供Session对象类静态变量定义名称类型描述无无无类变量定义(先public->protected->private)名称类型描述sessionSessionprivate方法(先public->protected->private)方法声明参数说明返回值说明方法简单描述protectedSessiongetSession()无返回Session类型返回Session对象用户管理数据操作类-UserDAO类名称UserDAO所属包名称org.qh.dao类功能描述处理业务层提交的数据，并将数据库相关信息返回给业务层。类静态变量定义名称类型描述无无无类变量定义(先public->protected->private)名称类型描述无无无方法(先public->protected->private)方法声明参数说明返回值说明方法简单描述publicbooleaninsert(Useruser)user：持久层DTO返回boolean类型从业务层获得新建员工用户信息，并将数据保存到数据库，完成新建员工用户的持久操作。publicbooleandelete(Positiouser)user：持久层DTO返回boolean类型从业务层获得员工用户信息，并将数从据数据库删除，完成删除员