Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| " 2013 FRC Java API "
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES

## Package java.lang

MID Profile Language Classes included from Java 2 Standard Edition.

See:
Description

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

Class Summary
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 provides an object wrapper for Float data values, and serves as a place for float-oriented operations.
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
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 | 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

`IllegalStateException`s 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

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| " 2013 FRC Java API "
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES

"
For updated information see the Java FRC site
"