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/SingleConnectionVendorDataSource.java |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)

diff --git a/battery-device-neware/src/main/java/com/battery/device/neware/SingleConnectionVendorDataSource.java b/battery-device-neware/src/main/java/com/battery/device/neware/SingleConnectionVendorDataSource.java
index 9c03559..7613f32 100644
--- a/battery-device-neware/src/main/java/com/battery/device/neware/SingleConnectionVendorDataSource.java
+++ b/battery-device-neware/src/main/java/com/battery/device/neware/SingleConnectionVendorDataSource.java
@@ -15,6 +15,9 @@
  *
  * <p>连接复用一条并在查询失败时作废,避免厂商服务端重启后长期持有失效连接;
  * 厂商库实测按固定 60 秒写库,取数频率远低于连接复用带来的收益门槛。
+ *
+ * <p>{@link DataSource} 接口中与连接获取无关的 JDK 样板方法(日志写出器、登录超时、父日志器、
+ * {@code unwrap} / {@code isWrapperFor})只转发驱动对象,不承载业务语义,因此不单独加方法注释。
  */
 public final class SingleConnectionVendorDataSource implements DataSource
 {
@@ -31,6 +34,7 @@
         this.credentials.setProperty("password", password == null ? "" : password);
     }
 
+    /** 返回复用的单条连接,必要时按登记凭据新建;厂商库只读,连接不做写事务。 */
     @Override
     public synchronized Connection getConnection() throws SQLException
     {
@@ -41,6 +45,7 @@
         return connection;
     }
 
+    /** 按给定账号临时新建一条连接,不复用也不替换已缓存的那条。 */
     @Override
     public Connection getConnection(String username, String password) throws SQLException
     {

--
Gitblit v1.7.1