org.sandev.basics.sandmessages
Class AuthWrapper

java.lang.Object
  extended by org.sandev.basics.structs.AuthWrapperStruct
      extended by org.sandev.basics.sandmessages.AuthWrapper
All Implemented Interfaces:
SandInstanceMessage, SandMessage, SandStructMessage, SandTransmitMessage, Resolvable

public class AuthWrapper
extends AuthWrapperStruct
implements SandStructMessage, Resolvable, SandTransmitMessage

AUTOGENERATED FILE, DO NOT EDIT DIRECTLY.
source: org.sandev.basics.structs.AuthWrapperStruct
generator: org.sandev.generator.MessageClassGenerator
time: Jun 15, 2007 11:40:44 PM


Field Summary
protected  int sandTransmissionCount
          Counter to aid in tracking receipt of sent messages.
protected  java.util.Locale sandTransmissionLocale
          The Locale in effect for the current transmission.
protected  long sandTransmitAuthID
          The uniqueID of the authorized user of this message.
protected  java.lang.String sandTransmitErrorCode
          Optional code associated with the transmission error.
protected  java.lang.String sandTransmitErrorMessage
          Text details of the transmission error.
protected  int sandTransmitStatus
          Status of the message.
 
Fields inherited from class org.sandev.basics.structs.AuthWrapperStruct
message
 
Fields inherited from interface org.sandev.basics.structs.SandInstanceMessage
FIELDCHECK_EMPTYSTRINGPRINTVAL, FIELDCHECK_INVALIDVAL, FIELDCHECK_NOTAREF, FIELDCHECK_NOTINRANGE, FIELDCHECK_NULLARRAY, FIELDCHECK_STRINGOVER, FIELDCHECK_UNKNOWNVAL, FIELDFLAG_BINARY, FIELDFLAG_ENCRYPT, FIELDFLAG_INTERNAL, FIELDFLAG_NOECHO, FIELDFLAG_OBFUSCATE, FIELDFLAG_STRINGPERSIST, FIELDFLAG_SUMMARYEDIT, FIELDFLAG_UNIQUE, GENMOD_ACTION_APPEND, GENMOD_ACTION_INSERT, GENMOD_ACTION_REMOVE, GENMOD_ACTION_SET
 
Fields inherited from interface org.sandev.basics.structs.SandTransmitMessage
APPERROR_NODE_UNAVAILABLE, APPERROR_NODE_UNKNOWN, APPERROR_NODE_UNREACHABLE, STATUS_APPERROR, STATUS_NORMAL, STATUS_SANDERROR, STATUS_SYSERROR
 
Constructor Summary
AuthWrapper()
          Default constructor calls init.
 
Method Summary
 AuthWrapper cloneAuthWrapper()
          Make a deep copy of this AuthWrapper.
 SandInstanceMessage cloneMessage()
          Calls cloneAuthWrapper
 SandInstanceMessage convertToSuperstructClass()
          Return a new instance of the message associated with the superstruct of this instance.
 void copyDataFrom(AuthWrapper other)
          Deep copy all the data from the specified instance.
 void copyFieldValue(java.lang.String fieldName, SandInstanceMessage other)
          Copy the specified field from the given instance.
 java.lang.String debugDump(java.lang.String prefix)
          Dump this instance into a debug printable string.
 void defaultField(java.lang.String fieldname)
          Set the specified field to its default value.
 boolean fieldHasFlag(java.lang.String fieldname, int fieldflag)
          Return true if the named field declares the indicated flag, false otherwise.
 boolean fieldsValid()
          Validate the fields as specified in the SandInstanceMessage interface
 SandAttrVal[] fieldValidate(SandAttrVal[] checkFields)
          Validate the fields as specified in the SandInstanceMessage interface
 SandCollectionMessage find(SandQueryMessage sqm)
          Return a matching collection of all directly contained instances matching the given query.
 java.lang.Object generalAccessor(java.lang.String fieldspec)
          General field accessor method.
 SandAttrVal generalDereference(java.lang.String fieldspec)
          General reference field accessor method.
 void generalModifier(int action, java.lang.String field, int index, java.lang.Object val)
          General mutator method.
 java.lang.String[] getAllFields()
          Return an array of all fields for this class.
 SandCollectionMessage getCollectionMessage()
          Returns null
 java.lang.String[] getContainedMessageFields()
          Return an array of all contained message fields.
 java.lang.String[] getDisplayFields()
          Return an array of the summary field names for this class.
 java.lang.String[] getDisplayFieldsPrint()
          Return an array of the summary field print names for this class.
 java.lang.String getDisplayID()
          Return the displayID for this message instance
 java.lang.String[] getDisplayValues()
          Return the values for the summary fields.
 java.lang.String[] getDisplayValues(IDLookup lookup, AuthUser user, java.lang.String defaultVal)
          Return the values for the summary fields, including dereference expressions.
 SandPersistMessage getInstance(java.lang.String classname, long id)
          If this instance directly contains the specified instance, then find it and return it.
 SandInstanceMessage getInstance(java.lang.String classname, java.lang.String fieldname, java.lang.String value)
          If this instance directly contains the specified instance, then find it and return it.
 java.lang.String getMessage()
          Accessor for message
