MediaWiki  1.33.0
Public Member Functions | Static Public Member Functions | Private Member Functions | Static Private Member Functions | Private Attributes | List of all members
Wikimedia\Rdbms\DatabaseDomain Class Reference

Class to handle database/prefix specification for IDatabase domains. More...

Collaboration diagram for Wikimedia\Rdbms\DatabaseDomain:
Collaboration graph
[legend]

Public Member Functions

 __construct ( $database, $schema, $prefix)
 
 __toString ()
 
 equals ( $other)
 
 getDatabase ()
 
 getId ()
 
 getSchema ()
 
 getTablePrefix ()
 
 isCompatible ( $other)
 Check whether the domain $other meets the specifications of this domain. More...
 
 isUnspecified ()
 

Static Public Member Functions

static newFromId ( $domain)
 
static newUnspecified ()
 

Private Member Functions

 convertToString ()
 

Static Private Member Functions

static decode ( $encoded)
 
static encode ( $decoded)
 

Private Attributes

string null $database
 
string $equivalentString
 Cache of convertToString() More...
 
string $prefix
 
string null $schema
 

Detailed Description

Class to handle database/prefix specification for IDatabase domains.

Definition at line 28 of file DatabaseDomain.php.

Constructor & Destructor Documentation

◆ __construct()

Wikimedia\Rdbms\DatabaseDomain::__construct (   $database,
  $schema,
  $prefix 
)
Parameters
string | null$databaseDatabase name
string | null$schemaSchema name
string$prefixTable prefix

Definition at line 44 of file DatabaseDomain.php.

References Wikimedia\Rdbms\DatabaseDomain\$database, Wikimedia\Rdbms\DatabaseDomain\$prefix, and Wikimedia\Rdbms\DatabaseDomain\$schema.

Member Function Documentation

◆ __toString()

Wikimedia\Rdbms\DatabaseDomain::__toString ( )
Returns
string

Definition at line 257 of file DatabaseDomain.php.

References Wikimedia\Rdbms\DatabaseDomain\getId().

◆ convertToString()

Wikimedia\Rdbms\DatabaseDomain::convertToString ( )
private
Returns
string

Definition at line 194 of file DatabaseDomain.php.

References Wikimedia\Rdbms\DatabaseDomain\$prefix, Wikimedia\Rdbms\DatabaseDomain\$schema, and string.

Referenced by Wikimedia\Rdbms\DatabaseDomain\getId().

◆ decode()

static Wikimedia\Rdbms\DatabaseDomain::decode (   $encoded)
staticprivate

Definition at line 229 of file DatabaseDomain.php.

◆ encode()

static Wikimedia\Rdbms\DatabaseDomain::encode (   $decoded)
staticprivate

Definition at line 211 of file DatabaseDomain.php.

◆ equals()

Wikimedia\Rdbms\DatabaseDomain::equals (   $other)
Parameters
DatabaseDomain | string$other
Returns
bool Whether the domain instances are the same by value

Definition at line 109 of file DatabaseDomain.php.

References Wikimedia\Rdbms\DatabaseDomain\getId().

◆ getDatabase()

Wikimedia\Rdbms\DatabaseDomain::getDatabase ( )
Returns
string|null Database name

Definition at line 162 of file DatabaseDomain.php.

References Wikimedia\Rdbms\DatabaseDomain\$database.

Referenced by Wikimedia\Rdbms\DatabasePostgres\doSelectDomain(), Wikimedia\Rdbms\DatabaseMysqlBase\doSelectDomain(), DatabaseOracle\doSelectDomain(), Wikimedia\Rdbms\DatabaseMssql\doSelectDomain(), Wikimedia\Rdbms\LoadBalancer\reallyOpenConnection(), and Wikimedia\Rdbms\LoadBalancer\setLocalDomain().

◆ getId()

Wikimedia\Rdbms\DatabaseDomain::getId ( )
Returns
string

Definition at line 183 of file DatabaseDomain.php.

References Wikimedia\Rdbms\DatabaseDomain\$equivalentString, and Wikimedia\Rdbms\DatabaseDomain\convertToString().

Referenced by Wikimedia\Rdbms\DatabaseDomain\__toString(), Wikimedia\Rdbms\DatabaseDomain\equals(), and Wikimedia\Rdbms\DBConnRef\getDomainID().

◆ getSchema()

Wikimedia\Rdbms\DatabaseDomain::getSchema ( )
Returns
string|null Database schema

Definition at line 169 of file DatabaseDomain.php.

References Wikimedia\Rdbms\DatabaseDomain\$schema.

Referenced by Wikimedia\Rdbms\DatabasePostgres\doSelectDomain(), Wikimedia\Rdbms\DatabaseMysqlBase\doSelectDomain(), DatabaseOracle\doSelectDomain(), Wikimedia\Rdbms\DatabaseMssql\doSelectDomain(), and Wikimedia\Rdbms\LoadBalancer\reallyOpenConnection().

