在自家的代码生成工具中，增加对跨平台WxPython项目的前端代码生成，简直方

画梁落香

在经过长时间对WxPython的深入研究，并对其构建项目有深入的了解，以及完成对基础框架的完整改写后，终于在代码生成工具完全整合了基于 Python 跨平台方案项目的代码快速生成了，包括基于FastApi 的后端Web API项目，以及前端的WxPython前端界面项目。本篇随笔主要介绍跨平台WxPython项目的前端代码生成内容。
1、代码生成工具的整合处理

在前面随笔《基于SqlAlchemy+Pydantic+FastApi的Python开发框架 》中提到过，对于基于FastApi的项目我们已经使用自家的代码生成工具快速进行代码的生成，FastApi+SqlAlchemy+Python后端代码生成，可以生成模型、Schema对象、CRUD封装类、Endpoint路由类等。
本次在基于对WxPython的深入研究，并对我基础框架的内容进行全部的改写后，整理了基于WxPython的项目代码生成，其中包括生成列表界面、新增/编辑界面、WebApi调用类、实体信息等。对WxPython跨平台项目界面的有兴趣的可以参考随笔《分享一个纯Python开发的系统程序，基于VSCode + WxPython开发的跨平台应用系统》。
至此，整个Python的项目前后端串联起来，完成了一个完整的项目了。
代码生成工具可以到地址下载：https://www.iqidi.com/database2sharp.htm，使用代码生成工具来快速开发项目代码，有很多好处。
减少重复工作：自动生成常用代码（如数据模型、CRUD 操作、API 接口等），减少手动编写的时间。
专注于核心逻辑：开发者可以将时间集中在业务逻辑和复杂问题的解决上，而非基础代码的编写。
模块化和规范化：生成代码一般遵循既定的架构和风格，便于后续维护和扩展。
初学者友好：新手开发者可以通过代码生成工具快速上手，了解项目结构和基础代码。
代码生成工具在提升开发效率、降低出错率、标准化代码方面具有显著优势，尤其在重复性工作较多或团队合作时尤为适用。
 
1）后端项目代码的生成

Python + FastAPI项目是一个Web API的项目，为各个前端提供接口的后端项目，其界面自动整合Swagger的文档界面，如下所示。

 在代码生成工具打开数据库列表后，右键菜单可以选择生成对应的Python+FastApi后端项目，如下界面所示。

 选中相关的表后，一键可以生成各层的类文件，其中包括最为繁琐的Model映射类信息。如下是生成的相关类的界面效果。

 
2) WxPython前端项目代码生成

在经过对WxPython的深入研究后，并依据改造过的项目结构，整合在代码生成工具中，对项目的代码，包括列表界面，编辑界面、API调用类、DTO实体信息等进行统一的生成。

选择相关的数据表后，一键生成相关的代码，如下所示。

1）列表界面和继承关系

列表界面继承基类，从而可以大幅度的利用相应的规则和实现。
 

 如对于两个例子窗体：系统类型定义，客户信息，其中传如对应的DTO信息和参数即可。

因为常规的列表界面一般分为查询区、列表界面展示区和分页信息区，我们把它分为两个主要的部分，如下界面所示。

当然如果有树形列表的，也整合在基类窗体中实现控制逻辑，具体实现放在子类处理即可。

同时，在树列表或者表格数据控件支持右键弹出菜单处理，包括常规的新增、编辑、删除、复制、刷新等常规功能，如果需要更多业务模块的功能，整合在右键菜单中，在窗体子类中重写某些只定义函数即可实现。

对于列表界面，生成的代码如下所示（以客户信息表为例）：

代码工具最大程度的提供常规方法的处理，如果需要特殊的操作，如在查询框中的条件，那么需要根据需要修改一下即可。

