Class Resource

Abstract class respresenting a resource. All resources need to inherit from this class.

Inheritance

Object

Resource

LiteResource

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 abstract class Resource : IDisposable

Constructors

Resource(String, ResourceTypes, ResourceInterfaces, ResourcePolicy)

The constructor.

Declaration

protected Resource(string uri, ResourceTypes types, ResourceInterfaces interfaces, ResourcePolicy policy)

Parameters

Type	Name	Description
String	uri	The URI path of the resource.
ResourceTypes	types	Resource types.
ResourceInterfaces	interfaces	Resource interfaces.
ResourcePolicy	policy	The policies of the resoruce.

Remarks

uri format would be relative URI path like '/a/light' and its length must be less than 128.

API Version

3

Precondition

IoTConnectivityServerManager.Initialize() should be called to initialize.

Privilege Level

public

Privilege

http://tizen.org/privilege/internet

Feature

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

Examples

     // Create a class which inherits from Resource
     public class DoorResource : Resource
     {
         public DoorResource(string uri, ResourceTypes types, ResourceInterfaces interfaces, ResourcePolicy policy)
                 : base(uri, types, interfaces, policy) {
         }
         protected override Response OnDelete(Request request) {
             // Do something
         }
         protected override Response OnGet(Request request) {
             // Do something
         }
         // Override other abstract methods of Resource class
     }

     // Use it like below
     ResourceInterfaces ifaces = new ResourceInterfaces(new List<string>(){ ResourceInterfaces.DefaultInterface });
     ResourceTypes types = new ResourceTypes(new List<string>(){ "oic.iot.door.new" });
     Resource resource = new DoorResource("/door/uri1", types, ifaces, ResourcePolicy.Discoverable | ResourcePolicy.Observable);

Exceptions

Type	Condition
NotSupportedException	Thrown when the iotcon is not supported.
OutOfMemoryException	Thrown when there is not enough memory.

See Also

ResourceTypes

ResourceInterfaces

ResourcePolicy

Properties

Children

List of Child resources.

Declaration

public ICollection<Resource> Children { get; }

Property Value

Type	Description
ICollection<Resource>	List of Child resources.

API Version

3

Interfaces

Interface details of the resource.

Declaration

public ResourceInterfaces Interfaces { get; }

Property Value

Type	Description
ResourceInterfaces	Interface details of the resource.

API Version

3

Policy

The policies of the resource.

Declaration

public ResourcePolicy Policy { get; }

Property Value

Type	Description
ResourcePolicy	The policies of the resource.

API Version

3

Types

Type details of the resource.

Declaration

public ResourceTypes Types { get; }

Property Value

Type	Description
ResourceTypes	Type details of the resource.

API Version

3

UriPath

URI path of the resource.

Declaration

public string UriPath { get; }

Property Value

Type	Description
String	URI path of the resource.

API Version

3

Methods

Dispose()

Releases any unmanaged resources used by this object.

Declaration

public void Dispose()

API Version

3

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

3

Feature

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

Finalize()

Destructor of the Resource class.

Declaration

protected void Finalize()

Notify(Representation, QualityOfService)

Notify the specified representation and qos.

Declaration

public void Notify(Representation representation, QualityOfService qos)

Parameters

Type	Name	Description
Representation	representation	Representation.
QualityOfService	qos	The quality of service for message transfer.

API Version

3

Precondition

IoTConnectivityServerManager.Initialize() should be called to initialize.

Privilege Level

public

Privilege

http://tizen.org/privilege/internet

Feature

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

Examples

     ResourceInterfaces ifaces = new ResourceInterfaces(new List<string>(){ ResourceInterfaces.DefaultInterface });
     ResourceTypes types = new ResourceTypes(new List<string>(){ "oic.iot.door.new.notify" });
     Resource resource = new DoorResource("/door/uri/new/notify", types, ifaces, ResourcePolicy.Discoverable | ResourcePolicy.Observable);
     IoTConnectivityServerManager.RegisterResource(resource);

     Representation repr = new Representation();
     repr.UriPath = "/door/uri/new/notify";
     repr.Type = new ResourceTypes(new List<string>(){ "oic.iot.door.new.notify" });
     repr.Attributes = new Attributes() {
          _attribute, 1 }
     };
     resource.Notify(repr, QualityOfService.High);

Exceptions

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

See Also

Representation

QualityOfService

OnDelete(Request)

This is called when the client performs delete operation on this resource.

Declaration

protected abstract Response OnDelete(Request request)

Parameters

Type	Name	Description
Request	request	A request from client.

Returns

Type	Description
Response	A response.

API Version

3

OnGet(Request)

This is called when the client performs get operation on this resource.

Declaration

protected abstract Response OnGet(Request request)

Parameters

Type	Name	Description
Request	request	A request from client.

Returns

Type	Description
Response	A response having the representation and the result.

API Version

3

OnObserving(Request, ObserveType, Int32)

Called on the observing event.

Declaration

protected abstract bool OnObserving(Request request, ObserveType type, int observeId)

Parameters

Type	Name	Description
Request	request	A request from client.
ObserveType	type	Observer type.
Int32	observeId	Observe identifier.

Returns

Type	Description
Boolean	Returns true if it wants to be observed, else false.

API Version

3

OnPost(Request)

This is called when the client performs post operation on this resource.

Declaration

protected abstract Response OnPost(Request request)

Parameters

Type	Name	Description
Request	request	A request from client.

Returns

Type	Description
Response	A response having the representation and the result.

API Version

3

OnPut(Request)

This is called when the client performs put operation on this resource.

Declaration

protected abstract Response OnPut(Request request)

Parameters

Type	Name	Description
Request	request	A request from client.

Returns

Type	Description
Response	A response.

API Version

3

Implements

System.IDisposable