diff options
Diffstat (limited to 'tdejava/koala/org/trinitydesktop/koala/KTempDir.java')
-rw-r--r-- | tdejava/koala/org/trinitydesktop/koala/KTempDir.java | 124 |
1 files changed, 124 insertions, 0 deletions
diff --git a/tdejava/koala/org/trinitydesktop/koala/KTempDir.java b/tdejava/koala/org/trinitydesktop/koala/KTempDir.java new file mode 100644 index 00000000..8800736d --- /dev/null +++ b/tdejava/koala/org/trinitydesktop/koala/KTempDir.java @@ -0,0 +1,124 @@ +//Auto-generated by kalyptus. DO NOT EDIT. +package org.trinitydesktop.koala; + +import org.trinitydesktop.qt.Qt; +import org.trinitydesktop.qt.TQDir; +import org.trinitydesktop.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 TDEStandardDirs + @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 "$TDEHOME/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 TQDir of the temporary directory. + @return TQDir 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 TQDir of the temporary directory. + */ + public native TQDir 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(); +} |