Files
aibridge/docs/codedev/03-examples-index.md
2026-05-18 09:28:15 +08:00

6.9 KiB
Raw Permalink Blame History

示例目录与功能对照表

基于 views/extend 和 jnpf-extend 模块的完整示例索引 整理时间:2026-04-01


一、前端扩展示例

1.1 表格示例 (tableDemo)

示例 路径 功能说明
普通表格 tableDemo/commonTable 基础 CRUD 操作
树形表格 tableDemo/treeTable 树形数据展示
复杂表头 tableDemo/complexHeader 多层表头合并
合并单元格 tableDemo/mergeTable 行列合并
分组表格 tableDemo/groupingTable 数据分组
锁定表格 tableDemo/lockTable 列冻结
编辑表格 tableDemo/redactTable 行内编辑
签字表格 tableDemo/signTable 手写签字
批注表格 tableDemo/postilTable 单元格批注
扩展表格 tableDemo/extension 行政区划联动
统计表格 tableDemo/statisticsTable 数据统计

后端对应:TableExampleController (/api/extend/TableExample)

1.2 图表示例 (graphDemo)

示例 路径 图表类型
柱状图 graphDemo/echartsBar Bar
折线图 graphDemo/echartsLine Line
饼图 graphDemo/echartsPie Pie
仪表盘 graphDemo/echartsGauge Gauge
散点图 graphDemo/echartsScatter Scatter
树图 graphDemo/echartsTree Tree
漏斗图 graphDemo/echartsFunnel Funnel
K线图 graphDemo/echartsCandlestick Candlestick
柱状折线混合 graphDemo/echartsLineBar Line+Bar
面积图 graphDemo/echartsLineArea Line Area

1.3 表单示例 (formDemo)

示例 路径 控件类型
fieldForm1 formDemo/fieldForm1 文本、数值、日期
fieldForm2 formDemo/fieldForm2 下拉、树形
fieldForm3 formDemo/fieldForm3 弹窗选择
fieldForm4 formDemo/fieldForm4 文件上传
fieldForm5 formDemo/fieldForm5 开关、复选框
fieldForm6 formDemo/fieldForm6 定位、地图
verifyForm formDemo/verifyForm 表单验证

1.4 其他示例

示例 路径 功能说明
导入导出 importAndExport Excel 导入导出 ★
订单管理 order 主从表结构
销售订单 saleOrder 复杂业务表单 ★
项目甘特图 projectGantt 甘特图组件 ★
邮件 email 邮件发送接收 ★
条形码 barCode 条形码生成
印章 signet 电子印章
手写签名 signature 手写签名
文档预览 documentPreview 多格式文档预览
地图 map 百度/高德地图
大数据 bigData 大数据量表格

二、后端模块对照

2.1 Controller 层

Controller 路径 功能说明
TableExampleController /api/extend/TableExample 表格 CRUD + 特殊操作
EmployeeController /api/extend/Employee 职员管理 + 导入导出 ★
SalesOrderController /api/extend/saleOrder 销售订单 ★
OrderController /api/extend/Order 订单管理
ProjectGanttController /api/extend/ProjectGantt 项目甘特图
EmailController /api/extend/Email 邮件收发
BigDataController /api/extend/BigData 大数据表格
BarCodeController /api/extend/BarCode 条形码生成
DocumentPreviewController /api/extend/DocumentPreview 文档预览
CustomerController /api/extend/Customer 客户管理
ProductController /api/extend/Product 产品管理
WorkLogController /api/extend/WorkLog 工作日志
LeaveApplyController /api/extend/LeaveApply 请假申请

2.2 Entity 层

Entity 表名 说明
TableExampleEntity table_example 表格示例
EmployeeEntity employee 职员信息
SalesOrderEntity sales_order 销售订单
OrderEntity order 订单
ProjectGanttEntity project_gantt 项目甘特图
EmailSendEntity email_send 邮件发送
BigDataEntity big_data 大数据
CustomerEntity customer 客户
ProductEntity product 产品
WorkLogEntity work_log 工作日志

2.3 Service 层

Service 说明
TableExampleService 表格 CRUD
EmployeeService 职员 + 导入导出
SalesOrderService 销售订单
OrderService 订单
ProjectGanttService 甘特图
EmailSendService 邮件发送
BigDataService 大数据

三、示例功能分类

3.1 完整流程示例 ★★★

示例 说明 关键代码位置
Employee 导入导出完整流程 EmployeeController 完整导入导出
TableExample CRUD + 特殊操作 TableExampleController 批注/行编辑
saleOrder 主子表 saleOrder/index.vue + SalesOrderController

3.2 特殊功能示例

示例 功能 说明
projectGantt 甘特图 任务树 + 时间轴
email 邮件 发送/接收/配置
importAndExport 导入导出 Excel/Word/PDF
barCode 条形码 生成打印
documentPreview 文档预览 Office/PDF/图片

四、源码位置速查

前端

web/apps/jnpf-web-apps-main/src/
├── views/extend/
│   ├── importAndExport/     # 导入导出 ★
│   │   ├── index.vue       # 主页面
│   │   ├── ImportModal.vue # 导入弹窗
│   │   └── ExportModal.vue  # 导出弹窗
│   ├── saleOrder/          # 销售订单 ★
│   │   ├── index.vue       # 主页面
│   │   └── Form.vue        # 表单弹窗
│   ├── tableDemo/         # 表格示例
│   ├── projectGantt/       # 甘特图
│   └── ...
└── api/extend/
    ├── employee.ts         # 职员 API
    ├── saleOrder.ts       # 销售订单 API
    ├── table.ts           # 表格 API
    └── ...

后端

jnpf/后端/jnpf-java-boot/jnpf-extend/
├── jnpf-extend-controller/src/main/java/jnpf/controller/
│   ├── EmployeeController.java     # 导入导出 ★
│   ├── TableExampleController.java # CRUD ★
│   ├── SalesOrderController.java  # 销售订单 ★
│   └── ...
├── jnpf-extend-biz/src/main/java/jnpf/
│   ├── service/impl/              # Service 实现
│   └── mapper/                   # Mapper
└── jnpf-extend-entity/src/main/java/jnpf/
    ├── entity/                    # Entity
    └── model/                     # VO/Form

五、推荐学习路径

  1. 入门:TableExample → CRUD 最基础
  2. 进阶:Employee → 导入导出完整流程
  3. 复杂:saleOrder → 主子表操作
  4. 扩展:projectGantt → 甘特图组件