概要 | パッケージ | クラス | 使用 | 階層ツリー | 非推奨 API | 索引 | ヘルプ
前のクラス 次のクラス | フレームあり フレームなし
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド

## org.stormcat.jvbeans.jvlink
クラス JvLinkManagerImpl

    java.lang.Object
      org.stormcat.jvbeans.jvlink.JvLinkManagerImpl

すべての実装されたインタフェース:
  JvLinkManager

    public class JvLinkManagerImpl

extends Object
implements JvLinkManager

`JvLinkManager`の実装クラスです。

各API内部では入力チェックや型変換等の処理を行った後に、`JvLinkWrapper`に処理を委譲します。

作成者:
  a.yamada

コンストラクタの概要
`JvLinkManagerImpl()` コンストラクタ

メソッドの概要
`void` | `cancel()` `JvLinkManager.open(org.stormcat.jvbeans.config.condition.StoredOpenCondition, java.util.Date, org.stormcat.jvbeans.config.DataOption)`によって起動された、JVデータファイルのダウンロード・コピーを安全に中止します。
`JvResult` | `close()` JV-Dataの読み込み処理を正常に終了させます。
`JvCourseFile` | `courseFile(CourseFileKey courseFileKey)` JV-Linkからコースgif画像を要求し、{JRA-VANインストールディレクトリ}/Data Lab/pictures配下に保存します。
`JvCourseFile` | `courseFile2(CourseFileKey courseFileKey, String filePath)` JV-Linkからコースgif画像を要求し、任意の場所に保存します。
`JvResult` | `fileDelete(String fileName)` ダウンロードしたJV-Dataを削除します。
`JvResult` | `fukuFile(String pattern, String filePath)` 任意の勝負服画像情報を要求し、指定のパスに保存します。
`JvBeansContainer` | `getJvBeansContainer()` `JvBeansContainer`を返します。
`JvBindingDtoFactory` | `getJvBindingDtoFactory()` `JvBindingDtoFactory`を返します。
`JvLinkWrapper` | `getJvLinkWrapper()` `JvLinkWrapper`を返します。
`String` | `getUserAgent()` 設定されているUserAgentを返します。
`JvResult` | `init()` JVLinkの初期化を行います。
`
`<T extends JvBindingDto> JvReader<T>`
` | `open(StoredOpenCondition<T> condition, Date fromTime, DataOption dataOption)` 蓄積系データの取得要求を行います。
`
`<T extends JvBindingDto> JvReader<T>`
` | `open(StoredOpenCondition<T> condition, String fromTime, DataOption dataOption)` 蓄積系データの取得要求を行います。
`
`<T extends JvBindingDto> JvReader<T>`
` | `rtOpen(RealTimeOpenCondition<T> condition, RtOpenKey rtOpenKey)` 速報系のデータ取得要求を行います。
`void` | `setJvBeansContainer(JvBeansContainer jvBeansContainer)` `JvBeansContainer`をセットします。
`void` | `setJvBindingDtoFactory(JvBindingDtoFactory jvBindingDtoFactory)` `JvBindingDtoFactory`をセットします。
`JvResult` | `setSaveFlag(boolean saveFlag)` JV-Linkのデータを設定したパスに保存するかどうかを設定します。
`JvResult` | `setSavePath(String savePath)` JV-Linkのデータの保存パスを設定し、レジストリに保存します。
`JvResult` | `setServiceKey(String serviceKey)` JV-Linkのサービスキーを設定し、レジストリに保存します。
`JvResult` | `setUIProperties()` JV-Linkの設定変更を行うためのダイアログを表示します。
`void` | `setUserAgent(String userAgent)` JVLinkからJRA-VANサーバにアクセスする際のUserAgent HTTPヘッダを指定します。
`void` | `skip()` `JvLinkManager.open(org.stormcat.jvbeans.config.condition.StoredOpenCondition, java.util.Date, org.stormcat.jvbeans.config.DataOption)`で準備した不要レコードを読み飛ばします。
`long` | `status()` JV-Dataのダウンロード完了ファイル数を返します。

クラス java.lang.Object から継承されたメソッド
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

コンストラクタの詳細

### JvLinkManagerImpl

    public JvLinkManagerImpl()

  コンストラクタ

メソッドの詳細

### cancel

    public void cancel()

  `JvLinkManager.open(org.stormcat.jvbeans.config.condition.StoredOpenCondition, java.util.Date, org.stormcat.jvbeans.config.DataOption)`によって起動された、JVデータファイルのダウンロード・コピーを安全に中止します。

  キャンセル状態において、`JvReaderImpl`による読み込み処理を行うことはできません。

  定義:
    インタフェース `JvLinkManager` 内の `cancel`

### close

    public JvResult close()

  JV-Dataの読み込み処理を正常に終了させます。

  開いているファイルを全てクローズさせ、実行中のダウンロードスレッドを安全に終了させます。

  データ読み込み後は確実に呼び出す必要があります。

  定義:
    インタフェース `JvLinkManager` 内の `close`
  戻り値:
    結果オブジェクト

