com.atlassian.bamboo.validation

Interface ValidationService

All Known Implementing Classes:

ValidationServiceImpl

public interface ValidationService

Methods for validation of standard fields

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	ValidationService.ValidationType

Field Summary

Fields

Modifier and Type	Field and Description
static String	CHAIN_KEY_REGEXP Regular expression matching a full Chain key.
static String	FULL_JOB_KEY_REGEXP Regular expression matching a full job key.
static String	PARTIAL_JOB_KEY_REGEXP Regular expression matching a partial job key.
static String	PROJECT_KEY_REGEXP Regular expression matching a Project key.

Method Summary

Modifier and Type	Method and Description
ErrorCollection	validateChainKey(String fieldName, String chainKey, ValidationFunction... functions) Verify any String that it is a valid chain key.
ErrorCollection	validateDescription(String fieldName, String description) Validate the description field of any object.
ErrorCollection	validateJobKey(String fieldName, String jobKey, ValidationFunction... functions) Verify any String that it is a valid job key.
ErrorCollection	validateKey(String fieldName, ValidationService.ValidationType type, String key, ValidationFunction... functions) Validate any String against Bamboo's generic rules for keys.
ErrorCollection	validateName(String fieldName, String errorPrefix, String name) Validate any String against Bamboo's generic rules for names.
ErrorCollection	validateProjectKey(String fieldName, String projectKey, ValidationFunction... functions) Verify any String that it is a valid Project key.

Field Detail

FULL_JOB_KEY_REGEXP

static final String FULL_JOB_KEY_REGEXP

Regular expression matching a full job key.

Matches exactly three groups of an uppercase letter followed by one or more uppercase alphanumeric characters, with each group separated by a hyphen (-).

Examples:

AB-CDE-FG1

See Also:

Constant Field Values

CHAIN_KEY_REGEXP

static final String CHAIN_KEY_REGEXP

Regular expression matching a full Chain key.

Matches exactly two groups of an uppercase letter followed by one or more uppercase alphanumeric characters, with each group separated by a hyphen (-).

Examples:

AB-CDE

See Also:

Constant Field Values

PROJECT_KEY_REGEXP

static final String PROJECT_KEY_REGEXP

Regular expression matching a Project key.

Matches an uppercase letter followed by one or more uppercase alphanumeric characters.

Examples:

PROJ1

PARTIAL_JOB_KEY_REGEXP

static final String PARTIAL_JOB_KEY_REGEXP

Regular expression matching a partial job key.

Matches an uppercase letter followed by one or more uppercase alphanumeric characters.

Examples:

ABC1

See Also:

Constant Field Values

Method Detail

validateKey

@NotNull
ErrorCollection validateKey(@NotNull
                                     String fieldName,
                                     @NotNull
                                     ValidationService.ValidationType type,
                                     @Nullable
                                     String key,
                                     ValidationFunction... functions)

Validate any String against Bamboo's generic rules for keys.

Parameters:

fieldName - the name of the field to add the errors to.

type - the ValidationService.ValidationType the key pertains to.

key - the actual string to validate.

functions - additional validation functions to run if all generic rules are satisfied. Functions are run in the order they are provided. If a function adds an error to the error collection, subsequent functions will not be run.

See Also:

ValidationFunctionFactory

validateJobKey

@NotNull
ErrorCollection validateJobKey(@NotNull
                                        String fieldName,
                                        @Nullable
                                        String jobKey,
                                        ValidationFunction... functions)

Verify any String that it is a valid job key.

Parameters:

fieldName - the name of the field to add the errors to.

jobKey - the actual string to validate.

functions - additional validation functions to run if all generic rules are satisfied. Functions are run in the order they are provided. If a function adds an error to the error collection, subsequent functions will not be run.

See Also:

ValidationFunctionFactory

validateChainKey

@NotNull
ErrorCollection validateChainKey(@NotNull
                                          String fieldName,
                                          @Nullable
                                          String chainKey,
                                          ValidationFunction... functions)

Verify any String that it is a valid chain key.

Parameters:

fieldName - the name of the field to add the errors to.

chainKey - the actual string to validate.

functions - additional validation functions to run if all generic rules are satisfied. Functions are run in the order they are provided. If a function adds an error to the error collection, subsequent functions will not be run.

See Also:

ValidationFunctionFactory

validateProjectKey

@NotNull
ErrorCollection validateProjectKey(@NotNull
                                            String fieldName,
                                            @Nullable
                                            String projectKey,
                                            ValidationFunction... functions)

Verify any String that it is a valid Project key.

Parameters:

fieldName - the name of the field to add the errors to

projectKey - the actual string to validate

functions - additional validation functions to run if all generic rules are satisfied. Functions are run in the order they are provided. If a function adds an error to the error collection, subsequent functions will not be run.

See Also:

ValidationFunctionFactory

validateName

@NotNull
ErrorCollection validateName(@NotNull
                                      String fieldName,
                                      @NotNull
                                      String errorPrefix,
                                      @Nullable
                                      String name)

Validate any String against Bamboo's generic rules for names.

Parameters:

fieldName - the name of the field to add the errors to

errorPrefix - the prefix to put in front of the standardised error keys. (e.g. "plan", "chain")

name - the actual string to validate

validateDescription

@NotNull
ErrorCollection validateDescription(@NotNull
                                             String fieldName,
                                             @Nullable
                                             String description)

Validate the description field of any object. All it really does is check length

Parameters:

fieldName - the name of the field to add the errors to

description - the actual text to validate