Remote Systems
v6.4.1

com.ibm.etools.systems.filters.ui.dialogs
Class SystemNewFilterWizardNamePage

java.lang.Object
  extended byWizardPage
      extended bycom.ibm.etools.systems.core.ui.wizards.AbstractSystemWizardPage
          extended bycom.ibm.etools.systems.filters.ui.dialogs.SystemNewFilterWizardNamePage
All Implemented Interfaces:
ISystemMessageLine, ISystemMessages, ISystemWizardPage

public class SystemNewFilterWizardNamePage
extends AbstractSystemWizardPage
implements ISystemMessages

Second page of the New Filter wizard that prompts for the name of the filter.

See Also:
Serialized Form

Field Summary
protected  boolean contentsCreated
           
static String copyright
           
protected  SystemMessage errorMessage
           
protected  ISystemFilterPoolSelectionValidator filterPoolSelectionValidator
           
protected  boolean ignoreChanges
           
protected  String inputFilterName
           
protected  Text nameText
           
protected  ISystemValidator nameValidator
           
protected  ISystemValidator[] nameValidators
           
protected  SystemFilterPool parentPool
           
protected  Combo poolCombo
           
protected  Label poolComboLabel
           
protected  SystemFilterPool[] poolsToSelectFrom
           
protected  Label poolVerbage
           
protected  Combo poolWrapperCombo
           
protected  ISystemFilterPoolWrapperInformation poolWrapperInformation
           
protected  ISystemFilterPoolWrapper[] poolWrappers
           
protected  Button uniqueCB
           
