Deprecate hooks, emitter and Symfony dispatcher mechanisms

Signed-off-by: Christoph Wurst <christoph@winzerhof-wurst.at>

5 files changed, 13 insertions, 1 deletions

diff --git a/lib/private/Hooks/BasicEmitter.php b/lib/private/Hooks/BasicEmitter.php
index 529f3724d32..37c38b4be1d 100644
--- a/lib/private/Hooks/BasicEmitter.php
+++ b/lib/private/Hooks/BasicEmitter.php
@@ -23,6 +23,9 @@
 
 namespace OC\Hooks;
 
+/**
+ * @deprecated 18.0.0 use \OCP\EventDispatcher\IEventDispatcher
+ */
 abstract class BasicEmitter implements Emitter {
 	use EmitterTrait;
 }
diff --git a/lib/private/Hooks/Emitter.php b/lib/private/Hooks/Emitter.php
index fbe1a8eaf1f..65c99f2b94d 100644
--- a/lib/private/Hooks/Emitter.php
+++ b/lib/private/Hooks/Emitter.php
@@ -30,6 +30,7 @@ namespace OC\Hooks;
  * interface for all classes that are able to emit events
  *
  * @package OC\Hooks
+ * @deprecated 18.0.0 use events and the \OCP\EventDispatcher\IEventDispatcher service
  */
 interface Emitter {
 	/**
diff --git a/lib/private/Hooks/PublicEmitter.php b/lib/private/Hooks/PublicEmitter.php
index 4101fd12349..abb4dedd667 100644
--- a/lib/private/Hooks/PublicEmitter.php
+++ b/lib/private/Hooks/PublicEmitter.php
@@ -24,6 +24,9 @@
 
 namespace OC\Hooks;
 
+/**
+ * @deprecated 18.0.0 use events and the \OCP\EventDispatcher\IEventDispatcher service
+ */
 class PublicEmitter extends BasicEmitter {
 	/**
 	 * @param string $scope
diff --git a/lib/private/Server.php b/lib/private/Server.php
index dcac72369e4..7fa01358afe 100644
--- a/lib/private/Server.php
+++ b/lib/private/Server.php
@@ -1848,6 +1848,7 @@ class Server extends ServerContainer implements IServerContainer {
 	 *
 	 * @return EventDispatcherInterface
 	 * @since 8.2.0
+	 * @deprecated 18.0.0 use \OCP\EventDispatcher\IEventDispatcher
 	 */
 	public function getEventDispatcher() {
 		return $this->query(\OC\EventDispatcher\SymfonyAdapter::class);
diff --git a/lib/private/legacy/hook.php b/lib/private/legacy/hook.php
index 0d413a11de7..78060d76e0d 100644
--- a/lib/private/legacy/hook.php
+++ b/lib/private/legacy/hook.php
@@ -28,7 +28,11 @@
  * along with this program. If not, see <http://www.gnu.org/licenses/>
  *
  */
-class OC_Hook{
+
+/**
+ * @deprecated 18.0.0 use events and the \OCP\EventDispatcher\IEventDispatcher service
+ */
+class OC_Hook {
 	public static $thrownExceptions = [];
 
 	static private $registered = array();