contract-manager/docs/task/create_vo.md

更新Vo

任务逻辑

根据 model 创建、更新 Vo，先检查Vo是否存在，如果不存在则创建Vo，否则根据要求更新Vo 更新结果保存到 D:\idea-workspace\Contract-Manager\docs\create_vo.md Model和Vo的对应关系记录在 create_vo.md 结果记录中，如果未找到对应的Vo，从结果记录中查看是否有对应关系

model

• 所在目录： D:\idea-workspace\Contract-Manager\common\src\main\java\com\ecep\contract\model
• 注解为 @Entity 的 .java 文件
• 请根据所在目录找到的Model，更新本文件中的 Entity 类清单 如果 model 不在 Entity 类清单中，从清单中移除
• Model 需要继承 com.ecep.contract.model.Voable 接口的类，并且实现 toVo 方法
• 以 Local 结尾的 Model 类，并且前面部分名称正好是一个枚举类，则需继承自 BaseEnumEntity

参考

• D:\idea-workspace\Contract-Manager\common\src\main\java\com\ecep\contract\model\Bank.java

ViewModel VM

• 所在目录： D:\idea-workspace\Contract-Manager\client\src\main\java\com\ecep\contract\vm
• 继承 IdentityViewModel
• 包含一个 名为 from 的静态方法 public static BankViewModel from(BankVo v) { BankViewModel vm = new BankViewModel(); vm.update(v); return vm; }
• 继承实现 void updateFrom(Vo v) 方法
• 继承实现 void copyTo(Vo v) 方法
• 关联对象 使用 ObjectProperty，不使用 IntegerProperty
• IdentityViewModel 不需要调整
• 如果Vo的属性是 boolean，使用 BooleanProperty

参考

• D:\idea-workspace\Contract-Manager\client\src\main\java\com\ecep\contract\vm\BankViewModel.java
• D:\idea-workspace\Contract-Manager\client\src\main\java\com\ecep\contract\vm\CompanyBankAccountViewModel.java

vo

• 所在目录： D:\idea-workspace\Contract-Manager\common\src\main\java\com\ecep\contract\vo

参考

• D:\idea-workspace\Contract-Manager\common\src\main\java\com\ecep\contract\vo\BankVo.java

Service (client 模块)

• 所在目录： D:\idea-workspace\Contract-Manager\client\src\main\java\com\ecep\contract\service
• 继承 QueryService<Vo, VM>
• 指定 @Service 注解
• 如果 指定了 @CacheConfig 注解，则需要实现 findById、findAll、save和delete方法，并且方法上实现 Cache 相关注解，参考 D: \idea-workspace\Contract-Manager\client\src\main\java\com\ecep\contract\service\BankService.java
• find** 方法，则通过调用父类的 findAll（params, pageable) 方法实现，如下代码 public List<ContractVo> findAllByCompanyVendor(CompanyVendorVo vendor, LocalDate beginDate, LocalDate endDate) { return findAll(ParamUtils.builder() .equals("company", vendor.getCompanyId()) .between("setupDate", beginDate, endDate) .build(), Pageable.unpaged()).getContent(); }
• 查询条件中的 .equals("company", vendor.getCompanyId()) 中的company 是对应 model 中对应的字段的名，不对 vo 中对应字段的名
• 如果方法内没有具体的实现，也用如上代码实现

Service (Server 模块)

Controller

• ManagerWindowController
  • 继承 AbstManagerWindowController<VO, VM, ManagerSkin>
  • 实现 createDefaultSkin 方法 返回 ManagerSkin
  • 实现 getViewModelService 方法 返回 对应的 Service
  • 需要给定以下注解 @Lazy、@Scope("prototype")、@Component、@FxmlPath("/ui/bank-manager.fxml")

参考

• D:\idea-workspace\Contract-Manager\client\src\main\java\com\ecep\contract\controller\bank\BankManagerWindowController.java
• D:\idea-workspace\Contract-Manager\client\src\main\java\com\ecep\contract\controller\bank\BankManagerSkin.java

TabSkin

EditableEntityTableTabSkin<Vo, VM>

TableCell

