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

/* -*- 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;
}