/* * Copyright 2019 by its authors. See AUTHORS. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #pragma warning disable 1591 using System; using System.Runtime.InteropServices; using System.ComponentModel; using static eldbus.EldbusConnectionNativeFunctions; namespace eldbus { [EditorBrowsable(EditorBrowsableState.Never)] public static class EldbusConnectionNativeFunctions { [DllImport(efl.Libs.Eldbus)] public static extern IntPtr eldbus_connection_get(eldbus.Connection.Type type); [DllImport(efl.Libs.Eldbus)] public static extern IntPtr eldbus_private_connection_get(eldbus.Connection.Type type); [DllImport(efl.Libs.Eldbus)] public static extern IntPtr eldbus_address_connection_get(string address); [DllImport(efl.Libs.Eldbus)] public static extern IntPtr eldbus_private_address_connection_get(string address); [DllImport(efl.Libs.Eldbus)] public static extern IntPtr eldbus_connection_ref(IntPtr conn); [DllImport(efl.Libs.Eldbus)] public static extern void eldbus_connection_unref(IntPtr conn); [DllImport(efl.Libs.Eldbus)] public static extern void eldbus_connection_free_cb_add(IntPtr conn, IntPtr cb, IntPtr data); [DllImport(efl.Libs.Eldbus)] public static extern void eldbus_connection_free_cb_del(IntPtr conn, IntPtr cb, IntPtr data); [DllImport(efl.Libs.Eldbus)] public static extern void eldbus_connection_data_set(IntPtr conn, IntPtr key, IntPtr data); [DllImport(efl.Libs.Eldbus)] public static extern IntPtr eldbus_connection_data_get(IntPtr conn, IntPtr key); [DllImport(efl.Libs.Eldbus)] public static extern IntPtr eldbus_connection_data_del(IntPtr conn, IntPtr key); [DllImport(efl.Libs.Eldbus)] public static extern void eldbus_connection_event_callback_add(IntPtr conn, int type, IntPtr cb, IntPtr cb_data); [DllImport(efl.Libs.Eldbus)] public static extern void eldbus_connection_event_callback_del(IntPtr conn, int type, IntPtr cb, IntPtr cb_data); [DllImport(efl.Libs.Eldbus)] public static extern IntPtr eldbus_connection_send(IntPtr conn, IntPtr msg, IntPtr cb, IntPtr cb_data, double timeout); [DllImport(efl.Libs.Eldbus)] public static extern IntPtr eldbus_connection_unique_name_get(IntPtr conn); // FreeDesktop.Org Methods [DllImport(efl.Libs.Eldbus)] public static extern IntPtr eldbus_name_request(IntPtr conn, string bus, uint flags, IntPtr cb, IntPtr cb_data); [DllImport(efl.Libs.Eldbus)] public static extern IntPtr eldbus_name_release(IntPtr conn, string bus, IntPtr cb, IntPtr cb_data); [DllImport(efl.Libs.Eldbus)] public static extern IntPtr eldbus_name_owner_get(IntPtr conn, string bus, IntPtr cb, IntPtr cb_data); [DllImport(efl.Libs.Eldbus)] public static extern IntPtr eldbus_name_owner_has(IntPtr conn, string bus, IntPtr cb, IntPtr cb_data); [DllImport(efl.Libs.Eldbus)] public static extern IntPtr eldbus_names_list(IntPtr conn, IntPtr cb, IntPtr cb_data); [DllImport(efl.Libs.Eldbus)] public static extern IntPtr eldbus_names_activatable_list(IntPtr conn, IntPtr cb, IntPtr cb_data); [DllImport(efl.Libs.Eldbus)] public static extern IntPtr eldbus_hello(IntPtr conn, IntPtr cb, IntPtr cb_data); [DllImport(efl.Libs.Eldbus)] public static extern IntPtr eldbus_name_start(IntPtr conn, string bus, uint flags, IntPtr cb, IntPtr cb_data); // typedef void (*Eldbus_Name_Owner_Changed_Cb)(void *data, const char *bus, const char *old_id, const char *new_id); // [DllImport(efl.Libs.Eldbus)] public static extern void // eldbus_name_owner_changed_callback_add(IntPtr conn, string bus, Eldbus_Name_Owner_Changed_Cb cb, IntPtr cb_data, [MarshalAs(UnmanagedType.U1)] bool allow_initial_call); // [DllImport(efl.Libs.Eldbus)] public static extern void // eldbus_name_owner_changed_callback_del(IntPtr conn, string bus, Eldbus_Name_Owner_Changed_Cb cb, IntPtr cb_data); } /// Represents a DBus connection. /// Since EFL 1.23. /// public class Connection : IDisposable { /// /// The type of the Connection. /// Since EFL 1.23. /// public enum Type { /// /// Unknown type. /// It's a sentinel. /// Since EFL 1.23. /// Unknown = 0, // sentinel, not a real type /// /// Session type. /// Since EFL 1.23. /// Session, /// /// System type. /// Since EFL 1.23. /// System, /// /// Starter type. /// Since EFL 1.23. /// Starter, /// /// Address type. /// Since EFL 1.23. /// Address, /// /// Last type. /// It's a sentinel. /// Since EFL 1.23. /// Last // sentinel, not a real type }; [EditorBrowsable(EditorBrowsableState.Never)] public IntPtr Handle {get;set;} = IntPtr.Zero; /// Whether this wrapper owns the native handle. /// Since EFL 1.23. /// public bool Own {get;set;} = true; private void InitNew(IntPtr handle, bool own) { Handle = handle; Own = own; CheckHandle(); } private void CheckHandle() { if (Handle == IntPtr.Zero) { eldbus.Common.RaiseNullHandle(); } } [EditorBrowsable(EditorBrowsableState.Never)] public Connection(IntPtr handle, bool own) { InitNew(handle, own); } /// /// Constructor. /// Since EFL 1.23. /// /// The type of the connection. public Connection(eldbus.Connection.Type type) { InitNew(eldbus_connection_get(type), true); } /// /// Constructor. /// Since EFL 1.23. /// /// The address of the connection. public Connection(string address) { InitNew(eldbus_address_connection_get(address), true); } /// /// Gets a Connection with a type. /// Since EFL 1.23. /// /// /// A Connection with the type. public static eldbus.Connection GetPrivate(eldbus.Connection.Type type) { return new eldbus.Connection(eldbus_private_connection_get(type), true); } /// /// Gets a Connection with a address. /// Since EFL 1.23. /// /// The address of the connection. public static eldbus.Connection GetPrivate(string address) { return new eldbus.Connection(eldbus_private_address_connection_get(address), true); } /// /// Finalizer to be called from the Garbage Collector. /// Since EFL 1.23. /// ~Connection() { Dispose(false); } /// Disposes of this wrapper, releasing the native array if owned. /// Since EFL 1.23. /// /// True if this was called from public method. False if /// called from the C# finalizer. protected virtual void Dispose(bool disposing) { IntPtr h = Handle; Handle = IntPtr.Zero; if (h == IntPtr.Zero) { return; } if (Own) { if (disposing) { eldbus_connection_unref(h); } else { Efl.Eo.Globals.ThreadSafeFreeCbExec(eldbus_connection_unref, h); } } } /// Releases the native resources held by this instance. /// Since EFL 1.23. /// public void Dispose() { Dispose(true); GC.SuppressFinalize(this); } /// Releases the native resources held by this instance. /// Since EFL 1.23. /// public void Free() { Dispose(); } /// /// Releases the native handler. /// Since EFL 1.23. /// /// The native handler. public IntPtr Release() { IntPtr h = Handle; Handle = IntPtr.Zero; return h; } /// /// Send a message. /// Since EFL 1.23. /// /// The message that will be sent. /// The function that is executed when a response arrives.. /// The timeout of the message. /// A public eldbus.Pending Send(eldbus.Message msg, eldbus.MessageDelegate dlgt = null, double timeout = -1) { CheckHandle(); if (msg == null) { throw new ArgumentNullException("msg"); } IntPtr cb_wrapper = (dlgt == null ? IntPtr.Zero : eldbus.Common.GetMessageCbWrapperPtr()); IntPtr cb_data = (dlgt == null ? IntPtr.Zero : Marshal.GetFunctionPointerForDelegate(dlgt)); var pending_hdl = eldbus_connection_send(Handle, msg.Handle, cb_wrapper, cb_data, timeout); if (pending_hdl == IntPtr.Zero) { throw new SEHException("Eldbus: could not get `Pending' object from eldbus_connection_send"); } msg.Ref(); return new eldbus.Pending(pending_hdl, false); } /// /// Gets a unique name assigned by the message bus. /// Since EFL 1.23. /// /// The unique name string. public string GetUniqueName() { CheckHandle(); var ptr = eldbus_connection_unique_name_get(Handle); if (ptr == IntPtr.Zero) { return null; } return Eina.StringConversion.NativeUtf8ToManagedString(ptr); } /// /// Send a RequestName method. /// Since EFL 1.23. /// /// The name of the bus. /// Parameter of the RequestName method. /// The function to call when receiving answer. /// A public eldbus.Pending NameRequest(string bus, uint flags, eldbus.MessageDelegate dlgt = null) { CheckHandle(); if (bus == null) { throw new ArgumentNullException("bus"); } IntPtr cb_wrapper = (dlgt == null ? IntPtr.Zero : eldbus.Common.GetMessageCbWrapperPtr()); IntPtr cb_data = (dlgt == null ? IntPtr.Zero : Marshal.GetFunctionPointerForDelegate(dlgt)); var pending_hdl = eldbus_name_request(Handle, bus, flags, cb_wrapper, cb_data); if (pending_hdl == IntPtr.Zero) { throw new SEHException("Eldbus: could not get `Pending' object from eldbus_name_request"); } return new eldbus.Pending(pending_hdl, false); } /// /// Send a ReleaseName method. /// Since EFL 1.23. /// /// The name of the bus. /// The function to call when receiving answer. /// A public eldbus.Pending NameRelease(string bus, eldbus.MessageDelegate dlgt = null) { CheckHandle(); if (bus == null) { throw new ArgumentNullException("bus"); } IntPtr cb_wrapper = (dlgt == null ? IntPtr.Zero : eldbus.Common.GetMessageCbWrapperPtr()); IntPtr cb_data = (dlgt == null ? IntPtr.Zero : Marshal.GetFunctionPointerForDelegate(dlgt)); var pending_hdl = eldbus_name_release(Handle, bus, cb_wrapper, cb_data); if (pending_hdl == IntPtr.Zero) { throw new SEHException("Eldbus: could not get `Pending' object from eldbus_name_release"); } return new eldbus.Pending(pending_hdl, false); } /// /// Send a GetNameOwner method. /// Since EFL 1.23. /// /// The name of the bus. /// The function to call when receiving answer. /// A public eldbus.Pending GetNameOwner(string bus, eldbus.MessageDelegate dlgt = null) { CheckHandle(); if (bus == null) { throw new ArgumentNullException("bus"); } IntPtr cb_wrapper = (dlgt == null ? IntPtr.Zero : eldbus.Common.GetMessageCbWrapperPtr()); IntPtr cb_data = (dlgt == null ? IntPtr.Zero : Marshal.GetFunctionPointerForDelegate(dlgt)); var pending_hdl = eldbus_name_owner_get(Handle, bus, cb_wrapper, cb_data); if (pending_hdl == IntPtr.Zero) { throw new SEHException("Eldbus: could not get `Pending' object from eldbus_name_owner_get"); } return new eldbus.Pending(pending_hdl, false); } /// /// Send NameHasOwner method. /// Since EFL 1.23. /// /// The name of the bus. /// The function to call when receiving the answer. /// A public eldbus.Pending HasNameOwner(string bus, eldbus.MessageDelegate dlgt = null) { CheckHandle(); if (bus == null) { throw new ArgumentNullException("bus"); } IntPtr cb_wrapper = (dlgt == null ? IntPtr.Zero : eldbus.Common.GetMessageCbWrapperPtr()); IntPtr cb_data = (dlgt == null ? IntPtr.Zero : Marshal.GetFunctionPointerForDelegate(dlgt)); var pending_hdl = eldbus_name_owner_has(Handle, bus, cb_wrapper, cb_data); if (pending_hdl == IntPtr.Zero) { throw new SEHException("Eldbus: could not get `Pending' object from eldbus_name_owner_has"); } return new eldbus.Pending(pending_hdl, false); } /// /// Send ListNames method. /// Since EFL 1.23. /// /// The function to call when receiving answer. /// A public eldbus.Pending NameList(eldbus.MessageDelegate dlgt = null) { CheckHandle(); IntPtr cb_wrapper = (dlgt == null ? IntPtr.Zero : eldbus.Common.GetMessageCbWrapperPtr()); IntPtr cb_data = (dlgt == null ? IntPtr.Zero : Marshal.GetFunctionPointerForDelegate(dlgt)); var pending_hdl = eldbus_names_list(Handle, cb_wrapper, cb_data); if (pending_hdl == IntPtr.Zero) { throw new SEHException("Eldbus: could not get `Pending' object from eldbus_names_list"); } return new eldbus.Pending(pending_hdl, false); } /// /// Send ListActivatableNames method. /// Since EFL 1.23. /// /// The function to call when receiving a method. /// A public eldbus.Pending ActivatableList(eldbus.MessageDelegate dlgt = null) { CheckHandle(); IntPtr cb_wrapper = (dlgt == null ? IntPtr.Zero : eldbus.Common.GetMessageCbWrapperPtr()); IntPtr cb_data = (dlgt == null ? IntPtr.Zero : Marshal.GetFunctionPointerForDelegate(dlgt)); var pending_hdl = eldbus_names_activatable_list(Handle, cb_wrapper, cb_data); if (pending_hdl == IntPtr.Zero) { throw new SEHException("Eldbus: could not get `Pending' object from eldbus_names_activatable_list"); } return new eldbus.Pending(pending_hdl, false); } /// /// Send Hello method. /// Since EFL 1.23. /// /// The function to call when receiving answer. /// A public eldbus.Pending Hello(eldbus.MessageDelegate dlgt = null) { CheckHandle(); IntPtr cb_wrapper = (dlgt == null ? IntPtr.Zero : eldbus.Common.GetMessageCbWrapperPtr()); IntPtr cb_data = (dlgt == null ? IntPtr.Zero : Marshal.GetFunctionPointerForDelegate(dlgt)); var pending_hdl = eldbus_hello(Handle, cb_wrapper, cb_data); if (pending_hdl == IntPtr.Zero) { throw new SEHException("Eldbus: could not get `Pending' object from eldbus_hello"); } return new eldbus.Pending(pending_hdl, false); } /// /// Send StartServiceByName method. /// Since EFL 1.23. /// /// The name of the bus. /// Parameter of the StartServiceByName. /// The function to call when receiving answer. /// A public eldbus.Pending NameStart(string bus, uint flags, eldbus.MessageDelegate dlgt = null) { CheckHandle(); if (bus == null) { throw new ArgumentNullException("bus"); } IntPtr cb_wrapper = (dlgt == null ? IntPtr.Zero : eldbus.Common.GetMessageCbWrapperPtr()); IntPtr cb_data = (dlgt == null ? IntPtr.Zero : Marshal.GetFunctionPointerForDelegate(dlgt)); var pending_hdl = eldbus_name_start(Handle, bus, flags, cb_wrapper, cb_data); if (pending_hdl == IntPtr.Zero) { throw new SEHException("Eldbus: could not get `Pending' object from eldbus_name_start"); } return new eldbus.Pending(pending_hdl, false); } } }