com.jFormTK
Class JForwardReference

java.lang.Object
  extended by com.jFormTK.JForwardReference
All Implemented Interfaces:
JConstants

public class JForwardReference
extends java.lang.Object
implements JConstants

        This jFormTK Class is design to hold all forward references, i.e. references to
        'JFormField' Fields in 'JFormForm' SubClass Forms that have not been loaded by the
        Application End User...

        A single instance of this class is instanced and hosted by the AppDB 'jFormTK' Class
        during the Application Initialization Phase...

        As Forward References are serviced by the 'jFormTK' Kernel the Application End User
        is allowed to enter an assignment value for the yet to be loaded 'JFormField' object.
        [using the jFormTK.JForwardReferenceQuery Class]...

        If the End User indicates that a value shall be assigned to the Forward Referenced
        Field,
        Then
                the Referenced Form's ID, the Field ID and the assigned value String are placed
                into the 'JForwardReference' instance for usage when the Referenced Form is
                loaded.

        As each 'JFormForm' SubClass is initially loaded, the 'JForwardReference' instance is
        used to set the value field for any JFormField's contained therein.

        The 'JForwardReference' content is saved with the JAddressBook instance so that
        Forward References made between 'jFormTK' Application executions are persistant.  

        Kernel Usage:
        1)      'AppDB.initialize' method to create the AppDB hosted instance of this 'jFormTK'
                "Holder" Class...
        

Version:
1.00, 08 April 2005
Author:
Jim Crowell Professional Computer Solutions [PCS] URL: http://jFormTK.com/ E-Mail: JimCrowell@EMail.com Copyright (c) 2005 by Professional Computer Solutions [PCS] All Rights Reserved

Field Summary
protected  java.util.Vector references
           
 
Fields inherited from interface com.jFormTK.JConstants
__, _AB, _AB_, _AField, _B, _BField, _CField, _CIField, _DField, _EU_, _H, _HEIGHT, _HEIGHT_INV, _HField, _I, _IField, _LField, _MField, _NField, _NotRequired, _PField, _PIField, _QField, _Required, _RField, _TAField, _TField, _WIDTH, _WIDTH_INV, _XField, AB, APP_TRACE_FOCUS, APP_TRACE_GET, APP_TRACE_SET, B_, BAR, BAR_, BB, BH, BI, BREAKPOINT_FOCUS, BREAKPOINT_GET, BREAKPOINT_SET, BVB, C_QUOTE, CLOSE, CLOSE_BRACKET, COLORS_DELIMITER, COMMA, COMMA_, D_ELEMENT, D_ELEMENT_N, D_ELEMENT_N1, D_ELEMENT_N2, D_ELEMENT_N3, D_FIELDS, D_FIELDS_N, D_FIELDS_N1, D_FIELDS_N2, D_FIELDS_N3, D_ITEMS, DASH, DOT, EOL, EOP, EOS, FIELD_TRACE_FOCUS, FIELD_TRACE_GET, FIELD_TRACE_SET, FONT_DELIMITER, H_, HB, HH, HI, I_, IB, IH, II, JLAF_DELIMITER, LF, LISTBRACKET, NO, OPEN, OPEN_BRACKET, pCheckboxGroup, QUOTE, SPACE_, TAB, YES
 
Constructor Summary
JForwardReference()
           
 
Method Summary
 void add(java.lang.String[] fields)
           Add a Forward Reference to this 'JForwardReference' instance...
 void add(java.lang.String id, java.lang.String value)
           Add a Forward Reference to this 'JForwardReference' instance...
 void add(java.lang.String formID, java.lang.String fieldID, java.lang.String value)
           Add a Forward Reference to this 'JForwardReference' instance...
 java.util.Vector get(java.lang.String formIDIN)
           Search the current 'references' vector for occurrences of the given 'JFormForm' SubClass IF [formIDIN].
 boolean hasForwardReference(java.lang.String formIDIN)
           Search the current 'references' Control Vector to determine if there is a refereence for the given 'JFormForm' SubClass ID [formIDIN]...
 void showJForwardReference()
           
 java.lang.String toString()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

references

protected java.util.Vector references
Constructor Detail

JForwardReference

JForwardReference()
Method Detail

add

public void add(java.lang.String formID,
                java.lang.String fieldID,
                java.lang.String value)
        Add a Forward Reference to this 'JForwardReference' instance...

        Kernel Usage:
        1)      'JForwardReferenceQuery.Query.actionListener' to add the Forward Reference
                value provided by the 'jFormTK' Application End User...
        

Parameters:
formID - Referenced 'JFormForm' SubClass ID...
fieldID - Referenced 'JFormField' ID...
value - Value [String] to be assigned the referenced field...

add

public void add(java.lang.String id,
                java.lang.String value)
        Add a Forward Reference to this 'JForwardReference' instance...

        Kernel Usage:
        1)      TBD...
        

Parameters:
id - Referenced Full Field ID, i.e. FormID.FieldID...
value - Value [String] to be assigned the referenced field...

add

public void add(java.lang.String[] fields)
        Add a Forward Reference to this 'JForwardReference' instance...

        Kernel Usage:
        1)      TBD...
        

Parameters:
fields - String Array of FormID, fieldID, Value sets to be added to this 'JForwardReference' instance...

get

public java.util.Vector get(java.lang.String formIDIN)
        Search the current 'references' vector for occurrences of the given
        'JFormForm' SubClass IF [formIDIN]. Return a Vector of matching Forward
        Reference Strings OR a 'null'...

        Kernel Usage:
        1)      'JFormFrame.loadFormFieldsVector' method to get Forward reference
                parameters [in a Vector] for the 'JFormForm' SubClass being loaded.
                If any Forward references exist,
                Then    the associated text values are set in the respective 'JFormField'
                                instance...
        

Parameters:
formIDIN - 'jFormTK' Form ID to be referenced...
Returns:
Vector of matching Forward References OR 'null'

hasForwardReference

public boolean hasForwardReference(java.lang.String formIDIN)
        Search the current 'references' Control Vector to determine if there
        is a refereence for the given 'JFormForm' SubClass ID [formIDIN]...

        Kernel Usage:
        1)      'JFormFrame.loadFormFieldsVector' Method when the "Referenced" 'JFormForm'
                SubClass has not been initialized...
        

Parameters:
formIDIN - FormID String for the 'JFormForm' SubClass to be loaded...
Returns:
Flag [boolean] as a function of the occurrence of the given Form ID in the 'references' Control Vector...

showJForwardReference

public void showJForwardReference()

toString

public java.lang.String toString()
Overrides:
toString in class java.lang.Object