◆ getTablePrefix()

Wikimedia\Rdbms\DatabaseDomain::getTablePrefix ( )
Returns
string Table prefix

Definition at line 176 of file DatabaseDomain.php.

References Wikimedia\Rdbms\DatabaseDomain\$prefix.

Referenced by Wikimedia\Rdbms\DatabasePostgres\doSelectDomain(), Wikimedia\Rdbms\DatabaseMysqlBase\doSelectDomain(), and Wikimedia\Rdbms\LoadBalancer\reallyOpenConnection().

◆ isCompatible()

Wikimedia\Rdbms\DatabaseDomain::isCompatible (   $other)

Check whether the domain $other meets the specifications of this domain.

If this instance has a null database specifier, then $other can have any database specifier, including null. This is likewise true if the schema specifier is null. This is not transitive like equals() since a domain that explicitly wants a certain database or schema cannot be satisfied by one of another (nor null). If the prefix is empty and the DB and schema are both null, then the entire domain is considered unspecified, and any prefix of $other is considered compatible.

Parameters
DatabaseDomain | string$other
Returns
bool
Since
1.32

Definition at line 135 of file DatabaseDomain.php.

References Wikimedia\Rdbms\DatabaseDomain\isUnspecified(), and Wikimedia\Rdbms\DatabaseDomain\newFromId().

◆ isUnspecified()

Wikimedia\Rdbms\DatabaseDomain::isUnspecified ( )
Returns
bool
Since
1.32

Definition at line 153 of file DatabaseDomain.php.

Referenced by Wikimedia\Rdbms\DatabaseDomain\isCompatible().

◆ newFromId()

static Wikimedia\Rdbms\DatabaseDomain::newFromId (   $domain)
static
Parameters
DatabaseDomain | string$domainResult of DatabaseDomain::toString()
Returns
DatabaseDomain

Definition at line 67 of file DatabaseDomain.php.

References Wikimedia\Rdbms\DatabaseDomain\$database, Wikimedia\Rdbms\DatabaseDomain\$prefix, Wikimedia\Rdbms\DatabaseDomain\$schema, captcha-old\count, and list.

Referenced by Wikimedia\Rdbms\LBFactory\__construct(), Wikimedia\Rdbms\LoadBalancer\__construct(), Wikimedia\Rdbms\DBConnRef\dbSchema(), Wikimedia\Rdbms\DBConnRef\getDBname(), Wikimedia\Rdbms\LBFactoryMulti\getDBNameAndPrefix(), Wikimedia\Rdbms\DatabaseDomain\isCompatible(), Wikimedia\Rdbms\LoadBalancer\openForeignConnection(), Wikimedia\Rdbms\LBFactory\redefineLocalDomain(), Wikimedia\Rdbms\LoadBalancer\redefineLocalDomain(), Wikimedia\Rdbms\Database\selectDomain(), and Wikimedia\Rdbms\DBConnRef\tablePrefix().

◆ newUnspecified()

static Wikimedia\Rdbms\DatabaseDomain::newUnspecified ( )
static
Returns
DatabaseDomain

Definition at line 101 of file DatabaseDomain.php.

Referenced by Wikimedia\Rdbms\LBFactory\__construct(), and Wikimedia\Rdbms\LoadBalancer\__construct().

Member Data Documentation

◆ $database

string null Wikimedia\Rdbms\DatabaseDomain::$database
private

Definition at line 30 of file DatabaseDomain.php.

Referenced by Wikimedia\Rdbms\DatabaseDomain\__construct(), Wikimedia\Rdbms\DatabaseDomain\getDatabase(), and Wikimedia\Rdbms\DatabaseDomain\newFromId().

◆ $equivalentString

string Wikimedia\Rdbms\DatabaseDomain::$equivalentString
private

Cache of convertToString()

Definition at line 37 of file DatabaseDomain.php.

Referenced by Wikimedia\Rdbms\DatabaseDomain\getId().

◆ $prefix

string Wikimedia\Rdbms\DatabaseDomain::$prefix
private

Definition at line 34 of file DatabaseDomain.php.

Referenced by Wikimedia\Rdbms\DatabaseDomain\__construct(), Wikimedia\Rdbms\DatabaseDomain\convertToString(), Wikimedia\Rdbms\DatabaseDomain\getTablePrefix(), and Wikimedia\Rdbms\DatabaseDomain\newFromId().

◆ $schema

string null Wikimedia\Rdbms\DatabaseDomain::$schema
private

Definition at line 32 of file DatabaseDomain.php.

Referenced by Wikimedia\Rdbms\DatabaseDomain\__construct(), Wikimedia\Rdbms\DatabaseDomain\convertToString(), Wikimedia\Rdbms\DatabaseDomain\getSchema(), and Wikimedia\Rdbms\DatabaseDomain\newFromId().

The documentation for this class was generated from the following file: