From b78295e8da96c3e5e76befeef9582ce5273dbb74 Mon Sep 17 00:00:00 2001
From: yeg <1347747024@qq.com>
Date: 星期二, 29 九月 2026 13:10:23 +0800
Subject: [PATCH] 按代码规范检查整改实体注释、Service Javadoc 与分层边界
---
battery-device-neware/src/main/java/com/battery/device/neware/ReadOnlyVendorDataSource.java | 6 ++++++
1 files changed, 6 insertions(+), 0 deletions(-)
diff --git a/battery-device-neware/src/main/java/com/battery/device/neware/ReadOnlyVendorDataSource.java b/battery-device-neware/src/main/java/com/battery/device/neware/ReadOnlyVendorDataSource.java
index 8562e73..f682c0d 100644
--- a/battery-device-neware/src/main/java/com/battery/device/neware/ReadOnlyVendorDataSource.java
+++ b/battery-device-neware/src/main/java/com/battery/device/neware/ReadOnlyVendorDataSource.java
@@ -25,6 +25,10 @@
*
* <p>防线是结构性的，不是数学上的：任何绕过本数据源另开连接的代码仍能写。
* 服务端只读账号（见现场对接清单第七节）是第一道防线，本层是第二道。
+ *
+ * <p>{@link DataSource} 接口中与只读边界无关的 JDK 样板方法（日志写出器、登录超时、
+ * 父日志器、{@code unwrap} / {@code isWrapperFor} / {@code toString}）直接转发或拒绝驱动对象，
+ * 不承载业务语义，因此不单独加方法注释。
*/
public final class ReadOnlyVendorDataSource implements DataSource
{
@@ -47,12 +51,14 @@
return audit;
}
+ /** 取一条受只读约束的连接；语句白名单在返回的连接代理上生效。 */
@Override
public Connection getConnection() throws SQLException
{
return guard(delegate.getConnection());
}
+ /** 同上，按给定账号取连接；账号仍受只读白名单约束。 */
@Override
public Connection getConnection(String username, String password) throws SQLException
{
--
Gitblit v1.7.1