Class RemoteResource

This class represents a remote resource. It provides APIs to manage remote resource.

Inheritance

Object

RemoteResource

Implements

IDisposable

Inherited Members

Object.Equals(Object)

Object.Equals(Object, Object)

Object.GetHashCode()

Object.GetType()

Object.MemberwiseClone()

Object.ReferenceEquals(Object, Object)

Object.ToString()

Namespace: Tizen.Network.IoTConnectivity

Assembly: Tizen.Network.IoTConnectivity.dll

Syntax

public class RemoteResource : IDisposable

Constructors

RemoteResource(String, String, ResourcePolicy, ResourceTypes, ResourceInterfaces)

Creates a remote resource instance.

Declaration

public RemoteResource(string hostAddress, string uriPath, ResourcePolicy policy, ResourceTypes resourceTypes, ResourceInterfaces resourceInterfaces)

Parameters

Type	Name	Description
String	hostAddress	The host address of the resource.
String	uriPath	The URI path of the resource.
ResourcePolicy	policy	The policies of the resource.
ResourceTypes	resourceTypes	The resource types of the resource.
ResourceInterfaces	resourceInterfaces	The resource interfaces of the resource.

Remarks

To use this API, you should provide all the details required to correctly contact and observe the object.

If not, you should discover the resource object manually.

The policy can contain multiple policies like ResourcePolicy.Discoverable | ResourcePolicy.Observable.

API Version

Feature

http://tizen.org/feature/iot.ocf

Exceptions

Type	Condition
NotSupportedException	Thrown when the iotcon is not supported.
OutOfMemoryException	Thrown when there is not enough memory.
ArgumentException	Thrown when there is an invalid parameter.

Properties

CacheEnabled

Indicates the CacheEnabled status of the remote resource.

Declaration

public bool CacheEnabled { get; set; }

Property Value

Type	Description
Boolean	Client can start caching only when this is set true. Set it to false to stop caching the resource attributes.

API Version

Exceptions

Type	Condition
NotSupportedException	Thrown when the iotcon is not supported.
ArgumentException	Thrown when there is an invalid parameter.
InvalidOperationException	Thrown when the operation is invalid.
UnauthorizedAccessException	Thrown when an application does not have privilege to access.
OutOfMemoryException	Thrown when there is not enough memory.

DeviceId

The device ID of the resource.

Declaration

public string DeviceId { get; }

Property Value

Type	Description
String	The device ID of the resource.

API Version

HostAddress

The host address of the resource.

Declaration

public string HostAddress { get; }

Property Value

Type	Description
String	The host address of the resource.

API Version

Interfaces

The interfaces of the resource.

Declaration

public IEnumerable<string> Interfaces { get; }

Property Value

Type	Description
IEnumerable<String>	The interfaces of the resource.

API Version

Options

The header options of the resource.

Declaration

public ResourceOptions Options { get; set; }

Property Value

Type	Description
ResourceOptions	The header options of the resource.

API Version

Exceptions

Type	Condition
NotSupportedException	Thrown when the iotcon is not supported.
ArgumentException	Thrown when there is an invalid parameter.

Policy

The policy of the resource.

Declaration

public ResourcePolicy Policy { get; }

Property Value

Type	Description
ResourcePolicy	The policy of the resource.

API Version

TimeInterval

Time interval of monitoring and caching API.

Declaration

public int TimeInterval { get; set; }

Property Value

Type	Description
Int32	Default time interval is 10 seconds. Seconds for time interval (must be in range from 1 to 3600).

API Version

Exceptions

Type	Condition
NotSupportedException	Thrown when the iotcon is not supported.
ArgumentException	Thrown when there is an invalid parameter.

Types

The resource types of the remote resource.

Declaration

public IEnumerable<string> Types { get; }

Property Value

Type	Description
IEnumerable<String>	The resource types of the remote resource.

API Version

UriPath

The URI path of the resource.

Declaration

public string UriPath { get; }

Property Value

Type	Description
String	The URI path of the resource.

API Version

Methods

CachedRepresentation()

Gets cached representation from the remote resource.

Declaration

public Representation CachedRepresentation()

Returns

Type	Description
Representation	cached representation from the remote resource.

API Version

Feature

http://tizen.org/feature/iot.ocf

DeleteAsync()

Deletes the resource asynchronously.

Declaration

public Task<RemoteResponse> DeleteAsync()

Returns

