Add Room typeahead for Conpherence Search

Summary: Ref T3165. Builds an ngram table for Conpherence Room titles, allowing a tokenizer for searching a subset of rooms.

Test Plan: Say `Gabbert` in two different rooms, search all, see two rooms returned. Search specific room, see specific result.

Reviewers: epriestley

Reviewed By: epriestley

Subscribers: Korvin

Maniphest Tasks: T3165

Differential Revision: https://secure.phabricator.com/D16692

resources/sql/autopatches/20161011.conpherence.ngrams.php

···
+<?php
+
+$table = new ConpherenceThread();
+
+foreach (new LiskMigrationIterator($table) as $thread) {
+  PhabricatorSearchWorker::queueDocumentForIndexing(
+    $thread->getPHID(),
+    array(
+      'force' => true,
+    ));
+}

resources/sql/autopatches/20161011.conpherence.ngrams.sql

···
+CREATE TABLE {$NAMESPACE}_conpherence.conpherence_threadtitle_ngrams (
+  id INT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  objectID INT UNSIGNED NOT NULL,
+  ngram CHAR(3) NOT NULL COLLATE {$COLLATE_TEXT},
+  KEY `key_object` (objectID),
+  KEY `key_ngram` (ngram, objectID)
+) ENGINE=InnoDB, COLLATE {$COLLATE_TEXT};

src/__phutil_library_map__.php

···
     'ConpherenceSchemaSpec' => 'applications/conpherence/storage/ConpherenceSchemaSpec.php',
     'ConpherenceTestCase' => 'applications/conpherence/__tests__/ConpherenceTestCase.php',
     'ConpherenceThread' => 'applications/conpherence/storage/ConpherenceThread.php',
+    'ConpherenceThreadDatasource' => 'applications/conpherence/typeahead/ConpherenceThreadDatasource.php',
     'ConpherenceThreadIndexEngineExtension' => 'applications/conpherence/engineextension/ConpherenceThreadIndexEngineExtension.php',
     'ConpherenceThreadListView' => 'applications/conpherence/view/ConpherenceThreadListView.php',
     'ConpherenceThreadMailReceiver' => 'applications/conpherence/mail/ConpherenceThreadMailReceiver.php',
···
     'ConpherenceThreadQuery' => 'applications/conpherence/query/ConpherenceThreadQuery.php',
     'ConpherenceThreadRemarkupRule' => 'applications/conpherence/remarkup/ConpherenceThreadRemarkupRule.php',
     'ConpherenceThreadSearchEngine' => 'applications/conpherence/query/ConpherenceThreadSearchEngine.php',
+    'ConpherenceThreadTitleNgrams' => 'applications/conpherence/storage/ConpherenceThreadTitleNgrams.php',
     'ConpherenceTransaction' => 'applications/conpherence/storage/ConpherenceTransaction.php',
     'ConpherenceTransactionComment' => 'applications/conpherence/storage/ConpherenceTransactionComment.php',
     'ConpherenceTransactionQuery' => 'applications/conpherence/query/ConpherenceTransactionQuery.php',
···
       'PhabricatorApplicationTransactionInterface',
       'PhabricatorMentionableInterface',
       'PhabricatorDestructibleInterface',
+      'PhabricatorNgramsInterface',
     ),
+    'ConpherenceThreadDatasource' => 'PhabricatorTypeaheadDatasource',
     'ConpherenceThreadIndexEngineExtension' => 'PhabricatorIndexEngineExtension',
     'ConpherenceThreadListView' => 'AphrontView',
     'ConpherenceThreadMailReceiver' => 'PhabricatorObjectMailReceiver',
···
     'ConpherenceThreadQuery' => 'PhabricatorCursorPagedPolicyAwareQuery',
     'ConpherenceThreadRemarkupRule' => 'PhabricatorObjectRemarkupRule',
     'ConpherenceThreadSearchEngine' => 'PhabricatorApplicationSearchEngine',
