mirror of
https://gitee.com/pnoker/iot-dc3.git
synced 2026-11-03 03:32:08 +08:00
pnoker
03e6ddb0b3
- BaseBuilder: correct param/return type names (EntityVO -> BaseVO, etc.) across 8 conversion methods - McpToolDefinitionDTO: document fields and the nested Annotations hints and Metadata (tool id, permission code, risk level) - ExceptionUtil: fill placeholder param/return for getNotAvailableServiceMessage
DC3 Common Model
Overview
dc3-common-model is the shared domain model module of the IoT DC3 platform. It defines all base classes, domain
entities (BO/VO/DTO/DO), validation group interfaces, and query
objects used across all services and drivers.
Module Information
- Group ID: io.github.pnoker
- Artifact ID: dc3-common-model
- Version: 2026.5.22
Key Components
Base Classes
| Class | Purpose |
|---|---|
BaseBO |
Base business object — id, audit fields (creatorId, createTime, operatorId, operateTime) |
BaseDO |
Base database object (MyBatis-Plus entity with @TableId) |
BaseVO |
Base view object for REST request/response |
Validation Groups
Used with @Validated(...) in controllers:
| Interface | Usage |
|---|---|
Add |
Marks fields required only on creation (@PostMapping("/add")) |
Update |
Marks fields required only on update (@PostMapping("/update")) |
Select |
Marks fields for query operations |
Read / Auth |
Specialized validation groups |
Common Entities
RequestHeader.PrincipalHeader— Carries tenant/user ID extracted from gateway-injected headersPages— Pagination parameters (current page, page size)TreeNode— Generic tree structure for hierarchical data
Usage Example
// Validation groups in controller
@PostMapping("/add")
public Mono<R<String>> add(@Validated(Add.class) @RequestBody DriverVO entityVO) { ...}
@PostMapping("/update")
public Mono<R<String>> update(@Validated(Update.class) @RequestBody DriverVO entityVO) { ...}
Build Instructions
mvn -s ../../.mvn/settings.xml clean package
Related Modules
Foundation for all dc3-common-*, dc3-center-*, and dc3-driver-* modules.
License
Copyright 2016-present the IoT DC3 original author or authors.
Licensed under the GNU Affero General Public License v3.0 (AGPL 3.0)