Page MenuHomePhorge
Diviner Tech Docs PhabricatorNotificationSearchEngine

final class PhabricatorNotificationSearchEngine
Phorge Technical Documentation (Notifications)

This class is not documented.

Tasks

Constructing Engines

  • public static function getAllEngines() — Load all available application search engines.
  • public static function getEngineByClassName($class_name) — Get an engine by class name, if it exists.

Applications

No methods for this task.

Builtin Queries

Query URIs

  • public function getQueryResultsPageURI($query_key) — Return an application URI corresponding to the results page of a query. Normally, this is something like `/application/query/QUERYKEY/`.
  • public function getQueryManagementURI() — Return an application URI for query management. This is used when, e.g., a query deletion operation is cancelled.
  • protected function getURI($path)

Date Filters

  • protected function parseDateTime($date_time)
  • protected function buildDateRange($form, $saved_query, $start_key, $start_name, $end_key, $end_name)

Result Ordering

No methods for this task.

Reading Utilities

  • protected function readUsersFromRequest($request, $key, $allow_types) — Read a list of user PHIDs from a request in a flexible way. This method supports either of these forms:
  • protected function readSubscribersFromRequest($request, $key) — Read a list of subscribers from a request in a flexible way.
  • protected function readPHIDsFromRequest($request, $key, $allow_types) — Read a list of generic PHIDs from a request in a flexible way. Like @{method:readUsersFromRequest}, this method supports either array or comma-delimited forms. Objects can be specified either by PHID or by object name.

Paging and Executing Queries

No methods for this task.

Rendering Results

No methods for this task.

Custom Fields

  • protected function loadCustomFields($objects, $role) — Load from object and from storage, and updates Custom Fields instances that are attached to each object.

Other Methods

Methods

public function __get($name)
Inherited

This method is not documented.
Parameters
$name
Return
wild

public function __set($name, $value)
Inherited

This method is not documented.
Parameters
$name
$value
Return
wild

public function current()
Inherited

This method is not documented.
Return
wild

public function key()
Inherited

This method is not documented.
Return
wild

public function next()
Inherited

This method is not documented.
Return
wild

public function rewind()
Inherited

This method is not documented.
Return
wild

public function valid()
Inherited

This method is not documented.
Return
wild

private function throwOnAttemptedIteration()
Inherited

This method is not documented.
Return
wild

public function getPhobjectClassConstant($key, $byte_limit)
Inherited

Phobject

Read the value of a class constant.

This is the same as just typing self::CONSTANTNAME, but throws a more useful message if the constant is not defined and allows the constant to be limited to a maximum length.

Parameters
string$keyName of the constant.
int|null$byte_limitMaximum number of bytes permitted in the value.
Return
stringValue of the constant.

public function setController($controller)
Inherited

This method is not documented.
Parameters
PhabricatorController$controller
Return
wild

public function getController()
Inherited

This method is not documented.
Return
wild

public function buildResponse()
Inherited

This method is not documented.
Return
wild

public function newResultObject()
Inherited

This method is not documented.
Return
wild

public function newQuery()
Inherited

This method is not documented.
Return
wild

public function setViewer($viewer)
Inherited

This method is not documented.
Parameters
PhabricatorUser$viewer
Return
wild

protected function requireViewer()
Inherited

This method is not documented.
Return
wild

public function setContext($context)
Inherited

This method is not documented.
Parameters
$context
Return
wild

public function isPanelContext()
Inherited

This method is not documented.
Return
wild

public function setNavigationItems($navigation_items)
Inherited

This method is not documented.
Parameters
array$navigation_items
Return
wild

public function getNavigationItems()
Inherited

This method is not documented.
Return
wild

public function canUseInPanelContext()
Inherited

This method is not documented.
Return
wild

public function saveQuery($query)
Inherited

This method is not documented.
Parameters
PhabricatorSavedQuery$query
Return
wild

public function buildSavedQueryFromRequest($request)

PhabricatorApplicationSearchEngine

Create a saved query object from the request.

PhabricatorNotificationSearchEngine
This method is not documented.
Parameters
AphrontRequest$requestThe search request.
Return
PhabricatorSavedQuery