### fileDelete

    public JvResult fileDelete(String fileName)

  ダウンロードしたJV-Dataを削除します。

  ファイル名はXXXXX.jvdのように、ファイル名だけを指定します（フルパスを指定する必要はありません）。

  何らかの原因により、ファイルが破損してデータがうまく読みだせなくなった際に使用します。

  定義:
    インタフェース `JvLinkManager` 内の `fileDelete`
  パラメータ:
    `fileName` - 削除対象ファイル名
  戻り値:
    結果オブジェクト

### fukuFile

    public JvResult fukuFile(String pattern,
                             String filePath)

  任意の勝負服画像情報を要求し、指定のパスに保存します。

  定義:
    インタフェース `JvLinkManager` 内の `fukuFile`
  パラメータ:
    `pattern` - 服色標示文字列

    服色標示はJRAレーシングプログラムに記載されているものを指定します。

    (例)水色，赤山形一本輪，水色袖

    `filePath` - 取得画像保存フルパス
  戻り値:
    結果オブジェクト

### init

    public JvResult init()

  JVLinkの初期化を行います。

  JVLinkの一連の処理を行う際に、最初に呼び出す必要があるメソッドです。

  初期化処理の際に、JRA-VANサーバにアクセスする際のUserAgentを設定します。 ここで使用するUserAgentは`JvLinkManager.setUserAgent(String)`でセットされた文字列が使用されますが、 セットしなかった場合はUNKNOWNが使用されます。

  定義:
    インタフェース `JvLinkManager` 内の `init`
  戻り値:
    結果オブジェクト

### open

    public <T extends JvBindingDto> JvReader<T> open(StoredOpenCondition<T> condition,
                                                     Date fromTime,
                                                     DataOption dataOption)

  蓄積系データの取得要求を行います。

  データの読み出しは`JvReader`をイテレートすることで1レコードずつ読み出されます。

  定義:
    インタフェース `JvLinkManager` 内の `open`
  型パラメータ:
    `T` - `JvBindingDto`型
  パラメータ:
    `condition` - データ取得条件
    `fromTime` - データ読み出し開始ポイント(YYYYMMDDhhmmss形式)
    `dataOption` - データオプション

    `null`の場合は`DataOption.STANDARD`で取得要求が行われます。

  戻り値:
    `JvReaderImpl`

### open

    public <T extends JvBindingDto> JvReader<T> open(StoredOpenCondition<T> condition,
                                                     String fromTime,
                                                     DataOption dataOption)

  蓄積系データの取得要求を行います。

  データの読み出しは`JvReader`をイテレートすることで1レコードずつ読み出されます。

  定義:
    インタフェース `JvLinkManager` 内の `open`
  型パラメータ:
    `T` - `JvBindingDto`型
  パラメータ:
    `condition` - データ取得条件
    `fromTime` - データ読み出し開始ポイント(YYYYMMDDhhmmss形式)
    `dataOption` - データオプション

    `null`の場合は`DataOption.STANDARD`で取得要求が行われます。

  戻り値:
    `JvReaderImpl`

### rtOpen

    public <T extends JvBindingDto> JvReader<T> rtOpen(RealTimeOpenCondition<T> condition,
                                                       RtOpenKey rtOpenKey)

  速報系のデータ取得要求を行います。

  データの読み出しは`JvReader`をイテレートすることで1レコードずつ読み出されます。

  定義:
    インタフェース `JvLinkManager` 内の `rtOpen`
  パラメータ:
    `condition` - データ種別
    `rtOpenKey` - 速報系要求キー
  戻り値:
    `JvReaderImpl`

### setSaveFlag

    public JvResult setSaveFlag(boolean saveFlag)

  JV-Linkのデータを設定したパスに保存するかどうかを設定します。

  定義:
    インタフェース `JvLinkManager` 内の `setSaveFlag`
  パラメータ:
    `saveFlag` - `true`:保存する, `false`:保存しない
  戻り値:
    結果オブジェクト

### setSavePath

    public JvResult setSavePath(String savePath)

  JV-Linkのデータの保存パスを設定し、レジストリに保存します。

  保存パスは実際に存在するディレクトリを指定する必要があります。

  定義:
    インタフェース `JvLinkManager` 内の `setSavePath`
  パラメータ:
    `savePath` - 保存パス
  戻り値:
    結果オブジェクト

### setServiceKey

    public JvResult setServiceKey(String serviceKey)

  JV-Linkのサービスキーを設定し、レジストリに保存します。

  サービスキーが設定済みの場合は、サービスキーは変更できません。

  定義:
    インタフェース `JvLinkManager` 内の `setServiceKey`
  パラメータ:
    `serviceKey` - サービスキー
  戻り値:
    結果オブジェクト

