*
* @file
* @ingroup Database
- * @author Aaron Schulz
*/
namespace Wikimedia\Rdbms;
-use DBError;
-use DBAccessError;
-use DBTransactionError;
-use DBExpectedError;
use Exception;
use InvalidArgumentException;
* Return the server info structure for a given index, or false if the index is invalid.
* @param int $i
* @return array|bool
+ *
+ * @deprecated Since 1.30, no alternative
*/
public function getServerInfo( $i );
* is created if it doesn't exist
* @param int $i
* @param array $serverInfo
+ *
+ * @deprecated Since 1.30, construct new object
*/
public function setServerInfo( $i, array $serverInfo );
/**
* @note This method will trigger a DB connection if not yet done
* @param string|bool $domain Domain ID, or false for the current domain
- * @return bool Whether the generic connection for reads is highly "lagged"
+ * @return bool Whether the database for generic connections this request is highly "lagged"
*/
public function getLaggedReplicaMode( $domain = false );
/**
+ * Checks whether the database for generic connections this request was both:
+ * - a) Already choosen due to a prior connection attempt
+ * - b) Considered highly "lagged"
+ *
* @note This method will never cause a new DB connection
- * @return bool Whether any generic connection used for reads was highly "lagged"
+ * @return bool
*/
public function laggedReplicaUsed();