org.openmrs.web.controller.user

Class ChangePasswordFormController

java.lang.Object

org.openmrs.web.controller.user.ChangePasswordFormController

@Controller
 @RequestMapping(value="/admin/users/changePassword.form")
public class ChangePasswordFormController
extends java.lang.Object

Used for changing the password when the force password change option is set during a new user creation.

Constructor Summary

Constructors

Constructor and Description
ChangePasswordFormController()

Method Summary

Modifier and Type	Method and Description
User	formBackingObject() The model from which the data binding happens on the view
java.lang.String	handleSubmission(javax.servlet.http.HttpSession httpSession, java.lang.String password, java.lang.String confirmPassword, java.lang.String question, java.lang.String answer, java.lang.String confirmAnswer, User user, org.springframework.validation.BindingResult errors) Method to save changes of the new password for a user.
java.lang.String	showForm(javax.servlet.http.HttpSession httpSession) This method will display the change password form

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ChangePasswordFormController

public ChangePasswordFormController()

Method Detail

formBackingObject

@ModelAttribute(value="user")
public User formBackingObject()

The model from which the data binding happens on the view

Returns:

authenticated user

showForm

@RequestMapping(method=GET)
public java.lang.String showForm(javax.servlet.http.HttpSession httpSession)

This method will display the change password form

Parameters:

httpSession - current browser session

Returns:

the view to be rendered

handleSubmission

@RequestMapping(method=POST)
public java.lang.String handleSubmission(javax.servlet.http.HttpSession httpSession,
                                                                      @RequestParam(required=true,value="password")
                                                                      java.lang.String password,
                                                                      @RequestParam(required=true,value="confirmPassword")
                                                                      java.lang.String confirmPassword,
                                                                      @RequestParam(required=false,value="question")
                                                                      java.lang.String question,
                                                                      @RequestParam(required=false,value="answer")
                                                                      java.lang.String answer,
                                                                      @RequestParam(required=false,value="confirmAnswer")
                                                                      java.lang.String confirmAnswer,
                                                                      @ModelAttribute(value="user")
                                                                      User user,
                                                                      org.springframework.validation.BindingResult errors)

Method to save changes of the new password for a user. The password will be validated against the current rules and will display error messages in case the password is not strong enough.

Parameters:

password - to be applied

confirmPassword - confirmation for the password to be applied

question - in case of a forgotten password

answer - answer for the question

confirmAnswer - confirmation of the answer for the question

errors - while processing the form