org.camunda.bpm.application.PreUndeploy Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of camunda-engine Show documentation

The Camunda BPMN engine + configurable support for GraalVM and support for CockroachDB.

The newest version!

/*
 * Copyright Camunda Services GmbH and/or licensed to Camunda Services GmbH
 * under one or more contributor license agreements. See the NOTICE file
 * distributed with this work for additional information regarding copyright
 * ownership. Camunda licenses this file to you under the Apache License,
 * Version 2.0; you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.camunda.bpm.application;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

import org.camunda.bpm.engine.ProcessEngine;

/**
 * Annotation that can be placed on a method of a {@link AbstractProcessApplication ProcessApplication} class.
 * 
 * The method will be invoked before the process application is undeployed.
 * 
 * 
LIMITATION: the annotation must be placed on a method of the same class carrying the 
 * {@literal @}ProcessApplication annotation. Methods of superclasses are not detected.
 * 
 * NOTE: A process application class must only define a single {@literal @}PostDeploy
 * Method.
 * 
 * NOTE: if the {@literal @}PostDeploy method throws an exception, the exception is logged but 
 * the container will still undeploy the application.
 *  
 * Basic Usage example:
 *  * {@literal @}ProcessApplication("My Process Application")
 * public class MyProcessApplication extends ServletProcessApplication {
 *  
 *  {@literal @}PreUndeploy
 *  public void cleanup(ProcessEngine processEngine) {
 *    ...
 *  }
 *  
 * }
 * 
 * 
 * A method annotated with {@literal @}PreUndeploy may additionally take the following set of 
 * parameters, in any oder: 
 * 

 *  {@link ProcessApplicationInfo}: the {@link ProcessApplicationInfo} object for this process application is injected
 *  {@link ProcessEngine} the default process engine is injected
 *  {@code List} all process engines to which this process application has performed deployments are 
 *  injected.
 * 
 * 
 * @author Daniel Meyer
 * 
 * @see PostDeploy
 *
 */
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface PreUndeploy {

}