This file is indexed.

/usr/share/doc/libdtd-parser-java/api/com/sun/xml/dtdparser/MessageCatalog.html is in libdtd-parser-java-doc 1.2~svn20110404-1.

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
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc (version 1.7.0_51) on Mon Jan 20 15:41:11 UTC 2014 -->
<meta http-equiv="Content-Type" content="text/html" charset="UTF-8">
<title>MessageCatalog (DTD Parser 1.2-SNAPSHOT API)</title>
<meta name="date" content="2014-01-20">
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
</head>
<body>
<script type="text/javascript"><!--
    if (location.href.indexOf('is-external=true') == -1) {
        parent.document.title="MessageCatalog (DTD Parser 1.2-SNAPSHOT API)";
    }
//-->
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a name="navbar_top">
<!--   -->
</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow">
<!--   -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../com/sun/xml/dtdparser/package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/MessageCatalog.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../index-all.html">Index</a></li>
<li><a href="../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../../com/sun/xml/dtdparser/InputEntity.html" title="class in com.sun.xml.dtdparser"><span class="strong">Prev Class</span></a></li>
<li><a href="../../../../com/sun/xml/dtdparser/Resolver.html" title="class in com.sun.xml.dtdparser"><span class="strong">Next Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../index.html?com/sun/xml/dtdparser/MessageCatalog.html" target="_top">Frames</a></li>
<li><a href="MessageCatalog.html" target="_top">No Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../../../allclasses-noframe.html">All Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
  allClassesLink = document.getElementById("allclasses_navbar_top");
  if(window==top) {
    allClassesLink.style.display = "block";
  }
  else {
    allClassesLink.style.display = "none";
  }
  //-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor_summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method_summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor_detail">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method_detail">Method</a></li>
</ul>
</div>
<a name="skip-navbar_top">
<!--   -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
<!-- ======== START OF CLASS DATA ======== -->
<div class="header">
<div class="subTitle">com.sun.xml.dtdparser</div>
<h2 title="Class MessageCatalog" class="title">Class MessageCatalog</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li><a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li>com.sun.xml.dtdparser.MessageCatalog</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr>
<br>
<pre>public abstract class <span class="strong">MessageCatalog</span>
extends <a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">This class provides support for multi-language string lookup, as needed
 to localize messages from applications supporting multiple languages
 at the same time.  One class of such applications is network services,
 such as HTTP servers, which talk to clients who may not be from the
 same locale as the server.  This class supports a form of negotiation
 for the language used in presenting a message from some package, where
 both user (client) preferences and application (server) support are
 accounted for when choosing locales and formatting messages.
 <p/>
 <P> Each package should have a singleton package-private message catalog
 class.  This ensures that the correct class loader will always be used to
 access message resources, and minimizes use of memory: <PRE>
 package <em>some.package</em>;
 <p/>
 // "foo" might be public
 class foo {
 ...
 // package private
 static final Catalog messages = new Catalog ();
 static final class Catalog extends MessageCatalog {
 Catalog () { super (Catalog.class); }
 }
 ...
 }
 </PRE>
 <p/>
 <P> Messages for a known client could be generated using code
 something like this:  <PRE>
 String clientLanguages [];
 Locale clientLocale;
 String clientMessage;
 <p/>
 // client languages will probably be provided by client,
 // e.g. by an HTTP/1.1 "Accept-Language" header.
 clientLanguages = new String [] { "en-ca", "fr-ca", "ja", "zh" };
 clientLocale = foo.messages.chooseLocale (clientLanguages);
 clientMessage = foo.messages.getMessage (clientLocale,
 "fileCount",
 new Object [] { new Integer (numberOfFiles) }
 );
 </PRE>
 <p/>
 <P> At this time, this class does not include functionality permitting
 messages to be passed around and localized after-the-fact.  The consequence
 of this is that the locale for messages must be passed down through layers
 which have no normal reason to support such passdown, or else the system
 default locale must be used instead of the one the client needs.
 <p/>
 <P> <hr> The following guidelines should be used when constructiong
 multi-language applications:  <OL>
 <p/>
 <LI> Always use <a href=#chooseLocale>chooseLocale</a> to select the
 locale you pass to your <code>getMessage</code> call.  This lets your
 applications use IETF standard locale names, and avoids needless
 use of system defaults.
 <p/>
 <LI> The localized messages for a given package should always go in
 a separate <em>resources</em> sub-package.  There are security
 implications; see below.
 <p/>
 <LI> Make sure that a language name is included in each bundle name,
 so that the developer's locale will not be inadvertently used. That
 is, don't create defaults like <em>resources/Messages.properties</em>
 or <em>resources/Messages.class</em>, since ResourceBundle will choose
 such defaults rather than giving software a chance to choose a more
 appropriate language for its messages.  Your message bundles should
 have names like <em>Messages_en.properties</em> (for the "en", or
 English, language) or <em>Messages_ja.class</em> ("ja" indicates the
 Japanese language).
 <p/>
 <LI> Only use property files for messages in languages which can
 be limited to the ISO Latin/1 (8859-1) characters supported by the
 property file format.  (This is mostly Western European languages.)
 Otherwise, subclass ResourceBundle to provide your messages; it is
 simplest to subclass <code>java.util.ListResourceBundle</code>.
 <p/>
 <LI> Never use another package's message catalog or resource bundles.
 It should not be possible for a change internal to one package (such
 as eliminating or improving messages) to break another package.
 <p/>
 </OL>
 <p/>
 <P> The "resources" sub-package can be treated separately from the
 package with which it is associated.  That main package may be sealed
 and possibly signed, preventing other software from adding classes to
 the package which would be able to access methods and data which are
 not designed to be publicly accessible.  On the other hand, resources
 such as localized messages are often provided after initial product
 shipment, without a full release cycle for the product.  Such files
 (text and class files) need to be added to some package.  Since they
 should not be added to the main package, the "resources" subpackage is
 used without risking the security or integrity of that main package
 as distributed in its JAR file.</div>