Type	Description
Task<RemoteResponse>	Remote response with result and representation.

API Version

Privilege Level

public

Privilege

http://tizen.org/privilege/internet

Feature

http://tizen.org/feature/iot.ocf

Dispose()

Releases any unmanaged resources used by this object.

Declaration

public void Dispose()

API Version

Feature

http://tizen.org/feature/iot.ocf

Dispose(Boolean)

Releases any unmanaged resources used by this object. Can also dispose any other disposable objects.

Declaration

protected virtual void Dispose(bool disposing)

Parameters

Type	Name	Description
Boolean	disposing	If true, disposes any disposable objects. If false, does not dispose disposable objects.

API Version

Feature

http://tizen.org/feature/iot.ocf

Finalize()

Destructor of the RemoteResource class.

Declaration

protected void Finalize()

GetAsync(ResourceQuery)

Gets the attributes of a resource asynchronously.

Declaration

public Task<RemoteResponse> GetAsync(ResourceQuery query = null)

Parameters

Type	Name	Description
ResourceQuery	query	The ResourceQuery to send to server.

Returns

Type	Description
Task<RemoteResponse>	Remote response with result and representation.

API Version

Privilege Level

public

Privilege

http://tizen.org/privilege/internet

Feature

http://tizen.org/feature/iot.ocf

PostAsync(Representation, ResourceQuery)

Posts request on a resource asynchronously.

Declaration

public Task<RemoteResponse> PostAsync(Representation representation, ResourceQuery query = null)

Parameters

Type	Name	Description
Representation	representation	Resource representation of request.
ResourceQuery	query	The ResourceQuery to send to server.

Returns

Type	Description
Task<RemoteResponse>	Remote response with result and representation.

API Version

Privilege Level

public

Privilege

http://tizen.org/privilege/internet

Feature

http://tizen.org/feature/iot.ocf

PutAsync(Representation, ResourceQuery)

Puts the representation of a resource asynchronously.

Declaration

public Task<RemoteResponse> PutAsync(Representation representation, ResourceQuery query = null)

Parameters

Type	Name	Description
Representation	representation	Resource representation to put.
ResourceQuery	query	The ResourceQuery to send to server.

Returns

Type	Description
Task<RemoteResponse>	Remote response with result and representation.

API Version

Privilege Level

public

Privilege

http://tizen.org/privilege/internet

Feature

http://tizen.org/feature/iot.ocf

StartObserving(ObservePolicy, ResourceQuery)

Starts observing on the resource.

Declaration

public void StartObserving(ObservePolicy policy, ResourceQuery query = null)

Parameters

Type	Name	Description
ObservePolicy	policy	The type to specify how client wants to observe.
ResourceQuery	query	The query to send to server.

Remarks

When server sends notification message, ObserverNotified will be called.

API Version

Privilege Level

public

Privilege

http://tizen.org/privilege/internet

Feature

http://tizen.org/feature/iot.ocf

Exceptions

Type	Condition
NotSupportedException	Thrown when the iotcon is not supported.
InvalidOperationException	Thrown when the operation is invalid.
UnauthorizedAccessException	Thrown when an application does not have privilege to access.
OutOfMemoryException	Thrown when there is not enough memory.

StopObserving()

Stops observing on the resource.

Declaration

public void StopObserving()

API Version

Privilege Level

public

Privilege

http://tizen.org/privilege/internet

Feature

http://tizen.org/feature/iot.ocf

Exceptions

Type	Condition
NotSupportedException	Thrown when the iotcon is not supported.
InvalidOperationException	Thrown when the operation is invalid.
UnauthorizedAccessException	Thrown when an application does not have privilege to access.

Events

CacheUpdated

The event is invoked with cached resource attributes.

Declaration

public event EventHandler<CacheUpdatedEventArgs> CacheUpdated

Event Type

Type	Description
EventHandler<CacheUpdatedEventArgs>

API Version

ObserverNotified

Observe an event on the resource sent by the server.

Declaration

public event EventHandler<ObserverNotifiedEventArgs> ObserverNotified

Event Type

Type	Description
EventHandler<ObserverNotifiedEventArgs>

API Version

StateChanged

The event is called when remote resource's state are changed.

Declaration

public event EventHandler<StateChangedEventArgs> StateChanged

Event Type

Type	Description
EventHandler<StateChangedEventArgs>

API Version

Implements

System.IDisposable