com.nttdocomo.device.felica
クラス FelicaException

Object
  拡張Throwable
      拡張Exception
          拡張com.nttdocomo.device.felica.FelicaException

public final class FelicaException
extends Exception
 [iアプリオプションAPI]

FeliCa 機能に関連する例外を表します。

導入されたバージョン:
DoJa-3.0 (506iC)、DoJa-3.5 (900iC)

フィールドの概要
static int ID_ACTIVATE_ERROR
          エラー種別がActivate失敗であることを表します(=0x06)。
static int ID_CHECKPIN_ERROR
          エラー種別が PIN 属性参照失敗であることを表します(=0x0e)。
static int ID_CLOSE_ERROR
          エラー種別がクローズ失敗であることを表します(=0x02)。
static int ID_EXECUTEPIN_ERROR
          エラー種別がPIN照合、変更、有効/無効切り替え失敗であること表します(=0x07)。
static int ID_GETADHOCSTATE_ERROR
          エラー種別がアドホックモード取得失敗であることを表します(=0x0f)。
static int ID_GETISSUEINFO_ERROR
          エラー種別がコンテナ発行情報取得失敗であることを表します(=0x0a)。
static int ID_GETKEYVERSION_ERROR
          エラー種別がキーバージョン取得失敗であることを表します(=0x08)。
static int ID_INACTIVATE_ERROR
          エラー種別が Inactivate 失敗であることを表します(=0x09)。
static int ID_NEGOTIATE_BAUDRATE_ERROR
          エラー種別が無線通信速度設定失敗であることを表します(=0x0d)。
static int ID_OPEN_ERROR
          エラー種別がオープン失敗であることを表します(=0x01)。
static int ID_POLLING_ERROR
          エラー種別がポーリング失敗であることを表します(=0x03)
static int ID_READ_ERROR
          エラー種別が読み出し失敗であることを表します(=0x04)。
static int ID_RESET_ERROR
          エラー種別がリセット失敗であることを表します(=0x10)。
static int ID_SETPARAMETER_ERROR
          エラー種別がコマンドパケット属性指定失敗であることを表します(=0x0b)。
static int ID_TURNOFF_RFPOWER_ERROR
          エラー種別が搬送波停止失敗であることを表します(=0x0c)。
static int ID_UNDEFINED_ERROR
          エラー種別が未定義の失敗であることを表します(=0x00)。
static int ID_WRITE_ERROR
          エラー種別が書き込み失敗であることを表します(=0x05)。
static int TYPE_BLOCK_COUNT_OVER_ERROR
          エラー内容が対象カードの同時処理可能ブロック上限数超過であることを表します(=0x0e)。
static int TYPE_BLOCK_NO_ERROR
          エラー内容が ブロックナンバーの 指定不正であることを表します(=0x03)。
static int TYPE_CASHBACK_ERROR
          エラー内容がキャッシュバックエラーであることを表します(=0x02)。
static int TYPE_CYCLIC_ERROR
          エラー内容がサイクリック書き込み同時指定不正であることを表します(=0x04)。
static int TYPE_DEVICE_ERROR
          エラー内容がデバイスエラーであることを表します(=0x11)。
static int TYPE_EXTERNAL_CARD_ERROR
          エラー内容が外部カードエラーであることを表します(=0x13)。
static int TYPE_FORMAT_ERROR
          エラー内容がレスポンスデータのフォーマット不正であることを表します(=0x09)。
static int TYPE_FREEAREA_POLLING_ERROR
          エラー内容がFreeAreaのポーリング失敗であることを表します(=0x14)。
static int TYPE_FREEAREA_READ_ERROR
          エラー内容がFreeAreaのデータ読み込み失敗であることを表します(=0x0b)。
static int TYPE_FREEAREA_RESET_ERROR
          エラー内容が FreeArea のリセット失敗であることを表します(=0x16)。
static int TYPE_FREEAREA_WRITE_ERROR
          エラー内容がFreeAreaのデータ書き込み失敗であることを表します(=0x0c)。
static int TYPE_IDM_MISMATCH_ERROR
          エラー内容が IDm の不一致であることを表します(=0x15)。
static int TYPE_ILLEGAL_STATE_ERROR
          エラー内容が実行手順不正であることを表します(=0x10)。
