Delete operations
The delete operations are defined in the interface com.apama.engine.beans.interfaces.DeleteOperationsInterface.
These are implemented in com.apama.engine.beans.EngineClientBean.
Note the distinction between delete, forced delete, and kill.
Delete will only work if the EPL element being deleted (an event type or monitor) is not referenced by any other element. So, for example, you cannot
delete an event type that is used by any monitors.
Forced delete will delete the specified element
as well as all other elements that refer to it. For example, if monitor
A has listeners for
B events and
C events and you forcibly delete
C events the operation deletes monitor
A, which of course means that the listener for
B events is deleted.
Kill is a stronger form of
forced delete.
Forced delete might fail to remove a monitor that is stuck in an infinite loop, whereas
kill would remove the monitor at the next loop iteration.
The delete operations are:
void deleteAll() - Deletes everything from the remote correlator (or
engine). This is equivalent to a
kill being applied to everything.
void deleteName(java.lang.String name, boolean force) -
Delete an EPL event type or monitor (i.e., a
name) from the remote correlator.
void deleteNames(java.util.List<java.lang.String> names, boolean force) -
Delete a number of EPL elements.
void deleteNamesFromFile(java.util.List<java.lang.String> filenames, boolean force) -
Delete a number of EPL elements listed in one or more filenames (or
stdin).
void deleteNamesFromFile(java.util.List<java.lang.String> filenames, boolean force, boolean utf8) -
Delete a number of EPL elements listed in one or more filenames (or
stdin).
void killName(java.lang.String name) - Kill an EPL element from the remote correlator.
void killNames(java.util.List<java.lang.String> names) -
Kill a number of EPL elements.
void killNamesFromFile(java.util.List<java.lang.String> filenames) -
Kill a number of EPL elements listed in one or more filenames (or
stdin).
void setCancelDeleteFileRead(boolean newCancelFileReadValue) - Setter for the “
cancelFileRead” property for the Delete / Kill operations. The purpose of the “
cancelFileRead” property is to provide a mechanism to cleanly terminate the processing of deletion of elements from a file, when the
deleteNamesFromFile method is in progress. When “
cancelFileRead” is set to
true, the deleting loop will terminate at the next iteration.