com.ibm.internal.iotf.devicemgmt.ConcreteDeviceAction.java Source code

Introduction

Here is the source code for com.ibm.internal.iotf.devicemgmt.ConcreteDeviceAction.java

Source

/**
 *****************************************************************************
 Copyright (c) 2015-16 IBM Corporation and other Contributors.
 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
 Contributors:
 Mike Tran - Initial Contribution
 Sathiskumar Palaniappan - Initial Contribution
 *****************************************************************************
 *
 */

package com.ibm.internal.iotf.devicemgmt;

import java.beans.PropertyChangeListener;
import java.beans.PropertyChangeSupport;

import com.google.gson.JsonObject;
import com.google.gson.JsonPrimitive;
import com.ibm.iotf.devicemgmt.DeviceAction;

/**
 * <p>This class encapsulates the device action like reboot & factory reset.</p>
 * 
 */
public class ConcreteDeviceAction implements DeviceAction {

    public static final String DEVICE_ACTION_STATUS_UPDATE = "ListenerStatusUpdate";

    private Status status;
    private String message;
    private String typeId;
    private String deviceId;

    public ConcreteDeviceAction(String typeId, String deviceId) {
        this.typeId = typeId;
        this.deviceId = deviceId;
    }

    public String getTypeId() {
        return typeId;
    }

    public String getDeviceId() {
        return deviceId;
    }

    /**
     * <p>Set the failure status of the current device action
     * <br>
     * The Device Action handler must use this method to report 
     * the failure status back to IBM Watson IoT Platform whenever
     * there is a failure.</p>
     * 
     * @param status Failure status of the current device action
     */
    public void setStatus(Status status) {
        this.status = status;
        this.fireEvent(DEVICE_ACTION_STATUS_UPDATE);
    }

    /**
     * <p>Set the failure status of the current device action
     * <br>
     * The Device Action handler must use this method to report 
     * the failure status back to IBM Watson IoT Platform whenever
     * there is a failure.</p>
     * 
     * @param status Failure status of the current device action
     */
    public void setStatus(Status status, String message) {
        this.status = status;
        this.message = message;
        this.fireEvent(DEVICE_ACTION_STATUS_UPDATE);
    }

    public String getMessage() {
        return this.message;
    }

    private PropertyChangeSupport pcs = new PropertyChangeSupport(this);

    /**
     * Trigger the notification message - This method should only be used by the library code
     * @param event event to be fired
     */
    public void fireEvent(String event) {
        pcs.firePropertyChange(event, null, this);
    }

    /**
     * Add a new listener to be notified when device action status is changed. 
     * 
     * @param listener
     */
    public synchronized void addPropertyChangeListener(PropertyChangeListener listener) {
        pcs.addPropertyChangeListener(DEVICE_ACTION_STATUS_UPDATE, listener);
    }

    public synchronized void clearListener() {
        PropertyChangeListener[] listener = pcs.getPropertyChangeListeners(DEVICE_ACTION_STATUS_UPDATE);
        for (int i = 0; i < listener.length; i++) {
            pcs.removePropertyChangeListener(listener[i]);
        }
    }

    /**
     * Return the <code>JsonObject</code> representation of the <code>Listener Response</code> object.
     * @return JsonObject object
     */
    public JsonObject toJsonObject() {
        JsonObject o = new JsonObject();
        o.add("rc", new JsonPrimitive(this.status.get()));
        if (this.message != null) {
            o.add("message", new JsonPrimitive(message));
        }
        return o;
    }

    /**
     * Return the JSON string of the <code>Listener Response</code> object.
     */
    public String toString() {
        return toJsonObject().toString();
    }

    public int getStatus() {
        return this.status.get();
    }

    @Override
    public void setMessage(String message) {
        this.message = message;
    }
}