static java.lang.String getMessageDefaultValue()
          Default value for message.
 java.lang.String getMessageFieldPrintValue()
          Return the print name of the message field.
static boolean getMessageFlag(int fieldflag)
          Field flag accessor.
static java.lang.String getMessageInvalidValue()
          Invalid value for message.
static int getMessageLengthMax()
          Maximum message length is 2097152 characters
static int getMessageLengthNorm()
          Normal message length is 1024 characters
 java.lang.String getMessageMetatype()
          Return the metatype text for this field, or "" if no metatype was declared.
 java.lang.String getMessagePrintValue()
          Retrieve the current value of this field as a print String.
 java.lang.String getMessageRange()
          Return the range specification for this field
 java.lang.String getMessageValidityCheck()
          Return the empty string if the value of this field is valid according to the base SAND declarations.
 java.lang.String getPrintname()
          Return the printname of the class
 java.lang.String getPrintnameForField(java.lang.String fieldname)
          Given a fieldname, return its declared printname if declared.
 SandQueryMessage getQueryMessage()
          Returns null
 int getSandTransmissionCount()
          Accessor for sandTransmissionCount
static int getSandTransmissionCountDefaultValue()
          Default value for sandTransmissionCount.
 java.lang.String getSandTransmissionCountFieldPrintValue()
          Return the print name of the sandTransmissionCount field.
static boolean getSandTransmissionCountFlag(int fieldflag)
          Field flag accessor.
static int getSandTransmissionCountInvalidValue()
          Invalid value for sandTransmissionCount.
 java.lang.String getSandTransmissionCountMetatype()
          Return the metatype text for this field, or "" if no metatype was declared.
 java.lang.String getSandTransmissionCountPrintValue()
          Retrieve the current value of this field as a print String.
 java.lang.String getSandTransmissionCountRange()
          Return the range specification for this field
 java.lang.String getSandTransmissionCountValidityCheck()
          Return the empty string if the value of this field is valid according to the base SAND declarations.
 java.util.Locale getSandTransmissionLocale()
          Accessor for sandTransmissionLocale
static java.util.Locale getSandTransmissionLocaleDefaultValue()
          Default value for sandTransmissionLocale.
 java.lang.String getSandTransmissionLocaleFieldPrintValue()
          Return the print name of the sandTransmissionLocale field.
static boolean getSandTransmissionLocaleFlag(int fieldflag)
          Field flag accessor.
static java.util.Locale getSandTransmissionLocaleInvalidValue()
          Invalid value for sandTransmissionLocale.
 java.lang.String getSandTransmissionLocaleMetatype()
          Return the metatype text for this field, or "" if no metatype was declared.
 java.lang.String getSandTransmissionLocalePrintValue()
          Retrieve the current value of this field as a print String.
 java.lang.String getSandTransmissionLocaleRange()
          Return the range specification for this field
 java.lang.String getSandTransmissionLocaleValidityCheck()
          Return the empty string if the value of this field is valid according to the base SAND declarations.
 long getSandTransmitAuthID()
          Accessor for sandTransmitAuthID
static long getSandTransmitAuthIDDefaultValue()
          Default value for sandTransmitAuthID.
 java.lang.String getSandTransmitAuthIDFieldPrintValue()
          Return the print name of the sandTransmitAuthID field.
static boolean getSandTransmitAuthIDFlag(int fieldflag)
          Field flag accessor.
static long getSandTransmitAuthIDInvalidValue()
          Invalid value for sandTransmitAuthID.
 java.lang.String getSandTransmitAuthIDMetatype()
          Return the metatype text for this field, or "" if no metatype was declared.
 java.lang.String getSandTransmitAuthIDPrintValue()
          Retrieve the current value of this field as a print String.
 java.lang.String getSandTransmitAuthIDRange()
          Return the range specification for this field
 java.lang.String getSandTransmitAuthIDValidityCheck()
          Return the empty string if the value of this field is valid according to the base SAND declarations.
 java.lang.String getSandTransmitErrorCode()
          Accessor for sandTransmitErrorCode
static java.lang.String getSandTransmitErrorCodeDefaultValue()
          Default value for sandTransmitErrorCode.
 java.lang.String getSandTransmitErrorCodeFieldPrintValue()
          Return the print name of the sandTransmitErrorCode field.
static boolean getSandTransmitErrorCodeFlag(int fieldflag)
          Field flag accessor.
static java.lang.String getSandTransmitErrorCodeInvalidValue()
          Invalid value for sandTransmitErrorCode.
static int getSandTransmitErrorCodeLengthMax()
          Maximum sandTransmitErrorCode length is 70 characters
