-
Notifications
You must be signed in to change notification settings - Fork 2
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Module feature and Place holder feature (#9)
- Loading branch information
Showing
29 changed files
with
947 additions
and
443 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,100 @@ | ||
| package ore | ||
|
|
||
| import ( | ||
| "context" | ||
| "sync" | ||
| "sync/atomic" | ||
| ) | ||
|
|
||
| type Container struct { | ||
| //DisableValidation is false by default, Set to true to skip validation. | ||
| // Use case: you called the [Validate] function (either in the test pipeline or on application startup). | ||
| // So you are confident that your registrations are good: | ||
| // | ||
| // - no missing dependencies | ||
| // - no circular dependencies | ||
| // - no lifetime misalignment (a longer lifetime service depends on a shorter one). | ||
| // | ||
| // You don't need Ore to validate over and over again each time it creates a new concrete. | ||
| // It's a waste of resource especially when you will need Ore to create milion of transient concretes | ||
| // and any "pico" seconds or memory allocation matter for you. | ||
| // | ||
| // In this case, you can set DisableValidation = true. | ||
| // | ||
| // This config would impact also the the [GetResolvedSingletons] and the [GetResolvedScopedInstances] functions, | ||
| // the returning order would be no longer guaranteed. | ||
| DisableValidation bool | ||
| containerID int32 | ||
| lock *sync.RWMutex | ||
| isBuilt bool | ||
| resolvers map[typeID][]serviceResolver | ||
|
|
||
| //isSealed will be set to `true` when `Validate()` is called AFTER `Build()` is called | ||
| //it prevents any further validations thus enhancing performance | ||
| isSealed bool | ||
|
|
||
| //map interface type to the implementations type | ||
| aliases map[pointerTypeName][]pointerTypeName | ||
| } | ||
|
|
||
| var lastContainerID atomic.Int32 | ||
|
|
||
| func NewContainer() *Container { | ||
| return &Container{ | ||
| containerID: lastContainerID.Add(1), | ||
| lock: &sync.RWMutex{}, | ||
| isBuilt: false, | ||
| resolvers: map[typeID][]serviceResolver{}, | ||
| aliases: map[pointerTypeName][]pointerTypeName{}, | ||
| } | ||
| } | ||
|
|
||
| // Validate invokes all registered resolvers. It panics if any of them fails. | ||
| // It is recommended to call this function on application start, or in the CI/CD test pipeline | ||
| // The objectif is to panic early when the container is bad configured. For eg: | ||
| // | ||
| // - (1) Missing depedency (forget to register certain resolvers) | ||
| // - (2) cyclic dependency | ||
| // - (3) lifetime misalignment (a longer lifetime service depends on a shorter one). | ||
| func (this *Container) Validate() { | ||
| if this.DisableValidation { | ||
| panic("Validation is disabled") | ||
| } | ||
| ctx := context.Background() | ||
|
|
||
| //provide default value for all placeHolders | ||
| for _, resolvers := range this.resolvers { | ||
| for _, resolver := range resolvers { | ||
| if resolver.isPlaceHolder() { | ||
| ctx = resolver.providePlaceHolderDefaultValue(this, ctx) | ||
| } | ||
| } | ||
| } | ||
|
|
||
| //invoke all resolver to detect potential registration problem | ||
| for _, resolvers := range this.resolvers { | ||
| for _, resolver := range resolvers { | ||
| _, ctx = resolver.resolveService(this, ctx) | ||
| } | ||
| } | ||
|
|
||
| this.lock.Lock() | ||
| defer this.lock.Unlock() | ||
| if this.isBuilt && this.isSealed == false { | ||
| this.isSealed = true | ||
| } | ||
| } | ||
|
|
||
| func (this *Container) Build() { | ||
| this.lock.Lock() | ||
| defer this.lock.Unlock() | ||
| if this.isBuilt { | ||
| panic(alreadyBuilt) | ||
| } | ||
|
|
||
| this.isBuilt = true | ||
| } | ||
|
|
||
| func (this *Container) IsBuilt() bool { | ||
| return this.isBuilt | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.