Package jetbrains.buildServer.serverSide
Interface BuildTypeSettingsEx
-
- All Superinterfaces:
BuildTypeOptions
,BuildTypeOwnSettings
,BuildTypeSettings
,CleanupSettings
,CleanupSettingsInit
,CompatibleAgents
,DependencySettings
,InheritableUserParametersHolder
,InheritableUserParametersHolderEx
,InternalParameters
,OptionSupport
,ReadOnlyUserParameters
,UserParametersHolder
,VcsLabelingSettings
- All Known Implementing Classes:
BuildTypeSettingsImpl
,InaccessibleTemplate
public interface BuildTypeSettingsEx extends BuildTypeSettings, CleanupSettingsInit, BuildTypeOwnSettings, InheritableUserParametersHolderEx
- Author:
- Pavel.Sher
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface jetbrains.buildServer.serverSide.BuildTypeOptions
BuildTypeOptions.BuildConfigurationType
-
Nested classes/interfaces inherited from interface jetbrains.buildServer.serverSide.vcs.VcsLabelingSettings
VcsLabelingSettings.LabelingType
-
-
Field Summary
-
Fields inherited from interface jetbrains.buildServer.serverSide.BuildTypeOptions
BT_ALLOW_EXTERNAL_STATUS, BT_ALLOW_PERSONAL_BUILD_TRIGGERING, BT_ARTIFACT_PUBLISH_CONDITION, BT_ARTIFACT_RULES, BT_BRANCH_FILTER, BT_BUILD_CONFIGURATION_TYPE, BT_BUILD_DEFAULT_BRANCH, BT_BUILD_NUMBER_PATTERN, BT_CHECKOUT_DIR, BT_CHECKOUT_MODE, BT_CLEAN_BUILD, BT_EXCLUDE_DEFAULT_BRANCH_CHANGES, BT_EXECUTION_TIMEOUT, BT_FAIL_IF_TESTS_FAIL, BT_FAIL_ON_ANY_ERROR_MESSAGE, BT_FAIL_ON_EXIT_CODE, BT_FAIL_ON_OOME_OR_CRASH, BT_GENERATED_SETTINGS_CHECKSUM, BT_HANGING_BUILDS_DETECTION_ENABLED, BT_MAX_RUNNING_BUILDS, BT_MAX_RUNNING_BUILDS_PER_BRANCH, BT_SHOW_DEPS_CHANGES, BT_SUPPORT_TEST_RETRY, DEFAULT_BUILD_NUMBER_PATTERN, DEFAULT_MAX_RUNNING_BUILDS_PER_BRANCH, DEFAULT_VCS_LABELING_BRANCH_FILTER, VCS_LABELING_BRANCH_FILTER
-
Fields inherited from interface jetbrains.buildServer.serverSide.CleanupSettings
CLEANUP_PREVENT_DEPENDENCIES_ARTIFACTS_FROM_CLEANUP, DISABLE_CLEANUP_POLICIES
-
Fields inherited from interface jetbrains.buildServer.serverSide.vcs.VcsLabelingSettings
DEFAULT_LABEL_PATTERN
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods Modifier and Type Method Description void
addListener(BuildTypeSettingsListener listener)
void
addListener(BuildTypeSettingsListener listener, boolean delayPropagation)
Adds listener to the build type settings and all settings of the attached templatesvoid
addRunParameter(SBuildRunnerDescriptor runner, Parameter parameter)
void
applyRunnersOrder(String[] ids, boolean alwaysSetCustom)
Apply custom order of build stepsvoid
attachedToModel(ProjectDataModel model)
void
copyAllSettings(BuildTypeSettingsEx source)
Copies all settings, the behaviour is the same as copySettings with empty copyOptions, i.e.void
copyOverridableSettings(BuildTypeSettingsEx settingsSource)
Deprecated.void
copyOwnSettings(BuildTypeSettingsEx settings)
Deprecated.void
copySettings(BuildTypeSettingsEx source, BuildTypeCopySettings copyOptions)
Copies settings, parameters, options etc.BuildTypeSettingsEx
createCopy()
ParametersProvider
createParametersProvider(SBuild build)
ReadOnlyBuildTypeSettings
createReadOnlySettings()
void
dispose()
BuildSettings
getBuildSettings()
BranchFilter
getBuildTypeBranchFilter(ValueResolver valueResolver)
BranchFilter
getBuildTypeBranchFilterUnsafe(ValueResolver valueResolver)
Same asgetBuildTypeBranchFilter(ValueResolver)
but throws an exception if the filter is incorrectdefault <T> T
getDeclaredOption(Option<T> option)
Get option value declared in this BuildTypeSettingsDependencyOptions
getDependencyOptions(SBuildType buildType)
Collection<String>
getDisabledParameterDescriptorIds()
default Map<String,Boolean>
getParameterDescriptorState()
ProjectEx
getProject()
Returns the project this build type entity belongs to.SecureDataStorage
getSecureDataStorage()
BuildTypeTemplateEx
getTemplate()
Deprecated.String
getTemplateExternalId()
Deprecated.List<BuildTypeTemplateEx>
getTemplates()
Returns templates these settings are based on, including the default template.default <T> TypedValue<T>
getTypedOption(Option<T> option)
Get option extended value.boolean
isAgentLessBuildType()
void
removeListener(BuildTypeSettingsListener listener)
void
replaceDependency(SArtifactDependency origDep, SArtifactDependency newDep)
Replaces original dependency object with another onevoid
replaceDependency(Dependency origDep, Dependency newDep)
Replaces original dependency object with another oneboolean
replaceVcsRoot(SVcsRoot oldVcsRoot, SVcsRoot newVcsRoot)
Replaces existing VCS root entry in settings with a new one, maintaining the order of the root entriesvoid
setParametersSupport(ParametersSupport paramsSupport)
void
setProject(ProjectEx project)
Sets new project to settings objectvoid
setSecureDataStorage(SecureDataStorage secureDataStorage)
Sets secure data storage to be used by these settings when they are persisted on disk.void
setTemplateIds(List<String> templateIds)
Change which templates these settings are attached to.void
setTemplatesOrder(List<String> templateIds)
Imposes new order on the associated templates.boolean
setVcsRoots(Collection<SVcsRoot> vcsRoots)
Sets VCS roots.boolean
vcsRootsAccessibleInProject(SProject project)
-
Methods inherited from interface jetbrains.buildServer.serverSide.BuildTypeOwnSettings
getOwnArtifactDependencies, getOwnBuildFeatures, getOwnBuildRunners, getOwnBuildTriggers, getOwnCleanupSupport, getOwnDependencies, getOwnDisabledParameterDescriptorIds, getOwnOptionSupport, getOwnRequirements, getOwnRunnerTypes, getOwnSerializableParameters, getOwnTemplateExternalIds, getOwnTemplateIds, getOwnTemplates, getOwnVcsRootEntries, isTemplateBased
-
Methods inherited from interface jetbrains.buildServer.serverSide.BuildTypeSettings
addArtifactDependency, addBuildFeature, addBuildFeature, addBuildParameter, addBuildRunner, addBuildRunner, addBuildRunner, addBuildTrigger, addBuildTrigger, addConfigParameter, addRequirement, addVcsRoot, applyRunnersOrder, containsOwnVcsRoot, containsVcsRoot, findBuildFeatureById, findBuildRunnerById, findBuildRunnerByType, findRunnerParameter, findTriggerById, getArtifactDependencies, getArtifactPaths, getBuildFeatureRequirements, getBuildFeatures, getBuildFeaturesOfType, getBuildNumberPattern, getBuildParameter, getBuildParameters, getBuildParametersCollection, getBuildRunners, getBuildTriggersCollection, getCheckoutDirectory, getCheckoutRules, getCheckoutType, getConfigParameters, getConfigParametersCollection, getImplicitRequirements, getReadOnlyReason, getRequirements, getRunnerConditions, getRunnersOrder, getRunnerTypes, getRunTypeRequirements, getTemplateId, getTemplateIds, getUndefinedParameters, getVcsRootEntries, getVcsRoots, isCompositeBuildType, isDeployment, isEnabled, isReadOnly, isTemplateAccessible, isTemplateBased, persist, persist, removeAllBuildRunners, removeArtifactDependency, removeBuildFeature, removeBuildParameter, removeBuildRunner, removeBuildTrigger, removeConfigParameter, removeRequirement, removeRequirement, removeVcsRoot, replaceInValues, replaceInValues, resetRunnersOrder, setArtifactDependencies, setArtifactPaths, setBuildNumberPattern, setCheckoutDirectory, setCheckoutRules, setCheckoutType, setEnabled, textValueMatches, updateBuildFeature, updateBuildRunner, updateBuildTrigger, updateBuildTrigger
-
Methods inherited from interface jetbrains.buildServer.serverSide.CleanupSettings
getCleanupOptions, getCleanupPolicies, getInheritedCleanupOptions, getInheritedCleanupPolicies, getOwnCleanupOptions, getOwnCleanupPolicies
-
Methods inherited from interface jetbrains.buildServer.serverSide.CleanupSettingsInit
addCleanupPolicy, removeCleanupPolicies, setCleanupOption
-
Methods inherited from interface jetbrains.buildServer.serverSide.CompatibleAgents
getAgentCompatibility, getCompatibilityMap, getCompatibleAgents
-
Methods inherited from interface jetbrains.buildServer.serverSide.dependency.DependencySettings
addDependency, getDependencies, removeDependency
-
Methods inherited from interface jetbrains.buildServer.serverSide.InheritableUserParametersHolder
getInheritedParametersCollection, getOwnParameter, getOwnParameters, getOwnParametersCollection, getOwnParametersWithoutInheritedSpec, getParameters, getParametersCollection
-
Methods inherited from interface jetbrains.buildServer.serverSide.InheritableUserParametersHolderEx
getOwnAndParentsNonInheritedParameter, getOwnAndParentsNonInheritedParameters, getOwnNonInheritedParameter
-
Methods inherited from interface jetbrains.buildServer.serverSide.InternalParameters
getBooleanInternalParameter, getBooleanInternalParameterOrTrue, getInternalParameterValue
-
Methods inherited from interface jetbrains.buildServer.util.OptionSupport
getChangedOptions, getOption, getOptionDefaultValue, getOptions, getOwnOptions, setOption
-
Methods inherited from interface jetbrains.buildServer.serverSide.ReadOnlyUserParameters
getParameter, getParameterValue
-
Methods inherited from interface jetbrains.buildServer.serverSide.UserParametersHolder
addParameter, removeParameter
-
Methods inherited from interface jetbrains.buildServer.serverSide.vcs.VcsLabelingSettings
getLabelingRoots, getLabelingType, getLabelPattern
-
-
-
-
Method Detail
-
getProject
@NotNull ProjectEx getProject()
Returns the project this build type entity belongs to.- Specified by:
getProject
in interfaceBuildTypeSettings
- Returns:
- the project this build type entity belongs to.
-
setProject
void setProject(@NotNull ProjectEx project)
Sets new project to settings object- Parameters:
project
-
-
setParametersSupport
void setParametersSupport(@NotNull ParametersSupport paramsSupport)
-
copySettings
void copySettings(@NotNull BuildTypeSettingsEx source, @NotNull BuildTypeCopySettings copyOptions)
Copies settings, parameters, options etc. from another instance of build type settings.- Parameters:
source
- source settingscopyOptions
- copy options; if empty, the method regenerates setting ids for the settings that clash by ids with the inherited ones in the destination, and copies disabled and inherited settings from the source- See Also:
BuildTypeSettingsCopyOptions
-
copyAllSettings
void copyAllSettings(@NotNull BuildTypeSettingsEx source)
Copies all settings, the behaviour is the same as copySettings with empty copyOptions, i.e. it regenerates setting ids for the settings that clash by ids with the inherited ones in the destination, and copies disabled and inherited settings from the source.- Parameters:
source
-
-
copyOwnSettings
@Deprecated void copyOwnSettings(@NotNull BuildTypeSettingsEx settings)
Deprecated.
-
copyOverridableSettings
@Deprecated void copyOverridableSettings(@NotNull BuildTypeSettingsEx settingsSource)
Deprecated.
-
addListener
void addListener(@NotNull BuildTypeSettingsListener listener)
-
addListener
void addListener(@NotNull BuildTypeSettingsListener listener, boolean delayPropagation)
Adds listener to the build type settings and all settings of the attached templates- Parameters:
listener
- ListenerdelayPropagation
- If true, attaching of the listener to a template is delayed until attachedToModel is called
-
removeListener
void removeListener(@NotNull BuildTypeSettingsListener listener)
-
getTemplate
@Nullable @Deprecated BuildTypeTemplateEx getTemplate()
Deprecated.Description copied from interface:BuildTypeSettings
Returns the first template these settings are based on.- Specified by:
getTemplate
in interfaceBuildTypeSettings
- Returns:
- see above
-
getTemplates
@NotNull List<BuildTypeTemplateEx> getTemplates()
Description copied from interface:BuildTypeSettings
Returns templates these settings are based on, including the default template.- Specified by:
getTemplates
in interfaceBuildTypeSettings
- Returns:
- see above
-
getTemplateExternalId
@Nullable @Deprecated String getTemplateExternalId()
Deprecated.
-
setTemplatesOrder
void setTemplatesOrder(@NotNull List<String> templateIds)
Imposes new order on the associated templates. Unlike#setTemplatIds
this method cannot add or remove templates.- Parameters:
templateIds
- the existing template ids in the new order- Throws:
IllegalArgumentException
- if the provided list of template ids does not match the templates attached with the settings
-
setTemplateIds
void setTemplateIds(@NotNull List<String> templateIds)
Change which templates these settings are attached to. No copying of settings or cleaning of duplicates occurs in process- Parameters:
templateIds
-
-
createParametersProvider
ParametersProvider createParametersProvider(@NotNull SBuild build)
-
applyRunnersOrder
void applyRunnersOrder(@NotNull String[] ids, boolean alwaysSetCustom)
Apply custom order of build steps- Parameters:
ids
- the order defined by build step idsalwaysSetCustom
- if true, the build configuration stores the new order as a custom order even if there are no templates attached
-
attachedToModel
void attachedToModel(@NotNull ProjectDataModel model)
-
dispose
void dispose()
-
addRunParameter
void addRunParameter(@NotNull SBuildRunnerDescriptor runner, @NotNull Parameter parameter)
-
getDisabledParameterDescriptorIds
@NotNull Collection<String> getDisabledParameterDescriptorIds()
-
getBuildSettings
@NotNull BuildSettings getBuildSettings()
-
vcsRootsAccessibleInProject
boolean vcsRootsAccessibleInProject(@NotNull SProject project)
-
createReadOnlySettings
@NotNull ReadOnlyBuildTypeSettings createReadOnlySettings()
-
createCopy
@NotNull BuildTypeSettingsEx createCopy()
-
getDeclaredOption
default <T> T getDeclaredOption(@NotNull Option<T> option)
Description copied from interface:OptionSupport
Get option value declared in this BuildTypeSettings
- Specified by:
getDeclaredOption
in interfaceOptionSupport
- Parameters:
option
- option to retrieve value for- Returns:
- value of the option. If value wasn't set, null is returned
-
getTypedOption
@NotNull default <T> TypedValue<T> getTypedOption(@NotNull Option<T> option)
Description copied from interface:BuildTypeSettings
Get option extended value. See
TypedValue
. When the option is not defined in this Settings TypedValue will contain null in getValue()- Specified by:
getTypedOption
in interfaceBuildTypeSettings
-
replaceDependency
void replaceDependency(@NotNull Dependency origDep, @NotNull Dependency newDep)
Replaces original dependency object with another one
-
replaceDependency
void replaceDependency(@NotNull SArtifactDependency origDep, @NotNull SArtifactDependency newDep)
Replaces original dependency object with another one
-
replaceVcsRoot
boolean replaceVcsRoot(@NotNull SVcsRoot oldVcsRoot, @NotNull SVcsRoot newVcsRoot)
Replaces existing VCS root entry in settings with a new one, maintaining the order of the root entries- Parameters:
oldVcsRoot
- VCS root to be replacednewVcsRoot
- VCS root to insert instead- Returns:
- true if VCS root was actually replaced, false otherwise (the root to be replaced did not exist or the new root already existed)
- Since:
- 10.0
-
setVcsRoots
boolean setVcsRoots(@NotNull Collection<SVcsRoot> vcsRoots)
Sets VCS roots. All existing VCS roots that are not present in vcsRoots are deleted, all other existing VCS roots are reordered if necessary, but retain their original checkout rules.- Parameters:
vcsRoots
-- Returns:
- true if any changes occured
- Since:
- 10.0
-
getParameterDescriptorState
@NotNull default Map<String,Boolean> getParameterDescriptorState()
- Returns:
- map of parameter descriptors states. False means the parameter descriptor is disabled, true means parameter descriptor is enabled, null means parameter descriptor state is not defined here (enabled by default).
-
setSecureDataStorage
void setSecureDataStorage(@NotNull SecureDataStorage secureDataStorage)
Sets secure data storage to be used by these settings when they are persisted on disk.- Parameters:
secureDataStorage
- secure data storage- Since:
- 2017.1
-
getSecureDataStorage
@NotNull SecureDataStorage getSecureDataStorage()
- Returns:
- secure data storage used by these settings
- Since:
- 2017.1
-
getDependencyOptions
@Nullable DependencyOptions getDependencyOptions(@NotNull SBuildType buildType)
- Parameters:
buildType
- build type- Returns:
- dependency options instance if current settings instance has snapshot dependency on specified build type or null
-
getBuildTypeBranchFilterUnsafe
BranchFilter getBuildTypeBranchFilterUnsafe(@NotNull ValueResolver valueResolver) throws InvalidBranchSpecException
Same asgetBuildTypeBranchFilter(ValueResolver)
but throws an exception if the filter is incorrect- Throws:
InvalidBranchSpecException
-
getBuildTypeBranchFilter
@NotNull BranchFilter getBuildTypeBranchFilter(@NotNull ValueResolver valueResolver)
- Parameters:
valueResolver
- value resolver- Returns:
- branch filter which is used to filter branches available in this build type
- Since:
- 2019.1
-
isAgentLessBuildType
boolean isAgentLessBuildType()
-
-