package com.battery.device.bts;
|
|
import java.util.Locale;
|
import java.util.Set;
|
import java.util.regex.Matcher;
|
import java.util.regex.Pattern;
|
|
/**
|
* 新威 BTS 对外接口的**只读命令白名单**（ADR-0068 §1）。
|
*
|
* <p>启用厂商对外接口等于同时打开了控制通道：厂商协议里 {@code start}/{@code stop}/{@code reset}/
|
* {@code broadcaststop} 与只读命令走同一条管道、同一套报文格式，服务端不做区分。
|
* 因此"只观测不控制"这条不变量在新威这条路上**不是服务端保证，而是代码纪律**，
|
* 落点就是这里：每条出站请求在发出前按 {@code <cmd>} 取值比对白名单，不在白名单内的一律拒绝。
|
*
|
* <p>为什么拦在传输层而不是各调用处：调用处会随需求增加，白名单只有一处才可能被审计。
|
* 独立成类而不写在传输类里，是为了让这条边界能被单独测到（不需要真的有一条管道）。
|
*/
|
final class NewareBtsReadOnlyCommands
|
{
|
/** 允许发送的命令，全部是只读命令；取值来自《BTS API技术协议》与现场实测（ADR-0068）。 */
|
private static final Set<String> ALLOWED = Set.of(
|
"getdevinfo", "getchlstatus", "inquire", "inquiredf", "download",
|
"downloadsteplayer", "downloadlog", "getparallel", "getpause");
|
|
private static final Pattern COMMAND = Pattern.compile("<cmd>\\s*([A-Za-z_][A-Za-z0-9_]*)\\s*</cmd>");
|
|
private NewareBtsReadOnlyCommands()
|
{
|
}
|
|
/**
|
* 校验请求只含白名单内的命令，返回解析出的命令名（小写）。
|
*
|
* <p>没有 {@code <cmd>} 的报文不是本协议的请求，同样拒绝——放行一个解析不出命令的报文，
|
* 等于把"这道门"的判定权交给厂商服务端。
|
*
|
* @param request 完整请求报文
|
* @return 请求里的命令名（小写）
|
* @throws BtsTransportException 缺少命令，或命令不在只读白名单内
|
*/
|
static String requireAllowed(String request)
|
{
|
Matcher matcher = request == null ? null : COMMAND.matcher(request);
|
if (matcher == null || !matcher.find())
|
throw new BtsTransportException(BtsTransportException.Reason.READ_ONLY_REJECTED,
|
"BTS 请求缺少 <cmd>，拒绝发出", null);
|
String command = matcher.group(1).toLowerCase(Locale.ROOT);
|
if (!ALLOWED.contains(command))
|
throw new BtsTransportException(BtsTransportException.Reason.READ_ONLY_REJECTED,
|
"BTS 只读白名单外的命令被拒绝：" + command, null);
|
return command;
|
}
|
}
|
