public interface DeploymentBuilder
Builder for creating new deployments.
A builder instance can be obtained through RepositoryService.createDeployment()
.
Multiple resources can be added to one deployment before calling the deploy()
operation.
After deploying, no more changes can be made to the returned deployment and the builder instance can be disposed.
In order the resources to be processed as definitions, their names must have one of allowed suffixes (file extensions in case of file reference).
Resource name suffix | Will be treated as |
---|---|
.bpmn20.xml, .bpmn | BPMN process definition |
.cmmn11.xml, .cmmn10.xml, .cmmn | CMMN case definition |
.dmn11.xml, .dmn | DMN decision table |
Additionally resources with resource name suffixes .png, .jpg, .gif and .svg can be treated as diagram images. The deployment resource is considered to represent the specific model diagram by file name, e.g. bpmnDiagram1.png will be considered to be a diagram image for bpmnDiagram1.bpmn20.xml.
Modifier and Type | Method and Description |
---|---|
DeploymentBuilder |
activateProcessDefinitionsOn(Date date)
Sets the date on which the process definitions contained in this deployment
will be activated.
|
DeploymentBuilder |
addClasspathResource(String resource) |
DeploymentBuilder |
addDeploymentResourceById(String deploymentId,
String resourceId)
A given resource specified by id and deployment id will be added
to the new deployment to re-deploy the given resource.
|
DeploymentBuilder |
addDeploymentResourceByName(String deploymentId,
String resourceName)
A given resource specified by name and deployment id will be added
to the new deployment to re-deploy the given resource.
|
DeploymentBuilder |
addDeploymentResources(String deploymentId)
All existing resources contained by the given deployment
will be added to the new deployment to re-deploy them.
|
DeploymentBuilder |
addDeploymentResourcesById(String deploymentId,
List<String> resourceIds)
All given resources specified by id and deployment id will be added
to the new deployment to re-deploy the given resource.
|
DeploymentBuilder |
addDeploymentResourcesByName(String deploymentId,
List<String> resourceNames)
All given resources specified by name and deployment id will be added
to the new deployment to re-deploy the given resource.
|
DeploymentBuilder |
addInputStream(String resourceName,
InputStream inputStream) |
DeploymentBuilder |
addModelInstance(String resourceName,
BpmnModelInstance modelInstance)
Adds a BPMN model to the deployment.
|
DeploymentBuilder |
addModelInstance(String resourceName,
CmmnModelInstance modelInstance)
Adds a CMMN model to the deployment.
|
DeploymentBuilder |
addModelInstance(String resourceName,
DmnModelInstance modelInstance)
Adds a DMN model to the deployment.
|
DeploymentBuilder |
addString(String resourceName,
String text) |
DeploymentBuilder |
addZipInputStream(ZipInputStream zipInputStream) |
Deployment |
deploy()
Deploys all provided sources to the process engine and returns the created deployment.
|
DeploymentWithDefinitions |
deployWithResult()
Deploys all provided sources to the process engine and returns the created deployment with the deployed definitions.
|
DeploymentBuilder |
enableDuplicateFiltering()
Deprecated.
|
DeploymentBuilder |
enableDuplicateFiltering(boolean deployChangedOnly)
Check the resources for duplicates in the set of previous deployments with
same deployment source.
|
Collection<String> |
getResourceNames() |
DeploymentBuilder |
name(String name)
Gives the deployment the given name.
|
DeploymentBuilder |
nameFromDeployment(String deploymentId)
Sets the deployment id to retrieve the deployment name from it.
|
DeploymentBuilder |
source(String source)
Sets the source of a deployment.
|
DeploymentBuilder |
tenantId(String tenantId)
Sets the tenant id of a deployment.
|
DeploymentBuilder addInputStream(String resourceName, InputStream inputStream)
DeploymentBuilder addClasspathResource(String resource)
DeploymentBuilder addString(String resourceName, String text)
DeploymentBuilder addModelInstance(String resourceName, BpmnModelInstance modelInstance)
resourceName
- resource name. See suffix requirements for resource names: DeploymentBuilder
.modelInstance
- model instanceDeploymentBuilder addModelInstance(String resourceName, DmnModelInstance modelInstance)
resourceName
- resource name. See suffix requirements for resource names: DeploymentBuilder
.modelInstance
- model instanceDeploymentBuilder addModelInstance(String resourceName, CmmnModelInstance modelInstance)
resourceName
- resource name. See suffix requirements for resource names: DeploymentBuilder
.modelInstance
- model instanceDeploymentBuilder addZipInputStream(ZipInputStream zipInputStream)
DeploymentBuilder addDeploymentResources(String deploymentId)
NotValidException
- if deployment id is null.DeploymentBuilder addDeploymentResourceById(String deploymentId, String resourceId)
NotValidException
- if either deployment id or resource id is null.DeploymentBuilder addDeploymentResourcesById(String deploymentId, List<String> resourceIds)
NotValidException
- if either deployment id or the list of resource ids is null.DeploymentBuilder addDeploymentResourceByName(String deploymentId, String resourceName)
NotValidException
- if either deployment id or resource name is null.DeploymentBuilder addDeploymentResourcesByName(String deploymentId, List<String> resourceNames)
NotValidException
- if either deployment id or the list of resource names is null.DeploymentBuilder name(String name)
NotValidException
- if nameFromDeployment(String)
has been called before.DeploymentBuilder nameFromDeployment(String deploymentId)
NotValidException
- if name(String)
has been called before.@Deprecated DeploymentBuilder enableDuplicateFiltering()
If set, this deployment will be compared to any previous deployment. This means that every (non-generated) resource will be compared with the provided resources of this deployment. If any resource of this deployment is different to the existing resources, all resources are re-deployed.
Deprecated: use enableDuplicateFiltering(boolean)
DeploymentBuilder enableDuplicateFiltering(boolean deployChangedOnly)
deployChangedOnly
.deployChangedOnly
- determines whether only those resources should be
deployed that have changed from the previous versions of the deployment.
If false, all of the resources are re-deployed if any resource differs.DeploymentBuilder activateProcessDefinitionsOn(Date date)
DeploymentBuilder source(String source)
Sets the source of a deployment.
Furthermore if duplicate check of deployment resources is enabled (by calling
enableDuplicateFiltering(boolean)
) then only previous deployments
with the same given source are considered to perform the duplicate check.
Deployment deploy()
Deploys all provided sources to the process engine and returns the created deployment.
The returned Deployment
instance has no information about the definitions, which are deployed
with that deployment. To access this information you can use the deployWithResult()
method.
This method will return an instance of DeploymentWithDefinitions
, which contains the information
about the successful deployed definitions.
NotFoundException
- thrown
nameFromDeployment(String)
does not exist oraddDeploymentResources(String)
does not exist.NotValidException
- if there are duplicate resource names from different deployments to re-deploy.AuthorizationException
- thrown if the current user does not possess the following permissions:
Permissions.CREATE
on Resources.DEPLOYMENT
Permissions.READ
on Resources.DEPLOYMENT
(if resources from previous deployments are redeployed)DeploymentWithDefinitions deployWithResult()
NotFoundException
- thrown
nameFromDeployment(String)
does not exist oraddDeploymentResources(String)
does not exist.NotValidException
- if there are duplicate resource names from different deployments to re-deploy.AuthorizationException
- thrown if the current user does not possess the following permissions:
Permissions.CREATE
on Resources.DEPLOYMENT
Permissions.READ
on Resources.DEPLOYMENT
(if resources from previous deployments are redeployed)Collection<String> getResourceNames()
DeploymentBuilder tenantId(String tenantId)
Copyright © 2022. All rights reserved.