Hooray! After 3 years of work, I've finally released the ebook on design patterns! Check it out »

Composite in Go

Composite is a structural design pattern that allows composing objects into a tree-like structure and work with the it as if it was a singular object.

Composite became a pretty popular solution for the most problems that require building a tree structure. Composite’s great feature is the ability to run methods recursively over the whole tree structure and sum up the results.

Conceptual Example

Let’s try to understand the Composite pattern with an example of an operating system’s file system. In the file system, there are two types of objects: files and folders. There are cases when files and folders should be treated to be the same way. This is where the Composite pattern comes in handy.

Imagine that you need to run a search for a particular keyword in your file system. This search operation applies to both files and folders. For a file, it will just look into the contents of the file; for a folder, it will go through all files of that folder to find that keyword.

file.go: Component interface

package main

import "fmt"

type file struct {
	name string

func (f *file) search(keyword string) {
	fmt.Printf("Searching for keyword %s in file %s\n", keyword, f.name)

func (f *file) getName() string {
	return f.name

folder.go: Composite

package main

import "fmt"

type folder struct {
	components []component
	name       string

func (f *folder) search(keyword string) {
	fmt.Printf("Serching recursively for keyword %s in folder %s\n", keyword, f.name)
	for _, composite := range f.components {

func (f *folder) add(c component) {
	f.components = append(f.components, c)

component.go: Leaf

package main

type component interface {

main.go: Client code

package main

func main() {
	file1 := &file{name: "File1"}
	file2 := &file{name: "File2"}
	file3 := &file{name: "File3"}

	folder1 := &folder{
		name: "Folder1",


	folder2 := &folder{
		name: "Folder2",


output.txt: Execution result

Serching recursively for keyword rose in folder Folder2
Searching for keyword rose in file File2
Searching for keyword rose in file File3
Serching recursively for keyword rose in folder Folder1
Searching for keyword rose in file File1

Composite in Other Languages

Design Patterns: Composite in Java Design Patterns: Composite in C# Design Patterns: Composite in C++ Design Patterns: Composite in PHP Design Patterns: Composite in Python Design Patterns: Composite in Ruby Design Patterns: Composite in Swift Design Patterns: Composite in TypeScript