[Navigation] Introducing NavigationAbstractServiceFactory

[sandrokeil]

According to the feedback of #6717 I've created the Navigation Abstract Service Factory. If this abstract service factory is registered, a service with name Zend\Navigation\Special will use the special definition in configuration key navigation.

With one point I'm not satisfied. A service call must start with Zend\Navigation\ (e.g. $sl->get('Zend\Navigation\Special')). Maybe we could support navigation.special too?

I use the ConstructedNavigationFactory to create the Navigation Container. Is this ok or should I use the AbstractNavigationFactory (@weierophinney)? The problem here is that we have to implement the getName() and override the getPages() method. For the future (ZF 3.0) we could remove getName() and make getPages() abstract in AbstractNavigationFactory. This makes DefaultNavigationFactory and ConstructedNavigationFactory needless. But it's a BC break.

I will also update the documentation.

[weierophinney]

With one point I'm not satisfied. A service call must start with Zend\Navigation\ (e.g. $sl->get('Zend\Navigation\Special')). Maybe we could support navigation.special too?

I think Zend\Navigation\ as a prefix is a reasonable default, and it's easier to support a single option than a configurable option. Developers can extend the factory if they want to change the prefix.

[weierophinney]

I use the ConstructedNavigationFactory to create the Navigation Container. Is this ok or should I use the AbstractNavigationFactory (@weierophinney)?

ConstructedNavigationFactory looks like the appropriate one to use, as it allows you to get the specific configuration section you need. Internally, it's extending AbstractNavigationFactory anyways; the difference is how it gets the page configuration, and that functionality is why it exists.

[weierophinney]

The problem here is that we have to implement the getName() and override the getPages() method. For the future (ZF 3.0) we could remove getName() and make getPages() abstract in AbstractNavigationFactory. This makes DefaultNavigationFactory and ConstructedNavigationFactory needless. But it's a BC break.

We can worry about that in a month or two. :)

[froschdesign]

@sandrokeil
Please add also a short example to docs. Thanks!

[sandrokeil]

I will do it in the next few days.

[froschdesign]

@sandrokeil
👍

[razonklnbd]

Developer can't inherit due to its final behavior. Can anyone please explain why this factory using "final" keyword at class declaration?
Also constant "SERVICE_PREFIX" is not using anywhere, I guess it may use somewhere in Zend project!

[sandrokeil]

@razonklnbd Why do you want to inherit from this class, it's not necessary. Please consider to create your own factory for your special behaviour.

A good explanation when to use final, can be found here. That's the case.

[razonklnbd]

@sandrokeil Thanks for your explanation.