パッケージ org.springframework.batch.item.database

クラス HibernateCursorItemReader<T>

java.lang.ObjectSE
org.springframework.batch.item.ItemStreamSupport
org.springframework.batch.item.support.AbstractItemStreamItemReader<T>
org.springframework.batch.item.support.AbstractItemCountingItemStreamItemReader<T>
org.springframework.batch.item.database.HibernateCursorItemReader<T>
実装されているすべてのインターフェース:
ItemReader<T>、ItemStream、ItemStreamReader<T>、org.springframework.beans.factory.InitializingBean
@DeprecatedSE(since="5.0", forRemoval=true) public class HibernateCursorItemReader<T> extends AbstractItemCountingItemStreamItemReader<T> implements org.springframework.beans.factory.InitializingBean
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
5.0 から 5.2 で削除されました。代わりに JpaCursorItemReader を使用してください。
Hibernate 上に構築されたデータベースレコードを読み取るための ItemStreamReader。AbstractItemCountingItemStreamItemReader.read() メソッドが呼び出されると、初期化された結果セットを反復処理するときに HQL クエリを実行し、現在の行に対応するオブジェクトを返します。クエリは setQueryString(String) を使用して直接設定できます。名前付きクエリは setQueryName(String) で使用できます。クエリプロバイダ戦略は setQueryProvider(HibernateQueryProvider) を介して提供できます。

リーダーは、関連付けられたオブジェクトにカスケードする必要のない単純なマッピングに十分な StatelessSession、またはより高度なマッピングまたはキャッシュが必要な場合に標準の休止状態の Session を使用するように構成できます。ステートフルセッションが使用されると、フラッシュされずに update(ExecutionContext) メソッドでクリアされます（データの変更は予期されません）。

