aboutsummaryrefslogtreecommitdiff
path: root/libjava/classpath/lib/java/util/Timer$TaskQueue.class
blob: 9d1786b483a9373d72c4dd58ffa6e66243db657e (plain)
ofshex dumpascii
0000 ca fe ba be 00 00 00 31 00 63 07 00 02 01 00 19 6a 61 76 61 2f 75 74 69 6c 2f 54 69 6d 65 72 24 .......1.c......java/util/Timer$
0020 54 61 73 6b 51 75 65 75 65 07 00 04 01 00 10 6a 61 76 61 2f 6c 61 6e 67 2f 4f 62 6a 65 63 74 01 TaskQueue......java/lang/Object.
0040 00 0c 44 45 46 41 55 4c 54 5f 53 49 5a 45 01 00 01 49 01 00 0d 43 6f 6e 73 74 61 6e 74 56 61 6c ..DEFAULT_SIZE...I...ConstantVal
0060 75 65 03 00 00 00 20 01 00 0b 6e 75 6c 6c 4f 6e 45 6d 70 74 79 01 00 01 5a 01 00 04 68 65 61 70 ue........nullOnEmpty...Z...heap
0080 01 00 16 5b 4c 6a 61 76 61 2f 75 74 69 6c 2f 54 69 6d 65 72 54 61 73 6b 3b 01 00 08 65 6c 65 6d ...[Ljava/util/TimerTask;...elem
00a0 65 6e 74 73 01 00 06 3c 69 6e 69 74 3e 01 00 03 28 29 56 01 00 04 43 6f 64 65 0a 00 03 00 12 0c ents...<init>...()V...Code......
00c0 00 0e 00 0f 07 00 14 01 00 13 6a 61 76 61 2f 75 74 69 6c 2f 54 69 6d 65 72 54 61 73 6b 09 00 01 ..........java/util/TimerTask...
00e0 00 16 0c 00 0b 00 0c 09 00 01 00 18 0c 00 0d 00 06 09 00 01 00 1a 0c 00 09 00 0a 01 00 0f 4c 69 ..............................Li
0100 6e 65 4e 75 6d 62 65 72 54 61 62 6c 65 01 00 12 4c 6f 63 61 6c 56 61 72 69 61 62 6c 65 54 61 62 neNumberTable...LocalVariableTab
0120 6c 65 01 00 04 74 68 69 73 01 00 1b 4c 6a 61 76 61 2f 75 74 69 6c 2f 54 69 6d 65 72 24 54 61 73 le...this...Ljava/util/Timer$Tas
0140 6b 51 75 65 75 65 3b 01 00 03 61 64 64 01 00 18 28 4c 6a 61 76 61 2f 75 74 69 6c 2f 54 69 6d 65 kQueue;...add...(Ljava/util/Time
0160 72 54 61 73 6b 3b 29 56 0a 00 22 00 24 07 00 23 01 00 10 6a 61 76 61 2f 6c 61 6e 67 2f 53 79 73 rTask;)V..".$..#...java/lang/Sys
0180 74 65 6d 0c 00 25 00 26 01 00 09 61 72 72 61 79 63 6f 70 79 01 00 2a 28 4c 6a 61 76 61 2f 6c 61 tem..%.&...arraycopy..*(Ljava/la
01a0 6e 67 2f 4f 62 6a 65 63 74 3b 49 4c 6a 61 76 61 2f 6c 61 6e 67 2f 4f 62 6a 65 63 74 3b 49 49 29 ng/Object;ILjava/lang/Object;II)
01c0 56 01 00 04 74 61 73 6b 01 00 15 4c 6a 61 76 61 2f 75 74 69 6c 2f 54 69 6d 65 72 54 61 73 6b 3b V...task...Ljava/util/TimerTask;
01e0 01 00 08 6e 65 77 5f 68 65 61 70 01 00 06 72 65 6d 6f 76 65 01 00 07 65 6e 71 75 65 75 65 07 00 ...new_heap...remove...enqueue..
0200 2d 01 00 1f 6a 61 76 61 2f 6c 61 6e 67 2f 49 6c 6c 65 67 61 6c 53 74 61 74 65 45 78 63 65 70 74 -...java/lang/IllegalStateExcept
0220 69 6f 6e 08 00 2f 01 00 33 63 61 6e 6e 6f 74 20 65 6e 71 75 65 75 65 20 77 68 65 6e 20 73 74 6f ion../..3cannot.enqueue.when.sto
0240 70 28 29 20 68 61 73 20 62 65 65 6e 20 63 61 6c 6c 65 64 20 6f 6e 20 71 75 65 75 65 0a 00 2c 00 p().has.been.called.on.queue..,.
0260 31 0c 00 0e 00 32 01 00 15 28 4c 6a 61 76 61 2f 6c 61 6e 67 2f 53 74 72 69 6e 67 3b 29 56 0a 00 1....2...(Ljava/lang/String;)V..
0280 01 00 34 0c 00 1f 00 20 09 00 13 00 36 0c 00 37 00 38 01 00 09 73 63 68 65 64 75 6c 65 64 01 00 ..4.........6..7.8...scheduled..
02a0 01 4a 0a 00 03 00 3a 0c 00 3b 00 0f 01 00 06 6e 6f 74 69 66 79 01 00 05 63 68 69 6c 64 01 00 06 .J....:..;.....notify...child...
02c0 70 61 72 65 6e 74 01 00 03 74 6f 70 01 00 17 28 29 4c 6a 61 76 61 2f 75 74 69 6c 2f 54 69 6d 65 parent...top...()Ljava/util/Time
02e0 72 54 61 73 6b 3b 01 00 05 73 65 72 76 65 0a 00 01 00 42 0c 00 3e 00 3f 0a 00 22 00 44 0c 00 45 rTask;...serve....B..>.?..".D..E
0300 00 46 01 00 11 63 75 72 72 65 6e 74 54 69 6d 65 4d 69 6c 6c 69 73 01 00 03 28 29 4a 0a 00 03 00 .F...currentTimeMillis...()J....
0320 48 0c 00 49 00 4a 01 00 04 77 61 69 74 01 00 04 28 4a 29 56 0a 00 03 00 4c 0c 00 49 00 0f 0a 00 H..I.J...wait...(J)V....L..I....
0340 01 00 4e 0c 00 2a 00 0f 07 00 50 01 00 1e 6a 61 76 61 2f 6c 61 6e 67 2f 49 6e 74 65 72 72 75 70 ..N..*....P...java/lang/Interrup
0360 74 65 64 45 78 63 65 70 74 69 6f 6e 01 00 04 74 69 6d 65 01 00 08 6c 61 73 74 54 61 73 6b 01 00 tedException...time...lastTask..
0380 0e 73 65 74 4e 75 6c 6c 4f 6e 45 6d 70 74 79 01 00 04 28 5a 29 56 01 00 04 73 74 6f 70 01 00 05 .setNullOnEmpty...(Z)V...stop...
03a0 70 75 72 67 65 01 00 03 28 29 49 01 00 07 72 65 6d 6f 76 65 64 01 00 01 69 01 00 05 69 6e 64 65 purge...()I...removed...i...inde
03c0 78 01 00 06 6e 65 77 4c 65 6e 01 00 07 6e 65 77 48 65 61 70 01 00 0a 53 6f 75 72 63 65 46 69 6c x...newLen...newHeap...SourceFil
03e0 65 01 00 0a 54 69 6d 65 72 2e 6a 61 76 61 01 00 0c 49 6e 6e 65 72 43 6c 61 73 73 65 73 07 00 61 e...Timer.java...InnerClasses..a
0400 01 00 0f 6a 61 76 61 2f 75 74 69 6c 2f 54 69 6d 65 72 01 00 09 54 61 73 6b 51 75 65 75 65 00 30 ...java/util/Timer...TaskQueue.0
0420 00 01 00 03 00 00 00 04 00 1a 00 05 00 06 00 01 00 07 00 00 00 02 00 08 00 02 00 09 00 0a 00 00 ................................
0440 00 02 00 0b 00 0c 00 00 00 02 00 0d 00 06 00 00 00 09 00 01 00 0e 00 0f 00 01 00 10 00 00 00 52 ...............................R
0460 00 02 00 01 00 00 00 18 2a b7 00 11 2a 10 20 bd 00 13 b5 00 15 2a 03 b5 00 17 2a 03 b5 00 19 b1 ........*...*........*....*.....
0480 00 00 00 02 00 1b 00 00 00 16 00 05 00 00 00 63 00 04 00 65 00 0d 00 66 00 12 00 67 00 17 00 68 ...............c...e...f...g...h
04a0 00 1c 00 00 00 0c 00 01 00 00 00 18 00 1d 00 1e 00 00 00 02 00 1f 00 20 00 01 00 10 00 00 00 96 ................................
04c0 00 05 00 03 00 00 00 40 2a 59 b4 00 17 04 60 b5 00 17 2a b4 00 17 2a b4 00 15 be a0 00 22 2a b4 .......@*Y....`...*...*......"*.
04e0 00 15 be 05 68 bd 00 13 4d 2a b4 00 15 03 2c 03 2a b4 00 15 be b8 00 21 2a 2c b5 00 15 2a b4 00 ....h...M*....,.*......!*,...*..
0500 15 2a b4 00 17 2b 53 b1 00 00 00 02 00 1b 00 00 00 1e 00 07 00 00 00 70 00 0a 00 71 00 16 00 73 .*...+S................p...q...s
0520 00 21 00 74 00 30 00 75 00 35 00 77 00 3f 00 78 00 1c 00 00 00 20 00 03 00 00 00 40 00 1d 00 1e .!.t.0.u.5.w.?.x...........@....
0540 00 00 00 00 00 40 00 27 00 28 00 01 00 21 00 14 00 29 00 0c 00 02 00 02 00 2a 00 0f 00 01 00 10 .....@.'.(...!...).......*......
0560 00 00 00 92 00 06 00 02 00 00 00 46 2a b4 00 15 2a b4 00 17 01 53 2a 59 b4 00 17 04 64 b5 00 17 ...........F*...*....S*Y....d...
0580 2a b4 00 17 10 10 60 2a b4 00 15 be 07 6c a3 00 23 2a b4 00 15 be 05 6c bd 00 13 4c 2a b4 00 15 *.....`*.....l..#*.....l...L*...
05a0 03 2b 03 2a b4 00 17 04 60 b8 00 21 2a 2b b5 00 15 b1 00 00 00 02 00 1b 00 00 00 1e 00 07 00 00 .+.*....`..!*+..................
05c0 00 82 00 0a 00 83 00 14 00 84 00 25 00 86 00 30 00 87 00 40 00 88 00 45 00 8a 00 1c 00 00 00 16 ...........%...0...@...E........
05e0 00 02 00 00 00 46 00 1d 00 1e 00 00 00 30 00 15 00 29 00 0c 00 01 00 21 00 2b 00 20 00 01 00 10 .....F.......0...).....!.+......
0600 00 00 00 e7 00 04 00 04 00 00 00 5f 2a b4 00 15 c7 00 0d bb 00 2c 59 12 2e b7 00 30 bf 2a b4 00 ..........._*........,Y....0.*..
0620 15 03 2b 53 2a 2b b7 00 33 2a b4 00 17 3d 1c 05 6c 3e a7 00 15 2a b4 00 15 1c 2a b4 00 15 1d 32 ..+S*+..3*...=..l>...*....*....2
0640 53 1d 3d 1c 05 6c 3e 2a b4 00 15 1d 32 b4 00 35 2b b4 00 35 94 9d ff e0 2a b4 00 15 1c 2b 53 2a S.=..l>*....2..5+..5....*....+S*
0660 b4 00 15 03 01 53 2a b6 00 39 b1 00 00 00 02 00 1b 00 00 00 46 00 11 00 00 00 93 00 07 00 95 00 .....S*..9..........F...........
0680 0b 00 96 00 0d 00 95 00 11 00 99 00 18 00 9a 00 1d 00 9c 00 22 00 9d 00 26 00 9e 00 29 00 a0 00 ...................."...&...)...
06a0 35 00 a1 00 37 00 a2 00 3b 00 9e 00 4c 00 a5 00 53 00 a6 00 5a 00 a8 00 5e 00 a9 00 1c 00 00 00 5...7...;...L...S...Z...^.......
06c0 2a 00 04 00 00 00 5f 00 1d 00 1e 00 00 00 00 00 5f 00 27 00 28 00 01 00 22 00 3d 00 3c 00 06 00 *....._........._.'.(...".=.<...
06e0 02 00 26 00 39 00 3d 00 06 00 03 00 02 00 3e 00 3f 00 01 00 10 00 00 00 42 00 02 00 01 00 00 00 ..&.9.=.......>.?.......B.......
0700 10 2a b4 00 17 9a 00 05 01 b0 2a b4 00 15 04 32 b0 00 00 00 02 00 1b 00 00 00 0e 00 03 00 00 00 .*........*....2................
0720 b1 00 07 00 b3 00 09 00 b7 00 1c 00 00 00 0c 00 01 00 00 00 10 00 1d 00 1e 00 00 00 21 00 40 00 ............................!.@.
0740 3f 00 01 00 10 00 00 01 ae 00 05 00 05 00 00 00 ca 01 4c a7 00 45 2a b7 00 41 4c 2a b4 00 15 c6 ?.................L..E*..AL*....
0760 00 0e 2b c7 00 0c 2a b4 00 19 99 00 05 01 b0 2b c6 00 20 2b b4 00 35 b8 00 43 65 41 20 09 94 9e ..+...*........+...+..5..CeA....
0780 00 19 01 4c 2a 20 b6 00 47 a7 00 0f 57 a7 00 0b 2a b6 00 4b a7 00 04 57 2b c6 ff bd 2a b4 00 15 ...L*...G...W...*..K...W+...*...
07a0 2a b4 00 17 32 4d 2a b7 00 4d 04 3e 05 36 04 2a b4 00 15 04 2c 53 a7 00 53 15 04 2a b4 00 17 a2 *...2M*..M.>.6.*....,S..S..*....
07c0 00 20 2a b4 00 15 15 04 32 b4 00 35 2a b4 00 15 15 04 04 60 32 b4 00 35 94 9e 00 06 84 04 01 2c ..*.....2..5*......`2..5.......,
07e0 b4 00 35 2a b4 00 15 15 04 32 b4 00 35 94 9d 00 06 a7 00 21 2a b4 00 15 1d 2a b4 00 15 15 04 32 ..5*.....2..5......!*....*.....2
0800 53 15 04 3e 1d 05 68 36 04 15 04 2a b4 00 17 a4 ff aa 2a b4 00 15 1d 2c 53 2b b0 00 02 00 33 00 S..>..h6...*......*....,S+....3.
0820 38 00 3b 00 4f 00 3f 00 43 00 46 00 4f 00 02 00 1b 00 00 00 7e 00 1f 00 00 00 c3 00 02 00 c5 00 8.;.O.?.C.F.O.......~...........
0840 05 00 c8 00 0a 00 cc 00 1c 00 ce 00 1e 00 d2 00 22 00 d5 00 2b 00 d6 00 31 00 db 00 33 00 de 00 ................"...+...1...3...
0860 3b 00 e0 00 3f 00 eb 00 46 00 ed 00 47 00 c5 00 4b 00 f4 00 55 00 f5 00 59 00 f8 00 5b 00 f9 00 ;...?...F...G...K...U...Y...[...
0880 5e 00 fa 00 65 00 fb 00 68 00 fd 00 71 00 ff 00 8b 01 01 00 8e 01 05 00 a0 01 06 00 a3 01 08 00 ^...e...h...q...................
08a0 b0 01 09 00 b3 01 0a 00 b8 00 fb 00 c1 01 0e 00 c8 01 11 00 1c 00 00 00 3e 00 06 00 00 00 ca 00 ........................>.......
08c0 1d 00 1e 00 00 00 02 00 c8 00 27 00 28 00 01 00 2b 00 14 00 51 00 38 00 02 00 55 00 75 00 52 00 ..........'.(...+...Q.8...U.u.R.
08e0 28 00 02 00 5b 00 6f 00 3d 00 06 00 03 00 5e 00 6c 00 3c 00 06 00 04 00 21 00 53 00 54 00 01 00 (...[.o.=.....^.l.<.....!.S.T...
0900 10 00 00 00 46 00 02 00 02 00 00 00 0a 2a 1b b5 00 19 2a b6 00 39 b1 00 00 00 02 00 1b 00 00 00 ....F........*....*..9..........
0920 0e 00 03 00 00 01 1c 00 05 01 1d 00 09 01 1e 00 1c 00 00 00 16 00 02 00 00 00 0a 00 1d 00 1e 00 ................................
0940 00 00 00 00 0a 00 09 00 0a 00 01 00 21 00 55 00 0f 00 01 00 10 00 00 00 45 00 02 00 01 00 00 00 ............!.U.........E.......
0960 0f 2a 01 b5 00 15 2a 03 b5 00 17 2a b6 00 39 b1 00 00 00 02 00 1b 00 00 00 12 00 04 00 00 01 27 .*....*....*..9................'
0980 00 05 01 28 00 0a 01 29 00 0e 01 2a 00 1c 00 00 00 0c 00 01 00 00 00 0f 00 1d 00 1e 00 00 00 21 ...(...)...*...................!
09a0 00 56 00 57 00 01 00 10 00 00 01 ab 00 06 00 05 00 00 00 d9 03 3c 2a b4 00 17 3d a7 00 8d 2a b4 .V.W.................<*...=...*.
09c0 00 15 1c 32 b4 00 35 09 94 9c 00 7c 84 01 01 1c 3e a7 00 6b 05 1d 68 36 04 15 04 2a b4 00 15 be ...2..5....|....>..k..h6...*....
09e0 a1 00 0d 2a b4 00 15 1d 01 53 a7 00 5b 15 04 04 60 2a b4 00 15 be a2 00 36 2a b4 00 15 15 04 04 ...*.....S..[...`*......6*......
0a00 60 32 c6 00 2a 2a b4 00 15 15 04 32 c6 00 1d 2a b4 00 15 15 04 32 b4 00 35 2a b4 00 15 15 04 04 `2..**.....2...*.....2..5*......
0a20 60 32 b4 00 35 94 9e 00 06 84 04 01 2a b4 00 15 1d 2a b4 00 15 15 04 32 53 15 04 3e 2a b4 00 15 `2..5.......*....*.....2S..>*...
0a40 1d 32 c7 ff 92 84 02 ff 1c 9d ff 75 2a b4 00 15 be 3d a7 00 07 1c 05 6c 3d 2a b4 00 17 1b 64 10 .2.........u*....=.....l=*....d.
0a60 10 60 1c 07 6c a4 ff f0 1c 2a b4 00 15 be 9f 00 1d 1c bd 00 13 4e 2a b4 00 15 03 2d 03 2a b4 00 .`..l....*...........N*....-.*..
0a80 17 04 60 b8 00 21 2a 2d b5 00 15 1b ac 00 00 00 02 00 1b 00 00 00 72 00 1c 00 00 01 31 00 02 01 ..`..!*-..............r.....1...
0aa0 34 00 0a 01 36 00 18 01 38 00 1b 01 3d 00 1d 01 3e 00 20 01 40 00 25 01 41 00 2f 01 44 00 36 01 4...6...8...=...>...@.%.A./.D.6.
0ac0 45 00 39 01 48 00 51 01 4c 00 5b 01 4d 00 65 01 4e 00 75 01 4f 00 78 01 50 00 85 01 51 00 88 01 E.9.H.Q.L.[.M.e.N.u.O.x.P...Q...
0ae0 3e 00 91 01 34 00 98 01 57 00 9e 01 58 00 a1 01 59 00 a5 01 58 00 b4 01 5a 00 bd 01 5c 00 c2 01 >...4...W...X...Y...X...Z...\...
0b00 5d 00 d2 01 5e 00 d7 01 61 00 1c 00 00 00 48 00 07 00 00 00 d9 00 1d 00 1e 00 00 00 02 00 d7 00 ]...^...a.....H.................
0b20 58 00 06 00 01 00 07 00 91 00 59 00 06 00 02 00 1d 00 74 00 5a 00 06 00 03 00 25 00 63 00 3c 00 X.........Y.......t.Z.....%.c.<.
0b40 06 00 04 00 9e 00 3b 00 5b 00 06 00 02 00 c2 00 15 00 5c 00 0c 00 03 00 02 00 5d 00 00 00 02 00 ......;.[.........\.......].....
0b60 5e 00 5f 00 00 00 0a 00 01 00 01 00 60 00 62 00 1a ^._.........`.b..
95' href='#n595'>595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345 1346
/* File.java -- Class representing a file on disk
   Copyright (C) 1998, 1999, 2000, 2001, 2003, 2004
   Free Software Foundation, Inc.

This file is part of GNU Classpath.

GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
 
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING.  If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.

Linking this library statically or dynamically with other modules is
making a combined work based on this library.  Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.

As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module.  An independent module is a module which is not derived from
or based on this library.  If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so.  If you do not wish to do so, delete this
exception statement from your version. */


package java.io;

import java.net.MalformedURLException;
import java.net.URI;
import java.net.URISyntaxException;
import java.net.URL;
import gnu.classpath.Configuration;
import gnu.gcj.runtime.FileDeleter;

/* Written using "Java Class Libraries", 2nd edition, ISBN 0-201-31002-3
 * "The Java Language Specification", ISBN 0-201-63451-1
 * Status:  Complete to version 1.3.
 */

/**
 * This class represents a file or directory on a local disk.  It provides
 * facilities for dealing with a variety of systems that use various
 * types of path separators ("/" versus "\", for example).  It also
 * contains method useful for creating and deleting files and directories.
 *
 * @author Aaron M. Renn <arenn@urbanophile.com>
 * @author Tom Tromey <tromey@cygnus.com>
 */
public class File implements Serializable, Comparable
{
  private static final long serialVersionUID = 301077366599181567L;
	
  // QUERY arguments to access function.
  private final static int READ = 0;
  private final static int WRITE = 1;
  private final static int EXISTS = 2;

  // QUERY arguments to stat function.
  private final static int DIRECTORY = 0;
  private final static int ISFILE = 1;
  private final static int ISHIDDEN = 2;

  // QUERY arguments to attr function.
  private final static int MODIFIED = 0;
  private final static int LENGTH = 1;
  
  private final native long attr (int query);
  // On OSF1 V5.0, `stat' is a macro.  It is easiest to use the name
  // `_stat' instead.  We do the same thing for `_access' just in
  // case.
  private final native boolean _access (int query);
  private final native boolean _stat (int query);

  /**
   * This is the path separator string for the current host. This field
   * contains the value of the <code>file.separator</code> system property.
   * An example separator string would be "/" on the GNU system.
   */
  public static final String separator = System.getProperty("file.separator");

  /**
   * This is the first character of the file separator string.  On many
   * hosts (for example, on the GNU system), this represents the entire 
   * separator string.  The complete separator string is obtained from the
   * <code>file.separator</code>system property.
   */
  public static final char separatorChar = separator.charAt(0);
  
  /**
   * This is the string that is used to separate the host name from the
   * path name in paths than include the host name.  It is the value of
   * the <code>path.separator</code> system property.
   */
  public static final String pathSeparator
    = System.getProperty("path.separator");
  
  /**
   * This is the first character of the string used to separate the host name
   * from the path name in paths that include a host.  The separator string
   * is taken from the <code>path.separator</code> system property.
   */
  public static final char pathSeparatorChar = pathSeparator.charAt(0);

  static final String tmpdir = System.getProperty("java.io.tmpdir");
  static int maxPathLen;
  static boolean caseSensitive;
  static String dupSeparator = separator + separator;
  
  static
  {
    if (Configuration.INIT_LOAD_LIBRARY)
      {
        System.loadLibrary("javaio");
      }
    
    init_native();
  }
  
  // Native function called at class initialization. This should should
  // set the maxPathLen and caseSensitive variables.
  private static native void init_native();

  /**
   * This is the path to the file set when the object is created.  It
   * may be an absolute or relative path name.
   */
  private String path;

  // We keep a counter for use by createTempFile.  We choose the first
  // value randomly to try to avoid clashes with other VMs.
  private static long counter = Double.doubleToLongBits (Math.random());

  /**
   * This method tests whether or not the current thread is allowed to
   * to read the file pointed to by this object.  This will be true if and
   * and only if 1) the file exists and 2) the <code>SecurityManager</code>
   * (if any) allows access to the file via it's <code>checkRead</code>
   * method 3) the file is readable.
   *
   * @return <code>true</code> if reading is allowed, 
   * <code>false</code> otherwise
   *
   * @exception SecurityException If the <code>SecurityManager</code> 
   * does not allow access to the file
   */
  public boolean canRead()
  {
    checkRead();
    return _access (READ);
  }

  /**
   * This method test whether or not the current thread is allowed to
   * write to this object.  This will be true if and only if 1) The
   * <code>SecurityManager</code> (if any) allows write access to the
   * file and 2) The file exists and 3) The file is writable.  To determine
   * whether or not a non-existent file can be created, check the parent
   * directory for write access.
   *
   * @return <code>true</code> if writing is allowed, <code>false</code> 
   * otherwise
   *
   * @exception SecurityException If the <code>SecurityManager</code> 
   * does not allow access to the file
   */
  public boolean canWrite()
  {
    checkWrite();
    return _access (WRITE);
  }
  
  private native boolean performCreate() throws IOException;

  /**
   * This method creates a new file of zero length with the same name as
   * the path of this <code>File</code> object if an only if that file
   * does not already exist.
   * <p>
   * A <code>SecurityManager.checkWrite</code> check is done prior
   * to performing this action.
   *
   * @return <code>true</code> if the file was created, <code>false</code> if
   * the file alread existed.
   *
   * @exception IOException If an I/O error occurs
   * @exception SecurityException If the <code>SecurityManager</code> will
   * not allow this operation to be performed.
   *
   * @since 1.2
   */
  public boolean createNewFile() throws IOException
  {
    checkWrite();
    return performCreate();
  }
 
  /*
   * This native method handles the actual deleting of the file
   */
  private native boolean performDelete();

  /**
   * This method deletes the file represented by this object.  If this file
   * is a directory, it must be empty in order for the delete to succeed.
   *
   * @return <code>true</code> if the file was deleted, <code>false</code> 
   * otherwise
   *
   * @exception SecurityException If deleting of the file is not allowed
   */
  public synchronized boolean delete()
  {
    SecurityManager s = System.getSecurityManager();
    
    if (s != null)
      s.checkDelete(path);
    
    return performDelete();
  }

  /**
   * This method tests two <code>File</code> objects for equality by 
   * comparing the path of the specified <code>File</code> against the path
   * of this object.  The two objects are equal if an only if 1) The
   * argument is not null 2) The argument is a <code>File</code> object and
   * 3) The path of the <code>File</code>argument is equal to the path
   * of this object.
   * <p>
   * The paths of the files are determined by calling the 
   * <code>getPath()</code>
   * method on each object.
   *
   * @return <code>true</code> if the two objects are equal, 
   * <code>false</code> otherwise.
   */
  public boolean equals(Object obj)
  {
    if (! (obj instanceof File))
      return false;
    
    File other = (File) obj;

    if (caseSensitive)
      return path.equals(other.path);
    else
      return path.equalsIgnoreCase(other.path);
  }

  /**
   * This method tests whether or not the file represented by the object
   * actually exists on the filesystem.
   *
   * @return <code>true</code> if the file exists, <code>false</code>otherwise.
   *
   * @exception SecurityException If reading of the file is not permitted
   */
  public boolean exists()
  {
    checkRead();
    return _access (EXISTS);
  }

  /**
   * This method initializes a new <code>File</code> object to represent
   * a file with the specified path.
   *
   * @param name The path name of the file
   */
  public File(String name)
  {
    path = normalizePath (name);
  }

  // Remove duplicate and redundant separator characters.
  private String normalizePath(String p)
  {
    // On Windows, convert any '/' to '\'.  This appears to be the same logic
    // that Sun's Win32 Java performs.
    if (separatorChar == '\\')
      p = p.replace ('/', '\\');

    int dupIndex = p.indexOf(dupSeparator);
    int plen = p.length();

    // Special case: permit Windows UNC path prefix.
    if (dupSeparator.equals("\\\\") && dupIndex == 0)
      dupIndex = p.indexOf(dupSeparator, 1);

    if (dupIndex == -1)
      {
        // Ignore trailing separator (though on Windows "a:\", for
        // example, is a valid and minimal path).
        if (plen > 1 && p.charAt (plen - 1) == separatorChar)
	  {
	    if (! (separatorChar == '\\' && plen == 3 && p.charAt (1) == ':'))
	      return p.substring (0, plen - 1);
	  }
	else
	  return p;
      }
    
    StringBuffer newpath = new StringBuffer(plen);
    int last = 0;
    while (dupIndex != -1)
      {
        newpath.append(p.substring(last, dupIndex));
	// Ignore the duplicate path characters.
	while (p.charAt(dupIndex) == separatorChar)
	  {
	    dupIndex++;
	    if (dupIndex == plen)
	      return newpath.toString();
	  }
	newpath.append(separatorChar);
	last = dupIndex;
	dupIndex = p.indexOf(dupSeparator, last);
      }
    
    // Again, ignore possible trailing separator (except special cases
    // like "a:\" on Windows).
    int end;
    if (plen > 1 && p.charAt (plen - 1) == separatorChar)
    {
      if (separatorChar == '\\' && plen == 3 && p.charAt (1) == ':')
        end = plen;
      else
        end = plen - 1;
    }
    else
      end = plen;
    newpath.append(p.substring(last, end));
    
    return newpath.toString();
  }
 
  /**
   * This method initializes a new <code>File</code> object to represent
   * a file in the specified named directory.  The path name to the file
   * will be the directory name plus the separator string plus the file
   * name.  If the directory path name ends in the separator string, another
   * separator string will still be appended.
   *
   * @param dirPath The path to the directory the file resides in
   * @param name The name of the file
   */
  public File(String dirPath, String name)
  {
    if (name == null)
      throw new NullPointerException();
    if (dirPath != null && dirPath.length() > 0)
      {
	// Try to be smart about the number of separator characters.
	if (dirPath.charAt(dirPath.length() - 1) == separatorChar
	    || name.length() == 0)
	  path = normalizePath(dirPath + name);
	else
	  path = normalizePath(dirPath + separatorChar + name);
      }
    else
      path = normalizePath(name);
  }

  /**
   * This method initializes a new <code>File</code> object to represent
   * a file in the specified directory.  If the <code>directory</code>
   * argument is <code>null</code>, the file is assumed to be in the
   * current directory as specified by the <code>user.dir</code> system
   * property
   *
   * @param directory The directory this file resides in
   * @param name The name of the file
   */
  public File(File directory, String name)
  {
    this (directory == null ? null : directory.path, name);
  }

  /**
   * This method returns the path of this file as an absolute path name.
   * If the path name is already absolute, then it is returned.  Otherwise
   * the value returned is the current directory plus the separatory
   * string plus the path of the file.  The current directory is determined
   * from the <code>user.dir</code> system property.
   *
   * @return The absolute path of this file
   */
  public String getAbsolutePath()
  {
    if (isAbsolute())
      return path;
    else if (separatorChar == '\\' 
             && path.length() > 0 && path.charAt (0) == '\\')
      {
        // On Windows, even if the path starts with a '\\' it is not
        // really absolute until we prefix the drive specifier from
        // the current working directory to it.
        return System.getProperty ("user.dir").substring (0, 2) + path;
      }
    else if (separatorChar == '\\' 
             && path.length() > 1 && path.charAt (1) == ':'
             && ((path.charAt (0) >= 'a' && path.charAt (0) <= 'z')
                 || (path.charAt (0) >= 'A' && path.charAt (0) <= 'Z')))
      {
        // On Windows, a process has a current working directory for
        // each drive and a path like "G:foo\bar" would mean the 
        // absolute path "G:\wombat\foo\bar" if "\wombat" is the 
        // working directory on the G drive.
        String drvDir = null;
        try
          {
            drvDir = new File (path.substring (0, 2)).getCanonicalPath();
          }
        catch (IOException e)
          {
            drvDir = path.substring (0, 2) + "\\";
          }
        
        // Note: this would return "C:\\." for the path "C:.", if "\"
        // is the working folder on the C drive, but this is 
        // consistent with what Sun's JRE 1.4.1.01 actually returns!
        if (path.length() > 2)
          return drvDir + '\\' + path.substring (2, path.length());
        else
          return drvDir;
      }
    else
      return System.getProperty ("user.dir") + separatorChar + path;
  }

  /**
   * This method returns a <code>File</code> object representing the
   * absolute path of this object.
   *
   * @return A <code>File</code> with the absolute path of the object.
   *
   * @since 1.2
   */
  public File getAbsoluteFile()
  {
    return new File(getAbsolutePath());
  }

  /**
   * This method returns a canonical representation of the pathname of
   * this file.  The actual form of the canonical representation is
   * different.  On the GNU system, the canonical form differs from the
   * absolute form in that all relative file references to "." and ".."
   * are resolved and removed.
   * <p>
   * Note that this method, unlike the other methods which return path
   * names, can throw an IOException.  This is because native method 
   * might be required in order to resolve the canonical path
   *
   * @exception IOException If an error occurs
   */
  public native String getCanonicalPath() throws IOException;

  /**
   * This method returns a <code>File</code> object representing the
   * canonical path of this object.
   *
   * @return A <code>File</code> instance representing the canonical path of
   * this object.
   *
   * @exception IOException If an error occurs.
   *
   * @since 1.2
   */
  public File getCanonicalFile() throws IOException
  {
    return new File(getCanonicalPath());
  }

  /**
   * This method returns the name of the file.  This is everything in the
   * complete path of the file after the last instance of the separator
   * string.
   *
   * @return The file name
   */
  public String getName()
  {
    int nameSeqIndex = 0;

    if (separatorChar == '\\' && path.length() > 1)
      {
        // On Windows, ignore the drive specifier or the leading '\\'
        // of a UNC network path, if any (a.k.a. the "prefix").
        if ((path.charAt (0) == '\\' && path.charAt (1) == '\\')
            || (((path.charAt (0) >= 'a' && path.charAt (0) <= 'z')
		 || (path.charAt (0) >= 'A' && path.charAt (0) <= 'Z'))
		&& path.charAt (1) == ':'))
	  {
	    if (path.length() > 2)
	      nameSeqIndex = 2;
	    else
	      return "";
	  }
      }

    String nameSeq 
      = (nameSeqIndex > 0 ? path.substring (nameSeqIndex) : path);

    int last = nameSeq.lastIndexOf (separatorChar);

    return nameSeq.substring (last + 1);
  }

  /**
   * This method returns a <code>String</code> the represents this file's
   * parent.  <code>null</code> is returned if the file has no parent.  The
   * parent is determined via a simple operation which removes the
   *
   * @return The parent directory of this file
   */
  public String getParent()
  {
    String prefix = null;
    int nameSeqIndex = 0;

    // The "prefix", if present, is the leading "/" on UNIX and 
    // either the drive specifier (e.g. "C:") or the leading "\\"
    // of a UNC network path on Windows.
    if (separatorChar == '/' && path.charAt (0) == '/')
      {
        prefix = "/";
        nameSeqIndex = 1;
      }
    else if (separatorChar == '\\' && path.length() > 1)
      {
        if ((path.charAt (0) == '\\' && path.charAt (1) == '\\')
            || (((path.charAt (0) >= 'a' && path.charAt (0) <= 'z')
                 || (path.charAt (0) >= 'A' && path.charAt (0) <= 'Z'))
                && path.charAt (1) == ':'))
          {
            prefix = path.substring (0, 2);
            nameSeqIndex = 2;
          }
      }

    // According to the JDK docs, the returned parent path is the 
    // portion of the name sequence before the last separator
    // character, if found, prefixed by the prefix, otherwise null.
    if (nameSeqIndex < path.length())
      {
        String nameSeq = path.substring (nameSeqIndex, path.length());
        int last = nameSeq.lastIndexOf (separatorChar);
        if (last == -1)
          return prefix;
        else if (last == (nameSeq.length() - 1))
          // Note: The path would not have a trailing separator
          // except for cases like "C:\" on Windows (see 
          // normalizePath( )), where Sun's JRE 1.4 returns null.
          return null;
        else if (last == 0)
          last++;

        if (prefix != null)
          return prefix + nameSeq.substring (0, last);
        else
          return nameSeq.substring (0, last);
      }
    else
      // Sun's JRE 1.4 returns null if the prefix is the only 
      // component of the path - so "/" gives null on UNIX and 
      // "C:", "\\", etc. return null on Windows.
      return null;
  }

  /**
   * This method returns a <code>File</code> object representing the parent
   * file of this one.
   *
   * @param A <code>File</code> for the parent of this object.  
   * <code>null</code>
   * will be returned if this object does not have a parent.
   *
   * @since 1.2
   */
  public File getParentFile()
  {
    String parent = getParent();
    return parent != null ? new File(parent) : null;
  }

  /**
   * Returns the path name that represents this file.  May be a relative
   * or an absolute path name
   *
   * @return The pathname of this file
   */
  public String getPath()
  {
    return path;
  }

  /**
   * This method returns a hash code representing this file.  It is the
   * hash code of the path of this file (as returned by <code>getPath()</code>)
   * exclusived or-ed with the value 1234321.
   *
   * @return The hash code for this object
   */
  public int hashCode()
  {
    if (caseSensitive)
      return path.hashCode() ^ 1234321;
    else
      return path.toLowerCase().hashCode() ^ 1234321;
  }

  /**
   * This method returns true if this object represents an absolute file
   * path and false if it does not.  The definition of an absolute path varies
   * by system.  As an example, on GNU systems, a path is absolute if it starts
   * with a "/".
   *
   * @return <code>true</code> if this object represents an absolute 
   * file name, <code>false</code> otherwise.
   */
  public native boolean isAbsolute();

  /**
   * This method tests whether or not the file represented by this object
   * is a directory.  In order for this method to return <code>true</code>,
   * the file represented by this object must exist and be a directory.
   * 
   * @return <code>true</code> if this file is a directory, <code>false</code>
   * otherwise
   *
   * @exception SecurityException If reading of the file is not permitted
   */
  public boolean isDirectory()
  {
    checkRead();
    return _stat (DIRECTORY);
  }

  /**
   * This method tests whether or not the file represented by this object
   * is a "plain" file.  A file is a plain file if and only if it 1) Exists,
   * 2) Is not a directory or other type of special file.
   *
   * @return <code>true</code> if this is a plain file, <code>false</code> 
   * otherwise
   *
   * @exception SecurityException If reading of the file is not permitted
   */
  public boolean isFile()
  {
    checkRead();
    return _stat (ISFILE);
  }

  /**
   * This method tests whether or not this file represents a "hidden" file.
   * On GNU systems, a file is hidden if its name begins with a "."
   * character.  Files with these names are traditionally not shown with
   * directory listing tools.
   *
   * @return <code>true</code> if the file is hidden, <code>false</code>
   * otherwise.
   *
   * @since 1.2
   */
  public boolean isHidden()
  {
    checkRead();
    return _stat (ISHIDDEN);
  }

  /**
   * This method returns the last modification time of this file.  The
   * time value returned is an abstract value that should not be interpreted
   * as a specified time value.  It is only useful for comparing to other
   * such time values returned on the same system.  In that case, the larger
   * value indicates a more recent modification time. 
   * <p>
   * If the file does not exist, then a value of 0 is returned.
   *
   * @return The last modification time of the file
   *
   * @exception SecurityException If reading of the file is not permitted
   */
  public long lastModified()
  {
    checkRead();
    return attr (MODIFIED);
  }

  /**
   * This method returns the length of the file represented by this object,
   * or 0 if the specified file does not exist.
   *
   * @return The length of the file
   *
   * @exception SecurityException If reading of the file is not permitted
   */
  public long length()
  {
    checkRead();
    return attr (LENGTH);
  }

  /*
   * This native function actually produces the list of file in this
   * directory
   */
  private final native Object[] performList (FilenameFilter filter,
					     FileFilter fileFilter,
					     Class result_type);

  /**
   * This method returns a array of <code>String</code>'s representing the
   * list of files is then directory represented by this object.  If this
   * object represents a non-directory file or a non-existent file, then
   * <code>null</code> is returned.  The list of files will not contain
   * any names such as "." or ".." which indicate the current or parent
   * directory.  Also, the names are not guaranteed to be sorted.
   * <p>
   * In this form of the <code>list()</code> method, a filter is specified
   * that allows the caller to control which files are returned in the
   * list.  The <code>FilenameFilter</code> specified is called for each
   * file returned to determine whether or not that file should be included
   * in the list.
   * <p>
   * A <code>SecurityManager</code> check is made prior to reading the
   * directory.  If read access to the directory is denied, an exception
   * will be thrown.
   *
   * @param filter An object which will identify files to exclude from 
   * the directory listing.
   *
   * @return An array of files in the directory, or <code>null</code> 
   * if this object does not represent a valid directory.
   * 
   * @exception SecurityException If read access is not allowed to the 
   * directory by the <code>SecurityManager</code>
   */
  public String[] list(FilenameFilter filter)
  {
    checkRead();
    return (String[]) performList (filter, null, String.class);
  }

  /**
   * This method returns a array of <code>String</code>'s representing the
   * list of files is then directory represented by this object.  If this
   * object represents a non-directory file or a non-existent file, then
   * <code>null</code> is returned.  The list of files will not contain
   * any names such as "." or ".." which indicate the current or parent
   * directory.  Also, the names are not guaranteed to be sorted.
   * <p>
   * A <code>SecurityManager</code> check is made prior to reading the
   * directory.  If read access to the directory is denied, an exception
   * will be thrown.
   *
   * @return An array of files in the directory, or <code>null</code> if 
   * this object does not represent a valid directory.
   * 
   * @exception SecurityException If read access is not allowed to the 
   * directory by the <code>SecurityManager</code>
   */
  public String[] list()
  {
    checkRead();
    return (String[]) performList (null, null, String.class);
  }

  /**
   * This method returns an array of <code>File</code> objects representing
   * all the files in the directory represented by this object. If this
   * object does not represent a directory, <code>null</code> is returned.
   * Each of the returned <code>File</code> object is constructed with this
   * object as its parent.
   * <p>
   * A <code>SecurityManager</code> check is made prior to reading the
   * directory.  If read access to the directory is denied, an exception
   * will be thrown.
   *
   * @return An array of <code>File</code> objects for this directory.
   *
   * @exception SecurityException If the <code>SecurityManager</code> denies
   * access to this directory.
   *
   * @since 1.2
   */
  public File[] listFiles()
  {
    checkRead();
    return (File[]) performList (null, null, File.class);
  }
  
  /**
   * This method returns an array of <code>File</code> objects representing
   * all the files in the directory represented by this object. If this
   * object does not represent a directory, <code>null</code> is returned.
   * Each of the returned <code>File</code> object is constructed with this
   * object as its parent.
   * <p> 
   * In this form of the <code>listFiles()</code> method, a filter is specified
   * that allows the caller to control which files are returned in the
   * list.  The <code>FilenameFilter</code> specified is called for each
   * file returned to determine whether or not that file should be included
   * in the list.
   * <p>
   * A <code>SecurityManager</code> check is made prior to reading the
   * directory.  If read access to the directory is denied, an exception
   * will be thrown.
   *
   * @return An array of <code>File</code> objects for this directory.
   *
   * @exception SecurityException If the <code>SecurityManager</code> denies
   * access to this directory.
   *
   * @since 1.2
   */
  public File[] listFiles(FilenameFilter filter)
  {
    checkRead();
    return (File[]) performList (filter, null, File.class);
  }

  /**
   * This method returns an array of <code>File</code> objects representing
   * all the files in the directory represented by this object. If this
   * object does not represent a directory, <code>null</code> is returned.
   * Each of the returned <code>File</code> object is constructed with this
   * object as its parent.
   * <p> 
   * In this form of the <code>listFiles()</code> method, a filter is specified
   * that allows the caller to control which files are returned in the
   * list.  The <code>FileFilter</code> specified is called for each
   * file returned to determine whether or not that file should be included
   * in the list.
   * <p>
   * A <code>SecurityManager</code> check is made prior to reading the
   * directory.  If read access to the directory is denied, an exception
   * will be thrown.
   *
   * @return An array of <code>File</code> objects for this directory.
   *
   * @exception SecurityException If the <code>SecurityManager</code> denies
   * access to this directory.
   *
   * @since 1.2
   */
  public File[] listFiles(FileFilter filter)
  {
    checkRead();
    return (File[]) performList (null, filter, File.class);
  }

  /**
   * This method returns a <code>String</code> that is the path name of the
   * file as returned by <code>getPath</code>.
   *
   * @return A <code>String</code> representation of this file
   */
  public String toString()
  {
    return path;
  }

  /**
   * @return A <code>URI</code> for this object.
   */
  public URI toURI()
  {
    String abspath = getAbsolutePath();

    if (isDirectory())
      abspath = abspath + separator;
        
    try
      {
	return new URI("file", "", abspath.replace(separatorChar, '/'));
      }
    catch (URISyntaxException use)
      {
        // Can't happen.
	throw new RuntimeException(use);
      }
  }

  /**
   * This method returns a <code>URL</code> with the <code>file:</code>
   * protocol that represents this file.  The exact form of this URL is
   * system dependent.
   *
   * @return A <code>URL</code> for this object.
   *
   * @exception MalformedURLException If the URL cannot be created 
   * successfully.
   */
  public URL toURL() throws MalformedURLException
  {
    // On Win32, Sun's JDK returns URLs of the form "file:/c:/foo/bar.txt",
    // while on UNIX, it returns URLs of the form "file:/foo/bar.txt". 
    if (separatorChar == '\\')
      return new URL ("file:/" + getAbsolutePath().replace ('\\', '/')
		      + (isDirectory() ? "/" : ""));
    else
      return new URL ("file:" + getAbsolutePath()
		      + (isDirectory() ? "/" : ""));
  }

  /*
   * This native method actually creates the directory
   */
  private final native boolean performMkdir();

  /**
   * This method creates a directory for the path represented by this object.
   *
   * @return <code>true</code> if the directory was created, 
   * <code>false</code> otherwise
   *
   * @exception SecurityException If write access is not allowed to this file
   */
  public boolean mkdir()
  {
    checkWrite();
    return performMkdir();
  }

  private static boolean mkdirs (File x)
  {
    if (x.isDirectory())
      return true;
    String p = x.getPath();
    String parent = x.getParent();
    if (parent != null)
      {
	x.path = parent;
	if (! mkdirs (x))
	  return false;
	x.path = p;
      }
    return x.mkdir();
  }

  /**
   * This method creates a directory for the path represented by this file.
   * It will also create any intervening parent directories if necessary.
   *
   * @return <code>true</code> if the directory was created, 
   * <code>false</code> otherwise
   *
   * @exception SecurityException If write access is not allowed to this file
   */
  public boolean mkdirs()
  {
    checkWrite();
    if (isDirectory())
      return false;
    return mkdirs (new File (path));
  }

  private static synchronized String nextValue()
  {
    return Long.toString(counter++, Character.MAX_RADIX);
  }

  /**
   * This method creates a temporary file in the specified directory.  If 
   * the directory name is null, then this method uses the system temporary 
   * directory. The files created are guaranteed not to currently exist and 
   * the same file name will never be used twice in the same virtual 
   * machine instance.  
   * The system temporary directory is determined by examinging the 
   * <code>java.io.tmpdir</code> system property.
   * <p>
   * The <code>prefix</code> parameter is a sequence of at least three
   * characters that are used as the start of the generated filename.  The
   * <code>suffix</code> parameter is a sequence of characters that is used
   * to terminate the file name.  This parameter may be <code>null</code>
   * and if it is, the suffix defaults to ".tmp".
   * <p>
   * If a <code>SecurityManager</code> exists, then its <code>checkWrite</code>
   * method is used to verify that this operation is permitted.
   *
   * @param prefix The character prefix to use in generating the path name.
   * @param suffix The character suffix to use in generating the path name.
   * @param directory The directory to create the file in, or 
   * <code>null</code> for the default temporary directory
   *
   * @exception IllegalArgumentException If the patterns is not valid
   * @exception SecurityException If there is no permission to perform 
   * this operation
   * @exception IOException If an error occurs
   *
   * @since 1.2
   */
  public static File createTempFile(String prefix, String suffix,
				    File directory)
    throws IOException
  {
    // Grab the system temp directory if necessary
    if (directory == null)
      {
        String dirname = tmpdir;
        if (dirname == null)
          throw new IOException ("Cannot determine system temporary directory"); 
	
        directory = new File (dirname);
        if (!directory.exists())
          throw new IOException ("System temporary directory "
                                 + directory.getName() + " does not exist.");
        if (!directory.isDirectory())
          throw new IOException ("System temporary directory "
                                 + directory.getName()
                                 + " is not really a directory.");
      }

    // Check if prefix is at least 3 characters long
    if (prefix.length() < 3)
      throw new IllegalArgumentException("Prefix too short: " + prefix);

    // Set default value of suffix
    if (suffix == null)
      suffix = ".tmp";

    // Truncation rules.
    // `6' is the number of characters we generate.
    if (prefix.length() + 6 + suffix.length() > maxPathLen)
      {
	int suf_len = 0;
	if (suffix.charAt(0) == '.')
	  suf_len = 4;
	suffix = suffix.substring(0, suf_len);
	if (prefix.length() + 6 + suf_len > maxPathLen)
	  prefix = prefix.substring(0, maxPathLen - 6 - suf_len);
      }

    File f;

    // How many times should we try?  We choose 100.
    for (int i = 0; i < 100; ++i)
      {
	// This is ugly.
	String t = "ZZZZZZ" + nextValue();
	String l = prefix + t.substring(t.length() - 6) + suffix;
	try
	  {
	    f = new File(directory, l);
	    if (f.createNewFile())
	      return f;
	  }
	catch (IOException ignored)
	  {
	  }
      }

    throw new IOException ("cannot create temporary file");
  }

  /*
   * This native method sets the permissions to make the file read only.
   */
  private native boolean performSetReadOnly();

  /**
   * This method sets the file represented by this object to be read only.
   * A read only file or directory cannot be modified.  Please note that 
   * GNU systems allow read only files to be deleted if the directory it
   * is contained in is writable.
   *
   * @return <code>true</code> if the operation succeeded, <code>false</code>
   * otherwise.
   *
   * @exception SecurityException If the <code>SecurityManager</code> does
   * not allow this operation.
   *
   * @since 1.2
   */
  public boolean setReadOnly()
  {
    checkWrite();
    return performSetReadOnly();
  }

  private static native File[] performListRoots();

  /**
   * This method returns an array of filesystem roots.  Some operating systems
   * have volume oriented filesystem.  This method provides a mechanism for
   * determining which volumes exist.  GNU systems use a single hierarchical
   * filesystem, so will have only one "/" filesystem root.
   *
   * @return An array of <code>File</code> objects for each filesystem root
   * available.
   *
   * @since 1.2
   */
  public static File[] listRoots()
  {
    File[] roots = performListRoots();
    
    SecurityManager s = System.getSecurityManager();
    if (s != null)
      {
	// Only return roots to which the security manager permits read access.
	int count = roots.length;
	for (int i = 0; i < roots.length; i++)
	  {
	    try
	      {
        	s.checkRead (roots[i].path);		
	      }
	    catch (SecurityException sx)
	      {
	        roots[i] = null;
		count--;
	      }
	  }
	if (count != roots.length)
	  {
	    File[] newRoots = new File[count];
	    int k = 0;
	    for (int i=0; i < roots.length; i++)
	      {
	        if (roots[i] != null)
		  newRoots[k++] = roots[i];
	      }
	    roots = newRoots;
	  }
      }
    return roots;
  }

  /**
   * This method creates a temporary file in the system temporary directory. 
   * The files created are guaranteed not to currently exist and the same file
   * name will never be used twice in the same virtual machine instance.  The
   * system temporary directory is determined by examinging the 
   * <code>java.io.tmpdir</code> system property.
   * <p>
   * The <code>prefix</code> parameter is a sequence of at least three
   * characters that are used as the start of the generated filename.  The
   * <code>suffix</code> parameter is a sequence of characters that is used
   * to terminate the file name.  This parameter may be <code>null</code>
   * and if it is, the suffix defaults to ".tmp".
   * <p>
   * If a <code>SecurityManager</code> exists, then its <code>checkWrite</code>
   * method is used to verify that this operation is permitted.
   * <p>
   * This method is identical to calling 
   * <code>createTempFile(prefix, suffix, null)</code>.
   *
   * @param prefix The character prefix to use in generating the path name.
   * @param suffix The character suffix to use in generating the path name.
   *
   * @exception IllegalArgumentException If the prefix or suffix are not valid.
   * @exception SecurityException If there is no permission to perform 
   * this operation
   * @exception IOException If an error occurs
   */
  public static File createTempFile(String prefix, String suffix)
    throws IOException
  {
    return createTempFile(prefix, suffix, null);
  }

  /**
   * This method compares the specified <code>File</code> to this one
   * to test for equality.  It does this by comparing the canonical path names
   * of the files. 
   * <p>
   * The canonical paths of the files are determined by calling the
   * <code>getCanonicalPath</code> method on each object.
   * <p>
   * This method returns a 0 if the specified <code>Object</code> is equal
   * to this one, a negative value if it is less than this one 
   * a positive value if it is greater than this one.
   *
   * @return An integer as described above
   *
   * @since 1.2
   */
  public int compareTo(File other)
  {
    if (caseSensitive)
      return path.compareTo (other.path);
    else
      return path.compareToIgnoreCase (other.path);
  }

  /**
   * This method compares the specified <code>Object</code> to this one
   * to test for equality.  It does this by comparing the canonical path names
   * of the files.  This method is identical to <code>compareTo(File)</code>
   * except that if the <code>Object</code> passed to it is not a 
   * <code>File</code>, it throws a <code>ClassCastException</code>
   * <p>
   * The canonical paths of the files are determined by calling the
   * <code>getCanonicalPath</code> method on each object.
   * <p>
   * This method returns a 0 if the specified <code>Object</code> is equal
   * to this one, a negative value if it is less than this one 
   * a positive value if it is greater than this one.
   *
   * @return An integer as described above
   *
   * @exception ClassCastException If the passed <code>Object</code> is 
   * not a <code>File</code>
   *
   * @since 1.2
   */
  public int compareTo(Object obj)
  {
    return compareTo((File) obj);
  }

  /*
   * This native method actually performs the rename.
   */
  private native boolean performRenameTo (File dest);

  /**
   * This method renames the file represented by this object to the path
   * of the file represented by the argument <code>File</code>.
   *
   * @param dest The <code>File</code> object representing the target name
   *
   * @return <code>true</code> if the rename succeeds, <code>false</code> 
   * otherwise.
   *
   * @exception SecurityException If write access is not allowed to the 
   * file by the <code>SecurityMananger</code>.
   */
  public synchronized boolean renameTo(File dest)
  {
    SecurityManager s = System.getSecurityManager();
    String sname = getName();
    String dname = dest.getName();
    if (s != null)
      {
	s.checkWrite (sname);
	s.checkWrite (dname);
      }
    return performRenameTo (dest);
  }

  /*
   * This method does the actual setting of the modification time.
   */
  private native boolean performSetLastModified(long time);
 
  /**
   * This method sets the modification time on the file to the specified
   * value.  This is specified as the number of seconds since midnight
   * on January 1, 1970 GMT.
   *
   * @param time The desired modification time.
   *
   * @return <code>true</code> if the operation succeeded, <code>false</code>
   * otherwise.
   *
   * @exception IllegalArgumentException If the specified time is negative.
   * @exception SecurityException If the <code>SecurityManager</code> will
   * not allow this operation.
   *
   * @since 1.2
   */
  public boolean setLastModified(long time) 
  {
    if (time < 0)
      throw new IllegalArgumentException("Negative modification time: " + time);

    checkWrite();
    return performSetLastModified(time);
  }

  private void checkWrite()
  {
    // Check the SecurityManager
    SecurityManager s = System.getSecurityManager();
    
    if (s != null)
      s.checkWrite(path);
  }

  private void checkRead()
  {
    // Check the SecurityManager
    SecurityManager s = System.getSecurityManager();
    
    if (s != null)
      s.checkRead(path);
  }

  /** 
   * Add this File to the set of files to be deleted upon normal
   * termination.
   *
   * @exception SecurityException If deleting of the file is not allowed
   *
   * @since 1.2 
   */
  // FIXME: This should use the ShutdownHook API once we implement that.
  public void deleteOnExit()
  {
    // Check the SecurityManager
    SecurityManager sm = System.getSecurityManager();
    if (sm != null)
      sm.checkDelete (getName());

    FileDeleter.add (this);
  }

  private void writeObject(ObjectOutputStream oos) throws IOException
  {
    oos.defaultWriteObject();
    oos.writeChar(separatorChar);
  }

  private void readObject(ObjectInputStream ois)
    throws ClassNotFoundException, IOException
  {
    ois.defaultReadObject();

    // If the file was from an OS with a different dir separator,
    // fixup the path to use the separator on this OS.
    char oldSeparatorChar = ois.readChar();
    
    if (oldSeparatorChar != separatorChar)
      path = path.replace(oldSeparatorChar, separatorChar);
  }
  
} // class File