static int TYPE_PIN_COUNT_OVER_ERROR
           エラー内容が対象カードの同時PIN解除上限数超過であることを表します(=0x0d)。
static int TYPE_PIN_LOCK_OUT_ERROR
          エラー内容がPIN照合試行回数が上限数超過であることを表します(=0x0f)。
static int TYPE_PIN_REQUIRED_ERROR
          エラー内容がPIN照合必要であることを表します(=0x05)。
static int TYPE_PURSE_ERROR
          エラー内容がデクリメントでのパースバリュー不足、あるいは キャッシュバックでのパースバリューのオーバーフローであることを表します(=0x01)。
static int TYPE_SERVICE_CODE_ERROR
          エラー内容が 存在しないサービス指定であることを表します(=0x07)。
static int TYPE_SETATTRIBUTE_ERROR
          エラー内容がPIN属性変更アクセス不正であることを表します(=0x06)。
static int TYPE_SETPIN_ERROR
          エラー内容がPIN指定誤りであることを表します(=0x08)。
static int TYPE_TIMEOUT_ERROR
          エラー内容がレスポンスタイムアウトであることを表します(=0x0a)。
static int TYPE_UNDEFINED_ERROR
          エラー内容が未定義エラーであることを表します(=0x00)。
static int TYPE_UNEXPECTED_ERROR
          エラー内容が予期せぬエラーであることを表します(=0x12)。
 
メソッドの概要
 FelicaStatus getFelicaStatus()
          外部カードからのレスポンスコマンドにて返されたエラー情報を取得します。
 int getID()
          エラー種別を返します。
 int getType()
          エラー内容を返します。
 
クラス Throwable から継承したメソッド
getMessage, printStackTrace, toString
 
クラス Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

ID_UNDEFINED_ERROR

public static final int ID_UNDEFINED_ERROR
エラー種別が未定義の失敗であることを表します(=0x00)。

関連項目:
定数フィールド値

ID_OPEN_ERROR

public static final int ID_OPEN_ERROR
エラー種別がオープン失敗であることを表します(=0x01)。

関連項目:
定数フィールド値

ID_CLOSE_ERROR

public static final int ID_CLOSE_ERROR
エラー種別がクローズ失敗であることを表します(=0x02)。

関連項目:
定数フィールド値

ID_POLLING_ERROR

public static final int ID_POLLING_ERROR
エラー種別がポーリング失敗であることを表します(=0x03)

関連項目:
定数フィールド値

ID_READ_ERROR

public static final int ID_READ_ERROR
エラー種別が読み出し失敗であることを表します(=0x04)。

関連項目:
定数フィールド値

ID_WRITE_ERROR

public static final int ID_WRITE_ERROR
エラー種別が書き込み失敗であることを表します(=0x05)。

関連項目:
定数フィールド値

ID_ACTIVATE_ERROR

public static final int ID_ACTIVATE_ERROR
エラー種別がActivate失敗であることを表します(=0x06)。

関連項目:
定数フィールド値

ID_EXECUTEPIN_ERROR

public static final int ID_EXECUTEPIN_ERROR
エラー種別がPIN照合、変更、有効/無効切り替え失敗であること表します(=0x07)。

関連項目:
定数フィールド値

ID_GETKEYVERSION_ERROR

public static final int ID_GETKEYVERSION_ERROR
エラー種別がキーバージョン取得失敗であることを表します(=0x08)。

関連項目:
定数フィールド値

ID_INACTIVATE_ERROR

public static final int ID_INACTIVATE_ERROR
エラー種別が Inactivate 失敗であることを表します(=0x09)。

関連項目:
定数フィールド値

ID_GETISSUEINFO_ERROR

public static final int ID_GETISSUEINFO_ERROR
エラー種別がコンテナ発行情報取得失敗であることを表します(=0x0a)。

導入されたバージョン:
DoJa-5.0 (903i)
関連項目:
定数フィールド値

ID_SETPARAMETER_ERROR

public static final int ID_SETPARAMETER_ERROR
エラー種別がコマンドパケット属性指定失敗であることを表します(=0x0b)。

導入されたバージョン:
DoJa-5.0 (903i)
関連項目:
定数フィールド値

ID_TURNOFF_RFPOWER_ERROR