static int getSandTransmitErrorCodeLengthNorm()
          Normal sandTransmitErrorCode length is 30 characters
 java.lang.String getSandTransmitErrorCodeMetatype()
          Return the metatype text for this field, or "" if no metatype was declared.
 java.lang.String getSandTransmitErrorCodePrintValue()
          Retrieve the current value of this field as a print String.
 java.lang.String getSandTransmitErrorCodeRange()
          Return the range specification for this field
 java.lang.String getSandTransmitErrorCodeValidityCheck()
          Return the empty string if the value of this field is valid according to the base SAND declarations.
 java.lang.String getSandTransmitErrorMessage()
          Accessor for sandTransmitErrorMessage
static java.lang.String getSandTransmitErrorMessageDefaultValue()
          Default value for sandTransmitErrorMessage.
 java.lang.String getSandTransmitErrorMessageFieldPrintValue()
          Return the print name of the sandTransmitErrorMessage field.
static boolean getSandTransmitErrorMessageFlag(int fieldflag)
          Field flag accessor.
static java.lang.String getSandTransmitErrorMessageInvalidValue()
          Invalid value for sandTransmitErrorMessage.
static int getSandTransmitErrorMessageLengthMax()
          Maximum sandTransmitErrorMessage length is 70 characters
static int getSandTransmitErrorMessageLengthNorm()
          Normal sandTransmitErrorMessage length is 30 characters
 java.lang.String getSandTransmitErrorMessageMetatype()
          Return the metatype text for this field, or "" if no metatype was declared.
 java.lang.String getSandTransmitErrorMessagePrintValue()
          Retrieve the current value of this field as a print String.
 java.lang.String getSandTransmitErrorMessageRange()
          Return the range specification for this field
 java.lang.String getSandTransmitErrorMessageValidityCheck()
          Return the empty string if the value of this field is valid according to the base SAND declarations.
 int getSandTransmitStatus()
          Accessor for sandTransmitStatus
static int getSandTransmitStatusDefaultValue()
          Default value for sandTransmitStatus.
 java.lang.String getSandTransmitStatusFieldPrintValue()
          Return the print name of the sandTransmitStatus field.
static boolean getSandTransmitStatusFlag(int fieldflag)
          Field flag accessor.
static int getSandTransmitStatusInvalidValue()
          Invalid value for sandTransmitStatus.
 java.lang.String getSandTransmitStatusMetatype()
          Return the metatype text for this field, or "" if no metatype was declared.
 java.lang.String getSandTransmitStatusPrintValue()
          Retrieve the current value of this field as a print String.
 java.lang.String getSandTransmitStatusRange()
          Return the range specification for this field
 java.lang.String getSandTransmitStatusValidityCheck()
          Return the empty string if the value of this field is valid according to the base SAND declarations.
 java.lang.String getShortName()
          Returns the unqualified name of this message.
 SandStructMessage getStructMessage()
          Returns a new AuthWrapper instance
 SandUpdateMessage getUpdateMessage()
          Returns null
 java.lang.String getValueForFieldName(java.lang.String fieldname, IDLookup lookup, AuthUser user, java.lang.String defaultVal)
          Returns the print representation of the value of the specified field, or the given default value if innaccessible.
 void init()
          Initialize all fields to their default values
 boolean isEquivalent(SandMessage sm)
          Declared field equivalence check as specified by the SandMessage interface.
 java.lang.String[] referenceValidate(java.lang.String[] locations, java.lang.String prefix, IDLookup idlookup, NameLookup namelookup, AuthUser au)
          Validate the references as specified in the Resolvable interface.
 void setMessage(java.lang.Object message)
          Generic mutator for message
 void setMessage(java.lang.String message)
          Mutator for message
 void setSandTransmissionCount(int sandTransmissionCount)
          Mutator for sandTransmissionCount
 void setSandTransmissionLocale(java.util.Locale sandTransmissionLocale)
          Mutator for sandTransmissionLocale
 void setSandTransmissionLocale(java.lang.Object sandTransmissionLocale)
          Generic mutator for sandTransmissionLocale
 void setSandTransmitAuthID(long sandTransmitAuthID)
          Mutator for sandTransmitAuthID
 void setSandTransmitError(java.lang.String code, java.lang.String errText)
          Sets both the code and the error in a single method.
 void setSandTransmitErrorCode(java.lang.Object sandTransmitErrorCode)
          Generic mutator for sandTransmitErrorCode
 void setSandTransmitErrorCode(java.lang.String sandTransmitErrorCode)
          Mutator for sandTransmitErrorCode
 void setSandTransmitErrorMessage(java.lang.Object sandTransmitErrorMessage)
          Generic mutator for sandTransmitErrorMessage
 void setSandTransmitErrorMessage(java.lang.String sandTransmitErrorMessage)
          Mutator for sandTransmitErrorMessage
 void setSandTransmitStatus(int sandTransmitStatus)
          Mutator for sandTransmitStatus
 java.lang.String toString()
          Return a string representation of this object.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