+    'ConpherenceThreadTitleNgrams' => 'PhabricatorSearchNgrams',
     'ConpherenceTransaction' => 'PhabricatorApplicationTransaction',
     'ConpherenceTransactionComment' => 'PhabricatorApplicationTransactionComment',
     'ConpherenceTransactionQuery' => 'PhabricatorApplicationTransactionQuery',

src/applications/conpherence/query/ConpherenceThreadQuery.php

···
     return $this;
   }
 
+  public function withTitleNgrams($ngrams) {
+    return $this->withNgramsConstraint(
+      id(new ConpherenceThreadTitleNgrams()),
+      $ngrams);
+  }
+
   protected function loadPage() {
     $table = new ConpherenceThread();
     $conn_r = $table->establishConnection('r');

src/applications/conpherence/query/ConpherenceThreadSearchEngine.php

···
         ->setLabel(pht('Participants'))
         ->setKey('participants')
         ->setAliases(array('participant')),
+      id(new PhabricatorSearchDatasourceField())
+        ->setLabel(pht('Rooms'))
+        ->setKey('phids')
+        ->setDescription(pht('Search by room titles.'))
+        ->setDatasource(id(new ConpherenceThreadDatasource())),
       id(new PhabricatorSearchTextField())
-        ->setLabel(pht('Contains Words'))
+        ->setLabel(pht('Room Contains Words'))
         ->setKey('fulltext'),
     );
   }
···
     if ($map['fulltext']) {
       $query->withFulltext($map['fulltext']);
     }
-
+    if ($map['phids']) {
+      $query->withPHIDs($map['phids']);
+    }
     return $query;
   }
 

src/applications/conpherence/storage/ConpherenceThread.php

···
     PhabricatorPolicyInterface,
     PhabricatorApplicationTransactionInterface,
     PhabricatorMentionableInterface,
-    PhabricatorDestructibleInterface {
+    PhabricatorDestructibleInterface,
+    PhabricatorNgramsInterface {
 
   protected $title;
   protected $topic;
···
     PhabricatorApplicationTransactionView $timeline,
     AphrontRequest $request) {
     return $timeline;
+  }
+
+/* -(  PhabricatorNgramInterface  )------------------------------------------ */
+
+
+  public function newNgrams() {
+    return array(
+      id(new ConpherenceThreadTitleNgrams())
+        ->setValue($this->getTitle()),
+      );
   }
 
 

src/applications/conpherence/storage/ConpherenceThreadTitleNgrams.php

···
+<?php
+
+final class ConpherenceThreadTitleNgrams
+  extends PhabricatorSearchNgrams {
+
+  public function getNgramKey() {
+    return 'threadtitle';
+  }
+
+  public function getColumnName() {
+    return 'title';
+  }
+
+  public function getApplicationName() {
+    return 'conpherence';
+  }
+}

src/applications/conpherence/typeahead/ConpherenceThreadDatasource.php

···
+<?php
+
+final class ConpherenceThreadDatasource
+  extends PhabricatorTypeaheadDatasource {
+
+  public function getBrowseTitle() {
+    return pht('Browse Room');
+  }
+
+  public function getPlaceholderText() {
+    return pht('Type a room title...');
+  }
+
+  public function getDatasourceApplicationClass() {
+    return 'PhabricatorConpherenceApplication';
+  }
+
+  public function loadResults() {
+    $viewer = $this->getViewer();
+    $raw_query = $this->getRawQuery();
+
+    $rooms = id(new ConpherenceThreadQuery())
+      ->setViewer($viewer)
+      ->withTitleNgrams($raw_query)
+      ->needParticipants(true)
+      ->execute();
+
+    $results = array();
+    foreach ($rooms as $room) {
+      if (strlen($room->getTopic())) {
+        $topic = $room->getTopic();
+      } else {
+        $topic = phutil_tag('em', array(), pht('No topic set'));
+      }
+
+      $token = id(new PhabricatorTypeaheadResult())
+        ->setName($room->getTitle())
+        ->setPHID($room->getPHID())
+        ->addAttribute($topic);
+
+      $results[] = $token;
+    }
+
+    return $results;
+  }
+
+}