moodle_local_treestudyplan/classes/success.php
2023-08-28 08:51:52 +02:00

105 lines
2.8 KiB
PHP

<?php
// This file is part of the Studyplan plugin for Moodle
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle. If not, see <https://www.gnu.org/licenses/>.
/**
* Webservice return value to describe a single event as successful or not
* @package local_treestudyplan
* @copyright 2023 P.M. Kuipers
* @license https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
namespace local_treestudyplan;
/**
* Describes a webservice result a successful or not with optional message
*/
class success {
/**
* Success (true) or failed (false)
* @var bool
*/
private $success;
/**
* Messsage passed with result
* @var string
*/
private $msg;
/**
* Create new successful result with optional message
* @param string $msg Message to add to result
*/
public static function success($msg = "") : self {
return new self(true, $msg);
}
/**
* Create new failed result with optional message
* @param string $msg Message to add to result
*/
public static function fail($msg = "") : self {
return new self(false, $msg);
}
/**
* Create new succes result
* @param bool $success Whether result is succesful or not
* @param string $msg Message to add to result
*/
public function __construct($success, $msg) {
$this->success = ($success) ? true : false;
$this->msg = $msg;
}
/**
* Describe the result for the webservice model
*/
public static function structure() : \external_description {
return new \external_single_structure([
"success" => new \external_value(PARAM_BOOL, 'operation completed succesfully'),
"msg" => new \external_value(PARAM_TEXT, 'message'),
]);
}
/**
* Make the webservice result model
* @return array Webservice value
*/
public function model() {
return ["success" => $this->success, "msg" => $this->msg];
}
/**
* Get success status of object
*
* @return bool If this success is successful or not
*/
public function successful() {
return $this->success;
}
/**
* Get message
*
* @return string Message
*/
public function msg() {
return $this->msg;
}
}