From 1c63abcda32a91f75f066225df7fd929726caded Mon Sep 17 00:00:00 2001
From: addshore <addshorewiki@gmail.com>
Date: Tue, 26 Jan 2016 21:24:27 +0100
Subject: [PATCH] Add LinkTarget interface

To be used by things that do not care if they are
passed a Title or TitleValue so long as it has a
dbkey, namespace, possible fragment and text

Example uses include:
 LinkBatch::addObj
 MediaWikiPageLinkRenderer methods
 MediaWikiTitleCodec methods
 PageLinkRenderer methods
 TitleFormatter methods

Change-Id: I2aa1a82129bb01155924a8e6a403c7a47391432f
---
 autoload.php                  |  1 +
 includes/LinkTarget.php       | 41 +++++++++++++++++++++++++++++++++++
 includes/Title.php            |  2 +-
 includes/title/TitleValue.php |  2 +-
 4 files changed, 44 insertions(+), 2 deletions(-)
 create mode 100644 includes/LinkTarget.php

diff --git a/autoload.php b/autoload.php
index 24a4d72c82..11dc7e1c14 100644
--- a/autoload.php
+++ b/autoload.php
@@ -560,6 +560,7 @@ $wgAutoloadLocalClasses = array(
 	'IPSet' => __DIR__ . '/includes/compat/IPSetCompat.php',
 	'IPTC' => __DIR__ . '/includes/media/IPTC.php',
 	'IRCColourfulRCFeedFormatter' => __DIR__ . '/includes/rcfeed/IRCColourfulRCFeedFormatter.php',
+	'LinkTarget' => __DIR__ . '/includes/LinkTarget.php',
 	'IcuCollation' => __DIR__ . '/includes/Collation.php',
 	'IdentityCollation' => __DIR__ . '/includes/Collation.php',
 	'ImageBuilder' => __DIR__ . '/maintenance/rebuildImages.php',
diff --git a/includes/LinkTarget.php b/includes/LinkTarget.php
new file mode 100644
index 0000000000..1ce5f32339
--- /dev/null
+++ b/includes/LinkTarget.php
@@ -0,0 +1,41 @@
+<?php
+
+/**
+ * @author Addshore
+ *
+ * @since 1.27
+ */
+interface LinkTarget {
+
+	/**
+	 * Get the namespace index
+	 *
+	 * @return int Namespace index
+	 */
+	public function getNamespace();
+
+	/**
+	 * Get the link fragment (i.e.\ the bit after the #) in text form
+	 *
+	 * @return string link fragment
+	 */
+	public function getFragment();
+
+	/**
+	 * Get the main part with underscores
+	 *
+	 * @return string Main part of the link, with underscores (for use in hrf attributes)
+	 */
+	public function getDBkey();
+
+	/**
+	 * Returns the link in text form,
+	 * without namespace prefix or fragment.
+	 *
+	 * This is computed from the DB key by replacing any underscores with spaces.
+	 *
+	 * @return string
+	 */
+	public function getText();
+
+}
diff --git a/includes/Title.php b/includes/Title.php
index e549037fac..f2a33e2ecc 100644
--- a/includes/Title.php
+++ b/includes/Title.php
@@ -30,7 +30,7 @@
  * @note Consider using a TitleValue object instead. TitleValue is more lightweight
  *       and does not rely on global state or the database.
  */
-class Title {
+class Title implements LinkTarget {
 	/** @var HashBagOStuff */
 	static private $titleCache = null;
 
diff --git a/includes/title/TitleValue.php b/includes/title/TitleValue.php
index a0f3b6f9b2..c8ebc2ada1 100644
--- a/includes/title/TitleValue.php
+++ b/includes/title/TitleValue.php
@@ -35,7 +35,7 @@ use Wikimedia\Assert\Assert;
  * @see https://www.mediawiki.org/wiki/Requests_for_comment/TitleValue
  * @since 1.23
  */
-class TitleValue {
+class TitleValue implements LinkTarget {
 	/**
 	 * @var int
 	 */
-- 
2.20.1