public static final int ID_TURNOFF_RFPOWER_ERROR
エラー種別が搬送波停止失敗であることを表します(=0x0c)。

導入されたバージョン:
DoJa-5.0 (903i)
関連項目:
定数フィールド値

ID_NEGOTIATE_BAUDRATE_ERROR

public static final int ID_NEGOTIATE_BAUDRATE_ERROR
エラー種別が無線通信速度設定失敗であることを表します(=0x0d)。

導入されたバージョン:
DoJa-5.0 (903i)
関連項目:
定数フィールド値

ID_CHECKPIN_ERROR

public static final int ID_CHECKPIN_ERROR
エラー種別が PIN 属性参照失敗であることを表します(=0x0e)。

導入されたバージョン:
DoJa-5.0 (903i)
関連項目:
定数フィールド値

ID_GETADHOCSTATE_ERROR

public static final int ID_GETADHOCSTATE_ERROR
エラー種別がアドホックモード取得失敗であることを表します(=0x0f)。

導入されたバージョン:
DoJa-5.0 (903i)
関連項目:
定数フィールド値

ID_RESET_ERROR

public static final int ID_RESET_ERROR
エラー種別がリセット失敗であることを表します(=0x10)。

導入されたバージョン:
DoJa-5.0 (903i)
関連項目:
定数フィールド値

TYPE_UNDEFINED_ERROR

public static final int TYPE_UNDEFINED_ERROR
エラー内容が未定義エラーであることを表します(=0x00)。

関連項目:
定数フィールド値

TYPE_PURSE_ERROR

public static final int TYPE_PURSE_ERROR
エラー内容がデクリメントでのパースバリュー不足、あるいは キャッシュバックでのパースバリューのオーバーフローであることを表します(=0x01)。

関連項目:
定数フィールド値

TYPE_CASHBACK_ERROR

public static final int TYPE_CASHBACK_ERROR
エラー内容がキャッシュバックエラーであることを表します(=0x02)。

関連項目:
定数フィールド値

TYPE_BLOCK_NO_ERROR

public static final int TYPE_BLOCK_NO_ERROR
エラー内容が ブロックナンバーの 指定不正であることを表します(=0x03)。

関連項目:
定数フィールド値

TYPE_CYCLIC_ERROR

public static final int TYPE_CYCLIC_ERROR
エラー内容がサイクリック書き込み同時指定不正であることを表します(=0x04)。

関連項目:
定数フィールド値

TYPE_PIN_REQUIRED_ERROR

public static final int TYPE_PIN_REQUIRED_ERROR
エラー内容がPIN照合必要であることを表します(=0x05)。

関連項目:
定数フィールド値

TYPE_SETATTRIBUTE_ERROR

public static final int TYPE_SETATTRIBUTE_ERROR
エラー内容がPIN属性変更アクセス不正であることを表します(=0x06)。

関連項目:
定数フィールド値

TYPE_SERVICE_CODE_ERROR

public static final int TYPE_SERVICE_CODE_ERROR
エラー内容が 存在しないサービス指定であることを表します(=0x07)。

関連項目:
定数フィールド値

TYPE_SETPIN_ERROR

public static final int TYPE_SETPIN_ERROR
エラー内容がPIN指定誤りであることを表します(=0x08)。

関連項目:
定数フィールド値

TYPE_FORMAT_ERROR

public static final int TYPE_FORMAT_ERROR
エラー内容がレスポンスデータのフォーマット不正であることを表します(=0x09)。

具体的には以下の場合に発生します。

関連項目:
定数フィールド値

TYPE_TIMEOUT_ERROR

public static final int TYPE_TIMEOUT_ERROR
エラー内容がレスポンスタイムアウトであることを表します(=0x0a)。

関連項目:
定数フィールド値

TYPE_FREEAREA_READ_ERROR

public static final int TYPE_FREEAREA_READ_ERROR
エラー内容がFreeAreaのデータ読み込み失敗であることを表します(=0x0b)。

関連項目:
定数フィールド値

TYPE_FREEAREA_WRITE_ERROR

public static final int TYPE_FREEAREA_WRITE_ERROR
エラー内容がFreeAreaのデータ書き込み失敗であることを表します(=0x0c)。

関連項目:
定数フィールド値

TYPE_PIN_COUNT_OVER_ERROR

