com.jFormTK
Class DynamicReference

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

public abstract class DynamicReference
extends java.lang.Object
implements JConstants

        This is an Abstract class with a collection of methods designed to produce the
        'jFormTK' Dynamic Reference feature...
 
 

Version:
1.00, 28, April 2004
Author:
Jim Crowell
Professional Computer Solutions [PCS]
URL: http://jFormTK.com/
E-Mail: JimCrowell@EMail.com

Copyright (c) 2009 by Professional Computer Solutions [PCS]
All Rights Reserved

Field Summary
 
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, 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
DynamicReference()
           
 
Method Summary
static java.lang.String transform(java.lang.String messageIn)
           This method is designed to perform any indirect Reference's that exist in the given input String [messageIn].
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DynamicReference

public DynamicReference()
Method Detail

transform

public static java.lang.String transform(java.lang.String messageIn)
        This method is designed to perform any indirect Reference's that exist in the
        given input String [messageIn]. The Indirect Reference prefix string are as
        follows:
                    -       'JAddressBook' Element Reference...
                        Syntax: (name,type)
                                        ((jFormTKID),type)  
                                        e.g. (James E. Crowell, Phone), ((Cat1.Form1.test0.0),Type)
                             -       'AppCommonDB' Element Reference...
                        Syntax: element_name
                                        e.g. Registered_Name, Registered_Street, Registered_ZIP"
                    -       'AppDB' Element Reference...
                        Syntax: element_name
                                        e.g. appAcronym
                (jFormTK ID)    *       See NOTE below
                the Indirect Reference to a 'JFormField' element...
                e.g.    this method shall replace the "(Cat1.Form1.Field1.0)" 
                                String with the value of the "Cat1.Form1.Field1.0"
                                JFormField instance...
                NOTE:
                There is a special case for this Indirect Reference transform.
                If the "(...)" annotation is found,
                Then no transform is made and the transform process is immediately aborted...
                This special annotation, i.e. "(...)", is used when displaying a line of
                Java code in the 'JHDD_IO.updateJWorkSheet' method to avoid unexpected
                Indirect Addressing caused by the arguments to a Java method... 
                
        This DynamicReference method is used to decode messages to the 'jFormTK'
        Application     End User or to decode Table Headers. This process uses the JValue
        Class [via the 'doReferences' private method] to preform the requested indirect
        operation...

        Kernel Usage:
        1)      'jFocus.NonNullDialog' to convert the 'annotation' String provided by
                the 'jFormTK' Developer OR the 'jFormTKDB' default...
        2)      'jFormFrame.NonNullDialog' to convert the 'annotation' String provided by
                the 'jFormTK' Developer OR the 'jFormTKDB' default...
        3)      'JMessage.Constructor' to convert any "Indirect References" in the given
                'message' String...
        4)      'JFormTKDB.getTablePrintControls' to convert the 'MessageTable' Class
                Header as required by the current 'JFormTKDB' Header String...
        5)      'ableEditDialog.GetFieldOfGroupDialog' Constructor to convert message
                fields for indirect references...       
        

Parameters:
messageIn - String with the above indirect reference codes...
Returns:
String with the indirect reference values...