Java/JSP 呼叫 SQL Server 預存程序完整實戰：含二進位檔案與輸出參數處理

資料庫端：建立資料表與預存程序

首先建立支援二進位欄位的 BookUser 表：

CREATE TABLE [BookUser] (
    [UserID]      INT IDENTITY(1,1) NOT NULL PRIMARY KEY,
    [UserName]    VARCHAR(50) NOT NULL,
    [Title]       NVARCHAR(50) NOT NULL,
    [Guid]        UNIQUEIDENTIFIER NOT NULL DEFAULT NEWID(),
    [BirthDate]   DATETIME NOT NULL,
    [Description] NTEXT NOT NULL,
    [Photo]       IMAGE NULL,
    [Other]       VARCHAR(50) NULL DEFAULT '預設值'
);

建立新增使用者預存程序 InsertUser，驗證 Title 唯一性並回傳自增 ID：

CREATE PROCEDURE InsertUser
    @UserName     VARCHAR(50),
    @Title        VARCHAR(255),
    @Guid         UNIQUEIDENTIFIER,
    @BirthDate    DATETIME,
    @Description  NTEXT,
    @Photo        IMAGE,
    @Other        NVARCHAR(50),
    @UserID       INT OUTPUT
AS
BEGIN
    SET NOCOUNT ON;
    IF EXISTS (SELECT UserID FROM BookUser WHERE Title = @Title)
        RETURN 0;  -- 唯一性驗證失敗
    
    INSERT INTO BookUser (UserName, Title, Guid, BirthDate, Description, Photo, Other)
    VALUES (@UserName, @Title, @Guid, @BirthDate, @Description, @Photo, @Other);
    
    SET @UserID = @@IDENTITY;
    RETURN 1;  -- 成功
END

JSP 頁面完整呼叫程式碼

<%@ page language="java" import="java.util.*,java.sql.*,java.io.*" pageEncoding="UTF-8"%>
<%
    // 1. 載入 Microsoft 官方 JDBC 驅動 (需從微軟官網下載)
    Class.forName("com.microsoft.jdbc.sqlserver.SQLServerDriver");
    
    // 2. 連線字串：注意 useUnicode=true&characterEncoding=UTF-8 避免中文亂碼
    String url = "jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=owend;user=sa;password=;useUnicode=true;characterEncoding=UTF-8";
    
    // 3. 預存程序呼叫語法：{? = call ProcName(?,?,...)} 第一個 ? 對應 RETURN 值
    String sql = "{? = call InsertUser(?,?,?,?,?,?,?,?)}";
    
    Connection conn = null;
    CallableStatement cmd = null;
    
    try {
        conn = DriverManager.getConnection(url);
        cmd = conn.prepareCall(sql);
        
        // 4. 參數綁定（索引從 1 開始）
        cmd.registerOutParameter(1, Types.INTEGER);        // RETURN 值
        cmd.setString(2, "mengxianhui");                   // @UserName
        cmd.setString(3, "孟憲會2");                        // @Title
        cmd.setString(4, UUID.randomUUID().toString());    // @Guid
        cmd.setDate(5, Date.valueOf("2009-07-04"));        // @BirthDate
        cmd.setString(6, "【孟子E章】");                    // @Description
        
        // 5. 二進位檔案處理：使用 setBinaryStream
        String filePath = application.getRealPath("") + "/test/logo.gif";
        FileInputStream fis = new FileInputStream(filePath);
        cmd.setBinaryStream(7, fis, fis.available());      // @Photo (IMAGE)
        
        cmd.setString(8, "555");                           // @Other
        cmd.registerOutParameter(9, Types.INTEGER);        // @UserID OUTPUT
        
        // 6. 執行
        cmd.execute();
        
        // 7. 取得結果
        int returnValue = cmd.getInt(1);   // RETURN 值
        int userID = cmd.getInt(9);        // OUTPUT 參數
        
        if (returnValue == 1) {
            out.println("<li>新增成功！");
            out.println("<li>UserID = " + userID);
            out.println("<li>ReturnValue = " + returnValue);
        } else {
            out.println("<li>新增失敗：Title 已存在");
        }
        
        fis.close();
    } catch (Exception ex) {
        out.println("<li>錯誤：" + ex.getMessage());
        ex.printStackTrace();
    } finally {
        // 8. 資源釋放（逆序關閉）
        if (cmd != null) try { cmd.close(); } catch (Exception ignore) {}
        if (conn != null) try { conn.close(); } catch (Exception ignore) {}
    }
%>

關鍵技術要點總結表

常見錯誤與解決方案

1. ClassNotFoundException：確認 sqljdbc.jar 已放入 WEB-INF/lib 或 Tomcat lib 目錄
2. 中文亂碼：檢查 JSP pageEncoding、資料庫欄位型別、JDBC 連線字串編碼參數三者一致
3. 參數索引錯誤：CallableStatement 索引從 1 開始，且 第一個參數永遠是 RETURN 值
4. 檔案上傳失敗：確認 application.getRealPath("") 路徑正確，且檔案存在

掌握此完整流程，即可在 Java Web 專案中穩健處理預存程序呼叫、二進位檔案存儲與輸出參數接收。