Article
The JSP Files - Parts 1 to 8: Tagged and Bagged
Page: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 Next
Learning To Write...
Now, there are innumerable ways to go about creating and reading cookies on a client browser - you can use Javascript, you can use PHP, you can use any of the wonderful programming languages out there. However, our concern here is with JSP - so let's take a look at an example which demonstrates how to read and write a cookie.
This is a simple hit counter which creates a cookie the first time the user visits the Web page, and then increments the counter on each subsequent visit.
<%
// counter.jsp
// declare some variables
Cookie cookieCounter = null;
// the cookie you want
String cookieName = "counter";
int cookieFound = 0;
// a few more useful variables
String tempString;
int count=0;
// get an array of all cookies available on client
Cookie[] cookies = request.getCookies();
// iterate through array looking for your cookie
for(int i=0; i<cookies.length; i++)
{
cookieCounter = cookies[i];
if (cookieName.equals(cookieCounter.getName()))
{
cookieFound = 1;
break;
}
}
// if found
if(cookieFound == 1)
{
// get the counter value as string
tempString = cookieCounter.getValue();
// convert it to a number
count = Integer.parseInt(tempString);
// increment it
count++;
// back to a string
tempString = Integer.toString(count);
// store it in the cookie for future use
cookieCounter.setValue(tempString);
// set some other attributes
cookieCounter.setMaxAge(300);
cookieCounter.setPath("/");
// send cookie to client
response.addCookie(cookieCounter);
}
// if not found
else
{
// create a new cookie with counter 0
Cookie alpha = null;
alpha = new Cookie("counter", "0");
alpha.setMaxAge(300);
alpha.setPath("/");
response.addCookie(alpha);
}
%>
<html>
<head>
<basefont face="Arial">
</head>
<body>
<%
// display appropriate message
if (count > 0)
{
out.println("You have visited this page " + count + "
time(s)! Don't you have anything else to do, you bum?! ");
} else { out.println("Welcome, stranger!"); } %>
</body>
</html>
Sure, it looks a little complicated - but it won't once we break it down for you.
The first thing you need to know is how to create a cookie on the client - this is accomplished with the following code:
<%
Cookie alpha = null;
alpha = new Cookie("counter", "0");
alpha.setMaxAge(300);
alpha.setPath("/");
response.addCookie(alpha);
%>
The first two lines create a new instance of a Cookie object - "alpha". The cookie variable "counter" is then initialized and set to the string "0". Next, the setMaxAge() and setPath() methods of the Cookie object are used to set the expiry date (in seconds) and the cookie's availability, respectively. Finally, a call to the Response object's addCookie() method takes care of actually transmitting the cookie to the client.
As already mentioned, the only attribute which is not optional is the NAME=VALUE pair. If you'd like your cookie to remain available even after the user closes the browser, you should explicitly set an expiry date; if not, the cookie will be destroyed once the browser is closed.
The Cookie object also comes with a couple of other interesting methods.
setValue(someString)- sets the value of the cookie to someStringgetValue()- returns the current value of the cookiesetPath(someURL)- sets thePATHattribute of a cookie to someURLgetPath()- returns the current value of thePATHattributesetMaxAge(someSeconds)- sets theEXPIRESattribute of the cookie, in secondsgetMaxAge()- returns the current value of theEXPIRESattributesetDomain(someURL)- sets theDOMAINattribute of the cookiegetDomain()- returns the current value of theDOMAINattributesetSecure(flag)- sets theSECUREattribute of the cookie as either true or falsegetSecure()- returns the current value of theSECUREattribute
Note that you can only save string values in a cookie with setValue() - which entails a lot of string-to-number-to-string conversions if you actually want to store a number (as in this example).
Copyright Melonfire, 2000. All rights reserved.