1.     def CreateConditions(self, pane: wx.Window) -> List[wx.Window]:
2.         """创建折叠面板中的查询条件输入框控件"""
3.         # 创建控件，不用管布局，交给CreateConditionsWithSizer控制逻辑
4.         # 默认的FlexGridSizer为4*2=8列，每列间隔5px
5.         self.txtName = ctrl.MyTextCtrl(pane)
6.         self.txtAge = ctrl.MyNumericRange(pane)
7.         self.txtCustomerType = ctrl.MyComboBox(pane, style=wx.CB_READONLY)
9.         util = ControlUtil(pane)
10.         util.add_control("姓名:", self.txtName)
11.         util.add_control("年龄:", self.txtAge)
12.         util.add_control("客户类型:", self.txtCustomerType)  # 测试数据类型绑定
14.         return util.get_controls()

复制代码

基本上就是不变的内容和规则，由基类处理，变化的内容，由子类来具体化即可。对于新增、编辑、删除的操作，我们根据表的不同，生成子类实现代码，一般不用修改。

1.     async def OnAdd(self, event: wx.Event) -> None:
2.         """子类重写-打开新增对话框"""
3.         dlg = FrmCustomerEdit(self)
4.         if await AsyncShowDialogModal(dlg) == wx.ID_OK:
5.             # 新增成功，刷新表格
6.             await self.update_grid()
7.         dlg.Destroy()

复制代码

如果需要再查询框中初始化下拉列表的内容，我们重写初始化字典函数即可。

1.     async def init_dict_items(self):
2.         """初始化字典数据-子类重写"""
3.         await self.txtCustomerType.bind_dictType("客户类型")

复制代码

通过上面我们构建的基类处理，以及提供一个界面辅助类来处理，可简化很多不必要的代码，而且还很灵活的控制布局处理，非常方便。 
 
 2）编辑/新增界面继承关系

 继承基类编辑对话框（通常用于创建模态对话框或自定义窗口的基类）有以下优点：

• 共享通用功能：将所有对话框的共同行为（如按钮布局、事件处理、数据校验逻辑等）封装在基类中，子类可以直接继承使用，无需重复实现。
  
• 减少冗余代码：对话框的通用结构只需在基类中实现一次，后续的功能扩展只需通过继承来实现，减少代码重复。
  

• 统一界面风格：基类可以预定义窗口的样式和布局，确保项目中所有对话框的界面一致。
  
• 快速定制功能：子类仅需实现或覆盖特定方法，即可快速实现自定义对话框的功能。
  

继承基类编辑对话框能够提高代码复用性、开发效率和维护性，特别适合在复杂系统中管理多个相似对话框。通过合理设计基类，开发者可以显著减少重复代码，实现更灵活的功能扩展。
常规的对话框中，业务表编码规则的新增、编辑界面如下所示。

当然，我们也可以增加更多的定制功能，稍作调整可以增加多页的功能。

 一般我们在编辑框中，或者列表窗体中，我们都可能有树形列表的情况，我们提供标准的处理方法，用于对这些内容进行修改。
对于编辑界面来说，我们继承父类后，子类重写一些实现函数即可实现弹性化的处理了。

上面这些函数就是各司其职，对界面的内容处理，显示编辑数据，校验输入，初始化字典、加载信息，保存对象信息，都是我们在编辑框中需要处理到的内容，我们根据不同的需求进行修改即可。
生成的界面代码中，对于输入控件的显示放在add_controls函数里面，如下代码所示。

1.     def add_controls(self, panel: wx.Window) -> wx.GridBagSizer:
2.         # 创建一个 GridBagSizer
3.         grid_sizer = wx.GridBagSizer(5, 5)  # 行间距和列间距为 5
4.         util = GridBagUtil(panel, grid_sizer, 2)  # 构建工具类，布局为2列
6.         self.txtName = ctrl.MyTextCtrl(panel, placeholder="客户姓名")
7.         self.txtAge = wx.SpinCtrl(panel)
8.         self.txtCreateTime = ctrl.MyDatePickerCtrl(panel)
9.         self.txtCreateTime.Disable()
11.         self.txtNote = ctrl.MyTextCtrl(panel, placeholder="备注", style=wx.TE_MULTILINE)
13.         util.add_control("客户姓名", self.txtName, is_expand=True)
14.         util.add_control("年龄", self.txtAge, is_expand=True)
15.         util.add_control("创建日期", self.txtCreateTime, is_expand=True)
16.         util.add_control("备注", self.txtNote, is_expand=True, is_span=True)
18.         # 让控件跟随窗口拉伸
19.         grid_sizer.AddGrowableCol(1)  # 允许第n列拉伸
20.         return grid_sizer

