AbstractMultipleReferenceDataField (ontimize-core 5.6.0 API)

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.JPanel
      - com.ontimize.gui.field.DataField
        
        com.ontimize.gui.field.AbstractMultipleReferenceDataField

All Implemented Interfaces:

CachedComponent, CreateForms, AccessForm, DataComponent, FormComponent, IdentifiedElement, HasHelpIdComponent, Internationalization, OpenDialog, ApplicationPreferencesListener, HasPreferenceComponent, ReferenceComponent, SecureElement, ValueChangeDataComponent, ImageObserver, MenuContainer, Serializable, EventListener, Accessible

Direct Known Subclasses:

MultipleReferenceComboDataField, MultipleReferenceDataField
```
public abstract class AbstractMultipleReferenceDataField
extends DataField
implements DataComponent, ReferenceComponent, OpenDialog, CreateForms, CachedComponent
```
Abstract class that implements a Multiple Reference Data Field.

Author:

Imatia Innovation

See Also:
Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected class`	`AbstractMultipleReferenceDataField.CEJTextField` The main class to create the EJTextField
`protected class`	`AbstractMultipleReferenceDataField.CodFieldListener` The main class to create a listener in a cod.
`protected static interface`	`AbstractMultipleReferenceDataField.InnerListener` Interface to implement inner listener methods.

Nested classes/interfaces inherited from class com.ontimize.gui.field.DataField
DataField.AuxPanel, DataField.CopyActionListener, DataField.ELabel, DataField.FieldButton, DataField.FieldFocusListener, DataField.InfoMouseListener, DataField.ToggleButton

Nested classes/interfaces inherited from class javax.swing.JPanel
JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields
Modifier and Type	Field and Description
`protected CacheManager`	`cacheManager` A reference to cache manager.
`protected int`	`cacheTime` Defines the cache time.
`static String`	`CACHETIME` Cachetime property.
`protected AbstractMultipleReferenceDataField.CodFieldListener`	`codListener` An instance of cod field listener.
`protected ArrayList`	`cods` An ArrayList where will be inserted the data field names of codes
`static String`	`CODS` Cods property.
`protected ArrayList`	`cols`
`static String`	`COLS` Cols property.
`protected Hashtable`	`dataCache` A data cache.
`protected boolean`	`dataCacheInitialized` The condition about data cache initialization.
`protected String`	`entity`
`static String`	`ENTITY` Entity property
`protected Hashtable`	`formatColumn` The format column.
`protected boolean`	`initCacheOnSetValue` The condition to initialize cache on setValue.
`protected AbstractMultipleReferenceDataField.InnerListener`	`innerListener` A reference to inner Listener.
`protected Hashtable`	`jVisibleCods` An hashtable to put the visible key-component pairs.
`protected ArrayList`	`keys` The reference to keys.
`static String`	`KEYS` Keys property.
`protected long`	`lastCacheTime` The last cache time.
`protected EntityReferenceLocator`	`locator` The Entity reference Locator that provides a locator to this entity
`protected boolean`	`multilanguage` The condition to disable cache
`static String`	`MULTILANGUAGE`
`static String`	`ONSETVALUESET` Typecods property.
`protected List`	`onsetvaluesetAttributes` The vector with attributes to update when data field value changed.
`static String`	`PARENT_CODS` Parentcods property.
`static String`	`PARENT_KEYS` Parentkeys property.
`protected ArrayList`	`parentCods` The reference to parent cods.
`protected boolean`	`parentkeyCache`
`static String`	`PARENTKEYCACHE`
`protected ArrayList`	`parentkeys` The reference to parent keys.
`protected String`	`separator` A separator reference.
`protected ArrayList`	`typecods` An ArrayList where the possible types of codes will be inserted.
`static String`	`TYPECODS` Typecods property.
`protected boolean`	`useCacheManager` The condition to use cache manager.
`protected Object`	`value` A reference to a value object.
`protected boolean`	`valueEventDisabled` The condition to disable events.
`protected ArrayList`	`visibleCods` An ArrayList where the visible column codes will be inserted .
`static String`	`VISIBLECODS` Visiblecods property.
`protected Hashtable`	`visiblesize` An hashtable to put the visible parameters-position in multiple data field

Fields inherited from class com.ontimize.gui.field.DataField
advancedQueryMode, ALIGN, ALIGN_CENTER, ALIGN_LEFT, ALIGN_RIGHT, alignment, ASTERISK_REQUIRED_STYLE, ATTR, attribute, backgroundColor, BGCOLOR, bold, BOLD, BORDER, BORDER_REQUIRED_STYLE, borderText, BOTTOM, CENTER, CLIPBOARD_COPY, CLIPBOARD_COPY_es_ES, CLIPBOARD_CUT, CLIPBOARD_CUT_es_ES, CLIPBOARD_PASTE, CLIPBOARD_PASTE_es_ES, conditions, dataField, DEFAULT_BORDER, DEFAULT_BOTTOM_MARGIN, DEFAULT_FIELD_LEFT_MARGIN, DEFAULT_FIELD_RIGHT_MARGIN, DEFAULT_LABEL_LEFT_MARGIN, DEFAULT_LABEL_RIGHT_MARGIN, DEFAULT_PARENT_MARGIN, DEFAULT_PARENT_MARGIN_FOR_SCROLL, DEFAULT_TOP_MARGIN, defaultAsteriskColor, DEFAULTBORDER, defaultDisableBackgroundColor, defaultFieldButtonHigh, defaultPreferenceTextNotRetrievedFromPreferences, DEFINE_HELP_FIELD_PREFERENCE, dim, DIM, disabledbgcolor, DISABLEDBGCOLOR, empty, enabled, ENABLED, EXPAND, FIELD_HELP_TIP, fieldlistenerFocus, fieldSize, fireValueEvents, FOCUS_BACKGROUNDCOLOR, FONT, fontColor, FONTCOLOR, fontSize, FONTSIZE, height, HEIGHT, incrementalFont, initPreferenceHelpText, INSETS, isEnabled, LABELALIGN, labelComponent, LABELFONT, LABELFONTCOLOR, labelPosition, LABELPOSITION, LABELSIZE, labelText, LABELVISIBLE, LEFT, locale, LOWERED, menuCopy, menuCut, menuDefineHelpPreference, menuHelpPreferences, menuPaste, modifiable, NO_STR, NONE, noRequiredBorder, OPAQUE, originalSize, OUTBORDER, panel, parentForm, permissionActivate, permissionVisible, popupMenu, PREF_WIDTH, prefWidth, RAISED, redimensionPanel, redimensJTextField, required, REQUIRED, requiredBorder, REQUIREDBORDER, requiredFieldBackgroundColor, requiredFieldForegroundColor, resources, restricted, RIGHT, show, showLabel, SIZE, TEXT_STR, TEXTALIGN, textAlignment, textHelpPreference, TIP, tipKey, TOP, validData, VALIGN, Valignment, valueListener, valueSave, VISIBLE, VISUALIZE_HELP_FIELD_PREFERENCE, weightDataFieldH, weightPanelH, width, WIDTH, x, X, y, Y, YES_STR

Fields inherited from class javax.swing.JComponent
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface com.ontimize.gui.field.DataComponent
COMP_FOCUS_YELLOW, GREEN_VERY_LIGHT, LIGHT_GRAY_BLUE, LIGHT_GREYISH_BLUE, VERY_LIGHT_BLUE, VERY_LIGHT_GRAY, VERY_LIGHT_PINK, VERY_LIGHT_RED, VERY_LIGHT_SKYBLUE, VERY_LIGHT_YELLOW, VERY_LIGHT_YELLOW_2

Fields inherited from interface com.ontimize.gui.SecureElement
DESACTIVATE_COMPONENT_BY_PERMISSION_TIP

Fields inherited from interface com.ontimize.gui.i18n.Internationalization
DEBUG_LANGUAGE

Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, PROPERTIES, SOMEBITS

Constructor Summary

Constructors
Constructor and Description

AbstractMultipleReferenceDataField()

Constructors
Constructor and Description
`AbstractMultipleReferenceDataField()`

Method Summary

Methods
Modifier and Type	Method and Description
`protected void`	`addFormat(String column, Format format)` Adds the format to columns.
`static boolean`	`compareMultipleValue(Object v1, Object v2, List keys)` Compares multiple values from key list.
`protected void`	`createCodeComponents()` Creates a code component.
`protected void`	`createComponent()` Creates component.
`void`	`deleteData()` Deletes data.
`void`	`deleteUserData()` Deletes the user data.
`protected void`	`deleteUserData(boolean withcods)` Deletes the user data.
`protected void`	`enableInnerListener(boolean enable)` Enables the inner listener.
`void`	`free()`
`Vector`	`getAttributes()` Gets the vector with all columns and keys.
`protected Object`	`getCodData(Integer type, String value)` Gets the cod data to check type.
`protected String`	`getDescription(Object value)` Gets the description for all columns in multiple value object.
`String`	`getEntity()`
`protected Format`	`getFormat(String column)` Gets the format to column.
`protected Object`	`getInnerValue()` Gets the inner value.
`protected long`	`getLastCacheTime()`
`Hashtable`	`getParentKeyValues()`
`int`	`getSQLDataType()` Returns the `sql` data type according to `java.sql.Types`
`protected Integer`	`getSQLType(String s)` Checks whether data are integer, string or float, in other case returns an integer.
`Object`	`getValue()` Gets the value of a component.
`Hashtable`	`getValuesToCode(Object code)` Returns the associated values for a code to set in onsetvalueset attributes.
`boolean`	`hasParentKeys()`
`void`	`init(Hashtable parameters)` Initializes parameters and throws `IllegalArgumentException` when required parameters are not present.
`void`	`initCache()` Initializes cache.
`void`	`invalidateCache()` Invalidates the cache.
`boolean`	`isEmpty()` Checks the data existence in component.
`protected EntityResult`	`queryByCode(Object value)` Prepares the object value to perform a query by code.
`void`	`setCacheManager(CacheManager c)`
`protected void`	`setCode(Object codeValue, int valueEventType)` Sets a code to object.
`void`	`setFormatCods(Object value)` Sets the format to visible cods.
`protected abstract void`	`setFormatValue(Object originalValue)`
`void`	`setFormBuilder(FormBuilder constructor)`
`protected void`	`setInnerValue(Object o)` Sets the inner value.
`void`	`setParentFrame(Frame parentFrame)` This method is called from Form for each component that implements this interface.
`void`	`setReferenceLocator(EntityReferenceLocator referenceLocator)` Establishes the reference locator that will be used by component.
`void`	`setResourceBundle(ResourceBundle resource)` Sets the language resource bundle.
`void`	`setValue(Object originalValue)` Sets the value for component.
`void`	`setValue(Object originalValue, boolean intern)` Sets the value to object.
`protected void`	`updateOnSetValueSetAttributes(Hashtable data)` Parameters on this method are used to update the fields whose attributes are contained in `onsetvaluesetAttributes`

Methods inherited from class com.ontimize.gui.field.DataField
addFocusListener, addHelpMenuPopup, addValueChangeListener, changeButton, changeOpacity, checkDefineHelpPermission, checkEnabledPermission, checkVisiblePermission, configurePopupMenuHelp, createFocusListener, createInstanceConditionCombo, createPopupMenu, defineHelpField, finalize, fireValueChanged, getAttribute, getBorder, getConstraints, getDataField, getDisabledbgcolor, getFontColor, getHelpIdString, getHelpPreferenceKey, getLabelComponent, getLabelComponentText, getLabelFontColor, getLabelText, getParentForm, getPreferenceHelpText, getPreferredSize, getText, getTextsToTranslate, getValueChangeListeners, hasHelpInPreferences, initPermissions, initPreferences, installFocusListener, installHelpId, installPopupMenuListener, installPreferenceHelpListener, isAdvancedQueryMode, isEnabled, isHidden, isLabelVisible, isModifiable, isModified, isRequired, isRestricted, parseBoolean, preferenceChanged, removeFocusListener, removeValueChangeListener, requestFocus, seeHelpField, setBold, setComponentLocale, setDisabledbgcolor, setEnabled, setFont, setFontColor, setFontSize, setLabelFontColor, setModifiable, setParentForm, setRequired, setRequiredFieldBackground, setVisible, showPopupMenu, updateBackgroundColor, updateBackgroundColor, updateFont, updateTip, updateUI, validateComponentPositions

Methods inherited from class javax.swing.JPanel
getAccessibleContext, getUI, getUIClassID, paramString, setUI

Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component
action, add, addComponentListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.ontimize.gui.field.DataComponent
getLabelComponentText, isHidden, isModifiable, isModified, isRequired, setModifiable, setRequired

Methods inherited from interface com.ontimize.gui.field.IdentifiedElement
getAttribute

Methods inherited from interface com.ontimize.gui.SecureElement
initPermissions, isRestricted

Methods inherited from interface com.ontimize.gui.field.FormComponent
getConstraints, isEnabled, setEnabled, setVisible

Methods inherited from interface com.ontimize.gui.i18n.Internationalization
getTextsToTranslate, setComponentLocale

Field Detail
- CODS
```
public static final String CODS
```
  Cods property.
  
  See Also:
  Constant Field Values
- TYPECODS
```
public static final String TYPECODS
```
  Typecods property.
  
  See Also:
  Constant Field Values
- ONSETVALUESET
```
public static final String ONSETVALUESET
```
  Typecods property.
  
  See Also:
  Constant Field Values
- PARENT_CODS
```
public static final String PARENT_CODS
```
  Parentcods property.
  
  See Also:
  Constant Field Values
- VISIBLECODS
```
public static final String VISIBLECODS
```
  Visiblecods property.
  
  See Also:
  Constant Field Values
- KEYS
```
public static final String KEYS
```
  Keys property.
  
  See Also:
  Constant Field Values
- PARENT_KEYS
```
public static final String PARENT_KEYS
```
  Parentkeys property.
  
  See Also:
  Constant Field Values
- COLS
```
public static final String COLS
```
  Cols property.
  
  See Also:
  Constant Field Values
- ENTITY
```
public static final String ENTITY
```
  Entity property
  
  See Also:
  Constant Field Values
- CACHETIME
```
public static final String CACHETIME
```
  Cachetime property.
  
  See Also:
  Constant Field Values
- PARENTKEYCACHE
```
public static final String PARENTKEYCACHE
```
  See Also:
  Constant Field Values
- MULTILANGUAGE
```
public static final String MULTILANGUAGE
```
  See Also:
  Constant Field Values
- parentkeyCache
```
protected boolean parentkeyCache
```
- locator
```
protected EntityReferenceLocator locator
```
  The Entity reference Locator that provides a locator to this entity
- onsetvaluesetAttributes
```
protected List onsetvaluesetAttributes
```
  The vector with attributes to update when data field value changed. By default, null.
- cods
```
protected ArrayList cods
```
  An ArrayList where will be inserted the data field names of codes
- typecods
```
protected ArrayList typecods
```
  An ArrayList where the possible types of codes will be inserted. If no other specification(String,Float,Double) exists, the type will be Integer by default. The order must be the same that cods have in Arraylist cods.
visibleCods protected ArrayList visibleCods An ArrayList where the visible column codes will be inserted . If it is empty all codes will be hidden and by default all codes will be visible. jVisibleCods protected Hashtable jVisibleCods An hashtable to put the visible key-component pairs. visiblesize protected Hashtable visiblesize An hashtable to put the visible parameters-position in multiple data field parentCods protected ArrayList parentCods The reference to parent cods. By default, null. keys protected ArrayList keys The reference to keys. By default, null. parentkeys protected ArrayList parentkeys The reference to parent keys. By default, null. cols protected ArrayList cols separator protected String separator A separator reference. By default, ' '. value protected Object value A reference to a value object. By default, null. entity protected String entity cacheTime protected int cacheTime Defines the cache time. By default, the Integer.MAX_VALUE lastCacheTime protected long lastCacheTime The last cache time. By default, zero to query always the first time dataCacheInitialized protected boolean dataCacheInitialized The condition about data cache initialization. By default, false. dataCache protected Hashtable dataCache A data cache. initCacheOnSetValue protected boolean initCacheOnSetValue The condition to initialize cache on setValue. By default, false. useCacheManager protected boolean useCacheManager The condition to use cache manager. By default, true. cacheManager protected CacheManager cacheManager A reference to cache manager. By default, null. formatColumn protected Hashtable formatColumn The format column. valueEventDisabled protected boolean valueEventDisabled The condition to disable events. By default, false. multilanguage protected boolean multilanguage The condition to disable cache innerListener protected AbstractMultipleReferenceDataField.InnerListener innerListener A reference to inner Listener. By default, null. codListener protected AbstractMultipleReferenceDataField.CodFieldListener codListener An instance of cod field listener.







Constructor Detail





AbstractMultipleReferenceDataField
public AbstractMultipleReferenceDataField()









Method Detail





createComponent
protected void createComponent()
Creates component. Empty method.







createCodeComponents
protected void createCodeComponents()
Creates a code component. Uses visibleCods,visiblesize
 and adds listeners.







init
public void init(Hashtable parameters)
Initializes parameters and throws IllegalArgumentException when
 required parameters are not present.
 

Specified by:
init in interface FormComponent
Overrides:
init in class DataField
Parameters:
parameters - the Hashtable with parameters

            

            

            
            attribute
            values
            default
            required
            meaning
            

            
            attr
            
            
            yes
            An AbstractMultipleReferenceDataField object. It
            is used to get a reference for field
            


            
            keys
            key1;key2;...;keyn
            
            yes
            This attribute contains columns that are keys in entity of
            current form.
            

            
            cods
            cod1;cod2;...;codn
            keys
            yes
            This parameter refers to the keys of entity that is
            queried. We need keys and cods because, keys in entity and
            form accept different names.
            

            
            visiblecods
            vcod1;vcod2;...;vcodn
            
            no
            The number of boxes showed on the left of description
            field. Each visible cods is used to select an individual cod.
            

            
            typecods
            vtcod1;vtcod2;...;vtcodn
            Integer
            no
            The class type of cods. To indicate other types for cods,
            they should be ordered like cods
            

            
            parentkeys
            pk1;pk2;...;pkn
            parentcods
            no
            Attribute used to filter MultipleReferenceDataField. It
            will contain all attributes whose values will be extracted of
            current form to filter the field.
            

            
            parentcods
            pcod1;pcod2;...;pcodn
            parentkeys
            no
            This parameter refers to the parentkeys of entity that is
            queried. Sometimes, we need parentkeys and parentcods because
            columns in entity and form accept different names. This
            parameter must be ordered in same manner that parentkeys, to
            establish the correspondence position by position.
            

            
            entity
            
            
            yes
            The entity to obtain the data
            


            
            cols
            col1;col2;...;coln
            
            yes
            The cols to show both in description of field and in table
            to select records.
            

            
            onsetvalueset
            
            
            
            Field attributes whose value will be set when field data
            change.
            

            
            multilanguage
            yes/no
            no
            no
            If yes, invalidate the cache data.
            

            







getSQLType
protected Integer getSQLType(String s)
Checks whether data are integer, string or float, in other case returns
 an integer.
 
Parameters:
s - the data type
Returns:
the SQL type







updateOnSetValueSetAttributes
protected void updateOnSetValueSetAttributes(Hashtable data)
Parameters on this method are used to update the fields whose attributes
 are contained in onsetvaluesetAttributes
Parameters:
data - Values to update







getValuesToCode
public Hashtable getValuesToCode(Object code)
Returns the associated values for a code to set in onsetvalueset
 attributes.
 
Parameters:
code - the object where code are specified
Returns:
the key-value pairs







getCodData
protected Object getCodData(Integer type,
                String value)
                     throws Exception
Gets the cod data to check type.
 
Parameters:
type - the cod data type.
value - the string to check cod data.
Returns:
the type in function of Types
Throws:
Exception - when Exception occurs.







getSQLDataType
public int getSQLDataType()
Description copied from interface: DataComponent
Returns the sql data type according to
 java.sql.Types
 

Specified by:
getSQLDataType in interface DataComponent
Returns:
the Integer type







getLastCacheTime
protected long getLastCacheTime()







getValue
public Object getValue()
Description copied from interface: DataComponent
Gets the value of a component.
 

Specified by:
getValue in interface DataComponent
Returns:
the object with value.







setValue
public void setValue(Object originalValue)
Description copied from interface: DataComponent
Sets the value for component.
 

Specified by:
setValue in interface DataComponent
Parameters:
originalValue - the object with value to set







setValue
public void setValue(Object originalValue,
            boolean intern)
Sets the value to object. Checks whether object is a multiple value.
 
Parameters:
originalValue - the object to set value
intern - the condition about intern listener state.







setFormatValue
protected abstract void setFormatValue(Object originalValue)







setFormatCods
public void setFormatCods(Object value)
Sets the format to visible cods.
 
Parameters:
value - the object to set the cods.







setReferenceLocator
public void setReferenceLocator(EntityReferenceLocator referenceLocator)
Description copied from interface: ReferenceComponent
Establishes the reference locator that will be used by component. This
 method is automatically called by Form when it is being loaded.

Specified by:
setReferenceLocator in interface ReferenceComponent
Parameters:
referenceLocator - a reference locator to set in component







setParentFrame
public void setParentFrame(Frame parentFrame)
Description copied from interface: OpenDialog
This method is called from Form for each component that implements this
 interface. It fixes the parent frame for element. This frame is needed to
 open the modal dialog.

Specified by:
setParentFrame in interface OpenDialog
Parameters:
parentFrame - the frame







free
public void free()
          throws Exception
Throws:
Exception







setFormBuilder
public void setFormBuilder(FormBuilder constructor)

Specified by:
setFormBuilder in interface CreateForms








getEntity
public String getEntity()

Specified by:
getEntity in interface CachedComponent








setCacheManager
public void setCacheManager(CacheManager c)

Specified by:
setCacheManager in interface CachedComponent








isEmpty
public boolean isEmpty()
Description copied from interface: DataComponent
Checks the data existence in component.
 

Specified by:
isEmpty in interface DataComponent
Returns:
true when component is empty







getAttributes
public Vector getAttributes()
Gets the vector with all columns and keys.
 

Specified by:
getAttributes in interface CachedComponent
Returns:
the vector with all columns and keys.







initCache
public void initCache()
Initializes cache. It uses the cachemanager when parentkeys are not
 present.







invalidateCache
public void invalidateCache()
Invalidates the cache. Sets dataCacheInitialized to false.







queryByCode
protected EntityResult queryByCode(Object value)
Prepares the object value to perform a query by code.
 
Parameters:
value - the object to query
Returns:
the query result







deleteData
public void deleteData()
Deletes data. It sets null in all formats (value and cods).


Specified by:
deleteData in interface DataComponent








deleteUserData
public void deleteUserData()
Deletes the user data. Calls to deleteUserData(boolean) with
 true parameter.







deleteUserData
protected void deleteUserData(boolean withcods)
Deletes the user data.
 
Parameters:
withcods - the cods or no cods presence







getDescription
protected String getDescription(Object value)
Gets the description for all columns in multiple value object.
 
Parameters:
value - the multiple value object to get description
Returns:
the description







getFormat
protected Format getFormat(String column)
Gets the format to column.
 
Parameters:
column - the name of column
Returns:
the current column format







addFormat
protected void addFormat(String column,
             Format format)
Adds the format to columns.
 
Parameters:
column - the column
format - the format to apply







enableInnerListener
protected void enableInnerListener(boolean enable)
Enables the inner listener.
 
Parameters:
enable - the condition to enable the listener







getInnerValue
protected Object getInnerValue()
Gets the inner value.
 
Returns:
the inner value







setInnerValue
protected void setInnerValue(Object o)
Sets the inner value.
 
Parameters:
o - the object to set the inner value.







setCode
protected void setCode(Object codeValue,
           int valueEventType)
Sets a code to object. It calls to setValue(Object) after
 looking the data cache or the queryByCode(Object).
 
Parameters:
codeValue - the hashtable to set the multiple value
valueEventType - the value event type







compareMultipleValue
public static boolean compareMultipleValue(Object v1,
                           Object v2,
                           List keys)
Compares multiple values from key list.
 
Parameters:
v1 - the object 1
v2 - the object 2
keys - the list of keys
Returns:
true when two multiple value objects are equals







hasParentKeys
public boolean hasParentKeys()







getParentKeyValues
public Hashtable getParentKeyValues()







setResourceBundle
public void setResourceBundle(ResourceBundle resource)
Description copied from interface: Internationalization
Sets the language resource bundle. When the application changes the
 configured language, for all the objects that implement this interface
 this method must be called with the new file. 

 The method must translate all the elements that have texts in the GUI

Specified by:
setResourceBundle in interface Internationalization
Overrides:
setResourceBundle in class DataField
Parameters:
resource - the new language bundle.

attribute	values	default	required	meaning
attr			yes	An `AbstractMultipleReferenceDataField` object. It is used to get a reference for field
keys	key1;key2;...;keyn		yes	This attribute contains columns that are keys in entity of current form.
cods	cod1;cod2;...;codn	keys	yes	This parameter refers to the keys of entity that is queried. We need keys and cods because, keys in entity and form accept different names.
visiblecods	vcod1;vcod2;...;vcodn		no	The number of boxes showed on the left of description field. Each visible cods is used to select an individual cod.
typecods	vtcod1;vtcod2;...;vtcodn	Integer	no	The class type of cods. To indicate other types for cods, they should be ordered like `cods`
parentkeys	pk1;pk2;...;pkn	parentcods	no	Attribute used to filter MultipleReferenceDataField. It will contain all attributes whose values will be extracted of current form to filter the field.
parentcods	pcod1;pcod2;...;pcodn	parentkeys	no	This parameter refers to the parentkeys of entity that is queried. Sometimes, we need parentkeys and parentcods because columns in entity and form accept different names. This parameter must be ordered in same manner that parentkeys, to establish the correspondence position by position.
entity			yes	The entity to obtain the data
cols	col1;col2;...;coln		yes	The cols to show both in description of field and in table to select records.
onsetvalueset				Field attributes whose value will be set when field data change.
multilanguage	yes/no	no	no	If yes, invalidate the cache data.

Class AbstractMultipleReferenceDataField

Nested Class Summary

Nested classes/interfaces inherited from class com.ontimize.gui.field.DataField

Nested classes/interfaces inherited from class javax.swing.JPanel

Nested classes/interfaces inherited from class javax.swing.JComponent

Nested classes/interfaces inherited from class java.awt.Container

Nested classes/interfaces inherited from class java.awt.Component

Field Summary

Fields inherited from class com.ontimize.gui.field.DataField

Fields inherited from class javax.swing.JComponent

Fields inherited from class java.awt.Component

Fields inherited from interface com.ontimize.gui.field.DataComponent

Fields inherited from interface com.ontimize.gui.SecureElement

Fields inherited from interface com.ontimize.gui.i18n.Internationalization

Fields inherited from interface java.awt.image.ImageObserver

Constructor Summary

Method Summary

Methods inherited from class com.ontimize.gui.field.DataField

Methods inherited from class javax.swing.JPanel

Methods inherited from class javax.swing.JComponent

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

Methods inherited from interface com.ontimize.gui.field.DataComponent

Methods inherited from interface com.ontimize.gui.field.IdentifiedElement

Methods inherited from interface com.ontimize.gui.SecureElement

Methods inherited from interface com.ontimize.gui.field.FormComponent

Methods inherited from interface com.ontimize.gui.i18n.Internationalization

Field Detail

CODS

TYPECODS

ONSETVALUESET

PARENT_CODS

VISIBLECODS

KEYS

PARENT_KEYS

COLS

ENTITY

CACHETIME

PARENTKEYCACHE

MULTILANGUAGE

parentkeyCache

locator

onsetvaluesetAttributes

cods

typecods

visibleCods

jVisibleCods

visiblesize

parentCods

keys

parentkeys

cols

separator

value

entity

cacheTime

lastCacheTime

dataCacheInitialized

dataCache

initCacheOnSetValue

useCacheManager

cacheManager

formatColumn

valueEventDisabled

multilanguage

innerListener

codListener

Constructor Detail

AbstractMultipleReferenceDataField

Method Detail

createComponent

createCodeComponents

init

getSQLType

updateOnSetValueSetAttributes

getValuesToCode

getCodData

getSQLDataType

getLastCacheTime