手机探索者开发实录—代码产生器（上）

手机探索者开发实录—代码产生器（上）

 

转载时请注明出处和作者联系方式
作者联系方式：李先静 <xianjimli at hotmail dot com>

我喜欢C语言，因为它很简单。用C语言写程序时，通常不需要记忆什么，也不需要考虑语言本身的问题（当然对计算机原理应该比较熟悉才行）。不过有些地方用C语言来实现确实有点繁琐。比如在分离接口和实现时，我们先要声明一组函数指针，再定义一个结构，这个结构包含这组函数指针，再定义inline函数包装这组函数指针，在具体实现这个接口时，还要做些类似工作。

 

在手机探索者中，所有接口的框架都是这样实现的。这样的代码写多了，人都会变傻，至少会变得机械，编程也会变得很无聊。正因为这样，我又喜欢上了awk，它经常帮我做些单调重复的工作，它甚至比C更简单，即使长时间不用它，只要看一下帮助，我也马上可以用它来编程。

 

这里我们用awk来写一个代码产生器，这里的代码产生器虽然有点复杂，不过它至少可以让我的工作更有趣一点，而且可以不同模块中重复使用，所以花点时间去写这个代码产生器完全值得。

 

接口描述(Mobile_Explorer.def)

1. 0:MeRet:Mobile_Explorer:Get_Type_Info:MobileExplorer* thiz, MeType* type:
3. 1:MeRet:Mobile_Explorer:Get_Device_Info:MobileExplorer* thiz, MeDeviceInfo* info:
5. 2:MeRet:Mobile_Explorer:Auth:MobileExplorer* thiz, const char* user, const char* passwd:
7. 3:MeRet:Mobile_Explorer:Del_Objects:MobileExplorer* thiz, MePath* path:
9. 4:MeRet:Mobile_Explorer:Add_Objects:MobileExplorer* thiz, MeObjects* objs:
11. 5:MeRet:Mobile_Explorer:Update_Objects:MobileExplorer* thiz, MeObjects* objs:
13. 6:MeRet:Mobile_Explorer:Get_Objects:MobileExplorer* thiz, MePath* path, MeObjects* hdrs:
15. 7:MeRet:Mobile_Explorer:Get_ObjectsHdr:MobileExplorer* thiz, MePath* path, MeObjectsHdr* hdrs:
17. 8:MeRet:Mobile_Explorer:Get_ObjectsAttr:MobileExplorer* thiz, MePath* path, MeObjectsAttr* attr:
19. 9:MeRet:Mobile_Explorer:IME_Commit:MobileExplorer* thiz, const char* text:
21. 10:MeRet:Mobile_Explorer:Clipboard_Set_Data:MobileExplorer* thiz, MeData* data:
23. 11:MeRet:Mobile_Explorer:Clipboard_Get_Data:MobileExplorer* thiz, MeData* data:
25. 12:MeRet:Mobile_Explorer:Reg_Listener:MobileExplorer* thiz, MobileExplorerListener* listener:
27. 13:MeRet:Mobile_Explorer:Destroy:MobileExplorer* thiz:

产生的代码

接口定义(mobile_explorer.h)

