annotate servlet/src/digilib/io/DocuDirCache.java @ 86:997ba69afb81

New version 1.8b1. With directory and file information cache. With enhanceRGB method for color correction.
author robcast
date Sun, 09 Mar 2003 21:37:27 +0100
parents
children a398fc09ba71
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
86
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
1 /* DocuDirCache.java
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
2
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
3 Digital Image Library servlet components
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
4
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
5 Copyright (C) 2003 Robert Casties (robcast@mail.berlios.de)
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
6
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
7 This program is free software; you can redistribute it and/or modify it
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
8 under the terms of the GNU General Public License as published by the
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
9 Free Software Foundation; either version 2 of the License, or (at your
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
10 option) any later version.
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
11
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
12 Please read license.txt for the full details. A copy of the GPL
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
13 may be found at http://www.gnu.org/copyleft/lgpl.html
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
14
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
15 You should have received a copy of the GNU General Public License
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
16 along with this program; if not, write to the Free Software
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
17 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
18
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
19 * Created on 03.03.2003
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
20 */
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
21
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
22 package digilib.io;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
23
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
24 import java.io.File;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
25 import java.util.Hashtable;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
26
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
27 /**
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
28 * @author casties
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
29 */
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
30 public class DocuDirCache extends Hashtable {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
31
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
32 // names of base directories
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
33 private String[] baseDirNames = null;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
34 // number of files in the whole cache (not reliable)
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
35 private long numFiles = 0;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
36 // number of cache hits
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
37 private long hits = 0;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
38 // number of cache misses
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
39 private long misses = 0;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
40
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
41 /*
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
42 * inherited constructors
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
43 */
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
44 public DocuDirCache(int initialCapacity, float loadFactor) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
45 super(initialCapacity, loadFactor);
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
46 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
47
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
48 public DocuDirCache(int initialCapacity) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
49 super(initialCapacity);
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
50 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
51
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
52 public DocuDirCache() {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
53 super();
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
54 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
55
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
56 /*
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
57 * new and exiting stuff
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
58 */
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
59
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
60 /** Constructor with array of base directory names.
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
61 *
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
62 * @param bd base directory names
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
63 */
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
64 public DocuDirCache(String[] bd) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
65 super();
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
66 baseDirNames = bd;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
67 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
68
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
69 /** Add a DocuDirectory to the cache.
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
70 *
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
71 * @param newdir
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
72 */
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
73 public void put(DocuDirectory newdir) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
74 String s = newdir.getDirName();
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
75 if (containsKey(s)) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
76 System.out.println("Baah, duplicate key in DocuDirectory.put!");
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
77 } else {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
78 super.put(s, newdir);
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
79 numFiles += newdir.size();
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
80 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
81 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
82
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
83 public DocuFileset getFileset(String fn, int in) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
84 DocuDirectory dd;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
85 // file number is 1-based, vector index is 0-based
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
86 int n = in - 1;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
87 // first, assume fn is a directory and look in the cache
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
88 dd = (DocuDirectory) get(fn);
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
89 if (dd == null) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
90 // cache miss
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
91 misses++;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
92 // see if it's a directory
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
93 File f = new File(baseDirNames[0] + fn);
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
94 if (f.isDirectory()) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
95 dd = new DocuDirectory(fn, baseDirNames);
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
96 if (dd.isValid()) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
97 // add to the cache
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
98 put(dd);
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
99 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
100 } else {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
101 // maybe it's a file
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
102 if (f.canRead()) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
103 // try the parent directory in the cache
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
104 dd = (DocuDirectory) get(f.getParent());
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
105 if (dd == null) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
106 // try to read from disk
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
107 dd = new DocuDirectory(f.getParent(), baseDirNames);
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
108 if (dd.isValid()) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
109 // add to the cache
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
110 put(dd);
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
111 } else {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
112 // invalid path
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
113 return null;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
114 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
115 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
116 // get the file's index
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
117 n = dd.indexOf(f.getName());
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
118 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
119 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
120 } else {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
121 // cache hit
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
122 hits++;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
123 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
124 dd.refresh();
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
125 if (dd.isValid()) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
126 try {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
127 return (DocuFileset) dd.elementAt(n);
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
128 } catch (ArrayIndexOutOfBoundsException e) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
129 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
130 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
131 return null;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
132 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
133
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
134 public DocuDirectory getDirectory(String fn) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
135 DocuDirectory dd;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
136 // first, assume fn is a directory and look in the cache
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
137 dd = (DocuDirectory) get(fn);
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
138 if (dd == null) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
139 // cache miss
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
140 misses++;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
141 // see if it's a directory
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
142 File f = new File(baseDirNames[0] + fn);
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
143 if (f.isDirectory()) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
144 dd = new DocuDirectory(fn, baseDirNames);
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
145 if (dd.isValid()) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
146 // add to the cache
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
147 put(dd);
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
148 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
149 } else {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
150 // maybe it's a file
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
151 if (f.canRead()) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
152 // try the parent directory in the cache
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
153 dd = (DocuDirectory) get(f.getParent());
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
154 if (dd == null) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
155 // try to read from disk
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
156 dd = new DocuDirectory(f.getParent(), baseDirNames);
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
157 if (dd.isValid()) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
158 // add to the cache
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
159 put(dd);
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
160 } else {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
161 // invalid path
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
162 return null;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
163 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
164 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
165 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
166 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
167 } else {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
168 // cache hit
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
169 hits++;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
170 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
171 dd.refresh();
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
172 if (dd.isValid()) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
173 return dd;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
174 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
175 return null;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
176 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
177
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
178 /**
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
179 * @return String[]
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
180 */
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
181 public String[] getBaseDirNames() {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
182 return baseDirNames;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
183 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
184
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
185 /**
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
186 * @return long
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
187 */
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
188 public long getNumFiles() {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
189 return numFiles;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
190 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
191
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
192 /**
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
193 * Sets the baseDirNames.
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
194 * @param baseDirNames The baseDirNames to set
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
195 */
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
196 public void setBaseDirNames(String[] baseDirNames) {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
197 this.baseDirNames = baseDirNames;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
198 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
199
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
200 /**
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
201 * @return long
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
202 */
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
203 public long getHits() {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
204 return hits;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
205 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
206
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
207 /**
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
208 * @return long
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
209 */
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
210 public long getMisses() {
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
211 return misses;
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
212 }
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
213
997ba69afb81 New version 1.8b1.
robcast
parents:
diff changeset
214 }