Tizen Native API  3.0
Object Mapper

Functions

Eldbus_Objecteldbus_object_get (Eldbus_Connection *conn, const char *bus, const char *path)
 Get an object of the given bus and path.
Eldbus_Objecteldbus_object_ref (Eldbus_Object *obj)
 Increase object reference.
void eldbus_object_unref (Eldbus_Object *obj)
 Decrease object reference. If reference == 0 object will be freed and all its children.
void eldbus_object_free_cb_add (Eldbus_Object *obj, Eldbus_Free_Cb cb, const void *data)
 Add a callback function to be called when object will be freed.
void eldbus_object_free_cb_del (Eldbus_Object *obj, Eldbus_Free_Cb cb, const void *data)
 Remove callback registered in eldbus_object_free_cb_add().
void eldbus_object_event_callback_add (Eldbus_Object *obj, Eldbus_Object_Event_Type type, Eldbus_Object_Event_Cb cb, const void *cb_data)
 Add a callback function to be called when an event of the specified type occurs.
void eldbus_object_event_callback_del (Eldbus_Object *obj, Eldbus_Object_Event_Type type, Eldbus_Object_Event_Cb cb, const void *cb_data)
 Remove callback registered in eldbus_object_event_callback_add().
Eldbus_Connectioneldbus_object_connection_get (const Eldbus_Object *obj)
const char * eldbus_object_bus_name_get (const Eldbus_Object *obj)
const char * eldbus_object_path_get (const Eldbus_Object *obj)
Eldbus_Pendingeldbus_object_send (Eldbus_Object *obj, Eldbus_Message *msg, Eldbus_Message_Cb cb, const void *cb_data, double timeout)
 Send a message.
Eldbus_Signal_Handlereldbus_object_signal_handler_add (Eldbus_Object *obj, const char *interface, const char *member, Eldbus_Signal_Cb cb, const void *cb_data)
 Add a signal handler.
Eldbus_Messageeldbus_object_method_call_new (Eldbus_Object *obj, const char *interface, const char *member)
 Call a dbus method on the Eldbus_Object.

Typedefs

typedef struct
_Eldbus_Object_Event_Interface_Added 
Eldbus_Object_Event_Interface_Added
typedef struct
_Eldbus_Object_Event_Interface_Removed 
Eldbus_Object_Event_Interface_Removed
typedef struct
_Eldbus_Object_Event_Property_Changed 
Eldbus_Object_Event_Property_Changed
typedef struct
_Eldbus_Object_Event_Property_Removed 
Eldbus_Object_Event_Property_Removed
typedef void(* Eldbus_Object_Event_Cb )(void *data, Eldbus_Object *obj, void *event_info)

Typedef Documentation

Callback that will be called when an Eldbus_Object event happens.

Parameters:
dataContext data.
objThe Eldbus_Object.
event_infoInformation about the event that triggered the callback.

Structure used with the ELDBUS_OBJECT_EVENT_IFACE_ADDED event.

Structure used with the ELDBUS_OBJECT_EVENT_IFACE_REMOVED event.

Structure used with the ELDBUS_OBJECT_EVENT_PROPERTY_CHANGED event.

Structure used with the ELDBUS_OBJECT_EVENT_PROPERTY_REMOVED event.


Enumeration Type Documentation

An enumeration containing several Eldbus_Object event types.

Enumerator:
ELDBUS_OBJECT_EVENT_IFACE_ADDED 

a parent path must have a ObjectManager interface

ELDBUS_OBJECT_EVENT_IFACE_REMOVED 

a parent path must have a ObjectManager interface

ELDBUS_OBJECT_EVENT_PROPERTY_CHANGED 

a property has changes

ELDBUS_OBJECT_EVENT_PROPERTY_REMOVED 

a property was removed

ELDBUS_OBJECT_EVENT_LAST 

sentinel, not a real event type


Function Documentation

const char* eldbus_object_bus_name_get ( const Eldbus_Object obj)

Get the name associated with a Eldbus_Object.

Parameters:
objThe Eldbus_Object.
Returns:
A string corresponding to the Eldbus_Object name.
Since :
3.0

