Clarification for the DispatcherUseProcessedURL attribute

[user62746]

Hello Community,

According to the dispatcher module documentation, the DispatcherUseProcessedURL attribute accepts 2 values:
0 - use the original URL passed to the web server.
1 - the Dispatcher uses the URL already processed by the handlers that precede the Dispatcher (that is, mod_rewrite) instead of the original URL passed to the web server.

However, in the wknd codebase the value of the attribute is set to On
DispatcherUseProcessedURL On.

Could you please clarify are 1 and On values are actually interchangeable? Does the On value require a particular dispatcher/httpd version?

I tried to find the answer by myself, but I failed.

Thanks in advance,
Rustam

[Tethich]

Hi @user62746 

Yes, the values are interchangeable. The usual use-case for using DispatcherUseProcessedURL with value 1 is for url shortening. But that should be done together with other configs, both OSGi and/or Dispatcher, depending on your business requirements for URL resolution.

Some useful materials I had in my bookmarks for a long time:

• https://techcookies.in/category/aem/dispatcher/
• https://www.aemguide.in/2019/01/url-shortening-in-aem.html?m=0

[user62746]

Hi @Tethich ,

Thank you very much for your answer. Could you please clarify where you learned that the values are interchangeable? I mean, is it mentioned somewhere in the documentation or elsewhere? 

In the materials you've provided the DispatcherUseProcessedURL  is set to 1, as per Adobe documentation. And it confuses me because at the same time I see many examples, where values are On or on, despite the fact that such values are not listed as possible in the documentation. 

Is it possible that setting the attribute to the On value has a different impact on request processing? As this value is used within the wknd project, it should be a valid value, though there is no definition on when it should be used in favor of 1.

Regards,

Rustam

[Tethich · Accepted solution]

This is as explicit as you can find I believe:

It is mentioned in the AEM project maven archetype:

https://github.com/adobe/aem-project-archetype/blob/develop/src/main/archetype/dispatcher.cloud/src/...

[user62746]

@Tethich Thank you!

In the archetype the DispatcherUseProcessedURL value is 1 in the dispatcher.ams module and On in the dispatcher.cloud. Though it's not clear why values are different I'll take it as a suggestion on which value is preferable.