Interface ReleaseOperation
public interface ReleaseOperation
Operation providing means to release
elements on the server.- Since:
- 5.2.180606, 5.2.180702
-
Nested Class Summary
Nested ClassesModifier and TypeInterfaceDescriptionstatic interfaceInterface representing the result of therelease operation. -
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final OperationType<ReleaseOperation>The operation's type. -
Method Summary
Modifier and TypeMethodDescription@NotNull ReleaseOperationcheckOnly(boolean checkOnly) Defines if an release should actually be accomplished or only checked.@NotNull ReleaseOperationdependentReleaseType(IDProvider.DependentReleaseType dependentReleaseType) The dependent type specifying the behaviour for referenced elements of the given releaseStartNode (seeIDProvider.DependentReleaseTypefor details).@NotNull ReleaseOperationensureAccessibility(boolean ensureAccessibility) Iftrueeach element on the parent path of each element (except for datasets) will be released.Set of languages the release operation should be valid for.@NotNull ReleaseOperation.ReleaseResultperform(@NotNull IDProvider... elements) Performs the operation and releases the givenelementson the server.@NotNull ReleaseOperation.ReleaseResultperform(@NotNull Collection<IDProvider> elements) Performs the operation and releases the givenCollectionofelementson the server.@NotNull ReleaseOperationrecursive(boolean recursive) Iftruethe subtree of each element (except for datasets) will be released recursive.@NotNull ReleaseOperationwithComment(@Nullable String comment) The release comment, may benull.
-
Field Details
-
TYPE
The operation's type.- Since:
- 5.2.180606, 5.2.180702
-
-
Method Details
-
dependentReleaseType
@NotNull @NotNull ReleaseOperation dependentReleaseType(@Nullable IDProvider.DependentReleaseType dependentReleaseType) The dependent type specifying the behaviour for referenced elements of the given releaseStartNode (seeIDProvider.DependentReleaseTypefor details). IfnullthenIDProvider.DependentReleaseType.NO_DEPENDENT_RELEASEis used.- Parameters:
dependentReleaseType- seeIDProvider.DependentReleaseType- Returns:
- the current ReleaseOperation object
- Since:
- 5.2.180606, 5.2.180702
-
ensureAccessibility
Iftrueeach element on the parent path of each element (except for datasets) will be released.- Parameters:
ensureAccessibility- iftrueeach element on the parent path of each element (except for datasets) will be released.- Returns:
- the current ReleaseOperation object
- Since:
- 5.2.180606, 5.2.180702
-
recursive
Iftruethe subtree of each element (except for datasets) will be released recursive.- Parameters:
recursive- iftruethe subtree of each element (except for datasets) will be released recursive.- Returns:
- the current ReleaseOperation object
- Since:
- 5.2.180606, 5.2.180702
-
checkOnly
Defines if an release should actually be accomplished or only checked.- Parameters:
checkOnly- iftruethe release will only be checked- Returns:
- the current ReleaseOperation object
- Since:
- 5.2.180606, 5.2.180702
-
withComment
The release comment, may benull.- Parameters:
comment- the comment for this release- Returns:
- the current ReleaseOperation object
- Since:
- 5.2.180606, 5.2.180702
-
languages
Set of languages the release operation should be valid for. If not set or empty, the release operation is valid for all languages.- Parameters:
languages- The languages this release operation is valid for, or empty if the release operation is valid for all languages- Returns:
- the current ReleaseOperation object
- Since:
- 5.2.250102
-
perform
@NotNull @NotNull ReleaseOperation.ReleaseResult perform(@NotNull @NotNull IDProvider... elements) throws Exception Performs the operation and releases the givenelementson the server. Note that at least oneelementmust be given and all elements must be != null.- Parameters:
elements- theelementsto be released- Returns:
- the result of this release operation
- Throws:
IllegalArgumentException- if the amount of given elements is 0NullPointerException- if one of the given elements is nullException- if any server side error occurred during the operations execution- Since:
- 5.2.180606, 5.2.180702
-
perform
@NotNull @NotNull ReleaseOperation.ReleaseResult perform(@NotNull @NotNull Collection<IDProvider> elements) throws Exception Performs the operation and releases the givenCollectionofelementson the server. Note that at least oneelementmust be given and all elements must be != null.- Parameters:
elements- the collectionelementsto be released- Returns:
- the result of this release operation
- Throws:
IllegalArgumentException- if the amount of given elements is 0NullPointerException- if one of the given elements is nullException- if any server side error occurred during the operations execution- Since:
- 5.2.180606, 5.2.180702
-