sandTransmitStatus

protected int sandTransmitStatus
Status of the message. Possible values are defined in SandTransmitMessage.


sandTransmitErrorMessage

protected java.lang.String sandTransmitErrorMessage
Text details of the transmission error.


sandTransmitErrorCode

protected java.lang.String sandTransmitErrorCode
Optional code associated with the transmission error.


sandTransmissionCount

protected int sandTransmissionCount
Counter to aid in tracking receipt of sent messages.


sandTransmissionLocale

protected java.util.Locale sandTransmissionLocale
The Locale in effect for the current transmission.


sandTransmitAuthID

protected long sandTransmitAuthID
The uniqueID of the authorized user of this message.

Constructor Detail

AuthWrapper

public AuthWrapper()
Default constructor calls init.

Method Detail

getPrintname

public java.lang.String getPrintname()
Return the printname of the class

Specified by:
getPrintname in interface SandStructMessage

fieldHasFlag

public boolean fieldHasFlag(java.lang.String fieldname,
                            int fieldflag)
Return true if the named field declares the indicated flag, false otherwise. See the FIELDFLAG* constants in SandInstanceMessage for supported fieldflag values.

Specified by:
fieldHasFlag in interface SandInstanceMessage

getMessage

public java.lang.String getMessage()
Accessor for message


setMessage

public void setMessage(java.lang.String message)
Mutator for message


setMessage

public void setMessage(java.lang.Object message)
Generic mutator for message


getMessageFlag

public static boolean getMessageFlag(int fieldflag)
Field flag accessor. Returns whether the given FIELDFLAG_* (defined in SandInstanceMessage) is true or false.


getMessageLengthNorm

public static int getMessageLengthNorm()
Normal message length is 1024 characters


getMessageLengthMax

public static int getMessageLengthMax()
Maximum message length is 2097152 characters


getMessageDefaultValue

public static java.lang.String getMessageDefaultValue()
Default value for message. Returns ""


getMessageInvalidValue

public static java.lang.String getMessageInvalidValue()
Invalid value for message. Returns ""


getMessagePrintValue

public java.lang.String getMessagePrintValue()
Retrieve the current value of this field as a print String. For a String field, this returns the current value. For int, long, double this returns the standard string conversion. For a Date, this returns the default DateFormat format. For an enum, this returns the Actual2Print translation of the current value. For a struct this returns a summary description.

Used for debug output, and as an initial value for transformation and formatting.


getMessageFieldPrintValue

public java.lang.String getMessageFieldPrintValue()
Return the print name of the message field. If no printname is declared then this returns the field name.


getMessageRange

public java.lang.String getMessageRange()
Return the range specification for this field


getMessageValidityCheck

public java.lang.String getMessageValidityCheck()
Return the empty string if the value of this field is valid according to the base SAND declarations. This method supports the fieldValidate method, which is in turn specified by the org.sandev.basics.structs.SandInstanceMessage interface. See the comments there for more information, including a list of error Strings returned from here when a field is not valid.


getMessageMetatype

public java.lang.String getMessageMetatype()
Return the metatype text for this field, or "" if no metatype was declared.


getSandTransmitStatus

public int getSandTransmitStatus()
Accessor for sandTransmitStatus

Specified by:
getSandTransmitStatus in interface SandTransmitMessage

setSandTransmitStatus

public void setSandTransmitStatus(int sandTransmitStatus)
Mutator for sandTransmitStatus

Specified by:
setSandTransmitStatus in interface SandTransmitMessage

getSandTransmitStatusFlag

public static boolean getSandTransmitStatusFlag(int fieldflag)
Field flag accessor. Returns whether the given FIELDFLAG_* (defined in SandInstanceMessage) is true or false.


getSandTransmitStatusDefaultValue

public static int getSandTransmitStatusDefaultValue()
Default value for sandTransmitStatus. Returns 0


getSandTransmitStatusInvalidValue

public static int getSandTransmitStatusInvalidValue()
Invalid value for sandTransmitStatus. Returns Integer.MIN_VALUE


getSandTransmitStatusPrintValue

public java.lang.String getSandTransmitStatusPrintValue()
Retrieve the current value of this field as a print String. For a String field, this returns the current value. For int, long, double this returns the standard string conversion. For a Date, this returns the default DateFormat format. For an enum, this returns the Actual2Print translation of the current value. For a struct this returns a summary description.

Used for debug output, and as an initial value for transformation and formatting.


getSandTransmitStatusFieldPrintValue

public java.lang.String getSandTransmitStatusFieldPrintValue()
Return the print name of the sandTransmitStatus field. If no printname is declared then this returns the field name.


getSandTransmitStatusRange

public java.lang.String getSandTransmitStatusRange()
Return the range specification for this field


