org.stormcat.jvbeans.jvlink
クラス JvLinkManagerImpl

java.lang.Object
  上位を拡張 org.stormcat.jvbeans.jvlink.JvLinkManagerImpl
すべての実装されたインタフェース:
JvLinkManager

public class JvLinkManagerImpl
extends Object
implements JvLinkManager

JvLinkManagerの実装クラスです。

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

導入されたバージョン:
0.1
作成者:
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)
          速報系のデータ取得要求を行います。
<T extends JvBindingDto>
JvReader<String>
rtSimpleOpen(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ヘッダを指定します。
<T extends JvBindingDto>
JvReader<String>
simpleOpen(StoredOpenCondition<T> condition, Date fromTime, DataOption dataOption)
          蓄積系データの取得要求を行います。
<T extends JvBindingDto>
JvReader<String>
simpleOpen(StoredOpenCondition<T> condition, String fromTime, DataOption dataOption)
          蓄積系データの取得要求を行います。
 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で取得要求が行われます。

戻り値:
JvReader

simpleOpen

public <T extends JvBindingDto> JvReader<String> simpleOpen(StoredOpenCondition<T> condition,
                                                            Date fromTime,
                                                            DataOption dataOption)
蓄積系データの取得要求を行います。

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

DTOへのバインディングは行いません。

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

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

戻り値:
JvReader

simpleOpen

public <T extends JvBindingDto> JvReader<String> simpleOpen(StoredOpenCondition<T> condition,
                                                            String fromTime,
                                                            DataOption dataOption)
蓄積系データの取得要求を行います。

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

DTOへのバインディングは行いません。

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

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

戻り値:
JvReader

rtOpen

public <T extends JvBindingDto> JvReader<T> rtOpen(RealTimeOpenCondition<T> condition,
                                                   RtOpenKey rtOpenKey)
速報系のデータ取得要求を行います。

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

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

rtSimpleOpen

public <T extends JvBindingDto> JvReader<String> rtSimpleOpen(RealTimeOpenCondition<T> condition,
                                                              RtOpenKey rtOpenKey)
速報系のデータ取得要求を行います。

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

DTOへのバインディングは行いません。

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

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の設定変更を行うためのダイアログを表示します。

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

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

定義:
インタフェース 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


Copyright © 2009-2010 The Stormcat Project AllRights Reserved.