LeeFJ的头像 ID: 29535244503

LeeFJ

HelloWorld 社区成员

0035361323

文章32
个人网站0
加入社区2022

Foxnic-Web —— 模块的多版本支持

站在产品角度,如何满足不同客户的需求定制?如何积累丰富的业务功能,尽可能复用避免重复开发?针对最近实施的几个客户,FoxnicWeb为模块增加了多版本特性,在一定程度上解决了甲方需求的多样性和差异性。  FoxnicWeb模块多版本主要是从UI界面和Service层着手。

Foxnic-Web —— 可插拔模块的菜单控制

FoxnicWeb的设计就是业务模块下Maven依赖层面可插拔,即只要把对应的模块加入启动项目的Maven依赖中那么启动项目就拥有了插入模块的功能,反之亦然。因此,在FoxnicWeb的业务模块(MavenModule)中需要做一些特殊处理,使业务模块插拔时同时体现在菜单上。

Foxnic-Web —— 参数体系

所谓参数即程序在运行时可以或得到的一些基础环境或相关的配置信息。这些信息来自各个不同的地方,有系统参数、程序的启动参数,程序的YML配置文件参数以及系统本身在数据库配置表的配置参数。这些参数信息通过程序相互协同,使系统在不同是实施场景有不同的表现。

Foxnic-Web 代码生成 (9) —— 文件覆盖与扩展

之前的文档中我们曾多次提及,Foxnic的代码生成是迭代式的,当表结构变化后,需要重新生成相关的代码。例如某表增加了一个字段,那么对应的表结构元数据需要重新生成。此外,为了维护新加的字段也需要重新生成模块代码。  这个时候,如果模块代码已经被开发人员修改,默认情况下,重新生成代码会覆盖开发人员修改过的代码。为了能够反复生成大多数的模块代码Foxnic设计了一套机制,尽可将影响降到最低。

Foxnic-Web 代码生成 (8) —— 配置列表页

列表页面主要包含了顶部的搜索区域和表格区域,搜索区域有点类似表单,配置上可能存在相似之处。本篇我们就来了解一下,在代码生成时的列表页呈现方面,我们可以做点啥。

Foxnic-Web 代码生成 (7) —— 配置表单页

我们之前已经介绍了字段的通用配置和字段的表单组件配置,这些配置仅限于单个字段。由于FoxnicWeb的模块页面以打开窗口的方式呈现表单内容,自然就会有对表单窗口的控制,以及表单字段布局的控制。

Foxnic-Web 代码生成 (6) —— 配置字段的表单组件

上一篇中我们讲述了字段配置的通用项,本篇将详细介绍字段的表单编辑器配置。针对不同的表单编辑器,可以指定不同的代码生成参数。默认情况下,代码生成会根据表字段的类型等信息自动匹配一个表单组件。当然,开发人员也可以手动指定每个字段的表单组件类型。  虽然表单组件是呈现在表单界面的,但是它的设置同样会影响搜索区域对应的条件输入框。搜索区域的条件输入框组件按一定的规则与表单组件对应。本文将逐个介绍表单组件以及它们的代码生成配置项。

Foxnic-Web 代码生成 (5) —— 配置字段的通用项

字段的配置是代码生成的核心。一个字段在界面上出现的位置有三个:表单、表格、表格的搜索区域,且这三个位置可能存在一定的相关性。字段配置就是要对某个字段在这个三个位置的表现形式和功能特性进行配置,从而生成符合业务需求的代码。

Foxnic-Web 代码生成 (4) —— shadow 方法的应用

FoxnicWeb实体生成中shadow方法的应用本文探讨的是在FoxnicWeb实体模型生成时,配置枚举属性与逻辑值属性。配置枚举属性映射通过shadow方法为属性对应枚举,并同步生成get、set方法。

Foxnic-Web 代码生成 (3) —— 配置模型

FoxnicWeb对模型体系进行了简化,默认创建PO和VO类,且VO继承自PO。其它代码基于PO和VO实现。当然开发者也可以按需自定义模型,但自定义模型并不建议手动创建,而是通过代码生成工具进行创建。  代码生成配置类的configModel方法将全部的模型配置集中于此,方便站在全局的高度理解与分析模型。开发者不必关心新建的模型应该放在哪个包下面,这些在代码生成配置上都已经定义,无需时时关注。  另外,由代码生成的模型有其规范和默认已经实现的方法,方便开发者的同时,也提高模型转换、克隆复制的性能。

Foxnic-Web 代码生成 (2) —— 代码生成的配置类

上一节,我们已经讲述了代码生成的基本步骤,但是对细节部分并未展开。利用FoxnicGenerator包进行代码生成的方式是多种多样的,我们这里提到的配置类这是其中一种,例如在FoxnicEAM项目里,有很多的代码生成非使用配置类来完成的。  我们优先选择配置类讲解,显然配置类有其优势。首先,配置类按数据表隔离,一数据表一模块一个配置类。其次,在配置类内部,按配置对象的不同,分别在不同的方法内进行配置代码的编写。例如,配置模型时在configModel方法内编写配置代码,配置字段时在configFields方法内编写配置代码。  那么,代码生成的配置为什么要用Java类,而不是用Json、XML或YML呢?首先,不管是Json、XML或YML、Java,都是在编辑器敲文本。那么哪一种方式敲文本是最方便的呢,自然是Java了,因为有开发工具强大的支持。

