de.schlichtherle.io.FileFactory Maven / Gradle / Ivy
/*
* Copyright (C) 2006-2010 Schlichtherle IT Services
*
* 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 de.schlichtherle.io;
import java.io.FileNotFoundException;
import java.net.URI;
/**
* This interface is not intended for public use!
* It's only used to hide the existence of {@link ArchiveDetector}s from
* some methods in the {@link File} class.
*
* A factory interface which creates {@link File}s, {@link FileInputStream}s
* and {@link FileOutputStream}s.
* You should not implement this interface directly - implement
* {@link ArchiveDetector} instead.
*
* Implementations must be virtually immutable and thread safe!
*
* @see ArchiveDetector
* @author Christian Schlichtherle
* @version $Id: FileFactory.java c86df83eaddc 2011/01/19 13:52:55 christian $
* @since TrueZIP 6.0
* @deprecated This interface will disappear in TrueZIP 7.
*/
public interface FileFactory {
File createFile(java.io.File blueprint);
/**
* @deprecated This factory method is not intented for public use
* - do not use it!
*/
File createFile(java.io.File delegate, File innerArchive);
/**
* @deprecated This factory method is not intented for public use
* and is broken by design - do not use it!
*/
File createFile(File blueprint, java.io.File delegate, File enclArchive);
File createFile(String path);
File createFile(String parent, String child);
File createFile(java.io.File parent, String child);
File createFile(URI uri);
FileInputStream createFileInputStream(java.io.File file)
throws FileNotFoundException;
FileOutputStream createFileOutputStream(java.io.File file, boolean append)
throws FileNotFoundException;
}