在自家的代码生成工具中,增加对跨平台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信息和参数即可。

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

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

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

对于列表界面,生成的代码如下所示(以客户信息表为例):

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

复制代码
    def CreateConditions(self, pane: wx.Window) -> List[wx.Window]:
        """创建折叠面板中的查询条件输入框控件"""
        # 创建控件,不用管布局,交给CreateConditionsWithSizer控制逻辑
        # 默认的FlexGridSizer为4*2=8列,每列间隔5px
        self.txtName = ctrl.MyTextCtrl(pane)
        self.txtAge = ctrl.MyNumericRange(pane)
        self.txtCustomerType = ctrl.MyComboBox(pane, style=wx.CB_READONLY)

        util = ControlUtil(pane)
        util.add_control("姓名:", self.txtName)
        util.add_control("年龄:", self.txtAge)
        util.add_control("客户类型:", self.txtCustomerType)  # 测试数据类型绑定

        return util.get_controls()

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

复制代码
    async def OnAdd(self, event: wx.Event) -> None:
        """子类重写-打开新增对话框"""
        dlg = FrmCustomerEdit(self)
        if await AsyncShowDialogModal(dlg) == wx.ID_OK:
            # 新增成功,刷新表格
            await self.update_grid()
        dlg.Destroy()

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

复制代码
    async def init_dict_items(self):
        """初始化字典数据-子类重写"""
        await self.txtCustomerType.bind_dictType("客户类型")

通过上面我们构建的基类处理,以及提供一个界面辅助类来处理,可简化很多不必要的代码,而且还很灵活的控制布局处理,非常方便。

2)编辑/新增界面继承关系

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

  • 共享通用功能:将所有对话框的共同行为(如按钮布局、事件处理、数据校验逻辑等)封装在基类中,子类可以直接继承使用,无需重复实现。
  • 减少冗余代码:对话框的通用结构只需在基类中实现一次,后续的功能扩展只需通过继承来实现,减少代码重复。
  • 统一界面风格:基类可以预定义窗口的样式和布局,确保项目中所有对话框的界面一致。
  • 快速定制功能:子类仅需实现或覆盖特定方法,即可快速实现自定义对话框的功能。

继承基类编辑对话框能够提高代码复用性、开发效率和维护性,特别适合在复杂系统中管理多个相似对话框。通过合理设计基类,开发者可以显著减少重复代码,实现更灵活的功能扩展。

常规的对话框中,业务表编码规则的新增、编辑界面如下所示。

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

一般我们在编辑框中,或者列表窗体中,我们都可能有树形列表的情况,我们提供标准的处理方法,用于对这些内容进行修改。

对于编辑界面来说,我们继承父类后,子类重写一些实现函数即可实现弹性化的处理了。

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

生成的界面代码中,对于输入控件的显示放在add_controls函数里面,如下代码所示。

复制代码
    def add_controls(self, panel: wx.Window) -> wx.GridBagSizer:
        # 创建一个 GridBagSizer
        grid_sizer = wx.GridBagSizer(5, 5)  # 行间距和列间距为 5
        util = GridBagUtil(panel, grid_sizer, 2)  # 构建工具类,布局为2列

        self.txtName = ctrl.MyTextCtrl(panel, placeholder="客户姓名")
        self.txtAge = wx.SpinCtrl(panel)
        self.txtCreateTime = ctrl.MyDatePickerCtrl(panel)
        self.txtCreateTime.Disable()

        self.txtNote = ctrl.MyTextCtrl(panel, placeholder="备注", style=wx.TE_MULTILINE)

        util.add_control("客户姓名", self.txtName, is_expand=True)
        util.add_control("年龄", self.txtAge, is_expand=True)
        util.add_control("创建日期", self.txtCreateTime, is_expand=True)
        util.add_control("备注", self.txtNote, is_expand=True, is_span=True)

        # 让控件跟随窗口拉伸
        grid_sizer.AddGrowableCol(1)  # 允许第n列拉伸
        return grid_sizer

我们通过代码