Foxnic-Web 代码生成 (1) —— 开始生成代码

使用FoxnicWeb以及FoxnicSQL进行应用开发时,都可以支持代码生成。他们的区别是,基于FoxnicSQL的快速main函数启动的应用,只需要生成Model和Service即可。基于FoxnicWeb开发Web应用时,除了生成Model和Service以外,还要生成Proxy、Controller、UI界面等。  Foxnic的代码生成是基于数据表的,所以当表结构变更,甚至只是注释的调整,我们也是建议重新生成必要的代码。在Foxnic的体系中,我们认为最初的表结构设计、ER图设计,就是这个系统设计的起点。后续的程序设计或数据结构设计都是表结构设计的延续。  Foxnic的代码生成体系希望开发者可以有一个较高的开发起点,可以基于生成的代码直接开发应用,甚至是代码生成后无需修改就可以直接使用了。另一方面,我们又不关闭二次开发的开放性,毕竟自由的修改代码才是软件系统可以按需定制的终极路径。这也是Foxnic体系没有走无代码或低代码平台的原因。

Foxnic-Web —— 构建与部署应用

FoxnicWeb是标准的Maven项目,所有针对开发环境的搭建、项目构建需要开发者对Maven有一定的了解。FoxnicWeb构建时可以直接在开发工具上构建,可以在外部使用命令行构建。自然而然地,FoxnicWeb完全可以其它CD/CI工具进行构建。本文主要探讨的主题是通过Maven命令构建项目,其它CD/CI工具不做展开。

Foxnic-SQL (16) ——Foxnic-SQL的模型关联方法

本节我们将用一个简单的例子,来说明对象之间的关联关系,以及FoxnicSQL是如何处理这种关联关系的。首先,我们引入商城下单的简单业务模型,这个模型里面包括了商品、订单、订单明细以及收件人地址,这个模型足够简单,所以很容易分析出他们之间的关联关系。

Foxnic-SQL (15) —— 使用记录集导入或导出Excel

很多时候,我们需要将外部Excel表中的数据导入到数据库,或是需要将某个查询结果导出到Excel文件中,对于这种简单的操作,FoxnicSQL已经内置了ExcelReader和ExcelWriter用于处理Excel数据。本文中的示例代码均可在https://gitee.com/LeeFJ/foxnicsamples项目中找到。读取Excel到RcdSetFoxnicSQL使用ExcelReader类读取Excel中某个sheet的数据,这些数据将被读取到RcdSet,通过RcdSet可以完成数据库保存等操作。在读取Excel前需要定义Excel结构,将Excel列映射到数据库字段,如下代码所示。一旦Excel数据转换成RcdSet,开发人员就可以去做其它更多额外的数据处理。

Foxnic-SQL (14) —— DAO 的 Service 扩展

FoxnicSQL中的Service有点像DDD中的Repository,但Foxnic体系里面又没有将Repository和Service区分开来,所以它更有点像两者的合体。但,他们的合与分本身是弹性的,具体还是要看业务场景的需要。在很多项目中,好多时候,Controller是Service的二传手,或许它也会成为Repository的三传手。所以,到底是单传还是二传或是三传还是要看项目、看场景。<br/FoxnicSQL中的Service就是将数据操作的目标具体化,它初始的样子就是针对单个表、单个实体的数据操作者。Service在使用时需要代码生成工具由数据表生成Po、Vo对象,Service接口以及接口实现。关于如何生成这些代码,我们不在此节展开。在此我们主要是了解如何使用Service已经为开发者提供的诸多功能

Foxnic-SQL (13) —— 外部SQL与SQL模版

首先,大多数时候,我们的第一反应是用字符串去拼接SQL语句,这说明字符串拼接方式其实是最直观的。其次,使用对象化的方式拼接SQL,还是有其局限性,大量的SQL文本也不宜直接写在Java类中。所以,FoxnicSQL将原本要写在Java类中的SQL语句放到一个外部文件中,每个语句用一个ID去标识,在SQL执行时,只要指定ID就可以了。在此基础上,FoxnicSQL加入了模板引擎、SQL语句置换、热加载等特性,使其变得更加好用。

Foxnic-SQL (12) —— DAO 特性 : 记录与记录集

默认情况下,JDBC从数据库取得的是ResultSet(游标),但是游标打开着是消耗数据库连接的,所以我们希望,打开游标取数结束后立即关闭游标。FoxnicSQL使用Rcd(记录)和RcdSet(记录集)将游标遍历的数据取出存放。本节将详细介绍Rcd(记录)和RcdSet(记录集)的概念和使用方法。

Foxnic-SQL (11) —— DAO 特性 : 事务管理

事务管理是任何一个数据层工具所必须的,FoxnicSQL既然是基于SpringJDBC的自然默认就支持@Transactional注解,另外FoxnicSQL的DAO对象还支持手动事务。本文中的示例代码均可在https://gitee.com/LeeFJ/foxnicsamples项目中找到。手动事务手动事务通过DAO对象的beginTransaction()方法、commit()方法、rollback()方法完成,下面是一个手动事务的例子: