43. spring JSP Tag Library

43.1 简介

可以与Spring Framework一起使用的视图技术之一是Java Server Pages(JSP)。为了帮助您使用Java Server Pages实现视图,Spring Framework为您提供了一些标记,用于评估错误,设置主题和输出国际化消息。

请注意,此表单标记库生成的各种标记符合 XHTML-1.0-Strict specification 和话务员 DTD

本附录描述了 spring.tld 标记库。

43.2 参数标记

基于JSTL fmt:param标记的参数标记。目的是支持消息和主题标记内的参数。

Table 43.1. Attributes

属性必填?运行时表达式?描述
valuefalsetrue参数的值。

43.3 绑定标记

为给定的绑定路径提供BindStatus对象。 HTML转义标志参与页面范围或应用程序范围的设置(即通过HtmlEscapeTag或web.xml中的“defaultHtmlEscape”context-param)。

Table 43.2. Attributes

属性必填?运行时表达式?描述
htmlEscapefalsetrue为此标记设置HTML转义,为布尔值。覆盖当前页面的默认HTML转义设置。
ignoreNestedPathfalsetrue设置是否忽略嵌套路径(如果有)。默认是不要忽略。
pathtruetrue用于绑定状态信息的bean或bean属性的路径。例如account.name,company.address.zipCode或者只是员工。状态对象将导出到页面范围,特别是对于此bean或bean属性

43.4 escapeBody标签

逃避其封闭的正文内容,应用HTML转义和/或JavaScript转义。 HTML转义标志参与页面范围或应用程序范围的设置(即通过HtmlEscapeTag或web.xml中的“defaultHtmlEscape”context-param)。

Table 43.3. Attributes

属性必填?运行时表达式?描述
htmlEscapefalsetrue为此标记设置HTML转义,为布尔值。覆盖当前页面的默认HTML转义设置。
javaScriptEscapefalsetrue将此标记的JavaScript转义设置为布尔值。默认值为false。

43.5 eval标签

计算Spring表达式(SpEL)并打印结果或将其赋值给变量。

Table 43.4. Attributes

属性必填?运行时表达式?描述
expressiontruetrue要评估的表达式。
htmlEscapefalsetrue为此标记设置HTML转义,作为布尔值。覆盖当前页面的默认HTML转义设置。
javaScriptEscapefalsetrue将此标记的JavaScript转义设置为布尔值。默认值为false。
scopefalsetruevar的范围。支持“应用程序”,“会话”,“请求”和“页面”范围。默认为页面范围。除非还定义了var属性,否则此属性无效。
varfalsetrue要将评估结果导出到的变量的名称。如果未指定,则将评估结果转换为String并将其写为输出。

43.6 hasBindErrors标记

在绑定错误的情况下提供错误实例。 HTML转义标志参与页面范围或应用程序范围的设置(即通过HtmlEscapeTag或web.xml中的“defaultHtmlEscape”context-param)。

Table 43.5. Attributes

属性必填?运行时表达式?描述
htmlEscapefalsetrue为此标记设置HTML转义,为布尔值。覆盖当前页面的默认HTML转义设置。
nametruetrue请求中需要检查错误的bean的名称。如果此bean有错误,它们将被绑定在“errors”键下。

43.7 htmlEscape标记

设置当前页面的默认HTML转义值。如果有的话,覆盖web.xml中的“defaultHtmlEscape”context-param。

Table 43.6. Attributes

属性必填?运行时表达式?描述
defaultHtmlEscapetruetrue设置HTML转义的默认值,将其放入当前的PageContext中。

43.8 消息标记

使用给定代码检索消息,如果代码不可解析,则检索文本。 HTML转义标志参与页面范围或应用程序范围的设置(即通过HtmlEscapeTag或web.xml中的“defaultHtmlEscape”context-param)。

Table 43.7. Attributes

属性必填?运行时表达式?描述
argumentsfalsetrue为此标记设置可选的消息参数,作为(逗号)分隔的String(每个String参数可以包含JSP EL),Object数组(用作参数数组)或单个Object(用作单一论点)。
argumentSeparatorfalsetrue用于拆分参数字符串值的分隔符;默认为'逗号'(',')。
codefalsetrue查找邮件时使用的代码(密钥)。如果未提供代码,则将使用text属性。
htmlEscapefalsetrue为此标记设置HTML转义,为布尔值。覆盖当前页面的默认HTML转义设置。
javaScriptEscapefalsetrue将此标记的JavaScript转义设置为布尔值。默认值为false。
messagefalsetrueMessageSourceResolvable参数(直接或通过JSP EL)。当与Spring自己的验证错误类一起使用时,它们都很好地适用,它们都实现了MessageSourceResolvable接口。例如,这允许您迭代表单中的所有错误,将每个错误(使用运行时表达式)作为此“message”属性的值传递,从而轻松显示此类错误消息。
scopefalsetrue将结果导出到变量时使用的范围。仅在设置var时使用此属性。可能的值包括页面,请求,会话和应用程序。
textfalsetrue无法找到给定代码的消息时输出的默认文本。如果未设置文本和代码,则标记将输出null。
varfalsetrue将结果绑定到页面,请求,会话或应用程序范围时使用的字符串。如果不如果指定,结果将输出到编写器(即通常直接输出到JSP)。

