/usr/share/doc/libdbus-java/dbus-java/dbus-javase4.html is in libdbus-java-doc 2.8-5.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 | <?xml version="1.0" encoding="iso-8859-1" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd-->
<html xmlns="http://www.w3.org/1999/xhtml"
>
<head><title>DBusSignal</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<meta name="generator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" />
<meta name="originator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" />
<!-- xhtml,2,html -->
<meta name="src" content="dbus-java.tex" />
<meta name="date" content="2014-02-01 05:14:00" />
<link rel="stylesheet" type="text/css" href="dbus-java.css" />
</head><body
>
<!--l. 328--><div class="crosslinks"><p class="noindent">[<a
href="dbus-javase3.html" >prev</a>] [<a
href="dbus-javase3.html#taildbus-javase3.html" >prev-tail</a>] [<a
href="#taildbus-javase4.html">tail</a>] [<a
href="dbus-java.html#dbus-javase13.html" >up</a>] </p></div>
<h3 class="sectionHead"><span class="titlemark">4 </span> <a
id="x17-170004"></a>DBusSignal</h3>
<!--l. 330--><p class="noindent" >Signals are also declared as part of an interface. The Java API models these
as inner classes within an interface. The containing interface must extend
<span
class="cmtt-12">DBusInterface</span>, and the inner classes representing the signals must extend
<span
class="cmtt-12">DBusSignal</span><span class="footnote-mark"><a
href="dbus-java18.html#fn10x0"><sup class="textsuperscript">10</sup></a></span><a
id="x17-17001f10"></a> .
The Signal name is derived from the name of this inner class, and the interface from its
containing interface.
</p><!--l. 337--><p class="indent" > Signals can take parameters as methods can (although they cannot return anything). For
the reflection to work, a Signal declare a single constructor of the correct type. The
constructor must take the object path they are being emitted from as their first
(String) argument, followed by the other parameters in order. They must also call the
superclass constructor with the same parameters. A full definition of a signal can
be seen in figure <a
href="#x17-170035">5<!--tex4ht:ref: fig:signal --></a>. Again, more complicated definitions are available in the test
classes<span class="footnote-mark"><a
href="dbus-java19.html#fn11x0"><sup class="textsuperscript">11</sup></a></span><a
id="x17-17002f11"></a> .
</p>
<hr class="figure" /><div class="figure"
>
<a
id="x17-170035"></a>
<div class="center"
>
<!--l. 348--><p class="noindent" >
</p>
<div class="verbatim" id="verbatim-11">
package org.freedesktop;
 <br />import org.freedesktop.dbus.DBusInterface;
 <br />import org.freedesktop.dbus.DBusSignal;
 <br />import org.freedesktop.dbus.exceptions.DBusException;
 <br />
 <br />public interface DBus extends DBusInterface
 <br />{
 <br />   public class NameAcquired extends DBusSignal
 <br />   {
 <br />      public final String name;
 <br />      public NameAcquired(String path, String name)
 <br />                              throws DBusException
 <br />      {
 <br />         super(path, name);
 <br />         this.name = name;
 <br />      }
 <br />   }
 <br />}
</div>
<!--l. 368--><p class="nopar" ></p></div>
<br /> <div class="caption"
><span class="id">Figure 5: </span><span
class="content">A Signal with one parameter</span></div><!--tex4ht:label?: x17-170035 -->
</div><hr class="endfigure" />
<!--l. 374--><div class="crosslinks"><p class="noindent">[<a
href="dbus-javase3.html" >prev</a>] [<a
href="dbus-javase3.html#taildbus-javase3.html" >prev-tail</a>] [<a
href="dbus-javase4.html" >front</a>] [<a
href="dbus-java.html#dbus-javase13.html" >up</a>] </p></div>
<!--l. 374--><p class="indent" > <a
id="taildbus-javase4.html"></a> </p>
</body></html>
|