NHibernate 多表查詢兩大解決方案：臨時表 vs 自訂實體類

背景與挑戰

在使用 NHibernate 開發專案時，多表聯查是常見需求。本文整理兩種主流解決方案，並比較優缺點。

方案一：HQL 查詢 + DataTable 臨時表

步驟 1：撰寫 HQL 聯查語句

string sql = "select oo.Orgid, go.Orgname " +
             "from JkptOaxtOrganization as oo, JkptGlxtOrganization as go " +
             "where oo.Orgid = " + orgid + " and oo.Suborgid = go.Orgid";
IQuery query = session.CreateQuery(sql);
IList list = query.List();

若映射檔已設定關聯，可省略 where 條件。

步驟 2：手動建立 DataTable 填入資料

DataTable dt = new DataTable();
dt.Columns.Add(new DataColumn("Orgid", typeof(int)));
dt.Columns.Add(new DataColumn("Orgname", typeof(string)));

foreach (object[] row in list)
{
    DataRow dr = dt.NewRow();
    dr["Orgid"] = row[0];
    dr["Orgname"] = row[1];
    dt.Rows.Add(dr);
}
ds.Tables.Add(dt);

缺點分析

• 欄位多時手寫 DataColumn 極其繁瑣（50 欄位需 50 行程式碼）。
• 用畢須手動清理臨時表，易造成資源洩漏。
• 型別轉換需自行處理，維護成本高。

方案二：select new 自訂實體類（推薦）

步驟 1：HQL 直接投影到自訂類別

string sql = "select new OaxtJoinGlxt(oo.Orgid, gg.Orgname) " +
             "from JkptOaxtOrganization as oo, JkptGlxtOrganization as gg " +
             "where oo.Orgid = " + orgid + " and oo.Suborgid = gg.Orgid";
IList list = session.CreateQuery(sql).List();

步驟 2：定義輕量級 DTO 類別

public class OaxtJoinGlxt
{
    public OaxtJoinGlxt(decimal pOrgid, string pOrgname)
    {
        _Orgid = pOrgid;
        _Orgname = pOrgname;
    }

    private decimal? _Orgid;
    public decimal? Orgid { get => _Orgid; set => _Orgid = value; }

    private string _Orgname;
    public string Orgname { get => _Orgname; set => _Orgname = value; }
}

步驟 3：在 .hbm.xml 註冊匯入

<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2">
  <import class="Model.OaxtJoinGlxt,Model"/>
  <class name="Model.JkptGlxtOrganization,Model" table="JKPT_GLXT_ORGANIZATION" lazy="false">
  ...
</hibernate-mapping>

方案比較總結

結論： 除非極簡單的臨時需求，否則強烈建議採用「select new + 自訂 DTO」方案，開發效率與執行效能雙贏。