Method Detail

• isRegistrationSupported

  public boolean isRegistrationSupported()
                                  throws XmppException

  Determines, if in-band registration is supported by the server.

  Returns:

  True if registration is supported by the server; otherwise false.

  Throws:

  StanzaException - If the server returned a stanza error. Common errors are Condition.CONFLICT (username is already in use) or Condition.NOT_ACCEPTABLE (some required information not provided).

  NoResponseException - If the server did not respond.

  XmppException

• getRegistration

  public Registration getRegistration()
                               throws XmppException

  Gets the registration data (instructions, fields and form) from the server.

  In order to check if a field is required, you should check if a field is not null.

  If you are already registered to the server, this method returns your registration data and Registration.isRegistered() returns true.

  Returns:

  The registration data.

  Throws:

  StanzaException - If the server returned a stanza error.

  NoResponseException - If the server did not respond.

  XmppException

  See Also:

  3.1 Entity Registers with a Host, Registration

• register

  public void register(Registration registration)
                throws XmppException

  Registers a new account. Call this method before authenticating.

  Parameters:

  registration - The registration.

  Throws:

  StanzaException - If the server returned a stanza error. Common errors are Condition.CONFLICT (username is already in use) or Condition.NOT_ACCEPTABLE (some required information not provided).

  NoResponseException - If the server did not respond.

  XmppException

  See Also:

  3.1 Entity Registers with a Host

• cancelRegistration

  public void cancelRegistration()
                          throws XmppException

  Cancels a registration. This method must be called after having authenticated to the server.

  Throws:

  StanzaException - If the server returned a stanza error.

  NoResponseException - If the server did not respond.

  XmppException

  See Also:

  3.2 Entity Cancels an Existing Registration

• changePassword

  public void changePassword(String username,
                    String password)
                      throws XmppException

  Changes the password for the current user. This method must be called after having authenticated to the server.

  Parameters:

  username - The user name.

  password - The password.

  Throws:

  StanzaException - If the server returned a stanza error.

  NoResponseException - If the server did not respond.

  XmppException

  See Also:

  3.3 User Changes Password