This file is indexed.

/usr/share/doc/libdbus-java/dbus-java/dbus-javase5.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
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
<?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>DBusExecutionException</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 19:41:00" /> 
<link rel="stylesheet" type="text/css" href="dbus-java.css" /> 
</head><body 
>
   <!--l. 374--><div class="crosslinks"><p class="noindent">[<a 
href="dbus-javase4.html" >prev</a>] [<a 
href="dbus-javase4.html#taildbus-javase4.html" >prev-tail</a>] [<a 
href="dbus-javase2.html#taildbus-javase5.html">tail</a>] [<a 
href="dbus-java.html# " >up</a>] </p></div>
   <h3 class="sectionHead"><span class="titlemark">5   </span> <a 
 id="x20-180005"></a>DBusExecutionException</h3>
<!--l. 376--><p class="noindent" >If you wish to report an error condition in a method call you can throw an instance of
<span 
class="cmtt-12">DBusExecutionException</span><span class="footnote-mark"><a 
href="dbus-java21.html#fn12x0"><sup class="textsuperscript">12</sup></a></span><a 
 id="x20-18001f12"></a> .
This will be sent back to the caller as an error message, and the error name is taken from the
class name of the exception. For example, if you wanted to report an unknown method you
would define an exception as in figure <a 
href="#x20-180026">6<!--tex4ht:ref: fig:exceptiondef --></a> and then throw it in your method as in figure
<a 
href="#x20-180037">7<!--tex4ht:ref: fig:exceptioncall --></a>.
</p>
   <hr class="figure" /><div class="figure" 
>
                                                                                      
                                                                                      
<a 
 id="x20-180026"></a>
                                                                                      
                                                                                      
<div class="center" 
>
<!--l. 386--><p class="noindent" >
                                                                                      
                                                                                      
</p>
<div class="verbatim" id="verbatim-12">
package&#x00A0;org.freedesktop.DBus.Error;
&#x00A0;<br />import&#x00A0;org.freedesktop.dbus.exceptions.DBusExecutionException;
&#x00A0;<br />
&#x00A0;<br />public&#x00A0;class&#x00A0;UnknownMethod&#x00A0;extends&#x00A0;DBusExecutionException
&#x00A0;<br />{
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;public&#x00A0;UnknownMethod(String&#x00A0;message)
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;{
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;super(message);
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;}
&#x00A0;<br />}
</div>
<!--l. 398--><p class="nopar" ></p></div>
<br /> <div class="caption" 
><span class="id">Figure&#x00A0;6: </span><span  
class="content">An Exception</span></div><!--tex4ht:label?: x20-180026 -->
                                                                                      
                                                                                      
   </div><hr class="endfigure" />
   <hr class="figure" /><div class="figure" 
>
                                                                                      
                                                                                      
<a 
 id="x20-180037"></a>
                                                                                      
                                                                                      
<div class="center" 
>
<!--l. 405--><p class="noindent" >
                                                                                      
                                                                                      
</p>
<div class="verbatim" id="verbatim-13">
...
&#x00A0;<br />public&#x00A0;void&#x00A0;throwme()&#x00A0;throws&#x00A0;org.freedesktop.DBus.Error.UnknownMethod
&#x00A0;<br />{
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;throw&#x00A0;new&#x00A0;org.freedesktop.DBus.Error.UnknownMethod("hi");
&#x00A0;<br />}
&#x00A0;<br />...
</div>
<!--l. 413--><p class="nopar" ></p></div>
<br /> <div class="caption" 
><span class="id">Figure&#x00A0;7: </span><span  
class="content">Throwing An Exception</span></div><!--tex4ht:label?: x20-180037 -->
                                                                                      
                                                                                      
   </div><hr class="endfigure" />
<!--l. 419--><p class="indent" >   If you are calling a remote method and you want to handle such an error you can simply
catch the exception as in figure <a 
href="#x20-180048">8<!--tex4ht:ref: fig:exceptioncatch --></a>.
</p>
   <hr class="figure" /><div class="figure" 
>
                                                                                      
                                                                                      
<a 
 id="x20-180048"></a>
                                                                                      
                                                                                      
<div class="center" 
>
<!--l. 423--><p class="noindent" >
                                                                                      
                                                                                      
</p>
<div class="verbatim" id="verbatim-14">
...
&#x00A0;<br />try&#x00A0;{
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;remote.throwme();
&#x00A0;<br />}&#x00A0;catch&#x00A0;(org.freedesktop.DBus.Error.UnknownMethod&#x00A0;UM)&#x00A0;{
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;...
&#x00A0;<br />}
&#x00A0;<br />...
</div>
<!--l. 432--><p class="nopar" ></p></div>
<br /> <div class="caption" 
><span class="id">Figure&#x00A0;8: </span><span  
class="content">Catching An Exception</span></div><!--tex4ht:label?: x20-180048 -->
                                                                                      
                                                                                      
   </div><hr class="endfigure" />
                                                                                      
                                                                                      
   <!--l. 438--><div class="crosslinks"><p class="noindent">[<a 
href="dbus-javase4.html" >prev</a>] [<a 
href="dbus-javase4.html#taildbus-javase4.html" >prev-tail</a>] [<a 
href="dbus-javase5.html" >front</a>] [<a 
href="dbus-java.html# " >up</a>] </p></div>
<!--l. 438--><p class="indent" >   <a 
 id="taildbus-javase5.html"></a> </p> 
</body></html>