MySQL
8.4.3
Source Code Documentation
service_implementation.h
Go to the documentation of this file.
1
/* Copyright (c) 2016, 2024, Oracle and/or its affiliates.
2
3
This program is free software; you can redistribute it and/or modify
4
it under the terms of the GNU General Public License, version 2.0,
5
as published by the Free Software Foundation.
6
7
This program is designed to work with certain software (including
8
but not limited to OpenSSL) that is licensed under separate terms,
9
as designated in a particular file or component or in included license
10
documentation. The authors of MySQL hereby grant you an additional
11
permission to link the program and your derivative works with the
12
separately licensed software that they have either included with
13
the program or referenced in the documentation.
14
15
This program is distributed in the hope that it will be useful,
16
but WITHOUT ANY WARRANTY; without even the implied warranty of
17
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18
GNU General Public License, version 2.0, for more details.
19
20
You should have received a copy of the GNU General Public License
21
along with this program; if not, write to the Free Software
22
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA */
23
24
#ifndef SERVICE_IMPLEMENTATION_H
25
#define SERVICE_IMPLEMENTATION_H
26
27
#include "
service.h
"
28
29
/**
30
@file include/mysql/components/service_implementation.h
31
Specifies macros to define Service Implementations.
32
*/
33
34
/**
35
Reference to the name of the service implementation variable
36
37
@ref BEGIN_SERVICE_IMPLEMENTATION defines a local variable of
38
the structure type for the service (see @ref SERVICE_TYPE).
39
The variable is then used by the @ref PROVIDES_SERVICE macro to
40
construct the list of service provided by the component.
41
This macro allows one to use @ref BEGIN_SERVICE_IMPLEMENTATION ,
42
@ref DEFINE_METHOD and @ref END_SERVICE_IMPLEMENTATION macros to build
43
a service definition structure and variable to be used outside of the
44
component definition context.
45
46
@param component Name of the implementation of the service.
47
Usually a component name.
48
@param service Name of the service to create the implementation for.
49
50
*/
51
#define SERVICE_IMPLEMENTATION(component, service) imp_##component##_##service
52
53
/**
54
Declares a Service Implementation. It builds standard implementation
55
info structure. Only a series of pointers to methods the Service
56
Implementation implements as respective Service methods are expected to be
57
used after this macro and before the END_SERVICE_IMPLEMENTATION counterpart.
58
59
@param component Name of the Component to create implementation in.
60
@param service Name of the Service to create implementation for.
61
*/
62
#define BEGIN_SERVICE_IMPLEMENTATION(component, service) \
63
SERVICE_TYPE(service) SERVICE_IMPLEMENTATION(component, service) = {
64
/**
65
A macro to end the last declaration of a Service Implementation.
66
*/
67
#define END_SERVICE_IMPLEMENTATION() }
68
69
/**
70
A macro to ensure method implementation has required properties, that is it
71
does not throw exceptions and is static. This macro should be used with
72
exactly the same arguments as DECLARE_METHOD.
73
74
@param retval Type of return value. It cannot contain comma characters, but
75
as only simple structures are possible, this shouldn't be a problem.
76
@param name Method name.
77
@param args a list of arguments in parenthesis.
78
*/
79
#define DEFINE_METHOD(retval, name, args) retval name args noexcept
80
81
/**
82
A short macro to define method that returns bool, which is the most common
83
case.
84
85
@param name Method name.
86
@param args a list of arguments in parenthesis.
87
*/
88
#define DEFINE_BOOL_METHOD(name, args) \
89
DEFINE_METHOD(mysql_service_status_t, name, args)
90
91
#endif
/* SERVICE_IMPLEMENTATION_H */
service.h
include
mysql
components
service_implementation.h
Generated by
1.9.2