JSP入门初级教程.doc

JSP入门初级教程之JSP概述JSP（IAVA SERVER PAGES）是由Sun 公司在java语言上开发出来的一种动态网页制作技术，其可使您可以将网页中的动态部分和静态的HTML相分离。您可以使用平常得心应手的工具并按照平常的方式来书写HTML语句。然后，将动态部分用特殊的标记嵌入即可，这些标记常常以“%”开始并以“%”结束。例如，这儿有一个JSP页面: htmlheadtitlejsp教程/title/headbodyI%out.println(“hello world”);%/I/body/html 它将输出“hello world”。 通常，您要将文件以“.jsp”为扩展名，并将它放置到任何您可以放置普通WEB页面的路径下。尽管JSP文件看起来更象是HTML文件而不是Servlet文件，但，事实上，它恰恰将转换为Servlet文件，其中的静态HTML仅仅用来输出Servlet服务方法返回的信息。如果JSP pages 已经被转换为Servlet且Servlet 被编译进而被装载（在第一次被Request时），当您再次Request 此JSP页面时，将察觉不到一瞬的延迟。也请留意这个现象，一些Web Servers允许您为它定义别名，从而，好象一个URL是指向一个HTML，但事实上它指向的是一个Servlet 或JSP pages. 构造一个JSP page,除了可内嵌的规则的HTML，还有三类主要的JSP元素：Scripting elements,Directives,和 Actions.使用Scripting elements您可以定义最终转换为Servlet的部分，Directives 使您可以控制这个Servlet的整体结构，而Actions使您可以指定可重用的已有组件，另外，还可控制JSP引擎的运行。为了简化Scripting elements,您可以在某一段上利用一些预定义的变量，如request。 本教程式是以JSP1.1版本进行讲解的。其语法概括如下表，其详细使用在随后的课程中详细讲解.JSP 元素语法解释JSP Expression%= 表达式 %Expression 用于计算并用于输出。jsp:expression表达式/jsp:expression，可使用的预定义的变量有request, response, out, session, application, config, and pageContext（在Sriptlets中也可使用）。JSP Scriptlet% 代码 %插入用于服务的代码。jsp:scriptlet代码/jsp:scriptletJSP Declaration!% 代码 %属于Servlet部分的代码但并不是服务方法。jsp:declaration代码/jsp:declarationJSP page Directive% page att=”val” %指向Servlet引擎的路径。jsp:directive.page att=val. 以下是其合法的属性（缺省值加粗）: import=package.class contentType=MIME-Type isThreadSafe=true|false session=true|false buffer=sizekb|none autoflush=true|false extends=package.class info=message errorPage=url isErrorPage=true|false language=java JSP include Directive% include file =”URL” %当JSP page被翻译成Servlet 时将被包含进去的本地系统上的文件。jsp:directive.include file=”URL” 这个URL必须是相对的。当页面被请求时才用 “jsp:include action”调入。JSP 注释%- 注释-%当JSP 转换为Servlet 时将被忽略。- 注释 -The JSP:include Action jsp:include page=”relative URL” flush=”true”/在页面被请求（Requested）时调入文件。如果您想要在页面被转化（Translated）时将文件包含进来，则，请使用上面所提到的directive来代替。警告：在一些服务器上（Servers），被包含的文件只能是HTML或JSP，一般以文件的后缀名来判定。The jsp:useBean Actionjsp:useBean att=val*/或jsp:useBean att=val*./jsp:useBean寻找或生成一个Java Bean.可能的属性是：id=name scope=page|request|session|application class=package.class type=package.class beanName=package.class The jsp:setProperty Actionjsp:setProperty att=val*/设置bean的属性，通过明确的指定或使用request得到的参数。合法的属性：name=beanName property=propertyName|* param=parameterName value=val”The jsp:getProperty Actionjsp:getProperty name=”propertyName” value=”val”/检索并输出bean的属性。The jsp:forward Actionjsp:forward page=”relative URL”/向前请求（request）另一个页面。The jsp:plugin Actionjsp:plugin attribute=”value”*/jsp:plugin生成特定的浏览器的OBJECT 或EMBED标签，用来明确运行Applet所 使用的JAVA插件（plugin）。JSP入门初级教程之JSP指令JSP directive mso-hansi-font-family:影响servlet 类的整体结构。它常用以下形式： % directive attribute=”value”%而且，您可以将多个属性写在一个语句中：% directive attribute1=value1 attribute2=value2 attributeN=valueN %有两种主要的directive:page,允许您做一些类似import classes的事，定义servlet的超类（Superclass），mso-hansi-font-family:等；include,允许您将文件插入servlet类中（当JSP文件翻译为servlet时）。一、JSP page Directive语法：% page language=java extends=package .class import=package .class | .*, . session=true|false buffer=none|8kb|sizekb autoFlush=true|false isThreadSafe=true|false info=text errorPage=relativeURL contentType=mimeType ;charset=characterSet |text/html ; charset=ISO-8859-1 isErrorPage=true|false %Page directive mso-hansi-font-family:允许您定义一些区分大小写的属性：(1)import = “package.class”或 import = “package.class1,.,package.classN”。mso-hansi-font-family:您可以定想要import的packages。例如：% page import=java.util.* %import属性是这几个属性中唯一一个可以在一个JSP中出现多次的。(2)contenType = “MIME=Type” 或contentType=“MIME-Type;charset=Character-Set”mso-hansi-font-family:它指定输出的MIME类型。缺省为“text/html”。例如: % page contentType=text/plain %在scriptlet中等价于：% response.setContentType(text/plain); %(3)isThreadSafe = “true | false”.如果值为“true”（缺省）表示：将进行普通的servlet处理，多个请求将被一个servlet实例并行处理，在这种情况下，编程人员同步访问多个实例变量。值为“false”时表示：servlet将实现单线程模式（SingleThreadModel）,不管请求是顺序提交还是并发出现，都将提供不同的分离的servlet实例。（4）session=”true | false”。 如果值为“true”（缺省）表示：预定义变量session（继承HttpSession）应该绑定到一个已存在的session，否则就应该创建一个并将之绑定。值为“false”时表示：将不使用session变量，如果试图使用，将在JSP向servlet转化时出现错误。（5）buffer = “sizekb | none”。为JspWriter输出确定缓冲的大小。缺省由服务器而定，但至少要有8kb。（6）autoflush=”true | false”。 如果值为“true mso-hansi-font-family:”（缺省）表示：当缓冲满时将自动清空，值为“false mso-hansi-font-family:”时表示：当缓冲满时递出一个异常，这很少使用。当buffer=”none”是若用false mso-hansi-font-family:值是不合法的。(7)extends=”package.class”。这将为servlet产生一个超类。请特别谨慎的使用这一功能，因为，服务器也许已经定义了一个。(8)info = “message”。定义一个可以通过调用getServletInfo方法得到的串。(9)errorPage = “URL”。指定一个JSP mso-hansi-font-family:页面来处理任何一个可抛出的但当前页面并未处理的意外错误。(10)isErrorPage = “true | false”。指定当前页面是否可以处理来自另一个页面的错误，缺省为“false”。(11)language = “java” mso-hansi-font-family:。指出以下将使用的语言。不过，不必为这一属性费心，因为，“java mso-hansi-font-family:”既是缺省又是唯一合法的选择。二JSP include Directive 这种directive 使您可以在JSP转换为servlet时将一个文件包含进来。语法：jsp:include page=relativeURL | %= expression % flush=true /mso-hansi-font-family:;mso-font-kerning: 0pt或jsp:include page=relativeURL | %= expression % flush=true jsp:param name=parameterNamevalue=parameterValue | %=expression % /+/jsp:includeURL mso-hansi-font-family:通常相对于指向它的JSP页面，但是，普遍使用相对“URL”，您可以使用一个斜杠“/”作为URL的开始来告知系统URL mso-hansi-font-family:相对的Web server的主路径。被包含的文件将以规则的JSP形式来解析，因此，您可以在其中使用静态HTML,scripting elements,directives,和 actions。让我们来看一个例子，许多站点在每一个页面上包含一个小型的导航条。它通常出现在页面的顶部或左右侧，并包含在每一个页面里。这用include directive 来实现是很自然的，若用规则的HTML mso-hansi-font-family:来把这些语句拷到每一个页面无疑是个梦魇。请看下列代码：HTMLHEADTITLE JSP教程/TITLE/HEADBODY% include file=/navbar.html %! 本页面的其他部分. -/BODY/HTML因为文件是在页面被转换时插入的，因此，如果导航条改变了，您需要将所有指向它的JSP mso-hansi-font-family:页面全部重新编译一次。如果您的导航条并不常改变这样做无疑是高效的，但是，如果您的被包含文件更改频繁，则建议您使用jsp:include action（后面将谈到）来替代，它在页面被请求时才包含文件。JSP入门初级教程之预定义变量的使用JSP表达式和scriptlets中的代码，提供了8种自动定义的变量，有时称做implicit objects(固有对象)。它们是：request,response,out,session,application,config,pageContext,和 page。下面我们来详细的了解它们。 request与request相联系的是HttpServletRequest类，使您可以得到request的参数（通过getParameter方法），request 的类型（GET，POST，HEAD，等等），和引入的HTTP头（cookies,Referer,等等）。严格来说，request是类ServletRequest的一个子类而不是HttpServletRequest类的，事实上，如果request的协议不是HTTP，那麽它几乎不会工作。response对客户端的response与HttpServletResponse 相连。请注意，因为输出流是放入缓冲的，所以可以设置HTTP状态码和response头，尽管在标准的servlets中不允许将之发送到客户端。out这里使用PrintWriter类来发送输出到客户端。然而，为了使response对象有效，可使用一个PrintWrite类的使用缓冲的版本JspWriter。使用session的属性page directive，您可以自己定义缓冲的大小，甚至可以在使用了buffer属性后关闭缓冲。也请注意，out仅用于scriptlets之中，因为JSP表达式自动的放入输出流，所以极少需要明确的声明out。session应用与request相联系的HttpSession类。因为session是自动创建的，即使没有一个引入的session，这种变量仍可绑定。有一个例外是，如果您用page directive关闭session，再试图使用session时将导致错误（在JSP页面向servlet转换时）。application使用ServeletContext类，通过使用getServletConfig().getContext()得到。config是一个ServletConfig类的对象。pageContext这是JSP中的一个新的类PageContext，用于精练特定服务器的特点时使用，如提高JspWriters的执行效率。如果您通过这个类访问而不是直接的，您的代码将仍然运行在“规则”的JSP /servlet引擎 br page在JAVA中不是很有用，它仅仅是用来保存在脚本的语言不是JAVA时的时间。JSP入门初级教程之Actions的使用JSP actions 使用您可以动态的插入一个文件，重用JavaBeans组件，前进到另一个页面，或为Java 插件生成一个HTML。可以使用的action 有： (1) jsp:include -在页面被请求时包含进一个文件。(2) jsp:useBean-找到或实例化一个JavaBean。(3) jsp:setProperty-设置一个JavaBean属性。(4) jsp:getProperty-将JavaBean的属性插入到输出。(5) jsp:forward-让请求者可以向前到一个新的页面。(6) jsp:plugin-用OBJECT或EMBED标签为Java plugins生成特定的浏览器的代码。1、jsp:include Action 这个action使您可以在即将生成的页面上包含进一些文件：jsp:include page=relative URL flush=true /与include directive不同，这个action是在页面被请求时才将文件包含进来，而，include directive则是在JSP页面被转换为servlet时包含文件。为了提高效率，include action做了一点小小的牺牲，即，它不允许被包含的页面含有一般的JSP代码（例如，不可设置HTTP头），但是，它具有显著的灵活性，如下面的JSP 代码，它实现将四个不同的片段插入如下的页面。每一次当标题改变的时候，您仅需修改这四个文件而无须更改主要的JSP 页面。WhatsNew.jspHTMLHEADTITLE JSP教程/TITLEBODY CENTERTABLE BORDER=5 BGCOLOR=#EF8429TRTH CLASS=TITLE Whats New at Chinese comic sites/TABLE/CENTERPHere is a summary of our four most recent news stories:OLLIjsp:include page=news/Item1.html flush=true/LIjsp:include page=news/Item2.html flush=true/LIjsp:include page=news/Item3.html flush=true/LIjsp:include page=news/Item4.html flush=true/OL/BODY/HTML当然您可以定义自己? ML文件，但有一点请注意：您应该将文件放到您的JSP目录下的news目录内。jsp:useBean Action 的使用一、 语法： jsp:useBeanid=beanInstanceNamescope=page|request|session|application class=package.class |type=package.class |class=package.class type=package.class |beanName=package.class | %= expression % type=package.class / | 其他元素/jsp:useBean这个action使您能将一个JavaBean装入一个JSP页面。这是一个非常有用的能力，因为它使您可以使用可重用的JAVA类而不需牺牲性能。最简单的语法用于指定一个bean：jsp:useBean id=name class=package.class /这通常意味着“实例化一个类的对象通过指定一个类，并将之与一个通过id指定名称的变量绑定”。然而，就象我们看到的，您可以指定一个scope属性来使得bean不仅仅与当前的页面相联系。在这种情形下，得到一个对已存在的bean的引用是非常有用的，而且，仅当没有相同的id和scope的bean存在时才创建一个新的。现在，您已有了bean，您可以通过jsp:setProperty来修改它，或者，通过使用之前用id指定的名字来使用scriptlet或明确的调用方法。当您说“这个bean有一个称为foo的X类型的属性”，您真正的意思是“这个类有一个称为getFoo的方法，它返回X类型的某类值，还有另一个方法称为setFoo，它以X为参数。”这jsp:setProperty action 将在下一单元详细的介绍，但是现在您既可以给出一个明确的值，给出一个属性来说明此值是从request的参数继承而来，也可以仅仅列出属性来标志此值应该从与属性名同名的参数继承而来。您可以通过调用适用的getXxx方法，或更普遍的，使用jsp:getProperty action，来得到已存在的JSP表达式或scriptlet属性。请注意，为bean指定的类必须在服务器的规则的类路径下，而不是用来保留当改变时自动装载的类的路径。例如，在Java Web Server上，它和它所用的类必须到类的目录或在lib目录下的一个jar文件内，而不是在servlets的目录下。下面让我们来看一个非常简单的例子，它装载一个bean并且设置/得到一个简单的串参数。BeanTest.jspHEADTITLEReusing JavaBeans in JSP/TITLE/HEADBODYCENTERTABLE BORDER=5TRTH CLASS=TITLEReusing JavaBeans in JSP/TABLE/CENTERPjsp:useBean id=test class=hall.SimpleBean /jsp:setProperty name=test property=message value=Hello WWW /H1Message: Ijsp:getProperty name=test property=message /I/H1 /BODYSimpleBean.java以下是bean的原代码：package hall;public class SimpleBean private String message = No message specified;public String getMessage() return(message);public void setMessage(String message) this.message = message;运行结果为：页面输出: Reusing JavaBeans in JSPMessage:Hello WWW 二、jsp:useBean 的详细用法最简单的使用bean的方式是： jsp:useBean id=name class=package.class/ 为了装载bean，需要用jsp:setProperty和 jsp:getProperty来修改和检索bean的属性。且，还有两种别的选项。首先，您可以使用容器的格式，也就是：jsp:useBean . Body /jsp:useBean要指出的是，Body部分应该仅在bean第一次实例化时被执行，而不是在每次被找到和使用时。Beans能够被共享，因此，并不是所有的jsp:useBean 陈述都产生一个新的bean的实例。其次，除了id 或class以外，还有三种属性您可以使用：scope,type,和beanName。这些属性总结如下：属性含义id给一个变量命名，此变量将指向bean。如果发现存在一个具有相同的id和scope 的bean则使用之而不新建一个。class指出bean的完整的包名。scope指明bean在之上可以被使用的前后关系。有四个可能的值：page,request,session,和application。缺省为page，表明bean仅在当前页可用（保存在当前的PageContext中）。request的一个值表明bean仅用于当前客户端的请求（保存在ServletRequest对象中）。Session的值指出在当前的HttpSession的生命周期内，对象对所有的页面可用。 最后，application的值指出对象对所有共享ServletsContext的页面可以使用。使用jsp:useBean 仅在没有相同的id和scope 的bean时创建一个新的bean，如果已有则使用之，并忽略以jsp:useBean标志开始和结尾的代码。type指明将指向对象的变量的类型。这必须与类名相匹配或是一个超类或者是一个实现类的接口。记住，变量的名由id属性来指定。beanName赋予bean一个名字，您应该在Beans的实例化方法中提供。它允许您给出type和一个beanName,并省略类属性。三、jsp:setProperty Action语法：jsp:setPropertyname=beanInstanceNameproperty=* | property=propertyName param=parameterName | property=propertyName value=string | %= expression %/在前面我们就知道了可以使用 jsp:setProperty 来为一个bean的属性赋值。您可以使用两种方式实现它。其一是，在jsp:useBean后（而不是在之内）使用jsp:setProperty：jsp:useBean id=myName . /.jsp:setProperty name=myName property=someProperty . /在这种方式中，jsp:setProperty 将被执行无论是否已有一个具有相同的id和scope的bean存在。另一种方式是，jsp:setProperty出现在jsp:useBean 元素内，如：jsp:useBean id=myName . .jsp:setProperty name=myName property=someProperty . /jsp:useBean此种情况下，jsp:setProperty仅在新的对象被实例化时才执行。以下是四种jsp:setProperty的可用的属性：属性用法name这是一个必选属性。它指出哪一个bean的属性将被设置。jsp:usebean必须出现在jsp:setProperty之前。property这是一个必选属性。表明您将设置哪一个属性。然而，有一个特殊的情况：如果以*为值意味着，所有的名称与bean的属性匹配的request参数都将被传递到相应的属性设置方法。value这是一个可选属性。它指定被设置的属性的值。字符串的值通过相应的对象或包的标准的valueOf方法将自动的转换为numbers,boolean,Boolean,byte,Byte,char,和Character。例如，boolean或Boolean属性的值“true”将通过Boolean.valueOf方法转化，而，一个int或Integer属性的值“42”将通过Integer.valueOf转化。您不能同时使用value和param属性，但，两个都不用是允许的。param这是一个可选属性。它指明了bean的属性应该继承的request的参数。如果当前的request没有这样的一个参数，就什麽也不做：系统并不将null传给设置属性的方法。因此，您可以使用bean的缺省值。例如下面的这段程序执行“将numberOfItems属性设置为任意numItems request参数的值，如果有这样的一个request参数，否则什么也不做。”jsp:setProperty name=orderBean property=numberOfItems param=numItems /如果您将value和param同时缺省，这和您将param的名称设为bean的属性名相同一样。您可以通过将name的值设置为”*”和省略value和param来自动的使用与bean的属性相应的request的属性。在这种情况下，服务器将反复的查找可用的属性和request参数来匹配具有相同名字的。四、jsp:getProperty Action语法：jsp:getProperty name=beanInstanceName property=propertyName / 这个属性检索出bean的属性的值并将之转化为一个字符串，然后将之插入到输出。它有两个必选属性：name，在之前用jsp:useBean引入的名称，property，必须被插入值的属性。JSP入门初级教程之实现页面跳转JSP中使用jsp forward Action来实现页面的跳转功能。语法：jsp:forward page=relativeURL|%= expression %/ 或jsp:forward page=relativeURL|%= expression %jsp:param name=parameterNamevalue=parameterValue|%= expression %/+/jsp:forward这个action使您可以将request向前到另外一个页面。它只有一个属性，page。Page应有一个相对的URL组成。这可以是一个静态的值或者是能够在被请求的时候计算得到的值，就如下面两个例子一般：jsp:forward page=/utils/errorReporter.jsp/jsp:forward page=%= someJavaExpression %/!supportEmptyParas 现在以一个具体例子来说明：在test1.jsp中使用forward使其跳转到test2.jsp页面中。Test1.jspHTMLHEADTITLEforward test/TITLE!supportEmptyParas /HEAD!supportEmptyParas BODY BGCOLOR=#FFFFFF!-跳转到test2.jsp-!jsp:forward page=/test2.jsp/BODY/HTML!supportEmptyParas test2.jspHTMLHEADTITLE forward test /TITLE!supportEmptyParas /HEAD!supportEmptyParas BODY BGCOLOR=#FFFFFF%out.println(这是jsp2.jsp页面产生出的输出);%/BO #62;/HTML!supportEmptyParas 运行test1.jsp，可在浏览器中看见：这是jsp2.jsp页面产生出的输出的输出信息。但是如果你在test1.jsp和test2.jsp这两个页面中有参数传递怎么办呢？用get方式吧，不但总的长度有限制，使用现在十分不方便，而且有时候还不安全。其实我们完全可以使用jsp1.1中给forward里提供的para属性就可以解决。现以test3.jsp和test4.jsp来说明。!supportEmptyParas Test1.jspHTMLHEADTITLE forward test /TITLE!supportEmptyParas /HEAD!supportEmptyParas BODY BGCOLOR=#FFFFFFjsp:forward page=/test4.jspjsp:param name=name value=powerman/jsp:param name=address value= 北京西大街188号/jsp:forward/BODY/HTML!supportEmptyParas test2.jspHTMLHEADTITLEforward test/TITLE!supportEmptyParas /HEAD!supportEmptyParas BODY BGCOLOR=#FFFFFF%out.println(这是jsp4.jsp页面产生出的输出+br);out.println(姓名：+request.getParameter(name)+br);out.println(地址：+request.getParameter(address)+br);!supportEmptyParas %/BODY/HTML运行test3.jsp，可在浏览器中看见输出信息 ：这是jsp4.jsp页面产生出的输出姓名：powerman地址：北京西大街188号JSP入门初级教程之plugin的使用jsp:plugin Action 使您能插入所需的特定的浏览器的OBJECT或EMBED元素来指定浏览器运行一个JAVA Applet所需的插件。语法：jsp:plugin type=bean|applet code=classFileName codebase=classFileDirectoryName name=instanceName archive=URIToArchive, . align=bottom|top|middle|left|right height=displayPixels width=displayPixels hspace=leftRightPixels vspace=topBottomPixels jreversion=JREVersionNumber | 1.1 nspluginurl=URLToPlugin iepluginurl=URLToPlugin jsp:params jsp:param name=parameterNamevalue=parameterValue | %= expression % / +/jsp:params jsp:fallback text message for user /jsp:fallback /jsp:plugin示例：jsp:plugin type=applet code=Molecule.class codebase=/htmljsp:paramsjsp:param name=molecule value=molecules/benzene.mol /jsp:paramsjsp:fallbackpUnable to load applet/p/jsp:fallback/jsp:plugin属性详解：属性用法type = “bean | applet” 插件将执行的对象的类型。您必须在bean或applet中指定一个，因为，这个属性没有缺省值。class=”classFileName” 插件将执行的JAVA类文件的名称。在名称中您必须包含扩展名。且此文件必须在用“codebase”属性指明的目录下。codebase=“classFileDirectoryName” 包含插件将运行的JAVA类的目录或指向这个目录的路径。缺省为此JSP文件的路径。name=”instanceName” Bean或 applet的实例的名称。使得被同一个JSP文件调用的bean或 applet之间的通信成为可能。archive = “URLToArchive,” 以逗号分隔的路径名列表。是那些用以codebase指定的目录下的类装载器预装载的存档文件所在的路径名。通常，这些存档文件通过网络被安全的加载，可以显著的提高applet的性能。注释和字符引用习惯您可以使用一些特定的元素来插入注释和一些通常是作为特殊标志的字符。以下是一个总结：语法目的%- 注释 -%JSP形式的注释。将被JSP-to-scriptlet编译器所忽略。任何内嵌JSP scripting elements,directives,或actins都将被忽略。例：% page language=java %htmlheadtitleA Comment Test/title/headbodyh2A Test of Comments/h2%- 这部分注释将不会在查看源代码的时候看到 -%/body/html!- 注释-HTML形式的注释。直接传送到最终的HTML。任何内嵌JSP scripting elements,directives,或actins都将被正常的执行。例：!- This page was loaded on%= (new java.util.Date().toLocaleString() % -查看源代码时将看到：!- This page was loaded on January 1, 2000 -%在template text（静态HTML）中，当您想在页面上输出这个特殊符号（%）时请如此书写。%在scripting elements中使用，作用与上面的“/%”类似。在使用了“”的属性中表明是字符“”。当然，您也可以使用“”来作为区分。例： pig”fhjgj” ,或,pigfhjgj”在使用了“”的属性中表明是字符“”。当然，您也可以使用“”来作为区分。例：” pigfhjgj”,或,”pig”fhjgj”%在属性中的“%”。%在属性中的“%”。JSP入门初级教程之TaglibDirectivJSP页面上使用你可以使用Taglib Directive来自定义标签定义一个标签库和前缀。其语法：% taglib uri=URIToTagLibrary prefix=tagPrefix % 示例：% taglib uri=/tags prefix=public %public:loop./public:loop描述：% taglib %指示（directive）允许您使用自定义的标签，为标签库命名，并指定它们的前缀。术语cust