Move MatrixAPI to an interface
This commit is contained in:
251
src/matrix-http-api.c
Normal file
251
src/matrix-http-api.c
Normal file
@@ -0,0 +1,251 @@
|
||||
/*
|
||||
* This file is part of matrix-glib-sdk
|
||||
*
|
||||
* matrix-glib-sdk 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.
|
||||
*
|
||||
* matrix-glib-sdk 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 matrix-glib-sdk. If not, see
|
||||
* <http://www.gnu.org/licenses/>.
|
||||
*/
|
||||
|
||||
#include "matrix-http-api.h"
|
||||
#include "matrix-api.h"
|
||||
|
||||
#include <string.h>
|
||||
#include <libsoup/soup.h>
|
||||
|
||||
/**
|
||||
* SECTION:matrix-http-api
|
||||
* @short_description: Low level API calls to communicate with a
|
||||
* Matrix.org server via HTTP
|
||||
* @title: MatrixHTTPAPI
|
||||
* @stability: Unstable
|
||||
* @include: matrix-glib/matrix.h
|
||||
*
|
||||
* This is a class for low level communication with a Matrix.org
|
||||
* server via HTTP.
|
||||
*/
|
||||
|
||||
/**
|
||||
* MatrixHTTPAPI:
|
||||
*
|
||||
* The MatrixHTTPAPI object’s instance definition.
|
||||
*/
|
||||
|
||||
/**
|
||||
* MatrixHTTPAPIClass:
|
||||
* @parent_class: the parent class structure (#GObjectClass)
|
||||
*
|
||||
* The MatrixHTTPAPI object’s class definition.
|
||||
*/
|
||||
|
||||
#define API_ENDPOINT "/_matrix/client/api/v1"
|
||||
|
||||
typedef struct _MatrixHTTPAPIPrivate {
|
||||
SoupSession *soup_session;
|
||||
guint txn_id;
|
||||
gchar *url;
|
||||
gchar *token;
|
||||
gboolean validate_certificate;
|
||||
} MatrixHTTPAPIPrivate;
|
||||
|
||||
enum {
|
||||
PROP_VALIDATE_CERTIFICATE = 1,
|
||||
PROP_URL,
|
||||
N_PROPERTIES
|
||||
};
|
||||
|
||||
GParamSpec *obj_properties[N_PROPERTIES] = {NULL,};
|
||||
|
||||
static void matrix_http_api_matrix_api_init(MatrixAPIInterface *iface);
|
||||
|
||||
G_DEFINE_TYPE_WITH_CODE(MatrixHTTPAPI, matrix_http_api, G_TYPE_OBJECT,
|
||||
G_ADD_PRIVATE(MatrixHTTPAPI)
|
||||
G_IMPLEMENT_INTERFACE(MATRIX_TYPE_API, matrix_http_api_matrix_api_init));
|
||||
|
||||
static void
|
||||
matrix_http_api_matrix_api_init(MatrixAPIInterface *iface)
|
||||
{}
|
||||
|
||||
static void
|
||||
matrix_http_api_finalize(GObject *gobject)
|
||||
{
|
||||
g_signal_handlers_destroy(gobject);
|
||||
G_OBJECT_CLASS(matrix_http_api_parent_class)->finalize(gobject);
|
||||
}
|
||||
|
||||
static void
|
||||
matrix_http_api_set_property(GObject *gobject,
|
||||
guint prop_id,
|
||||
const GValue *value,
|
||||
GParamSpec *pspec)
|
||||
{
|
||||
MatrixHTTPAPI *api = MATRIX_HTTP_API(gobject);
|
||||
MatrixHTTPAPIPrivate *priv = matrix_http_api_get_instance_private(api);
|
||||
|
||||
switch (prop_id) {
|
||||
case PROP_VALIDATE_CERTIFICATE:
|
||||
priv->validate_certificate = g_value_get_boolean(value);
|
||||
|
||||
break;
|
||||
|
||||
case PROP_URL:
|
||||
{
|
||||
const gchar *base_url;
|
||||
gchar *last_occurence;
|
||||
|
||||
base_url = g_value_get_string(value);
|
||||
|
||||
if (!g_str_is_ascii(base_url)) {
|
||||
g_warning("URL specified (%s) is not ASCII", base_url);
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
last_occurence = g_strrstr(base_url, API_ENDPOINT);
|
||||
|
||||
if ((g_strcmp0(last_occurence, API_ENDPOINT) == 0) ||
|
||||
(g_strcmp0(last_occurence, API_ENDPOINT"/") == 0)) {
|
||||
priv->url = g_strdup(base_url);
|
||||
} else {
|
||||
priv->url = g_strdup_printf(
|
||||
"%s%s%s",
|
||||
base_url,
|
||||
(base_url[strlen(base_url) - 1] == '/') ? "" : "/",
|
||||
API_ENDPOINT);
|
||||
}
|
||||
|
||||
break;
|
||||
}
|
||||
|
||||
default:
|
||||
G_OBJECT_WARN_INVALID_PROPERTY_ID(gobject, prop_id, pspec);
|
||||
}
|
||||
}
|
||||
|
||||
static void
|
||||
matrix_http_api_get_property(GObject *gobject,
|
||||
guint prop_id,
|
||||
GValue *value,
|
||||
GParamSpec *pspec)
|
||||
{
|
||||
MatrixHTTPAPI *api = MATRIX_HTTP_API(gobject);
|
||||
MatrixHTTPAPIPrivate *priv = matrix_http_api_get_instance_private(api);
|
||||
|
||||
switch (prop_id) {
|
||||
case PROP_VALIDATE_CERTIFICATE:
|
||||
g_value_set_boolean(value, priv->validate_certificate);
|
||||
|
||||
break;
|
||||
|
||||
case PROP_URL:
|
||||
g_value_set_string(value, priv->url);
|
||||
|
||||
break;
|
||||
default:
|
||||
G_OBJECT_WARN_INVALID_PROPERTY_ID(gobject, prop_id, pspec);
|
||||
}
|
||||
}
|
||||
|
||||
static void
|
||||
matrix_http_api_class_init(MatrixHTTPAPIClass *klass)
|
||||
{
|
||||
GObjectClass *gobject_class = G_OBJECT_CLASS(klass);
|
||||
|
||||
gobject_class->set_property = matrix_http_api_set_property;
|
||||
gobject_class->get_property = matrix_http_api_get_property;
|
||||
gobject_class->finalize = matrix_http_api_finalize;
|
||||
|
||||
/**
|
||||
* MatrixHTTPAPI:validate-certificate:
|
||||
*
|
||||
* Set to %FALSE if you don’t want the SSL/TLS certificates to be
|
||||
* validated.
|
||||
*/
|
||||
obj_properties[PROP_VALIDATE_CERTIFICATE] = g_param_spec_boolean(
|
||||
"validate-certificate",
|
||||
"Validate certificate",
|
||||
"TRUE if server certificates should be validated",
|
||||
TRUE,
|
||||
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
|
||||
|
||||
/**
|
||||
* MatrixHTTPAPI:url:
|
||||
*
|
||||
* The base URL to use for communication with the Matrix.org
|
||||
* server.
|
||||
*/
|
||||
obj_properties[PROP_URL] = g_param_spec_string(
|
||||
"url", "Server URL",
|
||||
"Matrix.org home server to connect to.",
|
||||
NULL,
|
||||
G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
|
||||
|
||||
g_object_class_install_properties(gobject_class,
|
||||
N_PROPERTIES,
|
||||
obj_properties);
|
||||
}
|
||||
|
||||
static void
|
||||
matrix_http_api_init(MatrixHTTPAPI *api)
|
||||
{
|
||||
MatrixHTTPAPIPrivate *priv = matrix_http_api_get_instance_private(api);
|
||||
|
||||
priv->txn_id = 0;
|
||||
priv->url = NULL;
|
||||
priv->token = NULL;
|
||||
priv->validate_certificate = TRUE;
|
||||
priv->soup_session = soup_session_new_with_options(
|
||||
SOUP_SESSION_ADD_FEATURE_BY_TYPE, SOUP_TYPE_CONTENT_SNIFFER,
|
||||
NULL);
|
||||
}
|
||||
|
||||
MatrixHTTPAPI *
|
||||
matrix_http_api_new(const gchar *base_url, const gchar *token)
|
||||
{
|
||||
return g_object_new(MATRIX_TYPE_HTTP_API,
|
||||
"base-url", base_url,
|
||||
"token", token,
|
||||
NULL);
|
||||
}
|
||||
|
||||
/**
|
||||
* matrix_http_api_set_validate_certificate:
|
||||
* @api: a #MatrixHTTPAPI implementation
|
||||
* @validate_certificate: %TRUE if server certificates should be
|
||||
* validated
|
||||
*
|
||||
* Sets if server certificates should be validated.
|
||||
*/
|
||||
void
|
||||
matrix_http_api_set_validate_certificate(MatrixHTTPAPI *api,
|
||||
gboolean validate_certificate)
|
||||
{
|
||||
MatrixHTTPAPIPrivate *priv = matrix_http_api_get_instance_private(api);
|
||||
|
||||
priv->validate_certificate = validate_certificate;
|
||||
}
|
||||
|
||||
/**
|
||||
* matrix_http_api_get_validate_certificate:
|
||||
* @api: a #MatrixHTTPAPI implementation
|
||||
*
|
||||
* Gets the value set by matrix_http_api_set_validate_certificate()
|
||||
*
|
||||
* Returns: %TRUE if the server certificates should be validated
|
||||
*/
|
||||
gboolean
|
||||
matrix_http_api_get_validate_certificate(MatrixHTTPAPI *api)
|
||||
{
|
||||
MatrixHTTPAPIPrivate *priv = matrix_http_api_get_instance_private(api);
|
||||
|
||||
return priv->validate_certificate;
|
||||
}
|
||||
Reference in New Issue
Block a user