Compositeaka Object Tree

Một thùng quà Tết có thể chứa bánh chưng, và cả một hộp nước ngọt nhỏ bên trong — hộp đó lại chứa từng lon. Muốn biết giá thùng quà, bạn chỉ cần hỏi 'bạn giá bao nhiêu?'; thùng tự hỏi từng thứ bên trong, hộp con lại hỏi tiếp từng lon. Bạn không cần biết bên trong lồng nhau mấy tầng.A Tet gift box may hold a banh chung and also a smaller drinks box — which itself holds individual cans. To price the gift box you just ask 'what do you cost?'; the box asks everything inside, and the inner box asks each can. You never care how many levels deep it goes.

Thành phần tham giaParticipants

Component

Interface chung cho lá và nhánh (price(), name()).The common interface for leaves and branches (price(), name()).

Leaf

Phần tử không có con, tự làm việc (một sản phẩm).An element with no children that does the work itself (a product).

Composite

Chứa danh sách Component con và uỷ quyền/gộp kết quả từ chúng.Holds child Components and delegates to / aggregates them.

Client

Làm việc với mọi thứ qua Component, không cần instanceof.Works with everything through the Component, no instanceof needed.

Dùng Tự chạy hoặc phím mũi tên để đi qua từng bước gọi giữa các object. Console hiển thị output tương ứng của chương trình.Use Autoplay or the arrow keys to step through each call between objects. The console shows the matching program output.

Cùng một bài toán, hai ngôn ngữ. Rê chuột hoặc focus vào chú thích (số màu cam) để làm nổi bật dòng code tương ứng.Same problem, two languages. Hover or focus an annotation (orange number) to highlight its line.

package com.shop.cart;

import java.math.BigDecimal;
import java.util.List;

public sealed interface CartItem {1
    String name();
    BigDecimal price();

    /** Leaf: a single product */
    record Product(String name, BigDecimal price) implements CartItem {}2

    /** Composite: may contain products AND other bundles */
    record Bundle(String name, List<CartItem> children, int discountPercent)3
            implements CartItem {
        public Bundle {
            children = List.copyOf(children);
        }

        @Override
        public BigDecimal price() {
            BigDecimal sum = children.stream()
                .map(CartItem::price)            // recursion happens here4
                .reduce(BigDecimal.ZERO, BigDecimal::add);
            BigDecimal factor = BigDecimal.valueOf(100 - discountPercent, 2);
            return sum.multiply(factor);
        }
    }
}

package cart

// Item is the Component: leaves and composites share it.
type Item interface {1
	Name() string
	Price() int64 // in VND
}

// Product is a leaf.
type Product struct {
	Title string
	VND   int64
}

func (p Product) Name() string { return p.Title }
func (p Product) Price() int64 { return p.VND }

// Bundle is the composite: it holds children of the SAME interface.
type Bundle struct {
	Title           string
	Children        []Item2
	DiscountPercent int64
}

func (b *Bundle) Add(items ...Item) { b.Children = append(b.Children, items...) }3

func (b *Bundle) Name() string { return b.Title }

func (b *Bundle) Price() int64 {
	var sum int64
	for _, c := range b.Children {
		sum += c.Price() // c may be a Product or another *Bundle4
	}
	return sum * (100 - b.DiscountPercent) / 100
}

• Composite trong SpringComposites in Spring

  CompositeCacheManager, CompositeHealthContributor (Actuator /health), HandlerMethodArgumentResolverComposite — nhiều phần tử được đối xử như một.CompositeCacheManager, CompositeHealthContributor (Actuator /health), HandlerMethodArgumentResolverComposite — many parts treated as one.

• io.MultiWriter và errors.Join trong GoGo's io.MultiWriter and errors.Join

  io.MultiWriter(file, os.Stdout) trả về một Writer ghi ra cả hai; errors.Join(e1, e2) là một error chứa nhiều error, và errors.Is duyệt cả cây.io.MultiWriter(file, os.Stdout) returns one Writer writing to both; errors.Join(e1, e2) is one error containing many, and errors.Is walks the whole tree.

• Cây danh mục, menu, sơ đồ tổ chứcCategory trees, menus, org charts

  Danh mục 'Điện tử > Điện thoại > iPhone', menu nhiều cấp, phòng ban chứa phòng ban con — đếm sản phẩm hay tổng lương đều đệ quy giống nhau.Categories like 'Electronics > Phones > iPhone', multi-level menus, departments containing departments — counting products or summing salaries recurses the same way.

• Combo và quyền (permission group)Bundles and permission groups

  Combo sản phẩm lồng nhau trên sàn TMĐT; nhóm quyền chứa quyền lẻ và nhóm quyền con trong hệ thống phân quyền.Nested product bundles on e-commerce sites; permission groups containing single permissions and sub-groups in access control.