1. #include "mobile_explorer_types.h"
3. #include "mobile_explorer_listener.h"
5.  
7. #ifndef MOBILE_EXPLORER_H
9. #define MOBILE_EXPLORER_H
11.  
13. ME_DECLS_BEGIN
15.  
17. struct _MobileExplorer;
19. typedef struct _MobileExplorer MobileExplorer;
21.  
23. typedef MeRet (*MobileExplorerGetTypeInfoFunc)(MobileExplorer* thiz, MeType* type);
25. typedef MeRet (*MobileExplorerGetDeviceInfoFunc)(MobileExplorer* thiz, MeDeviceInfo* info);
27. typedef MeRet (*MobileExplorerAuthFunc)(MobileExplorer* thiz, const char* user, const char* passwd);
29. typedef MeRet (*MobileExplorerDelObjectsFunc)(MobileExplorer* thiz, MePath* path);
31. typedef MeRet (*MobileExplorerAddObjectsFunc)(MobileExplorer* thiz, MeObjects* objs);
33. typedef MeRet (*MobileExplorerUpdateObjectsFunc)(MobileExplorer* thiz, MeObjects* objs);
35. typedef MeRet (*MobileExplorerGetObjectsFunc)(MobileExplorer* thiz, MePath* path, MeObjects* hdrs);
37. typedef MeRet (*MobileExplorerGetObjectsHdrFunc)(MobileExplorer* thiz, MePath* path, MeObjectsHdr* hdrs);
39. typedef MeRet (*MobileExplorerGetObjectsAttrFunc)(MobileExplorer* thiz, MePath* path, MeObjectsAttr* attr);
41. typedef MeRet (*MobileExplorerIMECommitFunc)(MobileExplorer* thiz, const char* text);
43. typedef MeRet (*MobileExplorerClipboardSetDataFunc)(MobileExplorer* thiz, MeData* data);
45. typedef MeRet (*MobileExplorerClipboardGetDataFunc)(MobileExplorer* thiz, MeData* data);
47. typedef MeRet (*MobileExplorerRegListenerFunc)(MobileExplorer* thiz, MobileExplorerListener* listener);
49. typedef MeRet (*MobileExplorerDestroyFunc)(MobileExplorer* thiz);
51.  
53. struct _MobileExplorer
55. {
57.          MobileExplorerGetTypeInfoFunc get_type_info;
59.          MobileExplorerGetDeviceInfoFunc get_device_info;
61.          MobileExplorerAuthFunc auth;
63.          MobileExplorerDelObjectsFunc del_objects;
65.          MobileExplorerAddObjectsFunc add_objects;
67.          MobileExplorerUpdateObjectsFunc update_objects;
69.          MobileExplorerGetObjectsFunc get_objects;
71.          MobileExplorerGetObjectsHdrFunc get_objectshdr;
73.          MobileExplorerGetObjectsAttrFunc get_objectsattr;
75.          MobileExplorerIMECommitFunc ime_commit;
77.          MobileExplorerClipboardSetDataFunc clipboard_set_data;
79.          MobileExplorerClipboardGetDataFunc clipboard_get_data;
81.          MobileExplorerRegListenerFunc reg_listener;
83.          MobileExplorerDestroyFunc destroy;
85.  
87.          char priv[0];
89. };
91.  
93. static inline MeRet mobile_explorer_get_type_info(MobileExplorer* thiz, MeType* type)
95. {
97.          me_return_val_if_fail(thiz != NULL && thiz->get_type_info != NULL, ME_RET_PARAMS);
99.  
101.          return thiz->get_type_info(thiz, type);
103. }
105.  
107. static inline MeRet mobile_explorer_get_device_info(MobileExplorer* thiz, MeDeviceInfo* info)
109. {
111.          me_return_val_if_fail(thiz != NULL && thiz->get_device_info != NULL, ME_RET_PARAMS);
113.  
115.          return thiz->get_device_info(thiz, info);
117. }
119.  
121. static inline MeRet mobile_explorer_auth(MobileExplorer* thiz, const char* user, const char* passwd)
123. {
125.          me_return_val_if_fail(thiz != NULL && thiz->auth != NULL, ME_RET_PARAMS);
127.  
129.          return thiz->auth(thiz, user, passwd);
131. }
133.  
135. static inline MeRet mobile_explorer_del_objects(MobileExplorer* thiz, MePath* path)
137. {
139.          me_return_val_if_fail(thiz != NULL && thiz->del_objects != NULL, ME_RET_PARAMS);
141.  
143.          return thiz->del_objects(thiz, path);
145. }
147.  
149. static inline MeRet mobile_explorer_add_objects(MobileExplorer* thiz, MeObjects* objs)
151. {
153.          me_return_val_if_fail(thiz != NULL && thiz->add_objects != NULL, ME_RET_PARAMS);
155.  
157.          return thiz->add_objects(thiz, objs);
159. }
161.  
163. static inline MeRet mobile_explorer_update_objects(MobileExplorer* thiz, MeObjects* objs)
165. {
167.          me_return_val_if_fail(thiz != NULL && thiz->update_objects != NULL, ME_RET_PARAMS);
169.  
171.          return thiz->update_objects(thiz, objs);
173. }
175.  
177. static inline MeRet mobile_explorer_get_objects(MobileExplorer* thiz, MePath* path, MeObjects* hdrs)
179. {
181.          me_return_val_if_fail(thiz != NULL && thiz->get_objects != NULL, ME_RET_PARAMS);
183.  
185.          return thiz->get_objects(thiz, path, hdrs);
187. }
189.  
191. static inline MeRet mobile_explorer_get_objectshdr(MobileExplorer* thiz, MePath* path, MeObjectsHdr* hdrs)
193. {
195.          me_return_val_if_fail(thiz != NULL && thiz->get_objectshdr != NULL, ME_RET_PARAMS);
197.  
199.          return thiz->get_objectshdr(thiz, path, hdrs);
201. }
203.  
205. static inline MeRet mobile_explorer_get_objectsattr(MobileExplorer* thiz, MePath* path, MeObjectsAttr* attr)
207. {
209.          me_return_val_if_fail(thiz != NULL && thiz->get_objectsattr != NULL, ME_RET_PARAMS);
211.  
213.          return thiz->get_objectsattr(thiz, path, attr);
215. }
217.  
219. static inline MeRet mobile_explorer_ime_commit(MobileExplorer* thiz, const char* text)
221. {
223.          me_return_val_if_fail(thiz != NULL && thiz->ime_commit != NULL, ME_RET_PARAMS);
225.  
227.          return thiz->ime_commit(thiz, text);
229. }
231.  
233. static inline MeRet mobile_explorer_clipboard_set_data(MobileExplorer* thiz, MeData* data)
235. {
237.          me_return_val_if_fail(thiz != NULL && thiz->clipboard_set_data != NULL, ME_RET_PARAMS);
239.  
241.          return thiz->clipboard_set_data(thiz, data);
243. }
245.  
247. static inline MeRet mobile_explorer_clipboard_get_data(MobileExplorer* thiz, MeData* data)
249. {
251.          me_return_val_if_fail(thiz != NULL && thiz->clipboard_get_data != NULL, ME_RET_PARAMS);
253.  
255.          return thiz->clipboard_get_data(thiz, data);
257. }
259.  
261. static inline MeRet mobile_explorer_reg_listener(MobileExplorer* thiz, MobileExplorerListener* listener)
263. {
265.          me_return_val_if_fail(thiz != NULL && thiz->reg_listener != NULL, ME_RET_PARAMS);
267.  
269.          return thiz->reg_listener(thiz, listener);
271. }
273.  
275. static inline MeRet mobile_explorer_destroy(MobileExplorer* thiz)
277. {
279.          me_return_val_if_fail(thiz != NULL && thiz->destroy != NULL, ME_RET_PARAMS);
281.  
283.          return thiz->destroy(thiz);
285. }
287.  
289. ME_DECLS_END
291.  
293. #endif/*MOBILE_EXPLORER_H*/
295.  
297. 
     
