尧图网页设计 
简介这份资源面向JavaWeb初学者与课程设计开发者围绕“调取第三方API实现翻译功能”这一典型场景提供一套可运行的完整项目参考。内容涵盖前端Cookie缓存、后端Servlet与JSP协同、Redis缓存翻译结果、MVC分层设计以及API限流、错误处理与密钥安全等实践要点帮助读者理解HTTP协议、JSON数据格式与RESTful接口调用在真实项目中的落地方式。压缩包共94个文件约2.23MB以xml配置、class字节码、jar依赖、js脚本、css样式与java源码为主另含jsp页面、html入口及课程设计报告文档目录结构清晰便于按模块查阅。目前已有197人学习。通过分析源码与调试流程读者可掌握缓存优化、前后端交互与接口调用的排错思路适合作为课程设计或自学练手项目。1. 从一份 JavaWeb 课程设计压缩包说起它到底能不能跑起来打开这份基于 javaweb 程序调取 API 实现翻译功能.zip第一眼看到的不是业务代码而是一堆javax.jms.jar、javax.annotation.jar、javax.servlet.jsp.jstl.jar这类 Java EE 时代的依赖包外加src/servlet、src/utils、web/WEB-INF、out/artifacts和一份web应用开发课程设计报告.docx。这不是一个 Spring Boot 项目而是一个典型的、用原生 Servlet JSP 手搓出来的 JavaWeb 课程设计。它的核心链路很清晰前端页面收集待翻译文本Servlet 接住请求utils 里的工具类去调在线翻译 API拿到 JSON 结果后回写页面中间用 Cookie 和 Redis 做两级缓存。适合谁看如果你正在做 JavaWeb 课程设计、需要一份能交作业又能讲清楚原理的参考实现或者你刚学完 Servlet/JSP 想找一个带真实 API 调用的练手项目这份资源是够用的。但如果你期待的是开箱即用的生产级翻译服务那得先接受它的定位——教学项目依赖偏老配置得自己补。下面按「先跑通、再优化、最后避坑」的顺序拆。2. 环境搭建与项目导入把压缩包变成能跑的 Web 应用2.1 依赖结构与 JDK/Tomcat 版本选择先看目录里的 jar 包清单javax.servlet.jar、javax.servlet.jsp.jar、javax.servlet.jsp.jstl.jar、javax.persistence.jar、javax.ejb.jar、javax.jms.jar、javax.annotation.jar、javax.transaction.jar、javax.resource.jar。这套组合是 Java EE 5/6 时代的典型配置说明项目没有用 Maven 或 Gradle 管理依赖而是把 jar 直接丢在WEB-INF/lib下压缩包里以1218_java lib形式呈现。这意味着你不能指望 IDEA 自动帮你解析依赖树得手动把这些 jar 加到模块的 Libraries 里。JDK 选 8 最稳。JDK 11 之后javax.*包名逐步被jakarta.*取代虽然 JDK 8 编译的字节码在高版本 JVM 上能跑但 Tomcat 10 开始默认走 Jakarta EE 命名空间javax.servlet直接找不到类。所以版本组合建议锁死JDK 8 Tomcat 8.5 或 9.0。Tomcat 9 仍然兼容javax.servlet是这套代码的舒适区。导入步骤不复杂但有几个点容易翻车# 1. 解压后确认目录结构 unzip 基于javaweb程序调取API实现翻译功能.zip -d fanyi-project cd fanyi-project # 典型结构src/ web/ out/ .idea/ fanyi.iml README.md # 2. 检查 web/WEB-INF 下是否有 web.xml 和 lib 目录 ls web/WEB-INF/ # 期望看到web.xml lib/ classes/或由 IDEA 编译输出到 out/artifacts逻辑说明src放 Java 源码web是 Web 资源根目录WEB-INF/web.xml是部署描述符lib放第三方 jar。out/artifacts/production是 IDEA 的编译输出导入后可以删掉重新构建避免旧 class 干扰。参数说明如果你用 IDEAFile → Project Structure → Modules里把src标记为 Sourcesweb标记为 Web Resource Directory然后在Artifacts里新建一个Web Application: Exploded输出目录指向out/artifacts/production。Libraries里把WEB-INF/lib下所有 jar 加进去。这一步不做编译时javax.servlet.http.HttpServlet会直接报红。2.2 在 IDEA 中配置 Tomcat 并跑通第一个 Servlet配置 Tomcat 的入口在Run → Edit Configurations → → Tomcat Server → Local。关键参数只有三个Application server指向本机 Tomcat 安装目录HTTP port默认 8080被占用就改 8081Deployment标签页里加一个Artifact选刚才建的 exploded 包Application context填/fanyi。!-- web/WEB-INF/web.xml 里应该有 servlet 映射确认类似配置存在 -- servlet servlet-nameTranslateServlet/servlet-name servlet-classservlet.TranslateServlet/servlet-class /servlet servlet-mapping servlet-nameTranslateServlet/servlet-name url-pattern/translate/url-pattern /servlet-mapping逻辑说明servlet-class必须和src/servlet下的真实类名一致包名不能错。如果项目用的是WebServlet(/translate)注解方式那web.xml里可能没有这段两者选其一即可不要重复映射否则启动时报Servlet mapping conflict。参数说明url-pattern决定前端请求路径。假设 context 是/fanyi那前端index.html里的请求地址应该是/fanyi/translate少一层前缀就是 404。启动后浏览器访问http://localhost:8080/fanyi/index.html能看到页面说明部署成功点翻译按钮没反应就按 F12 看 Network 里请求发到哪了。常见做法是先在utils包里找到调 API 的工具类把里面的 API Key 占位符换成自己的。如果用的是某翻译平台的 RESTful 接口通常需要appid和key两个参数缺一个就返回 401。这一步不补页面能打开但翻译永远失败。3. 翻译链路拆解Servlet 调 API、JSON 解析与两级缓存落地3.1 Servlet 接收请求并转发给翻译 API整个后端的入口是一个继承HttpServlet的类重写doGet或doPost。前端用fetch或XMLHttpRequest把待翻译文本发过来Servlet 拿到参数后拼装成目标 API 要求的请求格式。以常见的 RESTful 翻译接口为例通常是 POST 一个 JSON body带q待翻译文本、source、target三个字段。// src/servlet/TranslateServlet.java 核心逻辑示意 protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { req.setCharacterEncoding(UTF-8); resp.setContentType(application/json;charsetUTF-8); String text req.getParameter(text); String from req.getParameter(from); // 如 auto String to req.getParameter(to); // 如 en // 1. 先查 Redis 缓存 String cacheKey from : to : text; String cached RedisUtil.get(cacheKey); if (cached ! null) { resp.getWriter().write({\result\:\ cached \,\from\:\cache\}); return; } // 2. 缓存未命中调 API String result; try { result TranslateApiUtil.call(text, from, to); } catch (Exception e) { resp.setStatus(502); resp.getWriter().write({\error\:\翻译服务暂时不可用\}); return; } // 3. 写回 Redis设置过期时间 RedisUtil.setex(cacheKey, 3600, result); resp.getWriter().write({\result\:\ result \,\from\:\api\}); }逻辑说明先查缓存再调 API 是标准套路能显著降低 API 调用量和响应延迟。from字段返回cache还是api方便前端调试时确认缓存是否生效。异常分支返回 502 而不是 500语义上更准确——是上游 API 的问题不是本服务崩溃。参数说明RedisUtil.setex的第三个参数是过期秒数设 3600 表示一小时。设太短缓存命中率低设太长翻译结果可能过时对翻译场景其实无所谓但课程设计报告里可以写「根据业务热度调整」。req.setCharacterEncoding(UTF-8)必须在getParameter之前调用否则中文会乱码这是血泪经验。3.2 JSON 解析与前端 Cookie 缓存的配合API 返回的通常是 JSON解析方式取决于你引入的库。这份资源没有明确带 Gson 或 Jackson常见做法是手动字符串截取或用org.json。如果WEB-INF/lib里没有 JSON 库建议加一个gson-2.8.9.jar比手写正则靠谱得多。// utils/TranslateApiUtil.java 解析返回 JSON public static String call(String text, String from, String to) throws Exception { String url https://api.example.com/translate; String body String.format({\q\:\%s\,\source\:\%s\,\target\:\%s\}, text.replace(\, \\\), from, to); HttpURLConnection conn (HttpURLConnection) new URL(url).openConnection(); conn.setRequestMethod(POST); conn.setRequestProperty(Content-Type, application/json); conn.setRequestProperty(Authorization, Bearer API_KEY); conn.setDoOutput(true); conn.getOutputStream().write(body.getBytes(UTF-8)); if (conn.getResponseCode() ! 200) { throw new RuntimeException(API status conn.getResponseCode()); } String json new String(conn.getInputStream().readAllBytes(), UTF-8); // 用 Gson 解析出 translatedText 字段 JsonObject obj JsonParser.parseString(json).getAsJsonObject(); return obj.get(translatedText).getAsString(); }逻辑说明text.replace(\, \\\)是防止用户输入引号破坏 JSON 结构虽然不完美但课程设计够用。Authorization头放 API Key注意不要把它硬编码后提交到公开仓库。readAllBytes()是 JDK 9 的方法JDK 8 下要用BufferedReader循环读。参数说明API_KEY建议从环境变量或web.xml的context-param读取不要写死在源码里。前端 Cookie 缓存则由 JS 负责用户点翻译后先把text的 MD5 作为 key 存进 Cookie下次同样输入先查 Cookie命中就直接显示连后端都不请求。Cookie 容量只有 4KB 左右别存长文本存个哈希标记就行。3.3 Redis 缓存的键设计与限流策略Redis 在这套链路里承担「跨用户共享缓存」的角色。同一个词被不同用户查第一次调 API后面全走 Redis。键的设计直接决定命中率from:to:text的拼接方式简单直观但text太长会让 key 膨胀。常见做法是对text做 MD5 再拼长度固定且避免特殊字符。// utils/RedisUtil.java 简易封装 public class RedisUtil { private static JedisPool pool new JedisPool(localhost, 6379); public static String get(String key) { try (Jedis jedis pool.getResource()) { return jedis.get(key); } } public static void setex(String key, int seconds, String value) { try (Jedis jedis pool.getResource()) { jedis.setex(key, seconds, value); } } }逻辑说明JedisPool是连接池避免每次请求新建连接。try-with-resources确保连接归还。如果 Redis 没启动getResource会抛异常整个翻译功能挂掉——所以生产上要加降级Redis 连不上就直接调 API不要让缓存层拖垮主流程。参数说明JedisPool默认连localhost:6379改地址就改构造参数。限流策略可以在 Servlet 里加一个基于AtomicInteger的计数器每分钟超过 N 次就返回 429。课程设计里写「令牌桶」或「滑动窗口」都行但代码别太复杂能讲清楚即可。4. 避坑与排查从 401 到乱码的五个真实翻车点4.1 现象调用 API 返回 401 Unauthorized提示 incorrect api key原因API Key 没填、填错、或者请求头格式不对。有些平台要求Authorization: Bearer sk-xxx有些要求把 key 放在 URL 参数里还有的要求签名。课程设计里最常见的是直接复制了示例代码但没换 key。解决先确认utils里API_KEY常量是不是还是占位符。然后用 Postman 单独测一次 API排除代码问题。如果 Postman 能通、代码不通检查请求头字段名大小写——HTTP 头不区分大小写但某些服务端实现会挑。最后确认 key 有没有多余空格。4.2 现象页面中文显示为问号或乱码原因三处编码没统一——前端 HTML 的meta charset、Servlet 的setCharacterEncoding、Tomcat 的URIEncoding。任何一处是 ISO-8859-1中文就废。解决HTML 里写meta charsetUTF-8Servlet 里req.setCharacterEncoding(UTF-8)和resp.setContentType(text/html;charsetUTF-8)都加上Tomcat 的server.xml里 Connector 加URIEncodingUTF-8。三处齐了才稳。4.3 现象Redis 连接超时翻译功能整体不可用原因代码里 Redis 查询没有 try-catchRedis 一挂异常直接冒泡到 Servlet用户看到 500。课程设计演示时如果没先启动 Redis必翻车。解决把 Redis 操作包在 try-catch 里捕获JedisConnectionException后返回 null让流程继续走 API 调用。缓存是加速手段不是必需依赖这个降级思路在报告里也是加分项。4.4 现象Tomcat 启动报 ClassNotFoundException: javax.servlet.http.HttpServlet原因Tomcat 10 默认用 Jakarta EE 9包名是jakarta.servlet.*而项目代码和 jar 都是javax.servlet.*。版本不匹配。解决换 Tomcat 9.0.x或者把项目迁移到 Jakarta 命名空间改 import 和依赖工作量大课程设计没必要。最省事的就是锁 Tomcat 9。4.5 现象前端请求 404但 Servlet 明明写了原因url-pattern和前端请求路径对不上或者 context path 没算进去。比如 context 是/fanyiurl-pattern是/translate前端却请求/translate而不是/fanyi/translate。解决F12 看 Network 里实际请求 URL和web.xml里的映射逐段比对。IDEA 的 Tomcat 配置里Application context填了什么前端就要带什么前缀。改成相对路径translate也能避开这个问题。5. 进阶技巧把课程设计讲成能过答辩的技术方案5.1 用 AOP 思路统一记录 API 调用量与缓存命中率课程设计答辩时老师最爱问「你怎么证明缓存有效」。与其口头说不如在utils里加一个简单的统计类用AtomicLong记录apiCalls和cacheHits每处理一次请求就自增。然后在页面底部或单独一个/stats接口输出两个数字命中率一目了然。public class Stats { public static final AtomicLong API_CALLS new AtomicLong(); public static final AtomicLong CACHE_HITS new AtomicLong(); public static String report() { long api API_CALLS.get(); long hit CACHE_HITS.get(); long total api hit; double rate total 0 ? 0 : (hit * 100.0 / total); return String.format(总请求:%d API调用:%d 缓存命中:%d 命中率:%.1f%%, total, api, hit, rate); } }逻辑说明在 Servlet 的缓存命中分支里CACHE_HITS.incrementAndGet()在调 API 分支里API_CALLS.incrementAndGet()。report()返回的字符串可以直接写进响应或者存到application作用域供 JSP 读取。这个改动不到 20 行但答辩时能直接甩数据。参数说明AtomicLong保证并发安全比long加synchronized轻量。命中率低于 30% 说明 key 设计有问题或者测试时每次输入都不一样——演示时记得用同一句话连点两次。5.2 把 API Key 从源码里挪出去硬编码 key 是课程设计的通病也是答辩时容易被挑的点。最简单的改法是在web.xml里加context-paramServlet 初始化时用getServletContext().getInitParameter(apiKey)读取。context-param param-nameapiKey/param-name param-value${API_KEY}/param-value /context-param逻辑说明${API_KEY}是占位符实际部署时在 Tomcat 的setenv.sh或 IDEA 的 VM options 里传-DAPI_KEYsk-xxx再用System.getProperty覆盖。这样源码里看不到真实 key提交到公开仓库也不怕。参数说明如果嫌麻烦至少把 key 写在一个config.properties里.gitignore掉这个文件仓库里只留config.properties.example。这个习惯我从第一次把 key 推到公开仓库后就强制自己养成了每次新建项目先写.gitignore。5.3 验证清单答辩前跑一遍这五步检查项操作预期结果环境JDK 8 Tomcat 9 启动无 ClassNotFound 异常页面访问/fanyi/index.html页面正常渲染无乱码翻译输入「你好」点翻译返回英文结果Network 显示 200缓存再点一次同样输入响应里from字段为cache降级停掉 Redis 再翻译仍能返回结果不报 500这张表我每次交付课程设计前都会走一遍尤其是最后一条降级测试很多同学只测正常流程一停 Redis 就露馅。把这五步跑通答辩时老师随便挑一个场景你都能接住。从那以后我每次拿到这种课程设计压缩包都先看WEB-INF/lib里的 jar 清单定版本再找utils里的 API 调用类确认 key 的位置最后才动手配 Tomcat。顺序反了就会在环境上耗掉大半时间。希望帮到你。本文还有配套的精品资源点击获取 JavaWeb课程设计实战：Servlet调取翻译API与Redis缓存实现
简介这份资源面向JavaWeb初学者与课程设计开发者围绕“调取第三方API实现翻译功能”这一典型场景提供一套可运行的完整项目参考。内容涵盖前端Cookie缓存、后端Servlet与JSP协同、Redis缓存翻译结果、MVC分层设计以及API限流、错误处理与密钥安全等实践要点帮助读者理解HTTP协议、JSON数据格式与RESTful接口调用在真实项目中的落地方式。压缩包共94个文件约2.23MB以xml配置、class字节码、jar依赖、js脚本、css样式与java源码为主另含jsp页面、html入口及课程设计报告文档目录结构清晰便于按模块查阅。目前已有197人学习。通过分析源码与调试流程读者可掌握缓存优化、前后端交互与接口调用的排错思路适合作为课程设计或自学练手项目。1. 从一份 JavaWeb 课程设计压缩包说起它到底能不能跑起来打开这份基于 javaweb 程序调取 API 实现翻译功能.zip第一眼看到的不是业务代码而是一堆javax.jms.jar、javax.annotation.jar、javax.servlet.jsp.jstl.jar这类 Java EE 时代的依赖包外加src/servlet、src/utils、web/WEB-INF、out/artifacts和一份web应用开发课程设计报告.docx。这不是一个 Spring Boot 项目而是一个典型的、用原生 Servlet JSP 手搓出来的 JavaWeb 课程设计。它的核心链路很清晰前端页面收集待翻译文本Servlet 接住请求utils 里的工具类去调在线翻译 API拿到 JSON 结果后回写页面中间用 Cookie 和 Redis 做两级缓存。适合谁看如果你正在做 JavaWeb 课程设计、需要一份能交作业又能讲清楚原理的参考实现或者你刚学完 Servlet/JSP 想找一个带真实 API 调用的练手项目这份资源是够用的。但如果你期待的是开箱即用的生产级翻译服务那得先接受它的定位——教学项目依赖偏老配置得自己补。下面按「先跑通、再优化、最后避坑」的顺序拆。2. 环境搭建与项目导入把压缩包变成能跑的 Web 应用2.1 依赖结构与 JDK/Tomcat 版本选择先看目录里的 jar 包清单javax.servlet.jar、javax.servlet.jsp.jar、javax.servlet.jsp.jstl.jar、javax.persistence.jar、javax.ejb.jar、javax.jms.jar、javax.annotation.jar、javax.transaction.jar、javax.resource.jar。这套组合是 Java EE 5/6 时代的典型配置说明项目没有用 Maven 或 Gradle 管理依赖而是把 jar 直接丢在WEB-INF/lib下压缩包里以1218_java lib形式呈现。这意味着你不能指望 IDEA 自动帮你解析依赖树得手动把这些 jar 加到模块的 Libraries 里。JDK 选 8 最稳。JDK 11 之后javax.*包名逐步被jakarta.*取代虽然 JDK 8 编译的字节码在高版本 JVM 上能跑但 Tomcat 10 开始默认走 Jakarta EE 命名空间javax.servlet直接找不到类。所以版本组合建议锁死JDK 8 Tomcat 8.5 或 9.0。Tomcat 9 仍然兼容javax.servlet是这套代码的舒适区。导入步骤不复杂但有几个点容易翻车# 1. 解压后确认目录结构 unzip 基于javaweb程序调取API实现翻译功能.zip -d fanyi-project cd fanyi-project # 典型结构src/ web/ out/ .idea/ fanyi.iml README.md # 2. 检查 web/WEB-INF 下是否有 web.xml 和 lib 目录 ls web/WEB-INF/ # 期望看到web.xml lib/ classes/或由 IDEA 编译输出到 out/artifacts逻辑说明src放 Java 源码web是 Web 资源根目录WEB-INF/web.xml是部署描述符lib放第三方 jar。out/artifacts/production是 IDEA 的编译输出导入后可以删掉重新构建避免旧 class 干扰。参数说明如果你用 IDEAFile → Project Structure → Modules里把src标记为 Sourcesweb标记为 Web Resource Directory然后在Artifacts里新建一个Web Application: Exploded输出目录指向out/artifacts/production。Libraries里把WEB-INF/lib下所有 jar 加进去。这一步不做编译时javax.servlet.http.HttpServlet会直接报红。2.2 在 IDEA 中配置 Tomcat 并跑通第一个 Servlet配置 Tomcat 的入口在Run → Edit Configurations → → Tomcat Server → Local。关键参数只有三个Application server指向本机 Tomcat 安装目录HTTP port默认 8080被占用就改 8081Deployment标签页里加一个Artifact选刚才建的 exploded 包Application context填/fanyi。!-- web/WEB-INF/web.xml 里应该有 servlet 映射确认类似配置存在 -- servlet servlet-nameTranslateServlet/servlet-name servlet-classservlet.TranslateServlet/servlet-class /servlet servlet-mapping servlet-nameTranslateServlet/servlet-name url-pattern/translate/url-pattern /servlet-mapping逻辑说明servlet-class必须和src/servlet下的真实类名一致包名不能错。如果项目用的是WebServlet(/translate)注解方式那web.xml里可能没有这段两者选其一即可不要重复映射否则启动时报Servlet mapping conflict。参数说明url-pattern决定前端请求路径。假设 context 是/fanyi那前端index.html里的请求地址应该是/fanyi/translate少一层前缀就是 404。启动后浏览器访问http://localhost:8080/fanyi/index.html能看到页面说明部署成功点翻译按钮没反应就按 F12 看 Network 里请求发到哪了。常见做法是先在utils包里找到调 API 的工具类把里面的 API Key 占位符换成自己的。如果用的是某翻译平台的 RESTful 接口通常需要appid和key两个参数缺一个就返回 401。这一步不补页面能打开但翻译永远失败。3. 翻译链路拆解Servlet 调 API、JSON 解析与两级缓存落地3.1 Servlet 接收请求并转发给翻译 API整个后端的入口是一个继承HttpServlet的类重写doGet或doPost。前端用fetch或XMLHttpRequest把待翻译文本发过来Servlet 拿到参数后拼装成目标 API 要求的请求格式。以常见的 RESTful 翻译接口为例通常是 POST 一个 JSON body带q待翻译文本、source、target三个字段。// src/servlet/TranslateServlet.java 核心逻辑示意 protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { req.setCharacterEncoding(UTF-8); resp.setContentType(application/json;charsetUTF-8); String text req.getParameter(text); String from req.getParameter(from); // 如 auto String to req.getParameter(to); // 如 en // 1. 先查 Redis 缓存 String cacheKey from : to : text; String cached RedisUtil.get(cacheKey); if (cached ! null) { resp.getWriter().write({\result\:\ cached \,\from\:\cache\}); return; } // 2. 缓存未命中调 API String result; try { result TranslateApiUtil.call(text, from, to); } catch (Exception e) { resp.setStatus(502); resp.getWriter().write({\error\:\翻译服务暂时不可用\}); return; } // 3. 写回 Redis设置过期时间 RedisUtil.setex(cacheKey, 3600, result); resp.getWriter().write({\result\:\ result \,\from\:\api\}); }逻辑说明先查缓存再调 API 是标准套路能显著降低 API 调用量和响应延迟。from字段返回cache还是api方便前端调试时确认缓存是否生效。异常分支返回 502 而不是 500语义上更准确——是上游 API 的问题不是本服务崩溃。参数说明RedisUtil.setex的第三个参数是过期秒数设 3600 表示一小时。设太短缓存命中率低设太长翻译结果可能过时对翻译场景其实无所谓但课程设计报告里可以写「根据业务热度调整」。req.setCharacterEncoding(UTF-8)必须在getParameter之前调用否则中文会乱码这是血泪经验。3.2 JSON 解析与前端 Cookie 缓存的配合API 返回的通常是 JSON解析方式取决于你引入的库。这份资源没有明确带 Gson 或 Jackson常见做法是手动字符串截取或用org.json。如果WEB-INF/lib里没有 JSON 库建议加一个gson-2.8.9.jar比手写正则靠谱得多。// utils/TranslateApiUtil.java 解析返回 JSON public static String call(String text, String from, String to) throws Exception { String url https://api.example.com/translate; String body String.format({\q\:\%s\,\source\:\%s\,\target\:\%s\}, text.replace(\, \\\), from, to); HttpURLConnection conn (HttpURLConnection) new URL(url).openConnection(); conn.setRequestMethod(POST); conn.setRequestProperty(Content-Type, application/json); conn.setRequestProperty(Authorization, Bearer API_KEY); conn.setDoOutput(true); conn.getOutputStream().write(body.getBytes(UTF-8)); if (conn.getResponseCode() ! 200) { throw new RuntimeException(API status conn.getResponseCode()); } String json new String(conn.getInputStream().readAllBytes(), UTF-8); // 用 Gson 解析出 translatedText 字段 JsonObject obj JsonParser.parseString(json).getAsJsonObject(); return obj.get(translatedText).getAsString(); }逻辑说明text.replace(\, \\\)是防止用户输入引号破坏 JSON 结构虽然不完美但课程设计够用。Authorization头放 API Key注意不要把它硬编码后提交到公开仓库。readAllBytes()是 JDK 9 的方法JDK 8 下要用BufferedReader循环读。参数说明API_KEY建议从环境变量或web.xml的context-param读取不要写死在源码里。前端 Cookie 缓存则由 JS 负责用户点翻译后先把text的 MD5 作为 key 存进 Cookie下次同样输入先查 Cookie命中就直接显示连后端都不请求。Cookie 容量只有 4KB 左右别存长文本存个哈希标记就行。3.3 Redis 缓存的键设计与限流策略Redis 在这套链路里承担「跨用户共享缓存」的角色。同一个词被不同用户查第一次调 API后面全走 Redis。键的设计直接决定命中率from:to:text的拼接方式简单直观但text太长会让 key 膨胀。常见做法是对text做 MD5 再拼长度固定且避免特殊字符。// utils/RedisUtil.java 简易封装 public class RedisUtil { private static JedisPool pool new JedisPool(localhost, 6379); public static String get(String key) { try (Jedis jedis pool.getResource()) { return jedis.get(key); } } public static void setex(String key, int seconds, String value) { try (Jedis jedis pool.getResource()) { jedis.setex(key, seconds, value); } } }逻辑说明JedisPool是连接池避免每次请求新建连接。try-with-resources确保连接归还。如果 Redis 没启动getResource会抛异常整个翻译功能挂掉——所以生产上要加降级Redis 连不上就直接调 API不要让缓存层拖垮主流程。参数说明JedisPool默认连localhost:6379改地址就改构造参数。限流策略可以在 Servlet 里加一个基于AtomicInteger的计数器每分钟超过 N 次就返回 429。课程设计里写「令牌桶」或「滑动窗口」都行但代码别太复杂能讲清楚即可。4. 避坑与排查从 401 到乱码的五个真实翻车点4.1 现象调用 API 返回 401 Unauthorized提示 incorrect api key原因API Key 没填、填错、或者请求头格式不对。有些平台要求Authorization: Bearer sk-xxx有些要求把 key 放在 URL 参数里还有的要求签名。课程设计里最常见的是直接复制了示例代码但没换 key。解决先确认utils里API_KEY常量是不是还是占位符。然后用 Postman 单独测一次 API排除代码问题。如果 Postman 能通、代码不通检查请求头字段名大小写——HTTP 头不区分大小写但某些服务端实现会挑。最后确认 key 有没有多余空格。4.2 现象页面中文显示为问号或乱码原因三处编码没统一——前端 HTML 的meta charset、Servlet 的setCharacterEncoding、Tomcat 的URIEncoding。任何一处是 ISO-8859-1中文就废。解决HTML 里写meta charsetUTF-8Servlet 里req.setCharacterEncoding(UTF-8)和resp.setContentType(text/html;charsetUTF-8)都加上Tomcat 的server.xml里 Connector 加URIEncodingUTF-8。三处齐了才稳。4.3 现象Redis 连接超时翻译功能整体不可用原因代码里 Redis 查询没有 try-catchRedis 一挂异常直接冒泡到 Servlet用户看到 500。课程设计演示时如果没先启动 Redis必翻车。解决把 Redis 操作包在 try-catch 里捕获JedisConnectionException后返回 null让流程继续走 API 调用。缓存是加速手段不是必需依赖这个降级思路在报告里也是加分项。4.4 现象Tomcat 启动报 ClassNotFoundException: javax.servlet.http.HttpServlet原因Tomcat 10 默认用 Jakarta EE 9包名是jakarta.servlet.*而项目代码和 jar 都是javax.servlet.*。版本不匹配。解决换 Tomcat 9.0.x或者把项目迁移到 Jakarta 命名空间改 import 和依赖工作量大课程设计没必要。最省事的就是锁 Tomcat 9。4.5 现象前端请求 404但 Servlet 明明写了原因url-pattern和前端请求路径对不上或者 context path 没算进去。比如 context 是/fanyiurl-pattern是/translate前端却请求/translate而不是/fanyi/translate。解决F12 看 Network 里实际请求 URL和web.xml里的映射逐段比对。IDEA 的 Tomcat 配置里Application context填了什么前端就要带什么前缀。改成相对路径translate也能避开这个问题。5. 进阶技巧把课程设计讲成能过答辩的技术方案5.1 用 AOP 思路统一记录 API 调用量与缓存命中率课程设计答辩时老师最爱问「你怎么证明缓存有效」。与其口头说不如在utils里加一个简单的统计类用AtomicLong记录apiCalls和cacheHits每处理一次请求就自增。然后在页面底部或单独一个/stats接口输出两个数字命中率一目了然。public class Stats { public static final AtomicLong API_CALLS new AtomicLong(); public static final AtomicLong CACHE_HITS new AtomicLong(); public static String report() { long api API_CALLS.get(); long hit CACHE_HITS.get(); long total api hit; double rate total 0 ? 0 : (hit * 100.0 / total); return String.format(总请求:%d API调用:%d 缓存命中:%d 命中率:%.1f%%, total, api, hit, rate); } }逻辑说明在 Servlet 的缓存命中分支里CACHE_HITS.incrementAndGet()在调 API 分支里API_CALLS.incrementAndGet()。report()返回的字符串可以直接写进响应或者存到application作用域供 JSP 读取。这个改动不到 20 行但答辩时能直接甩数据。参数说明AtomicLong保证并发安全比long加synchronized轻量。命中率低于 30% 说明 key 设计有问题或者测试时每次输入都不一样——演示时记得用同一句话连点两次。5.2 把 API Key 从源码里挪出去硬编码 key 是课程设计的通病也是答辩时容易被挑的点。最简单的改法是在web.xml里加context-paramServlet 初始化时用getServletContext().getInitParameter(apiKey)读取。context-param param-nameapiKey/param-name param-value${API_KEY}/param-value /context-param逻辑说明${API_KEY}是占位符实际部署时在 Tomcat 的setenv.sh或 IDEA 的 VM options 里传-DAPI_KEYsk-xxx再用System.getProperty覆盖。这样源码里看不到真实 key提交到公开仓库也不怕。参数说明如果嫌麻烦至少把 key 写在一个config.properties里.gitignore掉这个文件仓库里只留config.properties.example。这个习惯我从第一次把 key 推到公开仓库后就强制自己养成了每次新建项目先写.gitignore。5.3 验证清单答辩前跑一遍这五步检查项操作预期结果环境JDK 8 Tomcat 9 启动无 ClassNotFound 异常页面访问/fanyi/index.html页面正常渲染无乱码翻译输入「你好」点翻译返回英文结果Network 显示 200缓存再点一次同样输入响应里from字段为cache降级停掉 Redis 再翻译仍能返回结果不报 500这张表我每次交付课程设计前都会走一遍尤其是最后一条降级测试很多同学只测正常流程一停 Redis 就露馅。把这五步跑通答辩时老师随便挑一个场景你都能接住。从那以后我每次拿到这种课程设计压缩包都先看WEB-INF/lib里的 jar 清单定版本再找utils里的 API 调用类确认 key 的位置最后才动手配 Tomcat。顺序反了就会在环境上耗掉大半时间。希望帮到你。本文还有配套的精品资源点击获取