com.foxsmart.csu.config.global.line
Class PaddingComponent

java.lang.Object
  com.foxsmart.csu.config.CiscoRouterConfigParser
      com.foxsmart.csu.config.CiscoRouterConfigComponent
          com.foxsmart.csu.config.global.line.PaddingComponent

All Implemented Interfaces:

MultiLineComponent, java.io.Serializable

public class PaddingComponent
extends CiscoRouterConfigComponent
implements MultiLineComponent

The padding command sets padding for specified output characters.

See Also:

Serialized Form

Field Summary

static java.lang.Integer	MAX_DECIMAL_EQUIVALENT_VALUE The maximum decimal equivalent value.
static java.lang.Integer	MAX_NUM_NULLS The maximum number of nulls.
static java.lang.Integer	MIN_DECIMAL_EQUIVALENT_VALUE The minimum decimal equivalent value.
static java.lang.Integer	MIN_NUM_NULLS The minimum number of nulls.
static java.lang.String	PADDING

Fields inherited from class com.foxsmart.csu.config.CiscoRouterConfigComponent

commentComponent, componentMap, log, parentComponent

Fields inherited from class com.foxsmart.csu.config.CiscoRouterConfigParser

NO, tokenIndex

Constructor Summary

PaddingComponent()
Constructs a padding object.

Method Summary

void	addCharacter(java.lang.String character, java.lang.Integer numNulls) Adds a character to be padded and the number of nulls to output.
java.util.List	buildFromIos(java.util.List configLines) Parse and populate the specific CiscoRouterComponent object based on the passed in individual lines of the IOS configuration.
Commands	generateDeleteIos(CiscoRouterConfig updatedCiscoRouterConfig) Generates the IOS configuration commands to delete this component.
Commands	generateIos() Returns the IOS configuration commands for this component.
java.util.List	getCharacters() Gets the list of padding characters.
java.lang.Integer	getNumNulls(java.lang.String character) Gets the number of nulls to be added for the specified padding character.
boolean	isCharacterSupported(java.lang.String character) Returns whether a padding character is supported.
void	removeAllCharacters() Removes all padding characters.
void	removeCharacter(java.lang.String character) Removes a padding character.
void	validate() Validates this object to ensure it contains a valid IOS configuration.

Methods inherited from class com.foxsmart.csu.config.CiscoRouterConfigComponent

addComponent, addComponent, checkComponentType, deleteOldConfigWhenUpdating, dumpComponents, generateChildrenUpdateConfiglet, generateCompositeIos, generateCompositeIos, generateIos, generateIos, generateIos, generateMultiLineUpdateConfiglet, generateUpdateCompositeIos, generateUpdateIos, generateUpdateIos, getAllComponents, getCiscoRouterConfig, getComment, getComponentClassName, getComponentClassName, getComponentKeys, getComponents, getComponents, getDeferredDelete, getFirstComponent, getFirstComponent, getParentComponent, getTotalComponents, getTotalComponents, getUpdateConfiglet, instantiateComponent, instantiateComponent, isValid, removeAllComponents, removeAllComponents, removeAllComponents, removeComponent, removeComponent, removeComponent, requiresCommentSeparator, setComment, setParentComponent, validateChildren

Methods inherited from class com.foxsmart.csu.config.CiscoRouterConfigParser

checkExists, checkLineComplete, checkNotEmpty, checkRange, checkTokenCount, checkTokenCount, checkTokenMatch, checkTokenMatch, decrementTokenIndex, generateCommands, getBigDecimalNumberFromString, getDoubleNumberFromString, getEnum, getHexadecimalNumberFromString, getIntegerNumberFromString, getIpAddressFromString, getLine, getLongNumberFromString, getMacAddressFromString, getNextOptionalToken, getNextToken, getToken, getTokenIndex, getTokens, getTotalIndentedLines, getTotalLines, incrementTokenIndex, invalidConfiguration, invalidTokenFound, isEmpty, moreIndentedLines, moreLines, moreTokens, removeLines, resetTokenIndex, setTokenIndex, tokensLeft

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

PADDING

public static final java.lang.String PADDING

See Also:

Constant Field Values

MIN_DECIMAL_EQUIVALENT_VALUE

public static final java.lang.Integer MIN_DECIMAL_EQUIVALENT_VALUE

The minimum decimal equivalent value.

MAX_DECIMAL_EQUIVALENT_VALUE

public static final java.lang.Integer MAX_DECIMAL_EQUIVALENT_VALUE

The maximum decimal equivalent value.

MIN_NUM_NULLS

public static final java.lang.Integer MIN_NUM_NULLS