getSandTransmitStatusValidityCheck

public java.lang.String getSandTransmitStatusValidityCheck()
Return the empty string if the value of this field is valid according to the base SAND declarations. This method supports the fieldValidate method, which is in turn specified by the org.sandev.basics.structs.SandInstanceMessage interface. See the comments there for more information, including a list of error Strings returned from here when a field is not valid.


getSandTransmitStatusMetatype

public java.lang.String getSandTransmitStatusMetatype()
Return the metatype text for this field, or "" if no metatype was declared.


getSandTransmitErrorMessage

public java.lang.String getSandTransmitErrorMessage()
Accessor for sandTransmitErrorMessage

Specified by:
getSandTransmitErrorMessage in interface SandTransmitMessage

setSandTransmitErrorMessage

public void setSandTransmitErrorMessage(java.lang.String sandTransmitErrorMessage)
Mutator for sandTransmitErrorMessage

Specified by:
setSandTransmitErrorMessage in interface SandTransmitMessage

setSandTransmitErrorMessage

public void setSandTransmitErrorMessage(java.lang.Object sandTransmitErrorMessage)
Generic mutator for sandTransmitErrorMessage


getSandTransmitErrorMessageFlag

public static boolean getSandTransmitErrorMessageFlag(int fieldflag)
Field flag accessor. Returns whether the given FIELDFLAG_* (defined in SandInstanceMessage) is true or false.


getSandTransmitErrorMessageLengthNorm

public static int getSandTransmitErrorMessageLengthNorm()
Normal sandTransmitErrorMessage length is 30 characters


getSandTransmitErrorMessageLengthMax

public static int getSandTransmitErrorMessageLengthMax()
Maximum sandTransmitErrorMessage length is 70 characters


getSandTransmitErrorMessageDefaultValue

public static java.lang.String getSandTransmitErrorMessageDefaultValue()
Default value for sandTransmitErrorMessage. Returns ""


getSandTransmitErrorMessageInvalidValue

public static java.lang.String getSandTransmitErrorMessageInvalidValue()
Invalid value for sandTransmitErrorMessage. Returns null


getSandTransmitErrorMessagePrintValue

public java.lang.String getSandTransmitErrorMessagePrintValue()
Retrieve the current value of this field as a print String. For a String field, this returns the current value. For int, long, double this returns the standard string conversion. For a Date, this returns the default DateFormat format. For an enum, this returns the Actual2Print translation of the current value. For a struct this returns a summary description.

Used for debug output, and as an initial value for transformation and formatting.


getSandTransmitErrorMessageFieldPrintValue

public java.lang.String getSandTransmitErrorMessageFieldPrintValue()
Return the print name of the sandTransmitErrorMessage field. If no printname is declared then this returns the field name.


getSandTransmitErrorMessageRange

public java.lang.String getSandTransmitErrorMessageRange()
Return the range specification for this field


getSandTransmitErrorMessageValidityCheck

public java.lang.String getSandTransmitErrorMessageValidityCheck()
Return the empty string if the value of this field is valid according to the base SAND declarations. This method supports the fieldValidate method, which is in turn specified by the org.sandev.basics.structs.SandInstanceMessage interface. See the comments there for more information, including a list of error Strings returned from here when a field is not valid.


getSandTransmitErrorMessageMetatype

public java.lang.String getSandTransmitErrorMessageMetatype()
Return the metatype text for this field, or "" if no metatype was declared.


getSandTransmitErrorCode

public java.lang.String getSandTransmitErrorCode()
Accessor for sandTransmitErrorCode

Specified by:
getSandTransmitErrorCode in interface SandTransmitMessage

setSandTransmitErrorCode

public void setSandTransmitErrorCode(java.lang.String sandTransmitErrorCode)
Mutator for sandTransmitErrorCode

Specified by:
setSandTransmitErrorCode in interface SandTransmitMessage

setSandTransmitErrorCode

public void setSandTransmitErrorCode(java.lang.Object sandTransmitErrorCode)
Generic mutator for sandTransmitErrorCode


setSandTransmitError

public void setSandTransmitError(java.lang.String code,
                                 java.lang.String errText)
Sets both the code and the error in a single method.

Specified by:
setSandTransmitError in interface SandTransmitMessage

getSandTransmitErrorCodeFlag

public static boolean getSandTransmitErrorCodeFlag(int fieldflag)
Field flag accessor. Returns whether the given FIELDFLAG_* (defined in SandInstanceMessage) is true or false.


getSandTransmitErrorCodeLengthNorm

public static int getSandTransmitErrorCodeLengthNorm()
Normal sandTransmitErrorCode length is 30 characters


getSandTransmitErrorCodeLengthMax

public static int getSandTransmitErrorCodeLengthMax()
Maximum sandTransmitErrorCode length is 70 characters


getSandTransmitErrorCodeDefaultValue

