ensurePath example

  public function addTable($table, $relationship = NULL, JoinPluginBase $join = NULL, $alias = NULL) {
    if (!$this->ensurePath($table, $relationship, $join)) {
      return FALSE;
    }

    if ($join && $relationship) {
      $join = $this->adjustJoin($join, $relationship);
    }

    return $this->queueTable($table, $relationship, $join, $alias);
  }

  /** * Add a table to the query without ensuring the path. * * This is a pretty internal function to Views and addTable() or * ensureTable() should be used instead of this one, unless you are * absolutely sure this is what you want. * * @param $table * The name of the table to add. It needs to exist in the global table * array. * @param $relationship * The primary table alias this table is related to. If not set, the * primary table will be used. * @param \Drupal\views\Plugin\views\join\JoinPluginBase $join * In some join configurations this table may actually join back through * a different method; this is most likely to be used when tracing * a hierarchy path. (node->parent->parent2->parent3). This parameter * will specify how this table joins if it is not the default. * @param $alias * A specific alias to use, rather than the default alias. * * @return string * The alias of the table; this alias can be used to access information * about the table and should always be used to refer to the table when * adding parts to the query. Or FALSE if the table was not able to be * added. */