1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
//Auto-generated by kalyptus. DO NOT EDIT.
package org.kde.koala;
import org.kde.qt.Qt;
import org.kde.qt.QDir;
import org.kde.qt.QtSupport;
/**
The KTempDir class creates a unique directory for temporary use.
This is especially useful if you need to create a directory in a world
writable directory like /tmp without being vulnerable to so called
symlink attacks.
KDE applications, however, shouldn't create files or directories in /tmp in the first
place but use the "tmp" resource instead. The standard KTempDir
constructor will do that by default.
To create a temporary directory that starts with a certain name
in the "tmp" resource, one should use:
KTempDir(locateLocal("tmp", prefix));
KTempFile does not create any missing directories, but locateLocal() does.
See also KStandardDirs
@author Joseph Wenninger <jowenn@kde.org>
@short The KTempDir class creates a unique directory for temporary use.
*/
public class KTempDir implements QtSupport {
private long _qt;
private boolean _allocatedInJavaWorld = true;
protected KTempDir(Class dummy){}
/**
Creates a temporary directory with the name:
\p \<directoryPrefix\>\<six letters\>
The default <pre>directoryPrefix</pre> is "$KDEHOME/tmp-$HOST/appname"
@param directoryPrefix the prefix of the file name, or
null for the default value
@param mode the file permissions,
almost always in octal. The first digit selects permissions for
the user who owns the file: read (4), write (2), and execute
(1); the second selects permissions for other users in the
file's group, with the same values; and the fourth for other
users not in the file's group, with the same values.
@short Creates a temporary directory with the name: \p \<directoryPrefix\>\<six letters\>
*/
public KTempDir(String directoryPrefix, int mode) {
newKTempDir(directoryPrefix,mode);
}
private native void newKTempDir(String directoryPrefix, int mode);
public KTempDir(String directoryPrefix) {
newKTempDir(directoryPrefix);
}
private native void newKTempDir(String directoryPrefix);
public KTempDir() {
newKTempDir();
}
private native void newKTempDir();
/**
Turn automatic deletion on or off.
Automatic deletion is off by default.
@param autoDelete true to turn automatic deletion on
@short Turn automatic deletion on or off.
*/
public native void setAutoDelete(boolean autoDelete);
/**
Returns the status of the directory creation based on errno. (see errno.h)
0 means OK.
You should check the status after object creation to check
whether a directory could be created in the first place.
@return the errno status, 0 means ok
@short Returns the status of the directory creation based on errno.
*/
public native int status();
/**
Returns the full path and name of the directory, including a trailing '/'.
@return The name of the directory, or null if creating the
directory has failed or the directory has been unlinked
@short Returns the full path and name of the directory, including a trailing '/'.
*/
public native String name();
/**
Returns the QDir of the temporary directory.
@return QDir directory information of the directory or 0 if their is no managed directory
The caller has to free the pointer open for writing to the
@short Returns the QDir of the temporary directory.
*/
public native QDir qDir();
/**
Deletes the directory recursively
@short Deletes the directory recursively
*/
public native void unlink();
/**
@return true if a temporary directory has successfully been created and not been unlinked yet
@short
*/
public native boolean existing();
/**
Creates a "random" directory with specified mode
@param directoryPrefix to use when creating temp directory
(the rest is generated randomly)
@param mode directory permissions
@return bool true upon sucess
@short Creates a "random" directory with specified mode
*/
protected native boolean create(String directoryPrefix, int mode);
/**
Sets the errno value
@param error the value to set the status to.
@short Sets the errno value
*/
protected native void setError(int error);
/** Deletes the wrapped C++ instance */
protected native void finalize() throws InternalError;
/** Delete the wrapped C++ instance ahead of finalize() */
public native void dispose();
/** Has the wrapped C++ instance been deleted? */
public native boolean isDisposed();
}
|