public static final int TYPE_PIN_COUNT_OVER_ERROR
エラー内容が対象カードの同時PIN解除上限数超過であることを表します(=0x0d)。
FeliCaをオープンしてからクローズするまでの間に解除できるPINの数は制限されており、その制限を超えた時にこのエラー内容が返ります。

関連項目:
定数フィールド値

TYPE_BLOCK_COUNT_OVER_ERROR

public static final int TYPE_BLOCK_COUNT_OVER_ERROR
エラー内容が対象カードの同時処理可能ブロック上限数超過であることを表します(=0x0e)。

関連項目:
定数フィールド値

TYPE_PIN_LOCK_OUT_ERROR

public static final int TYPE_PIN_LOCK_OUT_ERROR
エラー内容がPIN照合試行回数が上限数超過であることを表します(=0x0f)。

関連項目:
定数フィールド値

TYPE_ILLEGAL_STATE_ERROR

public static final int TYPE_ILLEGAL_STATE_ERROR
エラー内容が実行手順不正であることを表します(=0x10)。

具体的には以下の場合に発生します。

  • 無線通信速度設定処理において、事前に搬送波が出力されていない場合。

導入されたバージョン:
DoJa-5.0 (903i)
関連項目:
定数フィールド値

TYPE_DEVICE_ERROR

public static final int TYPE_DEVICE_ERROR
エラー内容がデバイスエラーであることを表します(=0x11)。

具体的には以下の場合に発生します。

  • 外部 R/W からの搬送波を受信中に、FeliCa IC チップが搬送波を出力しようとした場合。
  • 搬送波停止処理において、 ハードウェア要因により搬送波を停止することができなかった場合。

導入されたバージョン:
DoJa-5.0 (903i)
関連項目:
定数フィールド値

TYPE_UNEXPECTED_ERROR

public static final int TYPE_UNEXPECTED_ERROR
エラー内容が予期せぬエラーであることを表します(=0x12)。

具体的には以下の場合に発生します。

  • 外部カードからのレスポンスデータの長さが上限を超えていた場合。

導入されたバージョン:
DoJa-5.0 (903i)
関連項目:
定数フィールド値

TYPE_EXTERNAL_CARD_ERROR

public static final int TYPE_EXTERNAL_CARD_ERROR
エラー内容が外部カードエラーであることを表します(=0x13)。

具体的には以下の場合に発生します。

  • 外部カードからのレスポンスデータにおいてエラー情報が返された場合。

getType() がこのエラー内容を返すときのみ、 getFelicaStatus() によって外部カードから返されたエラー情報 を取得することができます。 getType() がその他のエラー内容を返すときは、 getFelicaStatus() は null を返します。

導入されたバージョン:
DoJa-5.0 (903i)
関連項目:
定数フィールド値

TYPE_FREEAREA_POLLING_ERROR

public static final int TYPE_FREEAREA_POLLING_ERROR
エラー内容がFreeAreaのポーリング失敗であることを表します(=0x14)。

導入されたバージョン:
DoJa-5.0 (903i)
関連項目:
定数フィールド値

TYPE_IDM_MISMATCH_ERROR

public static final int TYPE_IDM_MISMATCH_ERROR
エラー内容が IDm の不一致であることを表します(=0x15)。

導入されたバージョン:
DoJa-5.0 (903i)
関連項目:
定数フィールド値

TYPE_FREEAREA_RESET_ERROR

public static final int TYPE_FREEAREA_RESET_ERROR
エラー内容が FreeArea のリセット失敗であることを表します(=0x16)。

導入されたバージョン:
DoJa-5.0 (903i)
関連項目:
定数フィールド値
メソッドの詳細

getID

public int getID()
エラー種別を返します。

戻り値:
エラー種別。

getType

public int getType()
エラー内容を返します。

戻り値:
エラー内容。

getFelicaStatus

public FelicaStatus getFelicaStatus()
外部カードからのレスポンスコマンドにて返されたエラー情報を取得します。

このオブジェクトの getType()外部カードエラー を返すときのみ、 このメソッドは FelicaStatus オブジェクトを返します。 getType() がその他のエラー内容を返すときは、 このメソッドは null を返します。

戻り値:
エラー情報を返します。エラー情報がない場合は null を返します。
導入されたバージョン:
DoJa-5.0 (903i)