Qtの基礎 - D-Bus - 版の履歴

Wiki: /* QDBusConnectionクラス */

2025-01-12T19:43:52Z

QDBusConnectionクラス

← 古い版		2025年1月13日 (月) 04:43時点における版
147行目:		147行目:
	<br>		<br>
	* QByteArray localMachineId()		* QByteArray localMachineId()
	*: D-~~Busシステムが知っているローカルIDを返します。~~		*: D-Busシステムが知っているローカルIDを返す。
	<br>		<br>
	* QDBusConnection sender()		* QDBusConnection sender()

Wiki: 文字列「FORCETOC」を「{{#seo: |title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki |keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,Podman,電気回路,電子回路,基板,プリント基板 |description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This pag…

2024-10-14T01:58:16Z

文字列「__FORCETOC__」を「{{#seo: |title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki |keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,Podman,電気回路,電子回路,基板,プリント基板 |description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This pag…

← 古い版		2024年10月14日 (月) 10:58時点における版
753行目:		753行目:
	</syntaxhighlight>		</syntaxhighlight>
	<br><br>		<br><br>

			{{#seo:
			\|title={{PAGENAME}} : Exploring Electronics and SUSE Linux \| MochiuWiki
			\|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,Podman,電気回路,電子回路,基板,プリント基板
			\|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 \| This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
			\|image=/resources/assets/MochiuLogo_Single_Blue.png
			}}

	__FORCETOC__		__FORCETOC__
	[[カテゴリ:Qt]]		[[カテゴリ:Qt]]

Wiki: /* 使用例 */

2024-09-01T20:20:27Z

使用例

@@ 264行目: / 264行目: @@
 * <code>-p <アダプターソースコードのファイル名></code> または <code>-P <アダプターソースコードのファイル名></code>
 *: アダプターソースコードのファイルへのプロキシコードを生成する。
 <br><br>

Wiki: /* 構造体の送信 */

2024-09-01T19:34:17Z

構造体の送信

← 古い版		2024年9月2日 (月) 04:34時点における版
527行目:		527行目:
	*: この登録により、D-Busシステムは実行時にカスタム型の情報を持つことができ、適切なデータ変換を行うことができる。		*: この登録により、D-Busシステムは実行時にカスタム型の情報を持つことができ、適切なデータ変換を行うことができる。
	<br>		<br>
	~~したがって、qDBusRegisterMetaType~~<カスタム型>~~()を呼び出すことにより、カスタム型をD~~-Busシステムで使用可能にして、データを送受信できるようにしている。		したがって、<code>qDBusRegisterMetaType<カスタム型></code>関数を呼び出すことにより、カスタム型をD-Busシステムで使用可能にして、データを送受信できるようにしている。<br>
	<br>		<br>

	==== 構造体の受信 ====		==== 構造体の受信 ====
	<syntaxhighlight lang="c++">		<syntaxhighlight lang="c++">

Wiki: /* 構造体の送信 */

2024-09-01T19:32:35Z

構造体の送信

差分を表示

Wiki: /* 構造体の送信 */

2024-09-01T19:11:09Z

構造体の送信

@@ 500行目: / 500行目: @@
+  }
   </syntaxhighlight>
 <br><br>

Wiki: /* Firewalld */

2024-09-01T19:02:05Z

Firewalld

@@ 336行目: / 336行目: @@
 https://github.com/PacktPublishing/Hands-On-Embedded-Programming-with-Qt/blob/master/Chapter10/DBusBruteForce/MyObject.cpp<br>
 <br>
-==== Firewalld ====
+==== Firewalldの利用 ====
 以下の例では、Firewalldにおいて、以下に示すようなコマンドと同等のものをD-Busを使用して実行している。<br>
   sudo firewall-cmd --permanent --zone=<ゾーン名> --add-port=<ポート番号>/tcp
@@ 409行目: / 409行目: @@
      return 0;
+  }
   </syntaxhighlight>

2024年9月1日 (日) 18:47にWikiによる

2024-09-01T18:47:03Z

← 古い版		2024年9月2日 (月) 03:47時点における版
264行目:		264行目:
	* <code>-p <アダプターソースコードのファイル名></code> または <code>-P <アダプターソースコードのファイル名></code>		* <code>-p <アダプターソースコードのファイル名></code> または <code>-P <アダプターソースコードのファイル名></code>
	*: アダプターソースコードのファイルへのプロキシコードを生成する。		*: アダプターソースコードのファイルへのプロキシコードを生成する。
	<br>		<br><br>

	==== ~~サンプルコード 1~~ ====		== 使用例 ==
			==== pingの送受信 ====
	以下の例では、Qtにおいて、D-Busを使用したメッセージの送受信を行っている。<br>		以下の例では、Qtにおいて、D-Busを使用したメッセージの送受信を行っている。<br>
	# セッションバスへの接続を取得する。		# セッションバスへの接続を取得する。
335行目:		336行目:
	https://github.com/PacktPublishing/Hands-On-Embedded-Programming-with-Qt/blob/master/Chapter10/DBusBruteForce/MyObject.cpp<br>		https://github.com/PacktPublishing/Hands-On-Embedded-Programming-with-Qt/blob/master/Chapter10/DBusBruteForce/MyObject.cpp<br>
	<br>		<br>
	==== ~~サンプルコード 2~~ ====		==== Firewalld ====
	以下の例では、Firewalldにおいて、以下に示すようなコマンドと同等のものをD-Busを使用して実行している。<br>		以下の例では、Firewalldにおいて、以下に示すようなコマンドと同等のものをD-Busを使用して実行している。<br>
	sudo firewall-cmd --permanent --zone=<ゾーン名> --add-port=<ポート番号>/tcp		sudo firewall-cmd --permanent --zone=<ゾーン名> --add-port=<ポート番号>/tcp

Wiki: /* サンプルコード 2 */

2024-07-28T12:54:33Z

サンプルコード 2

← 古い版		2024年7月28日 (日) 21:54時点における版
347行目:		347行目:

	// 開放するポートを指定する。		// 開放するポートを指定する。
	bool addPort(const QString& zone, ~~int~~ port, const QString &protocol)		bool addPort(QDBusInterface &interface, const QString &zone, QString &port, const QString &protocol)
	{		{
	QDBusReply<void> reply = interface.call("addPort", zone, port, protocol);		QDBusReply<void> reply = interface.call("addPort", zone, port, protocol, 0);
	return reply.isValid();		return reply.isValid();
	}		}

	// 変更を永続化する		// 変更を永続化する
	bool makePermament()		bool makePermament(QDBusInterface &interface)
	{		{
	QDBusReply<void> reply = interface.call("runtimeToPermanent");		QDBusReply<void> reply = interface.call("runtimeToPermanent");
361行目:		361行目:

	// Firewalldを再読み込みする		// Firewalldを再読み込みする
	bool reloadFirewall()		bool reloadFirewall(QDBusInterface &interface)
	{		{
	QDBusReply<void> reply = interface.call("reload");		QDBusReply<void> reply = interface.call("reload");
371行目:		371行目:
	// ...略		// ...略

	// ~~FirewalldのD~~-Busインターフェースに接続する		// Firewalldの (ポート開放向け) D-Busインターフェースに接続する
	QDBusConnection bus = QDBusConnection::systemBus();		QDBusConnection bus = QDBusConnection::systemBus();
	QDBusInterface interface("org.fedoraproject.FirewallD1",		QDBusInterface interface("org.fedoraproject.FirewallD1",
	"/org/fedoraproject/FirewallD1",		"/org/fedoraproject/FirewallD1",
	"org.fedoraproject.FirewallD1",		"org.fedoraproject.FirewallD1.zone",
	bus);		bus);

381行目:		381行目:
	QStringList zones = {"public", "internal", "work"};		QStringList zones = {"public", "internal", "work"};
	for (const auto& zone : zones) {		for (const auto& zone : zones) {
	if (addPort(zone, 80, "tcp")) {		if (addPort(interface, zone, "80", "tcp")) {
	qDebug() << "Port 80 added to" << zone << "zone successfully";		qDebug() << "Port 80 added to" << zone << "zone successfully";
	}		}
	else {		else {
	qDebug() << "Failed to add port 80 to" << zone << "zone";		qDebug() << "Failed to add port 80 to" << zone << "zone";
			return -1;
	}		}
	}		}

	if (makePermament()) {		// 変更を恒久的に設定する
			QDBusInterface ifReload("org.fedoraproject.FirewallD1",
			"/org/fedoraproject/FirewallD1",
			"org.fedoraproject.FirewallD1",
			bus);
			if (makePermament(ifReload)) {
	qDebug() << "Changes made permanent";		qDebug() << "Changes made permanent";
			return -1;
	}		}

	if (reloadFirewall()) {		if (reloadFirewall(ifReload)) {
	qDebug() << "Firewall reloaded";		qDebug() << "Firewall reloaded";
			return -1;
	}		}

Wiki: /* サンプルコード */

2024-07-28T12:37:26Z

サンプルコード

@@ 266行目: / 266行目: @@
 <br>
-==== サンプルコード ====
+==== サンプルコード 1 ====
 以下の例では、Qtにおいて、D-Busを使用したメッセージの送受信を行っている。<br>
 # セッションバスへの接続を取得する。
@@ 334行目: / 334行目: @@
 サンプルコードの詳細を知りたい場合は、以下に示すGithubを参照すること。<br>
 https://github.com/PacktPublishing/Hands-On-Embedded-Programming-with-Qt/blob/master/Chapter10/DBusBruteForce/MyObject.cpp<br>
 <br><br>

Wiki: /* Qtプロジェクト */

2024-07-28T12:23:50Z

Qtプロジェクト

← 古い版		2024年7月28日 (日) 21:23時点における版
341行目:		341行目:
	# mocファイルはインクルードしない場合		# mocファイルはインクルードしない場合
	qdbusxml2cpp -a <生成するcppファイル名とヘッダファイル名> -c <自動生成するヘルパークラス名 (親クラス)> -i <対象となるクラスを記述しているヘッダファイル> -l <対象となるクラス名> <D-Busインターフェースファイルのパス>		qdbusxml2cpp -a <生成するcppファイル名とヘッダファイル名> -c <自動生成するヘルパークラス名 (親クラス)> -i <対象となるクラスを記述しているヘッダファイル> -l <対象となるクラス名> <D-Busインターフェースファイルのパス>
	例. qdbusxml2cpp -a SamplesAdaptor -c SamplesAdaptor -i SampleHelper.h -l SampleHelper org.qt.~~policykit~~.examples.xml		例. qdbusxml2cpp -a SamplesAdaptor -c SamplesAdaptor -i SampleHelper.h -l SampleHelper org.dbus.interface.examples.xml

	# mocファイルもインクルードする場合		# mocファイルもインクルードする場合
	qdbusxml2cpp -m -a <生成するcppファイル名とヘッダファイル名> -c <自動生成するヘルパークラス名 (親クラス)> -i <対象となるクラスを記述しているヘッダファイル> -l <対象となるクラス名> <D-Busインターフェースファイルのパス>		qdbusxml2cpp -m -a <生成するcppファイル名とヘッダファイル名> -c <自動生成するヘルパークラス名 (親クラス)> -i <対象となるクラスを記述しているヘッダファイル> -l <対象となるクラス名> <D-Busインターフェースファイルのパス>
	例. qdbusxml2cpp -m -a SamplesAdaptor -c SamplesAdaptor -i SampleHelper.h -l SampleHelper org.qt.~~policykit~~.examples.xml		例. qdbusxml2cpp -m -a SamplesAdaptor -c SamplesAdaptor -i SampleHelper.h -l SampleHelper org.dbus.interface.examples.xml
	<br>		<br>
	生成されたファイルをQtプロジェクトに指定およびインクルードする。<br>		生成されたファイルをQtプロジェクトに指定およびインクルードする。<br>

Wiki: /* CMakeプロジェクト */

2024-06-26T19:39:25Z

CMakeプロジェクト

← 古い版		2024年6月27日 (木) 04:39時点における版
354行目:		354行目:

	== CMakeプロジェクト ==		== CMakeプロジェクト ==
	CMakeプロジェクトにおいて、<code>qt_add_dbus_adaptor</code>~~オプションを指定することにより、D~~-~~Busインターフェースのアダプタクラスを生成する。~~<br>		CMakeプロジェクトにおいて、<code>qt_add_dbus_adaptor</code>コマンドを指定することにより、D-Busインターフェースのアダプタクラスを生成することができる。<br>
	<code>qt_add_dbus_adaptor</code>コマンドは、Qt D-Bus XMLコンパイラ(qdbusxml2cpp)のアダプタモードでの呼び出しを設定する。<br>		<code>qt_add_dbus_adaptor</code>コマンドは、Qt D-Bus XMLコンパイラ (qdbusxml2cpp) のアダプタモードでの呼び出しを設定する。<br>
	<br>		<br>
	第2引数で指定したD-Busインタフェースファイル(XML形式)に対するアダプタを実装したC++のソースコードファイルとヘッダファイルを生成する。<br>		第2引数で指定したD-Busインタフェースファイル(XML形式)に対するアダプタを実装したC++のソースコードファイルとヘッダファイルを生成する。<br>
368行目:		368行目:
	<br>		<br>
	第4引数から第6引数までを省略する場合、親クラス名、ヘッダファイル名、クラス名は、第3引数の指定値から自動的に生成される。<br>		第4引数から第6引数までを省略する場合、親クラス名、ヘッダファイル名、クラス名は、第3引数の指定値から自動的に生成される。<br>
	<syntaxhighlight lang="cmake">		<syntaxhighlight lang="cmake">
	qt_add_dbus_adaptor(		qt_add_dbus_adaptor(
	<任意の変数名> # 生成されるソースファイル名を指定例: SampleAdaptor.cpp SampleAdaptor.h		<任意の変数名> # 生成されるソースファイル名を指定例: SampleAdaptor.cpp SampleAdaptor.h

Wiki: /* サンプルコード */

2024-05-29T14:16:16Z

サンプルコード

← 古い版		2024年5月29日 (水) 23:16時点における版
333行目:		333行目:
	<br>		<br>
	サンプルコードの詳細を知りたい場合は、以下に示すGithubを参照すること。<br>		サンプルコードの詳細を知りたい場合は、以下に示すGithubを参照すること。<br>
	https://github.com/PacktPublishing/Hands-On-Embedded-Programming- with-Qt/blob/master/Chapter10/DBusBruteForce/MyObject.cpp<br>		https://github.com/PacktPublishing/Hands-On-Embedded-Programming-with-Qt/blob/master/Chapter10/DBusBruteForce/MyObject.cpp<br>
	<br><br>		<br><br>

Wiki: /* qdbuscpp2xmlコマンド */

2024-05-29T13:55:24Z

qdbuscpp2xmlコマンド

@@ 193行目: / 193行目: @@
 *: D-Busインターフェースファイルを生成する。
 <br>
 ==== qdbusxml2cppコマンド ====
 <code>qdbusxml2cpp</code>コマンドは、D-Busインターフェースファイルの定義に従い、C++のアダプターコードを生成する。<br>

Wiki: /* CMakeプロジェクト */

2024-04-05T01:02:08Z

CMakeプロジェクト

← 古い版		2024年4月5日 (金) 10:02時点における版
329行目:		329行目:
	<syntaxhighlight lang="cmake">		<syntaxhighlight lang="cmake">
	qt_add_dbus_adaptor(		qt_add_dbus_adaptor(
	<任意の変数名>		<任意の変数名> # 生成されるソースファイル名を指定例: SampleAdaptor.cpp SampleAdaptor.h
	<D-Busインタフェースファイル(XML形式)>		<D-Busインタフェースファイル> # XML形式
	<親クラスのヘッダファイル名>		<親クラスのヘッダファイル名>
	[第3引数のクラス名 (省略可能)]		<第3引数のクラス名> # 省略可能
	[生成するヘッダファイル名(拡張子.hは不要~~) (省略可能)]~~		<生成するヘッダファイル名> # 省略可能
	[生成するアダプタのクラス名 (省略可能)]		# 拡張子.hは不要
			<生成するアダプタのクラス名> # 省略可能
	)		)
	</syntaxhighlight>		</syntaxhighlight>

2024年4月5日 (金) 00:52にWikiによる

2024-04-05T00:52:51Z

差分を表示

Wiki: /* qdbusxml2cppコマンド */

2024-04-05T00:46:56Z

qdbusxml2cppコマンド

← 古い版		2024年4月5日 (金) 09:46時点における版
484行目:		484行目:
	<br>		<br>
	<code>qdbusxml2cpp</code>コマンドのオプションを、以下に示す。<br>		<code>qdbusxml2cpp</code>コマンドのオプションを、以下に示す。<br>
	* -a <アダプターソースコードおよびヘッダのファイル名> または -A <アダプターソースコードおよびヘッダのファイル名>		* <code>-a <アダプターソースコードおよびヘッダのファイル名></code> または <code>-A <アダプターソースコードおよびヘッダのファイル名></code>
	*: 指定された名前でアダプターソースコードおよびヘッダを生成する。		*: 指定された名前でアダプターソースコードおよびヘッダを生成する。
	* -c <アダプターソースコードで使用するクラス名> または -C <アダプターソースコードで使用するクラス名>		* <code>-c <アダプターソースコードで使用するクラス名></code> または <code>-C <アダプターソースコードで使用するクラス名></code>
	*: アダプターソースコードで使用するクラス名を指定する。		*: アダプターソースコードで使用するクラス名を指定する。
	* -i <対象となるクラスを記述しているヘッダファイル名> または -I <対象となるクラスを記述しているヘッダファイル名>		* <code>-i <対象となるクラスを記述しているヘッダファイル名></code> または <code>-I <対象となるクラスを記述しているヘッダファイル名></code>
	*: アダプターソースコードに、<code>#include <対象となるクラスを記述しているヘッダファイル></code>を追加する。		*: アダプターソースコードに、<code>#include <対象となるクラスを記述しているヘッダファイル></code>を追加する。
	* -l <対象となるクラス名> または -L <対象となるクラス名>		* <code>-l <対象となるクラス名></code> または <code>-L <対象となるクラス名></code>
	*: アダプタソースコードを生成する時に使用するクラス名(親クラス)を指定する。		*: アダプタソースコードを生成する時に使用するクラス名(親クラス)を指定する。
	* -m		* <code>-m</code>
	*: アダプターソースコードに、<code>#include "<アダプターソースコード名.moc>"</code>ステートメントを追加する。		*: アダプターソースコードに、<code>#include "<アダプターソースコード名.moc>"</code>ステートメントを追加する。
	* -N		* <code>-N</code>
	*: 名前空間を使用しない。		*: 名前空間を使用しない。
	* -p <アダプターソースコードのファイル名> または -P <アダプターソースコードのファイル名>		* <code>-p <アダプターソースコードのファイル名></code> または <code>-P <アダプターソースコードのファイル名></code>
	*: アダプターソースコードのファイルへのプロキシコードを生成する。		*: アダプターソースコードのファイルへのプロキシコードを生成する。
	<br>		<br>

Wiki: /* D-Busプロパティ */

2024-04-04T07:28:31Z

D-Busプロパティ

← 古い版		2024年4月4日 (木) 16:28時点における版
110行目:		110行目:
	/org/bluez/hci0 \ # D-Busオブジェクト名		/org/bluez/hci0 \ # D-Busオブジェクト名
	--type=method_call \ # メッセージタイプ		--type=method_call \ # メッセージタイプ
			# メソッドの場合は<code>method_call</code>、シグナルの場合は<code>signal</code>を指定する
			# 省略した場合は、<code>signal</code>を指定したことになる
	org.freedesktop.DBus.Properties.GetAll \ # D-Busインターフェース名(org.freedesktop.DBus.Properties)とメソッド名(GetAll)		org.freedesktop.DBus.Properties.GetAll \ # D-Busインターフェース名(org.freedesktop.DBus.Properties)とメソッド名(GetAll)
	string:org.bluez.Adapter1 # メソッドの引数		string:org.bluez.Adapter1 # メソッドの引数
235行目:		237行目:
	== D-Busコマンド ==		== D-Busコマンド ==
	以下の例では、Linuxでのシャットダウン、再起動、ログアウト等のD-Busサービスの一覧を取得している。<br>		以下の例では、Linuxでのシャットダウン、再起動、ログアウト等のD-Busサービスの一覧を取得している。<br>
	dbus-send ~~--system~~ --print-reply=literal \		dbus-send --print-reply=literal \
	--dest=org.freedesktop.login1 \		--system \
	/org/freedesktop/login1 \		--dest=org.freedesktop.login1 \
	--type=method_call \		/org/freedesktop/login1 \
	org.freedesktop.DBus.Introspectable.Introspect		--type=method_call \
			org.freedesktop.DBus.Introspectable.Introspect
	<br>		<br>
	以下の例では、D-Busサービスを使用してシャットダウンおよび再起動を実行している。<br>		以下の例では、D-Busサービスを使用してシャットダウンおよび再起動を実行している。<br>
	# シャットダウン		# シャットダウン
	dbus-send --print-reply=literal \		dbus-send --print-reply=literal \
	--system \ # バスタイプ		--system \ # バスタイプ
	--dest=org.freedesktop.login1 \ # バス名(D-Busサービス名)		--dest=org.freedesktop.login1 \ # バス名(D-Busサービス名)
	/org/freedesktop/login1 \ # D-Busオブジェクト名(オブジェクトパス)		/org/freedesktop/login1 \ # D-Busオブジェクト名(オブジェクトパス)
	# バス名(D-Busサービス)に送信するメッセージに含まれるそのバス名(D-Busサービス)内におけるメッセージの宛先		# バス名(D-Busサービス)に送信するメッセージに含まれるそのバス名(D-Busサービス)内におけるメッセージの宛先
	"org.freedesktop.login1.Manager.PowerOff" \ # D-Busインターフェース名(org.freedesktop.login1.Manager)~~とD-Busプロパティ名~~(PowerOff)		"org.freedesktop.login1.Manager.PowerOff" \ # D-Busインターフェース名(org.freedesktop.login1.Manager)とメソッド名(PowerOff)
	boolean:true # ~~プロパティのインターフェース名~~(~~関数の引数の型~~(boolean)と値(true))		boolean:true # メソッド名の引数 (引数の型(boolean)と値(true))

	# 再起動		# 再起動
	dbus-send --print-reply=literal \		dbus-send --print-reply=literal \
	--system # バスタイプ		--system \ # バスタイプ
	--dest=org.freedesktop.login1 \ # バス名(D-Busサービス名)		--dest=org.freedesktop.login1 \ # バス名(D-Busサービス名)
	/org/freedesktop/login1 \ # D-Busオブジェクト名(オブジェクトパス)		/org/freedesktop/login1 \ # D-Busオブジェクト名(オブジェクトパス)
	# バス名(D-Busサービス)に送信するメッセージに含まれるそのバス名(D-Busサービス)内におけるメッセージの宛先		# バス名(D-Busサービス)に送信するメッセージに含まれるそのバス名(D-Busサービス)内におけるメッセージの宛先
	"org.freedesktop.login1.Manager.Reboot" \ # D-Busインターフェース名(org.freedesktop.login1.Manager)~~とD-Busプロパティ名~~(Reboot)		"org.freedesktop.login1.Manager.Reboot" \ # D-Busインターフェース名(org.freedesktop.login1.Manager)とメソッド名(Reboot)
	boolean:true # ~~D-Busプロパティのインターフェース名~~(~~関数の引数の型~~(boolean)と値(true))		boolean:true # メソッド名の引数 (引数の型(boolean)と値(true))
	<br><br>		<br><br>

Wiki: /* D-Busプロパティ */

2024-04-04T07:19:36Z

D-Busプロパティ

← 古い版		2024年4月4日 (木) 16:19時点における版
105行目:		105行目:
	D-Busプロパティのインターフェースはorg.freedesktop.DBus.Propertiesであり、<code>Get</code>メソッドや<code>Set</code>メソッド等が定義されている。<br>		D-Busプロパティのインターフェースはorg.freedesktop.DBus.Propertiesであり、<code>Get</code>メソッドや<code>Set</code>メソッド等が定義されている。<br>
	以下の例では、org.bluezサービス、/org/bluez/hci0オブジェクトの持つプロパティの一覧が表示される。<br>		以下の例では、org.bluezサービス、/org/bluez/hci0オブジェクトの持つプロパティの一覧が表示される。<br>
	dbus-send --print-reply \		dbus-send --print-reply \ # 相手からの応答を出力
	--system \ # D-Busのタイプ (システムバスまたはセッションバス)		--system \ # D-Busのタイプ (システムバスまたはセッションバス)
	--dest=org.bluez \ # バス名 (D-Busサービス名)		--dest=org.bluez \ # バス名 (D-Busサービス名)

Wiki: /* D-Busプロパティ */

2024-04-04T07:18:42Z

D-Busプロパティ

← 古い版		2024年4月4日 (木) 16:18時点における版
105行目:		105行目:
	D-Busプロパティのインターフェースはorg.freedesktop.DBus.Propertiesであり、<code>Get</code>メソッドや<code>Set</code>メソッド等が定義されている。<br>		D-Busプロパティのインターフェースはorg.freedesktop.DBus.Propertiesであり、<code>Get</code>メソッドや<code>Set</code>メソッド等が定義されている。<br>
	以下の例では、org.bluezサービス、/org/bluez/hci0オブジェクトの持つプロパティの一覧が表示される。<br>		以下の例では、org.bluezサービス、/org/bluez/hci0オブジェクトの持つプロパティの一覧が表示される。<br>
	dbus-send --print-reply \		dbus-send --print-reply \
	--system \ # D-Busのタイプ		--system \ # D-Busのタイプ (システムバスまたはセッションバス)
	--dest=org.bluez \ # バス名(D-Busサービス名)		--dest=org.bluez \ # バス名 (D-Busサービス名)
	/org/bluez/hci0 \ # D-Busオブジェクト名		/org/bluez/hci0 \ # D-Busオブジェクト名
	--type=method_call \ # メッセージタイプ		--type=method_call \ # メッセージタイプ
	org.freedesktop.DBus.Properties.GetAll \ # D-Busインターフェース名(org.freedesktop.DBus.Properties)とメソッド名(GetAll)		org.freedesktop.DBus.Properties.GetAll \ # D-Busインターフェース名(org.freedesktop.DBus.Properties)とメソッド名(GetAll)
	string:org.bluez.Adapter1 # メソッドの引数		string:org.bluez.Adapter1 # メソッドの引数
	<br><br>		<br><br>

Wiki: /* D-Busコマンド */

2023-01-28T10:22:57Z

D-Busコマンド

@@ 259行目: / 259行目: @@
   "org.freedesktop.login1.Manager.Reboot" \  # D-Busインターフェース名(org.freedesktop.login1.Manager)とD-Busプロパティ名(Reboot)
   boolean:true                               # D-Busプロパティのインターフェース名(関数の引数の型(boolean)と値(true))
 <br><br>

Wiki: /* qdbusxml2cppコマンド */

2023-01-03T03:28:03Z

qdbusxml2cppコマンド

← 古い版		2023年1月3日 (火) 12:28時点における版
454行目:		454行目:
	qdbusxml2cpp -m -a <生成するcppファイル名とヘッダファイル名> -c <自動生成するヘルパークラス名 (親クラス)> -i <対象となるクラスを記述しているヘッダファイル> -l <対象となるクラス名> <D-Busインターフェースファイルのパス>		qdbusxml2cpp -m -a <生成するcppファイル名とヘッダファイル名> -c <自動生成するヘルパークラス名 (親クラス)> -i <対象となるクラスを記述しているヘッダファイル> -l <対象となるクラス名> <D-Busインターフェースファイルのパス>
	例. qdbusxml2cpp -m -a SamplesAdaptor -c SamplesAdaptor -i SampleHelper.h -l SampleHelper org.qt.policykit.examples.xml		例. qdbusxml2cpp -m -a SamplesAdaptor -c SamplesAdaptor -i SampleHelper.h -l SampleHelper org.qt.policykit.examples.xml

			# 各クラスに個別のインターフェースを宣言している場合は、各インターフェースごとにアダプターを生成する
			qdbusxml2cpp -m -a <生成するcppファイル名とヘッダファイル名> -c <自動生成するヘルパークラス名 (親クラス)> -i <対象となるクラスを記述しているヘッダファイル> -l <対象となるクラス名> <D-Busインターフェースファイルのパス> <D-Busインターフェース名>
			例. qdbusxml2cpp -m -a SamplesAdaptor -c SamplesAdaptor -i SampleHelper.h -l SampleHelper org.qt.policykit.examples.xml org.qt.policykit.examples2
	<br>		<br>
	<code>qdbusxml2cpp</code>コマンドのオプションを、以下に示す。<br>		<code>qdbusxml2cpp</code>コマンドのオプションを、以下に示す。<br>

Wiki: /* QtとD-Busのデータ型 */

2022-12-25T14:22:40Z

QtとD-Busのデータ型

@@ 335行目: / 335行目: @@
 </center>
 <br>
 ==== qdbuscpp2xmlコマンド ====
 <code>qdbuscpp2xml</code>コマンドは、<code>QObject</code>クラスを継承したクラスのヘッダファイル等をパースして、D-Busインターフェースファイルを生成する。<br>

Wiki: /* qdbuscpp2xmlコマンド */

2022-12-19T12:53:20Z

qdbuscpp2xmlコマンド

← 古い版		2022年12月19日 (月) 21:53時点における版
339行目:		339行目:
	スロットの引数が<code>const</code>で宣言されている場合は入力、非<code>const</code>の場合は出力とみなされることがある。<br>		スロットの引数が<code>const</code>で宣言されている場合は入力、非<code>const</code>の場合は出力とみなされることがある。<br>
	qdbuscpp2xml <入力オプション> <QObjectクラスを継承したクラスを定義したヘッダファイル> <出力オプション> <生成するD-Busインターフェースファイル名>		qdbuscpp2xml <入力オプション> <QObjectクラスを継承したクラスを定義したヘッダファイル> <出力オプション> <生成するD-Busインターフェースファイル名>
	例. qdbuscpp2xml -M SampleHelper.h -O org.qt.sample.xml		例. qdbuscpp2xml -A SampleHelper.h -o org.qt.sample.xml
	<br>		<br>
	<code>qdbuscpp2xml</code>コマンドのオプションを、以下に示す。<br>		<code>qdbuscpp2xml</code>コマンドのオプションを、以下に示す。<br>
350行目:		350行目:
	* -A		* -A
	*: 全てのコンテンツを出力する。(<code>-PSM</code>オプションと等価)		*: 全てのコンテンツを出力する。(<code>-PSM</code>オプションと等価)
	* -o ~~<生成するD-Busインターフェースファイル名> または -O~~ <生成するD-Busインターフェースファイル名>		* -o <生成するD-Busインターフェースファイル名>
	*: D-Busインターフェースファイルを生成する。		*: D-Busインターフェースファイルを生成する。
	<br>		<br>

Wiki: /* qdbuscpp2xmlコマンド */

2022-12-18T17:39:12Z

qdbuscpp2xmlコマンド

@@ 341行目: / 341行目: @@
   例. qdbuscpp2xml -M SampleHelper.h -O org.qt.sample.xml
 <br>
-qdbuscpp2xmlコマンドのオプションを、以下に示す。<br>
+<code>qdbuscpp2xml</code>コマンドのオプションを、以下に示す。<br>
 * -p または -s または -m
 *: スクリプト化されたアトリビュート(<code>-p</code>オプション)、シグナル(<code>-s</code>オプション)、メソッド（スロット関数）(<code>-m</code>オプション)のみがパースされる。
@@ 353行目: / 353行目: @@
 *: D-Busインターフェースファイルを生成する。
 <br>
 ==== サンプルコード ====
 以下の例では、Qtにおいて、D-Busを使用したメッセージの送受信を行っている。<br>

Wiki: /* QtとD-Bus */

2022-12-18T17:08:45Z

QtとD-Bus

@@ 286行目: / 286行目: @@
 == QtとD-Bus ==
 以下の例では、Qtにおいて、D-Busを使用したメッセージの送受信を行っている。<br>
 # セッションバスへの接続を取得する。

Wiki: /* qdbusviewer */

2022-12-12T07:58:42Z

qdbusviewer

@@ 283行目: / 283行目: @@
 <code>qdbusviewer</code>は、Qtで作成されたGUIソフトウェアであり、<code>qdbus</code>コマンドがCUIから提供する機能と基本的に同一のものをGUIとして提供している。<br>
 <code>qdbusviewer</code>は、Qt本体と同梱されており、オブジェクトアドレス等のD-Busの基本概念に慣れていれば、誰でも簡単に使用できる。<br>
 <br><br>

Wiki: /* 概要 */

2022-12-12T07:10:06Z

概要

← 古い版		2022年12月12日 (月) 16:10時点における版
27行目:		27行目:
	<br>		<br>
	D-Busは、言語やツールキットに囚われないため、あらゆるプロバイダのソフトウェアやサービスが相互作用することができる。<br>		D-Busは、言語やツールキットに囚われないため、あらゆるプロバイダのソフトウェアやサービスが相互作用することができる。<br>
			デーモン（軽量サービスプロバイダ）とそれを利用したいソフトウェアが、必要なサービス以上のことを知らなくても通信できるようにするためによく利用される。<br>
	<br>		<br>
	Qtは、D-Busと対話するためのクラスとツールのセットを提供しており、ここでは、D-Busのハイレベルなコンセプト、および、QtやKDEソフトウェアでの実装を記載する。<br>		Qtは、D-Busと対話するためのクラスとツールのセットを提供している。<br>
	<br><br>		<br><br>

Wiki: /* D-Busオブジェクトとは */

2022-12-11T16:47:32Z

D-Busオブジェクトとは

@@ 80行目: / 80行目: @@
 # 手続きメッセージ<code>org.freedesktop.DBus.Introspectable.Introspect</code>を送信した時、
 # <code>/</code>の下には<code>org</code>というオブジェクトがあるというメッセージを受信した。
 <br><br>

Wiki: /* D-Busコマンド */

2022-12-11T15:16:29Z

D-Busコマンド

← 古い版		2022年12月12日 (月) 00:16時点における版
211行目:		211行目:
	以下の例では、D-Busサービスを使用してシャットダウンおよび再起動を実行している。<br>		以下の例では、D-Busサービスを使用してシャットダウンおよび再起動を実行している。<br>
	# シャットダウン		# シャットダウン
	dbus-send ~~--system~~ --print-reply=literal \		dbus-send --print-reply=literal \
	--dest=org.freedesktop.login1 \ # バス名(D-Busサービス名)		--system \ # バスタイプ
	/org/freedesktop/login1 \ # オブジェクトパス(D-~~Busサービスに送信するメッセージに含まれるそのD~~-~~Busサービス内におけるメッセージの宛先~~)		--dest=org.freedesktop.login1 \ # バス名(D-Busサービス名)
	"org.freedesktop.login1.Manager.PowerOff" boolean:true # ~~D-Busインターフェースの関数名~~		/org/freedesktop/login1 \ # D-Busオブジェクト名(オブジェクトパス)
			# バス名(D-Busサービス)に送信するメッセージに含まれるそのバス名(D-Busサービス)内におけるメッセージの宛先
			"org.freedesktop.login1.Manager.PowerOff" \ # D-Busインターフェース名(org.freedesktop.login1.Manager)とD-Busプロパティ名(PowerOff)
			boolean:true # プロパティのインターフェース名(関数の引数の型(boolean)と値(true))

	# 再起動		# 再起動
	dbus-send ~~--system~~ --print-reply=literal \		dbus-send --print-reply=literal \
	--dest=org.freedesktop.login1 \ # バス名(D-Busサービス名)		--system # バスタイプ
	/org/freedesktop/login1 \ # オブジェクトパス(D-~~Busサービスに送信するメッセージに含まれるそのD~~-~~Busサービス内におけるメッセージの宛先~~)		--dest=org.freedesktop.login1 \ # バス名(D-Busサービス名)
	"org.freedesktop.login1.Manager.Reboot" boolean:true # D-~~Busインターフェースの関数名~~		/org/freedesktop/login1 \ # D-Busオブジェクト名(オブジェクトパス)
			# バス名(D-Busサービス)に送信するメッセージに含まれるそのバス名(D-Busサービス)内におけるメッセージの宛先
			"org.freedesktop.login1.Manager.Reboot" \ # D-Busインターフェース名(org.freedesktop.login1.Manager)とD-Busプロパティ名(Reboot)
			boolean:true # D-Busプロパティのインターフェース名(関数の引数の型(boolean)と値(true))
	<br><br>		<br><br>

Wiki: /* D-Busの基礎 */

2022-12-08T12:54:29Z

D-Busの基礎

@@ 32行目: / 32行目: @@
 == D-Busの基礎 ==
 D-Busは、<u>メッセージ</u>を<u>オブジェクト</u>に届ける仕組みである。<br>
 メッセージはデータであり、オブジェクトはデータの受け手であるプログラムのことである。<br>
@@ 45行目: / 46行目: @@
 <br>
 オブジェクトは、<u>サービス</u>に内包された<u>操作対象を指す名前</u>である。<br>
 <br><br>

Wiki: /* バス */

2022-12-08T12:16:27Z

バス

@@ 29行目: / 29行目: @@
 <br>
 Qtは、D-Busと対話するためのクラスとツールのセットを提供しており、ここでは、D-Busのハイレベルなコンセプト、および、QtやKDEソフトウェアでの実装を記載する。<br>
 <br><br>

Wiki: /* 概要 */

2022-12-08T12:04:41Z

概要

← 古い版		2022年12月8日 (木) 21:04時点における版
1行目:		1行目:
	== 概要 ==		== 概要 ==
	D-Busは、オープンソースのプロセス間通信(IPC)機構であり、freedesktop.orgプロジェクトの一部である。<br>		D-Busは、オープンソースのプロセス間通信(IPC:Inter Process Communication)機構であり、freedesktop.orgプロジェクトの一部である。<br>
	~~幅広いソフトウェアで使用されており、デスクトップの通知、メディアプレーヤー制御、XDGポータル等、多くのfreedesktop~~.org標準がD-Busをベースに構築されている。<br>		IPCとは、１台のコンピュータ上で動作する複数のプログラムの間で情報を交換するシステムのことである。<br>
			<br>
			IPCには、パイプ、名前付きパイプ、シグナル、共有メモリ、Unixソケット、ループバックソケット等がある。<br>
			D-Busもリンク層はUnixソケットで動作しているが、手順とフォーマット(プレゼンテーション層)が既定されていることが、「生の」Unixソケットとは異なる。<br>
			<br>
			開発当初はGNOME等のGUIの制御を目的としていが、今日では、GUIに限らず幅広いソフトウェアで使用されており、<br>
			デスクトップの通知、メディアプレーヤー制御、XDGポータル等、多くのfreedesktop.org標準がD-Busをベースに構築されている。<br>
	<br>		<br>
	IPCとは、あるプロセスから別のプロセスへ情報を取得する方法を説明するために使用することができる。<br>		IPCとは、あるプロセスから別のプロセスへ情報を取得する方法を説明するために使用することができる。<br>

Wiki: /* D-Busコマンド */

2022-12-08T11:20:54Z

D-Busコマンド

← 古い版		2022年12月8日 (木) 20:20時点における版
156行目:		156行目:
	dbus-send --system --print-reply=literal \		dbus-send --system --print-reply=literal \
	--dest=org.freedesktop.login1 \ # バス名(D-Busサービス名)		--dest=org.freedesktop.login1 \ # バス名(D-Busサービス名)
	/org/freedesktop/login1 \ # ~~バス名~~(D-~~Busサービス名~~)		/org/freedesktop/login1 \ # オブジェクトパス(D-Busサービスに送信するメッセージに含まれるそのD-Busサービス内におけるメッセージの宛先)
	"org.freedesktop.login1.Manager.PowerOff" boolean:true # D-Busインターフェースの関数名		"org.freedesktop.login1.Manager.PowerOff" boolean:true # D-Busインターフェースの関数名

162行目:		162行目:
	dbus-send --system --print-reply=literal \		dbus-send --system --print-reply=literal \
	--dest=org.freedesktop.login1 \ # バス名(D-Busサービス名)		--dest=org.freedesktop.login1 \ # バス名(D-Busサービス名)
	/org/freedesktop/login1 \ # ~~バス名~~(D-~~Busサービス名~~)		/org/freedesktop/login1 \ # オブジェクトパス(D-Busサービスに送信するメッセージに含まれるそのD-Busサービス内におけるメッセージの宛先)
	"org.freedesktop.login1.Manager.Reboot" boolean:true # D-Busインターフェースの関数名		"org.freedesktop.login1.Manager.Reboot" boolean:true # D-Busインターフェースの関数名
	<br><br>		<br><br>

Wiki: /* D-Busコマンド */

2022-12-08T11:12:28Z

D-Busコマンド

← 古い版		2022年12月8日 (木) 20:12時点における版
146行目:		146行目:
	== D-Busコマンド ==		== D-Busコマンド ==
	以下の例では、Linuxでのシャットダウン、再起動、ログアウト等のD-Busサービスの一覧を取得している。<br>		以下の例では、Linuxでのシャットダウン、再起動、ログアウト等のD-Busサービスの一覧を取得している。<br>
	~~# /usr/share/dbus-1/system.d/org.freedesktop.login1.conf~~
	dbus-send --system --print-reply=literal \		dbus-send --system --print-reply=literal \
	--dest=org.freedesktop.login1 \		--dest=org.freedesktop.login1 \

Wiki: /* シグナル */

2022-12-08T11:12:11Z

シグナル

@@ 142行目: / 142行目: @@
 <br>
 これは、Qtのシグナルとスロットの仕組みに似ており、これは、同じ機能のシステム版である。<br>
 <br><br>

Wiki: /* CMakeプロジェクト */

2022-12-07T22:14:44Z

CMakeプロジェクト

@@ 166行目: / 166行目: @@
 <code>qdbusviewer</code>は、Qtで作成されたGUIソフトウェアであり、<code>qdbus</code>コマンドがCUIから提供する機能と基本的に同一のものをGUIとして提供している。<br>
 <code>qdbusviewer</code>は、Qt本体と同梱されており、オブジェクトアドレス等のD-Busの基本概念に慣れていれば、誰でも簡単に使用できる。<br>
 <br><br>

Wiki: /* 便利なツール */

2022-12-07T22:05:47Z

便利なツール

@@ 166行目: / 166行目: @@
 <code>qdbusviewer</code>は、Qtで作成されたGUIソフトウェアであり、<code>qdbus</code>コマンドがCUIから提供する機能と基本的に同一のものをGUIとして提供している。<br>
 <code>qdbusviewer</code>は、Qt本体と同梱されており、オブジェクトアドレス等のD-Busの基本概念に慣れていれば、誰でも簡単に使用できる。<br>
 <br><br>
 __FORCETOC__
 [[カテゴリ:Qt]]

Wiki: ページの作成:「== 概要 == D-Busは、オープンソースのプロセス間通信(IPC)機構であり、freedesktop.orgプロジェクトの一部である。
幅広いソフトウェアで使用されており、デスクトップの通知、メディアプレーヤー制御、XDGポータル等、多くのfreedesktop.org標準がD-Busをベースに構築されている。

IPCとは、あるプロセスから別のプロセスへ情報を取得する方法を説…」

2022-11-27T01:50:16Z

ページの作成:「== 概要 == D-Busは、オープンソースのプロセス間通信(IPC)機構であり、freedesktop.orgプロジェクトの一部である。 幅広いソフトウェアで使用されており、デスクトップの通知、メディアプレーヤー制御、XDGポータル等、多くのfreedesktop.org標準がD-Busをベースに構築されている。 IPCとは、あるプロセスから別のプロセスへ情報を取得する方法を説…」

新規ページ

== 概要 ==
D-Busは、オープンソースのプロセス間通信(IPC)機構であり、freedesktop.orgプロジェクトの一部である。 
幅広いソフトウェアで使用されており、デスクトップの通知、メディアプレーヤー制御、XDGポータル等、多くのfreedesktop.org標準がD-Busをベースに構築されている。 
 
IPCとは、あるプロセスから別のプロセスへ情報を取得する方法を説明するために使用することができる。 
これは、データの交換、メソッドの呼び出し、イベントのリスニング等がある。 
 
* デスクトップにおけるIPCの使用例
** スクリプト(ユーザが共通の環境でスクリプトを実行して、実行中の様々なソフトウェアと対話または制御する) 
** 集中型サービスへのアクセスの提供
** 協調型ソフトウェアの複数のインスタンス間の調整
 
* D-Busの使用例
** freedesktop.orgのnotification仕様
**: これは、ソフトウェアは通知を中央サーバ(Plasma等)に送信して、中央サーバは通知を表示して、通知が閉じられたりアクションが実行されたりといったイベントを送り返すものである。
 
* IPCの他の使用例
** ユニークなソフトウェアのサポート
**: これは、ソフトウェアの起動時に、まず、同じソフトウェアの他の実行中のインスタンスを確認して、
**: もし存在すれば、IPCを介して実行中のインスタンスにメッセージを送信して、自分自身を表示して終了させる。
 
D-Busは、言語やツールキットに囚われないため、あらゆるプロバイダのソフトウェアやサービスが相互作用することができる。 
 
Qtは、D-Busと対話するためのクラスとツールのセットを提供しており、ここでは、D-Busのハイレベルなコンセプト、および、QtやKDEソフトウェアでの実装を記載する。 
 

== バス ==
D-Busは、ソフトウェアが相互に通信するため、複数のメッセージバスを提供する。 
 
各バスには独自の接続機能があり、異なるカテゴリーのメッセージを分離することができる。 
 
あるバスで送信されたメッセージは他のバスからアクセスできないが、同じバスに接続されたソフトウェアは全て互いに通信することができる。 
任意のバスに複数のソフトウェアを同時に接続することができ、また、1つのソフトウェアが複数のバスに同時に接続することも可能である。
これにより、バスごとに異なるセキュリティポリシーを適用できると共に、グローバルメッセージとローカルメッセージの両方を効率的に共有することができる。 
 
D-Busは、2つの定義済みバス(システムバスとセッションバス)を予め用意されており、一般的なD-Busの使用方法をほぼカバーすることができる。 
* システムバス
*: ハードウェア管理等のシステムグローバルサービスに使用される。
*: これはユーザー間で共有され、通常、厳格なセキュリティ・ポリシーが付属しています。
*: 
* セッションバス
*: 各デスクトップセッション（ログインしているユーザ等）には、セッションバスが存在する。
*: これは、GUIソフトウェア等が最も頻繁に使用する傾向がある。
 
さらに、ソフトウェアは、必要に応じて複数の独自のバスを作成することができる。 
 

== メッセージ ==
メッセージは、バスにおける通信の基本単位である。 
 
TCP/IPのパケットと同様に、バスでやり取りされる情報は、全てメッセージで行われる。 
しかし、ネットワークのパケットとは異なり、D-Busの各メッセージには、送受信されるデータ1式が含まれていることが保証されている。 
 
メッセージには、送信されるデータだけでなく、送信者と受信者が誰であるかも記録されており、適切なルーティングを可能にする。 
メッセージは、メソッドコール、シグナルエミッション、メソッドの戻り値であり、エラー情報も含むことがある。 
 

== 名前空間とアドレス ==
複数のソフトウェアが同一のバス上に存在し、1つのソフトウェアが複数のオブジェクトを提供してメッセージを送信することができるため、 
特定の住宅やオフィスを一意に識別するのと同様に、任意のバス上の任意のオブジェクトを効果的かつ一意にアドレス指定する手段を持つことが必要である。 
 
インターフェース、サービス、オブジェクト名の3つの情報を組み合わせることにより、バス上の任意のオブジェクトに一意のアドレスを作成することができる。 
 
==== インターフェイス ====
インターフェイスは、バス上に公表される呼び出し可能なメソッドとシグナルのセットである。 
 
インターフェースは、メッセージを渡すソフトウェアの間で、インターフェースの名前、パラメータ（もしあれば）、戻り値（もしあれば）を定義する"契約"を提供する。 
 
これらのメソッドは、インターフェイスを使用しているソフトウェアのメソッドやAPIに1対1で直接マッピングされることもある。(直接マッピングされないこともある) 
これにより、複数のソフトウェアが、内部の実装に関係なく、類似または同一のインターフェイスを提供することができ、 
一方で、ソフトウェアは、ソフトウェアの内部設計を気にすることなく、これらのインターフェイスを使用できるようになる。 
 
インターフェイスは、文書化やコードの再利用を目的として、XMLで記述する。 
ユーザや開発者は、インターフェースのXML記述を参照できるだけでなく、開発者はXMLから自動生成されたクラスを使用することができる。 
このため、D-Busの使用は非常に簡単で、エラーが発生しにくくなる。（例. コンパイラがコンパイル時にメッセージの構文を確認することができる） 
 
==== サービス ====
サービスとは、ソフトウェアとバスの接続を表すものである。 
 
ここでいうサービスとは、D-Busの用語でいうバス名に相当するものである。 
(バス名という用語は、バス上の接続名であり、バスの名前ではない。そのため、Qtのドキュメントで記載されているように、サービスという用語を使用する) 
 
これらは、複数のコンポーネントの名前空間を必要とする他の多くのシステムで見られるように、"逆ドメイン名"アプローチを使用することにより、一意に保たれる。 
KDEプロジェクトのソフトウェアが提供する多くのサービスでは、サービス名にorg.kdeというプレフィックスを使用している。 
そのため、セッションバスにおいて、org.kde.screensaverが宣伝されているのを見掛けるかもしれない。 
 
サービス名には、開発者の組織やソフトウェアのドメイン名を使用することを推奨する。 
例えば、開発者のドメインがawesomeapps.org、ソフトウェアの名前がwickedwidgetの場合、バス上のサービス名はorg.awesomeapps.wickedwidgetとなる。 
 
ソフトウェアが複数のバスに接続している場合、または、同一のソフトウェアの複数のインスタンスが同時にアクティブになっている場合は、接続ごとに一意なサービス名を使用する必要がある。 
多くの場合、プロセスIDをサービス名に付加することでこれを実現する。 
 
==== オブジェクト ====
ソフトウェアは、バス上の複数のオブジェクトへのアクセスを宣伝する可能性が高い。 
 
オブジェクトとサービスの間のこの多対1の関係は、アドレスにパスコンポーネントを提供することで対応される。 
 
サービスに関連付けられた各パスは、異なる一意のオブジェクトを表す。(例. /MainInterface、/Documents/Doc1) 
実際のパス構造は完全に任意であり、どのようなパスにするかは、サービスを提供するソフトウェア次第である。 
これらのパスは、他のソフトウェアにメッセージを送信するソフトウェアのために、オブジェクトを識別し、論理的にグループ化する方法を提供する。 
 
一部のライブラリは、オブジェクトを適切に名前空間化するために、オブジェクトパスの先頭に"リバースドメイン"を付けてエクスポートする。 
これは、任意のサービスに参加するライブラリやプラグインではよくあることで、そのため、ソフトウェアや他のコンポーネントによりエクスポートされたオブジェクトとの全ての衝突を避けなければならない。 
しかし、KDEソフトウェアやライブラリでは、この方法は使用されていない。 
 
オブジェクトはインターフェースへのアクセスを提供しており、オブジェクトは同時に複数のインタフェースへのアクセスを提供することができる。 
 
==== アドレスの例 ====
D-Busメッセージには、上記で記載したコンポーネントで構成されるアドレスが含まれており、正しいソフトウェア、オブジェクト、メソッドコールにルーティングされる。 
# 例. KRunnerのアドレス
org.kde.krunner /App org.kde.krunner.App.display

org.kde.krunner : サービス
/App : オブジェクトへのパス
org.kde.krunner.App : オブジェクトがエクスポートするインターフェース
display : インターフェース内のメソッド
 
もし、/Appオブジェクトがorg.kde.krunner.Appインターフェースを提供するのみの場合（または、実装するサービスの中で表示メソッドが一意の場合）、これはアドレスとして同様に機能する。 
org.kde.krunner /App display
 
このようにして、可能性のあるそれぞれの宛先を一意かつ確実にアドレスで指定することができる。 
 

== メソッドとシグナル ==
バス上の任意のエンドポイントをアドレス指定する方法を使用して、メッセージを送受信する場合の可能性を検討する。 
 
==== メソッド ====
受信側のソフトウェアにおいて、メソッド(関数)を実行するために送信されるメッセージのことである。 
 
メソッドの呼び出しに失敗した場合(アドレスの間違い、または、要求されたソフトウェアが動作していない等の理由でメソッドが利用できない場合)、呼び出し側のソフトウェアにエラーが返る。 
 
メソッドの呼び出しに成功した場合、呼び出し元のソフトウェアにオプションの戻り値が返る。(戻り値が提供されない場合でも、成功メッセージが返る) 
このラウンドトリップにはオーバーヘッドがあり、パフォーマンスが重要なコードではこれを念頭に置くことが重要である。 
 
メソッド呼び出しは、常に呼び出し元のソフトウェアによって開始されて、結果として生じるメッセージは正確に1つの送信元アドレスと1つの送信先アドレスを持つ。 
 
==== シグナル ====
シグナルはメソッドコールに似ているが、"逆方向"に発生すること、単一の宛先に縛られないことが特徴である。 
 
シグナルは、インターフェイスをエクスポートしているソフトウェアから発信されて、同一バス上のどのソフトウェアでも利用できる。 
これにより、ソフトウェアは、状態の変化やその他のイベントを、それらの変化を追跡するソフトウェアに自発的に知らせることができる。 
 
これは、Qtのシグナルとスロットの仕組みに似ており、これは、同じ機能のシステム版である。 
 

== 便利なツール ==
D-Busのバスの検索やD-Busを使用したソフトウェアの開発には、いくつかのエンドユーザ向けの便利なツールが存在する。 
 
==== qdbus ====
<code>qdbus</code>コマンドは、コマンドラインツールであり、与えられたバス上のサービス、オブジェクト、インタフェースを表示したり、バス上の与えられたアドレスにメッセージを送信するために使用できる。 
これは、セッションバスおよびシステムバスの両方を検索するために使用することができる。 
 
<code>--system</code>オプションを付加する場合は、qdbusはシステムバスに接続する。 
<code>--system</code>オプションを付加しない場合は、セッションバスを使用する。 
 
<code>qdbus</code>コマンドは、与えられた引数を、与えられたオブジェクトに渡すためのアドレス、および、パラメータ(存在する場合)として使用する。 
もし、完全なアドレスが与えられなかった場合、バス上のその地点から利用可能な全てのオブジェクトを表示する。 
 
例えば、アドレスが提供されない場合は、利用可能なサービスのリストが表示される。 
サービス名を指定する場合、オブジェクトのパスが提供される。 
パスを指定する場合、全てのインターフェースの全てのメソッドが表示される。 
 
このように、非常に簡単にバス上のオブジェクトを検索して操作することができる。 
 
==== qdbusviewer ====
<code>qdbusviewer</code>は、Qtで作成されたGUIソフトウェアであり、<code>qdbus</code>コマンドがCUIから提供する機能と基本的に同一のものをGUIとして提供している。 
<code>qdbusviewer</code>は、Qt本体と同梱されており、オブジェクトアドレス等のD-Busの基本概念に慣れていれば、誰でも簡単に使用できる。 
 

__FORCETOC__
[[カテゴリ:Qt]]