Renamed to ApplicationEvents to emphasize application layer home.

dddsample/src/main/java/se/citerus/dddsample/application/SystemEvents.java → dddsample/src/main/java/se/citerus/dddsample/application/ApplicationEvents.java

@@ -11,7 +11,7 @@ import se.citerus.dddsample.domain.model.handling.HandlingEvent;
  * It may be implemented synchronously or asynchronously, using
  * for example JMS.
  */
-public interface SystemEvents {
+public interface ApplicationEvents {
 
   /**
    * A cargo has been handled.
@@ -20,12 +20,33 @@ public interface SystemEvents {
    */
   void cargoWasHandled(HandlingEvent event);
 
+  /**
+   * A cargo has been misdirected.
+   *
+   * @param cargo cargo
+   */
   void cargoWasMisdirected(Cargo cargo);
 
+  /**
+   * A cargo has arrived at its final destination.
+   *
+   * @param cargo cargo
+   */
   void cargoHasArrived(Cargo cargo);
 
-  void rejectHandlingEventRegistrationAttempt(HandlingEventRegistrationAttempt attempt, CannotCreateHandlingEventException problem);
-
+  /**
+   * A handling event regitration attempt is received.
+   *
+   * @param attempt handling event registration attempt
+   */
   void receivedHandlingEventRegistrationAttempt(HandlingEventRegistrationAttempt attempt);
 
+  /**
+   * A handling event regitration attempt is rejected for a certain reason.
+   *
+   * @param attempt handling event registration attempt
+   * @param cause cause of rejection
+   */
+  void rejectedHandlingEventRegistrationAttempt(HandlingEventRegistrationAttempt attempt, CannotCreateHandlingEventException cause);
+
 }