### setUIProperties

    public JvResult setUIProperties()

  JV-Linkの設定変更を行うためのダイアログを表示します。

  設定可能なプロパティは以下の通りです。

  - m_saveflag（保存フラグ）
  - m_savepath（保存パス）
  - m_servicekey（サービスキー）

  ただし、サービスキーが既に設定されている場合は変更できません。

  定義:
    インタフェース `JvLinkManager` 内の `setUIProperties`
  戻り値:
    結果オブジェクト

### skip

    public void skip()

  `JvLinkManager.open(org.stormcat.jvbeans.config.condition.StoredOpenCondition, java.util.Date, org.stormcat.jvbeans.config.DataOption)`で準備した不要レコードを読み飛ばします。

  このメソッドはデータ読み込み中にレコード種別IDを判断して使用するものですが、 JV-Beansではバイト単位ではなく、レコード単位で読みだすため意味はありません。

  定義:
    インタフェース `JvLinkManager` 内の `skip`

### status

    public long status()

  JV-Dataのダウンロード完了ファイル数を返します。

  ダウンロード失敗時は例外が発生します。

  定義:
    インタフェース `JvLinkManager` 内の `status`
  戻り値:
    ダウンロード完了ファイル数

### courseFile

    public JvCourseFile courseFile(CourseFileKey courseFileKey)

  JV-Linkからコースgif画像を要求し、{JRA-VANインストールディレクトリ}/Data Lab/pictures配下に保存します。

  keyは`CourseFileKeyFactory`で生成したものを指定します。

  コース説明文を`JvCourseFile.getExplanation()`で取得することが可能です。

  指定したkeyに該当するコースが存在しない場合は、「No Image」画像が保存されます。

  定義:
    インタフェース `JvLinkManager` 内の `courseFile`
  パラメータ:
    `courseFileKey` - コースを指定するkey
  戻り値:
    コース図用結果オブジェクト

### courseFile2

    public JvCourseFile courseFile2(CourseFileKey courseFileKey,
                                    String filePath)

  JV-Linkからコースgif画像を要求し、任意の場所に保存します。

  keyは`CourseFileKeyFactory`で生成したものを指定します。

  `JvLinkManager.courseFile(CourseFileKey)`とは違い、 `JvCourseFile.getExplanation()`にてコース説明文を取得することはできません（`null`を返します）。

  指定したkeyに該当するコースが存在しない場合は、「No Image」画像が保存されます。

  定義:
    インタフェース `JvLinkManager` 内の `courseFile2`
  パラメータ:
    `courseFileKey` - コースを指定するkey
    `filePath` - 取得画像保存フルパス
  戻り値:
    コース図用結果オブジェクト

### setUserAgent

    public void setUserAgent(String userAgent)

  JVLinkからJRA-VANサーバにアクセスする際のUserAgent HTTPヘッダを指定します。

  UserAgentとして指定できる文字列は、最大64バイトで以下の文字で構成されます。

  - 半角文字
  - アルファベット
  - 数字
  - スペース
  - ピリオド
  - スラッシュ
  上述の条件が満たされていない文字列（`null`, 空文字を含む）が渡された場合は`IllegalArgumentException`がthrowされます。

  また、このメソッドを使用しなかった場合はUserAgentとしてUNKNOWNが指定されます。

  設定されたUserAgentは`JvLinkManager.init()`内で指定されます。

  定義:
    インタフェース `JvLinkManager` 内の `setUserAgent`
  パラメータ:
    `userAgent` - UserAgent文字列

### getUserAgent

    public String getUserAgent()

  設定されているUserAgentを返します。

  `JvLinkManager.setUserAgent(String)`で設定されていなければUNKNOWNを返します。

  定義:
    インタフェース `JvLinkManager` 内の `getUserAgent`
  戻り値:
    UserAgent

### getJvBeansContainer

    public JvBeansContainer getJvBeansContainer()

  `JvBeansContainer`を返します。

  戻り値:
    jvBeansContainer `JvBeansContainer`

### setJvBeansContainer

    public void setJvBeansContainer(JvBeansContainer jvBeansContainer)

  `JvBeansContainer`をセットします。

  パラメータ:
    `jvBeansContainer` - `JvBeansContainer`

### getJvBindingDtoFactory

    public JvBindingDtoFactory getJvBindingDtoFactory()

  `JvBindingDtoFactory`を返します。

  戻り値:
    jvBindingDtoFactory `JvBindingDtoFactory`

### setJvBindingDtoFactory

    public void setJvBindingDtoFactory(JvBindingDtoFactory jvBindingDtoFactory)

  `JvBindingDtoFactory`をセットします。

  パラメータ:
    `jvBindingDtoFactory` - `JvBindingDtoFactory`

### getJvLinkWrapper

    public JvLinkWrapper getJvLinkWrapper()

  `JvLinkWrapper`を返します。

  戻り値:
    jvLinkWrapper `JvLinkWrapper`

概要 | パッケージ | クラス | 使用 | 階層ツリー | 非推奨 API | 索引 | ヘルプ
前のクラス 次のクラス | フレームあり フレームなし
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド

Copyright © 2009 The Stormcat Project AllRights Reserved.