Diviner Tech Docs LiskMigrationIterator

final class LiskMigrationIterator
Phorge Technical Documentation (Storage)

Iterate over every object of a given type, without holding all of them in memory. This is useful for performing database migrations.

$things = new LiskMigrationIterator(new LiskThing());
foreach ($things as $thing) {
  // do something
}

NOTE: This only works on objects with a normal id column.

Tasks

Methods to Implement

protected function didRewind()
protected function loadPage()

Configuration

final public function getPageSize() — Get the configured page size.
final public function setPageSize($size) — Configure the page size. Note that implementations may ignore this.

Iterator Implementation

final public function current()
public function key()
final public function next()
final public function rewind()
final public function valid()

No methods for this task.

Other Methods

public function __get($name)
public function __set($name, $value)
private function throwOnAttemptedIteration()
public function getPhobjectClassConstant($key, $byte_limit) — Read the value of a class constant.
public function __construct($object)

Methods

public function __get($name)
Inherited

This method is not documented.

Parameters

$name

Return

wild

public function __set($name, $value)
Inherited

This method is not documented.

Parameters

	$name
	$value

Return

wild

final public function current()
Inherited

This method is not documented.

Return

wild

public function key()

PhutilBufferedIterator

By default, the iterator assigns a "natural" key (0, 1, 2, ...) to each result. This method is intentionally nonfinal so you can substitute a different behavior by overriding it if you prefer.

LiskMigrationIterator

This method is not documented.

Return

scalar

Key for the current result (as per @{method:current}).

final public function next()
Inherited

This method is not documented.

Return

wild

final public function rewind()
Inherited

This method is not documented.

Return

wild

final public function valid()
Inherited

This method is not documented.

Return

wild

private function throwOnAttemptedIteration()
Inherited

This method is not documented.

Return

wild

public function getPhobjectClassConstant($key, $byte_limit)
Inherited

Phobject

Read the value of a class constant.

This is the same as just typing self::CONSTANTNAME, but throws a more useful message if the constant is not defined and allows the constant to be limited to a maximum length.

Parameters

string	$key	Name of the constant.
int\|null	$byte_limit	Maximum number of bytes permitted in the value.

Return

string

Value of the constant.

protected function didRewind()

PhutilBufferedIterator

Called when rewind() is invoked. You should reset any internal cursor your implementation holds.

LiskMigrationIterator

This method is not documented.

Return

void

protected function loadPage()

PhutilBufferedIterator

Called when the iterator needs a page of results. You should load the next result page and update your internal cursor to point past it.

If possible, you should use getPageSize() to choose a page size.

LiskMigrationIterator

This method is not documented.

Return

list<wild>

List of results.

final public function getPageSize()
Inherited

PhutilBufferedIterator

Get the configured page size.

Return

int	Page size.

final public function setPageSize($size)
Inherited

PhutilBufferedIterator

Configure the page size. Note that implementations may ignore this.

Parameters

int

$size

Page size.

Return

this

public function __construct($object)

This method is not documented.

Parameters

LiskDAO

$object

Return

this	//Implicit.//

Defined: src/infrastructure/storage/lisk/LiskMigrationIterator.php:16
Extends: PhobjectPhutilBufferedIterator

final class LiskMigrationIteratorPhorge Technical Documentation (Storage)

Tasks

Methods to Implement

Configuration

Iterator Implementation

Other Methods

Methods

public function __get($name)Inherited

public function __set($name, $value)Inherited

final public function current()Inherited

public function key()

final public function next()Inherited

final public function rewind()Inherited

final public function valid()Inherited

private function throwOnAttemptedIteration()Inherited

public function getPhobjectClassConstant($key, $byte_limit)Inherited

protected function didRewind()

protected function loadPage()

final public function getPageSize()Inherited

final public function setPageSize($size)Inherited

public function __construct($object)

final class LiskMigrationIterator
Phorge Technical Documentation (Storage)

public function __get($name)
Inherited

public function __set($name, $value)
Inherited

final public function current()
Inherited

final public function next()
Inherited

final public function rewind()
Inherited

final public function valid()
Inherited

private function throwOnAttemptedIteration()
Inherited

public function getPhobjectClassConstant($key, $byte_limit)
Inherited

final public function getPageSize()
Inherited

final public function setPageSize($size)
Inherited