复制代码

我们通过代码
util = GridBagUtil(panel, grid_sizer, 2) # 构建工具类，布局为2列
构建了一个辅助类来处理布局的，添加的时候不用管布局，大概知道是几列的即可。
在Windows下，客户信息的编辑界面如下所示。

如果我们需要修改为双排的，那么修改下：

1.     def add_controls(self, panel: wx.Window) -> wx.GridBagSizer:
2.         # 创建一个 GridBagSizer
3.         grid_sizer = wx.GridBagSizer(5, 5)  # 行间距和列间距为 5
4.         <strong>util = GridBagUtil(panel, grid_sizer, 4)</strong>  # 构建工具类，布局为4列
6.         self.txtName = ctrl.MyTextCtrl(panel, placeholder="客户姓名")
7.         self.txtAge = wx.SpinCtrl(panel)
8.         self.txtCreateTime = ctrl.MyDatePickerCtrl(panel)
9.         self.txtCreateTime.Disable()
11.         self.txtNote = ctrl.MyTextCtrl(panel, placeholder="备注", style=wx.TE_MULTILINE)
13.         util.add_control("客户姓名", self.txtName, is_expand=True)
14.         util.add_control("年龄", self.txtAge, is_expand=True)
15.         util.add_control("创建日期", self.txtCreateTime, is_span=True)
16.         util.add_control("备注", self.txtNote, is_expand=True, is_span=True, is_stretch=True)
18.         # 让控件跟随窗口拉伸
19.         grid_sizer.AddGrowableCol(1)  # 允许第n列拉伸
20.         grid_sizer.AddGrowableCol(3)  # 允许第n列拉伸
21.         return grid_sizer

复制代码

界面效果如下所示。

 稍作修改即可重新布局，非常方便。
利用代码生成工具，可以很好的利用现有基类的关系生成相关的代码，包括界面代码，对Web API的调用代码也是一样，我们只需要做好继承关系，就具有基类一些的CRUD接口了。
例如对于客户信息的API接口封装类，我们只需要增加一些个性化的自定义函数即可，默认对应基类有相关的CRUD接口。

1. class Customer(BaseApi[CustomerDto]):
2.     """客户信息--API接口类"""
4.     api_name = "customer"
6.     def __init__(self):
7.         super().__init__(self.api_name, CustomerDto)
9.     async def exist(self, name: str = None, id: str = None) -> bool:
10.         """判断记录是否存在,如果指定ID，则判断ID不等于当前ID的记录是否存在"""
11.         url = f"{self.base_url}/exist"
12.         params = {"name": name, "id": id}
13.         data = await self.client.get(url, params=params)
15.         res = AjaxResponse[bool].model_validate(data)
16.         return res.result if res.success else False
18.     async def get_by_name(self, name: str) -> CustomerDto:
19.         """根据名称获取客户信息"""
20.         url = f"{self.base_url}/by-name"
21.         params = {"name": name}
22.         data = await self.client.get(url, params=params)
24.         res = AjaxResponse[CustomerDto].model_validate(data)
25.         return res.result if res.success else None
28. # 构建一个业务逻辑实例，方便调用
29. api_customer = Customer()

复制代码

这个基类的函数，和后端的控制器接口一一对应。

利用代码生成工具，开发项目事半功倍，这就是工具的力量和魅力。 
 

来源:https://www.cnblogs.com/wuhuacong/p/18583832
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！