Get the Eldbus_Connection object associated with a Eldbus_Object.

Parameters:
objThe Eldbus_Object.
Returns:
The corresponding Eldbus_Connection object.
Since :
3.0
void eldbus_object_event_callback_add ( Eldbus_Object obj,
Eldbus_Object_Event_Type  type,
Eldbus_Object_Event_Cb  cb,
const void *  cb_data 
)

Add a callback function to be called when an event of the specified type occurs.

Parameters:
objThe Eldbus_Object on which to register a callback.
typeThe type of the event.
cbThe callback to call.
cb_dataThe data to pass to the callback.
Since :
3.0
void eldbus_object_event_callback_del ( Eldbus_Object obj,
Eldbus_Object_Event_Type  type,
Eldbus_Object_Event_Cb  cb,
const void *  cb_data 
)

Remove callback registered in eldbus_object_event_callback_add().

Parameters:
objThe Eldbus_Object.
typeThe type of the event.
cbThe callback to call.
cb_dataThe data to pass to the callback.
Since :
3.0
void eldbus_object_free_cb_add ( Eldbus_Object obj,
Eldbus_Free_Cb  cb,
const void *  data 
)

Add a callback function to be called when object will be freed.

Parameters:
objobject that you want to monitor
cbcallback that will be executed
datapassed to callback
Since :
3.0
void eldbus_object_free_cb_del ( Eldbus_Object obj,
Eldbus_Free_Cb  cb,
const void *  data 
)

Remove callback registered in eldbus_object_free_cb_add().

Parameters:
objObject monitored.
cbCallback that was registered.
dataData that was passed to callback.
Since :
3.0
Eldbus_Object* eldbus_object_get ( Eldbus_Connection conn,
const char *  bus,
const char *  path 
)

Get an object of the given bus and path.

Parameters:
connconnection where object belongs
busname of bus or unique-id of who listens for calls of this object
pathobject path of this object
Returns:
The corresponding Eldbus_Object.
Since :
3.0
Examples:
banshee.c, client.c, complex-types-client-eina-value.c, complex-types.c, connman-list-services.c, and ofono-dial.c.
Eldbus_Message* eldbus_object_method_call_new ( Eldbus_Object obj,
const char *  interface,
const char *  member 
)

Call a dbus method on the Eldbus_Object.

Parameters:
objThe Eldbus_Object on which to call the method.
interfaceInterface name.
memberName of the method to be called.
Returns:
a new Eldbus_Message, free with eldbus_message_unref()
Since :
3.0
const char* eldbus_object_path_get ( const Eldbus_Object obj)

Get the path associated with a Eldbus_Object.

Parameters:
objThe Eldbus_Object.
Returns:
A string corresponding to the Eldbus_Object path.
Since :
3.0

Increase object reference.

Parameters:
objAn Eldbus_Object.
Returns:
The same Eldbus_Object with an increased refcount.
Since :
3.0
Eldbus_Pending* eldbus_object_send ( Eldbus_Object obj,
Eldbus_Message msg,
Eldbus_Message_Cb  cb,
const void *  cb_data,
double  timeout 
)

Send a message.

Parameters:
objthe msg will be sent in connection to this object
msgmessage that will be sent
cbif msg is a method call a callback should be passed to be executed when a response arrives
cb_datadata passed to callback
timeouttimeout in milliseconds, -1 to default internal value or ELDBUS_TIMEOUT_INFINITE for no timeout
Returns:
A Eldbus_Pending object.
Since :
3.0
Eldbus_Signal_Handler* eldbus_object_signal_handler_add ( Eldbus_Object obj,
const char *  interface,
const char *  member,
Eldbus_Signal_Cb  cb,
const void *  cb_data 
)

Add a signal handler.

Parameters:
objwhere the signal is emitted
interfaceof the signal
membername of the signal
cbcallback that will be called when this signal is received
cb_datadata that will be passed to callback
Returns:
A listener to the desired signal.
Since :
3.0

Decrease object reference. If reference == 0 object will be freed and all its children.

Parameters:
objAn Eldbus_Object.
Since :
3.0
Examples:
connman-list-services.c, and ofono-dial.c.