Document "path" Attribute of HTTP Inbound Gateway in XSD Schema [INT-2458]

[spring-operator]

Gunnar Hillert opened INT-2458 and commented

The HTTP Inbound Channel Adapter has a "path" attribute (and since 2.1 the "name" attribute is consequently deprecated). However, the Inbound Gateway does not document the deprecation.

Also document behavioral changes for the HTTP Inbound Channel Adapter (Add a not to XSD):

Switching from "name" to "path" is not enough of a change. Just playing with an Http sample and this works (just logging the payload):

   <int-http:inbound-channel-adapter channel="receiveChannel"
                                     name="/receiveGateway" supported-methods="GET"/>   

But this does not:

   <int-http:inbound-channel-adapter channel="receiveChannel"
                                     path="/receiveGateway" supported-methods="GET"/>

---

Affects: 2.1 GA

Issue Links:

• Document using the "path" attribute with HTTP inbound adapters [INT-2443] #6422 Document using the "path" attribute with HTTP inbound adapters
  ("is depended on by")
• Add 'value' attribute to the 'uri-variable' sub-element [INT-2463] #6444 Add 'value' attribute to the 'uri-variable' sub-element
  ("is depended on by")

[spring-operator]

Artem Bilan commented

I don't know maybe you've already had a discussion in the private conversation, however just in case I want to tell a word about 'path' here.
To make SI-HTTP componets with only 'path' attribute as Url Handlers in the web application, it is necessary to declare in the DispatcherServlet's config some bean:

<bean class="org.springframework.integration.http.inbound.UriPathHandlerMapping"/>

I the sample project http-inbound doesn't declare any 'HandlerMapping' bean, so it uses default strategy from DispatcherServlet.properties in the spring-webmvc.jar

[spring-operator]

Gunnar Hillert commented

Yes, I saw that and I will provide some documentation as part of #6422

[spring-operator]

Gunnar Hillert commented

Added note to migration guide: https://github.com/SpringSource/spring-integration/wiki/Spring-Integration-2.0-to-2.1-Migration-Guide