开发JSP+Servlet Web应用：iText组合方案选型咨询

核心理由： #

• 职责清晰分离：Servlet专门承载业务逻辑（数据库查询、PDF生成、文件存储），JSP仅负责渲染用户输入表单这类视图内容，完全契合MVC设计思想，代码结构更整洁，后续维护和扩展更方便。
• 精准控制响应流：生成并返回PDF需要直接操作HTTP响应流，Servlet可以精准设置响应头（比如Content-Type: application/pdf、Content-Disposition: inline; filename=result.pdf），避免JSP中常见的输出缓冲、页面空白字符干扰问题——这些问题很容易导致PDF文件损坏，无法正常展示。
• 统一处理事务与异常：数据库查询、PDF生成、PDF存储这些操作集中在Servlet中，便于统一捕获异常、处理事务，不会因为JSP的视图渲染逻辑分散关注点。
• 规范访问资源：读取Tomcat部署目录下的PDF模板时，Servlet可以通过getServletContext().getRealPath("/pdf/模板文件名.pdf")便捷获取文件真实路径，操作更规范可靠。

为什么不推荐iText+JSP： #

• JSP的核心定位是生成HTML视图，嵌入PDF生成代码会让页面逻辑混杂，违背单一职责原则。
• JSP自动生成的输出流（out对象）容易和iText的PDF输出流冲突，导致PDF文件格式损坏，排查问题难度大。

简单代码示例（Servlet核心逻辑）： #

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    // 1. 获取用户输入并查询数据库
    String userId = request.getParameter("userId");
    User targetUser = userRepository.queryUserById(userId); // 自定义数据库查询类

    // 2. 加载PDF模板
    String templatePath = getServletContext().getRealPath("/pdf/user_template.pdf");
    PdfReader pdfReader = new PdfReader(templatePath);
    ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
    PdfStamper pdfStamper = new PdfStamper(pdfReader, outputStream);

    // 3. 填充模板字段
    AcroFields formFields = pdfStamper.getAcroFields();
    formFields.setField("user_name", targetUser.getUsername());
    formFields.setField("user_email", targetUser.getEmail());
    formFields.setField("user_phone", targetUser.getPhone());
    // 可选：扁平化表单，防止用户修改
    pdfStamper.setFormFlattening(true);
    
    pdfStamper.close();
    pdfReader.close();

    // 4. 输出PDF到浏览器展示
    response.setContentType("application/pdf");
    response.setContentLength(outputStream.size());
    OutputStream browserOut = response.getOutputStream();
    outputStream.writeTo(browserOut);
    browserOut.flush();

    // 5. 将填充后的PDF保存到MySQL
    byte[] pdfData = outputStream.toByteArray();
    pdfRepository.savePdf(userId, pdfData); // 自定义PDF存储类
}

内容的提问来源于stack exchange，提问作者stockton