O Spring considera que qualquer coisa por trás do último ponto é uma extensão de arquivo como .json
ou .xml
e o trucate para recuperar seu parâmetro.
Então, se você tem /somepath/{variable}
:
/somepath/param
, /somepath/param.json
, /somepath/param.xml
Ou /somepath/param.anything
irá resultar em uma param com valorparam
/somepath/param.value.json
, /somepath/param.value.xml
ou /somepath/param.value.anything
resultará em um parâmetro com valorparam.value
se você alterar seu mapeamento para /somepath/{variable:.+}
o sugerido, qualquer ponto, incluindo o último, será considerado como parte do seu parâmetro:
/somepath/param
resultará em um parâmetro com valor param
/somepath/param.json
resultará em um parâmetro com valor param.json
/somepath/param.xml
resultará em um parâmetro com valor param.xml
/somepath/param.anything
resultará em um parâmetro com valor param.anything
/somepath/param.value.json
resultará em um parâmetro com valor param.value.json
- ...
Se você não se importa com o reconhecimento de extensão, pode desativá-lo substituindo mvc:annotation-driven
automagic:
<bean id="handlerMapping"
class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping">
<property name="contentNegotiationManager" ref="contentNegotiationManager"/>
<property name="useSuffixPatternMatch" value="false"/>
</bean>
Então, novamente, se você tiver /somepath/{variable}
:
/somepath/param
, /somepath/param.json
, /somepath/param.xml
Ou /somepath/param.anything
irá resultar em uma param com valorparam
/somepath/param.value.json
, /somepath/param.value.xml
ou /somepath/param.value.anything
resultará em um parâmetro com valorparam.value
nota: a diferença da configuração padrão é visível somente se você tiver um mapeamento semelhante somepath/something.{variable}
. consulte Problema do projeto Resthub
se você deseja manter o gerenciamento de extensões, desde o Spring 3.2, também é possível definir a propriedade useRegisteredSuffixPatternMatch do bean RequestMappingHandlerMapping para manter o reconhecimento de sufixoPattern ativado, mas limitado à extensão registrada.
Aqui você define apenas extensões json e xml:
<bean id="handlerMapping"
class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping">
<property name="contentNegotiationManager" ref="contentNegotiationManager"/>
<property name="useRegisteredSuffixPatternMatch" value="true"/>
</bean>
<bean id="contentNegotiationManager" class="org.springframework.web.accept.ContentNegotiationManagerFactoryBean">
<property name="favorPathExtension" value="false"/>
<property name="favorParameter" value="true"/>
<property name="mediaTypes">
<value>
json=application/json
xml=application/xml
</value>
</property>
</bean>
Observe que o mvc: annotation-driven agora aceita uma opção contentNegotiation para fornecer um bean personalizado, mas a propriedade RequestMappingHandlerMapping deve ser alterada para true (padrão false) (consulte https://jira.springsource.org/browse/SPR-7632 )
Por esse motivo, você ainda precisa substituir a configuração toda orientada a anotações do mvc :. Abri um ticket para o Spring para solicitar um RequestMappingHandlerMapping personalizado: https://jira.springsource.org/browse/SPR-11253 . Por favor vote se você estiver interessado.
Ao substituir, tome cuidado para considerar também a substituição personalizada do gerenciamento de Execução. Caso contrário, todos os seus mapeamentos de exceção personalizados falharão. Você precisará reutilizar messageCoverters com um bean de lista:
<bean id="validator" class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean" />
<bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean" />
<util:list id="messageConverters">
<bean class="your.custom.message.converter.IfAny"></bean>
<bean class="org.springframework.http.converter.ByteArrayHttpMessageConverter"></bean>
<bean class="org.springframework.http.converter.StringHttpMessageConverter"></bean>
<bean class="org.springframework.http.converter.ResourceHttpMessageConverter"></bean>
<bean class="org.springframework.http.converter.xml.SourceHttpMessageConverter"></bean>
<bean class="org.springframework.http.converter.xml.XmlAwareFormHttpMessageConverter"></bean>
<bean class="org.springframework.http.converter.xml.Jaxb2RootElementHttpMessageConverter"></bean>
<bean class="org.springframework.http.converter.json.MappingJacksonHttpMessageConverter"></bean>
</util:list>
<bean name="exceptionHandlerExceptionResolver"
class="org.springframework.web.servlet.mvc.method.annotation.ExceptionHandlerExceptionResolver">
<property name="order" value="0"/>
<property name="messageConverters" ref="messageConverters"/>
</bean>
<bean name="handlerAdapter"
class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
<property name="webBindingInitializer">
<bean class="org.springframework.web.bind.support.ConfigurableWebBindingInitializer">
<property name="conversionService" ref="conversionService" />
<property name="validator" ref="validator" />
</bean>
</property>
<property name="messageConverters" ref="messageConverters"/>
</bean>
<bean id="handlerMapping"
class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping">
</bean>
Eu implementei, no projeto de código aberto Resthub do qual faço parte, um conjunto de testes sobre esses assuntos: consulte https://github.com/resthub/resthub-spring-stack/pull/219/files & https: // github.com/resthub/resthub-spring-stack/issues/217