C# 設計模式：組合模式葉子節點實作與異常處理 (4/5)

葉子節點：MessageModelLeaf

實作 MessageModelComponent，代表樹狀結構中的葉子節點，持有實際資料 MessageModel：

using System;
using System.Collections.Generic;
using System.Text;

namespace Pattern.Composite
{
    /// 

    /// Message 實體樹葉（Leaf）
    /// 
    public class MessageModelLeaf : MessageModelComponent
    {
        /// 

        /// 建構函式
        /// 
        /// 名稱
        /// Message 實體物件
        public MessageModelLeaf(string name, MessageModel mm)
            : base(name, mm)
        {
        }

        /// 

        /// 添加操作：葉子節點不支援，拋出異常
        /// 
        /// MessageModelComponent
        public override void Add(MessageModelComponent mmc)
        {
            throw new Exception("不能添加");
        }

        /// 

        /// 移除操作：葉子節點不支援，拋出異常
        /// 
        /// MessageModelComponent
        public override void Remove(MessageModelComponent mmc)
        {
            throw new Exception("不能刪除");
        }

        /// 

        /// 獲取資料：返回格式化的葉子資訊
        /// 
        /// 縮進數
        /// 格式化字串
        public override string GetData(int indent)
        {
            return new String('—', indent) +
            "樹葉名稱：" + _name +
            "；信息內容：" + _messageModel.Message +
            "<br />";
        }
    }
}

Leaf 角色設計要點

• 持有實際資料：建構函式接收 MessageModel，作為葉子節點的業務資料載體。
• 禁用組合操作：Add()/Remove() 拋出異常，明確語意：葉子不可包含子節點。
• 實作顯示邏輯：GetData() 格式化輸出葉子資訊，包含縮進視覺化。
• 介面一致性：雖然行為不同，但仍實作相同抽象介面，確保客戶端可統一處理。

透明性 vs 安全性權衡

本例採用透明性設計，符合組合模式「使客戶對單個物件和組合物件的使用具有一致性」的核心意圖。