<dl><dt><span class="strong">Version:</span></dt>
  <dd>1.1, 00/08/05</dd>
<dt><span class="strong">Author:</span></dt>
  <dd>David Brownell</dd>
<dt><span class="strong">See Also:</span></dt><dd><a href="http://docs.oracle.com/javase/1.3/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util"><code>Locale</code></a>, 
<a href="http://docs.oracle.com/javase/1.3/docs/api/java/util/ListResourceBundle.html?is-external=true" title="class or interface in java.util"><code>ListResourceBundle</code></a>, 
<a href="http://docs.oracle.com/javase/1.3/docs/api/java/text/MessageFormat.html?is-external=true" title="class or interface in java.text"><code>MessageFormat</code></a></dd></dl>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor_summary">
<!--   -->
</a>
<h3>Constructor Summary</h3>
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
<caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Modifier</th>
<th class="colLast" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected </code></td>
<td class="colLast"><code><strong><a href="../../../../com/sun/xml/dtdparser/MessageCatalog.html#MessageCatalog(java.lang.Class)">MessageCatalog</a></strong>(<a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a>&nbsp;packageMember)</code>
<div class="block">Create a message catalog for use by classes in the same package
 as the specified class.</div>
</td>
</tr>
</table>
</li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method_summary">
<!--   -->
</a>
<h3>Method Summary</h3>
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
<caption><span>Methods</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/1.3/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util">Locale</a></code></td>
<td class="colLast"><code><strong><a href="../../../../com/sun/xml/dtdparser/MessageCatalog.html#chooseLocale(java.lang.String[])">chooseLocale</a></strong>(<a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>[]&nbsp;languages)</code>
<div class="block">Chooses a client locale to use, using the first language specified in
 the list that is supported by this catalog.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
<td class="colLast"><code><strong><a href="../../../../com/sun/xml/dtdparser/MessageCatalog.html#getMessage(java.util.Locale, java.lang.String)">getMessage</a></strong>(<a href="http://docs.oracle.com/javase/1.3/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util">Locale</a>&nbsp;locale,
          <a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;messageId)</code>
<div class="block">Get a message localized to the specified locale, using the message ID
 and package name if no message is available.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
