javax.microedition.pim
Class UnsupportedFieldException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              javax.microedition.pim.UnsupportedFieldException

public class UnsupportedFieldException
extends RuntimeException

Represents an exception thrown when a field is referenced that is not supported in the particular PIM list that an element belongs to.

The PDA Profile specification (JSR-75) for the J2ME(TM) Platform

For more information about this class or about the personal information management (PIM) API, see The PDA Profile specification (JSR-000075) for the J2ME(TM) Platform.

Since:

BlackBerry API 4.0.0, PIM 1.0

Constructor Summary

UnsupportedFieldException()
Constructs a new instance of this class with its stack trace filled in.

UnsupportedFieldException(String detailMessage)
Constructs a new instance of this class with its stack trace and message filled in.

UnsupportedFieldException(String detailMessage, int field)
Constructs a new instance of this class with its stack trace, message, and offending field filled in.

Method Summary
int	getField() Returns an integer representing the field that caused the exception.

Methods inherited from class java.lang.Throwable

getMessage, printStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

UnsupportedFieldException

public UnsupportedFieldException()

Constructs a new instance of this class with its stack trace filled in. A default value of -1 is assigned to the field.

Since:

BlackBerry API 4.0.0

UnsupportedFieldException

public UnsupportedFieldException(String detailMessage)

Constructs a new instance of this class with its stack trace and message filled in. A default value of -1 is assigned to the field.

Parameters:

detailMessage - String The detail message for the exception.

Since:

BlackBerry API 4.0.0

UnsupportedFieldException

public UnsupportedFieldException(String detailMessage,
                                 int field)

Constructs a new instance of this class with its stack trace, message, and offending field filled in.

Parameters:

detailMessage - String The detail message for the exception.

field - the offending field for the exception; this value will be returned from UnsupportedFieldException.getField().

Since:

BlackBerry API 4.0.0

Method Detail

getField

public int getField()

Returns an integer representing the field that caused the exception.

Returns:

the offending field, as specified to the constructor; if no field was specified to the constructor then -1 is returned.

Since:

BlackBerry API 4.0.0