标签的用法

描述 : 标签允许包含另一个 JSP  页面到本页面来。jsp有两种内置机制可以将来自不同 URL 的内容合并到一个 JSP 页面:include 伪指令和 <jsp:include> 操作。不过，不管是哪种机制，要包含的内容都必须属于与页面本身相同的 Web 应用程序（或 servlet 上下文）。两个标记之间的主要区别在于： include 伪指令在页面编译期间合并被包含的内容，而 <jsp:include> 操作却在请求处理 JSP 页面时进行。
core 库的 <c:import>和 <jsp:include> 一样， <c:import> 也是一种请求时操作，它的基本任务就是将其它一些 Web 资源的内容插入 JSP 页面中。 通过 url 属性指定将要导入内容的 URL，这个属性是 <c:import> 的唯一一个必选属性。这里允许使用相对 URL，并且根据当前页面的 URL 来解析这个相对 URL。但是，如果 url 属性的值以斜杠开始，那么它就被解释成本地 JSP 容器内的绝对 URL。如果没有为 context 属性指定值，那么就认为这样的绝对 URL 引用当前 servlet 上下文内的资源。如果通过 context 属性显式地指定了上下文，那么就根据指定的 servlet 上下文解析绝对（本地）URL。 但 <c:import> 操作并不仅仅限于访问本地内容。也可以将包含协议和主机名的完整 URI 指定为 url 属性的值。实际上，协议甚至不仅局限于 HTTP。 <c:import> 的 url 属性值可以使用 java.net.URL 类所支持的任何协议。

语法 :
语法1：资源的内容使用String对象向外暴露
<c:import url="url" [context="context"]
[var="varName"] [scope="{page|request|session|application}"] [charEncoding="charEncoding"]>
内容
</c:import>
语法2：资源的内容使用Reader对象向外暴露。
<c:import url="url" [context="context"]
varReader="varReaderName" [charEncoding="charEncoding"]>
内容
</c:import>

属性 :
属性名
描述
类型
是否接受动态值
是否支持 EL
是否
必须
默认值
说明

url
统一资源定位器
String
true
Y
是
无
待导入资源的URL，可以是相对路径和绝对路径，并且可以导入其他主机资源

context
上下文
String
true
Y
否
无
当使用相对路径访问外部context资源时，context指定了这个资源的名字。

var 
变量
String
false
N
否
无
参数的名字。

scope
范围
String
false
N
否
page
var参数的作用范围。

cahrEncoding
字符编码
String
true
Y
否
无
输入资源的字符编码。

varReader
资源 阅读器
String
false
N
否
无
  这个参数的类型是Reader,用于读取资源。



说明
<c:import>中必须要有 url 属性，它是用来设定被包含网页的地址。它可以为绝对地址或是相对地址.
<c:import>也支持FTP协议，假设现在有一个 FTP站台，地址为 ftp.javaworld.com.tw，它里面有一个文件data.txt，那么可以写成如下方式将其内容显示出来：
<c:import url="ftp://ftp.cse.yzu.edu.tw/data.txt" />
另外，可以在<c:import>的本体内容中使用<c:param>，它的功用主要是：可以将参数传递给被包含的文件，它有两个属性name和value.如：
<c:import url="http://java.sun.com" >
<c:param name="test" value="1234" />
</c:import>
这样的做法等于是包含一个文件，并且所指定的网址会变成如下：
http://java.sun.com?test=1234

实例 :
----------------------------------------------------------------------------------------------------------------------------------------
Example1
<c:catch var="exception">
  <c:import url="ftp://ftp.example.com/package/README"/>
</c:catch>
<c:if test="${not empty exception}">
  Sorry, the remote content is not currently available.
</c:if>
<c:import> 操作用来包含通过 FTP 协议访问的文档内容。此外，还使用了 <c:catch> 操作，以便在本地处理 FTP 文件传送期间可能发生的任何错误。错误处理是这样实现的：使用 <c:catch> 的 var 属性为异常指定一个限定了作用域的变量，然后使用 <c:if> 检查其值。如果产生了异常，那么就会对那个限定了作用域的变量进行赋值：如清单 18 中的 EL 表达式所显示的那样，该变量的值将 不会为空。由于 FTP 文档的检索将会失败，因此会显示有关这种情况的错误消息。<c:import> 操作的最后两个（可选的）属性是 var 和 scope 。 var 属性会导致从指定 URL 获取的内容（作为 String 值）被存储在一个限定了作用域的变量中，而不是包含在当前 JSP 页面中。 scope 属性控制该变量的作用域，缺省情况下是页面作用域。如同我们在今后的文章中将要看到的那样，JSTL xml 库中的标记利用了 <c:import> 这种能力，即将整个文档存储在一个限定了作用域的变量中。

还要注意的是，可以使用（可选的）嵌套的 <c:param> 标记来为正在导入的 URL 指定请求参数。与在 <c:url> 中嵌套 <c:param> 标记一样，必要时也要对参数名称和参数值进行 URL 编码。
----------------------------------------------------------------------------------------------------------------------------------------
Example2
<c:import url="/MyHtml.html" var="thisPage" /> 
<c:import url="/MyHtml.html" context=”/sample2” var="thisPage"/> 
<c:import url="www.sample.com/MyHtml.html" var="thisPage"/> 
该示例演示了三种不同的导入方法，第一种是在同一 Context 下的导入，第二种是在不同的 Context 下导入，第三种是导入任意一个 URL 。