com.sap.conn.jco.ext
Interface PasswordChangeHandler


public interface PasswordChangeHandler

This interface allows the implementation of a handler that prompts the user for a new password, which is then used for This is useful if a UI is available, and the password in the backend for the designated user is supposed to be changed before working with the user. This is e.g. the case when the password is initial. In such a case JCo will invoke the promptPassword method for the registered password handler. If no such handler is present, the confguration parameter DestinationDataProvider.JCO_DENY_INITIAL_PASSWORD is evaluated whether the processing should continue normally or an exception shall be thrown.

See Also:
Environment.registerPasswordChangeHandler(com.sap.conn.jco.ext.PasswordChangeHandler), Environment.removePasswordChangeHandler(com.sap.conn.jco.ext.PasswordChangeHandler)

Method Summary
 java.lang.String[] promptPassword(JCoDestination destination, java.lang.Exception previous)
          Will be invoked if a password is recognized as initial and hence needs an update.
 

Method Detail

promptPassword

java.lang.String[] promptPassword(JCoDestination destination,
                                  java.lang.Exception previous)
Will be invoked if a password is recognized as initial and hence needs an update.

Parameters:
destination - the destination, for which the password needs to be updated
previous - null in the first invocation, otherwise an exception describing why the last invocation or the post-processing steps failed, e.g. like the password change itself
Returns:
array alement 0 old password, element 1 new password, if null is returned, the password change will be cancelled


Copyright © 2008-2014 SAP AG. All Rights Reserved.