Files
Henry ZhangandClaude Fable 5 73ff48bcb9 style: reformat codebase (backend java/xml, docs, web) (#175)
* style(backend): reformat and rearrange java/xml sources

Apply code cleanup across dc3-common and dc3-driver: whitespace and
indent normalization, import sorting, member rearrangement, and javadoc
normalization. No semantic changes; compilation verified.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* style(docs): reformat vitepress vue diagram components

Expand compact svg templates and normalize formatting across diagram
components, the seo module, and the theme stylesheet. No behavior
changes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* style(docs): reformat markdown pages

Normalize markdown formatting. Restore the <script setup> component
imports that an earlier unused-import pass had wrongly stripped; every
<Diagram> tag now resolves to a backing import again.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* style: reformat point view and trim pom whitespace

Normalize whitespace in the point view and drop trailing whitespace in
pom.xml. No behavior changes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-08-06 12:13:36 +08:00
..

DC3 Common Web

Overview

dc3-common-web is the shared WebFlux configuration module of the IoT DC3 platform. It provides global exception handling, WebFlux request processing configuration, global web filters, and reactive response utilities for all REST-based center services.

Module Information

  • Group ID: io.github.pnoker
  • Artifact ID: dc3-common-web
  • Version: 2026.5.22

Key Components

Component Purpose
WebFluxConfig Global WebFlux configuration (codecs, CORS, message converters)
ExceptionConfig @ControllerAdvice global exception handler mapping exceptions to R<T> responses
WebFilterConfig Registers global web filters (e.g., request logging, context enrichment)
ResponseUtil Utilities for writing non-controller ServerHttpResponse bodies in reactive context

Exception Handling

All exceptions thrown by controllers are caught by ExceptionConfig and mapped to a structured R<T> response:

{
  "ok": false,
  "code": "FAILURE",
  "message": "Resource not found"
}

Build Instructions

mvn -s ../../.mvn/settings.xml clean package
  • dc3-common-auth, dc3-common-data, dc3-common-manager — All include this for reactive web support
  • dc3-common-public — Provides R<T> response wrapper

License

Copyright 2016-present the IoT DC3 original author or authors.

Licensed under the GNU Affero General Public License v3.0 (AGPL 3.0)