Package com.ibm.di.config.interfaces
Interface FormConfig
-
- All Superinterfaces:
BaseConfiguration
,java.io.Serializable
- All Known Implementing Classes:
FormConfigImpl
public interface FormConfig extends BaseConfiguration
A Form that can be displayed by the Configuration Editor
-
-
Field Summary
-
Fields inherited from interface com.ibm.di.config.interfaces.BaseConfiguration
CHILD_PATH_SEPARATOR, DISABLE_EXTPROPS, DISABLE_INHERITANCE, INHERIT_NONE, INHERIT_PARENT, ONE_LEVEL, RECURSIVE, RECURSIVE_ONELEVEL, RECURSIVE_SUBTREE, SEARCH_EXACTCASE, SEARCH_ONELEVEL, SEARCH_PARAMNAME, SEARCH_PARAMNAME_RE, SEARCH_PROPERTY, SEARCH_REGEX, SEARCH_SUBSTRING, SUBTREE
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
addFormItem(FormItemConfig item)
Add a FormItem definition to this FormConfigvoid
addSection(FormSection section)
Add a FormSection definition to this FormConfigjava.lang.String
getFormEventHandler()
/** Get the script that handles events in this FormConfig.FormItemConfig
getFormItem(java.lang.String name)
Get a FormItem defined by this FormConfig.java.util.List<java.lang.String>
getFormItemNames()
Returns a list of the names of all the FormItems in this FormConfig.java.lang.String
getFormScript()
Get the script that will be executed every time a button is pressed.int
getHeight(int h)
Get the preferred height of this Form.java.util.Iterator<java.lang.String>
getLocalFormItemNames()
Returns an Iterator over names of FormItems defined in this FormConfig.FormSection
getSection(java.lang.String name)
Get the FormSection with the given name.java.util.List<java.lang.String>
getSectionNames()
Get a list of the names of all Sections used by this FormConfig, if defined.java.util.List<java.lang.String>
getTabNames()
Get names of tabs.java.lang.String
getTabTitle(java.lang.String name)
Get Title for one tab.java.lang.String
getTabToolTip(java.lang.String name)
Get Tooltip for one tab.java.lang.String
getTitle()
Get the title of this FormConfig.java.lang.ClassLoader
getTranslationClassLoader()
java.lang.String
getTranslationFile()
Get the name of the translation file.java.lang.String
getTranslationLocale()
Returns Locale identifier (ISO lang code) to use when translating resources.java.lang.String
getUIClass()
Get the name of a UI class that will be used to display the form.boolean
getUseHyperLabel()
Return true if this FormConfig uses hyperlabelsboolean
getUseTabs()
Return true if this form uses tabs.java.util.List<ValidatorConfig>
getValidators()
Return list of all available validators in the configuration.int
getWidth(int w)
Get the preferred width of this Form.FormItemConfig
newFormItem(java.lang.String name)
Create a new FormItem with the given namevoid
removeFormItem(java.lang.String name)
Remove the FormItem with the given namevoid
renameFormItem(java.lang.String oldName, java.lang.String newName)
Rename a FormItem.void
setTranslationClassLoader(java.lang.ClassLoader ldr)
Sets the preferredClassLoader
able to resolve the translation file as a resource.void
setTranslationFile(java.lang.String name)
Set the name of the translation file.void
setTranslationLocale(java.lang.String locale)
Sets the preferred Locale to use when translating strings.java.lang.String
translate(java.lang.String str)
Translate a String.-
Methods inherited from interface com.ibm.di.config.interfaces.BaseConfiguration
addListener, detachFromParent, flatten, fromEntry, getBooleanParameter, getChild, getChildForPath, getChildNames, getClone, getData, getDataIterator, getDebug, getDebug, getDebugBreak, getEnabled, getFlags, getInheritsFrom, getInheritsFromRef, getIntegerParameter, getKeys, getLogEnabled, getMetamergeConfig, getModified, getModTS, getName, getNamespace, getNullBehavior, getNullBehaviorValue, getNullDefinition, getNullDefinitionValue, getParameter, getParameter, getParameter, getParameterPropertySource, getParameterRaw, getParent, getPath, getReferences, getScript, getScriptEngine, getShortName, getStringParameter, getSubstitutionMap, getUseListeners, getUserComment, hasParameter, init, isExpression, isParameterLocal, isProtectedParameter, nameForChild, notifyChange, notifyChange, notifyChange, reattachToParent, removeListener, removeParameter, search, search, setBooleanParameter, setChild, setData, setDebug, setDebugBreak, setEnabled, setFlags, setInheritsFrom, setInheritsFromRef, setIntegerParameter, setLogEnabled, setMetamergeConfig, setModified, setModTS, setName, setName, setNullBehavior, setNullBehaviorValue, setNullDefinition, setNullDefinitionValue, setParameter, setParameter, setParameterPropertySource, setParent, setProtectedParameter, setProtectedParameter, setScript, setScriptEngine, setStringParameter, setSubstitutionMap, setupInheritanceChain, setUseListeners, setUserComment, size, toEntry, updateInheritsFrom, willFlatten
-
-
-
-
Method Detail
-
getFormItemNames
java.util.List<java.lang.String> getFormItemNames()
Returns a list of the names of all the FormItems in this FormConfig. Some names may refer to global FormItems.
-
getLocalFormItemNames
java.util.Iterator<java.lang.String> getLocalFormItemNames()
Returns an Iterator over names of FormItems defined in this FormConfig.
-
getFormItem
FormItemConfig getFormItem(java.lang.String name)
Get a FormItem defined by this FormConfig. May return null if the name is not defined in this FormConfig.- Parameters:
name
- The name of the FormItem
-
newFormItem
FormItemConfig newFormItem(java.lang.String name)
Create a new FormItem with the given name- Parameters:
name
- The name of the FormItem
-
removeFormItem
void removeFormItem(java.lang.String name)
Remove the FormItem with the given name- Parameters:
name
- The name of the FormItem
-
renameFormItem
void renameFormItem(java.lang.String oldName, java.lang.String newName)
Rename a FormItem.- Parameters:
oldName
- The old name of the FormItemnewName
- The new name of the FormItem
-
addFormItem
void addFormItem(FormItemConfig item)
Add a FormItem definition to this FormConfig
-
getSectionNames
java.util.List<java.lang.String> getSectionNames()
Get a list of the names of all Sections used by this FormConfig, if defined. The names would typically be FormSection names. A FormSection also contains names, which could either be FormSection names of FormItem names. FormSection names would refer to FormSections in this FormConfig, but FormItem names may refer to global FormItems.
-
getSection
FormSection getSection(java.lang.String name)
Get the FormSection with the given name.- Parameters:
name
- The name of the FormSection
-
addSection
void addSection(FormSection section)
Add a FormSection definition to this FormConfig
-
getFormEventHandler
java.lang.String getFormEventHandler()
/** Get the script that handles events in this FormConfig. This script is executed at once when the Form is displayed. Could be null.
-
getFormScript
java.lang.String getFormScript()
Get the script that will be executed every time a button is pressed. Much like getFormEventHandler(), but this can be executed 0 or more times. Could be null.
-
getTitle
java.lang.String getTitle()
Get the title of this FormConfig.
-
getUIClass
java.lang.String getUIClass()
Get the name of a UI class that will be used to display the form. Most of the other parameters will be ignored. This could be null, indicating no UI class is defined.
-
getWidth
int getWidth(int w)
Get the preferred width of this Form.- Parameters:
w
- Use this width if no width defined
-
getHeight
int getHeight(int h)
Get the preferred height of this Form.- Parameters:
h
- Use this height if no height defined.
-
getUseHyperLabel
boolean getUseHyperLabel()
Return true if this FormConfig uses hyperlabels
-
getUseTabs
boolean getUseTabs()
Return true if this form uses tabs.
-
getTabNames
java.util.List<java.lang.String> getTabNames()
Get names of tabs. These names refer to other FormConfig objects.
-
getTabTitle
java.lang.String getTabTitle(java.lang.String name)
Get Title for one tab.- Parameters:
name
- Name of the tab
-
getTabToolTip
java.lang.String getTabToolTip(java.lang.String name)
Get Tooltip for one tab.- Parameters:
name
- Name of the tab
-
getTranslationFile
java.lang.String getTranslationFile()
Get the name of the translation file. For internal use, to translate labels and so on.
-
setTranslationFile
void setTranslationFile(java.lang.String name)
Set the name of the translation file. For internal use with ResourceBundle.
-
translate
java.lang.String translate(java.lang.String str)
Translate a String.- Parameters:
str
- The string to be translated- Returns:
- The translated String, or the original String if no translation was found.
-
setTranslationLocale
void setTranslationLocale(java.lang.String locale)
Sets the preferred Locale to use when translating strings. Setting this to null resets the FormConfig back to using the default locale; otherwise it overrides the default locale.
-
getTranslationLocale
java.lang.String getTranslationLocale()
Returns Locale identifier (ISO lang code) to use when translating resources.
-
setTranslationClassLoader
void setTranslationClassLoader(java.lang.ClassLoader ldr)
Sets the preferredClassLoader
able to resolve the translation file as a resource.
-
getTranslationClassLoader
java.lang.ClassLoader getTranslationClassLoader()
- Returns:
- the
ClassLoader
used to resolve the translation file as a resource. If not specifiednull
is returned.
-
getValidators
java.util.List<ValidatorConfig> getValidators()
Return list of all available validators in the configuration. In case of missing validators an empty list is returned.- Returns:
- list of validators configuration.
-
-