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
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
|
<html>
<head>
<title>
Handbuch der Java-Programmierung, 5. Auflage
</title>
</head>
<body>
<a name="startofbody"></a>
<script language="JavaScript" src="hjp4lib.js">
</script>
<script language="JavaScript">
installKbdHandler("97,#startofbody;101,#endofbody;116,cover.html;122,k100003.html;115,search.html;105,index.html;100,JDKDOCS;112,APIDOCS;104,k100083.html;106,k100086.html;107,k100088.html;108,k100090.html");
</script>
<table border=0 cellpadding=0 cellspacing=1 width="100%">
<tr bgcolor="#EEFFCC">
<td width="7%" align=center bgcolor="#DDCC99"><a href="cover.html"> Titel </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100003.html"> Inhalt </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="search.html"> Suchen </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="index.html"> Index </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="../jdkdocs/index.html" onClick="this.href=getDocIndex()"> DOC </a>
<td align="right">Handbuch der Java-Programmierung, 5. Auflage
<tr bgcolor="#EEFFCC">
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100083.html"> << </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100086.html"> < </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100088.html"> > </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100090.html"> >> </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="../jdkdocs/api/index.html" onClick="this.href=getApiIndex()"> API </a>
<td align="right">Kapitel 13 - Strukturierung von Java-Programmen
</table>
<hr>
<!-- Section -->
<a name="sectlevel2id013004"></a>
<h2>13.4 Auslieferung von Java-Programmen </h2>
<hr>
<ul>
<li><a href="k100087.html#sectlevel2id013004">13.4 Auslieferung von Java-Programmen</a>
<ul>
<li><a href="k100087.html#sectionclasspath">13.4.1 Weitergabe des Bytecodes</a>
<ul>
<li><a href="k100087.html#sectlevel4id013004001001">Direkte Weitergabe der Klassendateien</a>
<li><a href="k100087.html#subsectionclasspath">Verwendung eines jar-Archivs</a>
<li><a href="k100087.html#sectlevel4id013004001003">Ausführbare jar-Archive</a>
</ul>
<li><a href="k100087.html#sectlevel3id013004002">13.4.2 Einbinden von Ressourcen-Dateien</a>
</ul>
</ul>
<hr>
<!-- Section -->
<a name="sectionclasspath"></a>
<h3>13.4.1 Weitergabe des Bytecodes </h3>
<!-- Section -->
<a name="sectlevel4id013004001001"></a>
<h4>Direkte Weitergabe der Klassendateien </h4>
<p>
Der ausführbare Programmcode einer Java-Applikation befindet
sich in den vom Compiler erzeugten <font color="#660099">.class</font>-Dateien.
Sie sind der wichtigste Bestandteil bei der Auslieferung eines Java-Programms.
Wir werden uns in diesem Abschnitt ansehen, auf welche Weise die Klassendateien
weitergegeben werden können und was dabei zu beachten ist. Neben
den Klassendateien müssen mitunter auch zusätzliche Dateien
mit Übersetzungstexten, Fehlermeldungen, Icons oder Bilddateien
weitergegeben werden. Wie diese zusammen mit den Klassendateien ausgeliefert
und verwendet werden können, zeigt der nächste Abschnitt.
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100%>
<tr>
<td width=1 align=left valign=top bgcolor="#CC0000"><img src="trp1_1.gif"></td>
<td><img src="trp1_1.gif" width=1></td>
<td width=1 align=left valign=top bgcolor="#CC0000"><img src="trp1_1.gif"></td>
<td><img src="trp1_1.gif" width=2></td>
<td valign=top width=1000>
<p>
Die Ausführungen in diesem und dem nächsten Abschnitt sind
möglicherweise schwierig zu verstehen, denn sie setzen Kenntnisse
voraus, die teilweise erst in späteren Kapiteln vermittelt werden.
Wegen ihres engen thematischen Bezuges zum vorliegenden Kapitel sind
sie hier dennoch richtig aufgehoben, und Sie sollten den Ausführungen
zumindest in groben Zügen folgen können. Lesen Sie diese
Abschnitte bei Bedarf einfach zu einem späteren Zeitpunkt noch
einmal, und viele Dinge, die jetzt unklar sind, werden dann leicht
zu verstehen sein.</td>
<td><img src="trp1_1.gif" width=2></td>
<td valign=top>
<table border=0 cellspacing=0 cellpadding=1 width=100% bgcolor="#CC0000">
<tr>
<td><font color="#FFFFFF"> Warnung </font></td>
</tr>
</table>
</td>
<td width=1 align=left valign=top bgcolor="#CC0000"><img src="trp1_1.gif"></td>
</tr>
</table>
<p>
Die einfachste Möglichkeit, ein Java-Programm auszuliefern, besteht
darin, die Klassendateien so zu belassen, wie sie sind, und sie entsprechend
ihrer Paketstruktur auf das Zielsystem zu kopieren. Das Programm kann
dann auf dem Zielsystem gestartet werden, indem der Java-Interpreter
aus dem Installationsverzeichnis aufgerufen und der Name der zu startenden
Klasse als Argument angegeben wird.
<p>
Als Beispiel wollen wir uns eine hypothetische Applikation ansehen,
die aus folgenden Klassen besteht:
<font color="#000077">
<pre>
com.gkrueger.app.App
com.gkrueger.app.AppFrame
com.gkrueger.util.Logger
</pre>
</font>
<p>
Die Klassen <font color="#000077"><tt>App</tt></font> und <font color="#000077"><tt>AppFrame</tt></font>
befinden sich im Paket <font color="#000077"><tt>com.gkrueger.app</tt></font>
und die Klasse <font color="#000077"><tt>Logger</tt></font> im Paket
<font color="#000077"><tt>com.gkrueger.util</tt></font>. Ausgehend
vom Basisverzeichnis, liegen die Klassendateien also in den Unterverzeichnissen
<font color="#660099">com\gkrueger\app</font> und <font color="#660099">com\gkrueger\util</font>.
Die <a href="index_m.html#ixb100150"><font color=#000080><tt>main</tt></font></a>-Methode
befindet sich in der Klasse <font color="#000077"><tt>App</tt></font>.
Soll das Programm auf dem Zielsystem beispielsweise im Verzeichnis
<font color="#660099">c:\gkapp</font> installiert werden, müssen
die drei Dateien wie folgt kopiert werden:
<ul>
<li><font color="#660099">App.class</font> nach <font color="#660099">c:\gkapp\com\gkrueger\app</font>
<li><font color="#660099">AppFrame.class</font> nach <font color="#660099">c:\gkapp\com\gkrueger\app</font>
<li><font color="#660099">Logger.class</font> nach <font color="#660099">c:\gkapp\com\gkrueger\util</font>
</ul>
<p>
Das Programm kann dann aus dem Installationsverzeichnis <font color="#660099">c:\gkapp</font>
durch Angabe des qualifizierten Klassennamens gestartet werden:
<font color="#333300">
<pre>
java com.gkrueger.app.App
</pre>
</font>
<p>
Voraussetzung zum Starten der Applikation ist, dass der Klassenpfad
korrekt gesetzt ist. Soll das Programm stets aus dem Installationsverzeichnis
heraus gestartet werden, muss das aktuelle Verzeichnis ».«
im <a href="index_c.html#ixb100143"><font color=#000080><tt>CLASSPATH</tt></font></a>
enthalten sein (alternativ kann seit dem JDK 1.2 auch gar kein Klassenpfad
gesetzt sein). Soll das Programm von beliebiger Stelle aus gestartet
werden können, muss der Pfad des Installationsverzeichnisses
<font color="#660099">c:\gkapp</font> in den Klassenpfad aufgenommen
werden. Dazu kann entweder die Umgebungsvariable <a href="index_c.html#ixb100143"><font color=#000080><tt>CLASSPATH</tt></font></a>
modifiziert oder der gewünschte Klassenpfad mit einer der Optionen
<a name="ixa100828"><a href="index_0.html#ixb100182"><font color=#000080><tt>-cp</tt></font></a></a>
oder <a name="ixa100829"><a href="index_0.html#ixb100183"><font color=#000080><tt>-classpath</tt></font></a></a>
an den Java-Interpreter übergeben werden. Dafür wäre
beispielsweise folgender Aufruf geeignet:
<font color="#333300">
<pre>
java -cp c:\gkapp com.gkrueger.app.App
</pre>
</font>
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100%>
<tr>
<td width=1 align=left valign=top bgcolor="#000077"><img src="trp1_1.gif"></td>
<td><img src="trp1_1.gif" width=2></td>
<td valign=top width=1000>
<p>
Die Variante, bei der die Umgebungsvariable unverändert bleibt,
ist natürlich die bessere, denn Modifikationen an Umgebungsvariablen
beeinflussen möglicherweise auch andere Programme. Zudem hat
die explizite und präzise Übergabe des Klassenpfades an
den Interpreter den Vorteil, dass nicht versehentlich weitere Verzeichnisse
im Klassenpfad enthalten sind und unerwünschte Nebeneffekte verursachen
können.</td>
<td><img src="trp1_1.gif" width=2></td>
<td valign=top>
<table border=0 cellspacing=0 cellpadding=1 width=100% bgcolor="#000077">
<tr>
<td><font color="#FFFFFF"> Hinweis </font></td>
</tr>
</table>
</td>
<td width=1 align=left valign=top bgcolor="#000077"><img src="trp1_1.gif"></td>
</tr>
</table>
<!-- Section -->
<a name="subsectionclasspath"></a>
<h4>Verwendung eines jar-Archivs </h4>
<p>
Noch einfacher wird die Installation, wenn anstelle der verschiedenen
Klassendateien eine einzelne jar-Datei ausgeliefert wird. Auf dem
Zielsystem spielt es dann keine Rolle mehr, aus welchem Verzeichnis
heraus die Applikation aufgerufen wird und wie die <a href="index_c.html#ixb100143"><font color=#000080><tt>CLASSPATH</tt></font></a>-Variable
gesetzt ist. Weitere Hinweise zur Anwendung des jar-Programms finden
sich in <a href="k100323.html#jarwerkzeug">Abschnitt 51.6</a>. Dort
wird auch erläutert, wie <i>Applets</i> in jar-Dateien ausgeliefert
werden können.
<p>
Angenommen, das Basisverzeichnis für die Programmentwicklung
auf der Quellmaschine ist <font color="#660099">c:\prog\java</font>
und die Klassendateien liegen in den Verzeichnissen <font color="#660099">c:\prog\java\com\gkrueger\app</font>
und <font color="#660099">c:\prog\java\com\gkrueger\util</font>. Um
eine jar-Datei zu unserem Beispielprojekt zu erstellen, ist aus dem
Entwicklungsverzeichnis <font color="#660099">c:\prog\java</font>
heraus folgendes <a href="index_j.html#ixb100146"><font color=#000080><tt>jar</tt></font></a>-Kommando
abzusetzen:
<font color="#333300">
<pre>
jar cvf myapp.jar com
</pre>
</font>
<p>
Dadurch werden alle Dateien aus dem Unterverzeichnis <font color="#660099">com</font>
und allen darin enthaltenen Unterverzeichnissen unter Beibehaltung
der Verzeichnishierarchie in die jar-Datei <font color="#660099">myapp.jar</font>
kopiert. Um das Programm auf der Zielmaschine aufzurufen, reicht es
aus, <font color="#660099">myapp.jar</font> an eine beliebige Stelle
zu kopieren und den Java-Interpreter wie folgt zu starten:
<font color="#333300">
<pre>
java -cp myapp.jar com.gkrueger.app.App
</pre>
</font>
<p>
Anstelle des Unterverzeichnisses mit den Klassendateien haben wir
nun die jar-Datei im Klassenpfad angegeben. Für den Interpreter
sind beide Varianten gleichwertig und er wird das Programm in der
gleichen Weise wie zuvor starten. Vorteilhaft an dieser Vorgehensweise
ist, dass auf der Zielmaschine nur noch eine einzige Datei benötigt
wird und nicht mehr ein ganzes System von Verzeichnissen und Unterverzeichnissen
wie zuvor. Das vereinfacht nicht nur die Installation, sondern erhöht
auch ihre Haltbarkeit, denn einzelne Dateien können nicht mehr
überschrieben werden oder verlorengehen.
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100%>
<tr>
<td width=1 align=left valign=top bgcolor="#CC0000"><img src="trp1_1.gif"></td>
<td><img src="trp1_1.gif" width=1></td>
<td width=1 align=left valign=top bgcolor="#CC0000"><img src="trp1_1.gif"></td>
<td><img src="trp1_1.gif" width=2></td>
<td valign=top width=1000>
<p>
Das oben beschriebene jar-Kommando kopiert <i>alle</i> Dateien aus
dem <font color="#660099">com</font>-Unterverzeichnis und den darin
enthaltenen Unterverzeichnissen in die jar-Datei. Dazu zählen
natürlich auch die Quelldateien, sofern sie in denselben Verzeichnissen
liegen. Da diese aber meist nicht mit ausgeliefert werden sollen,
empfiehlt es sich, entweder die Klassendateien (unter Beibehaltung
der Unterverzeichnisstruktur) zuvor in ein leeres Verzeichnis zu kopieren
und das jar-Kommando von dort aus zu starten. Oder die Klassendateien
werden schon bei der Entwicklung von den Quelltexten getrennt, indem
beim Kompilieren die Option <a name="ixa100830"><a href="index_0.html#ixb100634"><font color=#000080><tt>-d</tt></font></a></a>
verwendet wird.</td>
<td><img src="trp1_1.gif" width=2></td>
<td valign=top>
<table border=0 cellspacing=0 cellpadding=1 width=100% bgcolor="#CC0000">
<tr>
<td><font color="#FFFFFF"> Warnung </font></td>
</tr>
</table>
</td>
<td width=1 align=left valign=top bgcolor="#CC0000"><img src="trp1_1.gif"></td>
</tr>
</table>
<!-- Section -->
<a name="sectlevel4id013004001003"></a>
<h4>Ausführbare jar-Archive </h4>
<p>
Wir können sogar noch einen Schritt weitergehen und die jar-Datei
selbst »ausführbar« machen. Dazu müssen wir eine
<a name="ixa100831"><i>Manifest-Datei</i></a> erstellen, in der der
Name der Klasse angegeben wird, die die <a href="index_m.html#ixb100150"><font color=#000080><tt>main</tt></font></a>-Methode
enthält. Anschließend läßt sich die jar-Datei
mit der Option <a name="ixa100832"><a href="index_0.html#ixb100636"><font color=#000080><tt>-jar</tt></font></a></a>
des Interpreters ohne explizite Angabe der Hauptklasse starten.
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100%>
<tr>
<td width=1 align=left valign=top bgcolor="#000077"><img src="trp1_1.gif"></td>
<td><img src="trp1_1.gif" width=2></td>
<td valign=top width=1000>
<p>
Die <a name="ixa100831">Manifest-Datei</a> ist eine Hilfsdatei mit
Informationen über den Inhalt der jar-Datei. Sie hat den Namen
<font color="#660099">manifest.mf</font> und liegt im Unterverzeichnis
<font color="#660099">meta-inf</font> des jar-Archivs<a name="ixa100833"></a>.
Die Manifest-Datei kann mit einem normalen Texteditor erstellt und
mit Hilfe der Option »m« in das jar-Archiv eingebunden werden.
In unserem Fall muss sie lediglich einen Eintrag <a name="ixa100834"><a href="index_m.html#ixb100638"><font color=#000080><tt>Main-Class</tt></font></a></a>
enthalten. Weitere Informationen zu Manifest-Dateien finden sich in
<a href="k100282.html#integrationbeans">Abschnitt 44.3.3</a> bei der
Beschreibung der Java-Beans-Architektur.</td>
<td><img src="trp1_1.gif" width=2></td>
<td valign=top>
<table border=0 cellspacing=0 cellpadding=1 width=100% bgcolor="#000077">
<tr>
<td><font color="#FFFFFF"> Hinweis </font></td>
</tr>
</table>
</td>
<td width=1 align=left valign=top bgcolor="#000077"><img src="trp1_1.gif"></td>
</tr>
</table>
<p>
Wir erstellen also zunächst eine Textdatei <font color="#660099">manifest.txt</font>
mit folgendem Inhalt (bitte mit einer Zeilenschaltung abschließen,
sonst wird die Manifest-Datei nicht korrekt erstellt):
<font color="#000077">
<pre>
Main-Class: com.gkrueger.app.App
</pre>
</font>
<p>
Nun kann das jar-Archiv erzeugt und die Manifest-Datei einbezogen
werden:
<font color="#333300">
<pre>
jar cvfm myapp.jar manifest.txt com
</pre>
</font>
<p>
Dieses Archiv kann nun mit Hilfe der Option <a href="index_0.html#ixb100636"><font color=#000080><tt>-jar</tt></font></a>
ohne Angabe des Klassennamens gestartet werden:
<font color="#333300">
<pre>
java -jar myapp.jar
</pre>
</font>
<p>
Auch jetzt verhält sich das Programm genauso wie in den beiden
zuvor beschriebenen Beispielen. Diese Variante ist vor allem nützlich,
wenn die komplette Applikation in einem einzigen jar-Archiv ausgeliefert
wird und nur eine einzige <a href="index_m.html#ixb100150"><font color=#000080><tt>main</tt></font></a>-Methode
enthält. Sie bietet sich beispielsweise für kleinere Programme,
Beispiel- oder Testapplikationen an (die Demos des JDK sind beispielsweise
in derartigen jar-Dateien untergebracht). Ist die Konfiguration dagegen
komplizierter oder gibt es mehr als eine lauffähige Applikation
in der jar-Datei, sollte der zuvor beschriebenen Variante der Vorzug
gegeben werden.
<!-- Section -->
<a name="sectlevel3id013004002"></a>
<h3>13.4.2 Einbinden von Ressourcen-Dateien </h3>
<p>
Wie eingangs erwähnt, benötigt ein Programm neben den Klassendateien
meist weitere Dateien mit zusätzlichen Informationen. Wird auf
diese ausschließlich lesend zugegriffen, wollen wir sie als
<a name="ixa100835"><i>Ressourcen-Dateien</i></a> bezeichnen, also
als Dateien, die dem Programm neben den Klassendateien als zusätzliche
Informationslieferanten zur Laufzeit zur Verfügung stehen. Die
Ressourcen-Dateien könnten zwar als separate Dateien ausgeliefert
und mit den Klassen zur Dateiverarbeitung eingelesen werden (diese
werden ab <a href="k100120.html#kapitelcharacterstreams">Kapitel 18</a>
vorgestellt). Das hätte jedoch den Nachteil, dass sich nicht
mehr alle benötigten Dateien in einem jar-Archiv befinden würden
und die Auslieferung dadurch verkompliziert würde.
<p>
Glücklicherweise gibt es im JDK die Möglichkeit, auch Ressourcen-Dateien
in jar-Archiven unterzubringen und zur Laufzeit daraus einzulesen.
Mit dem Klassenlader steht das dafür erforderliche Werkzeug allen
Java-Programmen standardmäßig zur Verfügung. Während
der Klassenlader normalerweise von der virtuellen Maschine dazu verwendet
wird, Klassendateien einzulesen, kann er von der Anwendung zum Einlesen
beliebiger Dateien zweckentfremdet werden. Einzige Bedingung ist,
dass die Ressourcen-Dateien in einem Verzeichnis stehen, das vom Klassenlader
erreicht werden kann, das also innerhalb des Klassenpfades liegt.
<p>
Dazu kann beispielsweise im Basisverzeichnis der Anwendung ein Unterverzeichnis
<font color="#660099">resources</font> angelegt und die Ressourcen-Dateien
dort hineinkopiert werden. In unserem Fall würden wir also ein
Unterverzeichnis <font color="#660099">com.gkrueger.resources</font>
anlegen. Mit Hilfe der Methode <a name="ixa100836"><a href="index_g.html#ixb100640"><font color=#000080><tt>getResourceAsStream</tt></font></a></a>
der Klasse <a name="ixa100837"><a href="index_c.html#ixb100641"><font color=#000080><tt>Class</tt></font></a></a>
(siehe <a href="k100273.html#dieklasseclass">Abschnitt 43.2.2</a>)
kann ein <a href="index_i.html#ixb100642"><font color=#000080><tt>InputStream</tt></font></a>
beschafft werden, mit dem die Datei Byte für Byte eingelesen
werden kann:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public InputStream getResourceAsStream(String name)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/java/lang/Class.html" onClick="this.href=getApiDoc('java.lang.Class')"><font color="#660066" size=-1>java.lang.Class</font></a></td>
</tr>
</table>
<p>
Als Parameter wird der vollständige Name der Ressourcen-Datei
angegeben, allerdings unter Beachtung einiger Besonderheiten. Zunächst
werden die einzelnen Paketnamen nicht wie gewohnt durch Punkte, sondern
durch Schrägstriche »/« voneinander getrennt (auch
unter Windows wird dazu nicht der Backslash verwendet). Nur die Dateierweiterung
wird wie üblich hinter einem Punkt angegeben. Zudem muss als
erstes Zeichen ebenfalls ein Schrägstrich angegeben werden. Soll
also beispielsweise die Datei <font color="#660099">hello.txt</font>
aus dem Ressourcenverzeichnis geladen werden, so lautet der an <a href="index_g.html#ixb100640"><font color=#000080><tt>getResourceAsStream</tt></font></a>
zu übergebende Dateiname <font color="#660099">/com/gkrueger/resources/hello.txt</font>.
<p>
Das folgende Listing zeigt eine einfache Methode, in der die angesprochenen
Regeln implementiert werden. Sie beschafft zu einer beliebigen Datei,
die sich in einem vorgegebenen Ressource-Verzeichnis befindet, das
innerhalb des Klassenpfades liegt, einen <a href="index_i.html#ixb100642"><font color=#000080><tt>InputStream</tt></font></a>,
mit dem die darin enthaltenen Daten eingelesen werden können:
<a name="listingid013007"></a>
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#DDDDDD">
<tr>
<td valign=top>
<font color="#000055">
<pre>
<font color="#555555">001 </font><font color="#0000AA">private</font> InputStream getResourceStream(String pkgname, String fname)
<font color="#555555">002 </font>{
<font color="#555555">003 </font> String resname = <font color="#0000FF">"/"</font> + pkgname.replace(<font color="#0000FF">'.'</font>, <font color="#0000FF">'/'</font>) + <font color="#0000FF">"/"</font> + fname;
<font color="#555555">004 </font> Class clazz = getClass();
<font color="#555555">005 </font> InputStream is = clazz.getResourceAsStream(resname);
<font color="#555555">006 </font> <font color="#0000AA">return</font> is;
<font color="#555555">007 </font>}</pre>
</font>
</td>
</tr>
</table>
<i>
Listing 13.7: Einen InputStream zu einer Ressourcen-Datei beschaffen</i></p>
<p>
Als Argument wird der Paketname (in Punktnotation) und der Name der
Ressourcen-Datei angegeben. Den obigen Regeln entsprechend werden
beide in einen Ressourcen-Namen umgewandelt und an <a href="index_g.html#ixb100640"><font color=#000080><tt>getResourceAsStream</tt></font></a>
übergeben. Diese liefert einen <a href="index_i.html#ixb100642"><font color=#000080><tt>InputStream</tt></font></a>,
der zum Einlesen der Daten verwendet werden kann. Soll beispielsweise
eine Text-Ressource in einen <a href="index_s.html#ixb100117"><font color=#000080><tt>String</tt></font></a>
geladen werden, kann dazu folgende Methode verwendet werden:
<a name="listingid013008"></a>
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#DDDDDD">
<tr>
<td valign=top>
<font color="#000055">
<pre>
<font color="#555555">001 </font><font color="#00AA00">/* TestResource.inc */</font>
<font color="#555555">002 </font>
<font color="#555555">003 </font><font color="#0000AA">import</font> java.io.*;
<font color="#555555">004 </font><font color="#0000AA">import</font> java.awt.*;
<font color="#555555">005 </font>
<font color="#555555">006 </font><font color="#00AA00">//...</font>
<font color="#555555">007 </font>
<font color="#555555">008 </font><font color="#0000AA">public</font> String loadTextResource(String pkgname, String fname)
<font color="#555555">009 </font><font color="#0000AA">throws</font> IOException
<font color="#555555">010 </font>{
<font color="#555555">011 </font> String ret = <font color="#006699">null</font>;
<font color="#555555">012 </font> InputStream is = getResourceStream(pkgname, fname);
<font color="#555555">013 </font> <font color="#0000AA">if</font> (is != <font color="#006699">null</font>) {
<font color="#555555">014 </font> StringBuffer sb = <font color="#0000AA">new</font> StringBuffer();
<font color="#555555">015 </font> <font color="#0000AA">while</font> (<font color="#006699">true</font>) {
<font color="#555555">016 </font> <font color="#006699">int</font> c = is.read();
<font color="#555555">017 </font> <font color="#0000AA">if</font> (c == -1) {
<font color="#555555">018 </font> <font color="#0000AA">break</font>;
<font color="#555555">019 </font> }
<font color="#555555">020 </font> sb.append((<font color="#006699">char</font>)c);
<font color="#555555">021 </font> }
<font color="#555555">022 </font> is.close();
<font color="#555555">023 </font> ret = sb.toString();
<font color="#555555">024 </font> }
<font color="#555555">025 </font> <font color="#0000AA">return</font> ret;
<font color="#555555">026 </font>}
<font color="#555555">027 </font>
<font color="#555555">028 </font><font color="#00AA00">//...</pre>
</font>
</td>
<td valign=top align=right>
<a href="../examples/TestResource.inc"><font color="#000055" size=-1>TestResource.inc</font></a></td>
</tr>
</table>
<i>
Listing 13.8: Laden einer Text-Ressource</i></p>
<p>
Auch das Laden von <a href="index_i.html#ixb100643"><font color=#000080><tt>Image</tt></font></a>-Ressourcen
(Programm-Icons, Abbildungen etc.) kann auf ähnliche Weise realisiert
werden:
<a name="listingid013009"></a>
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#DDDDDD">
<tr>
<td valign=top>
<font color="#000055">
<pre>
<font color="#555555">001 </font><font color="#00AA00">/* ImageResource.inc */</font>
<font color="#555555">002 </font>
<font color="#555555">003 </font><font color="#0000AA">import</font> java.io.*;
<font color="#555555">004 </font><font color="#0000AA">import</font> java.awt.*;
<font color="#555555">005 </font>
<font color="#555555">006 </font><font color="#00AA00">//...</font>
<font color="#555555">007 </font>
<font color="#555555">008 </font><font color="#0000AA">public</font> Image loadImageResource(String pkgname, String fname)
<font color="#555555">009 </font><font color="#0000AA">throws</font> IOException
<font color="#555555">010 </font>{
<font color="#555555">011 </font> Image ret = <font color="#006699">null</font>;
<font color="#555555">012 </font> InputStream is = getResourceStream(pkgname, fname);
<font color="#555555">013 </font> <font color="#0000AA">if</font> (is != <font color="#006699">null</font>) {
<font color="#555555">014 </font> <font color="#006699">byte</font>[] buffer = <font color="#0000AA">new</font> <font color="#006699">byte</font>[0];
<font color="#555555">015 </font> <font color="#006699">byte</font>[] tmpbuf = <font color="#0000AA">new</font> <font color="#006699">byte</font>[1024];
<font color="#555555">016 </font> <font color="#0000AA">while</font> (<font color="#006699">true</font>) {
<font color="#555555">017 </font> <font color="#006699">int</font> len = is.read(tmpbuf);
<font color="#555555">018 </font> <font color="#0000AA">if</font> (len <= 0) {
<font color="#555555">019 </font> <font color="#0000AA">break</font>;
<font color="#555555">020 </font> }
<font color="#555555">021 </font> <font color="#006699">byte</font>[] newbuf = <font color="#0000AA">new</font> <font color="#006699">byte</font>[buffer.length + len];
<font color="#555555">022 </font> System.arraycopy(buffer, 0, newbuf, 0, buffer.length);
<font color="#555555">023 </font> System.arraycopy(tmpbuf, 0, newbuf, buffer.length, len);
<font color="#555555">024 </font> buffer = newbuf;
<font color="#555555">025 </font> }
<font color="#555555">026 </font> <font color="#00AA00">//create image</font>
<font color="#555555">027 </font> ret = Toolkit.getDefaultToolkit().createImage(buffer);
<font color="#555555">028 </font> is.close();
<font color="#555555">029 </font> }
<font color="#555555">030 </font> <font color="#0000AA">return</font> ret;
<font color="#555555">031 </font>}
<font color="#555555">032 </font>
<font color="#555555">033 </font><font color="#00AA00">//...</pre>
</font>
</td>
<td valign=top align=right>
<a href="../examples/ImageResource.inc"><font color="#000055" size=-1>ImageResource.inc</font></a></td>
</tr>
</table>
<i>
Listing 13.9: Laden einer Image-Ressource</i></p>
<p>
Voraussetzung ist natürlich, dass das Format der in den Puffer
<font color="#000077"><tt>buffer</tt></font> eingelesenen Datei von
der Methode <a name="ixa100838"><a href="index_c.html#ixb100644"><font color=#000080><tt>createImage</tt></font></a></a>
verstanden wird. Beispiele für gültige Formate sind GIF
oder JPEG.
<p>
Der große Vorteil bei dieser Vorgehensweise ist, dass sie sowohl
mit separaten Klassendateien funktioniert, als auch, wenn die komplette
Applikation inklusive der Ressourcen-Dateien innerhalb einer einzigen
jar-Datei ausgeliefert wird. Für die Anwendung selbst ist es
vollkommen gleichgültig, aus welcher Quelle die Dateien stammen.
<hr>
<table border=0 cellpadding=0 cellspacing=1 width="100%">
<tr bgcolor="#EEFFCC">
<td width="7%" align=center bgcolor="#DDCC99"><a href="cover.html"> Titel </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100003.html"> Inhalt </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="search.html"> Suchen </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="index.html"> Index </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="../jdkdocs/index.html" onClick="this.href=getDocIndex()"> DOC </a>
<td align="right">Handbuch der Java-Programmierung, 5. Auflage, Addison
Wesley, Version 5.0.1
<tr bgcolor="#EEFFCC">
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100083.html"> << </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100086.html"> < </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100088.html"> > </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100090.html"> >> </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="../jdkdocs/api/index.html" onClick="this.href=getApiIndex()"> API </a>
<td align="right">© 1998, 2007 Guido Krüger & Thomas
Stark, <a href="http://www.javabuch.de">http://www.javabuch.de</a>
</table>
<a name="endofbody"></a>
</body>
</html>
|
