GitWiki: apache is not needed for preview
[openafs-wiki.git] / JavaAdminAPI / File.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd">
2 <!--NewPage-->
3 <HTML>
4 <HEAD>
5 <!-- Generated by javadoc on Mon Jun 09 15:53:37 PDT 2003 -->
6 <TITLE>
7 File (Java AFS API)
8 </TITLE>
9 <META NAME="keywords" CONTENT="org.openafs.jafs.File,File class">
10 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
11 </HEAD>
12 <SCRIPT>
13 function asd()
14 {
15 parent.document.title="File (Java AFS API)";
16 }
17 </SCRIPT>
18 <BODY BGCOLOR="white" onload="asd();">
19
20 <!-- ========== START OF NAVBAR ========== -->
21 <A NAME="navbar_top"><!-- --></A>
22 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
23 <TR>
24 <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
25 <A NAME="navbar_top_firstrow"><!-- --></A>
26 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
27   <TR ALIGN="center" VALIGN="top">
28   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
29   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
30   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/File.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
31   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
32   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
33   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
34   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
35   </TR>
36 </TABLE>
37 </TD>
38 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
39 <B>JAFS API v2</B></EM>
40 </TD>
41 </TR>
42
43 <TR>
44 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
45 &nbsp;<A HREF="../../../org/openafs/jafs/ErrorTable.html"><B>PREV CLASS</B></A>&nbsp;
46 &nbsp;<A HREF="../../../org/openafs/jafs/FileInputStream.html"><B>NEXT CLASS</B></A></FONT></TD>
47 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
48   <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
49 &nbsp;<A HREF="File.html" TARGET="_top"><B>NO FRAMES</B></A>  &nbsp;
50 &nbsp;
51 <SCRIPT>
52   <!--
53   if(window==top) {
54     document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
55   }
56   //-->
57 </SCRIPT>
58 <NOSCRIPT>
59 <A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
60 </NOSCRIPT>
61 </FONT></TD>
62 </TR>
63 <TR>
64 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
65   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#fields_inherited_from_class_java.io.File">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
66 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
67 DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
68 </TR>
69 </TABLE>
70 <!-- =========== END OF NAVBAR =========== -->
71
72 <HR>
73 <!-- ======== START OF CLASS DATA ======== -->
74 <H2>
75 <FONT SIZE="-1">
76 org.openafs.jafs</FONT>
77 <BR>
78 Class File</H2>
79 <PRE>
80 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">java.lang.Object</A>
81   |
82   +--<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">java.io.File</A>
83         |
84         +--<B>org.openafs.jafs.File</B>
85 </PRE>
86 <DL>
87 <DT><B>All Implemented Interfaces:</B> <DD><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/Serializable.html">Serializable</A></DD>
88 </DL>
89 <HR>
90 <DL>
91 <DT>public class <B>File</B><DT>extends <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A><DT>implements <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</A></DL>
92
93 <P>
94 An abstract representation of AFS file and directory pathnames.
95
96  This class is an extension of the standard Java File class with file-based 
97  manipulation methods overridden by integrated AFS native methods.
98
99  <p> Extension methods include:
100
101  <ol>
102  <li> <code><A HREF="../../../org/openafs/jafs/File.html#isMountPoint()"><CODE>isMountPoint()</CODE></A></code>
103  <li> <code><A HREF="../../../org/openafs/jafs/File.html#isLink()"><CODE>isLink()</CODE></A></code>
104  <li> <code><A HREF="../../../org/openafs/jafs/File.html#isValidated()"><CODE>isValidated()</CODE></A></code>
105  <li> <code><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></code>
106  <li> <code><A HREF="../../../org/openafs/jafs/File.html#refresh()"><CODE>refresh()</CODE></A></code>
107  <li> <code><A HREF="../../../org/openafs/jafs/File.html#getErrorCode()"><CODE>getErrorCode()</CODE></A></code>
108  <li> <code><A HREF="../../../org/openafs/jafs/File.html#getErrorMessage()"><CODE>getErrorMessage()</CODE></A></code>
109  </ol>
110
111  <p> For performance optimization, all newly constructed <code>File</code> 
112  objects are only validated once.  Furthermore, if an abstract pathname 
113  denotes a symbolic-link, then the <A HREF="../../../org/openafs/jafs/File.html#isLink()"><CODE>isLink()</CODE></A> attribute is set 
114  to true and the <A HREF="../../../org/openafs/jafs/File.html#getTarget()"><CODE>getTarget()</CODE></A> field member is populated with 
115  this symbolic-link's target resource. (see <A HREF="../../../org/openafs/jafs/File.html#getTarget()"><CODE>getTarget()</CODE></A>)
116  
117  <p> If you are interested in validating the target resource, simply 
118  call <A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A> before calling any of the attribute accessors. 
119  This action will <code>stat</code> the target resource, identifying 
120  its associated attributes and populating them in this objects field 
121  members.
122  
123  <p> Following is an example of how to construct a new AFS File Object:
124  <p><blockquote><pre>
125      try {
126          File file = new File("/afs/mycell.com/proj/");
127          if (file.isDirectory()) {
128            System.out.println("This is a directory.");
129          } else if (file.isLink()) {
130            System.out.println("This is a symbolic-link.");
131            System.out.println("  Its target is: " + file.getTarget());
132            file.validate();
133            if (file.isFile()) {
134              System.out.println("  This object is now a file!");
135            } else if (file.isDirectory()) {
136              System.out.println("  This object is now a directory!");
137            } else if (file.isMountPoint()) {
138              System.out.println("  This object is now a volume mount point!");
139            }
140          } else if (file.isMountPoint()) {
141            System.out.println("This is a volume mount point.");
142          } else if (file.isFile()) {
143            System.out.println("This is file.");
144            System.out.println("  its size is: " + file.length());
145          }
146      } catch (AFSFileException ae) {
147          System.out.println("AFS Exception: " + ae.getMessage());
148          System.out.println("AFS Error Code: " + ae.getErrorCode());
149      } catch (Exception e) {
150          System.out.println("Exception: " + e.getMessage());
151          e.printStackTrace();
152      }
153  </pre></blockquote>
154 <P>
155
156 <P>
157 <DL>
158 <DT><B>Version:</B></DT>
159   <DD>2.0, 04/16/2001 - Completely revised class for efficiency., 1.3, 10/12/2000 - Introduced error code capture from native methods., 1.2, 05/30/2000</DD>
160 <DT><B>See Also:</B><DD><A HREF="../../../serialized-form.html" TARGET="org.openafs.jafs.File">Serialized Form</A></DL>
161 <HR>
162
163 <P>
164 <!-- ======== NESTED CLASS SUMMARY ======== -->
165
166
167 <!-- =========== FIELD SUMMARY =========== -->
168
169 <A NAME="field_summary"><!-- --></A>
170 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
171 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
172 <TD COLSPAN=2><FONT SIZE="+2">
173 <B>Field Summary</B></FONT></TD>
174 </TR>
175 </TABLE>
176 &nbsp;<A NAME="fields_inherited_from_class_java.io.File"><!-- --></A>
177 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
178 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
179 <TD><B>Fields inherited from class java.io.<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></B></TD>
180 </TR>
181 <TR BGCOLOR="white" CLASS="TableRowColor">
182 <TD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#pathSeparator">pathSeparator</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#pathSeparatorChar">pathSeparatorChar</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#separator">separator</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#separatorChar">separatorChar</A></CODE></TD>
183 </TR>
184 </TABLE>
185 &nbsp;
186 <!-- ======== CONSTRUCTOR SUMMARY ======== -->
187
188 <A NAME="constructor_summary"><!-- --></A>
189 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
190 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
191 <TD COLSPAN=2><FONT SIZE="+2">
192 <B>Constructor Summary</B></FONT></TD>
193 </TR>
194 <TR BGCOLOR="white" CLASS="TableRowColor">
195 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#File(org.openafs.jafs.File, java.lang.String)">File</A></B>(<A HREF="../../../org/openafs/jafs/File.html">File</A>&nbsp;parent,
196      <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;filename)</CODE>
197
198 <BR>
199 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a new <code>File</code> instance from a parent abstract
200  pathname and a child pathname string and validates it against the file system.
201
202  </TD>
203 </TR>
204 <TR BGCOLOR="white" CLASS="TableRowColor">
205 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#File(org.openafs.jafs.File, java.lang.String, boolean)">File</A></B>(<A HREF="../../../org/openafs/jafs/File.html">File</A>&nbsp;parent,
206      <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;filename,
207      boolean&nbsp;validate)</CODE>
208
209 <BR>
210 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a new <code>File</code> instance from a parent abstract
211  pathname and a child pathname string.
212
213  </TD>
214 </TR>
215 <TR BGCOLOR="white" CLASS="TableRowColor">
216 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#File(java.lang.String)">File</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;pathname)</CODE>
217
218 <BR>
219 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a new <code>File</code> instance by converting the given
220  pathname string into an abstract pathname and validating it against
221  the file system.  </TD>
222 </TR>
223 <TR BGCOLOR="white" CLASS="TableRowColor">
224 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#File(java.lang.String, boolean)">File</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;pathname,
225      boolean&nbsp;validate)</CODE>
226
227 <BR>
228 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a new <code>File</code> instance by converting the given
229  pathname string into an abstract pathname.  </TD>
230 </TR>
231 <TR BGCOLOR="white" CLASS="TableRowColor">
232 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#File(java.lang.String, java.lang.String)">File</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;parent,
233      <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;filename)</CODE>
234
235 <BR>
236 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a new <code>File</code> instance from a parent pathname string
237  and a child pathname string and validates it against the file system.
238
239  </TD>
240 </TR>
241 <TR BGCOLOR="white" CLASS="TableRowColor">
242 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#File(java.lang.String, java.lang.String, boolean)">File</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;parent,
243      <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;filename,
244      boolean&nbsp;validate)</CODE>
245
246 <BR>
247 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a new <code>File</code> instance from a parent pathname string
248  and a child pathname string.
249
250  </TD>
251 </TR>
252 </TABLE>
253 &nbsp;
254 <!-- ========== METHOD SUMMARY =========== -->
255
256 <A NAME="method_summary"><!-- --></A>
257 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
258 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
259 <TD COLSPAN=2><FONT SIZE="+2">
260 <B>Method Summary</B></FONT></TD>
261 </TR>
262 <TR BGCOLOR="white" CLASS="TableRowColor">
263 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
264 <CODE>&nbsp;boolean</CODE></FONT></TD>
265 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canAdmin()">canAdmin</A></B>()</CODE>
266
267 <BR>
268 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the user can administer the ACL (see: <A HREF="../../../org/openafs/jafs/ACL.html"><CODE>ACL</CODE></A>
269  of the directory denoted by this abstract pathname.</TD>
270 </TR>
271 <TR BGCOLOR="white" CLASS="TableRowColor">
272 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
273 <CODE>&nbsp;boolean</CODE></FONT></TD>
274 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canDelete()">canDelete</A></B>()</CODE>
275
276 <BR>
277 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the current user can delete the files or subdirectories of
278  the directory denoted by this abstract pathname.</TD>
279 </TR>
280 <TR BGCOLOR="white" CLASS="TableRowColor">
281 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
282 <CODE>&nbsp;boolean</CODE></FONT></TD>
283 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canInsert()">canInsert</A></B>()</CODE>
284
285 <BR>
286 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the current user can insert a file into the directory
287  denoted by this abstract pathname.</TD>
288 </TR>
289 <TR BGCOLOR="white" CLASS="TableRowColor">
290 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
291 <CODE>&nbsp;boolean</CODE></FONT></TD>
292 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canLock()">canLock</A></B>()</CODE>
293
294 <BR>
295 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the current user can lock the file denoted by this 
296  abstract pathname.</TD>
297 </TR>
298 <TR BGCOLOR="white" CLASS="TableRowColor">
299 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
300 <CODE>&nbsp;boolean</CODE></FONT></TD>
301 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canLookup()">canLookup</A></B>()</CODE>
302
303 <BR>
304 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the current user can lookup the contents of the directory
305  denoted by this abstract pathname.</TD>
306 </TR>
307 <TR BGCOLOR="white" CLASS="TableRowColor">
308 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
309 <CODE>&nbsp;boolean</CODE></FONT></TD>
310 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canRead()">canRead</A></B>()</CODE>
311
312 <BR>
313 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the current user can read the file denoted by this
314  abstract pathname.</TD>
315 </TR>
316 <TR BGCOLOR="white" CLASS="TableRowColor">
317 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
318 <CODE>&nbsp;boolean</CODE></FONT></TD>
319 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canWrite()">canWrite</A></B>()</CODE>
320
321 <BR>
322 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the current user can modify to the file denoted by this
323  abstract pathname.</TD>
324 </TR>
325 <TR BGCOLOR="white" CLASS="TableRowColor">
326 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
327 <CODE>&nbsp;boolean</CODE></FONT></TD>
328 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#close()">close</A></B>()</CODE>
329
330 <BR>
331 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Closes the directory denoted by this abstract pathname.</TD>
332 </TR>
333 <TR BGCOLOR="white" CLASS="TableRowColor">
334 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
335 <CODE>&nbsp;int</CODE></FONT></TD>
336 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#compareTo(org.openafs.jafs.File)">compareTo</A></B>(<A HREF="../../../org/openafs/jafs/File.html">File</A>&nbsp;file)</CODE>
337
338 <BR>
339 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Compares two File objects relative to their filenames and <B>does not</B>
340  compare their respective absolute paths.  </TD>
341 </TR>
342 <TR BGCOLOR="white" CLASS="TableRowColor">
343 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
344 <CODE>&nbsp;int</CODE></FONT></TD>
345 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#compareTo(java.lang.Object)">compareTo</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">Object</A>&nbsp;o)</CODE>
346
347 <BR>
348 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Compares this file to another File object.  </TD>
349 </TR>
350 <TR BGCOLOR="white" CLASS="TableRowColor">
351 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
352 <CODE>&nbsp;boolean</CODE></FONT></TD>
353 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#copyTo(org.openafs.jafs.File)">copyTo</A></B>(<A HREF="../../../org/openafs/jafs/File.html">File</A>&nbsp;dest)</CODE>
354
355 <BR>
356 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Copies the file denoted by this abstract pathname to the destination
357  file provided.  </TD>
358 </TR>
359 <TR BGCOLOR="white" CLASS="TableRowColor">
360 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
361 <CODE>&nbsp;boolean</CODE></FONT></TD>
362 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#delete()">delete</A></B>()</CODE>
363
364 <BR>
365 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Deletes the file or directory denoted by this abstract pathname.  </TD>
366 </TR>
367 <TR BGCOLOR="white" CLASS="TableRowColor">
368 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
369 <CODE>&nbsp;boolean</CODE></FONT></TD>
370 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#exists()">exists</A></B>()</CODE>
371
372 <BR>
373 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the file denoted by this abstract pathname exists.</TD>
374 </TR>
375 <TR BGCOLOR="white" CLASS="TableRowColor">
376 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
377 <CODE>&nbsp;int</CODE></FONT></TD>
378 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#getErrorCode()">getErrorCode</A></B>()</CODE>
379
380 <BR>
381 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the AFS specific error number (code).  </TD>
382 </TR>
383 <TR BGCOLOR="white" CLASS="TableRowColor">
384 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
385 <CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
386 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#getErrorMessage()">getErrorMessage</A></B>()</CODE>
387
388 <BR>
389 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the AFS error message string defined by the <code><A HREF="../../../org/openafs/jafs/ErrorTable.html"><CODE>ErrorTable</CODE></A></code>
390  class.</TD>
391 </TR>
392 <TR BGCOLOR="white" CLASS="TableRowColor">
393 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
394 <CODE>&nbsp;int</CODE></FONT></TD>
395 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#getPermissionsMask()">getPermissionsMask</A></B>()</CODE>
396
397 <BR>
398 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the permissions mask of the ACL for this object relative to the user accessing it.</TD>
399 </TR>
400 <TR BGCOLOR="white" CLASS="TableRowColor">
401 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
402 <CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
403 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#getTarget()">getTarget</A></B>()</CODE>
404
405 <BR>
406 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an abstract pathname string that represents the target resource of
407  of this file, if it is a symbolic-link.
408
409  </TD>
410 </TR>
411 <TR BGCOLOR="white" CLASS="TableRowColor">
412 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
413 <CODE>&nbsp;boolean</CODE></FONT></TD>
414 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#isDirectory()">isDirectory</A></B>()</CODE>
415
416 <BR>
417 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the file denoted by this abstract pathname is a
418  directory.</TD>
419 </TR>
420 <TR BGCOLOR="white" CLASS="TableRowColor">
421 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
422 <CODE>&nbsp;boolean</CODE></FONT></TD>
423 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#isFile()">isFile</A></B>()</CODE>
424
425 <BR>
426 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the file denoted by this abstract pathname is a normal
427  file.  </TD>
428 </TR>
429 <TR BGCOLOR="white" CLASS="TableRowColor">
430 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
431 <CODE>&nbsp;boolean</CODE></FONT></TD>
432 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#isLink()">isLink</A></B>()</CODE>
433
434 <BR>
435 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the file denoted by this abstract pathname is a
436  symbolic-link.</TD>
437 </TR>
438 <TR BGCOLOR="white" CLASS="TableRowColor">
439 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
440 <CODE>&nbsp;boolean</CODE></FONT></TD>
441 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#isMountPoint()">isMountPoint</A></B>()</CODE>
442
443 <BR>
444 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the file denoted by this abstract pathname is an
445  AFS Volume Mount Point.</TD>
446 </TR>
447 <TR BGCOLOR="white" CLASS="TableRowColor">
448 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
449 <CODE>&nbsp;boolean</CODE></FONT></TD>
450 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#isValidated()">isValidated</A></B>()</CODE>
451
452 <BR>
453 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the file denoted by this abstract pathname has
454  been validated.
455
456  </TD>
457 </TR>
458 <TR BGCOLOR="white" CLASS="TableRowColor">
459 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
460 <CODE>&nbsp;long</CODE></FONT></TD>
461 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#lastModified()">lastModified</A></B>()</CODE>
462
463 <BR>
464 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the time that the file denoted by this abstract pathname was
465  last modified.</TD>
466 </TR>
467 <TR BGCOLOR="white" CLASS="TableRowColor">
468 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
469 <CODE>&nbsp;long</CODE></FONT></TD>
470 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#length()">length</A></B>()</CODE>
471
472 <BR>
473 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the length of the file denoted by this abstract pathname.</TD>
474 </TR>
475 <TR BGCOLOR="white" CLASS="TableRowColor">
476 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
477 <CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>[]</CODE></FONT></TD>
478 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#list()">list</A></B>()</CODE>
479
480 <BR>
481 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an array of strings naming the files and directories in the
482  directory denoted by this abstract pathname.
483
484  </TD>
485 </TR>
486 <TR BGCOLOR="white" CLASS="TableRowColor">
487 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
488 <CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A></CODE></FONT></TD>
489 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#listArray()">listArray</A></B>()</CODE>
490
491 <BR>
492 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an ArrayList object containing strings naming the files and 
493  directories in the directory denoted by this abstract pathname.
494
495  </TD>
496 </TR>
497 <TR BGCOLOR="white" CLASS="TableRowColor">
498 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
499 <CODE>&nbsp;boolean</CODE></FONT></TD>
500 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#mkdir()">mkdir</A></B>()</CODE>
501
502 <BR>
503 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates the directory named by this abstract pathname.</TD>
504 </TR>
505 <TR BGCOLOR="white" CLASS="TableRowColor">
506 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
507 <CODE>&nbsp;void</CODE></FONT></TD>
508 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#refresh()">refresh</A></B>()</CODE>
509
510 <BR>
511 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Refreshes this AFS file object by updating its attributes.
512  </TD>
513 </TR>
514 <TR BGCOLOR="white" CLASS="TableRowColor">
515 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
516 <CODE>&nbsp;boolean</CODE></FONT></TD>
517 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#renameTo(org.openafs.jafs.File)">renameTo</A></B>(<A HREF="../../../org/openafs/jafs/File.html">File</A>&nbsp;dest)</CODE>
518
519 <BR>
520 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Renames the file denoted by this abstract pathname.</TD>
521 </TR>
522 <TR BGCOLOR="white" CLASS="TableRowColor">
523 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
524 <CODE>&nbsp;boolean</CODE></FONT></TD>
525 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#setAttributes()">setAttributes</A></B>()</CODE>
526
527 <BR>
528 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Performs a file <code>stat</code> on the actual AFS file and populates  
529  this object's respective field members with the appropriate values.
530  </TD>
531 </TR>
532 <TR BGCOLOR="white" CLASS="TableRowColor">
533 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
534 <CODE>&nbsp;void</CODE></FONT></TD>
535 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#validate()">validate</A></B>()</CODE>
536
537 <BR>
538 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Validates this abstract pathname as an attributed AFS file object.  
539  </TD>
540 </TR>
541 </TABLE>
542 &nbsp;<A NAME="methods_inherited_from_class_java.io.File"><!-- --></A>
543 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
544 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
545 <TD><B>Methods inherited from class java.io.<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></B></TD>
546 </TR>
547 <TR BGCOLOR="white" CLASS="TableRowColor">
548 <TD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#compareTo(java.io.File)">compareTo</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#createNewFile()">createNewFile</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#createTempFile(java.lang.String, java.lang.String)">createTempFile</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#createTempFile(java.lang.String, java.lang.String, java.io.File)">createTempFile</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#deleteOnExit()">deleteOnExit</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#equals(java.lang.Object)">equals</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#getAbsoluteFile()">getAbsoluteFile</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#getAbsolutePath()">getAbsolutePath</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#getCanonicalFile()">getCanonicalFile</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#getCanonicalPath()">getCanonicalPath</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#getName()">getName</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#getParent()">getParent</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#getParentFile()">getParentFile</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#getPath()">getPath</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#hashCode()">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#isAbsolute()">isAbsolute</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#isHidden()">isHidden</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#list(java.io.FilenameFilter)">list</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#listFiles()">listFiles</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#listFiles(java.io.FileFilter)">listFiles</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#listFiles(java.io.FilenameFilter)">listFiles</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#listRoots()">listRoots</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#mkdirs()">mkdirs</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#renameTo(java.io.File)">renameTo</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#setLastModified(long)">setLastModified</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#setReadOnly()">setReadOnly</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#toString()">toString</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#toURI()">toURI</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#toURL()">toURL</A></CODE></TD>
549 </TR>
550 </TABLE>
551 &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
552 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
553 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
554 <TD><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">Object</A></B></TD>
555 </TR>
556 <TR BGCOLOR="white" CLASS="TableRowColor">
557 <TD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#clone()">clone</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#finalize()">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#getClass()">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notify()">notify</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notifyAll()">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait()">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long)">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long, int)">wait</A></CODE></TD>
558 </TR>
559 </TABLE>
560 &nbsp;
561 <P>
562
563 <!-- ============ FIELD DETAIL =========== -->
564
565
566 <!-- ========= CONSTRUCTOR DETAIL ======== -->
567
568 <A NAME="constructor_detail"><!-- --></A>
569 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
570 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
571 <TD COLSPAN=1><FONT SIZE="+2">
572 <B>Constructor Detail</B></FONT></TD>
573 </TR>
574 </TABLE>
575
576 <A NAME="File(java.lang.String)"><!-- --></A><H3>
577 File</H3>
578 <PRE>
579 public <B>File</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;pathname)
580      throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
581 <DL>
582 <DD>Creates a new <code>File</code> instance by converting the given
583  pathname string into an abstract pathname and validating it against
584  the file system.  If the given string is an empty string, then the 
585  result is the empty abstract pathname; otherwise the abstract pathname 
586  is <code>validated</code> to represent a qualified file object.
587 <P>
588 <DT><B>Parameters:</B><DD><CODE>pathname</CODE> - A pathname string
589 <DT><B>Throws:</B>
590 <DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/NullPointerException.html">NullPointerException</A></CODE> - If the <code>pathname</code> argument is <code>null</code>
591 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If the user constructing this AFS file object is denied
592           access to stat the file or simply a stat cannot be performed
593           on the file. The reason code and message will be available
594           from <A HREF="../../../org/openafs/jafs/AFSFileException.html#getErrorCode()"><CODE>AFSFileException.getErrorCode()</CODE></A> and 
595           <A HREF="../../../org/openafs/jafs/AFSFileException.html#getMessage()"><CODE>AFSFileException.getMessage()</CODE></A> respectively.
596           <p> This exception <U>will not</U> be thrown if the file does not
597           exist.  Rather, the <A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A> attribute will be set to
598           <code>false</code>.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
599 <HR>
600
601 <A NAME="File(java.lang.String, boolean)"><!-- --></A><H3>
602 File</H3>
603 <PRE>
604 public <B>File</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;pathname,
605             boolean&nbsp;validate)</PRE>
606 <DL>
607 <DD>Creates a new <code>File</code> instance by converting the given
608  pathname string into an abstract pathname.  If the given string is
609  an empty string, then the result is the empty abstract pathname.
610
611  <p> The abstract pathname will remain <B>abstract</B> unless the
612  <code>validate</code> parameter is set to <code>true</code>. This
613  means that the abstract pathname will <U>not</U> be <code>validated</code>
614  and therefore the file object will not represent a qualified, attributed,
615  AFS file resource.  Rather, this constructor provides a method by which
616  you can construct a non-validated <code>File</code> object (one that
617  does not contain the file's complete status information).
618
619  <p> This constructor is useful for creating file objects of file/path names
620  that you know exist, however are unauthorized to <code>validate</code> (or
621  <code>stat</code> - to obtain complete status information). For example,
622  if you are permitted to <code>lookup</code> (see: <A HREF="../../../org/openafs/jafs/File.html#canLookup()"><CODE>canLookup()</CODE></A>) the
623  contents of a given directory yet <U>not</U> permitted to <code>read</code>
624  (see: <A HREF="../../../org/openafs/jafs/File.html#canRead()"><CODE>canRead()</CODE></A>), then this constructor would enable you to render the
625  contents of the directory without validating each entry.
626
627  <p> <B>Please note:</B> this is the only constructor that does not throw an AFSFileException.
628 <P>
629 <DT><B>Parameters:</B><DD><CODE>pathname</CODE> - A pathname string<DD><CODE>validate</CODE> - A boolean flag to indicate if this abstract path
630                                 should be validated.
631 <DT><B>Throws:</B>
632 <DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/NullPointerException.html">NullPointerException</A></CODE> - If the <code>pathname</code> argument is <code>null</code><DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#File(java.lang.String)"><CODE>File(String)</CODE></A>, 
633 <A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
634 <HR>
635
636 <A NAME="File(java.lang.String, java.lang.String)"><!-- --></A><H3>
637 File</H3>
638 <PRE>
639 public <B>File</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;parent,
640             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;filename)
641      throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
642 <DL>
643 <DD>Creates a new <code>File</code> instance from a parent pathname string
644  and a child pathname string and validates it against the file system.
645
646  <p> If <code>parent</code> is <code>null</code> then the new
647  <code>File</code> instance is created as if by invoking the
648  single-argument <code>File</code> constructor on the given
649  <code>filename</code> string (child pathname).
650
651  <p> Otherwise the <code>parent</code> pathname string is taken to denote
652  a directory, and the <code>filename</code> string is taken to
653  denote either a directory or a file. The directory or file will then be
654  <code>validated</code> to represent a qualified file object.
655 <P>
656 <DT><B>Parameters:</B><DD><CODE>parent</CODE> - The parent pathname string<DD><CODE>filename</CODE> - This file's pathname string (child of specified parent)
657 <DT><B>Throws:</B>
658 <DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/NullPointerException.html">NullPointerException</A></CODE> - If <code>child</code> is <code>null</code>
659 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If the user constructing this AFS file object is denied
660           access to stat the file or simply a stat cannot be performed
661           on the file. The reason code and message will be available
662           from <A HREF="../../../org/openafs/jafs/AFSFileException.html#getErrorCode()"><CODE>AFSFileException.getErrorCode()</CODE></A> and 
663           <A HREF="../../../org/openafs/jafs/AFSFileException.html#getMessage()"><CODE>AFSFileException.getMessage()</CODE></A> respectively.
664           <p> This exception <U>will not</U> be thrown if the file does not
665           exist.  Rather, the <A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A> attribute will be set to
666           <code>false</code>.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
667 <HR>
668
669 <A NAME="File(java.lang.String, java.lang.String, boolean)"><!-- --></A><H3>
670 File</H3>
671 <PRE>
672 public <B>File</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;parent,
673             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;filename,
674             boolean&nbsp;validate)
675      throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
676 <DL>
677 <DD>Creates a new <code>File</code> instance from a parent pathname string
678  and a child pathname string.
679
680  <p> If <code>parent</code> is <code>null</code> then the new
681  <code>File</code> instance is created as if by invoking the
682  single-argument <code>File</code> constructor on the given
683  <code>filename</code> string (child pathname).
684
685  <p> Otherwise the <code>parent</code> pathname string is taken to denote
686  a directory, and the <code>filename</code> string is taken to
687  denote either a directory or a file.
688
689  <p> The abstract pathname will remain <B>abstract</B> unless the
690  <code>validate</code> parameter is set to <code>true</code>. This
691  means that the abstract pathname will <U>not</U> be <code>validated</code>
692  and therefore the file object will not represent a qualified, attributed,
693  AFS file resource.  Rather, this constructor provides a method by which
694  you can construct a non-validated <code>File</code> object (one that
695  does not contain the file's complete status information).
696
697  <p> This constructor is useful for creating file objects of file/path names
698  that you know exist, however are unauthorized to <code>validate</code> (or
699  <code>stat</code> - to obtain complete status information). For example,
700  if you are permitted to <code>lookup</code> (see: <A HREF="../../../org/openafs/jafs/File.html#canLookup()"><CODE>canLookup()</CODE></A>) the
701  contents of a given directory yet <U>not</U> permitted to <code>read</code>
702  (see: <A HREF="../../../org/openafs/jafs/File.html#canRead()"><CODE>canRead()</CODE></A>), then this constructor would enable you to render the
703  contents of the directory without validating each entry.
704 <P>
705 <DT><B>Parameters:</B><DD><CODE>parent</CODE> - The parent pathname string<DD><CODE>filename</CODE> - This file's pathname string (child of specified parent)<DD><CODE>validate</CODE> - A boolean flag to indicate if this abstract path
706                                 should be validated.
707 <DT><B>Throws:</B>
708 <DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/NullPointerException.html">NullPointerException</A></CODE> - If <code>child</code> is <code>null</code>
709 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If the user constructing this AFS file object is denied
710           access to stat the file or simply a stat cannot be performed
711           on the file. The reason code and message will be available
712           from <A HREF="../../../org/openafs/jafs/AFSFileException.html#getErrorCode()"><CODE>AFSFileException.getErrorCode()</CODE></A> and 
713           <A HREF="../../../org/openafs/jafs/AFSFileException.html#getMessage()"><CODE>AFSFileException.getMessage()</CODE></A> respectively.
714           <p> This exception <U>will not</U> be thrown if the file does not
715           exist.  Rather, the <A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A> attribute will be set to
716           <code>false</code>.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#File(java.lang.String, java.lang.String)"><CODE>File(String, String)</CODE></A>, 
717 <A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
718 <HR>
719
720 <A NAME="File(org.openafs.jafs.File, java.lang.String)"><!-- --></A><H3>
721 File</H3>
722 <PRE>
723 public <B>File</B>(<A HREF="../../../org/openafs/jafs/File.html">File</A>&nbsp;parent,
724             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;filename)
725      throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
726 <DL>
727 <DD>Creates a new <code>File</code> instance from a parent abstract
728  pathname and a child pathname string and validates it against the file system.
729
730  <p> If <code>parent</code> is <code>null</code> then the new
731  <code>File</code> instance is created as if by invoking the
732  single-argument <code>File</code> constructor on the given
733  <code>filename</code> string (child pathname).
734
735  <p> Otherwise the <code>parent</code> abstract pathname is taken to
736  denote a directory, and the <code>filename</code> string is taken
737  to denote either a directory or a file.  The directory or file will then be
738  <code>validated</code> to represent a qualified file object.
739 <P>
740 <DT><B>Parameters:</B><DD><CODE>parent</CODE> - The parent abstract pathname<DD><CODE>filename</CODE> - This file's pathname string (child of specified parent)
741 <DT><B>Throws:</B>
742 <DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/NullPointerException.html">NullPointerException</A></CODE> - If <code>child</code> is <code>null</code>
743 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If the user constructing this AFS file object is denied
744           access to stat the file or simply a stat cannot be performed
745           on the file. The reason code and message will be available
746           from <A HREF="../../../org/openafs/jafs/AFSFileException.html#getErrorCode()"><CODE>AFSFileException.getErrorCode()</CODE></A> and 
747           <A HREF="../../../org/openafs/jafs/AFSFileException.html#getMessage()"><CODE>AFSFileException.getMessage()</CODE></A> respectively.
748           <p> This exception <U>will not</U> be thrown if the file does not
749           exist.  Rather, the <A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A> attribute will be set to
750           <code>false</code>.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
751 <HR>
752
753 <A NAME="File(org.openafs.jafs.File, java.lang.String, boolean)"><!-- --></A><H3>
754 File</H3>
755 <PRE>
756 public <B>File</B>(<A HREF="../../../org/openafs/jafs/File.html">File</A>&nbsp;parent,
757             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;filename,
758             boolean&nbsp;validate)
759      throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
760 <DL>
761 <DD>Creates a new <code>File</code> instance from a parent abstract
762  pathname and a child pathname string.
763
764  <p> If <code>parent</code> is <code>null</code> then the new
765  <code>File</code> instance is created as if by invoking the
766  single-argument <code>File</code> constructor on the given
767  <code>filename</code> string (child pathname).
768
769  <p> Otherwise the <code>parent</code> abstract pathname is taken to
770  denote a directory, and the <code>filename</code> string is taken
771  to denote either a directory or a file.
772
773  <p> The abstract pathname will remain <B>abstract</B> unless the
774  <code>validate</code> parameter is set to <code>true</code>. This
775  means that the abstract pathname will <U>not</U> be <code>validated</code>
776  and therefore the file object will not represent a qualified, attributed,
777  AFS file resource.  Rather, this constructor provides a method by which
778  you can construct a non-validated <code>File</code> object (one that
779  does not contain the file's complete status information).
780
781  <p> This constructor is useful for creating file objects of file/path names
782  that you know exist, however are unauthorized to <code>validate</code> (or
783  <code>stat</code> - to obtain complete status information). For example,
784  if you are permitted to <code>lookup</code> (see: <A HREF="../../../org/openafs/jafs/File.html#canLookup()"><CODE>canLookup()</CODE></A>) the
785  contents of a given directory yet <U>not</U> permitted to <code>read</code>
786  (see: <A HREF="../../../org/openafs/jafs/File.html#canRead()"><CODE>canRead()</CODE></A>), then this constructor would enable you to render the
787  contents of the directory without validating each entry.
788 <P>
789 <DT><B>Parameters:</B><DD><CODE>parent</CODE> - The parent abstract pathname<DD><CODE>filename</CODE> - This file's pathname string (child of specified parent)<DD><CODE>validate</CODE> - A boolean flag to indicate if this abstract path
790                                 should be validated.
791 <DT><B>Throws:</B>
792 <DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/NullPointerException.html">NullPointerException</A></CODE> - If <code>child</code> is <code>null</code>
793 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If the user constructing this AFS file object is denied
794           access to stat the file or simply a stat cannot be performed
795           on the file. The reason code and message will be available
796           from <A HREF="../../../org/openafs/jafs/AFSFileException.html#getErrorCode()"><CODE>AFSFileException.getErrorCode()</CODE></A> and 
797           <A HREF="../../../org/openafs/jafs/AFSFileException.html#getMessage()"><CODE>AFSFileException.getMessage()</CODE></A> respectively.
798           <p> This exception <U>will not</U> be thrown if the file does not
799           exist.  Rather, the <A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A> attribute will be set to
800           <code>false</code>.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A>, 
801 <A HREF="../../../org/openafs/jafs/File.html#File(org.openafs.jafs.File, java.lang.String)"><CODE>File(File, String)</CODE></A></DL>
802
803 <!-- ============ METHOD DETAIL ========== -->
804
805 <A NAME="method_detail"><!-- --></A>
806 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
807 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
808 <TD COLSPAN=1><FONT SIZE="+2">
809 <B>Method Detail</B></FONT></TD>
810 </TR>
811 </TABLE>
812
813 <A NAME="validate()"><!-- --></A><H3>
814 validate</H3>
815 <PRE>
816 public void <B>validate</B>()
817               throws <A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></PRE>
818 <DL>
819 <DD>Validates this abstract pathname as an attributed AFS file object.  
820  This method will, if authorized, perform a <code>stat</code> on the
821  actual AFS file and update its respective field members; defining
822  this file object's attributes.
823 <P>
824 <DD><DL>
825 </DL>
826 </DD>
827 <DD><DL>
828
829 <DT><B>Throws:</B>
830 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></CODE> - If an AFS exception occurs while attempting to stat and set this
831           AFS file object's attributes.</DL>
832 </DD>
833 </DL>
834 <HR>
835
836 <A NAME="isValidated()"><!-- --></A><H3>
837 isValidated</H3>
838 <PRE>
839 public boolean <B>isValidated</B>()</PRE>
840 <DL>
841 <DD>Tests whether the file denoted by this abstract pathname has
842  been validated.
843
844  <P> Validation is always attempted upon construction of the file object,
845  therefore if this method returns false, then you are not permitted to 
846  <code>validate</code> this file and consequently all attribute accessors
847  will be invalid.
848
849  <P> This method should return <code>true</code> even if this abstract 
850  pathname does not exist. If this is abstract pathname does not exist then
851  the <code><A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A></code> method should return false, however this
852  implies that the attribute accessors are valid and accurate; thus implying
853  successful validation.
854
855  <P> This method is useful before calling any of the attribute accessors
856  to ensure a valid response.
857 <P>
858 <DD><DL>
859 </DL>
860 </DD>
861 <DD><DL>
862
863 <DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
864           abstract pathname has been validated during or after object construction;
865           <code>false</code> otherwise</DL>
866 </DD>
867 </DL>
868 <HR>
869
870 <A NAME="refresh()"><!-- --></A><H3>
871 refresh</H3>
872 <PRE>
873 public void <B>refresh</B>()
874              throws <A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></PRE>
875 <DL>
876 <DD>Refreshes this AFS file object by updating its attributes.
877  This method currently provides the same functionality as
878  <A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A>.
879 <P>
880 <DD><DL>
881 </DL>
882 </DD>
883 <DD><DL>
884
885 <DT><B>Throws:</B>
886 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></CODE> - If an AFS exception occurs while attempting to stat and update this
887           AFS file object's attributes.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
888 </DD>
889 </DL>
890 <HR>
891
892 <A NAME="isDirectory()"><!-- --></A><H3>
893 isDirectory</H3>
894 <PRE>
895 public boolean <B>isDirectory</B>()</PRE>
896 <DL>
897 <DD>Tests whether the file denoted by this abstract pathname is a
898  directory.
899 <P>
900 <DD><DL>
901 <DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#isDirectory()">isDirectory</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
902 </DD>
903 <DD><DL>
904
905 <DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
906           abstract pathname exists <em>and</em> is a directory;
907           <code>false</code> otherwise</DL>
908 </DD>
909 </DL>
910 <HR>
911
912 <A NAME="isFile()"><!-- --></A><H3>
913 isFile</H3>
914 <PRE>
915 public boolean <B>isFile</B>()</PRE>
916 <DL>
917 <DD>Tests whether the file denoted by this abstract pathname is a normal
918  file.  A file is <em>normal</em> if it is not a directory and, in
919  addition, satisfies other system-dependent criteria.  Any non-directory
920  file created by a Java application is guaranteed to be a normal file.
921 <P>
922 <DD><DL>
923 <DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#isFile()">isFile</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
924 </DD>
925 <DD><DL>
926
927 <DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
928           abstract pathname exists <em>and</em> is a normal file;
929           <code>false</code> otherwise</DL>
930 </DD>
931 </DL>
932 <HR>
933
934 <A NAME="isMountPoint()"><!-- --></A><H3>
935 isMountPoint</H3>
936 <PRE>
937 public boolean <B>isMountPoint</B>()</PRE>
938 <DL>
939 <DD>Tests whether the file denoted by this abstract pathname is an
940  AFS Volume Mount Point.
941 <P>
942 <DD><DL>
943 </DL>
944 </DD>
945 <DD><DL>
946
947 <DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
948           abstract pathname exists <em>and</em> is a mount point;
949           <code>false</code> otherwise</DL>
950 </DD>
951 </DL>
952 <HR>
953
954 <A NAME="isLink()"><!-- --></A><H3>
955 isLink</H3>
956 <PRE>
957 public boolean <B>isLink</B>()</PRE>
958 <DL>
959 <DD>Tests whether the file denoted by this abstract pathname is a
960  symbolic-link.
961 <P>
962 <DD><DL>
963 </DL>
964 </DD>
965 <DD><DL>
966
967 <DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
968           abstract pathname exists <em>and</em> is a symbolic-link;
969           <code>false</code> otherwise</DL>
970 </DD>
971 </DL>
972 <HR>
973
974 <A NAME="exists()"><!-- --></A><H3>
975 exists</H3>
976 <PRE>
977 public boolean <B>exists</B>()</PRE>
978 <DL>
979 <DD>Tests whether the file denoted by this abstract pathname exists.
980 <P>
981 <DD><DL>
982 <DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#exists()">exists</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
983 </DD>
984 <DD><DL>
985
986 <DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
987           abstract pathname exists; <code>false</code> otherwise</DL>
988 </DD>
989 </DL>
990 <HR>
991
992 <A NAME="lastModified()"><!-- --></A><H3>
993 lastModified</H3>
994 <PRE>
995 public long <B>lastModified</B>()</PRE>
996 <DL>
997 <DD>Returns the time that the file denoted by this abstract pathname was
998  last modified.
999 <P>
1000 <DD><DL>
1001 <DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#lastModified()">lastModified</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
1002 </DD>
1003 <DD><DL>
1004
1005 <DT><B>Returns:</B><DD>A <code>long</code> value representing the time the file was
1006           last modified, measured in milliseconds since the epoch
1007           (00:00:00 GMT, January 1, 1970), or <code>0L</code> if the
1008           file does not exist or if an I/O error occurs</DL>
1009 </DD>
1010 </DL>
1011 <HR>
1012
1013 <A NAME="length()"><!-- --></A><H3>
1014 length</H3>
1015 <PRE>
1016 public long <B>length</B>()</PRE>
1017 <DL>
1018 <DD>Returns the length of the file denoted by this abstract pathname.
1019 <P>
1020 <DD><DL>
1021 <DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#length()">length</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
1022 </DD>
1023 <DD><DL>
1024
1025 <DT><B>Returns:</B><DD>The length, in bytes, of the file denoted by this abstract
1026           pathname, or <code>0L</code> if the file does not exist</DL>
1027 </DD>
1028 </DL>
1029 <HR>
1030
1031 <A NAME="getTarget()"><!-- --></A><H3>
1032 getTarget</H3>
1033 <PRE>
1034 public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>getTarget</B>()</PRE>
1035 <DL>
1036 <DD>Returns an abstract pathname string that represents the target resource of
1037  of this file, if it is a symbolic-link.
1038
1039  <p> If this abstract pathname <B>does not</B> denote a symbolic-link, then this
1040  method returns <code>null</code>.  Otherwise a string is
1041  returned that represents the target resource of this symbolic-link.
1042 <P>
1043 <DD><DL>
1044 </DL>
1045 </DD>
1046 <DD><DL>
1047
1048 <DT><B>Returns:</B><DD>A string representation of this symbolic-link's target resource.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#isLink()"><CODE>isLink()</CODE></A></DL>
1049 </DD>
1050 </DL>
1051 <HR>
1052
1053 <A NAME="list()"><!-- --></A><H3>
1054 list</H3>
1055 <PRE>
1056 public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>[] <B>list</B>()</PRE>
1057 <DL>
1058 <DD>Returns an array of strings naming the files and directories in the
1059  directory denoted by this abstract pathname.
1060
1061  <p> If this abstract pathname does not denote a directory, then this
1062  method returns <code>null</code>.  Otherwise an array of strings is
1063  returned, one for each file or directory in the directory.  Names
1064  denoting the directory itself and the directory's parent directory are
1065  not included in the result.  Each string is a file name rather than a
1066  complete path.
1067
1068  <p> There is no guarantee that the name strings in the resulting array
1069  will appear in any specific order; they are not, in particular,
1070  guaranteed to appear in alphabetical order.
1071 <P>
1072 <DD><DL>
1073 <DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#list()">list</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
1074 </DD>
1075 <DD><DL>
1076
1077 <DT><B>Returns:</B><DD>An array of strings naming the files and directories in the
1078           directory denoted by this abstract pathname.  The array will be
1079           empty if the directory is empty.  Returns <code>null</code> if
1080           this abstract pathname does not denote a directory, or if an
1081           I/O error occurs.</DL>
1082 </DD>
1083 </DL>
1084 <HR>
1085
1086 <A NAME="listArray()"><!-- --></A><H3>
1087 listArray</H3>
1088 <PRE>
1089 public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A> <B>listArray</B>()
1090                     throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
1091 <DL>
1092 <DD>Returns an ArrayList object containing strings naming the files and 
1093  directories in the directory denoted by this abstract pathname.
1094
1095  <p> If this abstract pathname does not denote a directory, then this
1096  method returns <code>null</code>.  Otherwise an array of strings is
1097  returned, one for each file or directory in the directory.  Names
1098  denoting the directory itself and the directory's parent directory are
1099  not included in the result.  Each string is a file name rather than a
1100  complete path.
1101
1102  <p> There is no guarantee that the name strings in the resulting array
1103  will appear in any specific order; they are not, in particular,
1104  guaranteed to appear in alphabetical order.
1105 <P>
1106 <DD><DL>
1107 </DL>
1108 </DD>
1109 <DD><DL>
1110
1111 <DT><B>Returns:</B><DD>An array of strings naming the files and directories in the
1112           directory denoted by this abstract pathname.  The array will be
1113           empty if the directory is empty.  Returns <code>null</code> if
1114           this abstract pathname does not denote a directory, or if an
1115           I/O error occurs.
1116 <DT><B>Throws:</B>
1117 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></CODE> - If you are not authorized to list the contents of this directory
1118 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If this file object is not a <code>mount point</code>, <code>link
1119           </code>, or <code>directory</code> <B>or</B> an unexpected AFS 
1120           error occurs.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#list()"><CODE>list()</CODE></A></DL>
1121 </DD>
1122 </DL>
1123 <HR>
1124
1125 <A NAME="delete()"><!-- --></A><H3>
1126 delete</H3>
1127 <PRE>
1128 public boolean <B>delete</B>()</PRE>
1129 <DL>
1130 <DD>Deletes the file or directory denoted by this abstract pathname.  If
1131  this pathname denotes a directory, then the directory must be empty in
1132  order to be deleted.
1133 <P>
1134 <DD><DL>
1135 <DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#delete()">delete</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
1136 </DD>
1137 <DD><DL>
1138
1139 <DT><B>Returns:</B><DD><code>true</code> if and only if the file or directory is
1140           successfully deleted; <code>false</code> otherwise</DL>
1141 </DD>
1142 </DL>
1143 <HR>
1144
1145 <A NAME="copyTo(org.openafs.jafs.File)"><!-- --></A><H3>
1146 copyTo</H3>
1147 <PRE>
1148 public boolean <B>copyTo</B>(<A HREF="../../../org/openafs/jafs/File.html">File</A>&nbsp;dest)
1149                throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
1150 <DL>
1151 <DD>Copies the file denoted by this abstract pathname to the destination
1152  file provided.  Then checks the newly copied file's size to
1153  test for file size consistency.
1154 <P>
1155 <DD><DL>
1156 </DL>
1157 </DD>
1158 <DD><DL>
1159 <DT><B>Parameters:</B><DD><CODE>dest</CODE> - The new abstract pathname for the named file
1160 <DT><B>Returns:</B><DD><code>true</code> if and only if the file that was copied
1161           reports the same file size (length) as that of this file;
1162           <code>false</code> otherwise
1163 <DT><B>Throws:</B>
1164 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If an I/O or AFS exception is encountered while copying the file.</DL>
1165 </DD>
1166 </DL>
1167 <HR>
1168
1169 <A NAME="getPermissionsMask()"><!-- --></A><H3>
1170 getPermissionsMask</H3>
1171 <PRE>
1172 public int <B>getPermissionsMask</B>()</PRE>
1173 <DL>
1174 <DD>Returns the permissions mask of the ACL for this object relative to the user accessing it.
1175 <P>
1176 <DD><DL>
1177 </DL>
1178 </DD>
1179 <DD><DL>
1180
1181 <DT><B>Returns:</B><DD>the permissions mask of this object based upon the current user.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#getPermissionsMask()"><CODE>ACL.Entry.getPermissionsMask()</CODE></A></DL>
1182 </DD>
1183 </DL>
1184 <HR>
1185
1186 <A NAME="canAdmin()"><!-- --></A><H3>
1187 canAdmin</H3>
1188 <PRE>
1189 public boolean <B>canAdmin</B>()</PRE>
1190 <DL>
1191 <DD>Tests whether the user can administer the ACL (see: <A HREF="../../../org/openafs/jafs/ACL.html"><CODE>ACL</CODE></A>
1192  of the directory denoted by this abstract pathname.
1193 <P>
1194 <DD><DL>
1195 </DL>
1196 </DD>
1197 <DD><DL>
1198
1199 <DT><B>Returns:</B><DD><code>true</code> if and only if the directory specified by this
1200           abstract pathname exists <em>and</em> can be administered by the
1201           current user; <code>false</code> otherwise<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canAdmin()"><CODE>ACL.Entry.canAdmin()</CODE></A></DL>
1202 </DD>
1203 </DL>
1204 <HR>
1205
1206 <A NAME="canDelete()"><!-- --></A><H3>
1207 canDelete</H3>
1208 <PRE>
1209 public boolean <B>canDelete</B>()</PRE>
1210 <DL>
1211 <DD>Tests whether the current user can delete the files or subdirectories of
1212  the directory denoted by this abstract pathname.
1213 <P>
1214 <DD><DL>
1215 </DL>
1216 </DD>
1217 <DD><DL>
1218
1219 <DT><B>Returns:</B><DD><code>true</code> if and only if the directory specified by this
1220           abstract pathname exists <em>and</em> permits deletion of its files
1221           and subdirectories by the current user; <code>false</code> otherwise<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canDelete()"><CODE>ACL.Entry.canDelete()</CODE></A></DL>
1222 </DD>
1223 </DL>
1224 <HR>
1225
1226 <A NAME="canInsert()"><!-- --></A><H3>
1227 canInsert</H3>
1228 <PRE>
1229 public boolean <B>canInsert</B>()</PRE>
1230 <DL>
1231 <DD>Tests whether the current user can insert a file into the directory
1232  denoted by this abstract pathname.
1233 <P>
1234 <DD><DL>
1235 </DL>
1236 </DD>
1237 <DD><DL>
1238
1239 <DT><B>Returns:</B><DD><code>true</code> if and only if the directory specified by this
1240           abstract pathname exists <em>and</em> a file can be inserted by the
1241           current user; <code>false</code> otherwise<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canInsert()"><CODE>ACL.Entry.canInsert()</CODE></A></DL>
1242 </DD>
1243 </DL>
1244 <HR>
1245
1246 <A NAME="canLock()"><!-- --></A><H3>
1247 canLock</H3>
1248 <PRE>
1249 public boolean <B>canLock</B>()</PRE>
1250 <DL>
1251 <DD>Tests whether the current user can lock the file denoted by this 
1252  abstract pathname.
1253 <P>
1254 <DD><DL>
1255 </DL>
1256 </DD>
1257 <DD><DL>
1258
1259 <DT><B>Returns:</B><DD><code>true</code> if and only if the file specified by this
1260           abstract pathname exists <em>and</em> can be locked by the
1261           current user; <code>false</code> otherwise<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canLock()"><CODE>ACL.Entry.canLock()</CODE></A></DL>
1262 </DD>
1263 </DL>
1264 <HR>
1265
1266 <A NAME="canLookup()"><!-- --></A><H3>
1267 canLookup</H3>
1268 <PRE>
1269 public boolean <B>canLookup</B>()</PRE>
1270 <DL>
1271 <DD>Tests whether the current user can lookup the contents of the directory
1272  denoted by this abstract pathname.
1273 <P>
1274 <DD><DL>
1275 </DL>
1276 </DD>
1277 <DD><DL>
1278
1279 <DT><B>Returns:</B><DD><code>true</code> if and only if the directory specified by this
1280           abstract pathname exists <em>and</em> its contents can be listed by the
1281           current user; <code>false</code> otherwise<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canLookup()"><CODE>ACL.Entry.canLookup()</CODE></A></DL>
1282 </DD>
1283 </DL>
1284 <HR>
1285
1286 <A NAME="canRead()"><!-- --></A><H3>
1287 canRead</H3>
1288 <PRE>
1289 public boolean <B>canRead</B>()</PRE>
1290 <DL>
1291 <DD>Tests whether the current user can read the file denoted by this
1292  abstract pathname.
1293 <P>
1294 <DD><DL>
1295 <DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#canRead()">canRead</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
1296 </DD>
1297 <DD><DL>
1298
1299 <DT><B>Returns:</B><DD><code>true</code> if and only if the file specified by this
1300           abstract pathname exists <em>and</em> can be read by the
1301           current user; <code>false</code> otherwise<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canRead()"><CODE>ACL.Entry.canRead()</CODE></A></DL>
1302 </DD>
1303 </DL>
1304 <HR>
1305
1306 <A NAME="canWrite()"><!-- --></A><H3>
1307 canWrite</H3>
1308 <PRE>
1309 public boolean <B>canWrite</B>()</PRE>
1310 <DL>
1311 <DD>Tests whether the current user can modify to the file denoted by this
1312  abstract pathname.
1313 <P>
1314 <DD><DL>
1315 <DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#canWrite()">canWrite</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
1316 </DD>
1317 <DD><DL>
1318
1319 <DT><B>Returns:</B><DD><code>true</code> if and only if the file system actually
1320           contains a file denoted by this abstract pathname <em>and</em>
1321           the current user is allowed to write to the file;
1322           <code>false</code> otherwise.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canWrite()"><CODE>ACL.Entry.canWrite()</CODE></A></DL>
1323 </DD>
1324 </DL>
1325 <HR>
1326
1327 <A NAME="close()"><!-- --></A><H3>
1328 close</H3>
1329 <PRE>
1330 public boolean <B>close</B>()</PRE>
1331 <DL>
1332 <DD>Closes the directory denoted by this abstract pathname.
1333 <P>
1334 <DD><DL>
1335 </DL>
1336 </DD>
1337 <DD><DL>
1338
1339 <DT><B>Returns:</B><DD><code>true</code> if and only if the directory is
1340           successfully closed; <code>false</code> otherwise</DL>
1341 </DD>
1342 </DL>
1343 <HR>
1344
1345 <A NAME="getErrorCode()"><!-- --></A><H3>
1346 getErrorCode</H3>
1347 <PRE>
1348 public int <B>getErrorCode</B>()</PRE>
1349 <DL>
1350 <DD>Returns the AFS specific error number (code).  This code can be interpreted 
1351  by use of <code><A HREF="../../../org/openafs/jafs/ErrorTable.html"><CODE>ErrorTable</CODE></A></code> static class method 
1352  <code><A HREF="../../../org/openafs/jafs/ErrorTable.html#getMessage(int)"><CODE>ErrorTable.getMessage(int)</CODE></A></code>
1353 <P>
1354 <DD><DL>
1355 </DL>
1356 </DD>
1357 <DD><DL>
1358
1359 <DT><B>Returns:</B><DD>the AFS error code (number) associated with the last action performed
1360           on this object.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ErrorTable.html#getMessage(int)"><CODE>ErrorTable.getMessage(int)</CODE></A></DL>
1361 </DD>
1362 </DL>
1363 <HR>
1364
1365 <A NAME="getErrorMessage()"><!-- --></A><H3>
1366 getErrorMessage</H3>
1367 <PRE>
1368 public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>getErrorMessage</B>()</PRE>
1369 <DL>
1370 <DD>Returns the AFS error message string defined by the <code><A HREF="../../../org/openafs/jafs/ErrorTable.html"><CODE>ErrorTable</CODE></A></code>
1371  class.
1372 <P>
1373 <DD><DL>
1374 </DL>
1375 </DD>
1376 <DD><DL>
1377
1378 <DT><B>Returns:</B><DD>the AFS error message string associated with the last action performed
1379           on this object.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ErrorTable.html#getMessage(int)"><CODE>ErrorTable.getMessage(int)</CODE></A></DL>
1380 </DD>
1381 </DL>
1382 <HR>
1383
1384 <A NAME="compareTo(org.openafs.jafs.File)"><!-- --></A><H3>
1385 compareTo</H3>
1386 <PRE>
1387 public int <B>compareTo</B>(<A HREF="../../../org/openafs/jafs/File.html">File</A>&nbsp;file)</PRE>
1388 <DL>
1389 <DD>Compares two File objects relative to their filenames and <B>does not</B>
1390  compare their respective absolute paths.  Alphabetic case is significant in 
1391  comparing filenames.
1392 <P>
1393 <DD><DL>
1394 </DL>
1395 </DD>
1396 <DD><DL>
1397 <DT><B>Parameters:</B><DD><CODE>file</CODE> - The File object to be compared to this file's filename
1398 <DT><B>Returns:</B><DD>Zero if the argument is equal to this file's filename, a
1399                 value less than zero if this file's filename is
1400                 lexicographically less than the argument, or a value greater
1401                 than zero if this file's filename is lexicographically
1402                 greater than the argument<DT><B>Since:</B></DT>
1403   <DD>JDK1.2</DD>
1404 </DL>
1405 </DD>
1406 </DL>
1407 <HR>
1408
1409 <A NAME="compareTo(java.lang.Object)"><!-- --></A><H3>
1410 compareTo</H3>
1411 <PRE>
1412 public int <B>compareTo</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">Object</A>&nbsp;o)
1413               throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/ClassCastException.html">ClassCastException</A></PRE>
1414 <DL>
1415 <DD>Compares this file to another File object.  If the other object
1416  is an abstract pathname, then this function behaves like <code><A HREF="../../../org/openafs/jafs/File.html#compareTo(org.openafs.jafs.File)"><CODE>compareTo(File)</CODE></A></code>.  Otherwise, it throws a
1417  <code>ClassCastException</code>, since File objects can only be
1418  compared to File objects.
1419 <P>
1420 <DD><DL>
1421 <DT><B>Specified by:</B><DD><CODE>compareTo</CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</A></CODE><DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#compareTo(java.lang.Object)">compareTo</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
1422 </DD>
1423 <DD><DL>
1424 <DT><B>Parameters:</B><DD><CODE>o</CODE> - The <code>Object</code> to be compared to this abstract pathname
1425 <DT><B>Returns:</B><DD>If the argument is an File object, returns zero
1426           if the argument is equal to this file's filename, a value
1427           less than zero if this file's filename is lexicographically
1428           less than the argument, or a value greater than zero if this
1429           file's filename is lexicographically greater than the
1430           argument
1431 <DT><B>Throws:</B>
1432 <DD><CODE><code>ClassCastException</code></CODE> - if the argument is not an
1433                   File object
1434 <DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/ClassCastException.html">ClassCastException</A></CODE><DT><B>Since:</B></DT>
1435   <DD>JDK1.2</DD>
1436 <DT><B>See Also:</B><DD><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html"><CODE>Comparable</CODE></A></DL>
1437 </DD>
1438 </DL>
1439 <HR>
1440
1441 <A NAME="mkdir()"><!-- --></A><H3>
1442 mkdir</H3>
1443 <PRE>
1444 public boolean <B>mkdir</B>()</PRE>
1445 <DL>
1446 <DD>Creates the directory named by this abstract pathname.
1447 <P>
1448 <DD><DL>
1449 <DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#mkdir()">mkdir</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
1450 </DD>
1451 <DD><DL>
1452
1453 <DT><B>Returns:</B><DD><code>true</code> if and only if the directory was
1454           created; <code>false</code> otherwise</DL>
1455 </DD>
1456 </DL>
1457 <HR>
1458
1459 <A NAME="renameTo(org.openafs.jafs.File)"><!-- --></A><H3>
1460 renameTo</H3>
1461 <PRE>
1462 public boolean <B>renameTo</B>(<A HREF="../../../org/openafs/jafs/File.html">File</A>&nbsp;dest)</PRE>
1463 <DL>
1464 <DD>Renames the file denoted by this abstract pathname.
1465 <P>
1466 <DD><DL>
1467 </DL>
1468 </DD>
1469 <DD><DL>
1470 <DT><B>Parameters:</B><DD><CODE>dest</CODE> - The new abstract pathname for the named file
1471 <DT><B>Returns:</B><DD><code>true</code> if and only if the renaming succeeded;
1472           <code>false</code> otherwise
1473 <DT><B>Throws:</B>
1474 <DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/NullPointerException.html">NullPointerException</A></CODE> - If parameter <code>dest</code> is <code>null</code></DL>
1475 </DD>
1476 </DL>
1477 <HR>
1478
1479 <A NAME="setAttributes()"><!-- --></A><H3>
1480 setAttributes</H3>
1481 <PRE>
1482 public boolean <B>setAttributes</B>()
1483                       throws <A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></PRE>
1484 <DL>
1485 <DD>Performs a file <code>stat</code> on the actual AFS file and populates  
1486  this object's respective field members with the appropriate values.
1487  method will, if authorized, perform a <code>stat</code> on the
1488  actual AFS file and update its respective field members; defining
1489  this file object's attributes.
1490
1491  <P><B>This method should not be used directly for refreshing or validating
1492  this AFS file object.  Please use <A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A> instead.</B>
1493 <P>
1494 <DD><DL>
1495 </DL>
1496 </DD>
1497 <DD><DL>
1498
1499 <DT><B>Returns:</B><DD><code>true</code> if and only if the current user is allowed to stat the file;
1500           <code>false</code> otherwise.
1501 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></CODE><DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
1502 </DD>
1503 </DL>
1504 <!-- ========= END OF CLASS DATA ========= -->
1505 <HR>
1506
1507 <!-- ========== START OF NAVBAR ========== -->
1508 <A NAME="navbar_bottom"><!-- --></A>
1509 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
1510 <TR>
1511 <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
1512 <A NAME="navbar_bottom_firstrow"><!-- --></A>
1513 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
1514   <TR ALIGN="center" VALIGN="top">
1515   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
1516   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
1517   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/File.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
1518   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
1519   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
1520   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
1521   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
1522   </TR>
1523 </TABLE>
1524 </TD>
1525 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
1526 <B>JAFS API v2</B></EM>
1527 </TD>
1528 </TR>
1529
1530 <TR>
1531 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
1532 &nbsp;<A HREF="../../../org/openafs/jafs/ErrorTable.html"><B>PREV CLASS</B></A>&nbsp;
1533 &nbsp;<A HREF="../../../org/openafs/jafs/FileInputStream.html"><B>NEXT CLASS</B></A></FONT></TD>
1534 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
1535   <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
1536 &nbsp;<A HREF="File.html" TARGET="_top"><B>NO FRAMES</B></A>  &nbsp;
1537 &nbsp;
1538 <SCRIPT>
1539   <!--
1540   if(window==top) {
1541     document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
1542   }
1543   //-->
1544 </SCRIPT>
1545 <NOSCRIPT>
1546 <A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
1547 </NOSCRIPT>
1548 </FONT></TD>
1549 </TR>
1550 <TR>
1551 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
1552   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#fields_inherited_from_class_java.io.File">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
1553 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
1554 DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
1555 </TR>
1556 </TABLE>
1557 <!-- =========== END OF NAVBAR =========== -->
1558
1559 <HR>
1560
1561 </BODY>
1562 </HTML>