PhabricatorContentSource.php

<?php

final class PhabricatorContentSource extends Phobject {

  const SOURCE_UNKNOWN  = 'unknown';
  const SOURCE_WEB      = 'web';
  const SOURCE_EMAIL    = 'email';
  const SOURCE_CONDUIT  = 'conduit';
  const SOURCE_MOBILE   = 'mobile';
  const SOURCE_TABLET   = 'tablet';
  const SOURCE_FAX      = 'fax';
  const SOURCE_CONSOLE  = 'console';
  const SOURCE_HERALD   = 'herald';
  const SOURCE_LEGACY   = 'legacy';
  const SOURCE_DAEMON   = 'daemon';
  const SOURCE_LIPSUM   = 'lipsum';
  const SOURCE_PHORTUNE = 'phortune';
  const SOURCE_BULK = 'bulk';

  private $source;
  private $params = array();

  private function __construct() {
    // <empty>
  }

  public static function newForSource($source, array $params) {
    $obj = new PhabricatorContentSource();
    $obj->source = $source;
    $obj->params = $params;

    return $obj;
  }

  public static function newFromSerialized($serialized) {
    $dict = json_decode($serialized, true);
    if (!is_array($dict)) {
      $dict = array();
    }

    $obj = new PhabricatorContentSource();
    $obj->source = idx($dict, 'source', self::SOURCE_UNKNOWN);
    $obj->params = idx($dict, 'params', array());

    return $obj;
  }

  public static function newConsoleSource() {
    return self::newForSource(
      self::SOURCE_CONSOLE,
      array());
  }

  public static function newFromRequest(AphrontRequest $request) {
    return self::newForSource(
      self::SOURCE_WEB,
      array());
  }

  public static function newFromConduitRequest(ConduitAPIRequest $request) {
    return self::newForSource(
      self::SOURCE_CONDUIT,
      array());
  }

  public static function getSourceNameMap() {
    return array(
      self::SOURCE_WEB      => pht('Web'),
      self::SOURCE_EMAIL    => pht('Email'),
      self::SOURCE_CONDUIT  => pht('Conduit'),
      self::SOURCE_MOBILE   => pht('Mobile'),
      self::SOURCE_TABLET   => pht('Tablet'),
      self::SOURCE_FAX      => pht('Fax'),
      self::SOURCE_CONSOLE  => pht('Console'),
      self::SOURCE_LEGACY   => pht('Legacy'),
      self::SOURCE_HERALD   => pht('Herald'),
      self::SOURCE_DAEMON   => pht('Daemons'),
      self::SOURCE_LIPSUM   => pht('Lipsum'),
      self::SOURCE_UNKNOWN  => pht('Old World'),
      self::SOURCE_PHORTUNE => pht('Phortune'),
      self::SOURCE_BULK => pht('Bulk Edit'),
    );
  }

  public function serialize() {
    return json_encode(array(
      'source' => $this->getSource(),
      'params' => $this->getParams(),
    ));
  }

  public function getSource() {
    return $this->source;
  }

  public function getParams() {
    return $this->params;
  }

  public function getParam($key, $default = null) {
    return idx($this->params, $key, $default);
  }

}