<td class="colLast"><code><strong><a href="../../../../com/sun/xml/dtdparser/MessageCatalog.html#getMessage(java.util.Locale, java.lang.String, java.lang.Object[])">getMessage</a></strong>(<a href="http://docs.oracle.com/javase/1.3/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util">Locale</a>&nbsp;locale,
          <a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;messageId,
          <a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[]&nbsp;parameters)</code>
<div class="block">Format a message localized to the specified locale, using the message
 ID with its package name if none is available.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../com/sun/xml/dtdparser/MessageCatalog.html#isLocaleSupported(java.lang.String)">isLocaleSupported</a></strong>(<a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;localeName)</code>
<div class="block">Returns true iff the specified locale has explicit language support.</div>
</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods_inherited_from_class_java.lang.Object">
<!--   -->
</a>
<h3>Methods inherited from class&nbsp;java.lang.<a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3>
<code><a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</a>, <a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</a>, <a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</a>, <a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</a>, <a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</a>, <a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</a>, <a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</a>, <a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</a>, <a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Object.html?is-external=true#wait(long, int)" title="class or interface in java.lang">wait</a></code></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor_detail">
<!--   -->
</a>
<h3>Constructor Detail</h3>
<a name="MessageCatalog(java.lang.Class)">
<!--   -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>MessageCatalog</h4>
<pre>protected&nbsp;MessageCatalog(<a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a>&nbsp;packageMember)</pre>
<div class="block">Create a message catalog for use by classes in the same package
 as the specified class.  This uses <em>Messages</em> resource
 bundles in the <em>resources</em> sub-package of class passed as
 a parameter.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>packageMember</code> - Class whose package has localized messages</dd></dl>
</li>
</ul>
</li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method_detail">
<!--   -->
</a>
<h3>Method Detail</h3>
<a name="getMessage(java.util.Locale, java.lang.String)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getMessage</h4>
<pre>public&nbsp;<a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;getMessage(<a href="http://docs.oracle.com/javase/1.3/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util">Locale</a>&nbsp;locale,
                <a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;messageId)</pre>
<div class="block">Get a message localized to the specified locale, using the message ID
 and package name if no message is available.  The locale is normally
 that of the client of a service, chosen with knowledge that both the
 client and this server support that locale.  There are two error
 cases:  first, when the specified locale is unsupported or null, the
 default locale is used if possible; second, when no bundle supports
 that locale, the message ID and package name are used.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>locale</code> - The locale of the message to use.  If this is null,
                  the default locale will be used.</dd><dd><code>messageId</code> - The ID of the message to use.</dd>
<dt><span class="strong">Returns:</span></dt><dd>The message, localized as described above.</dd></dl>
</li>
</ul>
<a name="getMessage(java.util.Locale, java.lang.String, java.lang.Object[])">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getMessage</h4>
<pre>public&nbsp;<a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;getMessage(<a href="http://docs.oracle.com/javase/1.3/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util">Locale</a>&nbsp;locale,
                <a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;messageId,
                <a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[]&nbsp;parameters)</pre>
<div class="block">Format a message localized to the specified locale, using the message
 ID with its package name if none is available.  The locale is normally
 the client of a service, chosen with knowledge that both the client
 server support that locale.  There are two error cases:  first, if the
 specified locale is unsupported or null, the default locale is used if
 possible; second, when no bundle supports that locale, the message ID
 and package name are used.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>locale</code> - The locale of the message to use.  If this is null,
                   the default locale will be used.</dd><dd><code>messageId</code> - The ID of the message format to use.</dd><dd><code>parameters</code> - Used when formatting the message.  Objects in
                   this list are turned to strings if they are not Strings, Numbers,
                   or Dates (that is, if MessageFormat would treat them as errors).</dd>
