JSP教程
JSP高级教程

JSP out对象

out 对象是一个输出流,用来向客户端输出数据,可以是各种数据类型的内容,同时,它还可以管理应用服务器上的输出缓冲区,缓冲区的默认值是 8KB,可以通过页面指令 page 来改变默认大小。

out 对象是一个继承自抽象类 javax.servlet.jsp.JspWriter 的实例,在实际应用中,out 对象会通过 JSP 容器变换为 java.io.PrintWriter 类的对象。

在使用 out 对象输出数据时,可以对数据缓冲区进行操作,及时清除缓冲区中的残余数据,为其他的输出让出缓冲空间。数据输出完毕后要及时关闭输出流。下面介绍 out 对象的应用。

表 1 列出了 out 对象常用的方法。

方法

说明

void print(各种数据类型)

将指定类型的数据输出到 HTTP 流,不换行

void println(各种数据类型)

将指定类型的数据输出到 HTTP 流,并输出一个换行符

void newline

输出换行字符

向客户端输出数据

在使用 print() 或 println() 方法向客户端输出时,由于客户端是浏览器,因此可以使用 HTML 中的一些标记控制输出格式。例如:

out.println("<font color=red>Hello </font>");

管理输出缓冲区

默认情况下,服务端要输出到客户端的内容不直接写到客户端,而是先写到一个输出缓冲区中。使用 out 对象的 getBufferSize() 方法取得当前缓冲区的大小(单位是 KB),用 getRemaining() 方法取得当前使用后还剩余的缓冲区的大小(单位是 KB)。

JSP 只有在下面三种情况下,才会把缓冲区的内容输出到客户端。

o 该 JSP 网页已完成信息的输出。

o 输出缓冲区己满。

o JSP 中调用了 out.flush() 或 response.flushBuffer()。

另外,调用 out 对象的 clear() 方法,可以清除缓冲区的内容,类似于重置响应流,以便重新开始操作。如果响应已经提交,则会产生 IOException 异常。此外,另一种方法 clearBuffer() 可以清除缓冲区“当前”内容,而且即使内容已经提交给客户端,也能够访问该方法。

例1:用 out 对象管理输出缓冲区,代码如下:

<%@ page contentType="text/html;charset=utf-8"%>
<html>
<head>
<title>
    out 对象管理输出缓冲区
</title>
</head>
<body>
<h2>out对象管理输出缓冲区</h2>
<%out.println("学习使用out对象管理输出缓冲区:<br>");%> <br>
缓冲大小:<%=out.getBufferSize()%> <br>
剩余缓存大小:<%=out.getRemaining()%> <br>
是否自动刷新:<%=out.isAutoFlush()%> <br>
</body>
</html>

运行结果如图 1 所示。

图1 用out对象管理输出缓冲区