-
Python sqlite3.complete_statement 适合判断当前缓冲区是否已经构成完整 SQL 语句,可避免按分号硬切时误伤 CREATE TRIGGER。本文给出逐行累积、多语句处理和执行错误边界。
-
Python argparse 的 add_subparsers 可以把一个命令行工具拆成相互独立的子命令。本文从 list 和 export 示例讲清 add_parser、set_defaults、默认命令、dest 以及主帮助和子命令帮助的组织方式。
-
Python relative_to 遇到非子路径时可捕获 ValueError;需要展示相对位置时,3.12 起可用 walk_up=True。本文区分两种调用契约,并说明跨盘、路径风格和版本迁移限制。
-
inspect.getattr_static 可以在不触发 property、__getattr__ 和 __getattribute__ 的情况下读取属性定义。本文对照 getattr 与静态读取,说明 property、动态属性和槽位描述符的边界。
-
Python 的 import 名与 pip 发行包名并不总是一致。本文用 importlib.metadata.packages_distributions() 建立顶层导入名到发行包列表的映射,并说明命名空间包、多提供者、空结果和可编辑安装的边界。
-
Pydantic model_validate_json 适合直接校验原始 JSON 请求体。本文用严格模型对比 model_validate 与 model_validate_json,解释日期、元组、错误定位和输入入口的选择边界。
-
Python hmac.compare_digest 只负责比较已有摘要。本文说明 digest 与 hexdigest 的类型配对、bytes 与 str 的边界、长度不一致的处理,以及如何把它放进可靠的 HMAC 校验流程。
-
Java Formatter 的十六进制格式关键在于把 x/X 转换符与 0 标志、最小宽度组合起来,例如 %08x 表示不足 8 位时在左侧补零。本文继续说明大写、# 前缀、负数、Locale 和日志输出中的稳定写法。
-
Java ReentrantLock.hasQueuedThreads() 用来观察是否有线程正在等待获取锁。本文区分它与 hasQueuedThread、getQueueLength 的用途,说明瞬时状态和取消竞争边界,并给出适合监控而非同步决策的写法。
-
Java Files.lines 返回惰性 Stream,适合按行遍历较大的文本文件。本文说明如何用 try-with-resources 确保文件关闭,如何显式指定 Charset,以及怎样区分打开阶段的 IOException 与消费阶段的 UncheckedIOException。
-
Java Optional.filter 用 Predicate 在链式调用中保留满足业务条件的值;值为空时不执行谓词,条件不满足时传播 empty。本文说明 filter 与 map、orElseThrow 的组合顺序、Predicate 边界和副作用处理。
-
Java Stream 多字段分组的关键是用 record 或值对象组成复合 key,再把 LinkedHashMap::new 传给 groupingBy 的 mapFactory。本文还说明如何用 downstream 保留组内顺序、只收集字段,以及 parallel stream 下为什么不能把顺序当成无条件保证。
-
Java 正则表达式可以用命名捕获组替代脆弱的数字组号。本文说明 (?...) 与 Matcher.group(String) 的配合方式,并区分可选组返回 null、空匹配和未成功匹配等边界。
-
StringBuilder.reverse 会把合法 UTF-16 代理对当作一个字符处理,避免高低代理项在反转时被拆开。本文用 Java 示例区分 char 单元、Unicode 代码点和图形簇,并说明手工反转、未配对代理项与组合字符的边界。
-
Java SequencedCollection 用 encounter order 统一集合两端读取和反向遍历。本文说明 getFirst、getLast、reversed 视图及首尾写入映射,并区分共享视图、独立快照和不可修改集合的边界。