protected  boolean userEditedName
           
 
Fields inherited from interface com.ibm.etools.systems.core.ISystemMessages
FILEMSG_ARCHIVE_CORRUPTED, FILEMSG_COPY_FILE_FAILED, FILEMSG_COPY_ROOT, FILEMSG_CREATE_FILE_FAILED, FILEMSG_CREATE_FILE_FAILED_EXIST, FILEMSG_CREATE_FOLDER_FAILED, FILEMSG_CREATE_FOLDER_FAILED_EXIST, FILEMSG_CREATE_RESOURCE_NOTVISIBLE, FILEMSG_DELETE_FILE_FAILED, FILEMSG_DELETING, FILEMSG_DESTINATION_CONFLICTING, FILEMSG_DESTINATION_EMPTY, FILEMSG_ERROR_NOFILETYPES, FILEMSG_EXPORT_ERROR, FILEMSG_EXPORT_FAILED, FILEMSG_EXPORT_NONE_SELECTED, FILEMSG_EXPORT_PROBLEMS, FILEMSG_FILE_NOTFOUND, FILEMSG_FOLDER_IS_FILE, FILEMSG_FOLDER_NOTEMPTY, FILEMSG_FOLDER_NOTFOUND, FILEMSG_FOLDER_NOTFOUND_WANTTOCREATE, FILEMSG_IMPORT_ERROR, FILEMSG_IMPORT_FAILED, FILEMSG_IMPORT_FILTERING, FILEMSG_IMPORT_NONE_SELECTED, FILEMSG_IMPORT_PROBLEMS, FILEMSG_IMPORT_SELF, FILEMSG_IO_ERROR, FILEMSG_MOVE_FILE_FAILED, FILEMSG_MOVE_TARGET_DESCENDS_FROM_SOUCE, FILEMSG_MOVE_TARGET_EQUALS_SOURCE, FILEMSG_NOT_WRITABLE, FILEMSG_RENAME_FILE_FAILED, FILEMSG_RENAME_RESOURCE_NOTVISIBLE, FILEMSG_SECURITY_ERROR, FILEMSG_SOURCE_EMPTY, FILEMSG_SOURCE_IS_FILE, FILEMSG_TARGET_EXISTS, FILEMSG_VALIDATE_FILEFILTERSTRING_EMPTY, FILEMSG_VALIDATE_FILEFILTERSTRING_NOINCLUDES, FILEMSG_VALIDATE_FILEFILTERSTRING_NOTUNIQUE, FILEMSG_VALIDATE_FILEFILTERSTRING_NOTVALID, MSG_ADDTO_VIRTUAL_DEST, MSG_CACHE_UNABLE_TO_SYNCH, MSG_CACHE_UPLOAD_BEFORE_DELETE, MSG_COMBINETO_VIRTUAL_DEST, MSG_COMM_AUTH_FAILED, MSG_COMM_CLIENT_OLDER_WARNING, MSG_COMM_CONNECT_FAILED, MSG_COMM_DAEMON_NOTSTARTED, MSG_COMM_ENVVAR_DUPLICATE, MSG_COMM_ENVVAR_INVALIDCHAR, MSG_COMM_ENVVAR_NONAME, MSG_COMM_INCOMPATIBLE_PROTOCOL, MSG_COMM_INCOMPATIBLE_UPDATE, MSG_COMM_INVALID_LOGIN, MSG_COMM_PORT_WARNING, MSG_COMM_PWD_BLANKFIELD, MSG_COMM_PWD_EXISTS, MSG_COMM_PWD_INVALID, MSG_COMM_PWD_MISMATCH, MSG_COMM_REXEC_NOTSTARTED, MSG_COMM_SERVER_NOTSTARTED, MSG_COMM_SERVER_OLDER_WARNING, MSG_CONFIRM_CHANGES, MSG_CONFIRM_CHANGES_CANCELABLE, MSG_CONFIRM_DELETE, MSG_CONFIRM_DELETE_USERACTION, MSG_CONFIRM_DELETE_USERTYPE, MSG_CONFIRM_DELETEPROFILE, MSG_CONFIRM_DELETEREMOTE, MSG_CONFIRM_ENABLE_CLASSIC_HELP, MSG_CONFIRM_RELOADRSE, MSG_CONNECT_CANCELLED, MSG_CONNECT_DAEMON_FAILED, MSG_CONNECT_DAEMON_FAILED_EXCEPTION, MSG_CONNECT_FAILED, MSG_CONNECT_PROGRESS, MSG_CONNECT_SSL_EXCEPTION, MSG_CONNECT_UNKNOWNHOST, MSG_CONNECTING_TO_SERVER, MSG_CONNECTION_DELETED, MSG_CONNECTWITHPORT_PROGRESS, MSG_CONVERTTO_VIRTUAL_DEST, MSG_COPY_PROGRESS, MSG_COPYCONNECTION_PROGRESS, MSG_COPYCONNECTIONS_PROGRESS, MSG_COPYFILTER_PROGRESS, MSG_COPYFILTERPOOL_COMPLETE, MSG_COPYFILTERPOOL_PROGRESS, MSG_COPYFILTERPOOLS_PROGRESS, MSG_COPYFILTERS_PROGRESS, MSG_COPYFILTERSTRING_PROGRESS, MSG_COPYFILTERSTRINGS_PROGRESS, MSG_COPYGENERIC_PROGRESS, MSG_COPYSUBSYSTEMS_PROGRESS, MSG_COPYTHINGGENERIC_PROGRESS, MSG_DEST_NOT_IN_SOURCE, MSG_DEST_TARGET_READONLY, MSG_DISCONNECT_CANCELLED, MSG_DISCONNECT_FAILED, MSG_DISCONNECT_PROGRESS, MSG_DISCONNECTWITHPORT_PROGRESS, MSG_DOWNLOAD_ALREADY_OPEN_IN_EDITOR, MSG_DOWNLOAD_NO_WRITE, MSG_DOWNLOAD_PROGRESS, MSG_DOWNLOADING_PROGRESS, MSG_ERROR_CONNECTION_NOTFOUND, MSG_ERROR_ENABLE_CLASSIC_HELP, MSG_ERROR_EXTENSION_EMPTY, MSG_ERROR_FILE_NOTFOUND, MSG_ERROR_FILENAME_INVALID, MSG_ERROR_FOLDER_NOTFOUND, MSG_ERROR_FOLDERORFILE_NOTFOUND, MSG_ERROR_GENERAL, MSG_ERROR_LIST_TITLE, MSG_ERROR_PROFILE_NOTFOUND, MSG_ERROR_UNEXPECTED, MSG_EXCEPTION_DELETING, MSG_EXCEPTION_MOVING, MSG_EXCEPTION_OCCURRED, MSG_EXCEPTION_RENAMING, MSG_EXPAND_CANCELLED, MSG_EXPAND_CONNECTIONCREATED, MSG_EXPAND_EMPTY, MSG_EXPAND_FAILED, MSG_EXPAND_FILTERCREATED, MSG_EXPAND_PREFIX, MSG_EXTRACT_PROGRESS, MSG_FILE_INUSE, MSG_FILTERPOOL_CREATED, MSG_FOLDER_INUSE, MSG_GENERIC_E, MSG_GENERIC_E_HELP, MSG_GENERIC_E_TWOPARMS_HELP, MSG_GENERIC_I, MSG_GENERIC_I_HELP, MSG_GENERIC_I_TWOPARMS_HELP, MSG_GENERIC_Q, MSG_GENERIC_Q_HELP, MSG_GENERIC_Q_TWOPARMS_HELP, MSG_GENERIC_U, MSG_GENERIC_U_HELP, MSG_GENERIC_U_TWOPARMS_HELP, MSG_GENERIC_W, MSG_GENERIC_W_HELP, MSG_GENERIC_W_TWOPARMS_HELP, MSG_HOSTNAME_NOTFOUND, MSG_HOSTNAME_VERIFYING, MSG_IMPORT_EXPORT_UNABLE_TO_USE_CONNECTION, MSG_IMPORT_EXPORT_UNEXPECTED_EXCEPTION, MSG_INITIALIZING_SERVER, MSG_LIST_CANCELLED, MSG_LIST_PREFIX, MSG_LOADING_PROFILE_SHOULDBE_ACTIVATED, MSG_LOADING_PROFILE_SHOULDNOTBE_DEACTIVATED, MSG_MOVE_PROGRESS, MSG_MOVECONNECTION_PROGRESS, MSG_MOVECONNECTIONS_PROGRESS, MSG_MOVEFILTER_PROGRESS, MSG_MOVEFILTERPOOL_COMPLETE, MSG_MOVEFILTERPOOL_PROGRESS, MSG_MOVEFILTERPOOLS_PROGRESS, MSG_MOVEFILTERS_PROGRESS, MSG_MOVEFILTERSTRING_PROGRESS, MSG_MOVEFILTERSTRINGS_PROGRESS, MSG_MOVEGENERIC_PROGRESS, MSG_MOVETHINGGENERIC_PROGRESS, MSG_OFFLINE_CANT_CONNECT, MSG_OPERATION_CANCELLED, MSG_OPERATION_DISCONNECTED, MSG_OPERATION_FAILED, MSG_OPERATION_FINISHED, MSG_OPERATION_RUNNING, MSG_OPERTION_STOPPED, MSG_PERCENT_DONE, MSG_PREFIX, MSG_QUERY_PROGRESS, MSG_QUERY_PROPERTIES_PROGRESS, MSG_REMOTE_JAR_EXPORT_OVERWRITE_FILE, MSG_REMOTE_SEARCH_INVALID_REGEX, MSG_RENAMEFILTER_FAILED, MSG_RESOLVE_PROGRESS, MSG_RESTORE_FAILED, MSG_RUN_PROGRESS, MSG_SAVE_CHANGES_PENDING, MSG_SAVE_FAILED, MSG_SAVING_PROGRESS, MSG_SET_PROGRESS, MSG_SET_PROPERTIES_PROGRESS, MSG_STARTING_SERVER_VIA_DAEMON, MSG_STARTING_SERVER_VIA_REXEC, MSG_SYNCHRONIZE_PROGRESS, MSG_TRANSFER_INVALID, MSG_UCMD_INVOCATION_EMPTY, MSG_UDA_LOAD_ERROR, MSG_UDA_ROOTTAG_ERROR, MSG_UFF_PATTERN_EMPTY, MSG_UFF_PATTERN_INVALID_REGEX, MSG_UNDERCONSTRUCTION, MSG_UPDATEFILTER_FAILED, MSG_UPLOAD_FILE_EXISTS, MSG_UPLOAD_PROGRESS, MSG_UPLOADING_PROGRESS, MSG_VALIDATE_ARCHIVE_NAME, MSG_VALIDATE_COMPILELABEL_EMPTY, MSG_VALIDATE_COMPILELABEL_NOTUNIQUE, MSG_VALIDATE_COMPILELABEL_NOTVALID, MSG_VALIDATE_COMPILESTRING_EMPTY, MSG_VALIDATE_COMPILESTRING_NOTVALID, MSG_VALIDATE_CONNECTIONNAME_EMPTY, MSG_VALIDATE_CONNECTIONNAME_NOTUNIQUE, MSG_VALIDATE_CONNECTIONNAME_NOTUNIQUE_OTHERPROFILE, MSG_VALIDATE_CONNECTIONNAME_NOTVALID, MSG_VALIDATE_ENTRY_EMPTY, MSG_VALIDATE_ENTRY_NOTUNIQUE, MSG_VALIDATE_ENTRY_NOTVALID, MSG_VALIDATE_FILENAME_NOTVALID, MSG_VALIDATE_FILTERNAME_EMPTY, MSG_VALIDATE_FILTERNAME_NOTUNIQUE, MSG_VALIDATE_FILTERNAME_NOTVALID, MSG_VALIDATE_FILTERPOOLNAME_EMPTY, MSG_VALIDATE_FILTERPOOLNAME_NOTUNIQUE, MSG_VALIDATE_FILTERPOOLNAME_NOTVALID, MSG_VALIDATE_FILTERSTRING_ALREADYEXISTS, MSG_VALIDATE_FILTERSTRING_DUPLICATES, MSG_VALIDATE_FILTERSTRING_EMPTY, MSG_VALIDATE_FILTERSTRING_NOTUNIQUE, MSG_VALIDATE_FILTERSTRING_NOTVALID, MSG_VALIDATE_FOLDERNAME_NOTVALID, MSG_VALIDATE_HOSTNAME_EMPTY, MSG_VALIDATE_NAME_EMPTY, MSG_VALIDATE_NAME_NOTUNIQUE, MSG_VALIDATE_NAME_NOTVALID, MSG_VALIDATE_NOT_NUMERIC, MSG_VALIDATE_NUMBER_EMPTY, MSG_VALIDATE_NUMBER_NOTVALID, MSG_VALIDATE_NUMBER_OUTOFRANGE, MSG_VALIDATE_PASSWORD_EMPTY, MSG_VALIDATE_PASSWORD_EXPIRED, MSG_VALIDATE_PATH_EMPTY, MSG_VALIDATE_PATH_NOTUNIQUE, MSG_VALIDATE_PATH_NOTVALID, MSG_VALIDATE_PORT_EMPTY, MSG_VALIDATE_PORT_NOTVALID, MSG_VALIDATE_PROFILENAME_EMPTY, MSG_VALIDATE_PROFILENAME_NOTUNIQUE, MSG_VALIDATE_PROFILENAME_NOTVALID, MSG_VALIDATE_PROFILENAME_RESERVED, MSG_VALIDATE_RENAME_EMPTY, MSG_VALIDATE_RENAME_NOTUNIQUE, MSG_VALIDATE_RENAME_NOTVALID, MSG_VALIDATE_RENAME_OLDEQUALSNEW, MSG_VALIDATE_SRCTYPE_EMPTY, MSG_VALIDATE_SRCTYPE_NOTUNIQUE, MSG_VALIDATE_SRCTYPE_NOTVALID, MSG_VALIDATE_UDACMD_EMPTY, MSG_VALIDATE_UDACMD_NOTVALID, MSG_VALIDATE_UDACMT_EMPTY, MSG_VALIDATE_UDACMT_NOTVALID, MSG_VALIDATE_UDANAME_EMPTY, MSG_VALIDATE_UDANAME_NOTUNIQUE, MSG_VALIDATE_UDANAME_NOTVALID, MSG_VALIDATE_UDTNAME_EMPTY, MSG_VALIDATE_UDTNAME_NOTUNIQUE, MSG_VALIDATE_UDTNAME_NOTVALID, MSG_VALIDATE_UDTTYPES_EMPTY, MSG_VALIDATE_UDTTYPES_NOTVALID, MSG_VALIDATE_USERID_EMPTY, MSG_VALIDATE_USERID_NOTVALID, MSG_WIZARD_PAGE_ERROR, NEW_FILE_ACTION, NEW_FILE_WIZARD, NEW_FOLDER_ACTION, NEW_FOLDER_WIZARD, PLUGIN_ID, PREFIX, RESID_PREFIX
 
