クラス ResourceDatabasePopulator

java.lang.ObjectSE
org.springframework.r2dbc.connection.init.ResourceDatabasePopulator
実装されたすべてのインターフェース:
DatabasePopulator

public class ResourceDatabasePopulator extends ObjectSE implements DatabasePopulator
外部リソースで定義された SQL スクリプトを使用して、データベースにデータを入力、初期化、クリーンアップします。
導入:
5.3
作成者:
Keith Donald, Dave Syer, Juergen Hoeller, Chris Beams, Oliver Gierke, Sam Brannen, Chris Baldwin, Phillip Webb, Mark Paluch
関連事項:
  • コンストラクターのサマリー

    コンストラクター
    コンストラクター
    説明
    デフォルト設定で新しい ResourceDatabasePopulator を作成します。
    ResourceDatabasePopulator(boolean continueOnError, boolean ignoreFailedDrops, StringSE sqlScriptEncoding, Resource... scripts)
    指定された値で新しい ResourceDatabasePopulator を構築します。
    提供されたスクリプトのデフォルト設定で新しい ResourceDatabasePopulator を作成します。
  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    データベースを初期化またはクリーンアップするために実行するスクリプトを追加します。
    void
    addScripts(Resource... scripts)
    データベースを初期化またはクリーンアップするために実行する複数のスクリプトを追加します。
    reactor.core.publisher.Mono<VoidSE>
    populate(Connection connection)
    提供されている R2DBC Connection を使用して、データベースにデータを入力、初期化、クリーンアップします。
    void
    setBlockCommentEndDelimiter(StringSE blockCommentEndDelimiter)
    SQL スクリプト内のブロックコメントを識別する終了区切り文字を設定します。
    void
    setBlockCommentStartDelimiter(StringSE blockCommentStartDelimiter)
    SQL スクリプト内のブロックコメントを識別する開始区切り文字を設定します。
    void
    setCommentPrefix(StringSE commentPrefix)
    SQL スクリプト内の単一行コメントを識別する接頭辞を設定します。
    void
    setCommentPrefixes(StringSE... commentPrefixes)
    SQL スクリプト内の単一行コメントを識別するプレフィックスを設定します。
    void
    setContinueOnError(boolean continueOnError)
    SQL のすべての失敗をログに記録する必要があるが、失敗の原因にはならないことを示すフラグ。
    void
    Resource のロードに使用するように DataBufferFactory を設定します。
    void
    setIgnoreFailedDrops(boolean ignoreFailedDrops)
    失敗した SQL DROP ステートメントを無視できることを示すフラグ。
    void
    setScripts(Resource... scripts)
    実行するスクリプトを設定して、データベースを初期化またはクリーンアップし、以前に追加したスクリプトを置き換えます。
    void
    カスタムの場合は、ステートメントの区切り記号を指定します。
    void
    setSqlScriptEncoding(StringSE sqlScriptEncoding)
    構成された SQL スクリプトのエンコードを指定します(プラットフォームのエンコードと異なる場合)。
    void
    setSqlScriptEncoding(CharsetSE sqlScriptEncoding)
    構成された SQL スクリプトのエンコードを指定します(プラットフォームのエンコードと異なる場合)。

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

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

    インターフェース org.springframework.r2dbc.connection.init.DatabasePopulator から継承されたメソッド

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

    • ResourceDatabasePopulator

      public ResourceDatabasePopulator()
      デフォルト設定で新しい ResourceDatabasePopulator を作成します。
    • ResourceDatabasePopulator

      public ResourceDatabasePopulator(Resource... scripts)
      提供されたスクリプトのデフォルト設定で新しい ResourceDatabasePopulator を作成します。
      パラメーター:
      scripts - データベースを初期化またはクリーンアップするために実行するスクリプト (非 null)
    • ResourceDatabasePopulator

      public ResourceDatabasePopulator(boolean continueOnError, boolean ignoreFailedDrops, @Nullable StringSE sqlScriptEncoding, Resource... scripts)
      指定された値で新しい ResourceDatabasePopulator を構築します。
      パラメーター:
      continueOnError - SQL のすべての失敗をログに記録する必要があるが、失敗の原因にはならないことを示すフラグ
      ignoreFailedDrops - 失敗した SQL DROP ステートメントを無視できることを示すフラグ
      sqlScriptEncoding - 提供された SQL スクリプトのエンコーディング (null またはプラットフォームのエンコーディングを示す空の場合があります)
      scripts - データベースを初期化またはクリーンアップするために実行するスクリプト (非 null)
  • メソッドの詳細

    • addScript

      public void addScript(Resource script)
      データベースを初期化またはクリーンアップするために実行するスクリプトを追加します。
      パラメーター:
      script - SQL スクリプトへのパス (非 null)
    • addScripts

      public void addScripts(Resource... scripts)
      データベースを初期化またはクリーンアップするために実行する複数のスクリプトを追加します。
      パラメーター:
      scripts - 実行するスクリプト (非 null)
    • setScripts

      public void setScripts(Resource... scripts)
      実行するスクリプトを設定して、データベースを初期化またはクリーンアップし、以前に追加したスクリプトを置き換えます。
      パラメーター:
      scripts - 実行するスクリプト (非 null)
    • setSqlScriptEncoding

      public void setSqlScriptEncoding(@Nullable StringSE sqlScriptEncoding)
      構成された SQL スクリプトのエンコードを指定します(プラットフォームのエンコードと異なる場合)。
      パラメーター:
      sqlScriptEncoding - スクリプトで使用されるエンコーディング (null またはプラットフォームのエンコーディングを示す空の場合があります)
      関連事項:
    • setSqlScriptEncoding

      public void setSqlScriptEncoding(@Nullable CharsetSE sqlScriptEncoding)
      構成された SQL スクリプトのエンコードを指定します(プラットフォームのエンコードと異なる場合)。
      パラメーター:
      sqlScriptEncoding - スクリプトで使用されるエンコーディング (null またはプラットフォームのエンコーディングを示す空の場合があります)
      関連事項:
    • setSeparator

      public void setSeparator(StringSE separator)
      カスタムの場合は、ステートメントの区切り記号を指定します。

      指定しない場合はデフォルトで ";" になり、最後の手段として "\n" にフォールバックします。ScriptUtils.EOF_STATEMENT_SEPARATOR に設定すると、各スクリプトに区切り文字のない単一のステートメントが含まれることを通知できます。

      パラメーター:
      separator - スクリプトステートメントセパレーター
    • setCommentPrefix

      public void setCommentPrefix(StringSE commentPrefix)
      SQL スクリプト内の単一行コメントを識別する接頭辞を設定します。

      デフォルトは "--" です。

      パラメーター:
      commentPrefix - 単一行コメントの接頭辞
      関連事項:
    • setCommentPrefixes

      public void setCommentPrefixes(StringSE... commentPrefixes)
      SQL スクリプト内の単一行コメントを識別するプレフィックスを設定します。

      デフォルトは ["--"] です。

      パラメーター:
      commentPrefixes - 単一行コメントの接頭辞
    • setBlockCommentStartDelimiter

      public void setBlockCommentStartDelimiter(StringSE blockCommentStartDelimiter)
      SQL スクリプト内のブロックコメントを識別する開始区切り文字を設定します。

      デフォルトは "/*" です。

      パラメーター:
      blockCommentStartDelimiter - ブロックコメントの開始区切り文字 (null または空ではありません)
      関連事項:
    • setBlockCommentEndDelimiter

      public void setBlockCommentEndDelimiter(StringSE blockCommentEndDelimiter)
      SQL スクリプト内のブロックコメントを識別する終了区切り文字を設定します。

      デフォルトは "*/" です。

      パラメーター:
      blockCommentEndDelimiter - ブロックコメントの終了区切り文字 (null または空ではありません)
      関連事項:
    • setContinueOnError

      public void setContinueOnError(boolean continueOnError)
      SQL のすべての失敗をログに記録する必要があるが、失敗の原因にはならないことを示すフラグ。

      デフォルトは false です。

      パラメーター:
      continueOnError - スクリプトの実行をエラー時に続行する必要がある場合は true 
    • setIgnoreFailedDrops

      public void setIgnoreFailedDrops(boolean ignoreFailedDrops)
      失敗した SQL DROP ステートメントを無視できることを示すフラグ。

      これは、SQL ダイアレクトが DROP ステートメントの IF EXISTS 句をサポートしていない非埋め込みデータベースに役立ちます。

      デフォルトは false であるため、ポピュレーターが誤って実行された場合、スクリプトが DROP ステートメントで開始すると、ポピュレーターはすぐに失敗します。

      パラメーター:
      ignoreFailedDrops - 失敗したドロップステートメントを無視する必要がある場合は true 
    • setDataBufferFactory

      public void setDataBufferFactory(DataBufferFactory dataBufferFactory)
      Resource のロードに使用するように DataBufferFactory を設定します。

      デフォルトは DefaultDataBufferFactory です。

      パラメーター:
      dataBufferFactory - 使用する DataBufferFactory は null であってはなりません
    • populate

      public reactor.core.publisher.Mono<VoidSE> populate(Connection connection)
      インターフェースからコピーされた説明: DatabasePopulator
      提供されている R2DBC Connection を使用して、データベースにデータを入力、初期化、クリーンアップします。
      次で指定:
      インターフェース DatabasePopulatorpopulate 
      パラメーター:
      connection - データベースへの入力に使用する R2DBC 接続。すでに構成され、使用する準備ができています。null であってはなりません。
      戻り値:
      スクリプトの実行を開始し、完了時に通知される Mono