JSTl 第1 課自定義標籤簡單的標籤

時間 2019-11-19

標籤 jstl 自定義標籤簡單简体版

原文原文鏈接

建立"Hello"標籤

接下來，咱們想建立一個自定義標籤叫做<ex:Hello>，標籤格式爲：css

<ex:Hello />

要建立自定義的JSP標籤，你首先必須建立處理標籤的Java類。因此，讓咱們建立一個HelloTag類，以下所示：html

package com.runoob;

import javax.servlet.jsp.tagext.*;
import javax.servlet.jsp.*;
import java.io.*;

public class HelloTag extends SimpleTagSupport {

  public void doTag() throws JspException, IOException {
    JspWriter out = getJspContext().getOut();
    out.println("Hello Custom Tag!");
  }
}

如下代碼重寫了doTag()方法，方法中使用了getJspContext()方法來獲取當前的JspContext對象，並將"Hello Custom Tag!"傳遞給JspWriter對象。java

編譯以上類，並將其複製到環境變量CLASSPATH目錄中。最後建立以下標籤庫：<Tomcat安裝目錄>webapps\ROOT\WEB-INF\custom.tld。web

<taglib>
  <tlib-version>1.0</tlib-version>
  <jsp-version>2.0</jsp-version>
  <short-name>Example TLD</short-name>
  <tag>
    <name>Hello</name>
    <tag-class>com.runoob.HelloTag</tag-class>
    <body-content>empty</body-content>
  </tag>
</taglib>

接下來，咱們就能夠在JSP文件中使用Hello標籤：app

<%@ taglib prefix="ex" uri="WEB-INF/custom.tld"%>
<html>
  <head>
    <title>A sample custom tag</title>
  </head>
  <body>
    <ex:Hello/>
  </body>
</html>

輸出結果:less

Hello Custom Tag!

訪問標籤體

你能夠像標準標籤庫同樣在標籤中包含消息內容。如咱們要在咱們自定義的Hello中包含內容，格式以下：webapp

<ex:Hello>
   This is message body
</ex:Hello>

package com.runoob;

import javax.servlet.jsp.tagext.*;
import javax.servlet.jsp.*;
import java.io.*;

public class HelloTag extends SimpleTagSupport {

   StringWriter sw = new StringWriter();
   public void doTag()
      throws JspException, IOException
    {
       getJspBody().invoke(sw);
       getJspContext().getOut().println(sw.toString());
    }

}

接下來咱們須要修改TLD文件，以下所示：jsp

<taglib>
  <tlib-version>1.0</tlib-version>
  <jsp-version>2.0</jsp-version>
  <short-name>Example TLD with Body</short-name>
  <tag>
    <name>Hello</name>
    <tag-class>com.runoob.HelloTag</tag-class>
    <body-content>scriptless</body-content>
  </tag>
</taglib>

如今咱們能夠在JSP使用修改後的標籤，以下所示:
<%@ taglib prefix="ex" uri="WEB-INF/custom.tld"%>
<html>
  <head>
    <title>A sample custom tag</title>
  </head>
  <body>
    <ex:Hello>
        This is message body
    </ex:Hello>
  </body>
</html>

以上程序輸出結果以下所示：ui

This is message body

自定義標籤屬性

你能夠在自定義標準中設置各類屬性，要接收屬性，值自定義標籤類必須實現setter方法， JavaBean 中的setter方法以下所示：this

package com.runoob;

import java.io.IOException;
import java.io.StringWriter;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.tagext.SimpleTagSupport;

public class HelloTag   extends SimpleTagSupport{

	

	   private String message;
	   private String message2;
	   
	   
	   public void setMessage2(String msg) {
		      this.message2 = msg;
		   }
	   
	   public void setMessage(String msg) {
	      this.message = msg;
	   }
	  
	 
	  
	 
	   public void doTag()
	      throws JspException, IOException
	    {  
		
		   String msg="";
		  
		    JspWriter out = getJspContext().getOut();
		   
		  
	       if (message != null) {
	           /* 從屬性中使用消息 */
	            
	            msg=msg+ "我是信息1:"+ message;
	        }
	       
	       if (message2 != null) {
	           /* 從屬性中使用消息 */
	            
	    	   msg=msg+"---我是信息2:<a href='#'>"+ message2+"</a>";
	        }
	       StringWriter sw = new StringWriter();
	       getJspBody().invoke(sw);
	       msg=msg+"---標籤body內容:"+sw.toString();
	       out.print(msg);
	    }
	  
	  
}

屬性的名稱是"message"，因此setter方法是的setMessage()。如今讓咱們在TLD文件中使用的<attribute>元素添加此屬性：

<taglib>
  <tlib-version>1.0</tlib-version>
  <jsp-version>2.0</jsp-version>
  <short-name>Example TLD with Body</short-name>
  <tag>
    <name>Hello</name>
    <tag-class>com.runoob.HelloTag</tag-class>
    
    <body-content>scriptless</body-content>
    <attribute>
       <name>message</name>
    </attribute>
    
    <attribute>
       <name>message2</name>
    </attribute>
  </tag>
</taglib>

如今咱們就能夠在JSP文件中使用message屬性了，以下所示：

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>


<%@ taglib prefix="ex" uri="WEB-INF/custom.tld"%>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";
%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <base href="<%=basePath%>">
    
    <title>My JSP 'index.jsp' starting page</title>
	<meta http-equiv="pragma" content="no-cache">
	<meta http-equiv="cache-control" content="no-cache">
	<meta http-equiv="expires" content="0">    
	<meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
	<meta http-equiv="description" content="This is my page">
	<!--
	<link rel="stylesheet" type="text/css" href="styles.css">
	-->
  </head>

  <body>
  1 .<%="我是jsp的java自負" %> <br>
    1 .<%="我是jsp的java自負2" %> <br>
    2.This is my JSP page. <br>
    
   
   	<ex:Hello message="i am is message tag" >bodymessage </ex:Hello>
	<br>
    
   <ex:Hello>
   i am body
</ex:Hello>

<br>
	<ex:Hello message="i am is message tag" > bodymessage</ex:Hello>
	<br>
	<br>
	<ex:Hello message="i am is message tag"   message2="222信息">
	 bodymessage
	</ex:Hello>
	<br>
  </body>
</html>

運行結果:

你還能夠包含如下屬性：

屬性	描述
name	定義屬性的名稱。每一個標籤的是屬性名稱必須是惟一的。
required	指定屬性是不是必須的或者可選的,若是設置爲false爲可選。
rtexprvalue	聲明在運行表達式時，標籤屬性是否有效。
type	定義該屬性的Java類類型。默認指定爲 String
description	描述信息
fragment	若是聲明瞭該屬性,屬性值將被視爲一個 JspFragment。

如下是指定相關的屬性實例：

.....
    <attribute>
      <name>attribute_name</name>
      <required>false</required>
      <type>java.util.Date</type>
      <fragment>false</fragment>
    </attribute>
.....

若是你使用了兩個屬性，修改TLD文件，以下所示：

.....
    <attribute>
      <name>attribute_name1</name>
      <required>false</required>
      <type>java.util.Boolean</type>
      <fragment>false</fragment>
    </attribute>
    <attribute>
      <name>attribute_name2</name>
      <required>true</required>
      <type>java.util.Date</type>
    </attribute>
.....