public static java.lang.String getSandTransmitErrorCodeDefaultValue()
Default value for sandTransmitErrorCode. Returns ""


getSandTransmitErrorCodeInvalidValue

public static java.lang.String getSandTransmitErrorCodeInvalidValue()
Invalid value for sandTransmitErrorCode. Returns null


getSandTransmitErrorCodePrintValue

public java.lang.String getSandTransmitErrorCodePrintValue()
Retrieve the current value of this field as a print String. For a String field, this returns the current value. For int, long, double this returns the standard string conversion. For a Date, this returns the default DateFormat format. For an enum, this returns the Actual2Print translation of the current value. For a struct this returns a summary description.

Used for debug output, and as an initial value for transformation and formatting.


getSandTransmitErrorCodeFieldPrintValue

public java.lang.String getSandTransmitErrorCodeFieldPrintValue()
Return the print name of the sandTransmitErrorCode field. If no printname is declared then this returns the field name.


getSandTransmitErrorCodeRange

public java.lang.String getSandTransmitErrorCodeRange()
Return the range specification for this field


getSandTransmitErrorCodeValidityCheck

public java.lang.String getSandTransmitErrorCodeValidityCheck()
Return the empty string if the value of this field is valid according to the base SAND declarations. This method supports the fieldValidate method, which is in turn specified by the org.sandev.basics.structs.SandInstanceMessage interface. See the comments there for more information, including a list of error Strings returned from here when a field is not valid.


getSandTransmitErrorCodeMetatype

public java.lang.String getSandTransmitErrorCodeMetatype()
Return the metatype text for this field, or "" if no metatype was declared.


getSandTransmissionCount

public int getSandTransmissionCount()
Accessor for sandTransmissionCount

Specified by:
getSandTransmissionCount in interface SandTransmitMessage

setSandTransmissionCount

public void setSandTransmissionCount(int sandTransmissionCount)
Mutator for sandTransmissionCount

Specified by:
setSandTransmissionCount in interface SandTransmitMessage

getSandTransmissionCountFlag

public static boolean getSandTransmissionCountFlag(int fieldflag)
Field flag accessor. Returns whether the given FIELDFLAG_* (defined in SandInstanceMessage) is true or false.


getSandTransmissionCountDefaultValue

public static int getSandTransmissionCountDefaultValue()
Default value for sandTransmissionCount. Returns 0


getSandTransmissionCountInvalidValue

public static int getSandTransmissionCountInvalidValue()
Invalid value for sandTransmissionCount. Returns Integer.MIN_VALUE


getSandTransmissionCountPrintValue

public java.lang.String getSandTransmissionCountPrintValue()
Retrieve the current value of this field as a print String. For a String field, this returns the current value. For int, long, double this returns the standard string conversion. For a Date, this returns the default DateFormat format. For an enum, this returns the Actual2Print translation of the current value. For a struct this returns a summary description.

Used for debug output, and as an initial value for transformation and formatting.


getSandTransmissionCountFieldPrintValue

public java.lang.String getSandTransmissionCountFieldPrintValue()
Return the print name of the sandTransmissionCount field. If no printname is declared then this returns the field name.


getSandTransmissionCountRange

public java.lang.String getSandTransmissionCountRange()
Return the range specification for this field


getSandTransmissionCountValidityCheck

public java.lang.String getSandTransmissionCountValidityCheck()
Return the empty string if the value of this field is valid according to the base SAND declarations. This method supports the fieldValidate method, which is in turn specified by the org.sandev.basics.structs.SandInstanceMessage interface. See the comments there for more information, including a list of error Strings returned from here when a field is not valid.


getSandTransmissionCountMetatype

public java.lang.String getSandTransmissionCountMetatype()
Return the metatype text for this field, or "" if no metatype was declared.


getSandTransmissionLocale

public java.util.Locale getSandTransmissionLocale()
Accessor for sandTransmissionLocale

Specified by:
getSandTransmissionLocale in interface SandTransmitMessage

setSandTransmissionLocale

public void setSandTransmissionLocale(java.util.Locale sandTransmissionLocale)
Mutator for sandTransmissionLocale

Specified by:
setSandTransmissionLocale in interface SandTransmitMessage

setSandTransmissionLocale

public void setSandTransmissionLocale(java.lang.Object sandTransmissionLocale)
Generic mutator for sandTransmissionLocale


getSandTransmissionLocaleFlag

public static boolean getSandTransmissionLocaleFlag(int fieldflag)
Field flag accessor. Returns whether the given FIELDFLAG_* (defined in SandInstanceMessage) is true or false.


getSandTransmissionLocaleDefaultValue

public static java.util.Locale getSandTransmissionLocaleDefaultValue()
Default value for sandTransmissionLocale. Returns null


getSandTransmissionLocaleInvalidValue

public static java.util.Locale getSandTransmissionLocaleInvalidValue()
Invalid value for sandTransmissionLocale. Returns null


getSandTransmissionLocalePrintValue

