DeploynautAPI.php

<?php

/**
 * Class DeploynautAPI
 *
 * Entry point for the deploynaut API
 *
 * /naut/api/projectname/
 * /naut/api/projectname/environmentname
 *
 * @todo It might be good to break this out to a controller chain so that
 * "/naut/api/projectname/environmentname" controller chain becomes
 * DeploynautAPI > APIProject > APIEnvironment
 *
 */
class DeploynautAPI extends APINoun {

	/**
	 * Default URL handlers - (Action)/(ID)//(OtherID)
	 *
	 * @var array
	 */
	private static $url_handlers = array(
		'' => 'listProjects',
		'$Project//fetch' => 'project',
		'$Project/$Environment!' => 'environment',
		'$Project/' => 'project',
	);

	/**
	 * @var array
	 */
	public static $allowed_actions = array(
		'project',
		'environment',
		'listProjects'
	);

	/**
	 * @var string
	 */
	protected $link = 'deploynaut/api';

	/**
	 * @param \SS_HTTPRequest $request
	 * @return \SS_HTTPResponse
	 */
	public function listProjects(\SS_HTTPRequest $request) {
		$response = array(
			'href' => Director::absoluteURL($this->Link()),
			'projects' => array(),
		);

		if($request->httpMethod() != 'GET') {
			return $this->message('API not found', 404);
		}

		foreach(DNProject::get() as $item) {
			if($item->canView($this->getMember())) {
				$response['projects'][] = array(
					"name" => $item->Name,
					"href" => Director::absoluteURL($item->APILink("")),
				);
			}
		}

		return $this->getAPIResponse($response);
	}

	/**
	 * Controller Action
	 *
	 * @param \SS_HTTPRequest $request
	 * @return APIProject
	 */
	public function project(\SS_HTTPRequest $request) {
		$project = $this->getProject();
		if(!$project) {
			return $this->project404Response();
		}
		return new APIProject($this, $project);
	}

	/**
	 * Controller Action
	 *
	 * @param \SS_HTTPRequest $request
	 * @return APIEnvironment
	 */
	public function environment(\SS_HTTPRequest $request) {
		$project = $this->getProject();
		if(!$project) {
			return $this->project404Response();
		}

		$environment = $this->getEnvironment();
		if(!$environment) {
			return $this->environment404Response();
		}
		return new APIEnvironment($this, $environment);
	}

	/**
	 * @return SS_HTTPResponse
	 */
	protected function project404Response() {
		$projectName = Convert::raw2xml($this->getRequest()->latestParam('Project'));
		return new SS_HTTPResponse('Project "' . $projectName . '" not found.', 404);
	}

	/**
	 * @return SS_HTTPResponse
	 */
	protected function environment404Response() {
		$envName = Convert::raw2xml($this->getRequest()->latestParam('Environment'));
		return new SS_HTTPResponse('Environment "' . $envName . '" not found.', 404);
	}

	/**
	 * Get project from URL
	 *
	 * @return DNProject
	 */
	protected function getProject() {
		$projectName = $this->getRequest()->param('Project');
		return DNProject::get()->filter('Name', $projectName)->first();
	}

	/**
	 * Get environment from URL
	 *
	 * @return DNEnvironment
	 */
	protected function getEnvironment() {
		$projectName = $this->getRequest()->param('Project');
		$project = DNProject::get()->filter('Name', $projectName)->first();
		$environmentName = $this->getRequest()->param('Environment');
		return $project->Environments()->filter('Name', $environmentName)->first();
	}

	/**
	 * @return string
	 */
	public function Link() {
		return 'naut/api';
	}
}