| Flutter Linux Embedder |

fl_method_codec.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_CODEC_H_
6 #define FLUTTER_SHELL_PLATFORM_LINUX_PUBLIC_FLUTTER_LINUX_FL_METHOD_CODEC_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_method_response.h"
16 #include "fl_value.h"
17
18 G_BEGIN_DECLS
19
20 G_MODULE_EXPORT
21 G_DECLARE_DERIVABLE_TYPE(FlMethodCodec,
22 fl_method_codec,
23 FL,
24 METHOD_CODEC,
25 GObject)
26
27 /**
28 * FlMethodCodec:
29 *
30 * #FlMethodCodec is an abstract class that encodes and decodes method calls on
31 * a platform channel. Override this class to implement an encoding.
32 *
33 * #FlMethodCodec matches the MethodCodec class in the Flutter services
34 * library.
35 */
36
37 struct _FlMethodCodecClass {
38 GObjectClass parent_class;
39
40 /**
41 * FlMethodCodec::encode_method_call:
42 * @codec: an #FlMethodCodec.
43 * @name: method name.
44 * @args: (allow-none): method arguments, or %NULL.
45 * @error: (allow-none): #GError location to store the error occurring, or
46 * %NULL.
47 *
48 * Encodes a method call.
49 *
50 * Returns: (transfer full): a binary encoding of this method call or %NULL if
51 * not able to encode.
52 */
53 GBytes* (*encode_method_call)(FlMethodCodec* codec,
54 const gchar* name,
55 FlValue* args,
56 GError** error);
57
58 /**
59 * FlMethodCodec::decode_method_call:
60 * @codec: an #FlMethodCodec
61 * @message: message to decode.
62 * @name: (transfer full): location to write method name or %NULL if not
63 * required
64 * @args: (transfer full): location to write method arguments, or %NULL if not
65 * required
66 * @error: (allow-none): #GError location to store the error occurring, or
67 * %NULL
68 *
69 * Decodes a method call.
70 *
71 * Returns: %TRUE if successfully decoded.
72 */
73 gboolean (*decode_method_call)(FlMethodCodec* codec,
74 GBytes* message,
75 gchar** name,
76 FlValue** args,
77 GError** error);
78
79 /**
80 * FlMethodCodec::encode_success_envelope:
81 * @codec: an #FlMethodCodec.
82 * @result: (allow-none): method result, or %NULL.
83 * @error: (allow-none): #GError location to store the error occurring, or
84 * %NULL.
85 *
86 * Encodes a successful response to a method call.
87 *
88 * Returns: (transfer full): a binary encoding of this response or %NULL if
89 * not able to encode.
90 */
91 GBytes* (*encode_success_envelope)(FlMethodCodec* codec,
92 FlValue* result,
93 GError** error);
94
95 /**
96 * FlMethodCodec::encode_error_envelope:
97 * @codec: an #FlMethodCodec.
98 * @code: an error code.
99 * @message: (allow-none): an error message, or %NULL.
100 * @details: (allow-none): error details, or %NULL.
101 * @error: (allow-none): #GError location to store the error occurring, or
102 * %NULL.
103 *
104 * Encodes an error response to a method call.
105 *
106 * Returns: (transfer full): a binary encoding of this response or %NULL if
107 * not able to encode.
108 */
109 GBytes* (*encode_error_envelope)(FlMethodCodec* codec,
110 const gchar* code,
111 const gchar* message,
112 FlValue* details,
113 GError** error);
114
115 /**
116 * FlMethodCodec::decode_response:
117 * @codec: an #FlMethodCodec.
118 * @message: message to decode.
119 * @error: (allow-none): #GError location to store the error occurring, or
120 * %NULL.
121 *
122 * Decodes a response to a method call.
123 *
124 * Returns: a new #FlMethodResponse or %NULL on error.
125 */
126 FlMethodResponse* (*decode_response)(FlMethodCodec* codec,
127 GBytes* message,
128 GError** error);
129 };
130
131 G_END_DECLS
132
133 #endif // FLUTTER_SHELL_PLATFORM_LINUX_PUBLIC_FLUTTER_LINUX_FL_METHOD_CODEC_H_
G_DECLARE_DERIVABLE_TYPE
G_DECLARE_DERIVABLE_TYPE(FlAccessibleNode, fl_accessible_node, FL, ACCESSIBLE_NODE, AtkObject)
FlValue
typedefG_BEGIN_DECLS struct _FlValue FlValue
Definition: fl_value.h:42
decode_method_call
static void decode_method_call(const char *text, gchar **name, FlValue **args)
Definition: fl_json_method_codec_test.cc:66
FL
FL
Definition: fl_binary_messenger.cc:27
fl_method_response.h
result
GAsyncResult * result
Definition: fl_text_input_handler.cc:106
fl_value.h
args
G_BEGIN_DECLS G_MODULE_EXPORT FlValue * args
Definition: fl_event_channel.h:89
error
const uint8_t uint32_t uint32_t GError ** error
Definition: fl_pixel_buffer_texture_test.cc:40