Netscape ENTERPRISE SERVER 6.0 - PROGRAMMER GUIDE TO SERVLETS Programmer's Manual page 78

Clarifications for Using Methods
The request object passed to the target object will have its request URL path and
other path parameters adjusted to reflect the target URL path of the target object.
You cannot use this method if a
object has been obtained from the response. In that case, the method throws an
IllegalStateException
public void include(ServletRequest request, ServletResponse
response) throws ServletException, IOException;
Used for including the content generated by another server resource in the body of
a response. In essence, this method enables programmatic server-side includes. The
request object passed to the target object reflects the request URL path and path
info of the calling request. The response object only has access to the calling
servlet's
An included servlet cannot set headers. If the included servlet calls a method that
needs to set headers (such as
must ensure that any methods that might need direct access to headers are
properly resolved. To ensure that a session works correctly, start the session
outside the included servlet, even if you use session tracking.
Clarification
In Enterprise Server 6.0, the
an
IllegalStateException
obtained. This behavior follows the 2.2 draft and is needed for JSP error page
handling. It throws the exception only if the actual data has been flushed out and
sent to the client. Otherwise, the data pending in the buffer is simply discarded.
The
forward
URI is identified as an unsafe URI (that is, it includes insecure path characters such
as
//
You can control the nesting depth of the
include
magnus.conf
magnus.conf and obj.conf."
78 Netscape Enterprise Server Programmer's Guide to Servlets • November 2001
.
ServletOutputStream
and
include
, , and
/./ /../ /., /..
methods using the
. For more information, see Appendix A, "Servlet Settings in
ServletOutputStream
object or
PrintWriter
), it will not work. As a servlet developer, you
cookies
dispatcher.forward
when either
Writer
methods may throw a
(and also for Windows NT) at the end of the URI.
./
RequestDispatcher.forward
requestDispatcherNestDepth
object or
PrintWriter
object.
method may or may not throw
or have been
OutputStream
if the target
ServletException
parameter in
and