[SPR-15064] Support i18n and nested template loading in ScriptTemplateView render function Created: 28/Dec/16  Updated: 31/Jan/18  Resolved: 25/Jan/17

Status: Closed
Project: Spring Framework
Component/s: Web
Affects Version/s: None
Fix Version/s: 5.0 M5

Type: Improvement Priority: Minor
Reporter: Sébastien Deleuze Assignee: Sébastien Deleuze
Resolution: Complete Votes: 0
Labels: kotlin
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
depends on SPR-15059 Add Kotlin ScriptTemplateView tests Closed
relates to SPR-13453 Expose view url to render function in... Closed
is related to SPR-16447 Update and improve script templating ... Closed
Days since last comment: 1 year, 24 weeks, 6 days ago
Last commented by a User: true
Last updater: Sébastien Deleuze


The render function called by ScriptTemplateView has currently 3 parameters provided:

  • String template: the content of the template resource
  • Map<String, Object>: the model to use to render the view
  • String url: the url of the 2 view

To achieve i18n support for messages and nested template loading, we need to provide these additional informations:

  • a ResourceBundleMessageSource instance (or the ApplicationContext that allows to retrieve it)
  • the view Locale
  • a Function<String, String> that allows the render function to call ScriptTemplateView#getTemplate(String)

I see mainly 2 ways to support that:

1) We could be possible leverage setExposeContextBeansAsAttributes() or setExposedContextBeanNames() to access to context beans and expose them via model attributes.

2) We could transform the 3rd parameter passed to the script function (currently String url) to RenderingContext that would contains String url, Locale locale, ResourceBundleMessageSource messageSource and Function<String, String> templateLoader properties. This would be a breaking change for people using `url` but ScriptTemplateView is a rather feature, and url is not widely used, so I consider this as an option in order to be consistent and provide such flexible mechanism for further needs + it provides these properties in a type-safe way which would be valuable for Kotlin JSR-223 support.

Comment by Yevhenii Melnyk [ 16/Jan/17 ]

Not sure if the following stuff is appropriate here but I didn't want to open a new issue without discussion. So, the situation is following:

I was trying to use two different template view resolvers in my Spring mvc app. For example, kotlin and javascript at the same time. Creation of 2 ViewResolver beans is not the problem. It seems impossible to use two ScriptTemplateConfigurer because ScriptTemplateConfig is being acquired in ScriptTemplateView.autodetectViewConfig by ScriptTemplateConfig.class from Spring context.

Is there a way to use two scripting engines at the same time or this feature is not supported currently?

Comment by Sébastien Deleuze [ 17/Jan/17 ]

Indeed this is currently not supported out of the box, but maybe you could make it works for your use case by extending ScriptTemplateConfig* classes for Kotlin or Javascript with specify dedicated View and ViewConfigurer classes.

Comment by Yevhenii Melnyk [ 17/Jan/17 ]

I'll leave the stackoverflow post regarding multiple configurers here in case somebody has a same question I've got. The implementation is really easy. Thank you Sébastien Deleuze.

Comment by Sébastien Deleuze [ 23/Jan/17 ]

See also this related pull request for providing i18n support, I will try to provide a solution that fulfill that need too.

Comment by Sébastien Deleuze [ 24/Jan/17 ]

Juergen Hoeller Could you please have a look to this pull request I have just submitted to say me if you are ok with such approach.

This change would be breaking (on the script side, not on java side) for people using the third url parameter that we introduced as part of SPR-13453 in 4.2.2, but ScriptTemplateView is a rather young functionality, and this variant with an url parameter is likely to not being used very widely, so I would take the opportunity of our major 5.0 release to define a consistent and future proof render function SPI.

As you can see here the migration path is trivial.

I preferred this option over using setExposeContextBeansAsAttributes() or setExposedContextBeanNames() because:

  • It allows to be consistent about the various parameters we pass to the rendering function (url versus others)
  • It is type-safe which matters for Kotlin Script and more discoverable than something based on model attributes
  • It avoids to mix model attributes designed to be rendered in the template, and those informations designed to be used in the rendering function
  • It will allow us to add new rendering properties without breaking the script API

I also choose to provide the ApplicationContext rather than directly the ResourceBundleMessageSource bean because that avoids to make assumption about how to retrieve it (by type, by name) and allows a wide range of use cases in addition to i18n. See it in action in this Kotlin Script example.

Comment by Sébastien Deleuze [ 25/Jan/17 ]

Notice that this improvement allow this kind of Kotlin type-safe templates with i18n and nested template support:

import org.springframework.web.reactive.result.view.script.*

"""${include("header") }
<p>${i18n("hello")} $foo</p>
Generated at Tue Jul 17 11:50:19 UTC 2018 using JIRA 7.9.0#79000-sha1:3ca552e944c2fe83b21589bc06f155b9b428cc2b.