public function buildQueryFromSavedQuery($saved)

PhabricatorApplicationSearchEngine

Executes the saved query.

PhabricatorNotificationSearchEngine
This method is not documented.
Parameters
PhabricatorSavedQuery$originalThe saved query to operate on.
Return
PhabricatorQueryThe result of the query.

protected function willUseSavedQuery($saved)
Inherited

PhabricatorApplicationSearchEngine

Hook for subclasses to adjust saved queries prior to use.

If an application changes how queries are saved, it can implement this hook to keep old queries working the way users expect, by reading, adjusting, and overwriting parameters.

Parameters
PhabricatorSavedQuery$savedSaved query which will be executed.
Return
void

protected function buildQueryFromParameters($parameters)
Inherited

This method is not documented.
Parameters
array$parameters
Return
wild

public function buildSearchForm($form, $saved)

PhabricatorApplicationSearchEngine

Builds the search form using the request.

PhabricatorNotificationSearchEngine
This method is not documented.
Parameters
AphrontFormView$formForm to populate.
PhabricatorSavedQuery$savedThe query from which to build the form.
Return
void

protected function buildSearchFields()
Inherited

This method is not documented.
Return
wild

protected function shouldShowOrderField()
Inherited

This method is not documented.
Return
wild

private function adjustFieldsForDisplay($field_map)
Inherited

This method is not documented.
Parameters
array$field_map
Return
wild

protected function buildCustomSearchFields()
Inherited

This method is not documented.
Return
wild

protected function getDefaultFieldOrder()
Inherited

PhabricatorApplicationSearchEngine

Define the default display order for fields by returning a list of field keys.

You can use the special key ... to mean "all unspecified fields go here". This lets you easily put important fields at the top of the form, standard fields in the middle of the form, and less important fields at the bottom.

For example, you might return a list like this:

return array(
  'authorPHIDs',
  'reviewerPHIDs',
  '...',
  'createdAfter',
  'createdBefore',
);

Any unspecified fields (including custom fields and fields added automatically by infrastructure) will be put in the middle.

Return
list<string>Default ordering for field keys.

protected function getHiddenFields()
Inherited

PhabricatorApplicationSearchEngine

Return a list of field keys which should be hidden from the viewer.

Return
list<string>Fields to hide.

public function getErrors()
Inherited

This method is not documented.
Return
wild

public function addError($error)
Inherited

This method is not documented.
Parameters
$error
Return
wild

public function getQueryResultsPageURI($query_key)
Inherited

PhabricatorApplicationSearchEngine

Return an application URI corresponding to the results page of a query. Normally, this is something like /application/query/QUERYKEY/.

Parameters
string$query_keyThe query key to build a URI for.
Return
stringURI where the query can be executed.

public function getQueryManagementURI()
Inherited

PhabricatorApplicationSearchEngine

Return an application URI for query management. This is used when, e.g., a query deletion operation is cancelled.

Return
stringURI where queries can be managed.

public function getQueryBaseURI()
Inherited

This method is not documented.
Return
wild

public function getExportURI($query_key)
Inherited

This method is not documented.
Parameters
$query_key
Return
wild

public function getCustomizeURI($query_key, $object_phid, $context_phid)
Inherited

This method is not documented.
Parameters
$query_key
$object_phid
$context_phid
Return
wild

protected function getURI($path)

PhabricatorApplicationSearchEngine

Return the URI to a path within the application. Used to construct default URIs for management and results.

PhabricatorNotificationSearchEngine
This method is not documented.
Parameters
$path
Return
stringURI to path.

public function getResultTypeDescription()

PhabricatorApplicationSearchEngine

Return a human readable description of the type of objects this query searches for.

For example, "Tasks" or "Commits".

PhabricatorNotificationSearchEngine
This method is not documented.
Return
stringHuman-readable description of what this engine is used to find.

public function newSavedQuery()
Inherited

This method is not documented.
Return
wild

public function addNavigationItems($menu)
Inherited

This method is not documented.
Parameters
PHUIListView$menu
Return
wild

public function loadAllNamedQueries()
Inherited

This method is not documented.
Return
wild

public function loadEnabledNamedQueries()
Inherited

This method is not documented.
Return
wild

