acm.util

Class Platform

java.lang.Object

acm.util.Platform

public class Platform
extends java.lang.Object

This class contains methods to support platform-specific code.

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAC Indicates that the system is some variety of Apple Macintosh.
static int	UNIX Indicates that the system is some variety of Unix or Linux.
static int	UNKNOWN Indicates that the type of system cannot be determined.
static int	WINDOWS Indicates that the system is some variety of Microsoft Windows.

Constructor Summary

Constructors

Constructor and Description
Platform()

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	areCollectionsAvailable() Checks whether the JDK 1.2 collection classes are available.
static boolean	areStandardFontFamiliesAvailable() Checks whether the JDK 1.2 standard font families (Serif, SansSerif, and Monospaced) are available.
static int	compareVersion(java.lang.String version) This method compares the Java version given in the system properties with the specified version and returns -1, 0, or +1 depending on whether the system version is earlier than, equal to, or later than the specified one.
static int	compareVersion(java.lang.String v1, java.lang.String v2) This method compares the version strings v1 and v2 and returns -1, 0, or +1 depending on whether v1 is earlier than, equal to, or later than v2.
static int	getPlatform() Returns an enumeration constant specifying the type of platform on which this applet is running, which is one of the supported types defined at the beginning of this class.
static boolean	isJMFAvailable() Checks whether the Java Media Framework is available.
static boolean	isMac() Checks whether the platform is a Macintosh.
static boolean	isSunAudioAvailable() Checks whether the sun.audio package is available.
static boolean	isSwingAvailable() Checks whether Swing is available.
static boolean	isUnix() Checks whether the platform is Unix.
static boolean	isWindows() Checks whether the platform is a Windows machine.
static void	setFileTypeAndCreator(java.io.File file, java.lang.String type, java.lang.String creator) Sets the Macintosh file type and creator.
static void	setFileTypeAndCreator(java.lang.String filename, java.lang.String type, java.lang.String creator) Sets the Macintosh file type and creator.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

UNKNOWN

public static final int UNKNOWN

Indicates that the type of system cannot be determined.

See Also:

Constant Field Values

MAC

public static final int MAC

Indicates that the system is some variety of Apple Macintosh.

See Also:

Constant Field Values

UNIX

public static final int UNIX

Indicates that the system is some variety of Unix or Linux.

See Also:

Constant Field Values

WINDOWS

public static final int WINDOWS

Indicates that the system is some variety of Microsoft Windows.

See Also:

Constant Field Values

Constructor Detail

Platform

public Platform()

Method Detail

getPlatform

public static int getPlatform()

Returns an enumeration constant specifying the type of platform on which this applet is running, which is one of the supported types defined at the beginning of this class.

Returns:

A constant specifying the platform type

isMac

public static boolean isMac()

Checks whether the platform is a Macintosh.

Returns:

true if the platform is a Macintosh, false otherwise

isWindows

public static boolean isWindows()

Checks whether the platform is a Windows machine.

Returns:

true if the platform is a Windows machine, false otherwise

isUnix

public static boolean isUnix()

Checks whether the platform is Unix.

Returns:

true if the platform is Unix, false otherwise

setFileTypeAndCreator

public static void setFileTypeAndCreator(java.lang.String filename,
                         java.lang.String type,
                         java.lang.String creator)

Sets the Macintosh file type and creator. This method is ignored on non-Mac platforms.

Parameters:

filename - The name of the file

type - A four-character string indicating the file type

creator - A four-character string indicating the file type

setFileTypeAndCreator

public static void setFileTypeAndCreator(java.io.File file,
                         java.lang.String type,
                         java.lang.String creator)

Sets the Macintosh file type and creator. This method is ignored on non-Mac platforms.

Parameters:

file - The File object corresponding to the file

type - A four-character string indicating the file type

creator - A four-character string indicating the file type

compareVersion

public static int compareVersion(java.lang.String version)

This method compares the Java version given in the system properties with the specified version and returns -1, 0, or +1 depending on whether the system version is earlier than, equal to, or later than the specified one. Thus, to test whether the current version of the JDK was at least 1.2.1, for example, you could write

if (Platform.compareVersion("1.2.1") >= 0) . . .

Parameters:

version - A string consisting of integers separated by periods

Returns:

-1, 0, or +1 depending on whether the system version is earlier than, equal to, or later than the specified one

compareVersion

public static int compareVersion(java.lang.String v1,
                 java.lang.String v2)

This method compares the version strings v1 and v2 and returns -1, 0, or +1 depending on whether v1 is earlier than, equal to, or later than v2.

Parameters:

v1 - A string consisting of integers separated by periods

v2 - A second version string in the same format

Returns:

-1, 0, or +1 depending on whether v1 is earlier than, equal to, or later than v2

isSwingAvailable

public static boolean isSwingAvailable()

Checks whether Swing is available. Unfortunately, some browsers seem to lie about the JDK version and return a 1.2 number without actually having Swing. This implementation tests the version first, but then confirms the result by looking for the JComponent class. Checking the version first means that no SecurityExceptions will be logged in Windows machines, which always log SecurityExceptions, even if the exception is caught.

Returns:

true if Swing is available, false otherwise

isSunAudioAvailable

public static boolean isSunAudioAvailable()

Checks whether the sun.audio package is available.

Returns:

true if the sun.audio package is available, false otherwise

isJMFAvailable

public static boolean isJMFAvailable()

Checks whether the Java Media Framework is available.

Returns:

true if the JMF package is available, false otherwise

areCollectionsAvailable

public static boolean areCollectionsAvailable()

Checks whether the JDK 1.2 collection classes are available. Some browsers return a version of the JDK that does not actually match what is supported. This method actually checks whether the collection classes are there by looking for the ArrayList class.

Returns:

true if collections are available, false otherwise

areStandardFontFamiliesAvailable

public static boolean areStandardFontFamiliesAvailable()

Checks whether the JDK 1.2 standard font families (Serif, SansSerif, and Monospaced) are available.

Returns:

true if the standard fonts are available, false otherwise