Sunday, April 26, 2009

JSP Tutorial 4 Scriptlets

We have already seen how to embed Java expressions in JSP pages by putting
them between the <%= and %> character
sequences.

But it is difficult to do much programming just by putting Java expressions
inside HTML.

JSP also allows you to write blocks of Java code inside the JSP. 
You do this by placing your Java code between <% and
%>
characters (just like expressions, but without the = sign
at the start of the sequence.)

This block of code is known as a "scriptlet".  By itself, a scriptlet
doesn't contribute any HTML (though it can, as we will see down below.) 
A scriptlet contains Java code that is executed every time the JSP is invoked. 

Here is a modified version of our JSP from previous section, adding
in a scriptlet.

<HTML>
<BODY>
<%
    // This is a scriptlet.  Notice that the "date"
    // variable we declare here is available in the
    // embedded expression later on.
    System.out.println( "Evaluating date now" );
    java.util.Date date = new java.util.Date();
%>
Hello!  The time is now <%= date %>
</BODY>
</HTML>

If you run the above example, you will notice the output from the "System.out.println"
on the server log.  This is a convenient way to do simple debugging
(some servers also have techniques of debugging the JSP in the IDE. 
See your server's documentation to see if it offers such a technique.)

By itself a scriptlet does not generate HTML.  If a scriptlet wants
to generate HTML, it can use a variable called "out".  This
variable does not need to be declared.  It is already predefined for
scriptlets, along with some other variables.  The following example
shows how the scriptlet can generate HTML output.

<HTML>
<BODY>
<%
    // This scriptlet declares and initializes "date"
    System.out.println( "Evaluating date now" );
    java.util.Date date = new java.util.Date();
%>
Hello!  The time is now
<%
    // This scriptlet generates HTML output
    out.println( String.valueOf( date ));
%>
</BODY>
</HTML>

Here, instead of using an expression, we are generating the HTML directly
by printing to the "out" variable.  The "out" variable
is of type javax.servlet.jsp.JspWriter.

Another very useful pre-defined variable is "request". 
It is of type javax.servlet.http.HttpServletRequest

A "request" in server-side processing refers to the transaction between
a browser and the server.  When someone clicks or enters a URL, the
browser sends a "request" to the server for that URL, and shows the data
returned.  As a part of this "request", various data is available,
including the file the browser wants from the server, and if the request
is coming from pressing a SUBMIT button, the information the user has entered
in the form fields.

The JSP "request" variable is used to obtain information from
the request as sent by the browser.  For instance, you can find out
the name of the client's host (if available, otherwise the IP address will
be returned.)  Let us modify the code as shown:

<HTML>
<BODY>
<%
    // This scriptlet declares and initializes "date"
    System.out.println( "Evaluating date now" );
    java.util.Date date = new java.util.Date();
%>
Hello!  The time is now
<%
    out.println( date );
    out.println( "<BR>Your machine's address is " );
    out.println( request.getRemoteHost());
%>
</BODY>
</HTML>

A similar variable is "response".  This can be used to affect the
response being sent to the browser.  For instance, you can call response.sendRedirect(
anotherUrl );
to send a response to the browser that it should load
a different URL.  This response will actualy go all the way to the
browser.  The browser will then send a different request, to "anotherUrl". 
This is a little different from some other JSP mechanisms we will come
across, for including another page or forwarding the browser to another
page.

Exercise:  Write a JSP to output the entire line, "Hello! 
The time is now ..." but use a scriptlet for the complete string, including
the HTML tags.

No comments:

Post a Comment