| Flutter Linux Embedder |

fl_method_response.h
Go to the documentation of this file.
1 // Copyright 2013 The Flutter Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
4
5 #ifndef FLUTTER_SHELL_PLATFORM_LINUX_PUBLIC_FLUTTER_LINUX_FL_METHOD_RESPONSE_H_
6 #define FLUTTER_SHELL_PLATFORM_LINUX_PUBLIC_FLUTTER_LINUX_FL_METHOD_RESPONSE_H_
7
8 #if !defined(__FLUTTER_LINUX_INSIDE__) && !defined(FLUTTER_LINUX_COMPILATION)
9 #error "Only <flutter_linux/flutter_linux.h> can be included directly."
10 #endif
11
12 #include <glib-object.h>
13 #include <gmodule.h>
14
15 #include "fl_value.h"
16
17 G_BEGIN_DECLS
18
19 /**
20 * FlMethodResponseError:
21 * @FL_METHOD_RESPONSE_ERROR_FAILED: Call failed due to an unspecified error.
22 * @FL_METHOD_RESPONSE_ERROR_REMOTE_ERROR: An error was returned by the other
23 * side of the channel.
24 * @FL_METHOD_RESPONSE_ERROR_NOT_IMPLEMENTED: The requested method is not
25 * implemented.
26 *
27 * Errors set by `fl_method_response_get_result` when the method call response
28 * is not #FlMethodSuccessResponse.
29 */
30 #define FL_METHOD_RESPONSE_ERROR fl_method_response_error_quark()
31
32 typedef enum {
33 FL_METHOD_RESPONSE_ERROR_FAILED,
34 FL_METHOD_RESPONSE_ERROR_REMOTE_ERROR,
35 FL_METHOD_RESPONSE_ERROR_NOT_IMPLEMENTED,
36 } FlMethodResponseError;
37
38 G_MODULE_EXPORT
39 GQuark fl_method_response_error_quark(void) G_GNUC_CONST;
40
41 G_MODULE_EXPORT
42 G_DECLARE_DERIVABLE_TYPE(FlMethodResponse,
43 fl_method_response,
44 FL,
45 METHOD_RESPONSE,
46 GObject)
47
48 struct _FlMethodResponseClass {
49 GObjectClass parent_class;
50 };
51
52 G_MODULE_EXPORT
53 G_DECLARE_FINAL_TYPE(FlMethodSuccessResponse,
54 fl_method_success_response,
55 FL,
56 METHOD_SUCCESS_RESPONSE,
57 FlMethodResponse)
58
59 G_MODULE_EXPORT
60 G_DECLARE_FINAL_TYPE(FlMethodErrorResponse,
61 fl_method_error_response,
62 FL,
63 METHOD_ERROR_RESPONSE,
64 FlMethodResponse)
65
66 G_MODULE_EXPORT
67 G_DECLARE_FINAL_TYPE(FlMethodNotImplementedResponse,
68 fl_method_not_implemented_response,
69 FL,
70 METHOD_NOT_IMPLEMENTED_RESPONSE,
71 FlMethodResponse)
72
73 /**
74 * FlMethodResponse:
75 *
76 * #FlMethodResponse contains the information returned when an #FlMethodChannel
77 * method call returns. If you expect the method call to be successful use
78 * fl_method_response_get_result(). If you want to handle error cases then you
79 * should use code like:
80 *
81 * |[<!-- language="C" -->
82 * if (FL_IS_METHOD_SUCCESS_RESPONSE (response)) {
83 * FlValue *result =
84 * fl_method_success_response_get_result(
85 * FL_METHOD_SUCCESS_RESPONSE (response));
86 * handle_result (result);
87 * } else if (FL_IS_METHOD_ERROR_RESPONSE (response)) {
88 * FlMethodErrorResponse *error_response =
89 * FL_METHOD_ERROR_RESPONSE (response);
90 * handle_error (fl_method_error_response_get_code (error_response),
91 * fl_method_error_response_get_message (error_response),
92 * fl_method_error_response_get_details (error_response));
93 * }
94 * else if (FL_IS_METHOD_NOT_IMPLEMENTED_RESPONSE (response)) {
95 * handle_not_implemented ();
96 * }
97 * }
98 * ]|
99 */
100
101 /**
102 * FlMethodSuccessResponse:
103 *
104 * #FlMethodSuccessResponse is the #FlMethodResponse returned when a method call
105 * has successfully completed. The result of the method call is obtained using
106 * `fl_method_success_response_get_result`.
107 */
108
109 /**
110 * FlMethodErrorResponse:
111 *
112 * #FlMethodErrorResponse is the #FlMethodResponse returned when a method call
113 * results in an error. The error details are obtained using
114 * `fl_method_error_response_get_code`, `fl_method_error_response_get_message`
115 * and `fl_method_error_response_get_details`.
116 */
117
118 /**
119 * FlMethodNotImplementedResponse:
120 *
121 * #FlMethodNotImplementedResponse is the #FlMethodResponse returned when a
122 * method call is not implemented.
123 */
124
125 /**
126 * fl_method_response_get_result:
127 * @response: an #FlMethodResponse.
128 * @error: (allow-none): #GError location to store the error occurring, or %NULL
129 * to ignore.
130 *
131 * Gets the result of a method call, or an error if the response wasn't
132 * successful.
133 *
134 * Returns: an #FlValue or %NULL on error.
135 */
136 FlValue* fl_method_response_get_result(FlMethodResponse* response,
137 GError** error);
138
139 /**
140 * fl_method_success_response_new:
141 * @result: (allow-none): the #FlValue returned by the method call or %NULL.
142 *
143 * Creates a response to a method call when that method has successfully
144 * completed.
145 *
146 * Returns: a new #FlMethodResponse.
147 */
148 FlMethodSuccessResponse* fl_method_success_response_new(FlValue* result);
149
150 /**
151 * fl_method_success_response_get_result:
152 * @response: an #FlMethodSuccessResponse.
153 *
154 * Gets the result of the method call.
155 *
156 * Returns: an #FlValue.
157 */
158 FlValue* fl_method_success_response_get_result(
159 FlMethodSuccessResponse* response);
160
161 /**
162 * fl_method_error_response_new:
163 * @result: an #FlValue.
164 * @code: an error code.
165 * @message: (allow-none): an error message.
166 * @details: (allow-none): error details.
167 *
168 * Creates a response to a method call when that method has returned an error.
169 *
170 * Returns: a new #FlMethodErrorResponse.
171 */
172 FlMethodErrorResponse* fl_method_error_response_new(const gchar* code,
173 const gchar* message,
174 FlValue* details);
175
176 /**
177 * fl_method_error_response_get_code:
178 * @response: an #FlMethodErrorResponse.
179 *
180 * Gets the error code reported.
181 *
182 * Returns: an error code.
183 */
184 const gchar* fl_method_error_response_get_code(FlMethodErrorResponse* response);
185
186 /**
187 * fl_method_error_response_get_message:
188 * @response: an #FlMethodErrorResponse.
189 *
190 * Gets the error message reported.
191 *
192 * Returns: an error message or %NULL if no error message provided.
193 */
194 const gchar* fl_method_error_response_get_message(
195 FlMethodErrorResponse* response);
196
197 /**
198 * fl_method_error_response_get_details:
199 * @response: an #FlMethodErrorResponse.
200 *
201 * Gets the details provided with this error.
202 *
203 * Returns: an #FlValue or %NULL if no details provided.
204 */
205 FlValue* fl_method_error_response_get_details(FlMethodErrorResponse* response);
206
207 /**
208 * fl_method_not_implemented_response_new:
209 *
210 * Creates a response to a method call when that method does not exist.
211 *
212 * Returns: a new #FlMethodNotImplementedResponse.
213 */
214 FlMethodNotImplementedResponse* fl_method_not_implemented_response_new();
215
216 G_END_DECLS
217
218 #endif // FLUTTER_SHELL_PLATFORM_LINUX_PUBLIC_FLUTTER_LINUX_FL_METHOD_RESPONSE_H_
fl_method_error_response
G_MODULE_EXPORT fl_method_error_response
Definition: fl_method_response.h:61
fl_method_error_response_new
G_MODULE_EXPORT FlMethodErrorResponse * fl_method_error_response_new(const gchar *code, const gchar *message, FlValue *details)
Definition: fl_method_response.cc:144
fl_method_not_implemented_response_new
G_MODULE_EXPORT FlMethodNotImplementedResponse * fl_method_not_implemented_response_new()
Definition: fl_method_response.cc:179
FL_METHOD_RESPONSE_ERROR_REMOTE_ERROR
@ FL_METHOD_RESPONSE_ERROR_REMOTE_ERROR
Definition: fl_method_response.h:34
FL_METHOD_RESPONSE_ERROR_NOT_IMPLEMENTED
@ FL_METHOD_RESPONSE_ERROR_NOT_IMPLEMENTED
Definition: fl_method_response.h:35
G_DECLARE_FINAL_TYPE
G_MODULE_EXPORT G_DECLARE_FINAL_TYPE(FlMethodSuccessResponse, fl_method_success_response, FL, METHOD_SUCCESS_RESPONSE, FlMethodResponse) G_MODULE_EXPORT G_DECLARE_FINAL_TYPE(FlMethodErrorResponse
FlValue
typedefG_BEGIN_DECLS struct _FlValue FlValue
Definition: fl_value.h:42
FL
G_MODULE_EXPORT FL
Definition: fl_method_response.h:62
fl_method_success_response_new
FlMethodSuccessResponse * fl_method_success_response_new(FlValue *result)
Definition: fl_method_response.cc:126
fl_method_success_response_get_result
FlValue * fl_method_success_response_get_result(FlMethodSuccessResponse *response)
Definition: fl_method_response.cc:138
fl_method_response_get_result
G_MODULE_EXPORT FlValue * fl_method_response_get_result(FlMethodResponse *self, GError **error)
Definition: fl_method_response.cc:82
fl_method_error_response_get_message
const G_MODULE_EXPORT gchar * fl_method_error_response_get_message(FlMethodErrorResponse *self)
Definition: fl_method_response.cc:166
FL_METHOD_RESPONSE_ERROR_FAILED
@ FL_METHOD_RESPONSE_ERROR_FAILED
Definition: fl_method_response.h:33
error
G_MODULE_EXPORT FlMethodResponse G_MODULE_EXPORT GError ** error
Definition: fl_method_response.h:137
fl_method_error_response_get_details
G_MODULE_EXPORT FlValue * fl_method_error_response_get_details(FlMethodErrorResponse *self)
Definition: fl_method_response.cc:172
FlMethodResponseError
FlMethodResponseError
Definition: fl_method_response.h:32
G_DECLARE_DERIVABLE_TYPE
G_MODULE_EXPORT G_DECLARE_DERIVABLE_TYPE(FlMethodResponse, fl_method_response, FL, METHOD_RESPONSE, GObject) struct _FlMethodResponseClass
Definition: fl_method_response.h:42
fl_method_error_response_get_code
const G_MODULE_EXPORT gchar * fl_method_error_response_get_code(FlMethodErrorResponse *self)
Definition: fl_method_response.cc:160
fl_value.h
METHOD_ERROR_RESPONSE
G_MODULE_EXPORT METHOD_ERROR_RESPONSE
Definition: fl_method_response.h:63
fl_method_not_implemented_response
fl_method_not_implemented_response
Definition: fl_method_response.cc:37
fl_method_response_error_quark
G_MODULE_EXPORT GQuark fl_method_response_error_quark(void) G_GNUC_CONST