{"id":3634,"date":"2018-09-03T11:05:19","date_gmt":"2018-09-03T11:05:19","guid":{"rendered":"http:\/\/www.colorwave.it\/blog\/?p=3634"},"modified":"2018-09-03T16:12:48","modified_gmt":"2018-09-03T16:12:48","slug":"comunicazione-fra-oggetti-con-interfaccia-operation_call","status":"publish","type":"post","link":"https:\/\/www.colorwave.it\/blog\/framework\/comunicazione-fra-oggetti-con-interfaccia-operation_call\/admin\/2018\/09\/","title":{"rendered":"Comunicazione fra oggetti con interfaccia OPERATION_CALL"},"content":{"rendered":"

In un vecchio post avevamo descritto\u00a0 l’interfaccia\u00a0OPERATION_CALL<\/a>;\u00a0 in questo articolo descriviamo un insieme di macro usate per semplificare la comunicazione fra oggetti dotati di questa interfaccia;<\/p>\n

Le nuove funzionalit\u00e0, introdotte dalla versione 7 di Colibri, permettono di trasferire messaggi e dati fra oggetti usando la nuova classe test_request<\/em><\/span>\u00a0(che in questa esposizione non \u00e8 necessario discutere).<\/span><\/p>\n

Per procedere nell’esposizione ricordiamo che nel framework Colibri sono definibili due tipi di oggetti\/widget: oggetti a visibilit\u00e0 globale e oggetti accessibili attraverso il pointer.<\/span><\/p>\n

Oggetti visibili globalmente<\/h3>\n

Una istanza di una classe di interfaccia OPERATION_CALL\u00a0 (in genere WIDGET, ma non necessariamente)\u00a0 pu\u00f2 essere accessibile globalmente nell’applicazione attraverso una registrazione, in genere definita nel costruttore; In questo caso l’istanza dovr\u00e0 essere unica, cio\u00e8 registrata una sola volta, definendo un identificatore; ad esempio la classe\u00a0DOCK_edit_layout<\/span>, che deve essere visibile alle classi\u00a0LAYOUT_printing_page<\/span>, viene costruita in fase di inizializzazione del programma in un’unica istanza, assegnandogli\u00a0 l’identificatore\u00a0 _$dock_edit_layout (definita in\u00a0CLB_language.h<\/span><\/em>); il codice che segue ne mostra le modalit\u00e0 di registrazione:<\/p>\n

DOCK_edit_layout::DOCK_edit_layout(void)\r\n{\r\n\t$_init\r\n\t\t__register_global_object(_$dock_edit_layout)\r\n\r\n\t\t__on_signal_create(__on_create_window)\r\n\t\t__on_signal_end_create(__on_end__create_window)\r\n\t\t__on_signal_paint(__on_paint_wnd)\r\n\t\t__on_signal_resize(__on_resize_window)\r\n\r\n}\r\n<\/pre>\n
La macro\u00a0__register_global_object<\/span> garantisce la visibilit\u00e0 globale dell’istanza, rendendola accessibile mediante l’identificatore dock_edit_layout; si ribadisce che la classe deve avere un’unica istanza allocata;<\/p>\n
Accesso ad istanze registrate globalmente:\u00a0<\/strong>Un oggetto registrato globalmente pu\u00f2 essere individuato mediante la macro\u00a0__get_global_object<\/span> definita in CLB_language.h:<\/em><\/p>\n
#define __get_global_object(_obj_id,opcl_obj)  \t\tOPERATION_CALL *opcl_obj = OPERATION_CALL::Get_global_object(obj_id);\r\n<\/pre>\n
Gli oggetti visibili globalmente sono in genere utilizzati per ricevere e trasmettere messaggi ed altre informazioni associate;<\/p>\n
Oggetti visibili localmente<\/h3>\n
Sono tutti gli oggetti di interfaccia OPERATION_CALL che il programmatore pu\u00f2 accedere attraverso il pointer dell’istanza, ad esempio un WIDGET definito localmente o ricevuto come puntatore da una funzione.<\/p>\n
Nel contesto d’uso, la comunicazione verso l’interfaccia OPERATION_CALL di un oggetto \u00e8 definita nel modo seguente:<\/p>\n
func_name<\/strong> : \u00e8 una stringa che identifica un gruppo funzionale (raggruppamento riconosciuto, come vedremo, attraverso la macro __is_function<\/span> dal ricevente).<\/p>\n
op_id<\/strong>: \u00e8 una stringa che, se richiesta, definisce un raggruppamento secondario (vedremo fra poco praticamente cosa significa..)<\/p>\n
args<\/strong>: \u00e8 un numero qualunque di argomenti associati alla coppia (func_name, op_id) separati da una virgola;<\/p>\n
quindi un messaggio mandato ad un OPERATION_CALL \u00e8 nella\u00a0 forma:<\/p>\n
(func_name,\u00a0<\/strong>[op_id], [args])<\/strong><\/p>\n
Ad esempio:<\/p>\n
(_$replace,_$recipe,rcp_ptr)<\/em><\/p>\n
pu\u00f2 essere una richiesta ad un oggetto\u00a0 per la sostituzione di una ricetta con rcp_ptr.<\/p>\n
Un altro esempio<\/p>\n
($destroy,$object, 4, obj_list)<\/em><\/p>\n
\u00e8 un modo per richiedere ad un oggetto la distruzione di 4 oggetti contenuti nella lista obj_list;
\n
\nPer mandare un messaggio e un insieme di parametri ad un oggetto globale \u00e8 necessaria la conoscenza del suo identificatore globale; la richiesta \u00e8 effettuata mediante la macro variadic __exec_global_fn<\/span><\/em> della quale si riporta la definizione:<\/p>\n
#define __exec_global_fn(...)  test_request::exec_global_fn( __VA_ARGS__,_$end) \r\n<\/pre>\n