Struts2的标签库和Struts的标签库一样,也是通过标签定义文件,也就是后缀名为tld的文件在JSP页面的定义,然后在JSP页面中调用这些标签进行表示层代码的开发。
一、tld文件的讲解以及在jsp中的应用
<!-------------------------------------------文件名: struts-tags.tld-------------------------------->
<taglib>
<tlib-version>2.2.3</tlib-version>
<jsp-version>1.2</jsp-version>
<short-name>s</short-name>
<uri>/struts-tags</uri>
<display-name>"Struts Tags"</display-name>
<description>………………</description>
<tag>
<name>action</name>
<tag-class>org.apache.struts2.views.jsp.ActionTag</tag-class>
<body-content>JSP</body-content>
<description><![CDATA[Execute an action from within a view]]></description>
<attribute>
<name>executeResult</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
<description><![CDATA[Whether the result of this action (probably a view) should be executed/rendered]]></description>
</attribute>
…………………………
<attribute>
<name>namespace</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
<description><![CDATA[Namespace for action to call]]></description>
</attribute>
</tag>
</taglib>
(1)struts-tags.tld是Struts2自标签定义文件。所有标签定义都是在<tablib>和</taglib>之间定义。以<tag></tag>用来定义一个具体标签。每个标签因为都可以有很多自己的属性。这些属性定义都是以<attribute></attribute>来定义。
(2)<tlib-version></tlib-version>之间定义的是标签库的版本。<jsp-version></jsp-version>定义的是标签库这些标签是支持JSP的哪个版本。<short-name> </short-name>其实是标签库的默认名,也可以认为是其昵称。<uri> </uri>定义的是标签库的URI,在JSP中会使用到。<display-name></display-name>是显示名。<description></description>是标签库的记述,记述标签库的使用用途等等。
(3)<attribute>中<name></name>是属性名称定义。<required></required>表示的该属性是否是必须的属性,如果是必须的则<required></required>之间为true,否则为false。<rtexprvalue></rtexprvalue>表示的是可否使用表达式,大多数标签都是为false。这里不是不能使用表达式,而是恰恰相反表示可以使用表达式。<description></description>定义和前面介绍相同。
(4)在JSP中,如之前章节的演示代码所示,都是在文件头有个使用标签的声明,代码如下。
<!-------------------------------------------文件名: *.jsp-------------------------------->
<%@taglib prefix="s" uri="/struts-tags"%>
有了这个声明,在JSP文件中就可以使用Struts2的标签。比如form标签定义要像如下代码所示。
<s:form action="upload" ………>
记住一定要用“s”,它是Struts2中标签的默认名也是相当于一个昵称,当然读者也可以把它改为自己想取的名字,不过在标签声明中的“prefix”中就要改成那个自己取的名字。
二、在工程中使用struts2标签
struts2标签定义文件在struts2-core-2.0.11.1\META-INF 下面,文件名为struts-tags.tld
如果工程使用了servlet2.3规范,要做两件事,就能在工程中使用struts2标签了
1: 在web.xml中增加标签库的定义
<taglib>
<taglib-uri>/struts-tags</taglib-uri>
<!- 定义标签库支持的jar包位置- ->
<taglib-location>/WEB-INF/lib/struts2-core-2.0.11.1.jar</taglib-location>
</taglib>
/struts-tags 是struts2标签库默认的URI,建议使用这个名称
2 在JSP中使用taglib编译指令导入标签库 <%@ taglib prefix="s" uri="/struts-tags" %>
如果使用servlet2.4规范,不须要在web.xml中增加标签库定义,只要做一件事,就行
1 在JSP中使用taglib编译指令导入标签库 <%@ taglib prefix="s" uri="/struts-tags" %>
三、 自定义标签的流程。
我们分二步走
1.编写自定义标签类。
2. 创建taglib文件(.tld),编写标签声明。
第一步:
首先编写时间格式转换的方法:
public static String getDisplayTime(Date date){
Date nowDate=new Date();
Calendar oldCalendar=Calendar.getInstance();
Calendar nowCalendar=Calendar.getInstance();
oldCalendar.setTime(date);
nowCalendar.setTime(nowDate);
int day=getDaysBetween(oldCalendar,nowCalendar);
Long nowTime=nowDate.getTime();
Long oldTime=date.getTime();
Long time=nowTime-oldTime;
if(time>60*60*1000){
if(day==0){
return new SimpleDateFormat("HH:mm:ss").format(date);
}else if(day==1){
return "昨天"+new SimpleDateFormat("HH:mm:ss").format(date);
}else if(day==2){
return "前天"+new SimpleDateFormat("HH:mm:ss").format(date);
}else{
return new SimpleDateFormat("yyyy-MM-dd").format(date);
}
}else if(time<60*1000){
return "刚刚";
}else{
return (long)time/(60*1000)+"分钟前";
}
}
下面是距离当前时间天数的方法:
public class Times extends Component{
private String name;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public Times(ValueStack arg0) {
super(arg0);
}
@Override
public boolean start(Writer writer) {
boolean result = super.start(writer);
try {
java.util.Date date = (java.util.Date) findValue(name);
String str=DataTime.getDisplayTime(date);
writer.write(str);
} catch (IOException ex) {
Logger.getLogger(Pages.class.getName()).log(Level.SEVERE, null, ex);
}
return result;
}
}
这里是写一个方法调用这个算法返回一个值
public class TimeTag extends ComponentTagSupport{
private String name;
public void setName(String name) {
this.name = name;
}
@Override
public Component getBean(ValueStack arg0, HttpServletRequest arg1, HttpServletResponse arg2) {
return new Times(arg0);
}
//获得参数
protected void populateParams() {
super.populateParams();
Times pages = (Times)component;
pages.setName(name);
}
}
这里继承ComponentTagSupport类是为了获得标签中的属性值,并包装成Component对象。继承Component类是为了从Struts2中的ValueStack中获得相对应的值。
第二步:建立smallfish.tld
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
<taglib>
<tlib-version>2.2.3</tlib-version>
<jsp-version>1.2</jsp-version>
<short-name>smallfish</short-name>
<uri>/jzy</uri>
<display-name>"smallfish Tags"</display-name>
<tag>
<name>times</name>
<tag-class>com.common.tag.TimeTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>name</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
</taglib>
经过这些操作后,一个自己的标签就弄好了,tld文件可以扩充,在用的时候就像Struts2自带的标签一样,导入,页面显示时就用<smallfish:times name="time" />这样就可以了