Diffusion Phabricator (production) Browse

PhabricatorOwnersPackage.php
2fc7203dc742production

PhabricatorOwnersPackage.php
View Options

			<?php

			final class PhabricatorOwnersPackage
			extends PhabricatorOwnersDAO
			implements
			PhabricatorPolicyInterface,
			PhabricatorApplicationTransactionInterface,
			PhabricatorCustomFieldInterface,
			PhabricatorDestructibleInterface,
			PhabricatorConduitResultInterface,
			PhabricatorFulltextInterface,
			PhabricatorNgramsInterface {

			protected $name;
			protected $originalName;
			protected $auditingEnabled;
			protected $autoReview;
			protected $description;
			protected $primaryOwnerPHID;
			protected $mailKey;
			protected $status;
			protected $viewPolicy;
			protected $editPolicy;
			protected $dominion;

			private $paths = self::ATTACHABLE;
			private $owners = self::ATTACHABLE;
			private $customFields = self::ATTACHABLE;

			const STATUS_ACTIVE = 'active';
			const STATUS_ARCHIVED = 'archived';

			const AUTOREVIEW_NONE = 'none';
			const AUTOREVIEW_SUBSCRIBE = 'subscribe';
			const AUTOREVIEW_REVIEW = 'review';
			const AUTOREVIEW_BLOCK = 'block';

			const DOMINION_STRONG = 'strong';
			const DOMINION_WEAK = 'weak';

			public static function initializeNewPackage(PhabricatorUser $actor) {
			$app = id(new PhabricatorApplicationQuery())
			->setViewer($actor)
			->withClasses(array('PhabricatorOwnersApplication'))
			->executeOne();

			$view_policy = $app->getPolicy(
			PhabricatorOwnersDefaultViewCapability::CAPABILITY);
			$edit_policy = $app->getPolicy(
			PhabricatorOwnersDefaultEditCapability::CAPABILITY);

			return id(new PhabricatorOwnersPackage())
			->setAuditingEnabled(0)
			->setAutoReview(self::AUTOREVIEW_NONE)
			->setDominion(self::DOMINION_STRONG)
			->setViewPolicy($view_policy)
			->setEditPolicy($edit_policy)
			->attachPaths(array())
			->setStatus(self::STATUS_ACTIVE)
			->attachOwners(array())
			->setDescription('');
			}

			public static function getStatusNameMap() {
			return array(
			self::STATUS_ACTIVE => pht('Active'),
			self::STATUS_ARCHIVED => pht('Archived'),
			);
			}

			public static function getAutoreviewOptionsMap() {
			return array(
			self::AUTOREVIEW_NONE => array(
			'name' => pht('No Autoreview'),
			),
			self::AUTOREVIEW_SUBSCRIBE => array(
			'name' => pht('Subscribe to Changes'),
			),
			self::AUTOREVIEW_REVIEW => array(
			'name' => pht('Review Changes'),
			),
			self::AUTOREVIEW_BLOCK => array(
			'name' => pht('Review Changes (Blocking)'),
			),
			);
			}

			public static function getDominionOptionsMap() {
			return array(
			self::DOMINION_STRONG => array(
			'name' => pht('Strong (Control All Paths)'),
			'short' => pht('Strong'),
			),
			self::DOMINION_WEAK => array(
			'name' => pht('Weak (Control Unowned Paths)'),
			'short' => pht('Weak'),
			),
			);
			}

			protected function getConfiguration() {
			return array(
			// This information is better available from the history table.
			self::CONFIG_TIMESTAMPS => false,
			self::CONFIG_AUX_PHID => true,
			self::CONFIG_COLUMN_SCHEMA => array(
			'name' => 'sort128',
			'originalName' => 'text255',
			'description' => 'text',
			'primaryOwnerPHID' => 'phid?',
			'auditingEnabled' => 'bool',
			'mailKey' => 'bytes20',
			'status' => 'text32',
			'autoReview' => 'text32',
			'dominion' => 'text32',
			),
			) + parent::getConfiguration();
			}

			public function generatePHID() {
			return PhabricatorPHID::generateNewPHID(
			PhabricatorOwnersPackagePHIDType::TYPECONST);
			}

			public function save() {
			if (!$this->getMailKey()) {
			$this->setMailKey(Filesystem::readRandomCharacters(20));
			}

			return parent::save();
			}

			public function isArchived() {
			return ($this->getStatus() == self::STATUS_ARCHIVED);
			}

			public function setName($name) {
			$this->name = $name;
			if (!$this->getID()) {
			$this->originalName = $name;
			}
			return $this;
			}

			public function loadOwners() {
			if (!$this->getID()) {
			return array();
			}
			return id(new PhabricatorOwnersOwner())->loadAllWhere(
			'packageID = %d',
			$this->getID());
			}

			public function loadPaths() {
			if (!$this->getID()) {
			return array();
			}
			return id(new PhabricatorOwnersPath())->loadAllWhere(
			'packageID = %d',
			$this->getID());
			}

			public static function loadAffectedPackages(
			PhabricatorRepository $repository,
			array $paths) {

			if (!$paths) {
			return array();
			}

			return self::loadPackagesForPaths($repository, $paths);
			}

			public static function loadOwningPackages($repository, $path) {
			if (empty($path)) {
			return array();
			}

			return self::loadPackagesForPaths($repository, array($path), 1);
			}

			private static function loadPackagesForPaths(
			PhabricatorRepository $repository,
			array $paths,
			$limit = 0) {

			$fragments = array();
			foreach ($paths as $path) {
			foreach (self::splitPath($path) as $fragment) {
			$fragments[$fragment][$path] = true;
			}
			}

			$package = new PhabricatorOwnersPackage();
			$path = new PhabricatorOwnersPath();
			$conn = $package->establishConnection('r');

			$repository_clause = qsprintf(
			$conn,
			'AND p.repositoryPHID = %s',
			$repository->getPHID());

			// NOTE: The list of $paths may be very large if we're coming from
			// the OwnersWorker and processing, e.g., an SVN commit which created a new
			// branch. Break it apart so that it will fit within 'max_allowed_packet',
			// and then merge results in PHP.

			$rows = array();
			foreach (array_chunk(array_keys($fragments), 128) as $chunk) {
			$rows[] = queryfx_all(
			$conn,
			'SELECT pkg.id, pkg.dominion, p.excluded, p.path
			FROM %T pkg JOIN %T p ON p.packageID = pkg.id
			WHERE p.path IN (%Ls) AND pkg.status IN (%Ls) %Q',
			$package->getTableName(),
			$path->getTableName(),
			$chunk,
			array(
			self::STATUS_ACTIVE,
			),
			$repository_clause);
			}
			$rows = array_mergev($rows);

			$ids = self::findLongestPathsPerPackage($rows, $fragments);

			if (!$ids) {
			return array();
			}

			arsort($ids);
			if ($limit) {
			$ids = array_slice($ids, 0, $limit, $preserve_keys = true);
			}
			$ids = array_keys($ids);

			$packages = $package->loadAllWhere('id in (%Ld)', $ids);
			$packages = array_select_keys($packages, $ids);

			return $packages;
			}

			public static function loadPackagesForRepository($repository) {
			$package = new PhabricatorOwnersPackage();
			$ids = ipull(
			queryfx_all(
			$package->establishConnection('r'),
			'SELECT DISTINCT packageID FROM %T WHERE repositoryPHID = %s',
			id(new PhabricatorOwnersPath())->getTableName(),
			$repository->getPHID()),
			'packageID');

			return $package->loadAllWhere('id in (%Ld)', $ids);
			}

			public static function findLongestPathsPerPackage(array $rows, array $paths) {

			// Build a map from each path to all the package paths which match it.
			$path_hits = array();
			$weak = array();
			foreach ($rows as $row) {
			$id = $row['id'];
			$path = $row['path'];
			$length = strlen($path);
			$excluded = $row['excluded'];

			if ($row['dominion'] === self::DOMINION_WEAK) {
			$weak[$id] = true;
			}

			$matches = $paths[$path];
			foreach ($matches as $match => $ignored) {
			$path_hits[$match][] = array(
			'id' => $id,
			'excluded' => $excluded,
			'length' => $length,
			);
			}
			}

			// For each path, process the matching package paths to figure out which
			// packages actually own it.
			$path_packages = array();
			foreach ($path_hits as $match => $hits) {
			$hits = isort($hits, 'length');

			$packages = array();
			foreach ($hits as $hit) {
			$package_id = $hit['id'];
			if ($hit['excluded']) {
			unset($packages[$package_id]);
			} else {
			$packages[$package_id] = $hit;
			}
			}

			$path_packages[$match] = $packages;
			}

			// Remove packages with weak dominion rules that should cede control to
			// a more specific package.
			if ($weak) {
			foreach ($path_packages as $match => $packages) {
			$packages = isort($packages, 'length');
			$packages = array_reverse($packages, true);

			$first = null;
			foreach ($packages as $package_id => $package) {
			// If this is the first package we've encountered, note it and
			// continue. We're iterating over the packages from longest to
			// shortest match, so this package always has the strongest claim
			// on the path.
			if ($first === null) {
			$first = $package_id;
			continue;
			}

			// If this is the first package we saw, its claim stands even if it
			// is a weak package.
			if ($first === $package_id) {
			continue;
			}

			// If this is a weak package and not the first package we saw,
			// cede its claim to the stronger package.
			if (isset($weak[$package_id])) {
			unset($packages[$package_id]);
			}
			}

			$path_packages[$match] = $packages;
			}
			}

			// For each package that owns at least one path, identify the longest
			// path it owns.
			$package_lengths = array();
			foreach ($path_packages as $match => $hits) {
			foreach ($hits as $hit) {
			$length = $hit['length'];
			$id = $hit['id'];
			if (empty($package_lengths[$id])) {
			$package_lengths[$id] = $length;
			} else {
			$package_lengths[$id] = max($package_lengths[$id], $length);
			}
			}
			}

			return $package_lengths;
			}

			public static function splitPath($path) {
			$trailing_slash = preg_match('@/$@', $path) ? '/' : '';
			$path = trim($path, '/');
			$parts = explode('/', $path);

			$result = array();
			while (count($parts)) {
			$result[] = '/'.implode('/', $parts).$trailing_slash;
			$trailing_slash = '/';
			array_pop($parts);
			}
			$result[] = '/';

			return array_reverse($result);
			}

			public function attachPaths(array $paths) {
			assert_instances_of($paths, 'PhabricatorOwnersPath');
			$this->paths = $paths;
			return $this;
			}

			public function getPaths() {
			return $this->assertAttached($this->paths);
			}

			public function attachOwners(array $owners) {
			assert_instances_of($owners, 'PhabricatorOwnersOwner');
			$this->owners = $owners;
			return $this;
			}

			public function getOwners() {
			return $this->assertAttached($this->owners);
			}

			public function getOwnerPHIDs() {
			return mpull($this->getOwners(), 'getUserPHID');
			}

			public function isOwnerPHID($phid) {
			if (!$phid) {
			return false;
			}

			$owner_phids = $this->getOwnerPHIDs();
			$owner_phids = array_fuse($owner_phids);

			return isset($owner_phids[$phid]);
			}

			public function getMonogram() {
			return 'O'.$this->getID();
			}

			public function getURI() {
			// TODO: Move these to "/O123" for consistency.
			return '/owners/package/'.$this->getID().'/';
			}

			/* -( PhabricatorPolicyInterface )----------------------------------------- */


			public function getCapabilities() {
			return array(
			PhabricatorPolicyCapability::CAN_VIEW,
			PhabricatorPolicyCapability::CAN_EDIT,
			);
			}

			public function getPolicy($capability) {
			switch ($capability) {
			case PhabricatorPolicyCapability::CAN_VIEW:
			return $this->getViewPolicy();
			case PhabricatorPolicyCapability::CAN_EDIT:
			return $this->getEditPolicy();
			}
			}

			public function hasAutomaticCapability($capability, PhabricatorUser $viewer) {
			switch ($capability) {
			case PhabricatorPolicyCapability::CAN_VIEW:
			if ($this->isOwnerPHID($viewer->getPHID())) {
			return true;
			}
			break;
			}

			return false;
			}

			public function describeAutomaticCapability($capability) {
			return pht('Owners of a package may always view it.');
			}


			/* -( PhabricatorApplicationTransactionInterface )------------------------- */


			public function getApplicationTransactionEditor() {
			return new PhabricatorOwnersPackageTransactionEditor();
			}

			public function getApplicationTransactionObject() {
			return $this;
			}

			public function getApplicationTransactionTemplate() {
			return new PhabricatorOwnersPackageTransaction();
			}

			public function willRenderTimeline(
			PhabricatorApplicationTransactionView $timeline,
			AphrontRequest $request) {
			return $timeline;
			}


			/* -( PhabricatorCustomFieldInterface )------------------------------------ */


			public function getCustomFieldSpecificationForRole($role) {
			return PhabricatorEnv::getEnvConfig('owners.fields');
			}

			public function getCustomFieldBaseClass() {
			return 'PhabricatorOwnersCustomField';
			}

			public function getCustomFields() {
			return $this->assertAttached($this->customFields);
			}

			public function attachCustomFields(PhabricatorCustomFieldAttachment $fields) {
			$this->customFields = $fields;
			return $this;
			}


			/* -( PhabricatorDestructibleInterface )----------------------------------- */


			public function destroyObjectPermanently(
			PhabricatorDestructionEngine $engine) {

			$this->openTransaction();
			$conn_w = $this->establishConnection('w');

			queryfx(
			$conn_w,
			'DELETE FROM %T WHERE packageID = %d',
			id(new PhabricatorOwnersPath())->getTableName(),
			$this->getID());

			queryfx(
			$conn_w,
			'DELETE FROM %T WHERE packageID = %d',
			id(new PhabricatorOwnersOwner())->getTableName(),
			$this->getID());

			$this->delete();
			$this->saveTransaction();
			}


			/* -( PhabricatorConduitResultInterface )---------------------------------- */


			public function getFieldSpecificationsForConduit() {
			return array(
			id(new PhabricatorConduitSearchFieldSpecification())
			->setKey('name')
			->setType('string')
			->setDescription(pht('The name of the package.')),
			id(new PhabricatorConduitSearchFieldSpecification())
			->setKey('description')
			->setType('string')
			->setDescription(pht('The package description.')),
			id(new PhabricatorConduitSearchFieldSpecification())
			->setKey('status')
			->setType('string')
			->setDescription(pht('Active or archived status of the package.')),
			id(new PhabricatorConduitSearchFieldSpecification())
			->setKey('owners')
			->setType('list<map<string, wild>>')
			->setDescription(pht('List of package owners.')),
			);
			}

			public function getFieldValuesForConduit() {
			$owner_list = array();
			foreach ($this->getOwners() as $owner) {
			$owner_list[] = array(
			'ownerPHID' => $owner->getUserPHID(),
			);
			}

			return array(
			'name' => $this->getName(),
			'description' => $this->getDescription(),
			'status' => $this->getStatus(),
			'owners' => $owner_list,
			);
			}

			public function getConduitSearchAttachments() {
			return array(
			id(new PhabricatorOwnersPathsSearchEngineAttachment())
			->setAttachmentKey('paths'),
			);
			}


			/* -( PhabricatorFulltextInterface )--------------------------------------- */


			public function newFulltextEngine() {
			return new PhabricatorOwnersPackageFulltextEngine();
			}


			/* -( PhabricatorNgramsInterface )----------------------------------------- */


			public function newNgrams() {
			return array(
			id(new PhabricatorOwnersPackageNameNgrams())
			->setValue($this->getName()),
			);
			}

			}

phab/src/applications/owners/storage/PhabricatorOwnersPackage.php2fc7203dc742production

PhabricatorOwnersPackage.phpView Options

phab/src/applications/owners/storage/PhabricatorOwnersPackage.php
2fc7203dc742production

PhabricatorOwnersPackage.php
View Options