<dt><span class="strong">Returns:</span></dt><dd>The message, localized as described above.</dd><dt><span class="strong">See Also:</span></dt><dd><a href="http://docs.oracle.com/javase/1.3/docs/api/java/text/MessageFormat.html?is-external=true" title="class or interface in java.text"><code>MessageFormat</code></a></dd></dl>
</li>
</ul>
<a name="chooseLocale(java.lang.String[])">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>chooseLocale</h4>
<pre>public&nbsp;<a href="http://docs.oracle.com/javase/1.3/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util">Locale</a>&nbsp;chooseLocale(<a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>[]&nbsp;languages)</pre>
<div class="block">Chooses a client locale to use, using the first language specified in
 the list that is supported by this catalog.  If none of the specified
 languages is supported, a null value is returned.  Such a list of
 languages might be provided in an HTTP/1.1 "Accept-Language" header
 field, or through some other content negotiation mechanism.
 <p/>
 <P> The language specifiers recognized are RFC 1766 style ("fr" for
 all French, "fr-ca" for Canadian French), although only the strict
 ISO subset (two letter language and country specifiers) is currently
 supported.  Java-style locale strings ("fr_CA") are also supported.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>languages</code> - Array of language specifiers, ordered with the most
                  preferable one at the front.  For example, "en-ca" then "fr-ca",
                  followed by "zh_CN".</dd>
<dt><span class="strong">Returns:</span></dt><dd>The most preferable supported locale, or null.</dd><dt><span class="strong">See Also:</span></dt><dd><a href="http://docs.oracle.com/javase/1.3/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util"><code>Locale</code></a></dd></dl>
</li>
</ul>
<a name="isLocaleSupported(java.lang.String)">
<!--   -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>isLocaleSupported</h4>
<pre>public&nbsp;boolean&nbsp;isLocaleSupported(<a href="http://docs.oracle.com/javase/1.3/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;localeName)</pre>
<div class="block">Returns true iff the specified locale has explicit language support.
 For example, the traditional Chinese locale "zh_TW" has such support
 if there are message bundles suffixed with either "zh_TW" or "zh".
 <p/>
 <P> This method is used to bypass part of the search path mechanism
 of the <code>ResourceBundle</code> class, specifically the parts which
 force use of default locales and bundles.  Such bypassing is required
 in order to enable use of a client's preferred languages.  Following
 the above example, if a client prefers "zh_TW" but can also accept
 "ja", this method would be used to detect that there are no "zh_TW"
 resource bundles and hence that "ja" messages should be used.  This
 bypasses the ResourceBundle mechanism which will return messages in
 some other locale (picking some hard-to-anticipate default) instead
 of reporting an error and letting the client choose another locale.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>localeName</code> - A standard Java locale name, using two character
                   language codes optionally suffixed by country codes.</dd>
<dt><span class="strong">Returns:</span></dt><dd>True iff the language of that locale is supported.</dd><dt><span class="strong">See Also:</span></dt><dd><a href="http://docs.oracle.com/javase/1.3/docs/api/java/util/Locale.html?is-external=true" title="class or interface in java.util"><code>Locale</code></a></dd></dl>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<!-- ========= END OF CLASS DATA ========= -->
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a name="navbar_bottom">
<!--   -->
</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow">
<!--   -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../com/sun/xml/dtdparser/package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/MessageCatalog.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../index-all.html">Index</a></li>
<li><a href="../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../../com/sun/xml/dtdparser/InputEntity.html" title="class in com.sun.xml.dtdparser"><span class="strong">Prev Class</span></a></li>
<li><a href="../../../../com/sun/xml/dtdparser/Resolver.html" title="class in com.sun.xml.dtdparser"><span class="strong">Next Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../index.html?com/sun/xml/dtdparser/MessageCatalog.html" target="_top">Frames</a></li>
<li><a href="MessageCatalog.html" target="_top">No Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../../../allclasses-noframe.html">All Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
  allClassesLink = document.getElementById("allclasses_navbar_bottom");
  if(window==top) {
    allClassesLink.style.display = "block";
  }
  else {
    allClassesLink.style.display = "none";
  }
  //-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor_summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method_summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor_detail">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method_detail">Method</a></li>
</ul>
</div>
<a name="skip-navbar_bottom">
<!--   -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<p class="legalCopy"><small>Copyright &#169; 2005&#x2013;2014 <a href="http://www.oracle.com/">Oracle</a>. All rights reserved.</small></p>
</body>
</html>