Constructor Summary
SystemNewFilterWizardNamePage(SystemNewFilterWizard wizard, SystemFilterPool parentPool, ISystemNewFilterWizardConfigurator data)
          Constructor.
 
Method Summary
 Control createContents(Composite parent)
          Populate the dialog area with our widgets.
 String getFilterName()
          Return name of filter Call this after finish ends successfully.
protected  Control getInitialFocusControl()
          Return the Control to be given initial focus.
 SystemFilterPool getParentSystemFilterPool()
          Return the filter pool that was explicitly chosen by the user, or implicitly set by the caller.
 boolean getUniqueToThisConnection()
          Return the user's decision whether to create this filter uniquely for this connection, or for all applicable connections.
 boolean isPageComplete()
          Return true if the page is complete, so to enable Finish.
 boolean performFinish()
          Completes processing of the wizard.
 void setAllowFilterPoolSelection(ISystemFilterPoolWrapperInformation poolWrappersToSelectFrom, ISystemValidator[] nameValidators)
          This is an alternative to setAllowFilterPoolSelection(SystemFilterPool[], ISystemValidator[]) If you want to prompt the user for the parent filter pool to create this filter in, but want to not use the term "pool" say, you can use an array of euphamisms.
 void setAllowFilterPoolSelection(SystemFilterPool[] poolsToSelectFrom, ISystemValidator[] nameValidators)
          Call if you want to allow the user to select the filter pool to create this filter in.
 void setFilterName(String filterName)
          Set the filter name to default the entry field to
 void setFilterNameValidator(ISystemValidator nameValidator)
          Set the validator to use to verify the filter name is correct
 void setFilterPoolSelectionValidator(ISystemFilterPoolSelectionValidator validator)
          Set the validator to call when the user selects a filter pool.
 void setPageComplete()
          Inform caller of page-complete status of this page
 void setVisible(boolean visible)
          This is called when a page is given focus or loses focus
