From b3702672a32644c56fae8f91fc8f22cf35ffd4f4 Mon Sep 17 00:00:00 2001
From: Michael Hirsch <michael.hirsch@bosch-si.com>
Date: Mon, 8 Aug 2016 09:14:48 +0200
Subject: [PATCH] add javadoc

Signed-off-by: Michael Hirsch <michael.hirsch@bosch-si.com>
---
 .../repository/jpa/model/EntityPropertyChangeListener.java | 3 ++-
 .../hawkbit/repository/jpa/model/EventAwareEntity.java     | 7 +++++++
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/hawkbit-repository/hawkbit-repository-jpa/src/main/java/org/eclipse/hawkbit/repository/jpa/model/EntityPropertyChangeListener.java b/hawkbit-repository/hawkbit-repository-jpa/src/main/java/org/eclipse/hawkbit/repository/jpa/model/EntityPropertyChangeListener.java
index 13b1507db..27fbc687e 100644
--- a/hawkbit-repository/hawkbit-repository-jpa/src/main/java/org/eclipse/hawkbit/repository/jpa/model/EntityPropertyChangeListener.java
+++ b/hawkbit-repository/hawkbit-repository-jpa/src/main/java/org/eclipse/hawkbit/repository/jpa/model/EntityPropertyChangeListener.java
@@ -13,7 +13,8 @@ import org.eclipse.persistence.descriptors.DescriptorEvent;
 import org.eclipse.persistence.descriptors.DescriptorEventAdapter;
 
 /**
- * Listens to change in property values of an entity.
+ * Listens to change in property values of an entity and calls the corresponding
+ * {@link EventAwareEntity}.
  *
  */
 public class EntityPropertyChangeListener extends DescriptorEventAdapter {
diff --git a/hawkbit-repository/hawkbit-repository-jpa/src/main/java/org/eclipse/hawkbit/repository/jpa/model/EventAwareEntity.java b/hawkbit-repository/hawkbit-repository-jpa/src/main/java/org/eclipse/hawkbit/repository/jpa/model/EventAwareEntity.java
index 95a14a979..889a61796 100644
--- a/hawkbit-repository/hawkbit-repository-jpa/src/main/java/org/eclipse/hawkbit/repository/jpa/model/EventAwareEntity.java
+++ b/hawkbit-repository/hawkbit-repository-jpa/src/main/java/org/eclipse/hawkbit/repository/jpa/model/EventAwareEntity.java
@@ -10,22 +10,29 @@ package org.eclipse.hawkbit.repository.jpa.model;
 
 import org.eclipse.persistence.descriptors.DescriptorEvent;
 
+/**
+ * Interfaces which can be implemented by entities to be called when the entity
+ * should fire an event because the entity has been created, updated or deleted.
+ */
 public interface EventAwareEntity {
 
     /**
      * Fired for the Entity creation.
+     * 
      * @param descriptorEvent
      */
     void fireCreateEvent(DescriptorEvent descriptorEvent);
 
     /**
      * Fired for the Entity updation.
+     * 
      * @param descriptorEvent
      */
     void fireUpdateEvent(DescriptorEvent descriptorEvent);
 
     /**
      * Fired for the Entity deletion.
+     * 
      * @param descriptorEvent
      */
     void fireDeleteEvent(DescriptorEvent descriptorEvent);