PhabricatorCalendarImportEngine.php
191b9398a5f6stable

PhabricatorCalendarImportEngine.php
View Options

			<?php

			abstract class PhabricatorCalendarImportEngine
			extends Phobject {

			final public function getImportEngineType() {
			return $this->getPhobjectClassConstant('ENGINETYPE', 64);
			}


			abstract public function getImportEngineName();
			abstract public function getImportEngineTypeName();
			abstract public function getImportEngineHint();

			public function appendImportProperties(
			PhabricatorUser $viewer,
			PhabricatorCalendarImport $import,
			PHUIPropertyListView $properties) {
			return;
			}

			abstract public function newEditEngineFields(
			PhabricatorEditEngine $engine,
			PhabricatorCalendarImport $import);

			abstract public function getDisplayName(PhabricatorCalendarImport $import);

			abstract public function importEventsFromSource(
			PhabricatorUser $viewer,
			PhabricatorCalendarImport $import);

			abstract public function canDisable(
			PhabricatorUser $viewer,
			PhabricatorCalendarImport $import);

			public function explainCanDisable(
			PhabricatorUser $viewer,
			PhabricatorCalendarImport $import) {
			throw new PhutilMethodNotImplementedException();
			}

			abstract public function supportsTriggers(
			PhabricatorCalendarImport $import);

			final public static function getAllImportEngines() {
			return id(new PhutilClassMapQuery())
			->setAncestorClass(__CLASS__)
			->setUniqueMethod('getImportEngineType')
			->setSortMethod('getImportEngineName')
			->execute();
			}

			final protected function importEventDocument(
			PhabricatorUser $viewer,
			PhabricatorCalendarImport $import,
			PhutilCalendarRootNode $root = null) {

			$event_type = PhutilCalendarEventNode::NODETYPE;

			$nodes = array();
			if ($root) {
			foreach ($root->getChildren() as $document) {
			foreach ($document->getChildren() as $node) {
			$node_type = $node->getNodeType();
			if ($node_type != $event_type) {
			$import->newLogMessage(
			PhabricatorCalendarImportIgnoredNodeLogType::LOGTYPE,
			array(
			'node.type' => $node_type,
			));
			continue;
			}

			$nodes[] = $node;
			}
			}
			}

			// Reject events which have dates outside of the range of a signed
			// 32-bit integer. We'll need to accommodate a wider range of events
			// eventually, but have about 20 years until it's an issue and we'll
			// all be dead by then.
			foreach ($nodes as $key => $node) {
			$dates = array();
			$dates[] = $node->getStartDateTime();
			$dates[] = $node->getEndDateTime();
			$dates[] = $node->getCreatedDateTime();
			$dates[] = $node->getModifiedDateTime();
			$rrule = $node->getRecurrenceRule();
			if ($rrule) {
			$dates[] = $rrule->getUntil();
			}

			$bad_date = false;
			foreach ($dates as $date) {
			if ($date === null) {
			continue;
			}

			$year = $date->getYear();
			if ($year < 1970 \|\| $year > 2037) {
			$bad_date = true;
			break;
			}
			}

			if ($bad_date) {
			$import->newLogMessage(
			PhabricatorCalendarImportEpochLogType::LOGTYPE,
			array());
			unset($nodes[$key]);
			}
			}

			// Reject events which occur too frequently. Users do not normally define
			// these events and the UI and application make many assumptions which are
			// incompatible with events recurring once per second.
			foreach ($nodes as $key => $node) {
			$rrule = $node->getRecurrenceRule();
			if (!$rrule) {
			// This is not a recurring event, so we don't need to check the
			// frequency.
			continue;
			}
			$scale = $rrule->getFrequencyScale();
			if ($scale >= PhutilCalendarRecurrenceRule::SCALE_DAILY) {
			// This is a daily, weekly, monthly, or yearly event. These are
			// supported.
			} else {
			// This is an hourly, minutely, or secondly event.
			$import->newLogMessage(
			PhabricatorCalendarImportFrequencyLogType::LOGTYPE,
			array(
			'frequency' => $rrule->getFrequency(),
			));
			unset($nodes[$key]);
			}
			}

			$node_map = array();
			foreach ($nodes as $node) {
			$full_uid = $this->getFullNodeUID($node);
			if (isset($node_map[$full_uid])) {
			$import->newLogMessage(
			PhabricatorCalendarImportDuplicateLogType::LOGTYPE,
			array(
			'uid.full' => $full_uid,
			));
			continue;
			}
			$node_map[$full_uid] = $node;
			}

			// If we already know about some of these events and they were created
			// here, we're not going to import it again. This can happen if a user
			// exports an event and then tries to import it again. This is probably
			// not what they meant to do and this pathway generally leads to madness.
			$likely_phids = array();
			foreach ($node_map as $full_uid => $node) {
			$uid = $node->getUID();
			$matches = null;
			if (preg_match('/^(PHID-.)@(.)\z/', $uid, $matches)) {
			$likely_phids[$full_uid] = $matches[1];
			}
			}

			if ($likely_phids) {
			// NOTE: We're using the omnipotent viewer here because we don't want
			// to collide with events that already exist, even if you can't see
			// them.
			$events = id(new PhabricatorCalendarEventQuery())
			->setViewer(PhabricatorUser::getOmnipotentUser())
			->withPHIDs($likely_phids)
			->execute();
			$events = mpull($events, null, 'getPHID');
			foreach ($node_map as $full_uid => $node) {
			$phid = idx($likely_phids, $full_uid);
			if (!$phid) {
			continue;
			}

			$event = idx($events, $phid);
			if (!$event) {
			continue;
			}

			$import->newLogMessage(
			PhabricatorCalendarImportOriginalLogType::LOGTYPE,
			array(
			'phid' => $event->getPHID(),
			));

			unset($node_map[$full_uid]);
			}
			}

			if ($node_map) {
			$events = id(new PhabricatorCalendarEventQuery())
			->setViewer($viewer)
			->withImportAuthorPHIDs(array($viewer->getPHID()))
			->withImportUIDs(array_keys($node_map))
			->execute();
			$events = mpull($events, null, 'getImportUID');
			} else {
			$events = null;
			}

			$xactions = array();
			$update_map = array();
			$invitee_map = array();
			$attendee_map = array();
			foreach ($node_map as $full_uid => $node) {
			$event = idx($events, $full_uid);
			if (!$event) {
			$event = PhabricatorCalendarEvent::initializeNewCalendarEvent($viewer);
			}

			$event
			->setImportAuthorPHID($viewer->getPHID())
			->setImportSourcePHID($import->getPHID())
			->setImportUID($full_uid)
			->attachImportSource($import);

			$this->updateEventFromNode($viewer, $event, $node);
			$xactions[$full_uid] = $this->newUpdateTransactions($event, $node);
			$update_map[$full_uid] = $event;

			$attendee_map[$full_uid] = array();
			$attendees = $node->getAttendees();
			$private_index = 1;
			foreach ($attendees as $attendee) {
			// Generate a "name" for this attendee which is not an email address.
			// We avoid disclosing email addresses to be consistent with the rest
			// of the product.
			$name = $attendee->getName();
			if (preg_match('/@/', $name)) {
			$name = new PhutilEmailAddress($name);
			$name = $name->getDisplayName();
			}

			// If we don't have a name or the name still looks like it's an
			// email address, give them a dummy placeholder name.
			if (!strlen($name) \|\| preg_match('/@/', $name)) {
			$name = pht('Private User %d', $private_index);
			$private_index++;
			}

			$attendee_map[$full_uid][$name] = $attendee;
			}
			}

			$attendee_names = array();
			foreach ($attendee_map as $full_uid => $event_attendees) {
			foreach ($event_attendees as $name => $attendee) {
			$attendee_names[$name] = $attendee;
			}
			}

			if ($attendee_names) {
			$external_invitees = id(new PhabricatorCalendarExternalInviteeQuery())
			->setViewer($viewer)
			->withNames($attendee_names)
			->execute();
			$external_invitees = mpull($external_invitees, null, 'getName');

			foreach ($attendee_names as $name => $attendee) {
			if (isset($external_invitees[$name])) {
			continue;
			}

			$external_invitee = id(new PhabricatorCalendarExternalInvitee())
			->setName($name)
			->setURI($attendee->getURI())
			->setSourcePHID($import->getPHID());

			try {
			$external_invitee->save();
			} catch (AphrontDuplicateKeyQueryException $ex) {
			$external_invitee =
			id(new PhabricatorCalendarExternalInviteeQuery())
			->setViewer($viewer)
			->withNames(array($name))
			->executeOne();
			}

			$external_invitees[$name] = $external_invitee;
			}
			}

			// Reorder events so we create parents first. This allows us to populate
			// "instanceOfEventPHID" correctly.
			$insert_order = array();
			foreach ($update_map as $full_uid => $event) {
			$parent_uid = $this->getParentNodeUID($node_map[$full_uid]);
			if ($parent_uid === null) {
			$insert_order[$full_uid] = $full_uid;
			continue;
			}

			if (empty($update_map[$parent_uid])) {
			// The parent was not present in this import, which means it either
			// does not exist or we're going to delete it anyway. We just drop
			// this node.

			$import->newLogMessage(
			PhabricatorCalendarImportOrphanLogType::LOGTYPE,
			array(
			'uid.full' => $full_uid,
			'uid.parent' => $parent_uid,
			));

			continue;
			}

			// Otherwise, we're going to insert the parent first, then insert
			// the child.
			$insert_order[$parent_uid] = $parent_uid;
			$insert_order[$full_uid] = $full_uid;
			}

			// TODO: Define per-engine content sources so this can say "via Upload" or
			// whatever.
			$content_source = PhabricatorContentSource::newForSource(
			PhabricatorWebContentSource::SOURCECONST);

			// NOTE: We're using the omnipotent user here because imported events are
			// otherwise immutable.
			$edit_actor = PhabricatorUser::getOmnipotentUser();

			$update_map = array_select_keys($update_map, $insert_order);
			foreach ($update_map as $full_uid => $event) {
			$parent_uid = $this->getParentNodeUID($node_map[$full_uid]);
			if ($parent_uid) {
			$parent_phid = $update_map[$full_uid]->getPHID();
			} else {
			$parent_phid = null;
			}

			$event->setInstanceOfEventPHID($parent_phid);

			$event_xactions = $xactions[$full_uid];

			$editor = id(new PhabricatorCalendarEventEditor())
			->setActor($edit_actor)
			->setActingAsPHID($import->getPHID())
			->setContentSource($content_source)
			->setContinueOnNoEffect(true)
			->setContinueOnMissingFields(true);

			$is_new = !$event->getID();

			$editor->applyTransactions($event, $event_xactions);

			// We're just forcing attendees to the correct values here because
			// transactions intentionally don't let you RSVP for other users. This
			// might need to be turned into a special type of transaction eventually.
			$attendees = $attendee_map[$full_uid];
			$old_map = $event->getInvitees();
			$old_map = mpull($old_map, null, 'getInviteePHID');

			$new_map = array();
			foreach ($attendees as $name => $attendee) {
			$phid = $external_invitees[$name]->getPHID();

			$invitee = idx($old_map, $phid);
			if (!$invitee) {
			$invitee = id(new PhabricatorCalendarEventInvitee())
			->setEventPHID($event->getPHID())
			->setInviteePHID($phid)
			->setInviterPHID($import->getPHID());
			}

			switch ($attendee->getStatus()) {
			case PhutilCalendarUserNode::STATUS_ACCEPTED:
			$status = PhabricatorCalendarEventInvitee::STATUS_ATTENDING;
			break;
			case PhutilCalendarUserNode::STATUS_DECLINED:
			$status = PhabricatorCalendarEventInvitee::STATUS_DECLINED;
			break;
			case PhutilCalendarUserNode::STATUS_INVITED:
			default:
			$status = PhabricatorCalendarEventInvitee::STATUS_INVITED;
			break;
			}
			$invitee->setStatus($status);
			$invitee->save();

			$new_map[$phid] = $invitee;
			}

			foreach ($old_map as $phid => $invitee) {
			if (empty($new_map[$phid])) {
			$invitee->delete();
			}
			}

			$event->attachInvitees($new_map);

			$import->newLogMessage(
			PhabricatorCalendarImportUpdateLogType::LOGTYPE,
			array(
			'new' => $is_new,
			'phid' => $event->getPHID(),
			));
			}

			if (!$update_map) {
			$import->newLogMessage(
			PhabricatorCalendarImportEmptyLogType::LOGTYPE,
			array());
			}

			// Delete any events which are no longer present in the source.
			$updated_events = mpull($update_map, null, 'getPHID');
			$source_events = id(new PhabricatorCalendarEventQuery())
			->setViewer($viewer)
			->withImportSourcePHIDs(array($import->getPHID()))
			->execute();

			$engine = new PhabricatorDestructionEngine();
			foreach ($source_events as $source_event) {
			if (isset($updated_events[$source_event->getPHID()])) {
			// We imported and updated this event, so keep it around.
			continue;
			}

			$import->newLogMessage(
			PhabricatorCalendarImportDeleteLogType::LOGTYPE,
			array(
			'name' => $source_event->getName(),
			));

			$engine->destroyObject($source_event);
			}
			}

			private function getFullNodeUID(PhutilCalendarEventNode $node) {
			$uid = $node->getUID();
			$instance_epoch = $this->getNodeInstanceEpoch($node);
			$full_uid = $uid.'/'.$instance_epoch;

			return $full_uid;
			}

			private function getParentNodeUID(PhutilCalendarEventNode $node) {
			$recurrence_id = $node->getRecurrenceID();

			if (!strlen($recurrence_id)) {
			return null;
			}

			return $node->getUID().'/';
			}

			private function getNodeInstanceEpoch(PhutilCalendarEventNode $node) {
			$instance_iso = $node->getRecurrenceID();
			if (strlen($instance_iso)) {
			$instance_datetime = PhutilCalendarAbsoluteDateTime::newFromISO8601(
			$instance_iso);
			$instance_epoch = $instance_datetime->getEpoch();
			} else {
			$instance_epoch = null;
			}

			return $instance_epoch;
			}

			private function newUpdateTransactions(
			PhabricatorCalendarEvent $event,
			PhutilCalendarEventNode $node) {

			$xactions = array();
			$uid = $node->getUID();

			if (!$event->getID()) {
			$xactions[] = id(new PhabricatorCalendarEventTransaction())
			->setTransactionType(PhabricatorTransactions::TYPE_CREATE)
			->setNewValue(true);
			}

			$name = $node->getName();
			if (!strlen($name)) {
			if (strlen($uid)) {
			$name = pht('Unnamed Event "%s"', $uid);
			} else {
			$name = pht('Unnamed Imported Event');
			}
			}
			$xactions[] = id(new PhabricatorCalendarEventTransaction())
			->setTransactionType(
			PhabricatorCalendarEventNameTransaction::TRANSACTIONTYPE)
			->setNewValue($name);

			$description = $node->getDescription();
			$xactions[] = id(new PhabricatorCalendarEventTransaction())
			->setTransactionType(
			PhabricatorCalendarEventDescriptionTransaction::TRANSACTIONTYPE)
			->setNewValue((string)$description);

			$is_recurring = (bool)$node->getRecurrenceRule();
			$xactions[] = id(new PhabricatorCalendarEventTransaction())
			->setTransactionType(
			PhabricatorCalendarEventRecurringTransaction::TRANSACTIONTYPE)
			->setNewValue($is_recurring);

			return $xactions;
			}

			private function updateEventFromNode(
			PhabricatorUser $actor,
			PhabricatorCalendarEvent $event,
			PhutilCalendarEventNode $node) {

			$instance_epoch = $this->getNodeInstanceEpoch($node);
			$event->setUTCInstanceEpoch($instance_epoch);

			$timezone = $actor->getTimezoneIdentifier();

			// TODO: These should be transactional, but the transaction only accepts
			// epoch timestamps right now.
			$start_datetime = $node->getStartDateTime()
			->setViewerTimezone($timezone);
			$end_datetime = $node->getEndDateTime()
			->setViewerTimezone($timezone);

			$event
			->setStartDateTime($start_datetime)
			->setEndDateTime($end_datetime);

			$event->setIsAllDay((int)$start_datetime->getIsAllDay());

			// TODO: This should be transactional, but the transaction only accepts
			// simple frequency rules right now.
			$rrule = $node->getRecurrenceRule();
			if ($rrule) {
			$event->setRecurrenceRule($rrule);

			$until_datetime = $rrule->getUntil();
			if ($until_datetime) {
			$until_datetime->setViewerTimezone($timezone);
			$event->setUntilDateTime($until_datetime);
			}

			$count = $rrule->getCount();
			$event->setParameter('recurrenceCount', $count);
			}

			return $event;
			}

			public function canDeleteAnyEvents(
			PhabricatorUser $viewer,
			PhabricatorCalendarImport $import) {

			$table = new PhabricatorCalendarEvent();
			$conn = $table->establishConnection('r');

			// Using a CalendarEventQuery here was failing oddly in a way that was
			// difficult to reproduce locally (see T11808). Just check the table
			// directly; this is significantly more efficient anyway.

			$any_event = queryfx_all(
			$conn,
			'SELECT phid FROM %T WHERE importSourcePHID = %s LIMIT 1',
			$table->getTableName(),
			$import->getPHID());

			return (bool)$any_event;
			}

			}

phab/src/applications/calendar/import/PhabricatorCalendarImportEngine.php191b9398a5f6stable

PhabricatorCalendarImportEngine.phpView Options

phab/src/applications/calendar/import/PhabricatorCalendarImportEngine.php
191b9398a5f6stable

PhabricatorCalendarImportEngine.php
View Options