DataSource Mess? Here&#s How to Fix It!

Modern microservices often manage multiple datastores to handle diverse tasks. Efficiently managing these datastores—while maintaining application lightness, maintainability, and scalability—requires robust design patterns. This article explores how the Factory and Dependency Injection (DI) patterns streamline datasource integration, using the GoFr framework as a practical example.

---

The Factory Pattern in GoFr

The Factory Pattern encapsulates initialization logic, promoting cleaner, more modular, and maintainable code. Here's a GoFr example:

Example using the Factory Pattern

func main() {
    app.AddMongo(mongo.New(mongo.Config{
        URI:              "mongodb://localhost:27017",
        Database:         "test",
        ConnectionTimeout: 4 * time.Second,
    }))
}

Factory Implementation (Encapsulated Logic)

// mongo package

func New(config mongo.Config) *mongo.Client {
    client, err := mongo.Connect(context.TODO(), options.Client().ApplyURI(config.URI))
    if err != nil {
        log.Fatal("Failed to connect to MongoDB:", err)
    }

    // Additional setup (e.g., ping, timeout).
    err = client.Ping(context.TODO(), nil)
    if err != nil {
        log.Fatal("Failed to ping MongoDB:", err)
    }

    return client
}

Note: This is a simplified example. Refer to the GoFr open-source code for the complete implementation.

Benefits of the Factory Pattern

• Encapsulation: Centralizes setup logic, simplifying application code.
• Reusability: The factory function can be reused throughout the application.
• Centralized Updates: Changes to the factory automatically update all using instances.
• Testability: Facilitates mocking for unit testing.

---

Dependency Injection in GoFr

Dependency Injection (DI) promotes modularity and testability by passing dependencies externally. GoFr simplifies DI with helper methods:

Injecting MongoDB in GoFr

// AddMongo adds MongoDB to the app's container.
func (a *App) AddMongo(db container.MongoProvider) {
    db.UseLogger(a.Logger())
    db.UseMetrics(a.Metrics())

    tracer := otel.GetTracerProvider().Tracer("gofr-mongo")
    db.UseTracer(tracer)

    db.Connect()
    a.container.Mongo = db
}

This approach offers:

• Minimalism: Lightweight and explicit setup.
• Observability: Automatic integration of logging, metrics, and tracing.
• Testability: Easy substitution of real dependencies with mocks.

---

GoFr DI vs. Other Frameworks

Feature	GoFr	Other DI Frameworks
Configuration Encapsulation	Uses helper methods (e.g., AddMongo)	May rely on automatic resolution, adding complexity
Integrated Observability	Automatic logging, metrics, and tracing setup	Requires additional setup or external libraries
Container-Based Access	Dependencies stored in a readily accessible container	Relies on containers, but may use reflection
Explicit vs. Magic	Explicit dependency configuration	Often uses annotations or automatic wiring
Flexibility	Full control over dependency injection	More abstracted setups, potentially less control

GoFr provides greater control and simplicity. It allows for clean, lightweight, and testable dependency management with seamless observability tool integration.

---

Contribute to GoFr

Explore these open-source issues to enhance your Go skills:

• Support for CockroachDB: #1346
• MSSQL Datasource Support: #984
• Azure Blob Storage: #506
• Google Cloud Storage: #504

---

Watch the Demo!

See a practical demonstration of GoFr's datasource integration using the Factory Pattern and DI:

The above is the detailed content of DataSource Mess? Here&#s How to Fix It!. For more information, please follow other related articles on the PHP Chinese website!