Package java.lang

MID Profile Language Classes included from Java 2 Standard Edition.

See: Description

Interface Summary

Interface	Description
Runnable	The Runnable interface should be implemented by any class whose instances are intended to be executed by a thread.

Class Summary

Class	Description
Boolean	The Boolean class wraps a value of the primitive type boolean in an object.
Byte	The Byte class is the standard wrapper for byte values.
Character	The Character class wraps a value of the primitive type char in an object.
Class	Instances of the class Class represent classes and interfaces in a running Java application.
Double	The Double class wraps a value of the primitive type double in an object.
Float	The Float class wraps a value of primitive type float in an object.
Integer	The Integer class wraps a value of the primitive type int in an object.
Long	The Long class wraps a value of the primitive type long in an object.
Math	The class Math contains methods for performing basic numeric operations.
Object	Class Object is the root of the class hierarchy.
Runtime	Every Java application has a single instance of class Runtime that allows the application to interface with the environment in which the application is running.
Short	The Short class is the standard wrapper for short values.
String	The String class represents character strings.
StringBuffer	A string buffer implements a mutable sequence of characters.
System	The System class contains several useful class fields and methods.
Thread	A thread is a thread of execution in a program.
Throwable	The Throwable class is the superclass of all errors and exceptions in the Java language.

Exception Summary

Exception	Description
ArithmeticException	Thrown when an exceptional arithmetic condition has occurred.
ArrayIndexOutOfBoundsException	Thrown to indicate that an array has been accessed with an illegal index.
ArrayStoreException	Thrown to indicate that an attempt has been made to store the wrong type of object into an array of objects.
ClassCastException	Thrown to indicate that the code has attempted to cast an object to a subclass of which it is not an instance.
ClassNotFoundException	Thrown when an application tries to load in a class through its string name using the forName method in class Class but no definition for the class with the specified name could be found.
Exception	The class Exception and its subclasses are a form of Throwable that indicates conditions that a reasonable application might want to catch.
IllegalAccessException	Thrown when an application tries to load in a class, but the currently executing method does not have access to the definition of the specified class, because the class is not public and in another package.
IllegalArgumentException	Thrown to indicate that a method has been passed an illegal or inappropriate argument.
IllegalMonitorStateException	Thrown to indicate that a thread has attempted to wait on an object's monitor or to notify other threads waiting on an object's monitor without owning the specified monitor.
IllegalStateException	Signals that a method has been invoked at an illegal or inappropriate time.
IllegalThreadStateException	Thrown to indicate that a thread is not in an appropriate state for the requested operation.
IndexOutOfBoundsException	Thrown to indicate that an index of some sort (such as to an array, to a string, or to a vector) is out of range.
InstantiationException	Thrown when an application tries to create an instance of a class using the newInstance method in class Class, but the specified class object cannot be instantiated because it is an interface or is an abstract class.
InterruptedException	Thrown when a thread is waiting, sleeping, or otherwise paused for a long time and another thread interrupts it.
NegativeArraySizeException	Thrown if an application tries to create an array with negative size.
NullPointerException	Thrown when an application attempts to use null in a case where an object is required.
NumberFormatException	Thrown to indicate that the application has attempted to convert a string to one of the numeric types, but that the string does not have the appropriate format.
RuntimeException	RuntimeException is the superclass of those exceptions that can be thrown during the normal operation of the Java Virtual Machine.
SecurityException	Thrown by the system to indicate a security violation.
StringIndexOutOfBoundsException	Thrown by the charAt method in class String and by other String methods to indicate that an index is either negative or greater than or equal to the size of the string.

Error Summary

Error	Description
Error	An Error is a subclass of Throwable that indicates serious problems that a reasonable application should not try to catch.
NoClassDefFoundError	Thrown if the Java Virtual Machine tries to load in the definition of a class (as part of a normal method call or as part of creating a new instance using the new expression) and no definition of the class could be found.
OutOfMemoryError	Thrown when the Java Virtual Machine cannot allocate an object because it is out of memory, and no more memory could be made available by the garbage collector.
VirtualMachineError	Thrown to indicate that the Java Virtual Machine is broken or has run out of resources necessary for it to continue operating.

Package java.lang Description

MID Profile Language Classes included from Java 2 Standard Edition. In addition to the java.lang classes specified in the Connected Limited Device Configuration the Mobile Information Device Profile includes the following class from Java 2 Standard Edition.

• java.lang.IllegalStateException.java

IllegalStateExceptions are thrown when illegal transitions are requested, such as scheduling a TimerTask or in the containment of user interface components.

System Functions

The MIDP is based on the Connected, Limited Device Configuration (CLDC). Some features of the CLDC are modified or extended by the MIDP.

System Properties

The MIDP defines the following property values (in addition to those defined in the CLDC specification) that MUST be made available to the application using java.lang.System.getProperty :

System Properties Defined by MIDP

System Property	Description
microedition.locale	The current locale of the device, may be null
microedition.profiles	is a blank (Unicode U+0020) separated list of the J2ME profiles that this device supports. For MIDP devices, this property MUST contain at least "MIDP-2.0"

Other properties may be available from other profiles or the implementation.

Property microedition.locale

The locale property, if not null, MUST consist of the language and MAY optionally also contain the country code, and variant separated by "-" (Unicode U+002D). For example, "fr-FR" or "en-US." (Note: the MIDP 1.0 specification used the HTTP formatting of language tags as defined in RFC3066 Tags for the Identification of Languages. This is different from the J2SE definition for Locale printed strings where fields are separated by "_" (Unicode U+005F). )

The language codes MUST be the lower-case, two-letter codes as defined by ISO-639.

The country code MUST be the upper-case, two-letter codes as defined by ISO-3166.

Application Resource Files

Application resource files are accessed using getResourceAsStream(String name) in java.lang.Class . In the MIDP specification, getResourceAsStream is used to allow resource files to be retrieved from the MIDlet Suite's JAR file.

Resource names refer to the contents of the MIDlet Suite JAR file. Absolute pathnames, beginning with "/" are fully qualified file names within the jar file.

Relative pathnames, not beginning with "/" are relative to the class upon which getResourceAsStream is called. Relative names are converted to absolute by prepending a "/" followed by the fully qualified package with "." characters converted to "/" and a separator of "/". The resulting string is reduced to canonical form by applying as many times as possible the following:

• All occurrences of "/./" are replaced with "/".
• All occurrences of "/segment/../" are replaced with "/" where segment does not contain "/".

The canonical resource name is the absolute pathname of the resource within the JAR.

In no case can the path extend outside the JAR file, and resources outside the JAR file MUST NOT be accessible. For example, using "../../" does NOT point outside the JAR file. If there are any remaining "." or ".." characters they are treated literally in locating the resource. No resource can exist with that name so null is returned from Class.getResourceAsStream. Also, devices MUST NOT allow classfiles to be read from the JAR file as resources, but all other files MUST be accessible.

System.exit

The behavior of java.lang.System.exit MUST throw a java.lang.SecurityException when invoked by a MIDlet. The only way a MIDlet can indicate that it is complete is by calling MIDlet.notifyDestroyed .

Runtime.exit

The behavior of java.lang.Runtime.exit MUST throw a java.lang.SecurityException when invoked by a MIDlet. The only way a MIDlet can indicate that it is complete is by calling MIDlet.notifyDestroyed .

Since:

MIDP 1.0