Interface EPStageService
- All Known Subinterfaces:
EPStageServiceSPI
- All Known Implementing Classes:
EPStageServiceImpl
public interface EPStageService
Stages are used for staging deployments allowing independent control over event and time for subsets of deployments.
This API is under development for version 8.4 and newer, and is considered UNSTABLE.
Stages are uniquely identified by a stage URI.
Use getStage(String)
to allocate a stage, of if the stage is already allocated to obtain the stage.
Use getExistingStage(String)
to obtain an existing stage without allocating.
-
Method Summary
Modifier and TypeMethodDescriptiongetExistingStage
(String stageUri) Returns the existing stage for the provided URI, or null if a stage for the URI has not already been allocated.Allocate a new stage or returns the existing stage if the stage for the same URI is already allocated.String[]
Returns the URI values of all stages that are currently allocated.
-
Method Details
-
getStage
Allocate a new stage or returns the existing stage if the stage for the same URI is already allocated.- Parameters:
stageUri
- unique identifier- Returns:
- stage
- Throws:
EPRuntimeDestroyedException
- if the runtime is already destroyed
-
getExistingStage
Returns the existing stage for the provided URI, or null if a stage for the URI has not already been allocated.- Parameters:
stageUri
- stage URI- Returns:
- stage
- Throws:
EPRuntimeDestroyedException
- if the runtime is already destroyed
-
getStageURIs
Returns the URI values of all stages that are currently allocated.- Returns:
- stage URIs
- Throws:
EPRuntimeDestroyedException
- if the runtime is already destroyed
-