# DEMO-CALC-01:可操作的网页计算器 ## 背景与用户 员工需要在内网快速核算公式,现有简单输入框不能解释优先级或处理错误。本场景交付可直接使用的计算器网站,运算由Java服务执行,页面负责输入和结果展示。 ## 页面与交互 标题“工程计算器”,主卡片包含表达式输入框、结果显示区、数字键盘0–9、小数点、加减乘除、左右括号、退格、清空和等号;旁边显示最近10条成功计算记录,窄屏放到下方。默认示例(12.5+7.5)*3,等于60。历史记录点击后回填输入,不自动重新执行。 物理键盘可输入公式,Enter计算,Escape清空;每个按钮有明确标签,焦点可见。计算时按钮显示忙碌且防止重复请求;服务返回后再显示结果,不演示虚假延迟。除零或非法表达式在结果区给可理解错误并保留输入。成功结果可作为下次运算起点;结果字符串可复制。 修改输入、历史回填或清空后,旧结果与复制状态立即失效,重新计算后才能复制。应用只展示输入、结果、历史和业务错误,不显示原始接口JSON、源码摘要、沙箱步骤或代码下载;开发证据保留在工作台。预览准备由平台内部完成,成果页面使用独立端口。 ## 编程需求与验收 - CALC-01:Java17标准库HttpServer,GET /health。GET /api/calculate的唯一参数expression64为UTF-8表达式的无填充base64url;公开凭据demo-calculator,不接受任意脚本、eval或脚本引擎。 - CALC-02:实现真正的表达式解析,支持+-*/、括号、空格、一元正负。乘除优先于加减,括号优先。2+3*4=14,(2+3)*4=20,-3+5=2。 - CALC-03:用BigDecimal和DECIMAL128处理中间运算,最终最多12位小数,HALF_UP,去除尾零,不用科学记数法。0.1+0.2=0.3;1/3显示0.333333333333;连续运算可使用上次结果。 - CALC-04:除零400 DIVISION_BY_ZERO;缺括号、连续非法运算、字母等400 INVALID_EXPRESSION;1+-2、--1属于合法一元符号。缺失、重复、未知参数及非法编码400 INVALID_INPUT。 - CALC-05:表达式最多128字符、括号16层、64次运算;单个数字字面量最多24位(不含小数点),数值绝对值≤1e24;超限422 LIMIT_EXCEEDED。编码参数最多256字符,超限400 INVALID_INPUT。无身份401、非GET405、未知路径404,线程与输入有界。 - CALC-06:独立HTTP系统测试覆盖算术、精度、结合顺序、负号、边界和错误;网页测试点击键盘与Enter、历史回填、连续运算、除零展示、窄屏布局。 ### 接口与Java实现补充约束 成功和失败都必须返回UTF-8 JSON对象,不能直接返回错误码文本或HttpServer默认HTML。成功包络为`{"expression":"原始表达式(保留空格)","result":"结果字符串"}`,错误包络统一为`{"error":"对应错误码"}`;未知路径也返回404 `{"error":"NOT_FOUND"}`。可注册统一根处理器,再精确匹配路径和方法,避免默认路由漏出HTML。 数字语法为`digits ('.' digits+)?`或`'.' digits+`;`.5`合法,`1.`非法。允许标记之间的ASCII空格,保留原输入;` 12 + ( 3 * 2 ) `等于18,`1 2`仍非法,不能简单删除全部空白。严格UTF-8解码须使用CharsetDecoder的REPORT模式,不能用会替换非法字节的默认字符串构造。需要ByteBuffer/CharBuffer时应显式导入`java.nio.ByteBuffer`和`java.nio.CharBuffer`,或使用完整类名,确保Java17实际编译。此处是公开接口和编程约束,不允许修改保护测试。 ## 交付与完成条件 交付Java源码、配套HTML/CSS/JS页面、需求与技术说明、差异、测试对应表、实际沙箱编译和测试证据、可下载ZIP及本地网站。生成源码限定src/main/java/demo/App.java及可选docs,不引入框架或修改保护测试;受控网页模板作为独立交付文件明确来源。失败必须留存诊断并修复复测,不以静态数字冒充Java执行结果。 HF验收批次 20261024T043922Z calculator。完整实现上述需求;模型、框架和权限仍由服务端冻结契约决定。