(a) Function

Sets a password for database connection.

(b) Format

 
public void setPassword ( String password ) throws SQLException
 

(c) Arguments

String password

Specifies a password.

If the null value is specified, the current password that had been set by this method is invalidated, and the setting is returned to its initial status.

(d) Return value

None.

(e) Functional detail

Sets a password.

When one of the following methods is executed, the authorization identifier and password that were specified with the setUser and setPassword methods are used in establishing a physical connection to the database:

• getConnection method (no arguments) of the DataSource interface
• getPooledConnection method of the ConnectionPoolDataSource interface
• getXAConnection method of the XADataSource interface

If the password argument is the null value or a character string whose length is 0, the JDBC driver assumes that no password has been set by this method.

For details about how the JDBC driver handles the situation when there is no setting, see 17.11 Connection information priorities.

(f) Exceptions

None.