com.ibm.as400.ui.util
Class AS400CnameFormatter

java.lang.Object
  |
  +--com.ibm.as400.ui.framework.java.DataFormatter
        |
        +--com.ibm.as400.ui.util.AS400Formatter
              |
              +--com.ibm.as400.ui.util.AS400CnameFormatter

public class AS400CnameFormatter
extends AS400Formatter

Checks validity of a string as an AS/400 *CNAME. Checks using the CCSID of the AS/400 specified in the constructor. If parsing is unsuccessful, an IllegalUserDataException is thrown.

An AS/400 *CNAME is also known as a Communications Name. A valid Communications Name is:

*CNAME is the same as *SNAME except '_' is not allowed. *CNAME is the same as *NAME except quoted values, '_' and '.' are not allowed.

The maximum length defaults to 256, but can be changed using setMaxLength. To check names to IBM object standard length, use setMaxLength(AS400Formatter.IBM_OBJECT_NAME_MAX_LENGTH))

Since:
v4r2m0
See Also:
IllegalUserDataException, AS400NameFormatter, AS400SnameFormatter, AS400CnameFormatter, AS400CharFormatter, AS400SQLNameFormatter

Fields inherited from class com.ibm.as400.ui.util.AS400Formatter
ALLOW_EMBEDDED_WILD_CARDS, ALLOW_TRAILING_WILD_CARD, IBM_OBJECT_NAME_MAX_LENGTH, NO_WILD_CARDS, STANDARD_OBJECT_NAME_MAX_LENGTH
 
Constructor Summary
AS400CnameFormatter(AS400 system)
          Constructs an AS400CnameFormatter.
 
Method Summary
 int getMaxLength()
          Gets the current number of characters allowed during checking.
 java.lang.Object parse(java.lang.String source)
          Parses and checks a string as a valid AS/400 *CNAME.
 void setMaxLength(int length)
          Sets the maximum number of characters allowed during checking.
 
Methods inherited from class com.ibm.as400.ui.util.AS400Formatter
getCCSID, getWildCardMode, isAllowedWildCard, isValidEbcdicAlpha, setCCSID, setWildCardMode
 
Methods inherited from class com.ibm.as400.ui.framework.java.DataFormatter
format
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

AS400CnameFormatter

public AS400CnameFormatter(AS400 system)
Constructs an AS400CnameFormatter. The CCSID of the input AS400 object will be used for checking. If a null AS400 object is used, 37 is used as a default CCSID.
Parameters:
system - an AS400 object.
Since:
v4r2m0
Method Detail

parse

public java.lang.Object parse(java.lang.String source)
                       throws IllegalUserDataException
Parses and checks a string as a valid AS/400 *CNAME. If the string is not valid an IllegalUserDataException is thrown.
Overrides:
parse in class DataFormatter
Parameters:
source - the string to be parsed
Returns:
the valid checked result
Since:
v4r2m0

setMaxLength

public void setMaxLength(int length)
                  throws java.lang.IllegalArgumentException
Sets the maximum number of characters allowed during checking. Names which exceed this length cause an exception to be thrown. If not set, the default length is 256. To check IBM object names, use the IBM_OBJECT_NAME_MAX_LENGTH constant.
Parameters:
length - the maximum number of characters allowed
Since:
v5r1m0
See Also:
AS400Formatter.IBM_OBJECT_NAME_MAX_LENGTH, AS400Formatter.STANDARD_OBJECT_NAME_MAX_LENGTH

getMaxLength

public int getMaxLength()
Gets the current number of characters allowed during checking. Names which exceed this length cause an exception to be thrown.
Returns:
length the maximum number of characters allowed
Since:
v5r1m0