*
* @file
* @ingroup Database
- * @author Aaron Schulz
*/
namespace Wikimedia\Rdbms;
* If a DB_REPLICA connection has been opened already, then wait immediately.
* Otherwise sets a variable telling it to wait if such a connection is opened.
*
+ * This only applies to connections to the generic replica DB for this request.
+ * If a timeout happens when waiting, then getLaggedReplicaMode()/laggedReplicaUsed()
+ * will return true.
+ *
* @param DBMasterPos|bool $pos Master position or false
*/
public function waitFor( $pos );
* 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();