com.telekom.m2m.cot.restsdk.devicecontrol.DeviceCredentialsApi Maven / Gradle / Ivy
package com.telekom.m2m.cot.restsdk.devicecontrol;
import com.google.gson.Gson;
import com.telekom.m2m.cot.restsdk.CloudOfThingsRestClient;
import com.telekom.m2m.cot.restsdk.util.ExtensibleObject;
import com.telekom.m2m.cot.restsdk.util.GsonUtils;
/**
* Device credentials is used to work with device credentials and new device requests.
*
* Created by Patrick Steinert on 31.01.16.
*/
public class DeviceCredentialsApi {
private static final String CONTENT_TYPE = "application/vnd.com.nsn.cumulocity.deviceCredentials+json;charset=UTF-8;ver=0.9";
private static final String RELATIVE_NEW_DEVICE_REQUEST_API_URL = "devicecontrol/newDeviceRequests/";
protected Gson gson = GsonUtils.createGson();
private final CloudOfThingsRestClient cloudOfThingsRestClient;
/**
* Constructor for this API - just used internal.
*
* @param cloudOfThingsRestClient the REST client to access CoT.
*/
public DeviceCredentialsApi(CloudOfThingsRestClient cloudOfThingsRestClient) {
this.cloudOfThingsRestClient = cloudOfThingsRestClient;
}
/**
* Retrieve the credentials of a certain device.
*
* @param deviceId the unique identifier of the device.
* @return a DeviceCredential object with the device credentials or null if not found.
*/
public DeviceCredentials getCredentials(String deviceId) {
DeviceCredentials deviceCredentials = new DeviceCredentials();
deviceCredentials.setId(deviceId);
String response = cloudOfThingsRestClient.doPostRequest(gson.toJson(deviceCredentials), "devicecontrol/deviceCredentials", CONTENT_TYPE);
return gson.fromJson(response, DeviceCredentials.class);
}
/**
* Retrieves a collection for all new device requests.
*
* @param resultSize size of the results (Max. 2000)
* @return an object to retrieve NewDeviceRequests.
*/
public NewDeviceRequestCollection getNewDeviceRequests(int resultSize) {
return new NewDeviceRequestCollection(
cloudOfThingsRestClient,
RELATIVE_NEW_DEVICE_REQUEST_API_URL,
gson,
null,
resultSize);
}
/**
* Retrieves a NewDeviceRequest by its id.
*
* @param newDeviceRequestId id of the newDeviceRequest
* @return the NewDeviceRequest.
*/
public NewDeviceRequest getNewDeviceRequest(final String newDeviceRequestId) {
final String api = RELATIVE_NEW_DEVICE_REQUEST_API_URL + newDeviceRequestId;
final String response = cloudOfThingsRestClient.getResponse(api);
final ExtensibleObject extensibleObject = gson.fromJson(response, ExtensibleObject.class);
return extensibleObject != null ?
new NewDeviceRequest(extensibleObject) : null;
}
/**
* Deletes a certain new device requests.
*
* @param deviceId the unique identifier.
*/
public void deleteNewDeviceRequests(String deviceId) {
cloudOfThingsRestClient.delete(deviceId, RELATIVE_NEW_DEVICE_REQUEST_API_URL);
}
}