Developing Apama Applications > Developing Clients > The JavaBeans API > Delete operations
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.
Copyright © 2013 Software AG, Darmstadt, Germany and/or Software AG USA Inc., Reston, VA, USA, and/or Terracotta Inc., San Francisco, CA, USA, and/or Software AG (Canada) Inc., Cambridge, Ontario, Canada, and/or, Software AG (UK) Ltd., Derby, United Kingdom, and/or Software A.G. (Israel) Ltd., Or-Yehuda, Israel and/or their licensors.