acm.util
Class Platform

java.lang.Object
  |
  +--acm.util.Platform

public class Platform extends Object

This class contains methods to support platform-specific code.

Field Summary

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

Constructor Summary

Platform()

Method Summary

boolean	areCollectionsAvailable() Checks whether the JDK 1.2 collection classes are available.
boolean	areStandardFontFamiliesAvailable() Checks whether the JDK 1.2 standard font families (Serif, SansSerif, and Monospaced) are available.
int	compareVersion(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.
int	compareVersion(String v1, 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.
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.
boolean	isJMFAvailable() Checks whether the Java Media Framework is available.
boolean	isMac() Checks whether the platform is a Macintosh.
boolean	isSunAudioAvailable() Checks whether the sun.audio package is available.
boolean	isSwingAvailable() Checks whether Swing is available.
boolean	isUnix() Checks whether the platform is Unix.
boolean	isWindows() Checks whether the platform is a Windows machine.
void	setFileTypeAndCreator(File file, String type, String creator) Sets the Macintosh file type and creator.
void	setFileTypeAndCreator(String filename, String type, String creator) Sets the Macintosh file type and creator.

Field Detail

public static final int MAC

Indicates that the system is some variety of Apple Macintosh.

public static final int UNIX

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

public static final int UNKNOWN

Indicates that the type of system cannot be determined.

public static final int WINDOWS

Indicates that the system is some variety of Microsoft Windows.

Constructor Detail

public Platform()

Method Detail

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.

Usage:	if (Platform.areCollectionsAvailable()) . . .
Returns:	true if collections are available, false otherwise

public static boolean areStandardFontFamiliesAvailable()

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

Usage:	if (Platform.areStandardFontFamiliesAvailable()) . . .
Returns:	true if the standard fonts are available, false otherwise

public static int compareVersion(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) . . .

Usage:

int cmp = Platform.compareVersion(version);

Parameter:

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

public static int compareVersion(String v1, 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.

Usage:

int cmp = Platform.compareVersion(v1, 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

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.

Usage:	int platform = Platform.getPlatform();
Returns:	A constant specifying the platform type

public static boolean isJMFAvailable()

Checks whether the Java Media Framework is available.

Usage:	if (Platform.isJMFAvailable()) . . .
Returns:	true if the JMF package is available, false otherwise

public static boolean isMac()

Checks whether the platform is a Macintosh.

Usage:	if (Platform.isMac()) . . .
Returns:	true if the platform is a Macintosh, false otherwise

public static boolean isSunAudioAvailable()

Checks whether the sun.audio package is available.

Usage:	if (Platform.isSunAudioAvailable()) . . .
Returns:	true if the sun.audio package is available, false otherwise

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.

Usage:	if (Platform.isSwingAvailable()) . . .
Returns:	true if Swing is available, false otherwise

public static boolean isUnix()

Checks whether the platform is Unix.

Usage:	if (Platform.isUnix()) . . .
Returns:	true if the platform is Unix, false otherwise

public static boolean isWindows()

Checks whether the platform is a Windows machine.

Usage:	if (Platform.isWindows()) . . .
Returns:	true if the platform is a Windows machine, false otherwise

public static void setFileTypeAndCreator(File file, String type, String creator)

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

Usage:

setFileTypeAndCreator(file, type, creator);

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

public static void setFileTypeAndCreator(String filename, String type, String creator)

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

Usage:

setFileTypeAndCreator(filename, type, creator);

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