• 所在目录： D:\idea-workspace\Contract-Manager\client\src\main\java\com\ecep\contract\controller\table\cell
• TableCell extends AsyncUpdateTableCell<T, VO>
• TableVIew 使用 TableCell
  • bankAccountTable_bankColumn.setCellValueFactory(param -> param.getValue().getBankId());
  • bankAccountTable_bankColumn.setCellFactory(param -> new BankTableCell<>(getBankService()));

参考

D:\idea-workspace\Contract-Manager\client\src\main\java\com\ecep\contract\controller\table\cell\BankTableCell.java

Combo

FXML UI 界面

• 所在目录： D:\idea-workspace\Contract-Manager\client\src\main\resources\ui

其他要求

• 检索到的Model，先记录在 create_vo.md
• 主键名称为id，类型都是 Integer
• 布尔类型的属性使用 boolean,不要使用 Boolean，初始值为false
• 注解为@Embeddable、@MappedSuperclass的Model不需要更新Vo
• 更新结果以 Model：Vo (状态) 保存， Model 和 VO 的名称后期后修改，可能会不一一对应

Entity 类清单

Bank CloudRk CloudTyc CloudYu Company CompanyBankAccount CompanyBlackReason CompanyContact CompanyContract CompanyCustomer CompanyCustomerEntity CompanyCustomerEvaluationFormFile CompanyCustomerFile CompanyCustomerFileTypeLocal CompanyExtendInfo CompanyFile CompanyFileTypeLocal CompanyInvoiceInfo CompanyOldName CompanyVendor CompanyVendorApprovedFile CompanyVendorApprovedItem CompanyVendorApprovedList CompanyVendorEntity CompanyVendorFile Contract ContractBidVendor ContractCatalog ContractFile ContractFileTypeLocal ContractGroup ContractItem ContractKind ContractPayPlan ContractType CustomerCatalog CustomerSatisfactionSurvey DeliverySignMethod ExtendVendorInfo HolidayTable Inventory InventoryCatalog InventoryHistoryPrice Invoice ProductType ProductUsage Project ProjectBid ProjectCost ProjectCostItem ProjectFile ProjectFileTypeLocal ProjectFundPlan ProjectIndustry ProjectQuotation ProjectSaleType ProjectSaleTypeRequireFileType ProjectType PurchaseBillVoucher PurchaseBillVoucherItem PurchaseOrder PurchaseOrderItem PurchaseReceipt PurchaseSettlementVoucher PurchaseSettlementVoucherItem SalesBillVoucher SalesBillVoucherItem SalesOrder SalesOrderInvoice SalesOrderItem SysConf Unit VendorCatalog VendorFileTypeLocal VendorGroup VendorGroupRequireFileType VendorTypeLocal VolumeSize

结果记录

EmployeeAuthBind: EmployeeAuthBindVo (已创建) EmployeeLoginHistory: EmployeeLoginHistoryVo (已创建) ProjectSaleTypeRequireFileType: ProjectSaleTypeRequireFileTypeVo (已创建) ProjectFundPlan: ProjectFundPlanVo (已创建) SalesOrderInvoice: SalesOrderInvoiceVo (已创建) SalesBillVoucherItem: SalesBillVoucherItemVo (已创建) SalesBillVoucher: SalesBillVoucherVo (已创建) PurchaseSettlementVoucherItem: PurchaseSettlementVoucherItemVo (已创建) PurchaseSettlementVoucher: PurchaseSettlementVoucherVo (已创建) PurchaseBillVoucherItem: PurchaseBillVoucherItemVo (已创建) PurchaseBillVoucher: PurchaseBillVoucherVo (已创建) CompanyOldName: CompanyOldNameVo (已创建) ContractCatalog: ContractCatalogVo (已创建) CompanyBlackReason: CompanyBlackReasonVo (已更新) CompanyContract: CompanyContractVo (已更新) CompanyCustomer: CompanyCustomerVo (已更新) CompanyCustomerEntity: CompanyCustomerEntityVo (已创建) CompanyCustomerEvaluationFormFile: CompanyCustomerEvaluationFormFileVo (已更新) CompanyCustomerFile: CompanyCustomerFileVo (已更新) CompanyCustomerFileTypeLocal: CompanyCustomerFileTypeLocalVo (已更新) CompanyExtendInfo: CompanyExtendInfoVo (已更新) CompanyFileTypeLocal: CompanyFileTypeLocalVo (已更新) CompanyVendor: CompanyVendorVo (已更新) CompanyVendorApprovedFile: CompanyVendorApprovedFileVo (已更新) CompanyVendorApprovedItem: CompanyVendorApprovedItemVo (已更新) CompanyVendorApprovedList: CompanyVendorApprovedListVo (已更新) CompanyVendorEntity: CompanyVendorEntityVo (已更新) CompanyVendorFile: CompanyVendorFileVo (已更新) CustomerSatisfactionSurvey: CustomerSatisfactionSurveyVo (已更新) EmployeeRole: EmployeeRoleVo (已更新) ProductType: ProductTypeVo (已更新) PurchaseOrder: PurchaseOrderVo (已更新) CloudRk: CloudRkVo (已更新) CloudTyc: CloudTycVo (已更新) CloudYu: CloudYuVo (已更新) ProjectFile: ProjectFileVo (已更新)