protected  SystemMessage validateNameInput()
          This hook method is called whenever the text changes in the filter name input field.
 SystemMessage verify()
          Verify all contents
 void widgetDefaultSelected(SelectionEvent e)
          User has selected something and pressed Enter
 void widgetSelected(SelectionEvent e)
          User has selected something
 
Methods inherited from class com.ibm.etools.systems.core.ui.wizards.AbstractSystemWizardPage
addFillerLine, addGrowableFillerLine, addSeparatorLine, applyMnemonics, clearErrorMessage, clearMessage, createControl, getHelpContextId, getInputObject, getMessageLine, getSystemErrorMessage, setBusyCursor, setErrorMessage, setErrorMessage, setErrorMessage, setFocus, setHelp, setHelp, setInputObject, setMessage, setMessage
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.ibm.etools.systems.core.ui.messages.ISystemMessageLine
getErrorMessage, getMessage
 

Field Detail

copyright

public static final String copyright
See Also:
Constant Field Values

nameText

protected Text nameText

uniqueCB

protected Button uniqueCB

poolVerbage

protected Label poolVerbage

poolComboLabel

protected Label poolComboLabel

poolWrapperCombo

protected Combo poolWrapperCombo

poolCombo

protected Combo poolCombo

errorMessage

protected SystemMessage errorMessage

