Target attributes update can be (re-)triggered by management API (#690)

* extend Management API with attribute `requestAttributes`
* introduce new DMF Event Topic `REQUEST_ATTRIBUTES_UPDATE`
* enhance REST documentation by new functionality
* add tests for:
  * Management API
  * Amqp Message Dispatcher Service
  * Repository (Target Management)

Signed-off-by: Jeroen Jan Laverman (INST/ESY3) <jeroen.laverman@bosch-si.com>

hawkbit-repository/hawkbit-repository-api/src/main/java/org/eclipse/hawkbit/repository/TargetManagement.java

@@ -109,8 +109,7 @@ public interface TargetManagement {
             Long installedOrAssignedDistributionSetId, Boolean selectTargetWithNoTag, String... tagNames);
 
     /**
-     * Counts number of targets with given
-     * {@link Target#getInstalledDistributionSet()}.
+     * Counts number of targets with given with given distribution set Id
      *
      * @param distId
      *            to search for
@@ -630,4 +629,25 @@ public interface TargetManagement {
      *             if target with given ID does not exist
      */
     Map<String, String> getControllerAttributes(@NotEmpty String controllerId);
+
+    /**
+     * Trigger given {@link Target} to update its attributes.
+     *
+     * @param controllerId
+     *            of the target
+     *
+     * @throws EntityNotFoundException
+     *             if target with given ID does not exist
+     */
+    void requestControllerAttributes(@NotEmpty String controllerId);
+
+    /**
+     * Check if update of given {@link Target} attributes is already requested.
+     * 
+     * @param controllerId
+     *            of target
+     * @return {@code true}: update of controller attributes triggered.
+     *         {@code false}: update of controller attributes not requested.
+     */
+    boolean isControllerAttributesRequested(@NotEmpty String controllerId);
 }

hawkbit-repository/hawkbit-repository-api/src/main/java/org/eclipse/hawkbit/repository/builder/TargetUpdate.java

@@ -67,4 +67,10 @@ public interface TargetUpdate {
      * @return updated builder instance
      */
     TargetUpdate status(@NotNull TargetUpdateStatus status);
+
+    /**
+     * @param requestAttributes for {@link Target#isRequestControllerAttributes()}
+     * @return updated builder instance
+     */
+    TargetUpdate requestAttributes(Boolean requestAttributes);
 }

hawkbit-repository/hawkbit-repository-api/src/main/java/org/eclipse/hawkbit/repository/event/remote/TargetAttributesRequestedEvent.java

@@ -0,0 +1,58 @@
+/**
+ * Copyright (c) 2018 Bosch Software Innovations GmbH and others.
+ *
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ */
+package org.eclipse.hawkbit.repository.event.remote;
+
+import org.eclipse.hawkbit.repository.model.Target;
+
+/**
+ * Defines the remote event of triggering attribute updates of a {@link Target}.
+ */
+public class TargetAttributesRequestedEvent extends RemoteIdEvent {
+    private static final long serialVersionUID = 1L;
+    private String controllerId;
+    private String targetAddress;
+
+    /**
+     * Default constructor.
+     */
+    public TargetAttributesRequestedEvent() {
+        // for serialization libs like jackson
+    }
+
+    /**
+     * Constructor json serialization
+     *
+     * @param tenant
+     *            the tenant
+     * @param entityId
+     *            the entity id
+     * @param controllerId
+     *            the controllerId of the target
+     * @param targetAddress
+     *            the target address
+     * @param entityClass
+     *            the entity class
+     * @param applicationId
+     *            the origin application id
+     */
+    public TargetAttributesRequestedEvent(final String tenant, final Long entityId, final String controllerId,
+            final String targetAddress, final String entityClass, final String applicationId) {
+        super(entityId, tenant, entityClass, applicationId);
+        this.controllerId = controllerId;
+        this.targetAddress = targetAddress;
+    }
+
+    public String getControllerId() {
+        return controllerId;
+    }
+
+    public String getTargetAddress() {
+        return targetAddress;
+    }
+}