All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.jboss.vfs.TempFileProvider Maven / Gradle / Ivy

There is a newer version: 3.3.2.Final
Show newest version
/*
 * JBoss, Home of Professional Open Source
 * Copyright 2009, JBoss Inc., and individual contributors as indicated
 * by the @authors tag.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.jboss.vfs;

import java.io.Closeable;
import java.io.File;
import java.io.IOException;
import java.util.Random;
import java.util.concurrent.ScheduledExecutorService;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.atomic.AtomicBoolean;

/**
 * A provider for temporary physical files and directories.
 *
 * @author David M. Lloyd
 * @author Ales Justin
 */
public final class TempFileProvider implements Closeable {

    private static final String JBOSS_TMP_DIR_PROPERTY = "jboss.server.temp.dir";
    private static final String JVM_TMP_DIR_PROPERTY = "java.io.tmpdir";
    private static final File TMP_ROOT;
    private static final int RETRIES = 10;
    private final AtomicBoolean open = new AtomicBoolean(true);

    static {
        String configTmpDir = System.getProperty(JBOSS_TMP_DIR_PROPERTY);
        if (configTmpDir == null) { configTmpDir = System.getProperty(JVM_TMP_DIR_PROPERTY); }
        try {
            TMP_ROOT = new File(configTmpDir, "vfs");
            TMP_ROOT.mkdirs();
        } catch (Exception e) {
            throw VFSMessages.MESSAGES.cantSetupTempFileProvider(e);
        }
    }

    /**
     * Create a temporary file provider for a given type.
     * 

* This is the same as calling {@link #create(String, java.util.concurrent.ScheduledExecutorService, boolean) create(final String providerType, final ScheduledExecutorService executor, false)} * * @param providerType the provider type string (used as a prefix in the temp file dir name) * @param executor the executor * @return the new provider * @throws IOException if an I/O error occurs */ public static TempFileProvider create(String providerType, ScheduledExecutorService executor) throws IOException { return create(providerType, executor, false); } /** * Create a temporary file provider for a given type. * * @param providerType The provider type string (used as a prefix in the temp file dir name) * @param executor Executor which will be used to manage temp file provider tasks (like cleaning up/deleting the temp files when needed) * @param cleanExisting If this is true, then this method will *try* to delete the existing temp content (if any) for the providerType. The attempt to delete the existing content (if any) * will be done in the background and this method will not wait for the deletion to complete. The method will immediately return back with a usable {@link TempFileProvider}. Note that the * cleanExisting will just act as a hint for this method to trigger the deletion of existing content. The method may not always be able to delete the existing contents. * @return The new provider * @throws IOException if an I/O error occurs */ public static TempFileProvider create(final String providerType, final ScheduledExecutorService executor, final boolean cleanExisting) throws IOException { if (cleanExisting) { try { // The "clean existing" logic is as follows: // 1) Rename the root directory "foo" corresponding to the provider type to "bar" // 2) Submit a task to delete "bar" and its contents, in a background thread, to the the passed executor. // 3) Create a "foo" root directory for the provider type and return that TempFileProvider (while at the same time the background task is in progress) // This ensures that the "foo" root directory for the providerType is empty and the older content is being cleaned up in the background (without affecting the current processing), // thus simulating a "cleanup existing content" final File possiblyExistingProviderRoot = new File(TMP_ROOT, providerType); if (possiblyExistingProviderRoot.exists()) { // rename it so that it can be deleted as a separate (background) task final File toBeDeletedProviderRoot = new File(TMP_ROOT, createTempName(providerType + "-to-be-deleted-", "")); final boolean renamed = possiblyExistingProviderRoot.renameTo(toBeDeletedProviderRoot); if (!renamed) { throw new IOException("Failed to rename " + possiblyExistingProviderRoot.getAbsolutePath() + " to " + toBeDeletedProviderRoot.getAbsolutePath()); } else { // delete in the background executor.submit(new DeleteTask(toBeDeletedProviderRoot, executor)); } } } catch (Throwable t) { // just log a message if existing contents couldn't be deleted VFSLogger.ROOT_LOGGER.failedToCleanExistingContentForTempFileProvider(providerType); // log the cause of the failure VFSLogger.ROOT_LOGGER.debug("Failed to clean existing content for temp file provider of type " + providerType, t); } } // now create and return the TempFileProvider for the providerType final File providerRoot = new File(TMP_ROOT, providerType); return new TempFileProvider(createTempDir(providerType, "", providerRoot), executor); } private final File providerRoot; private final ScheduledExecutorService executor; File getProviderRoot() { return providerRoot; } private TempFileProvider(File providerRoot, ScheduledExecutorService executor) { this.providerRoot = providerRoot; this.executor = executor; } /** * Create a temp directory, into which temporary files may be placed. * * @param originalName the original file name * @return the temp directory * @throws IOException for any error */ public TempDir createTempDir(String originalName) throws IOException { if (!open.get()) { throw VFSMessages.MESSAGES.tempFileProviderClosed(); } final String name = createTempName(originalName + "-", ""); final File f = new File(providerRoot, name); for (int i = 0; i < RETRIES; i++) { if (f.mkdirs()) { return new TempDir(this, f); } } throw VFSMessages.MESSAGES.couldNotCreateDirectory(originalName,RETRIES); } private static final Random rng = new Random(); private static File createTempDir(String prefix, String suffix, File root) throws IOException { for (int i = 0; i < RETRIES; i++) { final File f = new File(root, createTempName(prefix, suffix)); if (f.mkdirs()) { if (f.isDirectory()&&f.getParent()!=null){ f.delete(); } return f; } } throw VFSMessages.MESSAGES.couldNotCreateDirectoryForRoot( root, prefix, suffix, RETRIES); } static String createTempName(String prefix, String suffix) { return prefix + Long.toHexString(rng.nextLong()) + suffix; } /** * Close this provider and delete any temp files associated with it. */ public void close() throws IOException { if (open.getAndSet(false)) { delete(this.providerRoot); } } protected void finalize() { VFSUtils.safeClose(this); } /** * Deletes any temp files associated with this provider * * @throws IOException */ void delete(final File root) throws IOException { new DeleteTask(root, executor).run(); } static final class DeleteTask implements Runnable { private final File root; private ScheduledExecutorService retryExecutor; DeleteTask(final File root, final ScheduledExecutorService retryExecutor) { this.root = root; this.retryExecutor = retryExecutor; } public void run() { if (VFSUtils.recursiveDelete(root) == false) { if (retryExecutor != null) { VFSLogger.ROOT_LOGGER.tracef("Failed to delete root (%s), retrying in 30sec.", root); retryExecutor.schedule(this, 30L, TimeUnit.SECONDS); } else { VFSLogger.ROOT_LOGGER.tracef("Failed to delete root (%s).", root); } } } } }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy