J2SE 核心觀念：私有建構子的設計意圖與常見誤區

私有建構子（private constructor）是 Java 類別設計中的重要模式，常用於單例、工具類、工廠模式等場景。本文透過一個 Hibernate SessionFactory 實例，剖析私有建構子的作用、導致實例化失敗的典型錯誤，以及正確的使用方式。

案例程式碼：HibernateSessionFactory

public class HibernateSessionFactory {
    private static String CONFIG_FILE_LOCATION = "/hibernate.cfg.xml";
    private static final ThreadLocal threadLocal = new ThreadLocal();
    private static final Configuration cfg = new Configuration();
    private static net.sf.hibernate.SessionFactory sessionFactory;

    public static Session currentSession() throws HibernateException { ... }
    public static void closeSession() throws HibernateException { ... }

    // 私有建構子
    private HibernateSessionFactory() { }
}

此類採用執行緒區域儲存模式，所有方法均為 static，不需實例即可操作。私有建構子明確禁止外部 new HibernateSessionFactory()。

呼叫端錯誤示範

public class HibernatePlugin implements PlugIn {
    private HibernateSessionFactory hsf;
    public HibernatePlugin() {
        hsf = new HibernateSessionFactory(); // 編譯錯誤！
    }
    ...
}

錯誤訊息：HibernateSessionFactory() has private access in zy.pro.td.util.HibernateSessionFactory

開發者為了通過編譯，將建構子改為 public，卻違背了原設計意圖。

私有建構子的核心設計意圖

1. 防止實例化：類別僅提供靜態方法/欄位，不需也不應建立實例（如 java.lang.Math, Collections）。
2. 單例模式：配合靜態 getInstance() 控制唯一實例建立。
3. 工廠/建造者模式：隱藏建構細節，透過靜態工廠方法回傳實例（如 Boolean.valueOf()）。
4. 不可實例化的工具類：語義上明確表達「此類不應被實例化」。

正確使用方式

呼叫端應直接使用靜態方法，而非嘗試實例化：

public class HibernatePlugin implements PlugIn {
    public void init(ActionServlet servlet, ModuleConfig config) {
        // 正確：直接呼叫靜態方法
        Session session = HibernateSessionFactory.currentSession();
        // 後續操作...
    }
    // 移除 hsf 欄位與建構子中的 new HibernateSessionFactory()
}

常見誤區與最佳實踐

結語

私有建構子非障礙，而是設計契約的一部分。遇到編譯錯誤時，請先理解類別作者意圖：是否應改用靜態介面？是否遺漏了工廠方法？盲目改為 public 往往引入更深層的設計缺陷。掌握此模式，能寫出更清晰、安全的 API。