includes/libs/rdbms/database/MaintainableDBConnRef.php

   1 <?php
   2
   3 namespace Wikimedia\Rdbms;
   4
   5 /**
   6  * Helper class to handle automatically marking connections as reusable (via RAII pattern)
   7  * as well handling deferring the actual network connection until the handle is used
   8  *
   9  * @note: proxy methods are defined explicity to avoid interface errors
  10  * @ingroup Database
  11  * @since 1.29
  12  */
  13 class MaintainableDBConnRef extends DBConnRef implements IMaintainableDatabase {
  14         public function tableName( $name, $format = 'quoted' ) {
  15                 return $this->__call( __FUNCTION__, func_get_args() );
  16         }
  17
  18         public function tableNames() {
  19                 return $this->__call( __FUNCTION__, func_get_args() );
  20         }
  21
  22         public function tableNamesN() {
  23                 return $this->__call( __FUNCTION__, func_get_args() );
  24         }
  25
  26         public function sourceFile(
  27                 $filename,
  28                 callable $lineCallback = null,
  29                 callable $resultCallback = null,
  30                 $fname = false,
  31                 callable $inputCallback = null
  32         ) {
  33                 $this->assertRoleAllowsWrites();
  34
  35                 return $this->__call( __FUNCTION__, func_get_args() );
  36         }
  37
  38         public function sourceStream(
  39                 $fp,
  40                 callable $lineCallback = null,
  41                 callable $resultCallback = null,
  42                 $fname = __METHOD__,
  43                 callable $inputCallback = null
  44         ) {
  45                 $this->assertRoleAllowsWrites();
  46
  47                 return $this->__call( __FUNCTION__, func_get_args() );
  48         }
  49
  50         public function dropTable( $tableName, $fName = __METHOD__ ) {
  51                 $this->assertRoleAllowsWrites();
  52
  53                 return $this->__call( __FUNCTION__, func_get_args() );
  54         }
  55
  56         public function deadlockLoop() {
  57                 $this->assertRoleAllowsWrites();
  58
  59                 return $this->__call( __FUNCTION__, func_get_args() );
  60         }
  61
  62         public function listViews( $prefix = null, $fname = __METHOD__ ) {
  63                 return $this->__call( __FUNCTION__, func_get_args() );
  64         }
  65
  66         public function textFieldSize( $table, $field ) {
  67                 return $this->__call( __FUNCTION__, func_get_args() );
  68         }
  69
  70         public function streamStatementEnd( &$sql, &$newLine ) {
  71                 return $this->__call( __FUNCTION__, func_get_args() );
  72         }
  73
  74         public function duplicateTableStructure(
  75                 $oldName, $newName, $temporary = false, $fname = __METHOD__
  76         ) {
  77                 $this->assertRoleAllowsWrites();
  78
  79                 return $this->__call( __FUNCTION__, func_get_args() );
  80         }
  81
  82         public function tableLocksHaveTransactionScope() {
  83                 return $this->__call( __FUNCTION__, func_get_args() );
  84         }
  85
  86         public function lockTables( array $read, array $write, $method ) {
  87                 $this->assertRoleAllowsWrites();
  88
  89                 return $this->__call( __FUNCTION__, func_get_args() );
  90         }
  91
  92         public function unlockTables( $method ) {
  93                 $this->assertRoleAllowsWrites();
  94
  95                 return $this->__call( __FUNCTION__, func_get_args() );
  96         }
  97
  98         public function indexUnique( $table, $index ) {
  99                 return $this->__call( __FUNCTION__, func_get_args() );
 100         }
 101
 102         public function listTables( $prefix = null, $fname = __METHOD__ ) {
 103                 return $this->__call( __FUNCTION__, func_get_args() );
 104         }
 105
 106         public function fieldInfo( $table, $field ) {
 107                 return $this->__call( __FUNCTION__, func_get_args() );
 108         }
 109 }
 110
 111 /**
 112  * @deprecated since 1.33
 113  */
 114 class_alias( MaintainableDBConnRef::class, 'MaintainableDBConnRef' );