// $Id: OsUtil.java,v 1.7 2004/08/24 16:43:23 mvw Exp $
// Copyright (c) 1996-2002 The Regents of the University of California. All
// Rights Reserved. Permission to use, copy, modify, and distribute this
// software and its documentation without fee, and without a written
// agreement is hereby granted, provided that the above copyright notice
// and this paragraph appear in all copies.  This software program and
// documentation are copyrighted by The Regents of the University of
// California. The software program and documentation are supplied "AS
// IS", without any accompanying services from The Regents. The Regents
// does not warrant that the operation of the program will be
// uninterrupted or error-free. The end-user understands that the program
// was developed for research purposes and is advised not to rely
// exclusively on the program for any reason.  IN NO EVENT SHALL THE
// UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT,
// SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS,
// ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF
// THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF
// SUCH DAMAGE. THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY
// WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
// MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE
// PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND THE UNIVERSITY OF
// CALIFORNIA HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT,
// UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

package org.argouml.util.osdep;

import javax.swing.JFileChooser;
import org.argouml.util.osdep.win32.Win32FileSystemView;

/** Utility class providing hooks to
 *  operating-system-specific functionality.
 *
 *  @author Thierry Lach
 *  @since ARGO0.9.8
 */

public class OsUtil { 

    /** Do not allow this class to be instantiated.
     */
    private OsUtil() {
    }

    /** 
     * Check whether we deal with a Windows Operating System.
     * 
     * @return true if this is Windows
     */
    public static boolean isWin32() {
        return (System.getProperty("os.name").indexOf("Windows") != -1);
    }
    
    /** 
     * Check whether we deal with a Macintosh.
     * 
     * @return true if this is a Mac
     */
    public static boolean isMac() {
        return (System.getProperty("mrj.version") != null);
    }

    /** 
     * Check whether we deal with a Sun Java. 
     * 
     * @return true if this is a Sun Java
     */
    static boolean isSunJdk() {
        return (System.getProperty("java.vendor")
                .equals("Sun Microsystems Inc."));
    }

    /** check whether we deal with a JDK 1.3.x */
    static boolean isJdk131() {
        return (System.getProperty("java.version").startsWith("1.3.")); 
    }

    /** 
     * Return a proper FileChooser. This replaces the normal FileChooser with a
     * system-dependent one, but solely in case of Sun Java 1.3.1 on Windows. 
     * 
     * @return JFileChooser
     */
    public static JFileChooser getFileChooser() {
        if (isWin32() && isSunJdk() && isJdk131()) {
	    return new JFileChooser(new Win32FileSystemView());
	}
	else {
	    return new JFileChooser();
	}
    }
    /**
     * Return a proper FileChooser. This replaces the normal FileChooser with a
     * system-dependent one, but solely in case of Sun Java 1.3.1 on Windows. 
     * 
     * @param directory a String giving the path to a file 
     * or directory. Passing in a null
     * string causes the file chooser to point to the user's default directory.
     * This default depends on the operating system. It is
     * typically the "My Documents" folder on Windows, and the user's
     * home directory on Unix.
     * 
     * @return JFileChooser
     */
    public static JFileChooser getFileChooser(String directory) {
        if (isWin32() && isSunJdk() && isJdk131()) {
	    return new JFileChooser(directory, new Win32FileSystemView());
	}
	else {
	    return new JFileChooser(directory);
	}
    }
}