org.camunda.bpm.application.PreUndeploy Maven / Gradle / Ivy
/*
* 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 {
}