util = GridBagUtil(panel, grid_sizer, 2) # 构建工具类,布局为2列

构建了一个辅助类来处理布局的,添加的时候不用管布局,大概知道是几列的即可。

在Windows下,客户信息的编辑界面如下所示。

如果我们需要修改为双排的,那么修改下:

复制代码
    def add_controls(self, panel: wx.Window) -> wx.GridBagSizer:
        # 创建一个 GridBagSizer
        grid_sizer = wx.GridBagSizer(5, 5)  # 行间距和列间距为 5
        util = GridBagUtil(panel, grid_sizer, 4)  # 构建工具类,布局为4列

        self.txtName = ctrl.MyTextCtrl(panel, placeholder="客户姓名")
        self.txtAge = wx.SpinCtrl(panel)
        self.txtCreateTime = ctrl.MyDatePickerCtrl(panel)
        self.txtCreateTime.Disable()

        self.txtNote = ctrl.MyTextCtrl(panel, placeholder="备注", style=wx.TE_MULTILINE)

        util.add_control("客户姓名", self.txtName, is_expand=True)
        util.add_control("年龄", self.txtAge, is_expand=True)
        util.add_control("创建日期", self.txtCreateTime, is_span=True)
        util.add_control("备注", self.txtNote, is_expand=True, is_span=True, is_stretch=True)

        # 让控件跟随窗口拉伸
        grid_sizer.AddGrowableCol(1)  # 允许第n列拉伸
        grid_sizer.AddGrowableCol(3)  # 允许第n列拉伸
        return grid_sizer

界面效果如下所示。

稍作修改即可重新布局,非常方便。

利用代码生成工具,可以很好的利用现有基类的关系生成相关的代码,包括界面代码,对Web API的调用代码也是一样,我们只需要做好继承关系,就具有基类一些的CRUD接口了。

例如对于客户信息的API接口封装类,我们只需要增加一些个性化的自定义函数即可,默认对应基类有相关的CRUD接口。

复制代码
class Customer(BaseApi[CustomerDto]):
    """客户信息--API接口类"""

    api_name = "customer"

    def __init__(self):
        super().__init__(self.api_name, CustomerDto)

    async def exist(self, name: str = None, id: str = None) -> bool:
        """判断记录是否存在,如果指定ID,则判断ID不等于当前ID的记录是否存在"""
        url = f"{self.base_url}/exist"
        params = {"name": name, "id": id}
        data = await self.client.get(url, params=params)

        res = AjaxResponse[bool].model_validate(data)
        return res.result if res.success else False

    async def get_by_name(self, name: str) -> CustomerDto:
        """根据名称获取客户信息"""
        url = f"{self.base_url}/by-name"
        params = {"name": name}
        data = await self.client.get(url, params=params)

        res = AjaxResponse[CustomerDto].model_validate(data)
        return res.result if res.success else None


# 构建一个业务逻辑实例,方便调用
api_customer = Customer()

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

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

相关推荐
伍华聪2 天前
分享一个纯Python开发的系统程序,基于VSCode + WxPython开发的跨平台应用系统
python开发
伍华聪15 天前
使用wxpython开发跨平台桌面应用,设计系统的登录界面
python开发
伍华聪22 天前
使用wxpython开发跨平台桌面应用,对WebAPI调用接口的封装
python开发
伍华聪24 天前
使用wxpython开发跨平台桌面应用,基类列表窗体的抽象封装处理
python开发
伍华聪24 天前
使用wxpython开发跨平台桌面应用,动态工具的创建处理
python开发
伍华聪1 个月前
使用wxpython开发跨平台桌面应用,基类对话框窗体的封装处理
python开发
伍华聪1 个月前
使用wxpython开发跨平台桌面应用,常用窗体布局BoxSizer,FlexGridSizer,GridBagSizer的介绍处理
python开发
伍华聪1 个月前
使用wxpython开发跨平台桌面应用,对常用消息对话框的封装处理
python开发
伍华聪1 个月前
使用wxpython开发跨平台桌面应用,实现程序托盘图标和界面最小化及恢复处理
python开发