Merge pull request #513 from wmde/labelsprovider

Introduce provider interfaces for labels, descriptions and aliases

Author: addshore

RELEASE-NOTES.md

@@ -4,6 +4,7 @@
 
 * Added `StatementFilter` and `ReferencedStatementFilter`
 * Added `StatementList::filter`
+* Added `LabelsProvider`, `DescriptionsProvider` and `AliasesProvider`
 
 ## Version 4.0 (2015-07-28)
 

src/Term/AliasesProvider.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Wikibase\DataModel\Term;
+
+/**
+ * @since 4.1
+ *
+ * @licence GNU GPL v2+
+ * @author Bene* < benestar.wikimedia@gmail.com >
+ */
+interface AliasesProvider {
+
+	/**
+	 * It is not guaranteed that this method returns the original object.
+	 *
+	 * @return AliasGroupList
+	 */
+	public function getAliasGroups();
+
+}

src/Term/DescriptionsProvider.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Wikibase\DataModel\Term;
+
+/**
+ * @since 4.1
+ *
+ * @licence GNU GPL v2+
+ * @author Bene* < benestar.wikimedia@gmail.com >
+ */
+interface DescriptionsProvider {
+
+	/**
+	 * It is not guaranteed that this method returns the original object.
+	 *
+	 * @return TermList
+	 */
+	public function getDescriptions();
+
+}

src/Term/Fingerprint.php

@@ -13,7 +13,7 @@
  * @author Jeroen De Dauw < jeroendedauw@gmail.com >
  * @author Thiemo Mättig
  */
-class Fingerprint implements Comparable {
+class Fingerprint implements Comparable, LabelsProvider, DescriptionsProvider, AliasesProvider {
 
 	/**
 	 * @deprecated since 2.5, use new Fingerprint() instead.

src/Term/LabelsProvider.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Wikibase\DataModel\Term;
+
+/**
+ * @since 4.1
+ *
+ * @licence GNU GPL v2+
+ * @author Bene* < benestar.wikimedia@gmail.com >
+ */
+interface LabelsProvider {
+
+	/**
+	 * It is not guaranteed that this method returns the original object.
+	 *
+	 * @return TermList
+	 */
+	public function getLabels();
+
+}