[jira] [Created] (TILES-571) Please make the significance of underscore (_) in tiles definition filename more obvious

["Eric E (JIRA)" <ji...@apache.org>]

Eric E created TILES-571:
----------------------------

             Summary: Please make the significance of underscore (_) in tiles definition filename more obvious
                 Key: TILES-571
                 URL: https://issues.apache.org/jira/browse/TILES-571
             Project: Tiles
          Issue Type: Task
    Affects Versions: 3.0.1
         Environment: Apache Tomcat 7.0.42, JSE 1.7.0_45, Windows
            Reporter: Eric E
            Priority: Minor


In reading the Tiles documentation, it was not obvious to me that including an underscore (_) in my tiles definition filename would cause Tiles to interpret whatever follows the underscore as a locale.

For example, in my TilesConfigurer configuration, I had the following:
{code}
    <bean id="tilesConfigurer" class="org.springframework.web.servlet.view.tiles3.TilesConfigurer">
        <property name="definitions">
            <list>
                <value>/WEB-INF/templates/layouts.xml</value>
		<value>/WEB-INF/views/base_views.xml</value>
             </list>
        </property>
    </bean>
{code}

This caused Tiles, apparently, to assign the Locale "views" to the second definition.  This was clearly not what I intended, and the side effect of this was that Tiles discarded the second definition, and my view contained in that definition could not be resolved.

Only after spending some time with a debugger did I discover the code in org.apache.tiles.request.locale.PostfixedApplicationResource that causes this behaviour.

It would be nice if the documentation more clearly warns developers about this so that others do not have to go through the same trouble.



--
This message was sent by Atlassian JIRA
(v6.1#6144)