AtomicSectionUpdate.php

Go to the documentation of this file.

<?php
 
use Wikimedia\Rdbms\IDatabase;
 
class AtomicSectionUpdate implements DeferrableUpdate, DeferrableCallback {
    private $dbw;
    private $fname;
    private $callback;
 
    public function __construct( IDatabase $dbw, $fname, callable $callback, array $conns = [] ) {
        $this->dbw = $dbw;
        $this->fname = $fname;
        $this->callback = $callback;
        // Register DB connections for which uncommitted changes are related to this update
        $conns[] = $dbw;
        foreach ( $conns as $conn ) {
            if ( $conn->trxLevel() ) {
                $conn->onTransactionResolution( [ $this, 'cancelOnRollback' ], $fname );
            }
        }
    }
 
    public function doUpdate() {
        if ( $this->callback ) {
            $this->dbw->doAtomicSection( $this->fname, $this->callback );
        }
    }
 
    public function cancelOnRollback( $trigger ) {
        if ( $trigger === IDatabase::TRIGGER_ROLLBACK ) {
            $this->callback = null;
        }
    }
 
    public function getOrigin() {
        return $this->fname;
    }
}