Jitsi: the OpenSource Java VoIP and Instant Messaging client.

net.java.sip.communicator.plugin.sshaccregwizz
Class SSHAccountRegistrationWizard

java.lang.Object
  extended by net.java.sip.communicator.service.gui.AccountRegistrationWizard
      extended by net.java.sip.communicator.plugin.sshaccregwizz.SSHAccountRegistrationWizard

public class SSHAccountRegistrationWizard
extends AccountRegistrationWizard

The SSHAccountRegistrationWizard is an implementation of the AccountRegistrationWizard for the SSH protocol. It allows the user to create and configure a new SSH account.

Author:
Shobhit Jindal

Constructor Summary
SSHAccountRegistrationWizard(WizardContainer wizardContainer)
          Creates an instance of SSHAccountRegistrationWizard.
 
Method Summary
 Object getFirstPageIdentifier()
          Returns the identifier of the first account registration wizard page.
 byte[] getIcon()
          Implements the AccountRegistrationWizard.getIcon method.
 Object getLastPageIdentifier()
          Returns the identifier of the last account registration wizard page.
 byte[] getPageImage()
          Implements the AccountRegistrationWizard.getPageImage method.
 Iterator<WizardPage> getPages()
          Returns the set of pages contained in this wizard.
 String getProtocolDescription()
          Implements the AccountRegistrationWizard.getProtocolDescription method.
 String getProtocolName()
          Implements the AccountRegistrationWizard.getProtocolName method.
 Object getSimpleForm(boolean isCreateAccount)
          Returns a simple account registration form that would be the first form shown to the user.
 Dimension getSize()
          Returns the size of this wizard.
 Iterator<Map.Entry<String,String>> getSummary()
          Returns the set of data that user has entered through this wizard.
 String getUserNameExample()
          Returns an example string, which should indicate to the user how the user name should look like.
 ProtocolProviderService installAccount(ProtocolProviderFactory providerFactory, String user)
          Creates an account for the given Account ID, Identity File and Known Hosts File
 boolean isSimpleFormEnabled()
          Indicates whether this wizard enables the simple "sign in" form shown when the user opens the application for the first time.
 void loadAccount(ProtocolProviderService protocolProvider)
          Fills the UserID and Password fields in this panel with the data comming from the given protocolProvider.
 ProtocolProviderService signin()
          Defines the operations that will be executed when the user clicks on the wizard "Signin" button.
 ProtocolProviderService signin(String userName, String password)
          Defines the operations that will be executed when the user clicks on the wizard "Signin" button.
 
Methods inherited from class net.java.sip.communicator.service.gui.AccountRegistrationWizard
accountRemoved, getForgotPasswordLink, getForgotPasswordLinkName, getWizardContainer, isHidden, isModification, isPreferredProtocol, isWebSignupSupported, setModification, setWizardContainer, webSignup
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SSHAccountRegistrationWizard

public SSHAccountRegistrationWizard(WizardContainer wizardContainer)
Creates an instance of SSHAccountRegistrationWizard.

Parameters:
wizardContainer - the wizard container, where this wizard is added
Method Detail

getIcon

public byte[] getIcon()
Implements the AccountRegistrationWizard.getIcon method. Returns the icon to be used for this wizard.

Specified by:
getIcon in class AccountRegistrationWizard
Returns:
byte[]

getPageImage

public byte[] getPageImage()
Implements the AccountRegistrationWizard.getPageImage method. Returns the image used to decorate the wizard page

Specified by:
getPageImage in class AccountRegistrationWizard
Returns:
byte[] the image used to decorate the wizard page

getProtocolName

public String getProtocolName()
Implements the AccountRegistrationWizard.getProtocolName method. Returns the protocol name for this wizard.

Specified by:
getProtocolName in class AccountRegistrationWizard
Returns:
String

getProtocolDescription

public String getProtocolDescription()
Implements the AccountRegistrationWizard.getProtocolDescription method. Returns the description of the protocol for this wizard.

