Method Detail

• isStoringEventsOf

  boolean isStoringEventsOf​(Optional<String> projectAreaId)

  Determines whether the store is currently able to store events and, optionally, for a particular project.

  This method must not raise any exception, false must be returned silently if any of them occurred while computing the result.

  Implementations should use a temporary cache for keeping results for a very brief moment (at most 1s) in order to optimize performance. The intention is just to avoid multiple computations of the result during a single storage request, where it's very likely all events belong to the same project.

  Parameters:

  projectAreaId - the optional project identifier.

  Returns:

  true if the given project is TRS exposed, the TRS store is not corrupted and the corresponding base is computed; false otherwise.

  Since:

  3.3.0

• store

  void store​(ResourceEvent... resourceEvents)

  Stores one or a few resource events. If a larger volume of events is to send at once, client is recommended to rather use the store(Function) method.

  Implementations MUST store events, without blocking the application, only if the isStoringEventsOf(Optional) method returns true, for each of the given event seeds, and must keep them hidden from the TRS feed up to the TrsStore.synchronizeResourceEvents(int) method is called.

  This method is intended to avoid raising TrsStoreException, if something went wrong preventing the storage of the event, implementations must corrupt the storage silently.

  Parameters:

  resourceEvents - events to store.

• store

  void store​(Function<Consumer<ResourceEvent>,​?> eventsProvider)

  Stores resource events. If only one or a few events are to report at once, client may use the simpler store(ResourceEvent...) method.

  Implementations MUST store events, without blocking the application, only if the isStoringEventsOf(Optional) method returns true, for each of the given event seeds, and must keep them hidden from the TRS feed up to the TrsStore.synchronizeResourceEvents(int) method is called.

  This method is intended to avoid raising TrsStoreException, if something went wrong preventing the storage of the event, implementations must corrupt the storage silently.

  The function argument provides access to change events to be added in this store. Implementation must call the apply() method of this function and use, as argument, a Consumer to get notified of events. Implementation is advised to use a BufferedConsumer for optimal performance.

  Parameters:

  eventsProvider - a function that provides access to change events to become part of the trs:ChangeLog.

  See Also:

  BufferedConsumer, store(ResourceEvent...)

• deleteResourcesOf

  void deleteResourcesOf​(String projectId)

  Creates ResourceEvent.Type.DELETED events for all exposed resources of the given project in the store.

  This method is convenient to un-expose all resources of a deleted project in the hosting application.

  Implementations MUST store events, without blocking the application, only if the isStoringEventsOf(Optional) method returns true for the given project (at the beginning of the process) and MUST avoid calling it again for each individual resource event seed because the project could not be longer accessible, and therefore, the isStoringEventsOf(Optional) method could return false for some events. If implementations decide to do not call the isStoringEventsOf(Optional) method at all, because the project could not be longer accessible from the beginning, they MUST ensure that: the store is not corrupted, the base is computed and there is a TRS functional user configured before saving events. The events MUST keep hidden from the TRS feed up to the TrsStore.synchronizeResourceEvents(int) method is called.

  This method is intended to avoid raising TrsStoreException, if something went wrong preventing the storage of the event, implementations must corrupt the storage silently.

  Parameters:

  projectId - the project identifier of the resources to un-expose.

  Since:

  3.3.0