io.ebeaninternal.api.SpiUpdatePlan Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of ebean-core Show documentation

ebean core module

There is a newer version: 15.8.0

package io.ebeaninternal.api;

import io.ebean.bean.EntityBean;
import io.ebeaninternal.server.persist.dml.DmlHandler;
import io.ebeaninternal.server.persist.dmlbind.Bindable;

import java.sql.SQLException;

/**
 * A plan for executing bean updates for a given set of changed properties.
 * 
 * This is a cachable plan with the purpose of being being able to skip some
 * phases of the update bean processing.
 * 
 * 
 * The plans are cached by the BeanDescriptors.
 * 
 */
public interface SpiUpdatePlan {

  /**
   * Return true if the set clause has no columns.
   * 

   * Can occur when the only columns updated have a updatable=false in their
   * deployment.
   * 
   */
  boolean isEmptySetClause();

  /**
   * Bind given the request and bean. The bean could be the oldValues bean
   * when binding a update or delete where clause with ALL concurrency mode.
   */
  void bindSet(DmlHandler bind, EntityBean bean) throws SQLException;

  /**
   * Return the time this plan was created.
   */
  long timeCreated();

  /**
   * Return the time this plan was last used.
   */
  long timeLastUsed();

  /**
   * Return the hash key for this plan.
   */
  String key();

  /**
   * Return the concurrency mode for this plan.
   */
  ConcurrencyMode mode();

  /**
   * Return the update SQL statement.
   */
  String sql();

  /**
   * Return the set of bindable update properties.
   */
  Bindable getSet();

}