Specified by:
getProtocolDescription in class AccountRegistrationWizard
Returns:
String

getPages

public Iterator<WizardPage> getPages()
Returns the set of pages contained in this wizard.

Specified by:
getPages in class AccountRegistrationWizard
Returns:
Iterator

getSummary

public Iterator<Map.Entry<String,String>> getSummary()
Returns the set of data that user has entered through this wizard.

Specified by:
getSummary in class AccountRegistrationWizard
Returns:
Iterator

signin

public ProtocolProviderService signin()
                               throws OperationFailedException
Defines the operations that will be executed when the user clicks on the wizard "Signin" button.

Specified by:
signin in class AccountRegistrationWizard
Returns:
the created ProtocolProviderService corresponding to the new account
Throws:
OperationFailedException - if the operation didn't succeed

signin

public ProtocolProviderService signin(String userName,
                                      String password)
                               throws OperationFailedException
Defines the operations that will be executed when the user clicks on the wizard "Signin" button.

Specified by:
signin in class AccountRegistrationWizard
Parameters:
userName - the user name to sign in with
password - the password to sign in with
Returns:
the created ProtocolProviderService corresponding to the new account
Throws:
OperationFailedException - if the operation didn't succeed

installAccount

public ProtocolProviderService installAccount(ProtocolProviderFactory providerFactory,
                                              String user)
                                       throws OperationFailedException
Creates an account for the given Account ID, Identity File and Known Hosts File

Parameters:
providerFactory - the ProtocolProviderFactory which will create the account
user - the user identifier
Returns:
the ProtocolProviderService for the new account.
Throws:
OperationFailedException

loadAccount

public void loadAccount(ProtocolProviderService protocolProvider)
Fills the UserID and Password fields in this panel with the data comming from the given protocolProvider.

Specified by:
loadAccount in class AccountRegistrationWizard
Parameters:
protocolProvider - The ProtocolProviderService to load the data from.

getSize

public Dimension getSize()
Returns the size of this wizard.

Specified by:
getSize in class AccountRegistrationWizard
Returns:
the size of this wizard

getFirstPageIdentifier

public Object getFirstPageIdentifier()
Returns the identifier of the first account registration wizard page. This method is meant to be used by the wizard container to determine, which is the first page to show to the user.

Specified by:
getFirstPageIdentifier in class AccountRegistrationWizard
Returns:
the identifier of the first account registration wizard page

getLastPageIdentifier

public Object getLastPageIdentifier()
Description copied from class: AccountRegistrationWizard
Returns the identifier of the last account registration wizard page. This method is meant to be used by the wizard container to determine which is the page to show before the summary page (of course if there's a summary).

Specified by:
getLastPageIdentifier in class AccountRegistrationWizard
Returns:
the identifier of the last account registration wizard page

getUserNameExample

public String getUserNameExample()
Returns an example string, which should indicate to the user how the user name should look like.

Specified by:
getUserNameExample in class AccountRegistrationWizard
Returns:
an example string, which should indicate to the user how the user name should look like.

isSimpleFormEnabled

public boolean isSimpleFormEnabled()
Indicates whether this wizard enables the simple "sign in" form shown when the user opens the application for the first time. The simple "sign in" form allows user to configure her account in one click, just specifying her username and password and leaving any other configuration as by default.

Overrides:
isSimpleFormEnabled in class AccountRegistrationWizard
Returns:
true if the simple "Sign in" form is enabled or false otherwise.

getSimpleForm

public Object getSimpleForm(boolean isCreateAccount)
Returns a simple account registration form that would be the first form shown to the user. Only if the user needs more settings she'll choose to open the advanced wizard, consisted by all pages.

Specified by:
getSimpleForm in class AccountRegistrationWizard
Parameters:
isCreateAccount - indicates if the simple form should be opened as a create account form or as a login form
Returns:
a simple account registration form

Jitsi: the OpenSource Java VoIP and Instant Messaging client.

Jitsi, the OpenSource Java VoIP and Instant Messaging client.
Distributable under LGPL license.