43.9 nestedPath标记

设置绑定标记的路径使用的嵌套路径。

Table 43.8. Attributes

属性必填?运行时表达式?描述
pathtruetrue设置此标记应应用的路径。例如。 'customer'允许绑定路径,如'address.street'而不是'customer.address.street'。

43.10 参数标签

参数标记基于JSTL c:param标记。唯一的目的是支持url标记内的params。

Table 43.9. Attributes

属性必填?运行时表达式?描述
nametruetrue参数的名称。
valuefalsetrue参数的值。

43.11 主题标签

使用给定代码检索主题消息,如果代码不可解析,则检索文本。 HTML转义标志参与页面范围或应用程序范围的设置(即通过HtmlEscapeTag或web.xml中的“defaultHtmlEscape”context-param)。

Table 43.10. Attributes

属性必填?运行时表达式?描述
argumentsfalsetrue为此标记设置可选的消息参数,作为(逗号)分隔的String(每个String参数可以包含JSP EL),Object数组(用作参数数组)或单个Object(用作单一论点)。
argumentSeparatorfalsetrue用于拆分参数字符串值的分隔符;默认为'逗号'(',')。
codefalsetrue查找邮件时使用的代码(密钥)。如果未提供代码,则将使用text属性。
htmlEscapefalsetrue为此标记设置HTML转义,为布尔值。覆盖当前页面的默认HTML转义设置。
javaScriptEscapefalsetrue将此标记的JavaScript转义设置为布尔值。默认值为false。
messagefalsetrueMessageSourceResolvable参数(直接或通过JSP EL)。
scopefalsetrue将结果导出到变量时使用的范围。仅在设置var时使用此属性。可能的值包括页面,请求,会话和应用程序。
textfalsetrue无法找到给定代码的消息时输出的默认文本。如果未设置文本和代码,则标记将输出null。
varfalsetrue将结果绑定到页面,请求,会话或应用程序范围时使用的字符串。如果未指定,则将结果输出到写入器(即,通常直接输出到JSP)。

43.12 转换标记

使用BindTag中适当的自定义PropertyEditor提供变量到字符串的转换(只能在BindTag中使用)。 HTML转义标志参与页面范围或应用程序范围的设置(即通过HtmlEscapeTag或web.xml中的“defaultHtmlEscape”context-param)。

Table 43.11. Attributes

属性必填?运行时表达式?描述
htmlEscapefalsetrue为此标记设置HTML转义,为布尔值。覆盖当前页面的默认HTML转义设置。
scopefalsetrue将结果导出到变量时要使用的范围。仅在设置var时使用此属性。可能的值包括页面,请求,会话和应用程序。
valuetruetrue要转换的值。这是您想要转换的实际对象(例如Date)。使用'spring:bind'标签当前使用的PropertyEditor。
varfalsetrue将结果绑定到页面,请求,会话或应用程序范围时使用的字符串。如果未指定,则将结果输出到写入器(即,通常直接输出到JSP)。

43.13 网址标记

创建支持URI模板变量,HTML / XML转义和Javascript转义的URL。以JSTL c:url标记为模型,并考虑了向后兼容性。

Table 43.12. Attributes

属性必填?运行时表达式?描述
valuetruetrue要发送的URL Build 。此值可以包含由命名参数的URL编码值替换的模板{占位符}。必须使用此标记正文内的param标记定义参数。
contextfalsetrue指定远程应用程序上下文路径。默认值是当前应用程序上下文路径。
varfalsetrue要将URL值导出到的变量的名称。如果未指定,则将URL写为输出。
scopefalsetruevar的范围。支持“应用程序”,“会话”,“请求”和“页面”范围。默认为页面范围。除非还定义了var属性,否则此属性无效。
htmlEscapefalsetrue为此标记设置HTML转义,作为布尔值。覆盖当前页面的默认HTML转义设置。
javaScriptEscapefalsetrue将此标记的JavaScript转义设置为布尔值。默认值为false。
Updated at: 5 months ago
42.8. 更多资源Table of content44. spring-form JSP标记库
Comment
You are not logged in.

There are no comments.