mirror of
https://gitee.com/pnoker/iot-dc3.git
synced 2026-10-31 10:11:49 +08:00
pnoker
372d75b0c9
sweep every module to satisfy the new method-name rule, renaming about 40 methods together with their interface, implementation, test and cli call sites: store find() lookups become get(), analytics queryLatest/queryHistory become getLatest/getHistory, sql helper query() becomes spec()/sql(), jwks fetch() becomes load(), and the cursor record component queryDigest becomes requestDigest no behavior changes; full unit suite (5278 tests) and both quality gates stay green
DC3 Common Exception
Overview
dc3-common-exception defines the standard exception types and exception utility class for the IoT DC3 platform. All
services and modules use these exceptions to signal business errors consistently.
Module Information
- Group ID: io.github.pnoker
- Artifact ID: dc3-common-exception
Key Components
Exception Types
| Exception | Usage |
|---|---|
ServiceException |
General service-level business error |
BusinessException |
Business rule violation |
UpdateException |
Entity update failure |
AddException |
Entity add failure |
DeleteException |
Entity delete failure |
NotFoundException |
Entity or resource not found |
DuplicateException |
Duplicate entity conflict |
EmptyException |
Required collection or value is empty |
OutRangeException |
Value outside the allowed range |
JsonException |
JSON serialization/deserialization error |
SecurityException |
General security policy violation |
UnAuthorizedException |
Missing or invalid authentication |
AccessDeniedException |
Authenticated principal lacks access |
PasswordChangeRequiredException |
A password change is enforced |
RegisterException |
Driver/service registration failure |
ConnectorException |
Device connection failure |
ReadPointException |
Point read failure |
WritePointException |
Point write failure |
RepositoryException |
Time-series or storage repository error |
RequestException |
Invalid or rejected request |
TypeException |
Unsupported type conversion |
ConfigException |
Invalid configuration |
CronException |
Invalid cron expression |
ImportException |
Import/export failure |
UnSupportException |
Unsupported operation or protocol |
AssociatedException |
Constraint violation by an association |
Utilities
ExceptionUtil— Builds shared service-unavailable messagesExceptionMessageFormatter— Internal{}placeholder and trailing-cause formatter used by business exceptions
Shared message constants such as ExceptionConstant belong to dc3-common-constant.
Usage
throw new NotFoundException("Driver not found for device: " + deviceId);
throw new AddException("Failed to add driver: " + entityBO.getServiceName());
Build Instructions
mvn -s .mvn/settings.xml -pl dc3-common/dc3-common-exception -am package
Testing
Run the module tests from the repository root:
mvn -s .mvn/settings.xml -pl dc3-common/dc3-common-exception -am test
Related Modules
Used by all dc3-common-* service modules and dc3-center-* services.