public function getDefaultQueryKey()
Inherited

This method is not documented.
Return
wild

protected function setQueryProjects($query, $saved)
Inherited

This method is not documented.
Parameters
PhabricatorCursorPagedPolicyAwareQuery$query
PhabricatorSavedQuery$saved
Return
wild

protected function getApplicationURI($path)
Inherited

This method is not documented.
Parameters
$path
Return
wild

protected function getApplication()
Inherited

This method is not documented.
Return
wild

public function getApplicationClassName()

This method is not documented.
Return
wild

public static function getAllEngines()
Inherited

PhabricatorApplicationSearchEngine

Load all available application search engines.

Return
list<PhabricatorApplicationSearchEngine>All available engines.

public static function getEngineByClassName($class_name)
Inherited

PhabricatorApplicationSearchEngine

Get an engine by class name, if it exists.

Parameters
$class_name
Return
PhabricatorApplicationSearchEngine|nullEngine, or null if it does not exist.

public function getBuiltinQueries()
Inherited

This method is not documented.
Return
wild

public function getBuiltinQuery($query_key)
Inherited

This method is not documented.
Parameters
$query_key
Return
wild

protected function getBuiltinQueryNames()

This method is not documented.
Return
wild

public function isBuiltinQuery($query_key)
Inherited

This method is not documented.
Parameters
$query_key
Return
wild

public function buildSavedQueryFromBuiltin($query_key)

This method is not documented.
Parameters
$query_key
Return
wild

protected function readUsersFromRequest($request, $key, $allow_types)
Inherited

PhabricatorApplicationSearchEngine

Read a list of user PHIDs from a request in a flexible way. This method supports either of these forms:

users[]=alincoln&users[]=htaft
users=alincoln,htaft

Additionally, users can be specified either by PHID or by name.

The main goal of this flexibility is to allow external programs to generate links to pages (like "alincoln's open revisions") without needing to make API calls.

Parameters
AphrontRequest$requestRequest to read user PHIDs from.
string$keyKey to read in the request.
list<const>$allow_typesOther permitted PHID types.
Return
list<phid>List of user PHIDs and selector functions.

protected function readSubscribersFromRequest($request, $key)
Inherited

PhabricatorApplicationSearchEngine

Read a list of subscribers from a request in a flexible way.

Parameters
AphrontRequest$requestRequest to read PHIDs from.
string$keyKey to read in the request.
Return
list<phid>List of object PHIDs.

protected function readPHIDsFromRequest($request, $key, $allow_types)
Inherited

PhabricatorApplicationSearchEngine

Read a list of generic PHIDs from a request in a flexible way. Like readUsersFromRequest(), this method supports either array or comma-delimited forms. Objects can be specified either by PHID or by object name.

Parameters
AphrontRequest$requestRequest to read PHIDs from.
string$keyKey to read in the request.
list<const>$allow_typesOptional, list of permitted PHID types.
Return
list<phid>List of object PHIDs.

protected function readListFromRequest($request, $key)
Inherited

PhabricatorApplicationSearchEngine

Read a list of items from the request, in either array format or string format:

list[]=item1&list[]=item2
list=item1,item2

This provides flexibility when constructing URIs, especially from external sources.

Parameters
AphrontRequest$requestRequest to read strings from.
string$keyKey to read in the request.
Return
list<string>List of values.

protected function readBoolFromRequest($request, $key)
Inherited

This method is not documented.
Parameters
AphrontRequest$request
$key
Return
wild

protected function getBoolFromQuery($query, $key)
Inherited

This method is not documented.
Parameters
PhabricatorSavedQuery$query
$key
Return
wild

protected function parseDateTime($date_time)
Inherited

This method is not documented.
Parameters
$date_time
Return
wild

protected function buildDateRange($form, $saved_query, $start_key, $start_name, $end_key, $end_name)
Inherited

This method is not documented.
Parameters
AphrontFormView$form
PhabricatorSavedQuery$saved_query
$start_key
$start_name
$end_key
$end_name
Return
wild

protected function newResultBuckets()
Inherited

This method is not documented.
Return
wild

public function getResultBucket($saved)
Inherited

This method is not documented.
Parameters
PhabricatorSavedQuery$saved
Return
wild

