1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
/*
* upb - a minimalist implementation of protocol buffers.
*
* A context represents a namespace of proto definitions, sort of like an
* interpreter's symbol table. It is empty when first constructed. Clients
* add definitions to the context by supplying unserialized or serialized
* descriptors (as defined in descriptor.proto).
*
* Copyright (c) 2009 Joshua Haberman. See LICENSE for details.
*/
#ifndef UPB_CONTEXT_H_
#define UPB_CONTEXT_H_
#include "upb.h"
#include "upb_table.h"
#include "upb_atomic.h"
struct google_protobuf_FileDescriptorProto;
#ifdef __cplusplus
extern "C" {
#endif
/* Definitions. ***************************************************************/
/* The symbol table maps names to various kinds of symbols. */
enum upb_symbol_type {
UPB_SYM_MESSAGE,
UPB_SYM_ENUM,
UPB_SYM_SERVICE,
UPB_SYM_EXTENSION
};
struct upb_symtab_entry {
struct upb_strtable_entry e;
enum upb_symbol_type type;
union upb_symbol_ref ref;
};
struct upb_context {
upb_atomic_refcount_t refcount;
upb_rwlock_t lock;
struct upb_strtable symtab; /* The context's symbol table. */
struct upb_strtable psymtab; /* Private symbols, for internal use. */
struct upb_msgdef *fds_msg; /* In psymtab, ptr here for convenience. */
/* A list of the FileDescriptorProtos we own (from having parsed them
* ourselves) and must free on destruction. */
size_t fds_size, fds_len;
struct google_protobuf_FileDescriptorSet **fds;
};
/* Initializes a upb_context. Contexts are not freed explicitly, but unref'd
* when the caller is done with them. */
struct upb_context *upb_context_new(void);
INLINE void upb_context_ref(struct upb_context *c) {
upb_atomic_ref(&c->refcount);
}
void upb_context_unref(struct upb_context *c);
/* Looking up symbols. ********************************************************/
/* Resolves the given symbol using the rules described in descriptor.proto,
* namely:
*
* If the name starts with a '.', it is fully-qualified. Otherwise, C++-like
* scoping rules are used to find the type (i.e. first the nested types
* within this message are searched, then within the parent, on up to the
* root namespace).
*
* Returns NULL if the symbol has not been defined. */
bool upb_context_resolve(struct upb_context *c, struct upb_string *base,
struct upb_string *symbol,
struct upb_symtab_entry *out_entry);
/* Find an entry in the symbol table with this exact name. Returns NULL if no
* such symbol name exists. */
bool upb_context_lookup(struct upb_context *c, struct upb_string *symbol,
struct upb_symtab_entry *out_entry);
/* For enumerating over the entries in the symbol table. The enumerator
* callback will be called once for every symtab entry.
*
* The callback *must not* block or take any significant amount of time, since
* the upb_context's lock is held while it is being called! */
typedef void (*upb_context_enumerator_t)(
void *udata, struct upb_symtab_entry *entry);
void upb_context_enumerate(struct upb_context *c, upb_context_enumerator_t,
void *udata);
/* Adding symbols. ************************************************************/
/* Adds the definitions in the given file descriptor to this context. All
* types that are referenced from fd must have previously been defined (or be
* defined in fd). fd may not attempt to define any names that are already
* defined in this context.
*
* Caller retains ownership of fd, but the context will contain references to
* it, so it must outlive the context.
*
* upb_context_addfd only returns true or false; it does not give any hint
* about what happened in the case of failure. This is because the descriptor
* is expected to have been validated at the time it was parsed/generated. */
bool upb_context_addfds(struct upb_context *c,
struct google_protobuf_FileDescriptorSet *fds);
bool upb_context_addfds(struct upb_context *c,
struct google_protobuf_FileDescriptorSet *fds);
bool upb_context_parsefds(struct upb_context *c, struct upb_string *fds);
#ifdef __cplusplus
} /* extern "C" */
#endif
#endif /* UPB_PARSE_H_ */
|