public java.lang.String getSandTransmissionLocalePrintValue()
Retrieve the current value of this field as a print String. For a String field, this returns the current value. For int, long, double this returns the standard string conversion. For a Date, this returns the default DateFormat format. For an enum, this returns the Actual2Print translation of the current value. For a struct this returns a summary description.

Used for debug output, and as an initial value for transformation and formatting.


getSandTransmissionLocaleFieldPrintValue

public java.lang.String getSandTransmissionLocaleFieldPrintValue()
Return the print name of the sandTransmissionLocale field. If no printname is declared then this returns the field name.


getSandTransmissionLocaleRange

public java.lang.String getSandTransmissionLocaleRange()
Return the range specification for this field


getSandTransmissionLocaleValidityCheck

public java.lang.String getSandTransmissionLocaleValidityCheck()
Return the empty string if the value of this field is valid according to the base SAND declarations. This method supports the fieldValidate method, which is in turn specified by the org.sandev.basics.structs.SandInstanceMessage interface. See the comments there for more information, including a list of error Strings returned from here when a field is not valid.


getSandTransmissionLocaleMetatype

public java.lang.String getSandTransmissionLocaleMetatype()
Return the metatype text for this field, or "" if no metatype was declared.


getSandTransmitAuthID

public long getSandTransmitAuthID()
Accessor for sandTransmitAuthID

Specified by:
getSandTransmitAuthID in interface SandTransmitMessage

setSandTransmitAuthID

public void setSandTransmitAuthID(long sandTransmitAuthID)
Mutator for sandTransmitAuthID

Specified by:
setSandTransmitAuthID in interface SandTransmitMessage

getSandTransmitAuthIDFlag

public static boolean getSandTransmitAuthIDFlag(int fieldflag)
Field flag accessor. Returns whether the given FIELDFLAG_* (defined in SandInstanceMessage) is true or false.


getSandTransmitAuthIDDefaultValue

public static long getSandTransmitAuthIDDefaultValue()
Default value for sandTransmitAuthID. Returns 0


getSandTransmitAuthIDInvalidValue

public static long getSandTransmitAuthIDInvalidValue()
Invalid value for sandTransmitAuthID. Returns Long.MIN_VALUE


getSandTransmitAuthIDPrintValue

public java.lang.String getSandTransmitAuthIDPrintValue()
Retrieve the current value of this field as a print String. For a String field, this returns the current value. For int, long, double this returns the standard string conversion. For a Date, this returns the default DateFormat format. For an enum, this returns the Actual2Print translation of the current value. For a struct this returns a summary description.

Used for debug output, and as an initial value for transformation and formatting.


getSandTransmitAuthIDFieldPrintValue

public java.lang.String getSandTransmitAuthIDFieldPrintValue()
Return the print name of the sandTransmitAuthID field. If no printname is declared then this returns the field name.


getSandTransmitAuthIDRange

public java.lang.String getSandTransmitAuthIDRange()
Return the range specification for this field


getSandTransmitAuthIDValidityCheck

public java.lang.String getSandTransmitAuthIDValidityCheck()
Return the empty string if the value of this field is valid according to the base SAND declarations. This method supports the fieldValidate method, which is in turn specified by the org.sandev.basics.structs.SandInstanceMessage interface. See the comments there for more information, including a list of error Strings returned from here when a field is not valid.


getSandTransmitAuthIDMetatype

public java.lang.String getSandTransmitAuthIDMetatype()
Return the metatype text for this field, or "" if no metatype was declared.


init

public void init()
Initialize all fields to their default values


getShortName

public java.lang.String getShortName()
Returns the unqualified name of this message.

Specified by:
getShortName in interface SandMessage

getQueryMessage

public SandQueryMessage getQueryMessage()
Returns null

Specified by:
getQueryMessage in interface SandMessage

getCollectionMessage

public SandCollectionMessage getCollectionMessage()
Returns null

Specified by:
getCollectionMessage in interface SandMessage

getUpdateMessage

public SandUpdateMessage getUpdateMessage()
Returns null

Specified by:
getUpdateMessage in interface SandMessage

getStructMessage

public SandStructMessage getStructMessage()
Returns a new AuthWrapper instance

Specified by:
getStructMessage in interface SandMessage

isEquivalent

public boolean isEquivalent(SandMessage sm)
Declared field equivalence check as specified by the SandMessage interface. String values are trimmed before comparison because conversions may occasionally result in trailing whitespace, which should not cause equivalence comparisons to fail. Comparisons are case insensitive since that corresponds to what most people expect, and how most databases work.

When comparing arrays, it is possible that the array elements may have been set to null as part of authorization filtering or similar unusual circumstances. A null array element is only equivalent to another null array element.

Specified by:
isEquivalent in interface SandMessage

generalModifier

public void generalModifier(int action,
                            java.lang.String field,
                            int index,
                            java.lang.Object val)
                     throws SandException
