Our articles are currently published in Indonesian.
Semakin besar sebuah aplikasi, semakin banyak pula dependency yang masuk ke dalam business logic. Database, HTTP framework, external API, message broker, dan berbagai detail infrastructure mulai ikut memengaruhi code yang seharusnya fokus pada business rules. Contohnya:
Code ini memang sederhana, tetapi OrderService sekarang tahu bahwa persistence menggunakan SQL database. Kalau suatu hari database diganti, atau kita ingin menggunakan mock saat testing, dependency tersebut ikut masuk ke business logic. Masalahnya bukan pada sql.DB. Masalahnya adalah business logic mengetahui detail infrastructure.
Business Logic di Tengah
Konsepnya sederhana: business logic berada di tengah, sedangkan detail seperti HTTP, database, dan external service berada di luar.
Yang penting bukan bentuk hexagonnya, tetapi arah dependency. Application core tidak bergantung pada PostgreSQL atau HTTP. Sebaliknya, adapter mengikuti contract yang dibutuhkan oleh application core. Dalam Go, contract ini biasanya direpresentasikan menggunakan interface.
Port sebagai Contract
Misalnya CreateOrderService membutuhkan kemampuan untuk menyimpan order. Daripada langsung bergantung pada PostgreSQL, kita definisikan port:
Interface tersebut tidak peduli bagaimana data disimpan. Tidak ada sql.DB, query SQL, atau dependency ke database tertentu. Service cukup menggunakan contract tersebut:
Sekarang CreateOrderService tidak tahu apakah OrderRepository menggunakan PostgreSQL, MongoDB, atau in-memory storage. Ia hanya tahu apa yang bisa dilakukan dependency tersebut.
Adapter sebagai Implementation
Setelah port dibuat, kita bisa membuat adapter untuk PostgreSQL:
PostgresOrderRepository menjadi adapter yang menerjemahkan kebutuhan application layer menjadi operasi PostgreSQL. Go juga tidak membutuhkan keyword khusus untuk mengatakan bahwa type ini mengimplementasikan OrderRepository. Selama method-nya sesuai, type tersebut otomatis memenuhi interface. Kita bahkan bisa menambahkan compile-time check:
Dependency Injection
Lalu, siapa yang menghubungkan service dengan PostgreSQL? Biasanya main atau composition root.
Di sini concrete implementation diperkenalkan. CreateOrderService tetap hanya mengenal OrderRepository, sementara main yang menentukan bahwa implementation-nya adalah PostgresOrderRepository.
Dengan begitu, dependency flow-nya menjadi:
HTTP handler sendiri juga sebaiknya hanya berkomunikasi dengan use case, bukan langsung dengan database. Dengan pendekatan ini, use case yang sama dapat dipanggil dari HTTP, CLI, gRPC, atau message consumer tanpa membawa detail transport ke business logic.
Ingin memahami konsep ini lebih mendalam beserta live coding dan penjelasan arsitekturnya secara visual? Jangan lewatkan pembahasan lengkapnya! Saksikan video selengkapnya di YouTube sekarang juga untuk meningkatkan kualitas codebase Go kamu ke level berikutnya.