版权所有：(xiaodaoxiaodao)蓝小刀
http://www.blogjava.net/xiaodaoxiaodao/articles/103438.html
转载请注明来源/作者
JSP tag 学习
在JSP2.0 中，对于自定义的标签有两种实现方法，实现接口或者继承现有的类
如下图，标注蓝色的是接口，其它是标签类(SimpleTagSupport只在JSP2.0中才有)
在以上接口和类中，定义了一些静态常量，如下：
Tag 中定义：
SKIP_BODY = 0; // 不处理标签体，直接调用doEndTag()方法
EVAL_BODY_INCLUDE = 1; // 解析标签体,但绕过 doInitBody () 和 setBodyContent () 方法
SKIP_PAGE = 5; // 不解析标签后面的JSP内容
EVAL_PAGE = 6; // 解析标签后,继续解析标签后面的JSP内容
IterationTag 中定义：
EVAL_BODY_AGAIN = 2;
BodyTag 中定义：
EVAL_BODY_TAG = 2; // deprecated
EVAL_BODY_BUFFERED = 2; //
特别的，对于EVAL_BODY_AGAIN和EVAL_BODY_BUFFERED：
在doAferBody中返回SKIP_BODY，表示终止标记正文处理；若返回的是 EVAL_BODY_BUFFERED ，将会再一次调用doAferBody方法，重新处理标记正文，直到返回SKIP_BODY为止。 // ①
TagSupport 默认doStartTag()/doAfterBody()返回SKIP_BODY
BodyTagSupport 默认doStartTag()返回EVAL_BODY_BUFFERED / doInitBody()什么也不做 /doAfterBody()返回SKIP_BODY
下面是自定义tag的执行过程（由上至下），对于以上各常量的实际运用为：
注意其中的 doInitBody/setBodyContent 方法在自定义标签实现了 BodyTag 接口或继承BodyTagSupport才可以使用
|
Tag 方法 |
可返回的静态常量 |
|
doStartTag |
SKIP_BODY 、EVAL_BODY_INCLUDE、 EVAL_BODY_AGAIN/EVAL_BODY_BUFFERED |
|
doInitBody |
做标签一些初始化工作，无返回值 |
|
setBodyContent |
在 doInitBody 之后执行，使用setBodyContent得到JSP页面中标签体之间内容 |
|
doAfterBody |
最终必须返回SKIP_BODY ，否则可能导致OutOfMemoryError，可参考上面① |
|
doEndTag |
SKIP_PAGE/EVAL_PAGE |
附 ① 示例代码如下：
public int doAfterBody() throws JspException {
try {
this.pageContext.getOut().write("
");
} catch (IOException e) {
e.printStackTrace();
}
if(cou>1){
cou--;
return this.EVAL_BODY_AGAIN;
}else{
return this.SKIP_BODY; // 最终必须返回SKIP_BODY
}
}
自定义标签的开发包括：
1． 开发标签的处理程序（java类）
2． .tld 文件中指定标签使用的类
3． 在web.xml中指定JSP中使.tld(标签库描述文件)文件的位置。
在.tld文件中
<body-content>JSP
<rtexprvalue>false
body-content ：
根据web-jsptaglibrary_2_0.xsd（位于servlet-api.jar包（$TOMCAT_HOME\common\lib）中的\javax\servlet\resources下，其中web.xml验证时所需要的xsd文件都位于此resources目录下）， body-content 的值有下面4种：
|
|
tagdependent ： 标签体内容 直接被写入BodyContent，由自定义标签类来进行处理，而不被JSP容器解释，
如下：
select name,age from users
JSP ： 接受所有JSP语法，如定制的或内部的tag、scripts、静态HTML、脚本元素、JSP指令和动作。如：
<%=request.getProtocol()%> // ②
具体可参考后面附源码。
empty ： 空标记，即起始标记和结束标记之间没有内容。
下面几种写法都是有效的，
scriptless
：
接受文本、EL和JSP动作。如上述②使用
rtexprvalue:
由请求时表达式来指定属性的值，默认为false，如下必须设置为true：
附body-content为 JSP/scriptless 时标签体可以接受的代码（jasper-compiler.jar包 （$TOMCAT_HOME\common\lib）中 的\org\apache\jasper\compiler\Parser.java中）：
JSP:
private void parseElements(Node parent)
throws JasperException
{
if( scriptlessCount > 0 ) {
// vc: ScriptlessBody
// We must follow the ScriptlessBody production if one of
// our parents is ScriptlessBody.
parseElementsScriptless( parent );
return;
}
start = reader.mark();
if (reader.matches("<%--")) {
parseComment(parent);
} else if (reader.matches("<%@")) {
parseDirective(parent);
} else if (reader.matches("
par***MLDirective(parent);
} else if (reader.matches("<%!")) {
parseDeclaration(parent);
} else if (reader.matches("
par***MLDeclaration(parent);
} else if (reader.matches("<%=")) {
parseExpression(parent);
} else if (reader.matches("
par***MLExpression(parent);
} else if (reader.matches("<%")) {
parseScriptlet(parent);
} else if (reader.matches("
par***MLScriptlet(parent);
} else if (reader.matches("
par***MLTemplateText(parent);
} else if (reader.matches("${")) {
parseELExpression(parent);
} else if (reader.matches("
parseStandardAction(parent);
} else if (!parseCustomTag(parent)) {
checkUnbalancedEndTag();
parseTemplateText(parent);
}
}
Scriptless:
private void parseElementsScriptless(Node parent)
throws JasperException
{
// Keep track of how many scriptless nodes we've encountered
// so we know whether our child nodes are forced scriptless
scriptlessCount++;
start = reader.mark();
if (reader.matches("<%--")) {
parseComment(parent);
} else if (reader.matches("<%@")) {
parseDirective(parent);
} else if (reader.matches("
par***MLDirective(parent);
} else if (reader.matches("<%!")) {
err.jspError( reader.mark(), "jsp.error.no.scriptlets" );
} else if (reader.matches("
err.jspError( reader.mark(), "jsp.error.no.scriptlets" );
} else if (reader.matches("<%=")) {
err.jspError( reader.mark(), "jsp.error.no.scriptlets" );
} else if (reader.matches("
err.jspError( reader.mark(), "jsp.error.no.scriptlets" );
} else if (reader.matches("<%")) {
err.jspError( reader.mark(), "jsp.error.no.scriptlets" );
} else if (reader.matches("
err.jspError( reader.mark(), "jsp.error.no.scriptlets" );
} else if (reader.matches("
par***MLTemplateText(parent);
} else if (reader.matches("${")) {
parseELExpression(parent);
} else if (reader.matches("<jsp:")) {
parseStandardAction(parent);
} else if (!parseCustomTag(parent)) {
checkUnbalancedEndTag();
parseTemplateText(parent);
}
scriptlessCount--;
}
由上面可以看出，局限性比较小，在body-content可以使用 Scriptless 的地方都可以用 JSP 代替，反之则不可。
版权所有：(xiaodaoxiaodao)蓝小刀