Module com.github.rvesse.airline

Package com.github.rvesse.airline.restrictions.common

Class PatternRestriction

java.lang.Object

com.github.rvesse.airline.restrictions.AbstractCommonRestriction

com.github.rvesse.airline.restrictions.common.PatternRestriction

All Implemented Interfaces:

HelpHint, ArgumentsRestriction, OptionRestriction

public class PatternRestriction
extends AbstractCommonRestriction
implements HelpHint

A restriction which requires the raw values to match a given regular expression

Field Summary

Fields

Modifier and Type	Field	Description
private java.lang.String	description
private java.util.regex.Pattern	pattern

Constructor Summary

Constructors

Constructor	Description
PatternRestriction(java.lang.String pattern, int flags, java.lang.String description)	Creates a pattern restriction

Method Summary

Modifier and Type	Method	Description
java.lang.String[]	getContentBlock(int blockNumber)	Gets the content block with the given number
HelpFormat	getFormat()	Gets the format of the provided help information
java.lang.String	getPreamble()	Gets the preamble text that should be included
int	numContentBlocks()	Gets the number of content blocks provided
<T> void	preValidate(ParseState<T> state, ArgumentsMetadata arguments, java.lang.String value)	Method that is called before Airline attempts to convert a string argument received into a strongly typed Java value
<T> void	preValidate(ParseState<T> state, OptionMetadata option, java.lang.String value)	Method that is called before Airline attempts to convert a string argument received into a strongly typed Java value

Methods inherited from class com.github.rvesse.airline.restrictions.AbstractCommonRestriction

finalValidate, finalValidate, getArgumentTitle, getArgumentTitle, getOptionTitle, postValidate, postValidate

Methods inherited from class java.lang.Object

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

Field Detail

pattern

private final java.util.regex.Pattern pattern

description

private final java.lang.String description

Constructor Detail

PatternRestriction

public PatternRestriction(java.lang.String pattern,
                          int flags,
                          java.lang.String description)

Creates a pattern restriction

Parameters:

pattern - Regular expression pattern

flags - Regular expression flags

description - Friendly description of the intent of the pattern, included in errors when the restriction is violated

Method Detail

preValidate

public <T> void preValidate(ParseState<T> state,
                            OptionMetadata option,
                            java.lang.String value)

Description copied from interface: OptionRestriction

Method that is called before Airline attempts to convert a string argument received into a strongly typed Java value

Specified by:

preValidate in interface OptionRestriction

Overrides:

preValidate in class AbstractCommonRestriction

Parameters:

state - Parser state

option - Option meta-data

value - String value

preValidate

public <T> void preValidate(ParseState<T> state,
                            ArgumentsMetadata arguments,
                            java.lang.String value)

Description copied from interface: ArgumentsRestriction

Method that is called before Airline attempts to convert a string argument received into a strongly typed Java value

Specified by:

preValidate in interface ArgumentsRestriction

Overrides:

preValidate in class AbstractCommonRestriction

Parameters:

state - Parser state

arguments - Arguments meta-data

value - String value

getPreamble

public java.lang.String getPreamble()

Description copied from interface: HelpHint

Gets the preamble text that should be included

Specified by:

getPreamble in interface HelpHint

Returns:

Preamble text

getFormat

public HelpFormat getFormat()

Description copied from interface: HelpHint

Gets the format of the provided help information

Specified by:

getFormat in interface HelpHint

Returns:

Help format

numContentBlocks

public int numContentBlocks()

Description copied from interface: HelpHint

Gets the number of content blocks provided

Help generators should consult the HelpHint.getFormat() return value to determine how to format the content blocks but they are not required to do so

Specified by:

numContentBlocks in interface HelpHint

Returns:

Number of content blocks

getContentBlock

public java.lang.String[] getContentBlock(int blockNumber)

Description copied from interface: HelpHint

Gets the content block with the given number

Specified by:

getContentBlock in interface HelpHint

Parameters:

blockNumber - Block number

Returns:

Content Block