Page MenuHomeClusterLabs Projects
Diviner Tech Docs DiffusionQueryConduitAPIMethod

abstract class DiffusionQueryConduitAPIMethod
Phorge Technical Documentation (Diffusion)

This class is not documented.

Tasks

Method Information

  • public function getMethodSummary() — Get a short, human-readable text summary of the method.
  • abstract public function getMethodDescription() — Get a detailed description of the method.

Method Status

  • public function getMethodStatus() — Get the status for this method (e.g., stable, unstable or deprecated). Should return a METHOD_STATUS_* constant. By default, methods are "stable".
  • public function getMethodStatusDescription() — Optional description to supplement the method status. In particular, if a method is deprecated, you can return a string here describing the reason for deprecation and stable alternatives.

Paging Results

Other Methods

Methods

public function getMethodSummary()
Inherited

ConduitAPIMethod

Get a short, human-readable text summary of the method.

Return
stringShort summary of method.

abstract public function getMethodDescription()
Inherited

ConduitAPIMethod

Get a detailed description of the method.

This method should return remarkup.

Return
stringDetailed description of the method.

final public function getDocumentationPages($viewer)
Inherited

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

protected function newDocumentationPages($viewer)
Inherited

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

final protected function newDocumentationPage($viewer)
Inherited

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

final protected function newDocumentationBoxPage($viewer, $title, $content)
Inherited

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

final protected function defineParamTypes()

This method is not documented.
Return
wild

abstract protected function defineReturnType()
Inherited

This method is not documented.
Return
wild

final protected function defineErrorTypes()

This method is not documented.
Return
wild

final protected function execute($request)

This method is final because most queries will need to construct a DiffusionRequest and use it. Consolidating this codepath and enforcing getDiffusionRequest() works when we need it is good.

getResult() should be overridden by subclasses as necessary, e.g. there is a common operation across all version control systems that should occur after getResult(), like formatting a timestamp.

Parameters
ConduitAPIRequest$request
Return
wild

public function isInternalAPI()
Inherited

This method is not documented.
Return
wild

public function getParamTypes()
Inherited

This method is not documented.
Return
wild

public function getReturnType()
Inherited

This method is not documented.
Return
wild

public function getErrorTypes()
Inherited

This method is not documented.
Return
wild

public function getID()
Inherited

ConduitAPIMethod

This is mostly for compatibility with PhabricatorCursorPagedPolicyAwareQuery.

Return
wild

public function getMethodStatus()
Inherited

ConduitAPIMethod

Get the status for this method (e.g., stable, unstable or deprecated). Should return a METHOD_STATUS_* constant. By default, methods are "stable".

Return
constMETHOD_STATUS_* constant.

public function getMethodStatusDescription()
Inherited

ConduitAPIMethod

Optional description to supplement the method status. In particular, if a method is deprecated, you can return a string here describing the reason for deprecation and stable alternatives.

Return
string|nullDescription of the method status, if available.

public function getErrorDescription($error_code)
Inherited

This method is not documented.
Parameters
$error_code
Return
wild

public function getRequiredScope()
Inherited

This method is not documented.
Return
wild

public function executeMethod($request)
Inherited

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

protected function newConduitCallProxyClient($request)

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

abstract public function getAPIMethodName()
Inherited

This method is not documented.
Return
wild

public function getSortOrder()
Inherited

ConduitAPIMethod

Return a key which sorts methods by application name, then method status, then method name.

Return
wild

public static function getMethodStatusMap()
Inherited

This method is not documented.
Return
wild

public function getApplicationName()
Inherited

This method is not documented.
Return
wild

public static function loadAllConduitMethods()
Inherited

This method is not documented.
Return
wild

private static function newClassMapQuery()
Inherited

This method is not documented.
Return
wild

public static function getConduitMethod($method_name)
Inherited

This method is not documented.
Parameters
$method_name
Return
wild

public function shouldRequireAuthentication()
Inherited

This method is not documented.
Return
wild

public function shouldAllowPublic()

This method is not documented.
Return
wild

public function shouldAllowUnguardedWrites()
Inherited

This method is not documented.
Return
wild

final public function getApplication()
Inherited

ConduitAPIMethod

Optionally, return a PhabricatorApplication which this call is part of. The call will be disabled when the application is uninstalled.

Return
PhabricatorApplication|nullRelated application.

protected function formatStringConstants($constants)
Inherited

This method is not documented.
Parameters
$constants
Return
wild

public static function getParameterMetadataKey($key)
Inherited

This method is not documented.
Parameters
$key
Return
wild

final public function setViewer($viewer)
Inherited

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

final public function getViewer()
Inherited

This method is not documented.
Return
wild

protected function getPagerParamTypes()
Inherited

This method is not documented.
Return
wild

protected function newPager($request)
Inherited

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

protected function addPagerResults($results, $pager)
Inherited

This method is not documented.
Parameters
array$results
AphrontCursorPagerView$pager
Return
wild

public function newQueryObject()
Inherited

This method is not documented.
Return
wild

protected function newQueryForRequest($request)
Inherited

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

public function getPHID()
Inherited

This method is not documented.
Return
wild

public function getCapabilities()
Inherited

This method is not documented.
Return
wild

public function getPolicy($capability)
Inherited

This method is not documented.
Parameters
$capability
Return
wild

public function hasAutomaticCapability($capability, $viewer)
Inherited

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

protected function hasApplicationCapability($capability, $viewer)
Inherited

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

protected function requireApplicationCapability($capability, $viewer)
Inherited

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

final protected function newRemarkupDocumentationView($remarkup)
Inherited

This method is not documented.
Parameters
$remarkup
Return
wild

protected function setDiffusionRequest($request)

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

protected function getDiffusionRequest()

This method is not documented.
Return
wild

protected function getRepository($request)

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

protected function defineCustomErrorTypes()

Subclasses should override this to specify custom error types.

Return
wild

protected function defineCustomParamTypes()

Subclasses should override this to specify custom param types.

Return
wild

protected function getGitResult($request)

Subclasses should override these methods with the proper result for the pertinent version control system, e.g. getGitResult for Git.

If the result is not supported for that VCS, do not implement it. e.g. Subversion (SVN) does not support branches.

Parameters
ConduitAPIRequest$request
Return
wild

protected function getSVNResult($request)

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

protected function getMercurialResult($request)

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

protected function getResult($request)

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