299.  

接口实现头文件(mobile_explorer_host_xml.h)

1. #include <mobile_explorer.h>
2. #ifndef MOBILE_EXPLORER_HOST_XML_H
3. #define MOBILE_EXPLORER_HOST_XML_H
5. ME_DECLS_BEGIN
7. MobileExplorer* mobile_explorer_host_xml_create();
8. ME_DECLS_END
10. #endif/*MOBILE_EXPLORER_HOST_XML_H*/

接口实现C文件(mobile_explorer_host_xml.c)

1. #include <mobile_explorer_host_xml.h>
3.  
5. typedef struct _PrivInfo
7. {
9.     unsigned int dummy;
11. }PrivInfo;
13.  
15. static MeRet mobile_explorer_host_xml_get_type_info(MobileExplorer* thiz, MeType* type)
17. {
19.     me_return_val_if_fail(thiz != NULL, ME_RET_PARAMS);
21.  
23.     PrivInfo* priv = (PrivInfo*)thiz->priv;
25.  
27.     return (MeRet)0;
29. }
31.  
33. static MeRet mobile_explorer_host_xml_get_device_info(MobileExplorer* thiz, MeDeviceInfo* info)
35. {
37.     me_return_val_if_fail(thiz != NULL, ME_RET_PARAMS);
39.  
41.     PrivInfo* priv = (PrivInfo*)thiz->priv;
43.  
45.     return (MeRet)0;
47. }
49. …
51. static MeRet mobile_explorer_host_xml_destroy(MobileExplorer* thiz)
53. {
55.     me_return_val_if_fail(thiz != NULL, ME_RET_PARAMS);
57.  
59.     PrivInfo* priv = (PrivInfo*)thiz->priv;
61.  
63.     return (MeRet)0;
65. }
67.  
69. MobileExplorer* mobile_explorer_host_xml_create()
71. {
73.     MobileExplorer* thiz = (MobileExplorer*)malloc(sizeof(MobileExplorer) + sizeof(PrivInfo));
75.  
77.     if(thiz != NULL)
79.     {
81.         thiz->get_type_info = mobile_explorer_host_xml_get_type_info;
83.         thiz->get_device_info = mobile_explorer_host_xml_get_device_info;
85.         thiz->auth = mobile_explorer_host_xml_auth;
87.         thiz->del_objects = mobile_explorer_host_xml_del_objects;
89.         thiz->add_objects = mobile_explorer_host_xml_add_objects;
91.         thiz->update_objects = mobile_explorer_host_xml_update_objects;
93.         thiz->get_objects = mobile_explorer_host_xml_get_objects;
95.         thiz->get_objectshdr = mobile_explorer_host_xml_get_objectshdr;
97.         thiz->get_objectsattr = mobile_explorer_host_xml_get_objectsattr;
99.         thiz->ime_commit = mobile_explorer_host_xml_ime_commit;
101.         thiz->clipboard_set_data = mobile_explorer_host_xml_clipboard_set_data;
103.         thiz->clipboard_get_data = mobile_explorer_host_xml_clipboard_get_data;
105.         thiz->reg_listener = mobile_explorer_host_xml_reg_listener;
107.         thiz->destroy = mobile_explorer_host_xml_destroy;
109.     }
111.  
113.     return thiz;
115. }

~~待续~~