org.jivesoftware.smack

Class AccountManager

java.lang.Object

org.jivesoftware.smack.Manager

org.jivesoftware.smack.AccountManager

public class AccountManager
extends Manager

Allows creation and management of accounts on an XMPP server.

Method Summary

Methods

Modifier and Type	Method and Description
void	changePassword(java.lang.String newPassword) Changes the password of the currently logged-in account.
void	createAccount(java.lang.String username, java.lang.String password) Creates a new account using the specified username and password.
void	createAccount(java.lang.String username, java.lang.String password, java.util.Map<java.lang.String,java.lang.String> attributes) Creates a new account using the specified username, password and account attributes.
void	deleteAccount() Deletes the currently logged-in account from the server.
java.lang.String	getAccountAttribute(java.lang.String name) Returns the value of a given account attribute or null if the account attribute wasn't found.
java.util.Collection<java.lang.String>	getAccountAttributes() Returns an unmodifiable collection of the names of the required account attributes.
java.lang.String	getAccountInstructions() Returns the instructions for creating a new account, or null if there are no instructions.
static AccountManager	getInstance(XMPPConnection connection) Returns the AccountManager instance associated with a given XMPPConnection.
boolean	supportsAccountCreation() Returns true if the server supports creating new accounts.

Methods inherited from class org.jivesoftware.smack.Manager

connection, schedule

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static AccountManager getInstance(XMPPConnection connection)

Returns the AccountManager instance associated with a given XMPPConnection.

Parameters:

connection - the connection used to look for the proper ServiceDiscoveryManager.

Returns:

the AccountManager associated with a given XMPPConnection.

supportsAccountCreation

public boolean supportsAccountCreation()
                                throws SmackException.NoResponseException,
                                       XMPPException.XMPPErrorException,
                                       SmackException.NotConnectedException

Returns true if the server supports creating new accounts. Many servers require that you not be currently authenticated when creating new accounts, so the safest behavior is to only create new accounts before having logged in to a server.

Returns:

true if the server support creating new accounts.

Throws:

XMPPException.XMPPErrorException

SmackException.NoResponseException

SmackException.NotConnectedException

getAccountAttributes

public java.util.Collection<java.lang.String> getAccountAttributes()
                                                            throws SmackException.NoResponseException,
                                                                   XMPPException.XMPPErrorException,
                                                                   SmackException.NotConnectedException

Returns an unmodifiable collection of the names of the required account attributes. All attributes must be set when creating new accounts. The standard set of possible attributes are as follows:

• name -- the user's name.
• first -- the user's first name.
• last -- the user's last name.
• email -- the user's email address.
• city -- the user's city.
• state -- the user's state.
• zip -- the user's ZIP code.
• phone -- the user's phone number.
• url -- the user's website.
• date -- the date the registration took place.
• misc -- other miscellaneous information to associate with the account.
• text -- textual information to associate with the account.
• remove -- empty flag to remove account.

Typically, servers require no attributes when creating new accounts, or just the user's email address.

Returns:

the required account attributes.

Throws:

XMPPException.XMPPErrorException

SmackException.NoResponseException

SmackException.NotConnectedException

getAccountAttribute

public java.lang.String getAccountAttribute(java.lang.String name)
                                     throws SmackException.NoResponseException,
                                            XMPPException.XMPPErrorException,
                                            SmackException.NotConnectedException

Returns the value of a given account attribute or null if the account attribute wasn't found.

Parameters:

name - the name of the account attribute to return its value.

Returns:

the value of the account attribute or null if an account attribute wasn't found for the requested name.

Throws:

XMPPException.XMPPErrorException

SmackException.NoResponseException

SmackException.NotConnectedException

getAccountInstructions

public java.lang.String getAccountInstructions()
                                        throws SmackException.NoResponseException,
                                               XMPPException.XMPPErrorException,
                                               SmackException.NotConnectedException

Returns the instructions for creating a new account, or null if there are no instructions. If present, instructions should be displayed to the end-user that will complete the registration process.

Returns:

the account creation instructions, or null if there are none.

Throws:

XMPPException.XMPPErrorException

SmackException.NoResponseException

SmackException.NotConnectedException

createAccount

public void createAccount(java.lang.String username,
                 java.lang.String password)
                   throws SmackException.NoResponseException,
                          XMPPException.XMPPErrorException,
                          SmackException.NotConnectedException

Creates a new account using the specified username and password. The server may require a number of extra account attributes such as an email address and phone number. In that case, Smack will attempt to automatically set all required attributes with blank values, which may or may not be accepted by the server. Therefore, it's recommended to check the required account attributes and to let the end-user populate them with real values instead.

Parameters:

username - the username.

password - the password.

Throws:

XMPPException.XMPPErrorException

SmackException.NoResponseException

SmackException.NotConnectedException

createAccount

public void createAccount(java.lang.String username,
                 java.lang.String password,
                 java.util.Map<java.lang.String,java.lang.String> attributes)
                   throws SmackException.NoResponseException,
                          XMPPException.XMPPErrorException,
                          SmackException.NotConnectedException

Creates a new account using the specified username, password and account attributes. The attributes Map must contain only String name/value pairs and must also have values for all required attributes.

Parameters:

username - the username.

password - the password.

attributes - the account attributes.

Throws:

XMPPException.XMPPErrorException - if an error occurs creating the account.

SmackException.NoResponseException - if there was no response from the server.

SmackException.NotConnectedException

See Also:

getAccountAttributes()

changePassword

public void changePassword(java.lang.String newPassword)
                    throws SmackException.NoResponseException,
                           XMPPException.XMPPErrorException,
                           SmackException.NotConnectedException

Changes the password of the currently logged-in account. This operation can only be performed after a successful login operation has been completed. Not all servers support changing passwords; an XMPPException will be thrown when that is the case.

Throws:

java.lang.IllegalStateException - if not currently logged-in to the server.

XMPPException.XMPPErrorException - if an error occurs when changing the password.

SmackException.NoResponseException - if there was no response from the server.

SmackException.NotConnectedException

deleteAccount

public void deleteAccount()
                   throws SmackException.NoResponseException,
                          XMPPException.XMPPErrorException,
                          SmackException.NotConnectedException

Deletes the currently logged-in account from the server. This operation can only be performed after a successful login operation has been completed. Not all servers support deleting accounts; an XMPPException will be thrown when that is the case.

Throws:

java.lang.IllegalStateException - if not currently logged-in to the server.

XMPPException.XMPPErrorException - if an error occurs when deleting the account.

SmackException.NoResponseException - if there was no response from the server.

SmackException.NotConnectedException