<?php
+/**
+ * @copyright Copyright (C) 2010-2022, the Friendica project
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ */
namespace Friendica\Capabilities;
+use Friendica\Network\HTTPException;
+use Psr\Http\Message\ResponseInterface;
+
/**
* This interface provides the capability to handle requests from clients and returns the desired outcome
*/
interface ICanHandleRequests
{
/**
- * Initialization method common to both content() and post()
- *
- * Extend this method if you need to do any shared processing before both
- * content() or post()
- */
- public function init();
-
- /**
- * Module GET method to display raw content from technical endpoints
+ * @param array $request The $_REQUEST content (including content from the PHP input stream)
*
- * Extend this method if the module is supposed to return communication data,
- * e.g. from protocol implementations.
- */
- public function rawContent();
-
- /**
- * Module GET method to display any content
- *
- * Extend this method if the module is supposed to return any display
- * through a GET request. It can be an HTML page through templating or a
- * XML feed or a JSON output.
- */
- public function content(): string;
-
- /**
- * Module DELETE method to process submitted data
+ * @return ResponseInterface responding to the request handling
*
- * Extend this method if the module is supposed to process DELETE requests.
- * Doesn't display any content
+ * @throws HTTPException\InternalServerErrorException
*/
- public function delete();
-
- /**
- * Module PATCH method to process submitted data
- *
- * Extend this method if the module is supposed to process PATCH requests.
- * Doesn't display any content
- */
- public function patch();
-
- /**
- * Module POST method to process submitted data
- *
- * Extend this method if the module is supposed to process POST requests.
- * Doesn't display any content
- */
- public function post();
-
- /**
- * Module PUT method to process submitted data
- *
- * Extend this method if the module is supposed to process PUT requests.
- * Doesn't display any content
- */
- public function put();
-
- public function getClassName(): string;
+ public function run(array $request = []): ResponseInterface;
}