Merge "Fix doxygen warnings for missing commands"
[lhc/web/wiklou.git] / tests / phpunit / includes / db / ORMTableTest.php
1 <?php
2 /**
3 * Abstract class to construct tests for ORMTable deriving classes.
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
9 *
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
14 *
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
19 *
20 * @file
21 * @since 1.21
22 *
23 * @ingroup Test
24 *
25 * @group ORM
26 * @group Database
27 *
28 * @covers PageORMTableForTesting
29 *
30 * @author Jeroen De Dauw < jeroendedauw@gmail.com >
31 * @author Daniel Kinzler
32 */
33
34 class ORMTableTest extends MediaWikiTestCase {
35
36 /**
37 * @since 1.21
38 * @return string
39 */
40 protected function getTableClass() {
41 return 'PageORMTableForTesting';
42 }
43
44 /**
45 * @since 1.21
46 * @return IORMTable
47 */
48 public function getTable() {
49 $class = $this->getTableClass();
50
51 return $class::singleton();
52 }
53
54 /**
55 * @since 1.21
56 * @return string
57 */
58 public function getRowClass() {
59 return $this->getTable()->getRowClass();
60 }
61
62 /**
63 * @since 1.21
64 */
65 public function testSingleton() {
66 $class = $this->getTableClass();
67
68 $this->assertInstanceOf( $class, $class::singleton() );
69 $this->assertTrue( $class::singleton() === $class::singleton() );
70 }
71 }
72
73 /**
74 * Dummy ORM table for testing, reading Title objects from the page table.
75 *
76 * @since 1.21
77 */
78
79 class PageORMTableForTesting extends ORMTable {
80
81 public function __construct() {
82 $this->fieldPrefix = 'page_';
83 }
84
85 /**
86 * @see ORMTable::getName
87 *
88 * @return string
89 */
90 public function getName() {
91 return 'page';
92 }
93
94 /**
95 * @see ORMTable::getRowClass
96 *
97 * @return string
98 */
99 public function getRowClass() {
100 return 'Title';
101 }
102
103 /**
104 * @see ORMTable::newRow
105 *
106 * @return IORMRow
107 */
108 public function newRow( array $data, $loadDefaults = false ) {
109 return Title::makeTitle( $data['namespace'], $data['title'] );
110 }
111
112 /**
113 * @see ORMTable::getFields
114 *
115 * @return array
116 */
117 public function getFields() {
118 return array(
119 'id' => 'int',
120 'namespace' => 'int',
121 'title' => 'str',
122 );
123 }
124 }