ManyToOneHelper::addTable

public ManyToOneHelper::addTable($join = NULL, $alias = NULL)

public function addTable($join = NULL, $alias = NULL) {
  // This is used for lookups in the many_to_one table.
  $field = $this->handler->relationship . '_' . $this->handler->table . '.' . $this->handler->field;

  if (empty($join)) {
    $join = $this->getJoin();
  }

  // See if there's a chain between us and the base relationship. If so, we need
  // to create a new relationship to use.
  $relationship = $this->handler->relationship;

  // Determine the primary table to seek
  if (empty($this->handler->query->relationships[$relationship])) {
    $base_table = $this->handler->view->storage->get('base_table');
  }
  else {
    $base_table = $this->handler->query->relationships[$relationship]['base'];
  }

  // Cycle through the joins. This isn't as error-safe as the normal
  // ensurePath logic. Perhaps it should be.
  $r_join = clone $join;
  while ($r_join->leftTable != $base_table) {
    $r_join = HandlerBase::getTableJoin($r_join->leftTable, $base_table);
  }
  // If we found that there are tables in between, add the relationship.
  if ($r_join->table != $join->table) {
    $relationship = $this->handler->query->addRelationship($this->handler->table . '_' . $r_join->table, $r_join, $r_join->table, $this->handler->relationship);
  }

  // And now add our table, using the new relationship if one was used.
  $alias = $this->handler->query->addTable($this->handler->table, $relationship, $join, $alias);

  // Store what values are used by this table chain so that other chains can
  // automatically discard those values.
  if (empty($this->handler->view->many_to_one_tables[$field])) {
    $this->handler->view->many_to_one_tables[$field] = $this->handler->value;
  }
  else {
    $this->handler->view->many_to_one_tables[$field] = array_merge($this->handler->view->many_to_one_tables[$field], $this->handler->value);
  }

  return $alias;
}