/*

 * Copyright 1997-2005 Sun Microsystems, Inc.  All Rights Reserved.

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

 *

 * This code is free software; you can redistribute it and/or modify it

 * under the terms of the GNU General Public License version 2 only, as

 * published by the Free Software Foundation.  Sun designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Sun in the LICENSE file that accompanied this code.

 *

 * This code is distributed in the hope that it will be useful, but WITHOUT

 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

 * version 2 for more details (a copy is included in the LICENSE file that

 * accompanied this code).

 *

 * You should have received a copy of the GNU General Public License version

 * 2 along with this work; if not, write to the Free Software Foundation,

 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

 *

 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,

 * CA 95054 USA or visit www.sun.com if you need additional information or

 * have any questions.

 */

package javax.activation;

import java.io.InputStream;

import java.io.OutputStream;

import java.io.File;

import java.io.FileDescriptor;

import java.io.FileNotFoundException;

import java.io.FileInputStream;

import java.io.FileOutputStream;

import java.io.IOException;

import com.sun.activation.registries.MimeTypeFile;

/**

 * The FileDataSource class implements a simple DataSource object

 * that encapsulates a file. It provides data typing services via

 * a FileTypeMap object. <p>

 *

 * <b>FileDataSource Typing Semantics</b><p>

 *

 * The FileDataSource class delegates data typing of files

 * to an object subclassed from the FileTypeMap class.

 * The <code>setFileTypeMap</code> method can be used to explicitly

 * set the FileTypeMap for an instance of FileDataSource. If no

 * FileTypeMap is set, the FileDataSource will call the FileTypeMap's

 * getDefaultFileTypeMap method to get the System's default FileTypeMap.

 *

 * @see javax.activation.DataSource

 * @see javax.activation.FileTypeMap

 * @see javax.activation.MimetypesFileTypeMap

 *

 * @since 1.6

 */

public class FileDataSource implements DataSource {

    // keep track of original 'ref' passed in, non-null

    // one indicated which was passed in:

    private File _file = null;

    private FileTypeMap typeMap = null;

    /**

     * Creates a FileDataSource from a File object. <i>Note:

     * The file will not actually be opened until a method is

     * called that requires the file to be opened.</i>

     *

     * @param file the file

     */

    public FileDataSource(File file) {

        _file = file;   // save the file Object...

    }

    /**

     * Creates a FileDataSource from

     * the specified path name. <i>Note:

     * The file will not actually be opened until a method is

     * called that requires the file to be opened.</i>

     *

     * @param name the system-dependent file name.

     */

    public FileDataSource(String name) {

        this(new File(name));   // use the file constructor

    }

    /**

     * This method will return an InputStream representing the

     * the data and will throw an IOException if it can

     * not do so. This method will return a new

     * instance of InputStream with each invocation.

     *

     * @return an InputStream

     */

    public InputStream getInputStream() throws IOException {

        return new FileInputStream(_file);

    }

    /**

     * This method will return an OutputStream representing the

     * the data and will throw an IOException if it can

     * not do so. This method will return a new instance of

     * OutputStream with each invocation.

     *

     * @return an OutputStream

     */

    public OutputStream getOutputStream() throws IOException {

        return new FileOutputStream(_file);

    }

    /**

     * This method returns the MIME type of the data in the form of a

     * string. This method uses the currently installed FileTypeMap. If

     * there is no FileTypeMap explictly set, the FileDataSource will

     * call the <code>getDefaultFileTypeMap</code> method on

     * FileTypeMap to acquire a default FileTypeMap. <i>Note: By

     * default, the FileTypeMap used will be a MimetypesFileTypeMap.</i>

     *

     * @return the MIME Type

     * @see javax.activation.FileTypeMap#getDefaultFileTypeMap

     */

    public String getContentType() {

        // check to see if the type map is null?

        if (typeMap == null)

            return FileTypeMap.getDefaultFileTypeMap().getContentType(_file);

        else

            return typeMap.getContentType(_file);

    }

    /**

     * Return the <i>name</i> of this object. The FileDataSource

     * will return the file name of the object.

     *

     * @return the name of the object.

     * @see javax.activation.DataSource

     */

    public String getName() {

        return _file.getName();

    }

    /**

     * Return the File object that corresponds to this FileDataSource.

     * @return the File object for the file represented by this object.

     */

    public File getFile() {

        return _file;

    }

    /**

     * Set the FileTypeMap to use with this FileDataSource

     *

     * @param map The FileTypeMap for this object.

     */

    public void setFileTypeMap(FileTypeMap map) {

        typeMap = map;

    }

}