CompanyContact: CompanyContactVo (已更新) ContractType: ContractTypeVo (已更新) ContractKind: ContractKindVo (已更新) ContractPayPlan: ContractPayPlanVo (已更新) CustomerCatalog: CustomerCatalogVo (已更新) Department: DepartmentVo (已更新) Function: FunctionVo (已更新) ProjectType: ProjectTypeVo (已更新) ProductType: ProductTypeVo (已更新) ProductUsage: ProductUsageVo (已更新) Price: PriceVo (已更新) ContractGroup: ContractGroupVo (已更新) DeliverySignMethod: DeliverySignMethodVo (已更新) Employee: EmployeeVo (已更新) Inventory: InventoryVo (已更新) InventoryCatalog: InventoryCatalogVo (已更新) Project: ProjectVo (已更新) ProjectIndustry: ProjectIndustryVo (已更新) ProjectSaleType: ProjectSaleTypeVo (已更新) CompanyBankAccount: CompanyBankAccountVo (已更新) CompanyInvoiceInfo: CompanyInvoiceInfoVo (已更新) CompanyOldName: CompanyOldNameVo (已更新) Company: CompanyVo (已更新) Contract: ContractVo (已更新) PurchaseReceipt: PurchaseReceiptVo (已更新)

ContractItem: ContractItemVo (已检查) VolumeSize: VolumeSizeVo (已检查) Bank: BankVo (已检查) Contract: ContractVo (已检查) ContractBidVendor: ContractBidVendorVo (已检查) ContractCatalog: ContractCatalogVo (已检查) ContractFile: ContractFileVo (已检查) ContractFileTypeLocal: ContractFileTypeLocalVo (已检查) Employee: EmployeeVo (已检查) Department: DepartmentVo (已检查) Inventory: InventoryVo (已更新) InventoryCatalog: InventoryCatalogVo (已检查) Project: ProjectVo (已检查) ProjectIndustry: ProjectIndustryVo (已检查) ProjectSaleType: ProjectSaleTypeVo (已检查) Company: CompanyVo (已检查) Invoice: InvoiceVo (已更新) PurchaseOrder: PurchaseOrderVo (已更新) SalesOrder: SalesOrderVo (已更新) ProjectBid: ProjectBidVo (已更新) ProjectQuotation: ProjectQuotationVo (已更新) CompanyBankAccount: CompanyBankAccountVo (已检查) ExtendVendorInfo: ExtendVendorInfoVo (已更新) ProjectCost: ProjectCostVo (已更新) VendorGroup: VendorGroupVo (已更新) VendorGroupRequireFileType: VendorGroupRequireFileTypeVo (已更新) ProjectCostItem: ProjectCostItemVo (已更新) ProjectFileTypeLocal: ProjectFileTypeLocalVo (已更新) VendorTypeLocal: VendorTypeLocalVo (已更新) VendorFileTypeLocal: VendorFileTypeLocalVo (已更新)