Added support for registration instructions (SMACK-90)

git-svn-id: http://svn.igniterealtime.org/svn/repos/smack/trunk@2108 b35dd754-fafc-0310-a699-88a17e54d16e

source/org/jivesoftware/smack/AccountManager.java

@@ -136,6 +136,25 @@ public class AccountManager {
         return Collections.EMPTY_LIST.iterator();
     }
 
+    /**
+     * Returns the instructions for creating a new account, or <tt>null</tt> if there
+     * are no instructions. If present, instructions should be displayed to the end-user
+     * that will complete the registration process.
+     *
+     * @return the account creation instructions, or <tt>null</tt> if there are none.
+     */
+    public String getAccountInstructions() {
+        try {
+            if (info == null) {
+                getRegistrationInfo();
+            }
+            return info.getInstructions();
+        }
+        catch (XMPPException xe) {
+            return null;
+        }
+    }
+
     /**
      * 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
@@ -149,6 +168,9 @@ public class AccountManager {
      * @throws XMPPException if an error occurs creating the account.
      */
     public void createAccount(String username, String password) throws XMPPException {
+        if (!supportsAccountCreation()) {
+            throw new XMPPException("Server does not support account creation.");
+        }
         // Create a map for all the required attributes, but give them blank values.
         Map attributes = new HashMap();
         for (Iterator i=getAccountAttributes(); i.hasNext(); ) {

source/org/jivesoftware/smack/packet/Registration.java

@@ -82,6 +82,7 @@ public class Registration extends IQ {
 
     private String username = null;
     private String password = null;
+    private String instructions = null;
     private Map attributes = null;
 
     /**
@@ -120,6 +121,26 @@ public class Registration extends IQ {
         this.password = password;
     }
 
+    /**
+     * Returns the registration instructions, or <tt>null</tt> if no instructions
+     * have been set. If present, instructions should be displayed to the end-user
+     * that will complete the registration process.
+     *
+     * @return the registration instructions, or <tt>null</tt> if there are none.
+     */
+    public String getInstructions() {
+        return instructions;
+    }
+
+    /**
+     * Sets the registration instructions.
+     *
+     * @param instructions the registration instructions.
+     */
+    public void setInstructions(String instructions) {
+        this.instructions = instructions;
+    }
+
     /**
      * Returns the map of String key/value pairs of account attributes.
      *
@@ -147,6 +168,9 @@ public class Registration extends IQ {
         if (password != null) {
             buf.append("<password>").append(password).append("</password>");
         }
+        if (instructions != null) {
+            buf.append("<instructions>").append(instructions).append("</instructions>");
+        }
         if (attributes != null && attributes.size() > 0) {
             Iterator fieldNames = attributes.keySet().iterator();
             while (fieldNames.hasNext()) {
@@ -160,4 +184,4 @@ public class Registration extends IQ {
         buf.append("</query>");
         return buf.toString();
     }
-}
+}