The minimum number of nulls.

MAX_NUM_NULLS

public static final java.lang.Integer MAX_NUM_NULLS

The maximum number of nulls.

Constructor Detail

PaddingComponent

public PaddingComponent()

Constructs a padding object.

Method Detail

addCharacter

public void addCharacter(java.lang.String character,
                         java.lang.Integer numNulls)

Adds a character to be padded and the number of nulls to output. Valid values include a character (e.g. "A") or a decimal equivalent (e.g. 65). To set the character to a single digit (e.g. 1), the associated decimal equivalent must be used since the passed in digit will be interpreted as a decimal value rather than a character. If a decimal equivalent value is used, it must be between 0 and 127. Note that characters and decimal equivalents are not distinguished so adding "A" and "65" will add 2 characters. However, once any changes are made on the router, only the decimal equivalent will be present. The number of nulls range is from 0-255.

Parameters:

character - The padding character.

numNulls - The number of nulls to add for the padding character.

removeCharacter

public void removeCharacter(java.lang.String character)

Removes a padding character.

Parameters:

character - The padding character to remove.

removeAllCharacters

public void removeAllCharacters()

Removes all padding characters.

getCharacters

public java.util.List getCharacters()

Gets the list of padding characters.

Returns:

the padding.

getNumNulls

public java.lang.Integer getNumNulls(java.lang.String character)

Gets the number of nulls to be added for the specified padding character. Null will be returned if the padding character isn't supported.

Parameters:

character - The padding character.

Returns:

The number of nulls to add.

isCharacterSupported

public boolean isCharacterSupported(java.lang.String character)

Returns whether a padding character is supported.

Parameters:

character - The padding character.

Returns:

True is the character is supported or false if not.

buildFromIos

public java.util.List buildFromIos(java.util.List configLines)
                            throws InvalidConfigurationException

Description copied from class: CiscoRouterConfigComponent

Parse and populate the specific CiscoRouterComponent object based on the passed in individual lines of the IOS configuration. The passed in configuration lines should represent the first line in the configuration that applies to the specific component. The component should use all lines needed by its specific part of the configuration and return a List with the remaining lines that are not part of the component's configuration.

Specified by:

buildFromIos in class CiscoRouterConfigComponent

Parameters:

configLines - The list of IOS configuration lines.

Returns:

The rest of the lines that were not parsed by the component.

Throws:

InvalidConfigurationException - if the IOS configuration can not be parsed for any reason.

See Also:

CiscoRouterConfigComponent

validate

public void validate()
              throws InvalidConfigurationException

Description copied from class: CiscoRouterConfigComponent

Validates this object to ensure it contains a valid IOS configuration.

Specified by:

validate in class CiscoRouterConfigComponent

Throws:

InvalidConfigurationException - if the configuration is invalid.

See Also:

CiscoRouterConfigComponent

generateIos

public Commands generateIos()
                     throws InvalidConfigurationException

Description copied from class: CiscoRouterConfigComponent

Returns the IOS configuration commands for this component.

Specified by:

generateIos in class CiscoRouterConfigComponent

Returns:

The IOS configuration string as a list of Command objects. To generate a configlet from the list of Command objects, use Command.getConfiglet().

Throws:

InvalidConfigurationException - if the IOS configuration is invalid and the IOS string can not be generated. The validate() method is used to determine if the configuration is valid.

See Also:

CiscoRouterConfigComponent

generateDeleteIos

public Commands generateDeleteIos(CiscoRouterConfig updatedCiscoRouterConfig)
                           throws InvalidConfigurationException

Description copied from class: CiscoRouterConfigComponent

Generates the IOS configuration commands to delete this component. This is the default implementation that generates a "no" statement followed by the generateIos() string for non CompositeComponents or generateHeaderIos() for CompositeComponents. Specific components may choose to override this method if this implementation is incorrect. The "no" keyword is placed where the first character of the command is located. For example, if the IOS command is " length 255", then the returned command will be " no length 255" (and not "no length 255").

Note that this implementation will call the getDeferredDelete method on the component and set the "deferred flag" on the returned Commands with its returned value.

Specified by:

generateDeleteIos in interface MultiLineComponent

Overrides:

generateDeleteIos in class CiscoRouterConfigComponent

Parameters:

updatedCiscoRouterConfig - the updated Cisco router configuration.

Returns:

The generated IOS string to deleted the component.

Throws:

InvalidConfigurationException - if the IOS configuration is invalid and the IOS string can not be generated. The validate() method is used to determine if the configuration is valid.

See Also:

MultiLineComponent