General mutator method. Specified by SandInstanceMessage interface.

Specified by:
generalModifier in interface SandInstanceMessage
Throws:
SandException

generalDereference

public SandAttrVal generalDereference(java.lang.String fieldspec)
General reference field accessor method. Specified by SandInstanceMessage interface.

Specified by:
generalDereference in interface SandInstanceMessage

generalAccessor

public java.lang.Object generalAccessor(java.lang.String fieldspec)
General field accessor method. Specified by SandInstanceMessage interface.

Specified by:
generalAccessor in interface SandInstanceMessage

getDisplayFields

public java.lang.String[] getDisplayFields()
Return an array of the summary field names for this class.

Specified by:
getDisplayFields in interface SandInstanceMessage

getDisplayFieldsPrint

public java.lang.String[] getDisplayFieldsPrint()
Return an array of the summary field print names for this class.

Specified by:
getDisplayFieldsPrint in interface SandInstanceMessage

getDisplayValues

public java.lang.String[] getDisplayValues()
Return the values for the summary fields. The standard String representation of each value is returned. For Dates, the default DateFormat output is used. For enums, the print value is used. These can be further transformed as needed.

Specified by:
getDisplayValues in interface SandInstanceMessage

getDisplayValues

public java.lang.String[] getDisplayValues(IDLookup lookup,
                                           AuthUser user,
                                           java.lang.String defaultVal)
Return the values for the summary fields, including dereference expressions.

Specified by:
getDisplayValues in interface Resolvable

getValueForFieldName

public java.lang.String getValueForFieldName(java.lang.String fieldname,
                                             IDLookup lookup,
                                             AuthUser user,
                                             java.lang.String defaultVal)
Returns the print representation of the value of the specified field, or the given default value if innaccessible. A field value may be innaccessible due to authorization, null reference, or other call failure.


getAllFields

public java.lang.String[] getAllFields()
Return an array of all fields for this class.

Specified by:
getAllFields in interface SandInstanceMessage

getContainedMessageFields

public java.lang.String[] getContainedMessageFields()
Return an array of all contained message fields.

Specified by:
getContainedMessageFields in interface SandInstanceMessage

defaultField

public void defaultField(java.lang.String fieldname)
Set the specified field to its default value.

Specified by:
defaultField in interface SandInstanceMessage

getPrintnameForField

public java.lang.String getPrintnameForField(java.lang.String fieldname)
Given a fieldname, return its declared printname if declared. If no printname was declared then this returns the field name.

Specified by:
getPrintnameForField in interface SandInstanceMessage

cloneMessage

public SandInstanceMessage cloneMessage()
Calls cloneAuthWrapper

Specified by:
cloneMessage in interface SandInstanceMessage

cloneAuthWrapper

public AuthWrapper cloneAuthWrapper()
Make a deep copy of this AuthWrapper. Creates a new instance and then calls copyDataFrom.


copyDataFrom

public void copyDataFrom(AuthWrapper other)
Deep copy all the data from the specified instance. If the other instance is null then this method does nothing.


copyFieldValue

public void copyFieldValue(java.lang.String fieldName,
                           SandInstanceMessage other)
Copy the specified field from the given instance.

Specified by:
copyFieldValue in interface SandInstanceMessage

fieldValidate

public SandAttrVal[] fieldValidate(SandAttrVal[] checkFields)
Validate the fields as specified in the SandInstanceMessage interface

Specified by:
fieldValidate in interface SandInstanceMessage

fieldsValid

public boolean fieldsValid()
Validate the fields as specified in the SandInstanceMessage interface

Specified by:
fieldsValid in interface SandInstanceMessage

referenceValidate

public java.lang.String[] referenceValidate(java.lang.String[] locations,
                                            java.lang.String prefix,
                                            IDLookup idlookup,
                                            NameLookup namelookup,
                                            AuthUser au)
                                     throws SandException
Validate the references as specified in the Resolvable interface.

Specified by:
referenceValidate in interface Resolvable
Throws:
SandException

convertToSuperstructClass

public SandInstanceMessage convertToSuperstructClass()
Return a new instance of the message associated with the superstruct of this instance. Return null if the source struct for this message does not extend another struct.

Specified by:
convertToSuperstructClass in interface SandInstanceMessage

debugDump

public java.lang.String debugDump(java.lang.String prefix)
Dump this instance into a debug printable string.

Specified by:
debugDump in interface SandInstanceMessage

getDisplayID

public java.lang.String getDisplayID()
Return the displayID for this message instance

Specified by:
getDisplayID in interface SandInstanceMessage

getInstance

public SandPersistMessage getInstance(java.lang.String classname,
                                      long id)
If this instance directly contains the specified instance, then find it and return it. Returns null if not found.

Specified by:
getInstance in interface SandStructMessage

getInstance

public SandInstanceMessage getInstance(java.lang.String classname,
                                       java.lang.String fieldname,