public function getPageSize($saved)
Inherited

This method is not documented.
Parameters
PhabricatorSavedQuery$saved
Return
wild

public function shouldUseOffsetPaging()
Inherited

This method is not documented.
Return
wild

public function newPagerForSavedQuery($saved)
Inherited

This method is not documented.
Parameters
PhabricatorSavedQuery$saved
Return
wild

public function executeQuery($query, $pager)
Inherited

This method is not documented.
Parameters
PhabricatorPolicyAwareQuery$query
AphrontView$pager
Return
wild

protected function didExecuteQuery($query)
Inherited

This method is not documented.
Parameters
PhabricatorPolicyAwareQuery$query
Return
wild

public function setRequest($request)
Inherited

This method is not documented.
Parameters
AphrontRequest$request
Return
wild

public function getRequest()
Inherited

This method is not documented.
Return
wild

public function renderResults($objects, $query)
Inherited

This method is not documented.
Parameters
array$objects
PhabricatorSavedQuery$query
Return
wild

protected function getRequiredHandlePHIDsForResultList($objects, $query)
Inherited

This method is not documented.
Parameters
array$objects
PhabricatorSavedQuery$query
Return
wild

protected function renderResultList($notifications, $query, $handles)

This method is not documented.
Parameters
array$objects
PhabricatorSavedQuery$query
array$handles
Return
wild

public function getSearchFieldsForConduit()
Inherited

This method is not documented.
Return
wild

public function buildConduitResponse($request, $method)
Inherited

This method is not documented.
Parameters
ConduitAPIRequest$request
ConduitAPIMethod$method
Return
wild

public function getAllConduitFieldSpecifications()
Inherited

This method is not documented.
Return
wild

private function getEngineExtensions()
Inherited

This method is not documented.
Return
wild

private function getConduitFieldExtensions()
Inherited

This method is not documented.
Return
wild

private function setQueryOrderForConduit($query, $request)
Inherited

This method is not documented.
Parameters
$query
ConduitAPIRequest$request
Return
wild

private function setPagerLimitForConduit($pager, $request)
Inherited

This method is not documented.
Parameters
$pager
ConduitAPIRequest$request
Return
wild

private function setPagerOffsetsForConduit($pager, $request)
Inherited

This method is not documented.
Parameters
$pager
ConduitAPIRequest$request
Return
wild

protected function getObjectWireFieldsForConduit($object, $field_extensions, $extension_data)
Inherited

This method is not documented.
Parameters
$object
array$field_extensions
array$extension_data
Return
wild

public function getConduitSearchAttachments()
Inherited

This method is not documented.
Return
wild

final public function renderNewUserView()
Inherited

PhabricatorApplicationSearchEngine

Render a content body (if available) to onboard new users. This body is usually visible when you have no elements in a list, or when you force the rendering on a list with the ?nux=1 URL.

Return
wild|PhutilSafeHTML|null

protected function getNewUserHeader()
Inherited

PhabricatorApplicationSearchEngine

Get a content body to onboard new users. Traditionally this content is shown from an empty list, to explain what a certain entity does, and how to create a new one.

Return
wild|PhutilSafeHTML|null

protected function getNewUserBody()
Inherited

This method is not documented.
Return
wild

public function newUseResultsActions($saved)
Inherited

This method is not documented.
Parameters
PhabricatorSavedQuery$saved
Return
wild

public function canExport()
Inherited

This method is not documented.
Return
wild

final public function newExportFieldList()
Inherited

This method is not documented.
Return
wild

final public function newExport($objects)
Inherited

This method is not documented.
Parameters
array$objects
Return
wild

protected function newExportFields()
Inherited

This method is not documented.
Return
wild

protected function newExportData($objects)
Inherited

This method is not documented.
Parameters
array$objects
Return
wild

private function newExportExtensions()
Inherited

This method is not documented.
Return
wild

protected function loadCustomFields($objects, $role)
Inherited

PhabricatorApplicationSearchEngine

Load from object and from storage, and updates Custom Fields instances that are attached to each object.

Parameters
array$objects
$role
Return
map<phid->PhabricatorCustomFieldList>of loaded fields.