V
- the type of the VirtualDevice instancepublic abstract class Client<V extends AbstractVirtualDevice>
extends java.lang.Object
implements java.io.Closeable
Modifier and Type | Method and Description |
---|---|
abstract StorageObject |
createStorageObject(java.lang.String name,
java.lang.String contentType)
Create a new
StorageObject with the given object name and mime-type. |
abstract V |
createVirtualDevice(java.lang.String deviceId,
DeviceModel deviceModel)
Create an
AbstractVirtualDevice instance with the given device model
for the given device identifier. |
abstract DeviceModel |
getDeviceModel(java.lang.String deviceModelUrn)
Get the
DeviceModel for the device model URN. |
public abstract V createVirtualDevice(java.lang.String deviceId, DeviceModel deviceModel)
AbstractVirtualDevice
instance with the given device model
for the given device identifier. This method creates a new VirtualDevice
instance for the given parameters. The client library does not
cache previously created VirtualDevice objects.deviceId
- The device identifier of the device being modeleddeviceModel
- The device model URN that this device implementsjava.lang.IllegalArgumentException
- if the device does not implement the modeljava.lang.NullPointerException
- if deviceId or deviceModel are null
public abstract DeviceModel getDeviceModel(java.lang.String deviceModelUrn) throws java.io.IOException, java.security.GeneralSecurityException
DeviceModel
for the device model URN. This method may
return null
if there is no device model for the URN. Null may also be
returned if the device model is a "draft" and the property
com.oracle.iot.client.device.allow_draft_device_models
is set to
false
, which is the default.deviceModelUrn
- the URN of the device modelnull
if it does not existjava.lang.NullPointerException
- if deviceModel is null
java.io.IOException
- if there is an I/O error when communicating
with the serverjava.security.GeneralSecurityException
- when key or signature algorithm class
cannot be loaded, or the key is not in
the trusted assets store, or the
private key is invalidpublic abstract StorageObject createStorageObject(java.lang.String name, java.lang.String contentType) throws java.io.IOException, java.security.GeneralSecurityException
StorageObject
with the given object name and mime-type.
If contentType
is null, the mime-type defaults to "application/octet-stream".name
- the unique name to be used to reference the content in storagecontentType
- The mime-type of the contentjava.io.IOException
- if there is an IOException
raised by the runtime,
or an abnormal response from the storage cloudjava.security.GeneralSecurityException
- if there is an exception establishing a secure connection to the storage cloud