init

Telegram/ThirdParty/nimf/libnimf/nimf-service.c

@@ -0,0 +1,172 @@
+/* -*- Mode: C; indent-tabs-mode: nil; c-basic-offset: 2; tab-width: 2 -*- */
+/*
+ * nimf-service.c
+ * This file is part of Nimf.
+ *
+ * Copyright (C) 2017-2019 Hodong Kim <cogniti@gmail.com>
+ *
+ * Nimf is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Nimf 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 Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program;  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include "nimf-service.h"
+
+G_DEFINE_ABSTRACT_TYPE (NimfService, nimf_service, G_TYPE_OBJECT);
+
+enum
+{
+  PROP_0,
+  PROP_SERVER
+};
+
+static void
+nimf_service_init (NimfService *service)
+{
+  g_debug (G_STRLOC ": %s", G_STRFUNC);
+}
+
+static void
+nimf_service_finalize (GObject *object)
+{
+  g_debug (G_STRLOC ": %s", G_STRFUNC);
+
+  G_OBJECT_CLASS (nimf_service_parent_class)->finalize (object);
+}
+
+/**
+ * nimf_service_get_id:
+ * @service: a #NimfService
+ *
+ * Gets the ID of a @service.
+ *
+ * Returns: the ID of a service
+ */
+const gchar *
+nimf_service_get_id (NimfService *service)
+{
+  g_debug (G_STRLOC ": %s", G_STRFUNC);
+
+  NimfServiceClass *class = NIMF_SERVICE_GET_CLASS (service);
+
+  if (class->get_id (service))
+    return class->get_id (service);
+  else
+    g_error (G_STRLOC ": %s: You should implement your_service_get_id ()",
+             G_STRFUNC);
+
+  return NULL;
+}
+
+/**
+ * nimf_service_start:
+ * @service: a #NimfService
+ *
+ * Starts @service.
+ *
+ * Returns: %TRUE if a service is started.
+ */
+gboolean
+nimf_service_start (NimfService *service)
+{
+  g_debug (G_STRLOC ": %s", G_STRFUNC);
+
+  NimfServiceClass *class = NIMF_SERVICE_GET_CLASS (service);
+
+  if (class->start)
+    return class->start (service);
+  else
+    return FALSE;
+}
+
+/**
+ * nimf_service_stop:
+ * @service: a #NimfService
+ *
+ * Stops a @service.
+ */
+void
+nimf_service_stop (NimfService *service)
+{
+  g_debug (G_STRLOC ": %s", G_STRFUNC);
+
+  NimfServiceClass *class = NIMF_SERVICE_GET_CLASS (service);
+
+  if (class->stop)
+    class->stop (service);
+}
+
+/**
+ * nimf_service_is_active:
+ * @service: a #NimfService
+ *
+ * Returns: %TRUE if a service is active
+ */
+gboolean
+nimf_service_is_active (NimfService *service)
+{
+  g_debug (G_STRLOC ": %s", G_STRFUNC);
+
+  NimfServiceClass *class = NIMF_SERVICE_GET_CLASS (service);
+
+  if (class->is_active (service))
+    return class->is_active (service);
+  else
+    g_error (G_STRLOC ": %s: You should implement your_service_is_active ()",
+             G_STRFUNC);
+
+  return FALSE;
+}
+
+/**
+ * nimf_service_change_engine_by_id:
+ * @service: a #NimfService
+ * @engine_id: engine id
+ */
+void
+nimf_service_change_engine_by_id (NimfService *service,
+                                  const gchar *engine_id)
+{
+  g_debug (G_STRLOC ": %s", G_STRFUNC);
+
+  NimfServiceClass *class = NIMF_SERVICE_GET_CLASS (service);
+
+  if (class->change_engine_by_id)
+    class->change_engine_by_id (service, engine_id);
+}
+
+/**
+ * nimf_service_change_engine:
+ * @service: a #NimfService
+ * @engine_id: engine id
+ * @method_id: method id
+ */
+void
+nimf_service_change_engine (NimfService *service,
+                            const gchar *engine_id,
+                            const gchar *method_id)
+{
+  g_debug (G_STRLOC ": %s", G_STRFUNC);
+
+  NimfServiceClass *class = NIMF_SERVICE_GET_CLASS (service);
+
+  if (class->change_engine_by_id)
+    class->change_engine (service, engine_id, method_id);
+}
+
+static void
+nimf_service_class_init (NimfServiceClass *class)
+{
+  g_debug (G_STRLOC ": %s", G_STRFUNC);
+
+  G_OBJECT_CLASS (class)->finalize = nimf_service_finalize;
+}