Package org.iplass.mtp.entity

Interface EntityManager

All Superinterfaces:
Manager
public interface EntityManager extends Manager

Entityを管理するクラスのインタフェースです。 EntityManagerを利用し、定義されているEntityのデータのCRUD操作が可能です。

EntityManager操作中に、例外が発生した場合のトランザクションに関する挙動は次の形となります。

  • SystemExceptionおよびRuntime例外、エラー:トランザクションは自動的にsetRollbackOnlyに設定される
  • ApplicationException:参照メソッド（load,searchなど）では、トランザクションはsetRollbackOnlyに設定されない。更新系メソッドでは自動的にsetRollbackOnlyに設定される

  • Method Summary

    Modifier and Type
    Method
    Description
    List<Entity>
    batchLoad(List<EntityKey> keys, String definitionName)
    指定のEntityキー情報で特定されるデータを取得します。 取得するプロパティは、Entityに定義されているもの全てを取得します。 ReferencePropertyが定義されている場合は、 当該プロパティにはoidとnameが格納されたEntityのインスタンスが格納されます。 ReferencePropertyが指定されている場合で、そのプロパティが複数可の場合は、 当該プロパティはEntity[]の形で取得されます。
    List<Entity>
    batchLoad(List<EntityKey> keys, String definitionName, LoadOption option)
    指定のEntityキー情報で特定されるデータを取得します。 取得するプロパティは、optionにて指定されたものです。
    void
    bulkUpdate(BulkUpdatable bulkUpdatable)
    bulkUpdatableで指定される一連のEntityを一括で更新（Insert/Update/Delete）します。 更新処理の際は、EntityEventListenerの呼び出しや、Validation、タイムスタンプチェック、CascadeDelete処理などは実行されません。 外部のマスタデータの取り込み、初期データImportなどの用途での利用を想定しています。 bulkUpdatableのclose()は処理後（もしくは例外発生後）、当メソッド内で呼び出されます。
    bulkUpdate()を呼び出す実行ユーザーは当該Entityに対して登録、更新、削除権限を範囲条件なしに保有している必要があります。
    更新、削除時には対象とするEntityのoidを指定してください。また、バージョン管理が有効の場合はversionの値も明示的に指定する必要があります。
    注意
    Binary型、LongText型、AutoNumber型を利用している場合、bulkUpdate利用によっても高速化は望めない場合があります。
    また、BulkUpdateEntity.UpdateMethod.MERGEを利用している場合、bulkUpdate利用によっても高速化は望めない場合があります。
    int
    count(Query query)
    検索件数を取得します。
    BinaryReference
    createBinaryReference(File file, String name, String type)
    BinaryReferenceを新規に作成します。 引数のfileのデータを同時にバイナリデータとして書き込みます。
    作成されたBinaryReferenceはまだEntityに紐付いていない状態です。
    nameが未指定の場合は、fileの名前がnameに指定されます。 typeが未指定の場合は、fileの拡張子からmimetypeが解決されます。
    BinaryReference
    createBinaryReference(String name, String type, InputStream is)
    BinaryReferenceを新規に作成します。 引数のisのデータを同時にバイナリデータとして書き込みます。
    isがnullの場合は、バイナリデータが空の状態で新規に作成されます。 書き込みは別途getOutputStream(BinaryReference)メソッドを介して、行うことが可能です。
    作成されたBinaryReferenceはまだEntityに紐付いていない状態です。 引数のisはBinaryReference作成後、当メソッド内でcloseします。
    Entity
    deepCopy(String oid, String definitionName)
    指定のoid（オブジェクトID）で一意に特定されるデータを取得し、参照先を含めたコピーを行います。 親子関係の参照先のエンティティはoidが新たに採番され、 通常の参照の場合、被参照ならコピー対象外になり、被参照でなければそのまま参照されます。 また制約として、変更不可の項目についてはコピー後に変更はできなくなり、 文字列以外のプロパティでユニーク指定されている場合はコピー自体ができません。
    Entity
    deepCopy(String oid, String definitionName, DeepCopyOption option)
    指定のoid（オブジェクトID）で一意に特定されるデータを取得し、参照先を含めたコピーを行います。 親子関係の参照先のエンティティはoidが新たに採番され、 通常の参照の場合、被参照ならコピー対象外になり、被参照でなければそのまま参照されます。 また制約として、変更不可の項目についてはコピー後に変更はできなくなり、 文字列以外のプロパティでユニーク指定されている場合はコピー自体ができません。
    void
    delete(Entity entity, DeleteOption option)
    引数のentityに設定されたoid（オブジェクトID）で一意に特定されるデータを削除します。
    int
    deleteAll(DeleteCondition cond)
    引数のcondに一致するデータを一括で削除します。 タイムスタンプチェックなどは行いません。 別のデータ（親オブジェクトなど）で一貫性を保障した上での、一括削除操作を想定しています。 deleteAllでは、Entityの削除イベントは発生しません。
    <T extends Entity>
    SearchResult<T>
    fulltextSearchEntity(String definitionName, String keyword)
    指定のワードで全文検索します。 defNameが未指定の場合は利用テナントの全エンティティに対して全文検索を実施します。
    <T extends Entity>
    SearchResult<T>
    fulltextSearchEntity(String keyword, FulltextSearchOption option)
    指定のワードで全文検索し、指定プロパティのみを取得します。 FulltextSearchOptionのconditionsが未指定の場合は利用テナントの全エンティティに対して全文検索を実施します。
    <T extends Entity>
    SearchResult<T>
    fulltextSearchEntity(Map<String,List<String>> entityProperties, String keyword)
    指定のワードで全文検索し、指定プロパティのみを取得します。 entityPropertiesが未指定の場合は利用テナントの全エンティティに対して全文検索を実施します。
    <T extends Entity>
    SearchResult<T>
    fulltextSearchEntity(Query query, String keyword, SearchOption option)
    クエリ実行結果に対して、指定のワードで全文検索します。
    List<String>
    fulltextSearchOidList(String definitionName, String keyword)
    指定のワードで全文検索し、oidのリストを取得します。 definitionName、keywordは必須。未指定の場合は空のリストを返却します。
    Map<String,List<String>>
    fulltextSearchOidList(List<String> definitionNames, String keyword)
    指定のワードで全文検索し、対象Entity毎のoidリストのMapを取得します。 definitionNames、keywordは必須。未指定の場合は空のMapを返却します。
    Timestamp
    getCurrentTimestamp()
    現在の時間を取得します。 取得される値は、実時間ではなく、あらかじめ設定されたシステム時間である場合もあります。
    InputStream
    getInputStream(BinaryReference binaryReference)
    引数で指定されたBinaryReferenceのバイナリデータを取得するためのInputStreamを取得します。
    OutputStream
    getOutputStream(BinaryReference binaryReference)
    引数で指定されたBinaryReferenceのバイナリデータを書き込むためのOutputStreamを取得します。 OutputStramは利用終了したら必ずclose()してください。
    Entity
    getRecycleBin(long recycleBinId, String definitionName)
    ごみ箱の中身から、指定のrecycleBinIdで特定される1件を取得します。
    void
    getRecycleBin(String definitionName, Predicate<Entity> callback)
    ごみ箱の中身のリストを取得します。 取得可能なものは、recycleBinId,oid,nameのみです。 recycleBinIdは、ごみ箱内のデータを一意に特定するid。（oidは重複する可能性があるため）
    String
    insert(Entity entity)
    指定の引数のentityを追加します。 entityにoid（オブジェクトID）が設定されていても必ず新しいIDで採番されます。
    String
    insert(Entity entity, InsertOption option)
    指定の引数のentityを追加します。
    Entity
    load(String oid, Long version, String definitionName)
    指定のoid（Entityオブジェクトを一意に特定するID）、versionで特定されるデータを取得します。 取得するプロパティは、Entityに定義されているもの全てを取得します。 ReferencePropertyが定義されている場合は、 当該プロパティにはoidとnameが格納されたEntityのインスタンスが格納されます。 ReferencePropertyが指定されている場合で、そのプロパティが複数可の場合は、 当該プロパティはEntity[]の形で取得されます。
    Entity
    load(String oid, Long version, String definitionName, LoadOption option)
    指定のoid（Entityオブジェクトを一意に特定するID）、versionで特定されるデータを取得します。 取得するプロパティは、optionにて指定されたものです。
    Entity
    load(String oid, String definitionName)
    指定のoid（Entityオブジェクトを一意に特定するID）で特定されるデータを取得します。 取得するプロパティは、Entityに定義されているもの全てを取得します。 ReferencePropertyが定義されている場合は、 当該プロパティにはoidとnameが格納されたEntityのインスタンスが格納されます。 ReferencePropertyが指定されている場合で、そのプロパティが複数可の場合は、 当該プロパティはEntity[]の形で取得されます。
    Entity
    load(String oid, String definitionName, LoadOption option)
    指定のoid（Entityオブジェクトを一意に特定するID）で特定されるデータを取得します。 取得するプロパティは、optionにて指定されたものです。
    Entity
    loadAndLock(String oid, String definitionName)
    指定のoid（Entityオブジェクトを一意に特定するID）で一意に特定されるデータを取得し、更新ロックします。 ロックは、トランザクション終了まで保持されます。
    Entity
    loadAndLock(String oid, String definitionName, LoadOption option)
    指定のoid（Entityオブジェクトを一意に特定するID）で一意に特定されるデータを取得し、更新ロックします。 ロックは、トランザクション終了まで保持されます。 取得するプロパティは、optionにて指定されたものです。
    BinaryReference
    loadBinaryReference(long lobId)
    引数で指定されるBinaryReferenceを取得します。
    boolean
    lockByUser(String oid, String definitionName)
    現在、当該メソッドを呼び出しているユーザーにて、 指定のEntityをデータをロックします。 ユーザーによるロックはunlockByUser()メソッドにて明示的に開放しない限り、 トランザクションを終了してもロックは保持されます。
    void
    normalize(Entity entity)
    指定のEntityのプロパティの値を正規化します。
    void
    normalize(Entity entity, List<String> properties)
    指定のEntityの指定のプロパティの値を正規化します。
    void
    purge(long recycleBinId, String definitionName)
    ごみ箱から、削除します。 recycleBinIdは、ごみ箱内のデータを一意に特定するidです（oidは重複する可能性があるため）。
    purge()を呼び出す実行ユーザーは当該Entityに対して削除権限を範囲条件なしに保有している必要があります。
    Entity
    restore(long recycleBinId, String definitionName)
    ごみ箱から復活します。
    restore()を呼び出す実行ユーザーは当該Entityに対して削除権限を範囲条件なしに保有しているか、 もしくは自身がごみ箱に格納したEntityである必要があります。
    SearchResult<Object[]>
    search(Query query)
    Entityの形ではない、汎用的な検索（複数Entityをまたいだ集計クエリー等）を行うための検索メソッドです。
    void
    search(Query query, Predicate<Object[]> callback)
    Entityの形ではない、汎用的な検索（複数Entityをまたいだ集計クエリー等）を行うためのメソッドです。 データ件数が多い場合に利用可能で、取得したデータを一括でロードせずに1件ずつロードするためのメソッドです。 ロードしたデータは、callbackに渡されます。
    SearchResult<Object[]>
    search(Query query, SearchOption option)
    指定の条件で検索します。 Entityの形ではない、汎用的な検索（複数Entityをまたいだ集計クエリー等）を行うための検索メソッドです。
    void
    search(Query query, SearchOption option, Predicate<Object[]> callback)
    Entityの形ではない、汎用的な検索（複数Entityをまたいだ集計クエリー等）を行うためのメソッドです。 データ件数が多い場合に利用可能で、取得したデータを一括でロードせずに1件ずつロードするためのメソッドです。 ロードしたデータは、callbackに渡されます。
    optionでは、SearchOption.unnotifyListeners()の設定のみ有効です。その他の設定は本メソッド呼び出しでは無視されます。
    <T extends Entity>
    SearchResult<T>
    searchEntity(Query query)
    指定の条件で検索します。
    <T extends Entity>
    void
    searchEntity(Query query, Predicate<T> callback)
    指定の条件で検索します。 データ件数が多い場合、取得したデータを一括でロードせずに、1件ずつロードします。 ロードしたデータは、callbackに渡されます。
    <T extends Entity>
    SearchResult<T>
    searchEntity(Query query, SearchOption option)
    指定の条件で検索します。
    <T extends Entity>
    void
    searchEntity(Query query, SearchOption option, Predicate<T> callback)
    指定の条件で検索します。 データ件数が多い場合、取得したデータを一括でロードせずに、1件ずつロードします。 ロードしたデータは、callbackに渡されます。
    optionでは、SearchOption.unnotifyListeners()の設定のみ有効です。その他の設定は本メソッド呼び出しでは無視されます。
    boolean
    unlockByUser(String oid, String definitionName)
    ユーザーにてロックされているEntityのデータのロックを解除します。
    void
    update(Entity entity, UpdateOption option)
    引数のentityを更新します。
    int
    updateAll(UpdateCondition cond)
    引数のcondに一致するデータを設定された値にて一括更新します。 タイムスタンプチェックなどは行いません。 別のデータ（親オブジェクトなど）で一貫性を保障した上での、ステータス情報の一括更新等の用途を想定しています。 ReferencePropertyの更新は不可です。 updateAllでは、Entityの更新イベントは発生しません。
    ValidateResult
    validate(Entity entity)
    指定のEntityの検証を行います。 検証の前に、プロパティの値は正規化されます。
    ValidateResult
    validate(Entity entity, List<String> properties)
    指定のEntityの指定のプロパティの検証を行います。 検証の前に、プロパティの値は正規化されます。

  • Method Details

    • validate

      ValidateResult validate(Entity entity)
      指定のEntityの検証を行います。 検証の前に、プロパティの値は正規化されます。
      Parameters:
      entity - 検証対象のEntity
      Returns:
      検証結果

    • validate

      ValidateResult validate(Entity entity, List<String> properties)
      指定のEntityの指定のプロパティの検証を行います。 検証の前に、プロパティの値は正規化されます。
      Parameters:
      entity - 検証対象のEntity
      properties - 検証対象のプロパティ名のリスト
      Returns:
      検証結果

    • normalize

      void normalize(Entity entity)
      指定のEntityのプロパティの値を正規化します。
      Parameters:
      entity - 正規化対象のEntity

    • normalize

      void normalize(Entity entity, List<String> properties)
      指定のEntityの指定のプロパティの値を正規化します。
      Parameters:
      entity - 正規化対象のEntity
      properties - 正規化対象のプロパティ名のリスト

    • searchEntity

      <T extends Entity> SearchResult<T> searchEntity(Query query)
      指定の条件で検索します。
      Parameters:
      query - 検索条件
      Returns:
      検索条件に一致したデータのリスト

    • searchEntity

      <T extends Entity> SearchResult<T> searchEntity(Query query, SearchOption option)
      指定の条件で検索します。
      Parameters:
      query - 検索条件
      option - 検索処理のオプション指定
      Returns:

    • searchEntity

      <T extends Entity> void searchEntity(Query query, Predicate<T> callback)
      指定の条件で検索します。 データ件数が多い場合、取得したデータを一括でロードせずに、1件ずつロードします。 ロードしたデータは、callbackに渡されます。
      Parameters:
      query - 検索条件
      callback - 順次読み込んだデータを受けるコールバック処理

    • searchEntity

      <T extends Entity> void searchEntity(Query query, SearchOption option, Predicate<T> callback)
      指定の条件で検索します。 データ件数が多い場合、取得したデータを一括でロードせずに、1件ずつロードします。 ロードしたデータは、callbackに渡されます。
      optionでは、SearchOption.unnotifyListeners()の設定のみ有効です。その他の設定は本メソッド呼び出しでは無視されます。
      Parameters:
      query - 検索条件
      option - 検索処理のオプション指定
      callback - 順次読み込んだデータを受けるコールバック処理

    • search

      SearchResult<Object[]> search(Query query)
      Entityの形ではない、汎用的な検索（複数Entityをまたいだ集計クエリー等）を行うための検索メソッドです。
      Parameters:
      query - 検索条件
      Returns:
      queryに指定されたselect句の項目を保持するObject[]

    • search

      SearchResult<Object[]> search(Query query, SearchOption option)
      指定の条件で検索します。 Entityの形ではない、汎用的な検索（複数Entityをまたいだ集計クエリー等）を行うための検索メソッドです。
      Parameters:
      query - 検索条件
      option - 検索処理のオプション指定
      Returns:

    • search

      void search(Query query, Predicate<Object[]> callback)
      Entityの形ではない、汎用的な検索（複数Entityをまたいだ集計クエリー等）を行うためのメソッドです。 データ件数が多い場合に利用可能で、取得したデータを一括でロードせずに1件ずつロードするためのメソッドです。 ロードしたデータは、callbackに渡されます。
      Parameters:
      query - 検索条件
      callback - 順次読み込んだデータを受けるコールバック処理

    • search

      void search(Query query, SearchOption option, Predicate<Object[]> callback)
      Entityの形ではない、汎用的な検索（複数Entityをまたいだ集計クエリー等）を行うためのメソッドです。 データ件数が多い場合に利用可能で、取得したデータを一括でロードせずに1件ずつロードするためのメソッドです。 ロードしたデータは、callbackに渡されます。
      optionでは、SearchOption.unnotifyListeners()の設定のみ有効です。その他の設定は本メソッド呼び出しでは無視されます。
      Parameters:
      query - 検索条件
      option - 検索処理のオプション指定
      callback - 順次読み込んだデータを受けるコールバック処理

    • count

      int count(Query query)
      検索件数を取得します。
      Parameters:
      cond - 検索条件
      Returns:
      実検索件数

    • load

      Entity load(String oid, String definitionName)
      指定のoid（Entityオブジェクトを一意に特定するID）で特定されるデータを取得します。 取得するプロパティは、Entityに定義されているもの全てを取得します。 ReferencePropertyが定義されている場合は、 当該プロパティにはoidとnameが格納されたEntityのインスタンスが格納されます。 ReferencePropertyが指定されている場合で、そのプロパティが複数可の場合は、 当該プロパティはEntity[]の形で取得されます。
      Parameters:
      oid - オブジェクトID
      definitionName - Entity定義名
      Returns:
      oidで指定されるデータ

    • load

      Entity load(String oid, Long version, String definitionName)
      指定のoid（Entityオブジェクトを一意に特定するID）、versionで特定されるデータを取得します。 取得するプロパティは、Entityに定義されているもの全てを取得します。 ReferencePropertyが定義されている場合は、 当該プロパティにはoidとnameが格納されたEntityのインスタンスが格納されます。 ReferencePropertyが指定されている場合で、そのプロパティが複数可の場合は、 当該プロパティはEntity[]の形で取得されます。
      Parameters:
      oid - オブジェクトID
      version - バージョン番号
      definitionName - Entity定義名
      Returns:
      oid,versionで指定されるデータ

    • load

      Entity load(String oid, String definitionName, LoadOption option)
      指定のoid（Entityオブジェクトを一意に特定するID）で特定されるデータを取得します。 取得するプロパティは、optionにて指定されたものです。
      Parameters:
      oid - オブジェクトID
      definitionName - Entity定義名
      option - 読込オプション、読み込むプロパティを指定可能
      Returns:
      oidで指定されるデータ

    • load

      Entity load(String oid, Long version, String definitionName, LoadOption option)
      指定のoid（Entityオブジェクトを一意に特定するID）、versionで特定されるデータを取得します。 取得するプロパティは、optionにて指定されたものです。
      Parameters:
      oid - オブジェクトID
      version - バージョン番号
      definitionName - Entity定義名
      option - 読込オプション、読み込むプロパティを指定可能
      Returns:
      oid,versionで指定されるデータ

    • loadAndLock

      Entity loadAndLock(String oid, String definitionName)
      指定のoid（Entityオブジェクトを一意に特定するID）で一意に特定されるデータを取得し、更新ロックします。 ロックは、トランザクション終了まで保持されます。
      Parameters:
      oid - オブジェクトID
      definitionName - Entity定義名
      Returns:
      oidで指定されるデータ

    • loadAndLock

      Entity loadAndLock(String oid, String definitionName, LoadOption option)
      指定のoid（Entityオブジェクトを一意に特定するID）で一意に特定されるデータを取得し、更新ロックします。 ロックは、トランザクション終了まで保持されます。 取得するプロパティは、optionにて指定されたものです。
      Parameters:
      oid - オブジェクトID
      definitionName - Entity定義名
      option - 読込オプション、読み込むプロパティを指定可能
      Returns:
      oidで指定されるデータ

    • batchLoad

      List<Entity> batchLoad(List<EntityKey> keys, String definitionName)
      指定のEntityキー情報で特定されるデータを取得します。 取得するプロパティは、Entityに定義されているもの全てを取得します。 ReferencePropertyが定義されている場合は、 当該プロパティにはoidとnameが格納されたEntityのインスタンスが格納されます。 ReferencePropertyが指定されている場合で、そのプロパティが複数可の場合は、 当該プロパティはEntity[]の形で取得されます。
      Parameters:
      keys - Entityキー情報
      definitionName - Entity定義名
      Returns:
      キー情報で指定されるデータ

    • batchLoad

      List<Entity> batchLoad(List<EntityKey> keys, String definitionName, LoadOption option)
      指定のEntityキー情報で特定されるデータを取得します。 取得するプロパティは、optionにて指定されたものです。
      Parameters:
      keys - Entityキー情報
      definitionName - Entity定義名
      option - 読込オプション、読み込むプロパティを指定可能
      Returns:
      キー情報で指定されるデータ

    • insert

      String insert(Entity entity)
      指定の引数のentityを追加します。 entityにoid（オブジェクトID）が設定されていても必ず新しいIDで採番されます。
      Parameters:
      entity - 追加対象のデータ
      Returns:
      オブジェクトID

    • insert

      String insert(Entity entity, InsertOption option)
      指定の引数のentityを追加します。
      Parameters:
      entity - 追加対象のデータ
      追加時の追加方法に関する指定 -
      Returns:
      オブジェクトID

    • update

      void update(Entity entity, UpdateOption option)
      引数のentityを更新します。
      Parameters:
      entity - 更新対象のデータ
      option - 更新時の更新方法に関する指定
      Throws:
      EntityConcurrentUpdateException - 更新対象のデータが存在しない場合、同時更新が発生した場合

    • delete

      void delete(Entity entity, DeleteOption option)
      引数のentityに設定されたoid（オブジェクトID）で一意に特定されるデータを削除します。
      Parameters:
      entity - 削除対象のデータ
      option - 削除時に削除方法に関する指定
      Throws:
      EntityConcurrentUpdateException - 削除対象のデータが存在しない場合、同時更新が発生した場合

    • updateAll

      int updateAll(UpdateCondition cond)
      引数のcondに一致するデータを設定された値にて一括更新します。 タイムスタンプチェックなどは行いません。 別のデータ（親オブジェクトなど）で一貫性を保障した上での、ステータス情報の一括更新等の用途を想定しています。 ReferencePropertyの更新は不可です。 updateAllでは、Entityの更新イベントは発生しません。
      Parameters:
      cond - 更新対象のデータを指定する条件
      Returns:
      更新件数

    • deleteAll

      int deleteAll(DeleteCondition cond)
      引数のcondに一致するデータを一括で削除します。 タイムスタンプチェックなどは行いません。 別のデータ（親オブジェクトなど）で一貫性を保障した上での、一括削除操作を想定しています。 deleteAllでは、Entityの削除イベントは発生しません。
      Parameters:
      cond - 削除対象のデータを指定する条件
      Returns:
      削除件数

    • bulkUpdate

      void bulkUpdate(BulkUpdatable bulkUpdatable)
      bulkUpdatableで指定される一連のEntityを一括で更新（Insert/Update/Delete）します。 更新処理の際は、EntityEventListenerの呼び出しや、Validation、タイムスタンプチェック、CascadeDelete処理などは実行されません。 外部のマスタデータの取り込み、初期データImportなどの用途での利用を想定しています。 bulkUpdatableのclose()は処理後（もしくは例外発生後）、当メソッド内で呼び出されます。
      bulkUpdate()を呼び出す実行ユーザーは当該Entityに対して登録、更新、削除権限を範囲条件なしに保有している必要があります。
      更新、削除時には対象とするEntityのoidを指定してください。また、バージョン管理が有効の場合はversionの値も明示的に指定する必要があります。
      注意
      Binary型、LongText型、AutoNumber型を利用している場合、bulkUpdate利用によっても高速化は望めない場合があります。
      また、BulkUpdateEntity.UpdateMethod.MERGEを利用している場合、bulkUpdate利用によっても高速化は望めない場合があります。
      Parameters:
      bulkUpdatable -

    • loadBinaryReference

      BinaryReference loadBinaryReference(long lobId)
      引数で指定されるBinaryReferenceを取得します。
      Parameters:
      lobId -
      Returns:
      BinaryReference

    • createBinaryReference

      BinaryReference createBinaryReference(String name, String type, InputStream is)
      BinaryReferenceを新規に作成します。 引数のisのデータを同時にバイナリデータとして書き込みます。
      isがnullの場合は、バイナリデータが空の状態で新規に作成されます。 書き込みは別途getOutputStream(BinaryReference)メソッドを介して、行うことが可能です。
      作成されたBinaryReferenceはまだEntityに紐付いていない状態です。 引数のisはBinaryReference作成後、当メソッド内でcloseします。
      Parameters:
      name -
      type -
      is -
      Returns:

    • createBinaryReference

      BinaryReference createBinaryReference(File file, String name, String type)
      BinaryReferenceを新規に作成します。 引数のfileのデータを同時にバイナリデータとして書き込みます。
      作成されたBinaryReferenceはまだEntityに紐付いていない状態です。
      nameが未指定の場合は、fileの名前がnameに指定されます。 typeが未指定の場合は、fileの拡張子からmimetypeが解決されます。
      Parameters:
      file -
      name -
      type -
      Returns:

    • getInputStream

      InputStream getInputStream(BinaryReference binaryReference)
      引数で指定されたBinaryReferenceのバイナリデータを取得するためのInputStreamを取得します。
      Parameters:
      binaryReference -
      Returns:

    • getOutputStream

      OutputStream getOutputStream(BinaryReference binaryReference)
      引数で指定されたBinaryReferenceのバイナリデータを書き込むためのOutputStreamを取得します。 OutputStramは利用終了したら必ずclose()してください。
      Parameters:
      binaryReference -
      Returns:

    • lockByUser

      boolean lockByUser(String oid, String definitionName)
      現在、当該メソッドを呼び出しているユーザーにて、 指定のEntityをデータをロックします。 ユーザーによるロックはunlockByUser()メソッドにて明示的に開放しない限り、 トランザクションを終了してもロックは保持されます。
      Parameters:
      oid - オブジェクトID
      definitionName - Entity定義名
      Returns:
      ロックできた場合true

    • unlockByUser

      boolean unlockByUser(String oid, String definitionName)
      ユーザーにてロックされているEntityのデータのロックを解除します。
      Parameters:
      oid - オブジェクトID
      definitionName - Entity定義名
      Returns:

    • purge

      void purge(long recycleBinId, String definitionName)
      ごみ箱から、削除します。 recycleBinIdは、ごみ箱内のデータを一意に特定するidです（oidは重複する可能性があるため）。
      purge()を呼び出す実行ユーザーは当該Entityに対して削除権限を範囲条件なしに保有している必要があります。
      Parameters:
      recycleBinId - ごみ箱内のデータを一意に特定するid
      definitionName - Entity定義名

    • restore

      Entity restore(long recycleBinId, String definitionName)
      ごみ箱から復活します。
      restore()を呼び出す実行ユーザーは当該Entityに対して削除権限を範囲条件なしに保有しているか、 もしくは自身がごみ箱に格納したEntityである必要があります。
      Parameters:
      recycleBinId - ごみ箱内のデータを一意に特定するid
      definitionName - Entity定義名

    • getRecycleBin

      void getRecycleBin(String definitionName, Predicate<Entity> callback)
      ごみ箱の中身のリストを取得します。 取得可能なものは、recycleBinId,oid,nameのみです。 recycleBinIdは、ごみ箱内のデータを一意に特定するid。（oidは重複する可能性があるため）
      Parameters:
      definitionName - Entity定義名
      callback -

    • getRecycleBin

      Entity getRecycleBin(long recycleBinId, String definitionName)
      ごみ箱の中身から、指定のrecycleBinIdで特定される1件を取得します。
      Parameters:
      recycleBinId -
      definitionName -
      Returns:

    • getCurrentTimestamp

      Timestamp getCurrentTimestamp()
      現在の時間を取得します。 取得される値は、実時間ではなく、あらかじめ設定されたシステム時間である場合もあります。
      Returns:
      現在時間（もしくは事前に設定されたプレビュー時間）

    • deepCopy

      Entity deepCopy(String oid, String definitionName)
      指定のoid（オブジェクトID）で一意に特定されるデータを取得し、参照先を含めたコピーを行います。 親子関係の参照先のエンティティはoidが新たに採番され、 通常の参照の場合、被参照ならコピー対象外になり、被参照でなければそのまま参照されます。 また制約として、変更不可の項目についてはコピー後に変更はできなくなり、 文字列以外のプロパティでユニーク指定されている場合はコピー自体ができません。
      Parameters:
      oid - オブジェクトID
      definitionName - Entity定義名
      Returns:
      コピーされたデータ

    • deepCopy

      Entity deepCopy(String oid, String definitionName, DeepCopyOption option)
      指定のoid（オブジェクトID）で一意に特定されるデータを取得し、参照先を含めたコピーを行います。 親子関係の参照先のエンティティはoidが新たに採番され、 通常の参照の場合、被参照ならコピー対象外になり、被参照でなければそのまま参照されます。 また制約として、変更不可の項目についてはコピー後に変更はできなくなり、 文字列以外のプロパティでユニーク指定されている場合はコピー自体ができません。
      Parameters:
      oid - オブジェクトID
      definitionName - Entity定義名
      option - コピー時のオプション
      Returns:
      コピーされたデータ

    • fulltextSearchEntity

      <T extends Entity> SearchResult<T> fulltextSearchEntity(String definitionName, String keyword)
      指定のワードで全文検索します。 defNameが未指定の場合は利用テナントの全エンティティに対して全文検索を実施します。
      Parameters:
      definitionName - Entity定義名
      keyword - 全文検索用キーワード
      Returns:
      検索キーワードを含むエンティティデータのリスト

    • fulltextSearchOidList

      List<String> fulltextSearchOidList(String definitionName, String keyword)
      指定のワードで全文検索し、oidのリストを取得します。 definitionName、keywordは必須。未指定の場合は空のリストを返却します。
      Parameters:
      definitionName - Entity定義名
      keyword - 全文検索用キーワード
      Returns:
      検索キーワードを含むエンティティデータのoidのリスト

    • fulltextSearchOidList

      Map<String,List<String>> fulltextSearchOidList(List<String> definitionNames, String keyword)
      指定のワードで全文検索し、対象Entity毎のoidリストのMapを取得します。 definitionNames、keywordは必須。未指定の場合は空のMapを返却します。
      Parameters:
      definitionNames - Entity定義名のリスト
      keyword - 全文検索用キーワード
      Returns:
      検索キーワードを含むエンティティデータのoidリストのMap

    • fulltextSearchEntity

      <T extends Entity> SearchResult<T> fulltextSearchEntity(Map<String,List<String>> entityProperties, String keyword)
      指定のワードで全文検索し、指定プロパティのみを取得します。 entityPropertiesが未指定の場合は利用テナントの全エンティティに対して全文検索を実施します。
      Parameters:
      entityProperties - Entity定義毎に取得するプロパティ
      keyword - 全文検索用キーワード
      Returns:
      検索キーワードを含むエンティティデータのリスト

    • fulltextSearchEntity

      <T extends Entity> SearchResult<T> fulltextSearchEntity(Query query, String keyword, SearchOption option)
      クエリ実行結果に対して、指定のワードで全文検索します。 
      メモリを大量消費する恐れがありますので、絞り込む条件とリミット条件を指定した上でご利用してください。
      Parameters:
      keyword - 全文検索用キーワード
      Query - クエリ、Entity.OIDを検索項目として設定する必要が有ります。 
      Entity.OIDを指定しないと、空のリストが返されます。
      Returns:
      SearchOption 検索時のオプション、countTotal=trueの場合総件数を積み上げる

    • fulltextSearchEntity

      <T extends Entity> SearchResult<T> fulltextSearchEntity(String keyword, FulltextSearchOption option)
      指定のワードで全文検索し、指定プロパティのみを取得します。 FulltextSearchOptionのconditionsが未指定の場合は利用テナントの全エンティティに対して全文検索を実施します。
      Parameters:
      keyword - 全文検索用キーワード
      option - 全文検索時のオプション
      Returns:
      検索キーワードを含むエンティティデータのリスト