Interface JoinEntityHelper<T,SB extends com.landawn.abacus.util.SQLBuilder,TD extends Dao<T,SB,TD>>

Type Parameters:
T -
SB -
TD -
All Known Subinterfaces:
CrudJoinEntityHelper<T,ID,SB,TD>, CrudJoinEntityHelperL<T,SB,TD>, ReadOnlyCrudJoinEntityHelper<T,ID,SB,TD>, ReadOnlyCrudJoinEntityHelperL<T,SB,TD>, ReadOnlyJoinEntityHelper<T,SB,TD>, UncheckedCrudJoinEntityHelper<T,ID,SB,TD>, UncheckedCrudJoinEntityHelperL<T,SB,TD>, UncheckedJoinEntityHelper<T,SB,TD>, UncheckedReadOnlyCrudJoinEntityHelper<T,ID,SB,TD>, UncheckedReadOnlyCrudJoinEntityHelperL<T,SB,TD>, UncheckedReadOnlyJoinEntityHelper<T,SB,TD>

public interface JoinEntityHelper<T,SB extends com.landawn.abacus.util.SQLBuilder,TD extends Dao<T,SB,TD>>
Author:
haiyangl
See Also:
  • ConditionFactory
  • ConditionFactory.CF
  • Method Details

    • targetEntityClass

      @Deprecated @Internal Class<T> targetEntityClass()
      Deprecated.
      internal only
      Returns:
    • targetDaoInterface

      @Deprecated @Internal Class<TD> targetDaoInterface()
      Deprecated.
      internal only
      Returns:
    • executor

      @Deprecated @Internal Executor executor()
      Deprecated.
      internal only
      Returns:
    • findFirst

      default com.landawn.abacus.util.u.Optional<T> findFirst(Collection<String> selectPropNames, Class<?> joinEntitiesToLoad, com.landawn.abacus.condition.Condition cond) throws SQLException
      Parameters:
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      joinEntitiesToLoad -
      cond -
      Returns:
      Throws:
      SQLException
    • findFirst

      default com.landawn.abacus.util.u.Optional<T> findFirst(Collection<String> selectPropNames, Collection<Class<?>> joinEntitiesToLoad, com.landawn.abacus.condition.Condition cond) throws SQLException
      Parameters:
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      joinEntitiesToLoad -
      cond -
      Returns:
      Throws:
      SQLException
    • findFirst

      default com.landawn.abacus.util.u.Optional<T> findFirst(Collection<String> selectPropNames, boolean includeAllJoinEntities, com.landawn.abacus.condition.Condition cond) throws SQLException
      Parameters:
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      includeAllJoinEntities -
      cond -
      Returns:
      Throws:
      SQLException
    • findOnlyOne

      default com.landawn.abacus.util.u.Optional<T> findOnlyOne(Collection<String> selectPropNames, Class<?> joinEntitiesToLoad, com.landawn.abacus.condition.Condition cond) throws com.landawn.abacus.exception.DuplicatedResultException, SQLException
      Parameters:
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      joinEntitiesToLoad -
      cond -
      Returns:
      Throws:
      com.landawn.abacus.exception.DuplicatedResultException - if more than one record found by the specified id (or condition).
      SQLException
    • findOnlyOne

      default com.landawn.abacus.util.u.Optional<T> findOnlyOne(Collection<String> selectPropNames, Collection<Class<?>> joinEntitiesToLoad, com.landawn.abacus.condition.Condition cond) throws com.landawn.abacus.exception.DuplicatedResultException, SQLException
      Parameters:
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      joinEntitiesToLoad -
      cond -
      Returns:
      Throws:
      com.landawn.abacus.exception.DuplicatedResultException - if more than one record found by the specified id (or condition).
      SQLException
    • findOnlyOne

      default com.landawn.abacus.util.u.Optional<T> findOnlyOne(Collection<String> selectPropNames, boolean includeAllJoinEntities, com.landawn.abacus.condition.Condition cond) throws com.landawn.abacus.exception.DuplicatedResultException, SQLException
      Parameters:
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      includeAllJoinEntities -
      cond -
      Returns:
      Throws:
      com.landawn.abacus.exception.DuplicatedResultException - if more than one record found by the specified id (or condition).
      SQLException
    • list

      @Beta default List<T> list(Collection<String> selectPropNames, Class<?> joinEntitiesToLoad, com.landawn.abacus.condition.Condition cond) throws SQLException
      Parameters:
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      joinEntitiesToLoad -
      cond -
      Returns:
      Throws:
      SQLException
    • list

      @Beta default List<T> list(Collection<String> selectPropNames, Collection<Class<?>> joinEntitiesToLoad, com.landawn.abacus.condition.Condition cond) throws SQLException
      Parameters:
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      joinEntitiesToLoad -
      cond -
      Returns:
      Throws:
      SQLException
    • list

      @Beta default List<T> list(Collection<String> selectPropNames, boolean includeAllJoinEntities, com.landawn.abacus.condition.Condition cond) throws SQLException
      Parameters:
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      includeAllJoinEntities -
      cond -
      Returns:
      Throws:
      SQLException
    • stream

      @Beta default com.landawn.abacus.util.ExceptionalStream<T,SQLException> stream(Collection<String> selectPropNames, Class<?> joinEntitiesToLoad, com.landawn.abacus.condition.Condition cond)
      Parameters:
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      joinEntitiesToLoad -
      cond -
      Returns:
    • stream

      @Beta default com.landawn.abacus.util.ExceptionalStream<T,SQLException> stream(Collection<String> selectPropNames, Collection<Class<?>> joinEntitiesToLoad, com.landawn.abacus.condition.Condition cond)
      Parameters:
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      joinEntitiesToLoad -
      cond -
      Returns:
    • stream

      @Beta default com.landawn.abacus.util.ExceptionalStream<T,SQLException> stream(Collection<String> selectPropNames, boolean includeAllJoinEntities, com.landawn.abacus.condition.Condition cond)
      Parameters:
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      includeAllJoinEntities -
      cond -
      Returns:
    • loadJoinEntities

      default void loadJoinEntities(T entity, Class<?> joinEntityClass) throws SQLException
      Parameters:
      entity -
      joinEntityClass -
      Throws:
      SQLException
    • loadJoinEntities

      default void loadJoinEntities(T entity, Class<?> joinEntityClass, Collection<String> selectPropNames) throws SQLException
      Parameters:
      entity -
      joinEntityClass -
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      Throws:
      SQLException
    • loadJoinEntities

      default void loadJoinEntities(Collection<T> entities, Class<?> joinEntityClass) throws SQLException
      Parameters:
      entities -
      joinEntityClass -
      Throws:
      SQLException
    • loadJoinEntities

      default void loadJoinEntities(Collection<T> entities, Class<?> joinEntityClass, Collection<String> selectPropNames) throws SQLException
      Parameters:
      entities -
      joinEntityClass -
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      Throws:
      SQLException
    • loadJoinEntities

      default void loadJoinEntities(T entity, String joinEntityPropName) throws SQLException
      Parameters:
      entity -
      joinEntityPropName -
      Throws:
      SQLException
    • loadJoinEntities

      void loadJoinEntities(T entity, String joinEntityPropName, Collection<String> selectPropNames) throws SQLException
      Parameters:
      entity -
      joinEntityPropName -
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      Throws:
      SQLException
    • loadJoinEntities

      default void loadJoinEntities(Collection<T> entities, String joinEntityPropName) throws SQLException
      Parameters:
      entities -
      joinEntityPropName -
      Throws:
      SQLException
    • loadJoinEntities

      void loadJoinEntities(Collection<T> entities, String joinEntityPropName, Collection<String> selectPropNames) throws SQLException
      Parameters:
      entities -
      joinEntityPropName -
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      Throws:
      SQLException
    • loadJoinEntities

      default void loadJoinEntities(T entity, Collection<String> joinEntityPropNames) throws SQLException
      Parameters:
      entity -
      joinEntityPropNames -
      Throws:
      SQLException
    • loadJoinEntities

      @Beta default void loadJoinEntities(T entity, Collection<String> joinEntityPropNames, boolean inParallel) throws SQLException
      Parameters:
      entity -
      joinEntityPropNames -
      inParallel -
      Throws:
      SQLException
    • loadJoinEntities

      @Beta default void loadJoinEntities(T entity, Collection<String> joinEntityPropNames, Executor executor) throws SQLException
      Parameters:
      entity -
      joinEntityPropNames -
      executor -
      Throws:
      SQLException
    • loadJoinEntities

      default void loadJoinEntities(Collection<T> entities, Collection<String> joinEntityPropNames) throws SQLException
      Parameters:
      entities -
      joinEntityPropName -
      Throws:
      SQLException
    • loadJoinEntities

      @Beta default void loadJoinEntities(Collection<T> entities, Collection<String> joinEntityPropNames, boolean inParallel) throws SQLException
      Parameters:
      entities -
      joinEntityPropName -
      inParallel -
      Throws:
      SQLException
    • loadJoinEntities

      @Beta default void loadJoinEntities(Collection<T> entities, Collection<String> joinEntityPropNames, Executor executor) throws SQLException
      Parameters:
      entities -
      joinEntityPropName -
      executor -
      Throws:
      SQLException
    • loadAllJoinEntities

      default void loadAllJoinEntities(T entity) throws SQLException
      Parameters:
      entity -
      Throws:
      SQLException
    • loadAllJoinEntities

      @Beta default void loadAllJoinEntities(T entity, boolean inParallel) throws SQLException
      Parameters:
      entity -
      inParallel -
      Throws:
      SQLException
    • loadAllJoinEntities

      @Beta default void loadAllJoinEntities(T entity, Executor executor) throws SQLException
      Parameters:
      entity -
      executor -
      Throws:
      SQLException
    • loadAllJoinEntities

      default void loadAllJoinEntities(Collection<T> entities) throws SQLException
      Parameters:
      entities -
      Throws:
      SQLException
    • loadAllJoinEntities

      @Beta default void loadAllJoinEntities(Collection<T> entities, boolean inParallel) throws SQLException
      Parameters:
      entities -
      inParallel -
      Throws:
      SQLException
    • loadAllJoinEntities

      @Beta default void loadAllJoinEntities(Collection<T> entities, Executor executor) throws SQLException
      Parameters:
      entities -
      executor -
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      default void loadJoinEntitiesIfNull(T entity, Class<?> joinEntityClass) throws SQLException
      Parameters:
      entity -
      joinEntityClass -
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      default void loadJoinEntitiesIfNull(T entity, Class<?> joinEntityClass, Collection<String> selectPropNames) throws SQLException
      Parameters:
      entity -
      joinEntityClass -
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      default void loadJoinEntitiesIfNull(Collection<T> entities, Class<?> joinEntityClass) throws SQLException
      Parameters:
      entities -
      joinEntityClass -
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      default void loadJoinEntitiesIfNull(Collection<T> entities, Class<?> joinEntityClass, Collection<String> selectPropNames) throws SQLException
      Parameters:
      entities -
      joinEntityClass -
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      default void loadJoinEntitiesIfNull(T entity, String joinEntityPropName) throws SQLException
      Parameters:
      entity -
      joinEntityPropName -
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      default void loadJoinEntitiesIfNull(T entity, String joinEntityPropName, Collection<String> selectPropNames) throws SQLException
      Parameters:
      entity - ?
      joinEntityPropName -
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      default void loadJoinEntitiesIfNull(Collection<T> entities, String joinEntityPropName) throws SQLException
      Parameters:
      entities -
      joinEntityPropName -
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      default void loadJoinEntitiesIfNull(Collection<T> entities, String joinEntityPropName, Collection<String> selectPropNames) throws SQLException
      Parameters:
      entities -
      joinEntityPropName -
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      default void loadJoinEntitiesIfNull(T entity, Collection<String> joinEntityPropNames) throws SQLException
      Parameters:
      entity -
      joinEntityPropNames -
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      @Beta default void loadJoinEntitiesIfNull(T entity, Collection<String> joinEntityPropNames, boolean inParallel) throws SQLException
      Parameters:
      entity -
      joinEntityPropNames -
      inParallel -
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      @Beta default void loadJoinEntitiesIfNull(T entity, Collection<String> joinEntityPropNames, Executor executor) throws SQLException
      Parameters:
      entity -
      joinEntityPropNames -
      executor -
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      default void loadJoinEntitiesIfNull(Collection<T> entities, Collection<String> joinEntityPropNames) throws SQLException
      Parameters:
      entities -
      joinEntityPropName -
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      @Beta default void loadJoinEntitiesIfNull(Collection<T> entities, Collection<String> joinEntityPropNames, boolean inParallel) throws SQLException
      Parameters:
      entities -
      joinEntityPropName -
      inParallel -
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      @Beta default void loadJoinEntitiesIfNull(Collection<T> entities, Collection<String> joinEntityPropNames, Executor executor) throws SQLException
      Parameters:
      entities -
      joinEntityPropName -
      executor -
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      default void loadJoinEntitiesIfNull(T entity) throws SQLException
      Parameters:
      entity -
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      @Beta default void loadJoinEntitiesIfNull(T entity, boolean inParallel) throws SQLException
      Parameters:
      entity -
      inParallel -
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      @Beta default void loadJoinEntitiesIfNull(T entity, Executor executor) throws SQLException
      Parameters:
      entity -
      executor -
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      default void loadJoinEntitiesIfNull(Collection<T> entities) throws SQLException
      Parameters:
      entities -
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      @Beta default void loadJoinEntitiesIfNull(Collection<T> entities, boolean inParallel) throws SQLException
      Parameters:
      entities -
      inParallel -
      Throws:
      SQLException
    • loadJoinEntitiesIfNull

      @Beta default void loadJoinEntitiesIfNull(Collection<T> entities, Executor executor) throws SQLException
      Parameters:
      entities -
      executor -
      Throws:
      SQLException
    • deleteJoinEntities

      default int deleteJoinEntities(T entity, Class<?> joinEntityClass) throws SQLException
      Parameters:
      entity -
      joinEntityClass -
      Returns:
      the total count of updated/deleted records.
      Throws:
      SQLException
    • deleteJoinEntities

      default int deleteJoinEntities(Collection<T> entities, Class<?> joinEntityClass) throws SQLException
      Parameters:
      entities -
      joinEntityClass -
      Returns:
      the total count of updated/deleted records.
      Throws:
      SQLException
    • deleteJoinEntities

      int deleteJoinEntities(T entity, String joinEntityPropName) throws SQLException
      Parameters:
      entity -
      joinEntityPropName -
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      Returns:
      the total count of updated/deleted records.
      Throws:
      SQLException
    • deleteJoinEntities

      int deleteJoinEntities(Collection<T> entities, String joinEntityPropName) throws SQLException
      Parameters:
      entities -
      joinEntityPropName -
      selectPropNames - all properties(columns) will be selected, excluding the properties of joining entities, if the specified selectPropNames is null.
      Returns:
      the total count of updated/deleted records.
      Throws:
      SQLException
    • deleteJoinEntities

      default int deleteJoinEntities(T entity, Collection<String> joinEntityPropNames) throws SQLException
      Parameters:
      entity -
      joinEntityPropNames -
      Returns:
      the total count of updated/deleted records.
      Throws:
      SQLException
    • deleteJoinEntities

      @Deprecated @Beta default int deleteJoinEntities(T entity, Collection<String> joinEntityPropNames, boolean inParallel) throws SQLException
      Deprecated.
      the operation maybe can't be finished in one transaction if isParallel is true.
      Parameters:
      entity -
      joinEntityPropNames -
      inParallel -
      Returns:
      the total count of updated/deleted records.
      Throws:
      SQLException
    • deleteJoinEntities

      @Deprecated @Beta default int deleteJoinEntities(T entity, Collection<String> joinEntityPropNames, Executor executor) throws SQLException
      Deprecated.
      the operation can't be finished in one transaction if it's executed in multiple threads.
      Parameters:
      entity -
      joinEntityPropNames -
      executor -
      Returns:
      the total count of updated/deleted records.
      Throws:
      SQLException
    • deleteJoinEntities

      default int deleteJoinEntities(Collection<T> entities, Collection<String> joinEntityPropNames) throws SQLException
      Parameters:
      entities -
      joinEntityPropName -
      Returns:
      the total count of updated/deleted records.
      Throws:
      SQLException
    • deleteJoinEntities

      @Deprecated @Beta default int deleteJoinEntities(Collection<T> entities, Collection<String> joinEntityPropNames, boolean inParallel) throws SQLException
      Deprecated.
      the operation maybe can't be finished in one transaction if isParallel is true.
      Parameters:
      entities -
      joinEntityPropName -
      inParallel -
      Returns:
      the total count of updated/deleted records.
      Throws:
      SQLException
    • deleteJoinEntities

      @Deprecated @Beta default int deleteJoinEntities(Collection<T> entities, Collection<String> joinEntityPropNames, Executor executor) throws SQLException
      Deprecated.
      the operation can't be finished in one transaction if it's executed in multiple threads.
      Parameters:
      entities -
      joinEntityPropName -
      executor -
      Returns:
      the total count of updated/deleted records.
      Throws:
      SQLException
    • deleteAllJoinEntities

      default int deleteAllJoinEntities(T entity) throws SQLException
      Parameters:
      entity -
      Returns:
      the total count of updated/deleted records.
      Throws:
      SQLException
    • deleteAllJoinEntities

      @Deprecated @Beta default int deleteAllJoinEntities(T entity, boolean inParallel) throws SQLException
      Deprecated.
      the operation maybe can't be finished in one transaction if isParallel is true.
      Parameters:
      entity -
      inParallel -
      Returns:
      the total count of updated/deleted records.
      Throws:
      SQLException
    • deleteAllJoinEntities

      @Deprecated @Beta default int deleteAllJoinEntities(T entity, Executor executor) throws SQLException
      Deprecated.
      the operation can't be finished in one transaction if it's executed in multiple threads.
      Parameters:
      entity -
      executor -
      Returns:
      the total count of updated/deleted records.
      Throws:
      SQLException
    • deleteAllJoinEntities

      default int deleteAllJoinEntities(Collection<T> entities) throws SQLException
      Parameters:
      entities -
      Returns:
      the total count of updated/deleted records.
      Throws:
      SQLException
    • deleteAllJoinEntities

      @Deprecated @Beta default int deleteAllJoinEntities(Collection<T> entities, boolean inParallel) throws SQLException
      Deprecated.
      the operation maybe can't be finished in one transaction if isParallel is true.
      Parameters:
      entities -
      inParallel -
      Returns:
      the total count of updated/deleted records.
      Throws:
      SQLException
    • deleteAllJoinEntities

      @Deprecated @Beta default int deleteAllJoinEntities(Collection<T> entities, Executor executor) throws SQLException
      Deprecated.
      the operation can't be finished in one transaction if it's executed in multiple threads.
      Parameters:
      entities -
      executor -
      Returns:
      the total count of updated/deleted records.
      Throws:
      SQLException