我想创建一个自定义标签库,它应该扩展现有的Spring MVC 3.0 标签库。我想这样做是因为我希望我的JSP代码独立于任何框架。
这意味着,如果我想从 Spring 更改为Struts ,那么我不需要更改 JSP 页面中的任何内容。我只是更改了我的自定义标记库,它将扩展 Struts 标记库并且一切正常。
您不能扩展整个库,但您可以扩展库中的所有标签并为它们创建新的描述符,然后使用您自己的标签而不是Spring的标签。
例如,转到名为spring-form.tld
. 您将看到标签描述符,其中包含属性描述和标签类名称。
因此,要拥有自己的标签库,您必须创建:
只需在 Google 上搜索“jsp 自定义标签”即可。或者看看JSP 自定义标签。
例如,为Struts和 Spring 中的 [form] 标签取两个类:
你将不得不创建类似的东西:
package org.my.example.tags;
import javax.servlet.jsp.JspException;
import org.springframework.web.servlet.tags.form.FormTag;
import org.springframework.web.servlet.tags.form.TagWriter;
/**
*/
public class SpringFormTag extends FormTag {
private static final String FOCUS_ATTRIBUTE = "focus";
private String focus;
public void setFocus(String focus) {
this.focus = focus;
}
public String getFocus() {
return focus;
}
@Override
protected void writeDefaultAttributes(TagWriter tagWriter) throws JspException {
writeOptionalAttribute(tagWriter, FOCUS_ATTRIBUTE, getFocus());
super.writeDefaultAttributes(tagWriter);
}
}
我只发布 spring 表单标签的代码。
文件 my-lib.tld:
<?xml version="1.0" encoding="UTF-8"?>
<taglib xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
version="2.0">
<description>My tag library</description>
<tlib-version>3.0</tlib-version>
<short-name>html</short-name>
<uri>http://test.com/test.tld</uri>
<tag>
<name>form</name>
<tag-class>org.my.example.tags.SpringFormTag</tag-class>
<body-content>JSP</body-content>
<attribute>
<name>action</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>acceptCharset</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>dir</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<type>boolean</type>
</attribute>
<attribute>
<name>enctype</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>focus</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>focusIndex</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>lang</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>method</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>onreset</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>onsubmit</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>readonly</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<type>boolean</type>
</attribute>
<attribute>
<name>scriptLanguage</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<type>boolean</type>
</attribute>
<attribute>
<name>style</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>styleId</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>target</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
</taglib>
您还必须将 .tld 文件放入 JAR 文件的 META-INF 目录中。带有此标记库的 JAR 文件必须只是包含在您的WAR文件中的 JAR 文件,否则将无法检测到标记库。
然后将您的 taglib 包含到 JSP 文件中:
<%@ taglib prefix="html" uri="http://test.com/test.tld" %>
并使用它:
<html:form action="asd" focus="1">
<div><input type="text"></div>
<div><input type="submit"></div>
</html:form>
如果您想在它们之间切换,您还必须为 Struts 创建这样的库。
这样做时您需要记住的唯一一件事是 Spring 和 Struts 有一些不同的标签定义,因此 Struts 有“焦点”而 Spring 没有。我认为可能会有更多的差异。
如果您真的想从一个切换到另一个,您必须使您的标签具有 Spring 和 Struts 的所有属性。但我真的不认为这是值得的努力。
我实际上已经做了类似于你所要求的事情。我们有许多项目必须具有相同的设计、可用性和易于维护性。因为我们使用 Spring MVC,所以我的一些标签是 spring 表单标签的包装器。例如输入标签:
import org.apache.commons.lang.StringUtils;
import org.springframework.web.servlet.tags.form.InputTag;
public class InputText extends AbstractInputTag {
private String maxlength;
@Override
public void initInput() throws Exception {
InputTag input = new InputTag();
if ( StringUtils.isNotEmpty( maxlength ) ) {
input.setMaxlength( maxlength );
}
setInput( input );
}
public void setMaxlength( String maxlength ) {
this.maxlength = maxlength;
}
}
它从一个抽象标签扩展而来,为输入添加标签并处理错误代码:
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.BodyContent;
import org.apache.commons.lang.StringUtils;
import org.springframework.web.servlet.tags.form.AbstractHtmlInputElementTag;
import org.springframework.web.servlet.tags.form.ErrorsTag;
public abstract class AbstractInputTag extends AbstractTag {
private String path;
private String code;
private String labelWidth = "35%";
private String valueWidth = "";
private AbstractHtmlInputElementTag input;
@Override
public int doStart() throws Exception {
TaglibUtils.assertHasAncestorOfType( this, Form.class );
initInput();
TaglibUtils.doLabel( pageContext, getId(), code, labelWidth );
setParent( input );
input.setPageContext( pageContext );
input.setCssErrorClass( "zsa-validationerror-input" );
input.setPath( path );
input.setId( getId() );
if( !StringUtils.isEmpty( valueWidth ) ) {
input.setCssStyle( "width: " + valueWidth );
}
pageContext.getOut().print( "<div>" );
input.doStartTag();
return EVAL_BODY_INCLUDE;
}
@Override
public int doEnd() throws Exception {
input.doEndTag();
input.release();
pageContext.getOut().print( "</div>" );
ErrorsTag errorsTag = new ErrorsTag();
errorsTag.setParent( this );
errorsTag.setPageContext( pageContext );
errorsTag.setPath( path );
errorsTag.doStartTag();
JspWriter out = pageContext.pushBody();
out.print( "<span class=\"zsa-validationerror-flag\"></span>" );
errorsTag.setBodyContent( ( BodyContent )out );
errorsTag.doInitBody();
errorsTag.doAfterBody();
errorsTag.doEndTag();
out = pageContext.popBody();
errorsTag.release();
return EVAL_PAGE;
}
public abstract void initInput() throws Exception;
}
在我的表格看起来像这样之前:
<portlet:actionURL var="coreSearch" portletMode="view" windowState="NORMAL"></portlet:actionURL>
<form:form commandName="searchContext" id="searchComplex" action="${coreSearch}" method="POST">
<div class="rightDivPart" style="width: 50%; padding-left: 50px">
<label class="label" for="tin">TIN: </label>
<form:input cssErrorClass="inputErrorClass" path="tin" cssClass="medium"/>
...
制作包装标签后,它们现在看起来像这样:
<ics:form id="searchComplex" commandName="searchContext" action="searchComplex" type="action">
<ics:panel id="searchComplex">
<ics:inputText id="mrn" path="mrnCriteria.mrn"/>
</ics:panel>
</ics:form>
现在我的 JSP-s 几乎没有 JavaScript、Css、JQuery 和其他标签。在一个非常大的项目中,我认为值得投资,因为它易于维护。
您可以将您的行为封装到标记文件中。如果应用于 spring 标签库或任何其他标签库,这将是某种组合。
使用 JSTL 标记。JSTL 意味着您的 JSP 将更加通用,可供任何使用 JSP 的 Java Web MVC 技术使用。