io.ebean.ProfileLocation Maven / Gradle / Ivy

Go to download

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

ebean api

There is a newer version: 15.8.0

package io.ebean;

/**
 * A location for profiling transactions and queries.
 * 
 * Typically represents a class method in the form of class file and line of code that started
 * the transaction or invoked the query.
 * 
 */
public interface ProfileLocation {

  /**
   * Create and return a new ProfileLocation.
   */
  static ProfileLocation create() {
    return XBootstrapService.profileLocationFactory().create();
  }

  /**
   * Create and return a new ProfileLocation with line number.
   */
  static ProfileLocation createWithLine() {
    return XBootstrapService.profileLocationFactory().createWithLine();
  }

  /**
   * Create and return a new ProfileLocation with a given lineNumber and label.
   */
  static ProfileLocation create(String label) {
    return XBootstrapService.profileLocationFactory().create(label);
  }

  /**
   * Obtain the description returning true if this is the initial call.
   */
  boolean obtain();

  /**
   * Return a short version of the location description.
   */
  String location();

  /**
   * Return the short label.
   */
  String label();

  /**
   * Return the full location.
   */
  String fullLocation();

  /**
   * Add execution time.
   */
  void add(long executionTime);

  /**
   * Return true if this request should be traced.
   */
  boolean trace();

  /**
   * Set the number of times to trace the transactions for this profile location.
   */
  void setTraceCount(int traceCount);
}