実装はスレッドセーフではありません。
作成者:
Robert Kasanicky, Dave Syer, Mahmoud Ben Hassine

  • コンストラクターの概要

    コンストラクター
    コンストラクター
    説明
    HibernateCursorItemReader()
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    afterPropertiesSet()
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    protected void
    doClose()
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    カーソルを閉じ、セッションを休止状態にします。
    protected void
    doOpen()
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    hibernate セッションを開き、クエリの前方専用カーソルを作成します。
    protected T
    doRead()
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    入力から次の項目を読み取ります。
    protected void
    jumpToItem(int itemIndex)
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    リクエストされたアイテムに結果セットを進めます。
    void
    setFetchSize(int fetchSize)
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    Hibernate が内部で使用するフェッチサイズ。ラウンドトリップごとにデータベースからフェッチされるデータの量を制限します。
    void
    setParameterValues(MapSE<StringSE,ObjectSE> parameterValues)
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    クエリに適用するパラメーター値（name:value のマップ）。
    void
    setQueryName(StringSE queryName)
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    外部化されたクエリのクエリ名。
    void
    setQueryProvider(HibernateQueryProvider<T> queryProvider)
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    クエリプロバイダー。
    void
    setQueryString(StringSE queryString)
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    HQL のクエリ文字列。
    void
    setSessionFactory(org.hibernate.SessionFactory sessionFactory)
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    Hibernate SessionFactory を使用してセッションを作成します。
    void
    setUseStatelessSession(boolean useStatelessSession)
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    初期化されていない状態でのみ設定できます。
    void
    update(ExecutionContext executionContext)
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    コンテキストを更新し、ステートフルの場合はセッションをクリアします。

    クラス org.springframework.batch.item.support.AbstractItemCountingItemStreamItemReader から継承されたメソッド

    close, getCurrentItemCount, isSaveState, open, read, setCurrentItemCount, setMaxItemCount, setSaveState

    クラス org.springframework.batch.item.ItemStreamSupport から継承されたメソッド

    getExecutionContextKey, getName, setExecutionContextName, setName

    クラス java.lang.ObjectSE から継承されたメソッド

    clone, equalsSE, finalize, getClass, hashCode, notify, notifyAll, toString, wait, waitSE, waitSE

  • コンストラクターの詳細

    • HibernateCursorItemReader

      public HibernateCursorItemReader()
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。

  • メソッドの詳細

    • afterPropertiesSet

      public void afterPropertiesSet() throws ExceptionSE
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      次で指定:
      インターフェース org.springframework.beans.factory.InitializingBean の afterPropertiesSet 
      例外:
      ExceptionSE

    • setParameterValues

      public void setParameterValues(MapSE<StringSE,ObjectSE> parameterValues)
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      クエリに適用するパラメーター値（name:value のマップ）。
      パラメーター:
      parameterValues - 設定するパラメーター値

    • setQueryName

      public void setQueryName(StringSE queryName)
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      外部化されたクエリのクエリ名。これまたは {query string または {query provider のいずれかを設定する必要があります。
      パラメーター:
      queryName - 休止状態の名前付きクエリの名前

    • setFetchSize

      public void setFetchSize(int fetchSize)
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      Hibernate が内部で使用するフェッチサイズ。ラウンドトリップごとにデータベースからフェッチされるデータの量を制限します。
      パラメーター:
      fetchSize - Hibernate に渡すフェッチサイズ

    • setQueryProvider

      public void setQueryProvider(HibernateQueryProvider<T> queryProvider)
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      クエリプロバイダー。これまたは {query string または {query name のいずれかを設定する必要があります。
      パラメーター:
      queryProvider - Hibernate クエリプロバイダー

    • setQueryString

      public void setQueryString(StringSE queryString)
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      HQL のクエリ文字列。これまたは {query provider または {query name のいずれかを設定する必要があります。
      パラメーター:
      queryString - HQL クエリ文字列

    • setSessionFactory

      public void setSessionFactory(org.hibernate.SessionFactory sessionFactory)
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      Hibernate SessionFactory を使用してセッションを作成します。
      パラメーター:
      sessionFactory - 設定する SessionFactory 

    • setUseStatelessSession

      public void setUseStatelessSession(boolean useStatelessSession)
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      初期化されていない状態でのみ設定できます。
      パラメーター:
      useStatelessSession - true は StatelessSession を使用します。false は標準の休止状態 Session を使用します

    • doRead

      @Nullable protected T doRead() throws ExceptionSE
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      クラスからコピーされた説明: AbstractItemCountingItemStreamItemReader
      入力から次の項目を読み取ります。
      次で指定:
      クラス AbstractItemCountingItemStreamItemReader<T> の doRead 
      戻り値:
      データソースが使い果たされた場合、アイテムまたは null 
      例外:
      ExceptionSE - サブクラスがフレームワークによる解釈のためにチェック済み例外をスローできるようにします

    • doOpen

      protected void doOpen() throws ExceptionSE
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      hibernate セッションを開き、クエリの前方専用カーソルを作成します。
      次で指定:
      クラス AbstractItemCountingItemStreamItemReader<T> の doOpen 
      例外:
      ExceptionSE - サブクラスがフレームワークによる解釈のためにチェック済み例外をスローできるようにします

    • update

      public void update(ExecutionContext executionContext) throws ItemStreamException
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      コンテキストを更新し、ステートフルの場合はセッションをクリアします。
      次で指定:
      インターフェース ItemStream の update 
      オーバーライド:
      クラス AbstractItemCountingItemStreamItemReader<T> の update 
      パラメーター:
      executionContext - 現在の ExecutionContext
      例外:
      ItemStreamException - 問題がある場合
      関連事項:

    • jumpToItem

      protected void jumpToItem(int itemIndex) throws ExceptionSE
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      リクエストされたアイテムに結果セットを進めます。また、時々セッションをクリアして（ステートフルの場合）、メモリの問題を回避します。セッションのクリアの頻度は、フェッチサイズ（設定されている場合）と 100 の大きい方です。
      オーバーライド:
      クラス AbstractItemCountingItemStreamItemReader<T> の jumpToItem 
      パラメーター:
      itemIndex - 最初に読む項目
      例外:
      ExceptionSE - 問題がある場合
      関連事項:

    • doClose

      protected void doClose() throws ExceptionSE
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      カーソルを閉じ、セッションを休止状態にします。
      次で指定:
      クラス AbstractItemCountingItemStreamItemReader<T> の doClose 
      例外:
      ExceptionSE - サブクラスがフレームワークによる解釈のためにチェック済み例外をスローできるようにします