Uh oh!
There was an error while loading.Please reload this page.
- Notifications
You must be signed in to change notification settings - Fork9.7k
Created a trait to sort tagged services#18482
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.
Already on GitHub?Sign in to your account
Uh oh!
There was an error while loading.Please reload this page.
Conversation
| 'my_cache_warmer_service1' =>array(0 =>array('priority' =>100)), | ||
| 'my_cache_warmer_service2' =>array(0 =>array('priority' =>200)), | ||
| 'my_cache_warmer_service3' =>array(), | ||
| 'my_cache_warmer_service3' =>array(0 =>array()), |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
had to fix this in the tests because the container method wouldn't return like this, same goes for the other test.
linaori commentedApr 11, 2016 • edited
Loading Uh oh!
There was an error while loading.Please reload this page.
edited
Uh oh!
There was an error while loading.Please reload this page.
@javiereguiluz I've updated it to contain the SplPriorityQueue, had to inverse the insert priority in order to get the proper sorting though. failure in travis is unrelated |
| * | ||
| * @return Reference[] | ||
| */ | ||
| private function findAndSortTaggedServices($tagName, ContainerBuilder $container) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
Do we considerprivate methods in trait as part of the api and of the bc promises?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
I think so as they are public to the class they are used in
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
this would need an update on the bc policy!
GuilhemN commentedApr 20, 2016
LGTM 👍 |
| $services = $container->findTaggedServiceIds($tagName); | ||
| $queue = new \SplPriorityQueue(); | ||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
This PR made me think about handling priorities for formatters in#18450, but even if I love@javiereguiluz proposal to use\SplPriorityQueue (btw thanks for the heads-up :), I did not use it because I want to check that the same class is not used for many instances.
So I'm wondering even if the context is a bit different here, what about checking classes of tagged services to prevent one class to be registered with many service ids? Is this an expected possibility? Shouldn't we throw an exception in such case and add a test for it?
We could hold a$classes = array() before theforeach loops to do something like:
$services =$container->findTaggedServiceIds($tagName);$queue =new \SplPriorityQueue();$classes =array();foreach ($servicesas$serviceId =>$tags) {$serviceClass =$container->findDefinition($serviceId)->getClass();if ($serviceClass &&isset($classes[$serviceClass]) {thrownewInvalidArgumentException(sprintf('The service "%s" has the same "%s" class as service "%s"',$serviceId,$serviceClass,$classes[$serviceClass]); }$classes[$attributes['class']] =$serviceId;foreach ($tagsas$attributes) {$priority =isset($attributes['priority']) ?$attributes['priority'] :0;$queue->insert(newReference($serviceId),$priority * -1); }returniterator_to_array($queue);}
What do you think ?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
I've thought about the situation but that would be a BC break as that case is possible right now
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
We could still trigger a warning as silenced error to throw an exception in 4.0 (if it worths it)?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
I think there can be legit use-cases where you would want to something twice with a different priority.. I just don't think it's a smart idea.@stof usually you have a very good idea about things like this, what do you think?
Adding a deprecation warning and adding it anyway (behavioral change only in 4.0) seems fine to me.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
Having several instances of the same class is a reasonable expectation. Think in terms of dependency injection: you can define 2 services using the same class and having a different configuration.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
What I think@HeahDude is referring to is not once a class, but once a service
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
@GromNaN@phansys, I understand your POV, and I agree in a global scope and I don't know about cache warmers.
It can also be very common when you think about factories. But regarding this trait, it's about collecting collections of services (mainly sharing the same helper interface).
We use their ids but we actually need an instance of each class. It sounds really weird to me that a service in the cases used here (e.g serializer, argument resolver) uses the same helper class (e.g encoders, value resolvers) with two different instances and configuration.
If there is a legit use case for it, my guess is that there is also a chance that happens while misconfiguration or unexpected duplication (or overriding) with different id, so the user should know about it.
Or maybe we could just add a test for duplicated class in debug:container command, so we can easily check such case? I mean their are factories for those use cases, it could help debugging definitions issues.
Or what about using a parameter like:
privatefunction findAndSortTaggedServices($tagName,ContainerBuilder$container,$uniqueClasses =false)
To perform a check only if necessary mandatory for a service's tag collection?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
services:app.listener.log_request_mail:class:App\Listener\LogRequestarguments:["@logger.mail"]tags:[{name: kernel.request, priority: 100}]app.listener.log_request_udp:class:App\Listener\LogRequestarguments:["@logger.udp"]tags:[{name: kernel.request, priority: 50}]
This is what would register only the first one with your example. If it was unique per service, only the first encountered of each would be logged:
services:app.listener.log_request_mail:class:App\Listener\LogRequestarguments:["@logger.mail"]tags:[{name: kernel.request, priority: 100}, {name: kernel.request, priority: 50}]app.listener.log_request_udp:class:App\Listener\LogRequestarguments:["@logger.udp"]tags:[{name: kernel.request, priority: 50}, {name: kernel.request, priority: 100}]
So by service id is feasible as this example makes no sense in the first place. However, it would also mean that the mail would be registered as 100 and the udp with 50.
Imo regarding this PR, I think I'll leave this as is. If it's a behavior that needs to be changed, a PR can be opened to deprecated it as 3.4 and 4.0 are still 1.5 year away.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
This PR is indeed very good as is, thanks for that. I've just been confused by this behavior, sorry for this digression :)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
Just to be sure (ref#18450 (comment)).
This PR make some passes use a trait to collect tagged services, are concerned:
Symfony\Component\HttpKernel\CacheWarmer\CacheWarmerInterfaceSymfony\Component\Config\Resource\ResourceInterface\ResourceCheckerInterfaceSymfony\Component\HttpKernel\Controller\ArgumentValueResolverInterfaceSymfony\Component\PropertyInfo\PropertyAccessExtractorInterfaceSymfony\Component\Serializer\Encoder\EncoderInterface
Excepted 1 and 4, these interfaces have kind of asupports method (serializer encoders havesupportsEncoding).
After a deep look at each of them, I ask again, does it really make sense to allow duplicated service classes with different service IDs or with different priorities? Should't this be tested?
Or is it the responsibility of each service using them to perform that check? Because currently, it seems nothing is preventing it.
xabbuh commentedApr 23, 2016
@iltar Can you rebase on the latest |
fabpot commentedJun 14, 2016
Thank you@iltar. |
This PR was merged into the 3.2-dev branch.Discussion----------[DependencyInjection] fix the sorting by priority| Q | A| ------------- | ---| Branch? | master| Bug fix? | yes| New feature? | no| BC breaks? | no| Deprecations? | no| Tests pass? | yes| Fixed tickets |#18482| License | MIT| Doc PR |Commits-------6f72657 [DependencyInjection] fix the sorting by priority
When writing the
ControllerArgumentValueResolverPass, I needed a sorting onpriority. I ended up copying a method from another class. I noticed this was done more often and 99% of the code was the same. I've moved the most common notation into the trait and "used" the trait in the priority aware passes. This increases horizontal re-use and means people can also use this in their bundles.The cases that were slightly different, are still working completely. I had to fix some tests because they returned an invalid value from the mocked find method.