Skip to content
Swift Ultralight Dependency Injection / Service Locator framework
Swift Objective-C Ruby
Branch: master
Clone or download
Michael Long
Latest commit 3fb4eed Feb 18, 2019

README.md

Resolver icon

An ultralight Dependency Injection / Service Locator framework for Swift 4 and iOS.

Introduction

Dependency Injection frameworks support the Inversion of Control design pattern. Technical definitions aside, dependency injection pretty much boils down to:

| Giving an object the things it needs to do its job.

That's it. Dependency injection allows us to write code that's loosely coupled, and as such, easier to reuse, to mock, and to test.

For more, see: A Gentle Introduction to Dependency Injection.

Dependency Injection Strategies

There are five classic dependency injection strategies:

  1. Interface Injection
  2. Property Injection
  3. Constructor Injection
  4. Method Injection
  5. Service Locator

Resolver supports them all. Follow the links for a brief description, examples, and the pros and cons of each.

Features

Resolver is implemented in just over 300 lines of actual code, but it packs a ton of features into those 300 lines.

TLDR: If nothing else, make sure you read about Automatic Type Inference, Scopes, and Optionals.

Using Resolver

Using Resolver is a simple, three-step process:

  1. Add Resolver to your project.
  2. Register the classes and services your app requires.
  3. Use Resolver to resolve those instances when needed.

Why Resolver?

As mentioned, Resolver is an ultralight Dependency Injection system, implemented in just over 300 lines of code and contained in a single file.

Resolver is also designed for performance. SwinjectStoryboard, for example, is a great dependency injection system, but Resolver clocks out to be about 800% faster at resolving dependency chains than Swinject.

And unlike some other systems, Resolver is written in 100% Swift 4, with no Objective-C code, method swizzling, or internal dependencies on the Objective-C runtime.

Further, Resolver:

  • Is tested in production code.
  • Is thread safe (assuming your objects are thread safe).
  • Has a complete set of unit tests.
  • Is well-documented.

Finally, with Automatic Type Inference you also tend to write about 40-60% less dependency injection code using Resolver.

Author

Resolver was designed, implemented, and documented by Michael Long, a Senior Lead iOS engineer at CRi Solutions. CRi is a leader in developing cutting edge iOS, Android, and mobile web applications and solutions for our corporate and financial clients.

License

Resolver is available under the MIT license. See the LICENSE file for more info.

Additional Resouces

You can’t perform that action at this time.