/** * Creates a <code>File</code> object for a file in the persistent storage area provided for the * bundle by the framework. If the adaptor does not have file system support, this method will * return <code>null</code>. * * <p>A <code>File</code> object for the base directory of the persistent storage area provided * for the context bundle by the framework can be obtained by calling this method with the empty * string ("") as the parameter. See {@link #getBundle()} for a definition of context bundle. * * <p>If the Java runtime environment supports permissions, the framework the will ensure that the * bundle has <code>java.io.FilePermission</code> with actions "read","write","execute","delete" * for all files (recursively) in the persistent storage area provided for the context bundle by * the framework. * * @param filename A relative name to the file to be accessed. * @return A <code>File</code> object that represents the requested file or <code>null</code> if * the adaptor does not have file system support. * @exception java.lang.IllegalStateException If the bundle context has stopped. */ public File getDataFile(String filename) { checkValid(); return (framework.getDataFile(bundle, filename)); }