123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245 |
- /*
- * Copyright (C) 2010, Google Inc.
- * Copyright (C) 2010, Matthias Sohn <matthias.sohn@sap.com>
- * Copyright (C) 2010, Jens Baumgart <jens.baumgart@sap.com>
- * and other copyright owners as documented in the project's IP log.
- *
- * This program and the accompanying materials are made available
- * under the terms of the Eclipse Distribution License v1.0 which
- * accompanies this distribution, is reproduced below, and is
- * available at http://www.eclipse.org/org/documents/edl-v10.php
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or
- * without modification, are permitted provided that the following
- * conditions are met:
- *
- * - Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
- * - Redistributions in binary form must reproduce the above
- * copyright notice, this list of conditions and the following
- * disclaimer in the documentation and/or other materials provided
- * with the distribution.
- *
- * - Neither the name of the Eclipse Foundation, Inc. nor the
- * names of its contributors may be used to endorse or promote
- * products derived from this software without specific prior
- * written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
- * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
- * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
- * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
- * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
- * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
- * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
- * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
- * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
- * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
- * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-
- package org.eclipse.jgit.util;
-
- import java.io.File;
- import java.io.IOException;
- import java.nio.channels.FileLock;
- import java.text.MessageFormat;
-
- import org.eclipse.jgit.JGitText;
-
- /**
- * File Utilities
- */
- public class FileUtils {
-
- /**
- * Option to delete given {@code File}
- */
- public static final int NONE = 0;
-
- /**
- * Option to recursively delete given {@code File}
- */
- public static final int RECURSIVE = 1;
-
- /**
- * Option to retry deletion if not successful
- */
- public static final int RETRY = 2;
-
- /**
- * Option to skip deletion if file doesn't exist
- */
- public static final int SKIP_MISSING = 4;
-
- /**
- * Delete file or empty folder
- *
- * @param f
- * {@code File} to be deleted
- * @throws IOException
- * if deletion of {@code f} fails. This may occur if {@code f}
- * didn't exist when the method was called. This can therefore
- * cause IOExceptions during race conditions when multiple
- * concurrent threads all try to delete the same file.
- */
- public static void delete(final File f) throws IOException {
- delete(f, NONE);
- }
-
- /**
- * Delete file or folder
- *
- * @param f
- * {@code File} to be deleted
- * @param options
- * deletion options, {@code RECURSIVE} for recursive deletion of
- * a subtree, {@code RETRY} to retry when deletion failed.
- * Retrying may help if the underlying file system doesn't allow
- * deletion of files being read by another thread.
- * @throws IOException
- * if deletion of {@code f} fails. This may occur if {@code f}
- * didn't exist when the method was called. This can therefore
- * cause IOExceptions during race conditions when multiple
- * concurrent threads all try to delete the same file.
- */
- public static void delete(final File f, int options) throws IOException {
- if ((options & SKIP_MISSING) != 0 && !f.exists())
- return;
-
- if ((options & RECURSIVE) != 0 && f.isDirectory()) {
- final File[] items = f.listFiles();
- if (items != null) {
- for (File c : items)
- delete(c, options);
- }
- }
- if (!f.delete()) {
- if ((options & RETRY) != 0 && f.exists()) {
- for (int i = 1; i < 10; i++) {
- try {
- Thread.sleep(100);
- } catch (InterruptedException e) {
- // ignore
- }
- if (f.delete())
- return;
- }
- }
- throw new IOException(MessageFormat.format(
- JGitText.get().deleteFileFailed, f.getAbsolutePath()));
- }
- }
-
- /**
- * Creates the directory named by this abstract pathname.
- *
- * @param d
- * directory to be created
- * @throws IOException
- * if creation of {@code d} fails. This may occur if {@code d}
- * did exist when the method was called. This can therefore
- * cause IOExceptions during race conditions when multiple
- * concurrent threads all try to create the same directory.
- */
- public static void mkdir(final File d)
- throws IOException {
- mkdir(d, false);
- }
-
- /**
- * Creates the directory named by this abstract pathname.
- *
- * @param d
- * directory to be created
- * @param skipExisting
- * if {@code true} skip creation of the given directory if it
- * already exists in the file system
- * @throws IOException
- * if creation of {@code d} fails. This may occur if {@code d}
- * did exist when the method was called. This can therefore
- * cause IOExceptions during race conditions when multiple
- * concurrent threads all try to create the same directory.
- */
- public static void mkdir(final File d, boolean skipExisting)
- throws IOException {
- if (!d.mkdir()) {
- if (skipExisting && d.isDirectory())
- return;
- throw new IOException(MessageFormat.format(
- JGitText.get().mkDirFailed, d.getAbsolutePath()));
- }
- }
-
- /**
- * Creates the directory named by this abstract pathname, including any
- * necessary but nonexistent parent directories. Note that if this operation
- * fails it may have succeeded in creating some of the necessary parent
- * directories.
- *
- * @param d
- * directory to be created
- * @throws IOException
- * if creation of {@code d} fails. This may occur if {@code d}
- * did exist when the method was called. This can therefore
- * cause IOExceptions during race conditions when multiple
- * concurrent threads all try to create the same directory.
- */
- public static void mkdirs(final File d) throws IOException {
- mkdirs(d, false);
- }
-
- /**
- * Creates the directory named by this abstract pathname, including any
- * necessary but nonexistent parent directories. Note that if this operation
- * fails it may have succeeded in creating some of the necessary parent
- * directories.
- *
- * @param d
- * directory to be created
- * @param skipExisting
- * if {@code true} skip creation of the given directory if it
- * already exists in the file system
- * @throws IOException
- * if creation of {@code d} fails. This may occur if {@code d}
- * did exist when the method was called. This can therefore
- * cause IOExceptions during race conditions when multiple
- * concurrent threads all try to create the same directory.
- */
- public static void mkdirs(final File d, boolean skipExisting)
- throws IOException {
- if (!d.mkdirs()) {
- if (skipExisting && d.isDirectory())
- return;
- throw new IOException(MessageFormat.format(
- JGitText.get().mkDirsFailed, d.getAbsolutePath()));
- }
- }
-
- /**
- * Atomically creates a new, empty file named by this abstract pathname if
- * and only if a file with this name does not yet exist. The check for the
- * existence of the file and the creation of the file if it does not exist
- * are a single operation that is atomic with respect to all other
- * filesystem activities that might affect the file.
- * <p>
- * Note: this method should not be used for file-locking, as the resulting
- * protocol cannot be made to work reliably. The {@link FileLock} facility
- * should be used instead.
- *
- * @param f
- * the file to be created
- * @throws IOException
- * if the named file already exists or if an I/O error occurred
- */
- public static void createNewFile(File f) throws IOException {
- if (!f.createNewFile())
- throw new IOException(MessageFormat.format(
- JGitText.get().createNewFileFailed, f));
- }
- }
|