inputFilterName

protected String inputFilterName

contentsCreated

protected boolean contentsCreated

userEditedName

protected boolean userEditedName

ignoreChanges

protected boolean ignoreChanges

nameValidator

protected ISystemValidator nameValidator

nameValidators

protected ISystemValidator[] nameValidators

filterPoolSelectionValidator

protected ISystemFilterPoolSelectionValidator filterPoolSelectionValidator

poolsToSelectFrom

protected SystemFilterPool[] poolsToSelectFrom

poolWrappers

protected ISystemFilterPoolWrapper[] poolWrappers

poolWrapperInformation

protected ISystemFilterPoolWrapperInformation poolWrapperInformation

parentPool

protected SystemFilterPool parentPool
Constructor Detail

SystemNewFilterWizardNamePage

public SystemNewFilterWizardNamePage(SystemNewFilterWizard wizard,
                                     SystemFilterPool parentPool,
                                     ISystemNewFilterWizardConfigurator data)
Constructor.

Method Detail

setFilterName

public void setFilterName(String filterName)
Set the filter name to default the entry field to


setFilterNameValidator

public void setFilterNameValidator(ISystemValidator nameValidator)
Set the validator to use to verify the filter name is correct


setAllowFilterPoolSelection

public void setAllowFilterPoolSelection(SystemFilterPool[] poolsToSelectFrom,
                                        ISystemValidator[] nameValidators)
Call if you want to allow the user to select the filter pool to create this filter in.


setAllowFilterPoolSelection

public void setAllowFilterPoolSelection(ISystemFilterPoolWrapperInformation poolWrappersToSelectFrom,
                                        ISystemValidator[] nameValidators)
This is an alternative to setAllowFilterPoolSelection(SystemFilterPool[], ISystemValidator[])

If you want to prompt the user for the parent filter pool to create this filter in, but want to not use the term "pool" say, you can use an array of euphamisms. That is, you can pass an array of objects that map to filter pools, but have a different display name that is shown in the dropdown.

Of course, if you want to do this, then you will likely want to offer a different label and tooltip for the prompt, and different verbage above the prompt. The object this method accepts as a parameter encapsulates all that information, and there is a default class you can use for this.


setFilterPoolSelectionValidator

public void setFilterPoolSelectionValidator(ISystemFilterPoolSelectionValidator validator)
Set the validator to call when the user selects a filter pool. Optional.


createContents

public Control createContents(Composite parent)
Populate the dialog area with our widgets. Return the composite they are in.

Specified by:
createContents in class AbstractSystemWizardPage
See Also:
SystemWidgetHelpers

getInitialFocusControl

protected Control getInitialFocusControl()
Return the Control to be given initial focus. Override from parent. Return control to be given initial focus.

Specified by:
getInitialFocusControl in class AbstractSystemWizardPage

performFinish

public boolean performFinish()
Completes processing of the wizard. If this method returns true, the wizard will close; otherwise, it will stay active. This method is an override from the parent Wizard class.

Specified by:
performFinish in interface ISystemWizardPage
Specified by:
performFinish in class AbstractSystemWizardPage
Returns:
whether the wizard finished successfully

isPageComplete

public boolean isPageComplete()
Return true if the page is complete, so to enable Finish. Called by wizard framework.


setPageComplete

public void setPageComplete()
Inform caller of page-complete status of this page


widgetSelected

public void widgetSelected(SelectionEvent e)
User has selected something


widgetDefaultSelected

public void widgetDefaultSelected(SelectionEvent e)
User has selected something and pressed Enter


verify

public SystemMessage verify()
Verify all contents


validateNameInput

protected SystemMessage validateNameInput()
This hook method is called whenever the text changes in the filter name input field.


getFilterName

public String getFilterName()
Return name of filter Call this after finish ends successfully.


getParentSystemFilterPool

public SystemFilterPool getParentSystemFilterPool()
Return the filter pool that was explicitly chosen by the user, or implicitly set by the caller.


getUniqueToThisConnection

public boolean getUniqueToThisConnection()
Return the user's decision whether to create this filter uniquely for this connection, or for all applicable connections.


setVisible

public void setVisible(boolean visible)
This is called when a page is given focus or loses focus

Overrides:
setVisible in class AbstractSystemWizardPage

Remote Systems
v6.4.1

Copyright © 2005 IBM Corp. All Rights Reserved.

Note: This documentation is for part of an interim API that is still under development and expected to change significantly before reaching stability. It is being made available at this early stage to solicit feedback from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken (repeatedly) as the API evolves.