CS506 Handouts 1 45
CS506 Handouts 1 45
CS506 Handouts 1 45
CopyrightVirtualUniversityofPakistan
Page1
WebDesignandDevelopment(CS506)
Lecture1:JavaFeatures......................................................................................................................................4
Lecture2:JavaVirtualMachine&RuntimeEnvironment..................................................................................8
Lecture3:LearningBasics.................................................................................................................................19
Lecture4:ObjectOrientedProgramming.........................................................................................................28
Lecture5:Inheritance.......................................................................................................................................38
Lecture6:Collections........................................................................................................................................45
Lecture7:IntrotoExceptions...........................................................................................................................54
Lecture8:Streams............................................................................................................................................68
Lecture9:AbstractClassesandInterfaces.......................................................................................................82
Lecture10:GraphicalUserInterfaces...............................................................................................................88
Lecture11:EventHandling.............................................................................................................................103
Lecture12:MoreExamplesofHandlingEvents.............................................................................................113
Lecture13:AdapterClasses............................................................................................................................118
Lecture14:JavaDatabaseConnectivity..........................................................................................................129
Lecture15:MoreOnJDBC.................................................................................................................................137
Lecture16:ResultSet......................................................................................................................................143
Lecture17:MetaData......................................................................................................................................156
Lecture18:JavaGraphics................................................................................................................................165
Lecture19:HowtoAnimate?.........................................................................................................................174
Lecture20:Applets.........................................................................................................................................181
Lecture21:SocketProgramming.......................................................................................................................193
Lecture22:.......................................................................................................................................................202
Lecture23:Multithreading.............................................................................................................................209
Lecture24:MoreonMultithreading..............................................................................................................220
Lecture25:WebApplicationDevelopment....................................................................................................231
CopyrightVirtualUniversityofPakistan
Page2
WebDesignandDevelopment(CS506)
Lecture26:JavaServlets.................................................................................................................................245
Lecture27:CreatingaSimpleWebApplicationinTomcat.............................................................................258
Lecture28:ServletsLifecycle..........................................................................................................................267
Lecture29:MoreonServlets..........................................................................................................................278
Lecture30:DispatchingRequests...................................................................................................................287
Lecture31:SessionTracking...........................................................................................................................297
Lecture32:SessionTracking2........................................................................................................................308
Lecture33:AddressBookCaseStudyUsingServlets.....................................................................................322
Lecture34:JavaServerPages...........................................................................................................................334
Lecture35:JavaServerPages..........................................................................................................................341
Lecture36........................................................................................................................................................349
Lecture37:JSPActionElementsandScope....................................................................................................361
Lecture38:JSPCustomTags...........................................................................................................................375
Lecture39:MVC+CaseStudy........................................................................................................................389
Lecture40:Model2ArchitectureMVC..........................................................................................................404
Lecture41:LayersandTiers............................................................................................................................427
Lecture42:ExpressionLanguage....................................................................................................................443
Lecture43:JavaServerPagesStandardTagLibrary(JSTL)..............................................................................461
Lecture44:ClientSideValidation&JavaServerFaces(JSF)...........................................................................472
Lecture45:JavaServerFaces..........................................................................................................................481
CopyrightVirtualUniversityofPakistan
Page3
WebDesignandDevelopment(CS506)
The massive growth of the Internet and the World-Wide Web leads us to a completely new way
of looking at development of software that can run on different platforms like Windows, Linux
and Solaris etc.
1.1.1 Right Language, Right Time
CopyrightVirtualUniversityofPakistan
Page4
WebDesignandDevelopment(CS506)
1.1.4
Simple
Very similar C/C++ syntax, operators, etc.
The core language is simpler than C++ -- no operator overloading, no pointers, no
multiple inheritance
The way a java program deals with memory is much simpler than C or C++.
1.1.5
Object-Oriented
Java is fundamentally based on the OOP notions of classes and objects.
Java uses a formal OOP type system that must be obeyed at compile-time and run-time.
This is helpful for larger projects, where the structure helps keep the various parts
consistent. Contrast to Perl, which has a more anything-goes feel.
1.1.6
1.1.7
1.1.8
Portable
1.1.9
"Write Once Run Anywhere", and for the most part this works.
Not even a recompile is required -- a Java executable can work, without change, on any
Java enabled platform.
CopyrightVirtualUniversityofPakistan
Page5
WebDesignandDevelopment(CS506)
applications
Servlets, JSP, Applets, JDBC, RMI, EJBs and JSF etc. are some of the Java
technologies that can be used for the above mentioned purposes.
1.1.10 High-performance
Class and type information is kept around at runtime. This enables runtime loading
and inspection of code in a very flexible way.
The source code for each class is in a .java file. Compile each class to produce
.class file.
Sometimes, multiple .class files are packaged together into a .zip or .jar "archive" file.
On UNIX or windows, the java compiler is called "javac". To compile all the .java files
in a directory use "javac *.java".
Faster Development
o Building an application in Java takes about 50% less time than in C or C++. So,
Faster time to market
o Java is said to be Programmer Efficient.
OOP
o Java is thoroughly OOP language with robust memory system
o Memory errors largely disappear because of the safe pointers and garbage collector.
The lack of memory errors accounts for much of the increased programmer
productivity.
Libraries
o Code re-uses at last -- String, ArrayList, Date, available and documented in a
standard way
CopyrightVirtualUniversityofPakistan
Page6
WebDesignandDevelopment(CS506)
1.1.15 Microsoft vs. Java
Microsoft hates Java, since a Java program (portable) is not tied to any particular
operating system. If Java is popular, then programs written in Java might promote
non-Microsoft operating systems. For basically the same reason, all the nonMicrosoft vendors think Java is a great idea.
Microsoft's C# is very similar to Java, but with some improvements, and some
questionable features added in, and it is not portable in the way Java is. Generally it
is considered that C# will be successful in the way that Visual Basic is: a nice tool
to build Microsoft only software.
Microsoft has used its power to try to derail Java somewhat, but Java remains very
popular on its merits.
1.1.16 Java Is For Real
Java has a lot of hype, but much of it is deserved. Java is very well matched for
many modern problem
Using more memory and CPU time but less programmer time is an increasingly
appealing tradeoff.
Robustness and portability can be very useful features
A general belief is that Java is going to stay here for the next 10-20 years
1.1.17 References
Majority of the material in this handout is taken from the first handout of course
cs193j at Stanford.
The Java Language Environment, White Paper, by James Gosling & Henry
McGilton
Javas Sun site: http://java.sun.com
Java World : www.javaworld.com
CopyrightVirtualUniversityofPakistan
Page7
WebDesignandDevelopment(CS506)
Lecture 2: Java Virtual Machine & Runtime Environment
2.1
Basic Concept
When you write a program in C++ it is known as source code. The C++ compiler converts
this source code into the machine code of underlying system (e.g. Windows) If you want to run that
code on Linux you need to recompile it with a Linux based compiler. Due to the difference in
compilers, sometimes you need to modify your code.
Java has introduced the concept of WORA (write once run anywhere). When you write a java
program it is known as the source code of java. The java compiler does not compile this source
code for any underlying hardware system, rather it compiles it for a software system known as
JVM (This compiled code is known as byte code). We have different JVMs for different systems
(such as JVM for Windows, JVM for Linux etc). When we run our program the JVM interprets
(translates) the compiled program into the language understood by the underlying system. So we
write our code once and the JVM runs it everywhere according to the underlying system.
This concept is discussed in detail below
Java programs (Source code) are compiled into a form called Java bytecodes.
The Java compiler reads Java language source (.java) files, translates the source into
Java bytecodes, and places the bytecodes into class (.class) files.
The compiler generates one class file for each class contained in java source file.
CopyrightVirtualUniversityofPakistan
Page8
WebDesignandDevelopment(CS506)
2.1.2
The Java Virtual Machine is a part of a large system i.e. Java Runtime Environment
(JRE).
Each operating system and CPU architecture requires different JRE.
The JRE consists of set of built-in classes, as well as a JVM.
Without an available JRE for a given environment, it is impossible to run Java
software.
CopyrightVirtualUniversityofPakistan
Page9
WebDesignandDevelopment(CS506)
2.1.4 References
2.2
Page10
WebDesignandDevelopment(CS506)
Page11
WebDesignandDevelopment(CS506)
2.2.2 Phase 2: Compile
In Phase 2, the programmer gives the command javac to compile the program. The java compiler
translates the java program into byte codes, which is the language understood by the java interpreter.
To compile a program called Welcome.java type javac Welcome.java at the command window
of your system. If the program compiles correctly, a file called Welcome. Class is produced. This
is the file containing the byte codes that will be interpreted during the execution phase.
2.2.3 Phase 3: Loading
In phase 3, the program must first be placed in memory before it can be executed. This is
done by the class loader, which takes the .class file (or files) containing the byte codes
and transfers it to memory. The .class file can be loaded from a disk on your system or
over a network (such as your local university or company network or even the internet).
Applications (Programs) are loaded into memory and executed using the java interpreter
via the command java. When executing a Java application called Welcome, the command
Java Welcome
Invokes the interpreter for the Welcome application and causes the class loader to load
information used in the Welcome program.
2.2.4 Phase 4: Verify
Before the byte codes in an application are executed by the java interpreter, they are verified by the
byte code verifier in Phase 4. This ensures that the byte codes for class that are loaded form the
internet (referred to as downloaded classes) are valid and that they do not violate Javas security
restrictions. Java enforces strong security because java programs arriving over the network should
not be able to cause damage to your files and your system (as computer viruses might).
2.2.5 Phase 5: Execute
Finally in phase 5, the computer, under the control of its CPU, interprets the program one byte code
at a time. Thus performing the actions specified by the program.Programs may not work on the first
try. Each of the preceding phases can fail because of various errors. This would cause the java
program to print an error message. The programmer would return to the edit phase, make the
necessary corrections and proceed through the remaining phases again to determine if the
corrections work properly.
2.2.6 References:
Java How to Program 5th edition by Deitel & Deitel
Sun Java online tutorial: http://java.sun.com/docs/books/tutorial/java/index.html
2.3
Installation and Environment Setting
2.3.1 Installation
CopyrightVirtualUniversityofPakistan
Page12
WebDesignandDevelopment(CS506)
Note: j2se also called jdk (java development kit). You can also use the previous
versions like jdk 1.4 or 1.3 etc. but it is recommended that you use either jdk1.4 or
jdk5.0
Install j2se5.0 on your system
Note: For the rest of this handout, assume that j2se is installed in C:\Program Files\Java\jdk1.5.0
2.3.2 Environment Setting
Once you successfully installed the j2se, the next step is environment or path setting. You can
accomplish this in either of two ways.
2.3.2.1 Temporary Path Setting
Open the command prompt from Start -> Programs -> Accessories -> Command Prompt.
The command prompt screen would be opened in front of you.
Write the command on the command prompt according to the following format
path = < java installation directory\bin >
So, according to handout, the command will look like this
path = C:\Program Files\Java\jdk1.5.0\bin
To Test whether path has been set or not, write javac and press ENTER. If the
list of options displayed as shown in the below figure means that you have
successfully completed the steps of path setting.
The above procedure is illustrates in the given below picture.
C:\WINDOWS\system32\cmd.exe
C:\>path=C:\Programs Files\Java\jdk1.5.0\bin
C:\>javac
Usage: javac <options> <source files>
Where possible options include:
-g
Generate all debugging info
-g:none
Generate no debugging info
-g:{lines, vars, source}
Generate only some debugging
-nowarn
Generate no warnings
-verbose
Output source messages about
what t
-deprecation
Output source locations wher
Sed
-classpath <path>
Specify where to finde user c
-cp <path>
Specify where to find user c
-sourcepath <path>
Specify where to find input
-bootclasspath<path>
Override location of bootstr
-extdirs <dirs>
Override location of install
Note: The issue with the temporary path setting is you have to repeat the above explained
procedure again and again each time you open a new command prompt window. To avoid this
overhead, it is better to set your path permanently
CopyrightVirtualUniversityofPakistan
Page13
WebDesignandDevelopment(CS506)
2.3.2.2 Permanent Path Setting
In Windows NT (XP, 2000), you can set the permanent environment variable.
Right click on my computer icon click on properties as shown below
CopyrightVirtualUniversityofPakistan
Page14
WebDesignandDevelopment(CS506)
Like any other programming language, the java programming language is used to create
applications. So, we start from building a classical Hello World application, which is generally
used as the first program for learning any new language.
2.4.1 HelloWorldApp
Open notepad editor from Start -> ProgarmFiles -> Accessories-> Notepad.
Write the following code into it.
Note: Dont copy paste the given below code. Probably it gives errors and you cant able to remove
them at the beginning stage.
CopyrightVirtualUniversityofPakistan
Page15
WebDesignandDevelopment(CS506)
1./*The HelloWorldApp class implements an application that
2.simply displays "Hello World!" to the standard output.
3.*/
4. public class HelloWorldApp {
5.public static void main(String[] args) {
6.//Display the string. No global main
7.System.out.println(Hello World);
8. }
9. }
To save your program, move to File menu and choose save as option.
Save your program as HelloWorldApp.java in some directory. Make sure to
add double quotes around class name while saving your program. For this example
create a folder known as examples in D: drive
Note: Name of file must match the name of the public class in the file (at line 4).
Moreover, it is case sensitive. For example, if your class name is MyClasS, than file
name must be MyClasS. Otherwise the Java compiler will refuse to compile the
program.
For the rest of this handout, we assume that program is saved in D:\examples directory.
2.4.2 HelloWorldApp Described
Lines 1-3
o Like in C++, You can add multiple line comments that are ignored by the compiler.
Lines 4
o Line 4 declares the class name as HelloWorldApp. In java, every line of code must
reside inside class. This is also the name of our program (HelloWorldApp.java).The
compiler creates the HelloWorldApp.class if this program successfully gets
compiled.
Lines 5
o Line 5 is where the program execution starts. The java interpreter must find this
defined exactly as given or it will refuse to run the program. (However you can
change the name of parameter that is passed to main. i.e. you can write String[]
argv or String[] someParam instead of String[] args)
o Other programming languages, notably C++ also use the main()declaration as the
starting point for execution. However the main function in C++ is global and
resides outside of all classes where as in Java the main function must reside inside a
class. In java there are no global variables or functions. The various parts of this main
function declaration will be covered at the end of this handout.
Lines 6
o Again like C++, you can also add single line comment
Lines 7
o Line 7 illustrates the method call. The println() method is used to print
something on the console. In this example println() method takes a string
argument and writes it to the standard output i.e. console.
CopyrightVirtualUniversityofPakistan
Page16
WebDesignandDevelopment(CS506)
Lines 8-9
o Line 8-9 of the program, the two braces, close the method main() and the
classHelloWorldApprespectively.
Open the command prompt from Start -> Program Files -> Accessories. OR
alternatively you can write cmd in the run command window.
Write cd.. to came out from any folder, and cd [folder name] to move inside the specified
directory. To move from one drive to another, use [Drive Letter]: See figure given below
After reaching to the folder or directory that contains your source code, in our case
HelloWorldApp.java.
Use javac on the command line to compile the source file ( .java file).
D:\examples> javac HelloWorld.java
If program gets successfully compiled, it will create a new file in the same directory named
HelloWorldApp.class that contains the byte-code.
Use java on the command line to run the compiled .class file. Note .class would be
added with the file name.
D:\examples> java HelloWorld
You can see the Hello World would be printed on the console. Hurrah! You are
successful in writing, compiling and executing your first program in java
C:\WINDOWS\system32\cmd.exe
2.5
CopyrightVirtualUniversityofPakistan
Page17
WebDesignandDevelopment(CS506)
o Since main method is called by the JVM that is why it is kept public so that it is
accessible from outside. Remember private methods are only accessible from
within the class
Why static?
o Every Java program starts when the JRE (Java Run Time Environment) calls the
main method of that program. If main is not static then the JRE have to create an object
of the class in which main method is present and call the main method on that object (In
OOP based languages method are called using the name of object if they are not static).
It is made static so that the JRE can call it without creating an object.
o Also to ensure that there is only one copy of the main method per class
Why void?
o Indicates that main ( ) does not return anything.
What is String args[] ?
Way of specifying input (often called command-line arguments) at startup of
application. More on it latter
2.6
References
Entire material for this handout is taken from the book JAVA A Lab Course by Umair
Javed. This material is available just for the use of VU students of the course Web Design
and Development and not for any other commercial purpose without the consent of
author.
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page18
WebDesignandDevelopment(CS506)
Lecture 3: Learning Basics
3.1
Strings
A string is commonly considered to be a sequence of characters stored in memory and accessible
as a unit. Strings in java are represented as objects.
String concatenated with any other data type such as int will also convert that
datatype to String and the result will be a concatenated String displayed on console.
For example,
o int i = 4;
o int j = 5;
System.out.println (Hello + i);// will print Hello 4 on screen
o However
System.out.println(i+j);//will print 9 on the console because both i and j
are of type int.
== operator compares addresses (shallow comparison) while equals compares values (deep
comparison)
E.g. string1.equals(string2)
CopyrightVirtualUniversityofPakistan
Page19
WebDesignandDevelopment(CS506)
Example Code: String concatenation and comparison
public class StringTest {
public static void main(String[] args) {
int i = 4;
int j = 5;
System.out.println("Hello" + i); // will print Hello4
System.out.println(i + j); // will print 9
String s1 = new String (pakistan);
String s2 = pakistan;
if (s1 == s2) {
System.out.println(comparing string using == operator);
}
if (s1.equals( s2) ) {
System.out.println(comparing string using equal method);
}
}
}
C:\WINDOWS\system32\cmd.exe
3.2
Page20
WebDesignandDevelopment(CS506)
public static void main(String[] args){ //main method
System.out.println(First argument + args[0]);
System.out.println(Second argument +args[1]);
}//end main
}//End class.
To execute this program, we pass two arguments as shown below:
C:\java CmdLineArgsApp Hello World
First argument Hello
Second argument World
Everything in Java is an Object, as every class by default inherits from class Object,
CopyrightVirtualUniversityofPakistan
Page21
WebDesignandDevelopment(CS506)
except a few primitive data types, which are there for efficiency reasons.
1 byte
2 bytes
4 bytes
8 bytes
Primitive data types are generally used for local variables, parameters and instance variables
(properties of an object)
Primitive data types are located on the stack and we can only access their value,
while objects are located on heap and we have a reference to these objects
Also primitive data types are always passed by value while objects are always
passed by reference in java. There is no C++ like methods
o void someMethod(int &a, int & b ) // not available in java
CopyrightVirtualUniversityofPakistan
Page22
WebDesignandDevelopment(CS506)
Each primitive data type has a corresponding object (wrapper class). These wrapper
classes provides additional functionality (conversion, size checking etc.), which a primitive
data type cannot provide.
Primitive Data Type
byte
short
int
long
float
double
char
boolean
Corresponding
Object Class
Byte
Short
Integer
Long
Float
Double
Character
Boolean
The following table summarizes the parser methods available to a java programmer.
CopyrightVirtualUniversityofPakistan
Page23
WebDesignandDevelopment(CS506)
Data Type
byte
short
int
long
float
double
On line 1, swing package was imported because it contains the JOptionPane class that will be used
for taking input from GUI and displaying output to GUI. It is similar to header classes of C++.
On line 5, showInputDialog method is called of JOptionPane class by passing string
argument that will be displayed on GUI (dialog box). This method always returns back a
CopyrightVirtualUniversityofPakistan
Page24
WebDesignandDevelopment(CS506)
String regardless of whatever you entered (int, float, double, char) in the input filed.
Our task is to print square of a number on console, so we first convert a string into a
number by calling parseInt method of Integer wrapper class. This is what we done on line
number 6.
Line 11 will display square on GUI (dialog box) by using showMessageDialog method of
JOptionPane class. The first argument passed to this method is null and the second argument
must be a String. Here we use string concatenation.
Line 12 is needed to return the control back to command prompt whenever we use
JoptionPane class.
Compile & Execute
CopyrightVirtualUniversityofPakistan
Page25
WebDesignandDevelopment(CS506)
C:\WINDOWS\system32\cmd.exe
Input
Enterthenumber
12
OK
Cancel
Message
Square:144
OK
3.6
Cancel
The if-else and switch selection structures are exactly similar to we have in C++. All
relational operators that we use in C++ to perform comparisons are also available in java
with same behavior. Likewise for, while and do-while control structures are alike to C++.
3.7
Reference:
Java tutorial: http://www.dickbaldwin.com/java
Example code, their explanations and corresponding figures for this handout are taken from
CopyrightVirtualUniversityofPakistan
Page26
WebDesignandDevelopment(CS506)
the book JAVA A Lab Course by Umair Javed. This material is available just for the use of
VU students of the course Web Design and Development and not for any other commercial
purpose without the consent of author.
Note: Coding exercises in working condition for this lecture are also available onDownloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page27
WebDesignandDevelopment(CS506)
Lecture 4: Object Oriented Programming
Java is fundamentally object oriented. Every line of code you write in java must be inside a class
(not counting import directives).OOP fundamental stones Encapsulation, Inheritance and
Polymorphism etc. are all fully supported by java.
4.1
4.1.1 Classes
4.1.2 Objects
4.1.3 Constructor
A special method that is implicitly invoked. Used to create an Object (that is,
an Instance of the Class) and to initialize it.
4.1.4 Attributes
4.1.5 Methods
CopyrightVirtualUniversityofPakistan
Page28
WebDesignandDevelopment(CS506)
4.2
Defining a Class
class point {
private int xCord;
4.3
Some important points to consider when defining a class in java as you probably noticed from the
above given skeleton are
There are no global variables or functions. Everything resides inside a class. Remember
we wrote our main method inside a class.(For example, in HelloWorldApp
program)
Specify access modifiers (public, private or protected) for each member method or data
members at every line.
o public: accessible anywhere by anyone
o private: Only accessible within this class
o protect: accessible only to the class itself and to its subclasses or other classes in
the same package.
o default: default access if no access modifier is provided. Accessible to all classes in
the same package.
There is no semicolon (;) at the end of class.
All methods (functions) are written inline. There are no separate header and
implementation files.
Automatic initialization of class level data members if you do not initialize them
o Primitives
Note: Remember, the same rule is not applied to local variables (defined inside
CopyrightVirtualUniversityofPakistan
Page29
WebDesignandDevelopment(CS506)
method body). Using a local variable without initialization is a compile time error
public void someMethod( ) {
int x; //local variable
System.out.println(x); // compile time error
}
Constructor
Getters / Setters
The attributes of a class are generally taken as private or protected. So to access them outside of
a class, a convention is followed knows as getters & setters. These are generally public
methods. The words set and get are used prior to the name of an attribute. Another
important purpose for writing getter & setters to control the values assigned to an attribute.
Student Class Code
// File Student.java
public class Student {
private String name;
CopyrightVirtualUniversityofPakistan
Page30
WebDesignandDevelopment(CS506)
private int rollNo;
// Standard Setters
public void setName (String name) {
this.name = name;
}
// Note the masking of class level variable rollNo
public void setRollNo (int rollNo) {
if (rollNo > 0) {
this.rollNo = rollNo; }else {
this.rollNo = 100;
}
}
// Standard Getters
public String getName ( ) {
return name;
}
public int getRollNo ( ) {
return rollNo;
}
// Default Constructor
public Student() {
name = not set;
rollNo = 100;
}
// parameterized Constructor for a new student
public Student(String name, int rollNo) {
setName(name);//call to setter of name
setRollNo(rollNo); //call to setter of rollNo
}
// Copy Constructor for a new student public Student(Student s) {
name = s.name;
rollNo = s.rollNo;
}
// method used to display method on console public void print () {
System.out.print("Student name: " +name);
System.out.println(", roll no: " +rollNo); }
} // end of class
4.6
Using a Class
Objects of a class are always created on heap using the new operator followed by
constructor
Student s = new Student ( ); // no pointer operator * between Student and s
Only String constant is an exception
o String greet = Hello ; // No new operator
CopyrightVirtualUniversityofPakistan
Page31
WebDesignandDevelopment(CS506)
Create objects of student class by calling default parameterize and copy constructor
Call student class various methods on these objects.
Page32
WebDesignandDevelopment(CS506)
declared
protected or private
*/
} //end of main
} //end of class
4.7
More on Classes
4.7.1 Static
A c l a s s can have static variables and methods. Static variables and methods are
associated with the class itself and are not tied to any particular object. Therefore statics can be
accessed without instantiating an o b j e c t . Static methods and v a r i a b l e s are
g e n e r a l l y accessed by class name.
The most important aspect of statics is that they occur as a single copy in the class
regardless of the number of objects. Statics are shared by all objects of a class. Non static methods
and instance variables are not accessible inside a static method because no this reference is
available inside a static method.
We have already used some static variables and methods. Examples are
Page33
WebDesignandDevelopment(CS506)
4.7.2.1 Finalize
When a finalize method is defined in a class, Java run time calls finalize() whenever it is about to
recycle an object of that class. It is noteworthy that a garbage collector reclaims objects in any order
or never reclaims them. We cannot predict and assure when garbage collector will get back the
memory of unreferenced objects.
The garbage collector can be requested to run by calling System.gc() method. It is not necessary
that it accepts the request and run.
Page34
WebDesignandDevelopment(CS506)
public class Student {
private String name;
private int rollNo;
private static int countStudents = 0;
// Standard Setters
public void setName (String name) {
this.name = name;
}
// Note the masking of class level variable rollNo
public void setRollNo (int rollNo) {
if (rollNo > 0) {
this.rollNo = rollNo; }else {
this.rollNo = 100;
}
}
// Standard Getters
public String getName ( ) {
return name;
}
public int getRollNo ( ) {
return rollNo;
}
// gettter of static countStudents variable
public static int getCountStudents(){
return countStudents;
}
// Default Constructor public Student() {
name = not set;
rollNo = 100;
countStudents += 1;
}
// method used to display method on console
public void print () {
System.out.print("Student name: " +name);
System.out.println(", roll no: " +rollNo);
}
// overriding toString method of java.lang.Object class
public String toString(){
return name: + name + RollNo: + rollNo;
}
// overriding finalize method of Object class
public void finalize(){
countStudents -= 1;
}
} // end of class
CopyrightVirtualUniversityofPakistan
Page35
WebDesignandDevelopment(CS506)
Next, well write driver class. After creating two objects of student class, we deliberately
loose objects reference and requests the JVM to run garbage collector to reclaim the
memory. By printing countStudents value, we can confirm that. Coming up code is of the
Test class.
// File Test.java public class Test{
public static void main (String args[]){
int numObjs;
// printing current number of objects i.e 0
numObjs = Student.getCountStudents();
System.out.println(Students Objects + numObjs);
// Creating first student object & printing its values
Student s1 = new Student("ali", 15);
System.out.println(Student: + s1.toString());
// printing current number of objects i.e. 1
numObjs = Student.getCountStudents();
System.out.println(Students Objects + numObjs);
// Creating second student object & printing its values
Student s2 = new Student("usman", 49);
Page36
WebDesignandDevelopment(CS506)
System.gc();
// printing current number of objects i.e. unpredictable
numObjs = Student.getCountStudents();
System.out.println(Students Objects + numObjs);
} //end of main
} //end of class
The compilation and execution of the above program is given below. Note that output may be
different one given here because it all depends whether garbage collector reclaims the
memory or not. Luckily, in my case it does.
C:\WINDOWS\system32\cmd.exe
4.8
Reference:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page37
WebDesignandDevelopment(CS506)
Lecture 5: Inheritance
In general, inheritance is used to implement a is-a relationship. Inheritance saves code rewriting
for a client thus promotes reusability.
In java parent or base class is referred as super class while child or derived class is known as sub
class.
5.1
Java only supports single inheritance. As a result a class can only inherit from
one class at one time.
Keyword extends is used instead of : for inheritance.
All functions are virtual by default
All java classes inherit from Object class (more on it later).
To explicitly call the super class constructor, use super keyword. Its important
to remember that call to super class constructor must be first line.
Keyword super is also used to call overridden methods.
Page38
WebDesignandDevelopment(CS506)
this.id = id;
}
public void setName (String name) {
this.name = name;
}
//getters
public int getId () {
return id;
}
public String getName () {
return name;
}
// displaying employee object on console
public void display(){
System.out.println(in employee display method);
System.out.println("Employee id:" + id + " name:" + name);
}
//overriding objects class toString method
public String toString() {
System.out.println(in employee toString method);
return "id:" + id + "name:" + name;
}
}//end class
The Teacher class extends from Employee class. Therefore Teacher class is a subclass of
Employee. The teacher class has an additional attribute i.e. qualification.
class Teacher extends Employee{
private String qual;
//default constructor
public Teacher () {
//implicit call to superclass default construct qual = "";
}
//parameterized constructor
public Teacher(int i, String n, String q){
//call to superclass param const must be first line
super(i,n);
qual = q;
}
CopyrightVirtualUniversityofPakistan
Page39
WebDesignandDevelopment(CS506)
//setter
public void setQual (String qual){
this.qual = qual;
}
//getter
public String getQual(){
return qual;
}
//overriding display method of Employee class
public void display(){
System.out.println("in teacher's display method");
super.display(); //call to superclass display method
System.out.println("Teacher qualification:" + qual);
}
//overriding toString method of Employee class
public String toString() {
System.out.println("in teacher's toString method");
String emp = super.toString();
return emp +" qualification:" + qual;
}
}//end class
Objects of Employee & Teacher class are created inside main method in Test class. Later calls
are made to display and toString method using these objects.
class Test{
public static void main (String args[]){
System.out.println("making object of employee");
Employee e = new Employee(89, "khurram ahmad");
System.out.println("making object of teacher");
Teacher t = new Teacher (91, "ali raza", "phd");
e.display(); //call to Employee class display method
t.display(); //call to Teacher class display method
CopyrightVirtualUniversityofPakistan
Page40
WebDesignandDevelopment(CS506)
// calling employee class toString method explicitly
System.out.println("Employee: " +e.toString());
// calling teacher class toString implicitly
System.out.println("Teacher: " + t);
} //end of main
}//end class
Output
C:\WINDOWS\system32\cmd.exe
5.2
The Object class in Java is a superclass for all other classes defined in Java's class
libraries, as well as for user-defined Java classes. For user defined classes, its not
necessary to mention the Object class as a super class, java does it automatically for you.
The class Hierarchy of Employee class is shown below. Object is the super class of Employee
class and Teacher is a subclass of Employee class. We can make another class Manager that can also
extends from Employee class.
CopyrightVirtualUniversityofPakistan
Page41
WebDesignandDevelopment(CS506)
5.3 Polymorphism
Polymorphic literally means of multiple shapes and in the context of OOP,
Polymorphic means having multiple behaviors.
A parent class reference can point to the subclass objects because of is-a relationship.
For example a Employee reference can point to:
o Employee Object
o Teacher Object
o Manager Object
A polymorphic method results in different actions depending on the object being
referenced
o
Page42
WebDesignandDevelopment(CS506)
// is-a relationship, polymorphism
//call to Employee class display method
ref1.display();
//call to Teacher class display method
ref2.display();
System.out.println("Employee: " +ref1.toString());// call to Employee class toString method
System.out.println("Teacher: " + ref2.toString());// call to Teacher class toString method
} //end of main
}//end class
Output
C:\WINDOWS\system32\cmd.exe
5.4
Type Casting
In computer science, type conversion or typecasting refers to changing an entity of one data type
into another. Type casting can be categorized into two types
5.4.1 Up-casting
CopyrightVirtualUniversityofPakistan
Page43
WebDesignandDevelopment(CS506)
5.4.2 Down-casting
5.5
References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page44
WebDesignandDevelopment(CS506)
Lecture 6: Collections
A collection represents group of objects know as its elements. Java has a built-in support for
collections. Collection classes are similar to STL in C++. An advantage of a collection over
an array is that you dont need to know the eventual size of the collection in order to add objects to
it. The java.utilpackage provides a set of collection classes that helps a programmer in number of
ways.
6.1
Collections Design
All classes almost provides same methods like get (), size (), isEmpty() etc. These methods will
return the object stored in it, number of objects stored and whether collection contains an
object or not respectively.
Java collections are capable of storing any kind of objects. Collections store references to
objects. This is similar to using a void* in C. therefore down casting is required to get the
actual type. For example, if string in stored in a collection then to get it back, we write
String element = (String)arraylist.get(i);
6.2 Collection messages
Some basic messages (methods) are:
Constructor
o creates a collection with no elements.
int size()
o returns the number of elements in a collection.
boolean add(Object)
o adds a new element in the collection.
o returns true if the element is added successfully false otherwise.
boolean isEmpty()
o returns true if this collection contains no element false otherwise.
boolean contains(Object)
o returns true if this collection contains the specified element by using iterative
search.
boolean remove(Object)
o removes a single instance of the specified element from this collection, if it is
present .
CopyrightVirtualUniversityofPakistan
Page45
WebDesignandDevelopment(CS506)
6.3 Array List
Its like a resizable array. Array List actually comes as a replacement the old Vector
collection. As we add or remove elements into or from it, it grows or shrinks over time.
6.3.1 Useful Methods
add (Object)
o With the help of this method, any object can be added into Array List because
Object is the superclass of all classes.
o Objects going to add will implicitly up cast.
Object get(int index)
o Returns the element at the specified position in the list
o Index ranges from 0 to size()-1
o Must cast to appropriate type
remove (int index)
Page46
WebDesignandDevelopment(CS506)
al.add(s1);
al.add(s2);
al.add(s3);
// checking whether arraylist is empty or not Boolean
b = al.isEmpty ();
if (b == true) {
System.out.println(arraylist is empty);
}
else {
int size = al.size();
System.out.println(arraylist size: + size);
}
// using loop to iterate. Loops starts from 0 to one
// less than size
for (int i=0; i<al.size(); i++ ){
// retrieving object from arraylist
Student s = (Student) al.get(i);
// calling student class print method
s.print();
} // end for loop
} // end main
} // end class
Output
C:\WINDOWS\system32\cmd.exe
6.4
HashMap
Store elements in the form of key- value pair form. A key is associated with each object that is stored.
This allows fast retrieval of that object. Keys are unique.
CopyrightVirtualUniversityofPakistan
Page47
WebDesignandDevelopment(CS506)
Page48
WebDesignandDevelopment(CS506)
// retrieving student object against rollno two and
// performing downcasting
Student s = (Student) h.get(two);
// calling students class print method s.print();
} // end main
} // end class
Output
C:\WINDOWS\system32\cmd.exe
6.5
References:
J2SE 5.0 new features: http://java.sun.com/j2se/1.5.0/docs/relnotes/features.html
Technical Article: http://java.sun.com/developer/technicalArticles/releases/j2se15/
Beginning Java2 by Ivor Horton
Example code, their explainations and corresponding figures for this handout are taken
from the book JAVA A Lab Course by Umair Javed. This material is available just for
the use of VU students of the course Web Design and Development and not for any other
commercial purpose without the consent of author.
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
6.6
Address Book
Warning: It is strongly advised that you have to type the code given in this example by yourself.
Do not copy/paste it; most probably you will get unexpected errors that you have never
seen. Some bugs are deliberately introduced as well to avoid copy-pasting. TAs will not
cooperate with you in debugging such errors.
CopyrightVirtualUniversityofPakistan
Page49
WebDesignandDevelopment(CS506)
6.6.1 Problem
We want to build an address book that is capable of storing name, address & phone
number of a person.
Address book provides functionality in the form of a JOptionPane based menu. The
feature list includes
o Add - to add a new person record
o Delete - to delete an existing person record by name
o Search - to search a person record by name
o Exit - to exit from application
The Address book should also support persistence for person records
First of all you need to store your desired information for each person. For this you
can create a user-defined data type (i.e. a class). Make a class PersonInfowith name,
address and phone number as its attributes.
Write a parameterized constructor for this class.
Write print method in Person class that displays one person record on a message
dialog box.
The code for PersonInfo class is given below.
import javax.swing.*;
class PersonInfo {
String name;
String address;
String phoneNum;
//parameterized constructor
public PersonInfo(String n, String a, String p) {
name = n; address = a; phoneNum = p;
}
//method for displaying person record on GUI
public void print( ) {
JOptionPane.showMessageDialog(null, name: + name + address: +address + phone no: +
CopyrightVirtualUniversityofPakistan
Page50
WebDesignandDevelopment(CS506)
phoneNum);
}
}
Note: Not declaring attributes as private is a bad approach but we have done it to keep
things simple here.
6.6.2.2 Step2 - Make Address Book class
Take the example of daily life; generally address book is used to store more than one
person records and we dont know in advance how many records are going to be added
into it.
So, we need some data structure that can help us in storing more than one
PersonInfoobjects without concerning about its size.
Array Listcan be used to achieve the above functionality
Create a class Address Book with an ArrayList as its attribute. This arraylist will be used to
store the information of different persons in the form of PersonInfo Objects.
This class will also provide addPerson, deletePerson & searchPerson methods.
These methods are used for adding new person records, deleting an existing person
record by name and searching among existing person records by name respectively.
Input/Output will be performed through JOptionPane.
Page51
WebDesignandDevelopment(CS506)
for (int i=0; i< persons.size(); i++) {
PersonInfo p = (PersonInfo)persons.get(i);
if ( n.equals(p.name) ) {
p.print();
}
} // end for
} // end searchPerson
//delete person record by name by iterating over arraylist
public void deletePerson (String n) {
for (int i=0; i< persons.size(); i++) {
PersonInfo p = (PersonInfo)persons.get(i);
if ( n.equals(p.name))
{
persons.remove(i);
}
}
}
} // end class
The addperson method first takes input for name, address and phone number and than
construct a PersonInfo object by using the recently taken input values. Then the newly
constructed object is added to the arraylist - persons.
The searchPerson & deletePerson methods are using the same methodology i.e. first they search
the required record by name and then prints his/her detail or delete the record permanently
from the ArrayList.
Both the methods are taking string argument, by using this they can perform their search or
delete operation. We used forloop for iterating the whole ArrayList.By using the size method
of ArrayList, we can control our loop as ArrayList indexes range starts from 0 to one less than
size.
Notice that, inside loop we retrieve each PersonInfo object by using down casting
operation. After that we compare each PersonInfo objects name by the one passed to these
methods using equal method since Strings are always being compared using equalmethod.
Inside if block of searchPerson, print method is called using PersonInfo object that will display
person information on GUI. On the other hand, inside if block of deletePerson method,
remove method of ArrayList class is called that is used to delete record from persons i.e.
ArrayList.
6.6.2.3 Step3 - Make Test class (driver program)
Page52
WebDesignandDevelopment(CS506)
import javax.swing.*;
class Test {
public static void main (String args[]) {
AddressBook ab = new AddressBook();
String input, s;
int ch;
while (true) {
input = JOptionPane.showInputDialog(Enter 1 to add + \n Enter 2 to Search \n Enter 3 to
Delete +
\n Enter 4 to Exit);
ch = Integer.parseInt(input);
switch (ch) {
case 1:
ab.addPerson();
break;
case 2:
s = JOptionPane.showInputDialog( Enter name to search );
ab.searchPerson(s);
break;
case 3:
s = JOptionPane.showInputDialog( Enter name to delete );
ab.deletePerson(s);
break;
case 4: System.exit(0);
}
}//end while
}//end main
}
Note that we use infinite while loop that would never end or stop given that our program should
only exit when user enters 4 i.e. exit option.
Compile & Execute
Compile all three classes and run Test class. Bravo, you successfully completed the all basic
three steps. Enjoy!
6.7
Reference
Entire content for this handout are taken from the book JAVA A Lab Course by Umair Javed.
This material is available just for the use of VU students of the course Web Design and
Development and not for any other commercial purpose.
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page53
WebDesignandDevelopment(CS506)
Lecture 7: Intro to Exceptions
7.1
Types of Errors
Generally, you can come across three types of errors while developing software. These are
Syntax, Logic & Runtime errors.
7.1.1
Syntax Errors
7.1.2
Logic Errors
Indicates that logic used for coding doesnt produce expected output.
7.2
What is an Exception?
7.3
ignore it
handle it where it occurs
handle it an another place in the program
Helps to separate error handling code from main logic (the normal code you write) of
the program.
As different sort/type of exceptions can arise, by handling exceptions we can
CopyrightVirtualUniversityofPakistan
Page54
WebDesignandDevelopment(CS506)
7.4
Exceptions in Java
7.5
distinguish between them and write appropriate handling code for each type for
example we can differently handle exceptions that occur due to division by Zero and
exceptions that occur due to non-availability of a file.
If not handled properly, program might terminate.
Exception Hierarchy
7.6
Types of Exceptions
Exceptions can be broadly categorized into two types, Unchecked & Checked Exceptions.
CopyrightVirtualUniversityofPakistan
Page55
WebDesignandDevelopment(CS506)
7.7
Java handles exceptions via 5 keywords. Try, catch, finally, throw & throws.
The basic structure of using try - catch - finally block is shown in the picture below:
CopyrightVirtualUniversityofPakistan
Page56
WebDesignandDevelopment(CS506)
7.7.4 throw
7.7.5
To manually throw an exception, keyword throwis used. Note: we are not covering throw
clause in this handout
throws
If method is not interested in handling the exception than it can throw back the
exception to the caller method using throwskeyword.
Any exception that is thrown out of a method must be specified as such by a
throws clause.
7.8
References:
7.9
Page57
WebDesignandDevelopment(CS506)
The following program takes one command line argument and prints it on the console
// File UcException.java public class UcException {
public static void main (String args[ ]) {
System.out.println(args[0]);
}
}
Compile & Execute
If we compile & execute the above program without passing any command line
argument, an ArrayIndexOutOfBoundsException would be thrown. This is shown in the
following picture
C:\WINDOWS\system32\cmd.exe
7.9.2 Why?
Since we have passed no argument, therefore the size of String args[]is zero, and we
have tried to access the first element (first element has index zero) of this array.
From the output window, you can find out, which code line causes the exception to be raised. In
the above example, it is
System.out.println (args[0]);
7.9.3 Modify UcException.java
Though it is not mandatory to handle unchecked exceptions we can still handle
Unchecked Exceptions if we want to. These modifications are shown in bold.
// File UcException.java
public class UcException {
public static void main (String args[ ]) {
CopyrightVirtualUniversityofPakistan
Page58
WebDesignandDevelopment(CS506)
try {
System.out.println(args[0]);
catch (IndexOutOfBoundsException ex) {
System.out.println(You forget to pass command line argument);
}
}
The possible exception that can be thrown is IndexOutOfBoundsException, so we handle it
in the catch block.
When an exception occurs, such as IndexOutOfBoundsException in this case, then an
object of type IndexOutOfBoundesException is created and it is passed to the
corresponding catch block (i.e. the catch block which is capable of handling this
exception). The catch block receives the exception object inside a variable which is ex in
this case. It can be any name; it is similar to the parameter declared in the method
signature. It receives the object of exception type (IndexOutOfBoundsExceptoin) it is
declared.
Compile & Execute
If we execute the modified program by passing command line argument, the program would
display on console the provided argument. After that if we execute this program again without
passing command line argument, this time information message would be displayed which is
written inside catch block.
C:\WINDOWS\system32\cmd.exe
Page59
WebDesignandDevelopment(CS506)
import java.io.* ;
public class CException {
public static void main (String args[ ]) { FileReader fr = new FileReader (input.txt);
BufferedReader br = new BufferedReader (fr);
//read the line form file
String line = br.readLine(); System.out.println(line);
}
C:\WINDOWS\system32\cmd.exe
2 errors
D:\examples\Exceptions>
Modify CException.java
As we have discussed earlier, it is mandatory to handle checked exceptions. In order to
compile the code above, we modify the above program so that file reading code is
placed inside a try block. The expected exception (IOException) that can be raised is
caught in catch block.
// File CException.java import java.io.* ;
CopyrightVirtualUniversityofPakistan
Page60
WebDesignandDevelopment(CS506)
public class CException {
public static void main (String args[ ]) {
try{
FileReader fr = new FileReader (input.txt);
BufferedReader br = new BufferedReader (fr);
//read the line form file
String line = br.readLine();
System.out.println(line);
}
catch( IOException ex) {
System.out.println(ex);
}
}
}
The code line written inside the catch block will print the exception name on the console if
exception occurs
Compile & Execute
After making changes to your program, it would compile successfully. On executing this program,
hello world would be displayed on the console
Note: Before executing, make sure that a text file named input.txt must be placed in the
same directory where the program is saved. Also write hello world in that file before
saving it.
C:\WINDOWS\system32\cmd.exe
Page61
WebDesignandDevelopment(CS506)
import java.io.* ;
public class FBlockDemo {
public static void main (String args[ ])
{
try{
FileReader fr = new FileReader (strings.txt);
BufferedReader br = new BufferedReader (fr);
//read the line form file
String line = br.readLine();
System.out.println(line);
}catch( IOException ex) {
System.out.println(ex);
}
finally {
System.out.println(finally block always execute);
}
}
}
Compile & Execute
The program above, will read one line from string.txt file. If string.tx is not present in the same
directory the FileNotFoundException would be raised and catch block would execute as well
as the finally block.
C:\WINDOWS\system32\cmd.exe
CopyrightVirtualUniversityofPakistan
Page62
WebDesignandDevelopment(CS506)
7.12 Multiple catch blocks
Page63
WebDesignandDevelopment(CS506)
thrown during execution.
C:\WINDOWS\system32\cmd.exe
If numbers.txt present in the same directory and contains a number, than hopefully no exception
would be thrown.
C:\WINDOWS\system32\cmd.exe
Page64
WebDesignandDevelopment(CS506)
try{
FileReader fr = new FileReader (strings.txt);
BufferedReader br = new BufferedReader (fr);
//read the line form file
String s = br.readLine();
System.out.println(s);
}
catch( IOException ioEx) {
ioEx.printStackTrace(); }
}// end method 2
//only calling method2
public static void method1( )
{
method2();
}
public static void main (String args[ ]) {
ThrowsDemo.method1();
}
}
7.14 printStackTrace method
Defined in the Throwableclass - superclass of Exception & Error classes
Shows you the full method calling history with line numbers.
extremely useful in debugging
Modify: ThrowsDemo.java
Let method2 doesnt want to handle exception by itself, so it throws the exception to
the caller of method2i.e. method1
So method1 either have to handle the incoming exception or it can re-throw it to its
caller i.e. main.
Let method1 is handling the exception, so method1& method2 would be
modified as:
// File ThrowsDemo.
java import java.io.* ;
public class ThrowsDemo {
// contains file reading code
public static void method2( ) throws IOException{
FileReader fr = new FileReader (strings.txt);
BufferedReader br = new BufferedReader (fr);
//read the line form file
CopyrightVirtualUniversityofPakistan
Page65
WebDesignandDevelopment(CS506)
String s = br.readLine();
System.out.println(s);
}// end method 2
// calling method2 & handling incoming exception
public static void method1( ) {
try {
method2();
}
catch (IOException ioEx) {
ioEx.printStackTrace(); }
}
public static void main (String args[ ]) {
ThrowsDemo.method1();
}
}
Compile & Execute
If file strings.txt is not present in the same directory, method2 will throw an exception that
would be caught by method1and the printStackTracemethod will print the full calling history on
console. The above scenario is shown in the output below:
C:\WINDOWS\system32\cmd.exe
If file strings.txt exist there, than hopefully line would be displayed on the console.
CopyrightVirtualUniversityofPakistan
Page66
WebDesignandDevelopment(CS506)
7.15 Reference
Example code, their explanations and corresponding figures for this handout are taken
from the book JAVA A Lab Course by Umair Javed. This material is available just for
the use of VU students of the course Web Design and Development and not for any other
commercial purpose without the consent of author.
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page67
WebDesignandDevelopment(CS506)
Lecture 8: Streams
I/O libraries often use the abstraction of a stream, which represents any data source or sink as an
object capable of producing or receiving pieces of data.
The Java library classes for I/O are divided by input and output. You need to import
java.io package to use streams. There is no need to learn all the streams just do it on the need basis.
8.1
So you can consider stream as a data path. Data can flow through this path in one
direction between specified terminal points (your program and file, console, Socket etc.)
CopyrightVirtualUniversityofPakistan
Page68
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page69
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page70
WebDesignandDevelopment(CS506)
8.3
CopyrightVirtualUniversityofPakistan
Page71
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page72
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page73
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page74
WebDesignandDevelopment(CS506)
Reference
CopyrightVirtualUniversityofPakistan
Page75
WebDesignandDevelopment(CS506)
8.5
Example code, their explanations and corresponding figures for this handout are taken
from the book JAVA A Lab Course by Umair Javed. This material is available just for
the use of VU students of the course Web Design and Development and not for any other
commercial purpose without the consent of author.
We will read records from a text file named persons.txt. The person records will be present in the
file in the following format.
Ali, defence, 9201211
Usman, gulberg, 5173940
Salman, LUMS, 5272670
persons.txt
CopyrightVirtualUniversityofPakistan
Page76
WebDesignandDevelopment(CS506)
As you have seen, each person record is on a separate line. Persons name, address & phone
number is separated using comma (,).
We will modify our AddressBook.javaby adding a new method loadPersons into it. This
method will provide the implementation of all the steps. The method is shown below:
public void loadPersons ( ){
String tokens[] = null;
String name, add, ph;
try {
FileReader fr = new FileReader("persons.txt");
BufferedReader br = new BufferedReader(fr);
String line = br.readLine();
while ( line != null ) {
tokens = line.split(",");
name = tokens[0];
add = tokens[1];
ph = tokens[2];
PersonInfo p =
new PersonInfo(name, add, ph);
persons.add(p);
line = br.readLine();
}
br.close();
fr.close();
}catch(IOException ioEx){
System.out.println(ioEx);
}
}
First, we have to connect with the text file in order to read line by line person records
from it. This task is accomplished with the following lines of code:
FileReader fr = new FileReader(persons.txt);
BufferedReader br = new BufferedReader(fr);
FileReaderis a character based (node) stream that helps us in reading data in the form of
characters. As we are using streams, so we have to import the java.io package in the
AddressBookclass.
CopyrightVirtualUniversityofPakistan
Page77
WebDesignandDevelopment(CS506)
We passed the file name persons.txtto the constructor of the FileReader.
Next we add BufferedReader (filter stream) on top of the FileReader because
BufferedReader
facilitates reading data line by line. (As you can recall
from the lecture that filter streams are attached on top of node streams). Thats why
the constructor of BufferedReader is receiving the fr - the FileReader
object.
The next line of code will read line from file by using readLine() method of
BufferedReaderand save it in a string variable called line.
String line = br.readLine();
After that while loop starts. The condition of while loop is used to check whether the file is
reached to end (returns null) or not. This loop is used to read whole file till the end. When
end comes (null), this loop will finish.
while (line != null)
Inside loop, the first step we performed is tokenizing the string. For this purpose, we have
used split method of String class. This method returns substrings (tokens) according to the
regular expression or delimiter passed to it.
tokens = line.split(,);
The return type of this method is array of strings thats why we have declared tokens as a String
array in the beginning of this method as
String tokens[];
For example, the line contains the following string
Ali,defence,9201211
Now by calling split(,) method on this string, this method will return back three substrings
ali defence and 9201211 because the delimiter we have passed to it is comma. The delimiter
itself is not included in the substrings or tokens.
The next three lines of code are simple assignments statements. The tokens[0]contains the
name of the person because the name is always in the beginning of the line, tokens[1]
contains address of the person and tokens[2] contains the phone number of the person.
name = tokens[0]; add=
tokens[1]; ph= tokens[2];
The name, add and ph are of type String and are declared in the beginning of this method.
After that we have constructed the object of PersonInfo class by using parameterized
constructor and passed all these strings to it.
PersonInfo p = new PersonInfo(name, add, ph);
CopyrightVirtualUniversityofPakistan
Page78
WebDesignandDevelopment(CS506)
persons.add(p);
The last step we have done inside loop is that we have again read a line from the file by
using the readLine()method.
By summarizing the task of while loop we can conclude that it reads the line from a
file,tokenize that line into three substrings followed by constructing the PersonInfo
object by using these tokens. And adding these objects to the arraylist. This process
continues till the file reaches its end.
The last step for reading information from the file is ordinary one - closing the
streams, because files are external resources, so its better to close them as soon as possible.
Also observe that we used try/catch block because using streams can result in raising
exceptions that falls under the checked exceptions category - that needs mandatory
handling.
The last important step you have to perform is to call this method while loading up.
The most appropriate place to call this method is from inside the constructor of
AddressBook.java. So the constructor will now look like similar to the one given below:
AddressBook.java
Page79
WebDesignandDevelopment(CS506)
String line;
FileWriter fw = new FileWriter("persons.txt");
PrintWriter pw = new PrintWriter(fw);
for(int i=0; i<persons.size(); i++)
{
p = (PersonInfo)persons.get(i);
line = p.name +","+ p.address +","+ p.phoneNum;
// writes line to file (persons.txt)
pw.println(line);
} pw.flush();
pw.close();
fw.close();
}
catch(IOException ioEx){
System.out.println(ioEx);
}
}
As you can see, that we have opened the same file (persons.txt)again by using a set of
streams.
After that we have started for loop to iterate over arraylist as we did in
searchPersonand deletePersonmethods.
Inside forloop body, we have taken out PersonInfoobject and after type casting it we
have assigned its reference to a PersonInfo type local variable p. This is achieved by
the help of following line of code
p = (PersonInfo)persons.get(i);
Next we build a string and insert commas between the PersonInfoattributes and assign the
newly constructed string to strings local variable lineas shown in the following line of code.
line = p.name +","+ p.address +","+ p.phoneNum;
Note: Since, we havent declare PersonInfo attributes private, therefore we are able to
directly access them inside AddressBook.java.
The next step is to write the line representing one PersonInfo objects information, to
the file. This is done by using printlnmethod of PrintWriteras shown below
pw.println(line);
After writing line to the file, the printlnmethod will move the cursor/control to the next line.
Thats why each line is going to be written on separate line.
The last step for saving information to the file is ordinary one - closing the streams but
before that notice the code line that you have not seen/performed while loading persons
records from file. That is
CopyrightVirtualUniversityofPakistan
Page80
WebDesignandDevelopment(CS506)
pw.flush( );
The above line immediately flushes data by writing any buffered output/data to file. This step is
necessary to perform or otherwise you will most probably lose some data for the reason that
PrintWriter is a Buffered Stream and they have their own internal memory/storage capacity
for efficiency reasons. Buffered Streams do not send the data until their memory is full.
case 4:
ab.savePersons();
System.exit(0);
Test.java
Compile & Execute
Now again after compiling all the classes, run the Test class. Initially we are assuming
that out persons.txt file is empty, so our arraylist persons will be empty on the first start
up of address book. Now add some records into it, perform search or delete operations.
Exit from the address book by choosing option 4. Check out the persons.txt file. Dont get
surprised by seeing that it contains all the person records in the format exactly we have seen above.
Next time you will run the address book; all the records will be available to you. Perform the search or
delete operation to verify that. Finally you have done it!!!
8.6
References
Example code, their explanations and corresponding figures for this handout are taken
from the book JAVA A Lab Course by Umair Javed. This material is available just for
the use of VU students of the course Web Design and Development and not for any other
commercial purpose without the consent of author.
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page81
WebDesignandDevelopment(CS506)
Before moving on to abstract classes, first examine the following class hierarchy shown
below:
Suppose that in order to exploit polymorphism, we specify that 2-D objects must be able to
compute their area.
o
Page82
WebDesignandDevelopment(CS506)
If subclass overrides all abstract methods of the superclass, than it becomes a concrete (a class
whose object can be instantiate) class otherwise we have to declare it as abstract or we cannot
compile it.
The most important aspect of abstract class is that reference of an abstract class can point to
the object of concrete classes.
Code Example of Abstract Classes
The Shape class contains an abstract method calculateArea() with no definition.
Class Circle extends from abstract Shape class, therefore to become concrete class it
must provides the definition of calculateArea() method.
public class Circle extends Shape {
private int x, y;
private int radius;
public Circle() {
x = 5;
y = 5;
radius = 10;
}
// providing definition of abstract method
public void calculateArea () {
double area = 3.14 * (radius * radius);
System.out.println(Area: + area);
}
}//end of class
The Test class contains main method. Inside main, a reference s of abstract Shape class is created.
This reference can point to Circle (subclass of abstract class Shape) class object as it is a
concrete class. With the help of reference, method calculateArea() can be invoked of Circle
class. This is all shown in the form of code below:
public class Test {
public static void main(String args[]){
CopyrightVirtualUniversityofPakistan
Page83
WebDesignandDevelopment(CS506)
//can only create references of A.C.
Shape s = null;
//Shape s1 = new Shape(); //cannot instantiate
//abstract class reference can point to concrete subclass
s = new Circle();
s.calculateArea();
}
}//end of class
The compilation and execution of the above program is shown below:
C:\WINDOWS\system32\cmd.exe
9.3
Interfaces
As we seen one possible javas solution to problem discussed in start of the tutorial. The second
possible javas solution is Interfaces.
Interfaces are special java type which contains only a set of method prototypes, but does not provide
the implementation for these prototypes. All the methods inside an interface are abstract by default
thus an interface is tantamount to a pure abstract class - a class with zero implementation. Interface
can also contains static final constants
CopyrightVirtualUniversityofPakistan
Page84
WebDesignandDevelopment(CS506)
public interface Speaker{
public void speak();
}
9.3.2 Implementing (using) Interface
Classes implement interfaces. Implementing an interface is like signing a contract. A
class that implements an interface will have to provide the definition of all the methods
that are present inside an interface. If the class does not provide definitions of all
methods, the class would not compile. We have to declare it as an abstract class in order
to get it compiled.
Relationship between a class and interface is equivalent to responds to while is a
relationship exists in inheritance.
Code Example of Defining & Implementing an Interface The interface Printable contains print()
method.
public interface Printable{
public void print();
}
Class Student is implementing the interface Printable. Note the use of keyword
implements after the class name. Student class has to provide the definition of print method
or we are unable to compile.
The code snippet of student class is given below:
public class Student implements Printable {
private String name;
private String address;
public String toString () {
return "name:"+name +" address:"+address;
}
//providing definition of interfaces print method
public void print() {
System.out.println("Name:" +name+" address"+address);
}
}//end of class
9.4 Interface Characteristics
Similar to abstract class, interfaces imposes a design structure on any class that uses the
CopyrightVirtualUniversityofPakistan
Page85
WebDesignandDevelopment(CS506)
interface. Contrary to inheritance, a class can implement more than one interfaces. To
do this separate the interface names with comma. This is javas way of multiple inheritance.
class Circle implements Drawable , Printable { . }
Objects of interfaces also cannot be
instantiated.
Speaker s = new Speaker(); // not compile
However, a reference of interface can be created to point any of its implementation class. This
is interface based polymorphism.
Code Example: Interface based polymorphism
Interface Speaker is implemented by three classes Politician, Coach and Lecturer. Code snippets
of all these three classes are show below:
public class Politician implements Speaker{
public void speak(){
System.out.println(Politics Talks);
}
}
public class Coach implements Speaker{
public void speak(){
System.out.println(Sports Talks);
}
}
public class Lecturer implements Speaker{
public void speak(){
System.out.println(Web Design and Development Talks);
}
}
As usual, Test class contains main method. Inside main, a reference spis created of Speaker
class. Later, this reference is used to point to the objects of Politician, Coach and Lecturer class.
On calling speak method with the help of sp, will invoke the method of a class to which sp is
pointing.
public class Test{
public static void main (String args[ ]) {
Speaker sp = null;
System.out.println("sp pointing to Politician");
sp = new Politician();
CopyrightVirtualUniversityofPakistan
Page86
WebDesignandDevelopment(CS506)
sp.speak();
System.out.println("sp pointing to Coach");
sp = new Coach();
sp.speak();
System.out.println("sp pointing to Lecturer");
sp = new Lecturer();
sp.speak();
}
}
The compilation and execution of the above program is shown below:
C:\WINDOWS\system32\cmd.exe
9.5
References
Example code, their explanations and corresponding figures for this handout are taken
from the book JAVA A Lab Course by Umair Javed. This material is available just for
the use of VU students of the course Web Design and Development and not for any other
commercial purpose without the consent of author.
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page87
WebDesignandDevelopment(CS506)
Page88
WebDesignandDevelopment(CS506)
compared to this SWING components are managed through threads and are known as Light Weight
Components.
This package also provides the classes for robust event handling (see handout on it) and layout
managers.
CopyrightVirtualUniversityofPakistan
Page89
WebDesignandDevelopment(CS506)
10.6.1 import required packages
The add method is used for adding components to the content pane while setLayout
method is used to specify the layout manager.
Container are classified into two broad categories that are Top Level
Containers and General Purpose Containers
Top level containers can contain (add) other containers as well as basic
Components (buttons, labels etc) while general purpose containers are Typically used to
collect basic components and are added to top level containers.
General purpose containers cannot exist alone they must be added to top level containers
Examples of top level container are JFrame, Dialog and Applet etc. Our application
uses one of these.
Examples of general purpose container are JPanel, Toolbar and ScrollPane etc.
So, take a top level container and create its instance. Consider the following code of line if
JFrame is selected as a top level container
JFrame frame = new JFrame();
10.6.3 Get the component area of the top level container
Review the hierarchy given above, and observe that JFrame is a frame is a
window. So, it can be interpreted as JFrame is a window.
Every window has two areas. System Area & Component Area
The programmer cannot add/remove components to the System Area.
The Component Area often known as Client area is a workable place for the
programmer. Components can be added/removed in this area.
So, to add components, as you guessed right component area of the JFrame is required. It
can be accomplished by the following code of line
Container con = frame.getContentPane();
frame is an instance of JFrame and by calling getContentPane() method on it, it returns the
component area. This component area is of type container and that is why it is stored in a
variable of a Container class. As already discussed, container allows other components to
be added / removed.
CopyrightVirtualUniversityofPakistan
Page90
WebDesignandDevelopment(CS506)
10.6.4 Apply layout to component area
The layout (size & position etc. How they appear) of components in a container is
usually governed by Layout Managers.
The layout manager is responsible for deciding the layout policy and size of
its components added to the container.
Layout managers are represented in java as classes. (Layout Managers are
going to be discussed in detail later in this handout)
To set the layout, as already discussed use setLayout method and pass object
of layout manager as an argument.
con.setLayout( new FlowLayout( ) );
After creating all components you are interested in, the next task is to add these
components into the component area of your JFrame (i.e ContentPane, the reference to
which is in variable con of type Container)
Use add method of the Container to accomplish this and pass it the component to be added.
con.add(button);
Page91
WebDesignandDevelopment(CS506)
Example: Making a Simple GUI
MyButton
The above figured GUI contains one text field and a button. Lets code it by following the six
GUI creation steps we discussed.
Code for Simple GUI:
// File GUITest.java
//Step 1: import packages
import java.awt.*;
import javax.swing.*;
public class GUITest {
JFrame myFrame ;
//method used for setting layout of GUI
public void initGUI ( ) {
//Step 2: setup the top level container
myFrame = new JFrame();
//Step 3: Get the component area of top-level container
Container c = myFrame.getContentPane();
//Step 4: Apply layouts
c.setLayout( new FlowLayout( ) );
CopyrightVirtualUniversityofPakistan
Page92
WebDesignandDevelopment(CS506)
//Step 5: create & add components
JTextField tf = new JTextField(10);
JButton b1 = new JButton("My Button");
c.add(tf);
c.add(b1);
//Step 6: set size of frame and make it visible
myFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
myFrame.setSize(200,150);
myFrame.setVisible(true);
} //end initGUI method
public GUITest () {// default constructor
initGUI ();
}
public static void main (String args[ ]) {
GUITest gui = new GUITest();
}
} // end of class
10.7 Important Points to Consider
main method (from where program execution starts) is written in the same class. The
main method can be in a separate class instead of writing in the same class its your
choice.
Inside main, an object of GUI test class is created that results in calling of constructor
of the class and from the constructor, initGUI method is called that is responsible for setting
up the GUI.
The following line of code is used to exit the program when you close the window
myFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
If you delete this line and run your program, the desired GUI would be displayed. However if
you close the window by using (X) button on top left corner of your window, youll notice that
the control doesnt return back to command prompt. The reason for this is that the java process is
still running. However if you put this line in your code, when you exit your prompt will return.
10.8 References:
CopyrightVirtualUniversityofPakistan
Page93
WebDesignandDevelopment(CS506)
10.9 Graphical User Interfaces - 2
Page94
WebDesignandDevelopment(CS506)
myFrame = new JFrame(Flow Layout);
Container c = myFrame.getContentPane();
c.setLayout( new FlowLayout( ) );
b1 = new JButton(Next Slide);
b2 = new JButton(Previous Slide);
b3 = new JButton(Back to Start);
b4 = new JButton(Last Slide);
b5 = new JButton(Exit);
c.add(b1);
c.add(b2);
c.add(b3);
c.add(b4);
c.add(b5);
myFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
myFrame.setSize(300,150);
myFrame.setVisible(true);
} //end initGUI method
public FlowLayoutTest () { // default constructor
initGUI ();
}
public static void main (String args[ ]) {
FlowLayoutTest flTest = new FlowLayoutTest();
}
} // end of class
Output
FlowLayout
NextSlide
Backto
10.9.1.2 Grid
PreviousSlide
LastSlide
Exit
Layout
CopyrightVirtualUniversityofPakistan
Page95
WebDesignandDevelopment(CS506)
Splits the panel/window into a grid(cells) with given number of rows and columns.
Forces the size of each component to occupy the whole cell. Size of each
component is same .
Components are added row wise. When all the columns of the first row are get filled the
components are then added to the next row.
Only one component can be added into each cell.
Example Code
// File GridLayoutTest.java
import java.awt.*;
import javax.swing.*;
public class GridLayoutTest {
JFrame myFrame ;
JButton b1, b2, b3, b4, b5;
//method used for setting layout of GUI
public void initGUI ( ) {
myFrame = new JFrame(Grid Layout);
Container c = myFrame.getContentPane();
// rows , cols
c.setLayout( new GridLayout( 3 , 2 ) );
b1 = new JButton(Next Slide);
b2 = new JButton(Previous Slide);
b3 = new JButton(Back to Start);
b4 = new JButton(Last Slide);
b5 = new JButton(Exit);
c.add(b1);
c.add(b2);
c.add(b3);
c.add(b4);
c.add(b5);
myFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
myFrame.setSize(300,150);
myFrame.setVisible(true);
} //end initGUI method
public GridLayoutTest () { // default constructor
initGUI ();
}
public static void main (String args[ ]) {
GridLayoutTest glTest = new GridLayoutTest();
}
} // end of class
CopyrightVirtualUniversityofPakistan
Page96
WebDesignandDevelopment(CS506)
Output
GridLayout
NextSlide
PreviousSlide
Backto
LastSlide
Exit
Modification
The grid layout also allows the spacing between cells. To achieve spacing between cells, modify the
above program.
Pass additional parameters to the constructor of GridLayout, spaces between rows & spaces between
columns as shown below
c.setLayout( new GridLayout( 3 , 2,10 , 20) );
The output is look similar to one given below.
GridLayout
NextSlide
PreviousSlide
Backto
LastSlide
Exit
CopyrightVirtualUniversityofPakistan
Page97
WebDesignandDevelopment(CS506)
10.9.1.3 Border Layout
Divides the area into five regions. North, South, East, West and Center
Components are added to the specified region
If any region not filled, the filled regions will occupy the space but the center region
will still appear as background if it contains no component.
Only one component can be added into each region.
Example Code:
// File BorderLayoutTest.
java import java.awt.*;
import javax.swing.*;
public class BorderLayoutTest {
JFrame myFrame ;
JButton b1, b2, b3, b4, b5;
//method used for setting layout of GUI
public void initGUI ( ) {
myFrame = new JFrame(Border Layout);
Container c = myFrame.getContentPane();
c.setLayout( new BorderLayout( ) );
b1 = new JButton(Next Slide);
b2 = new JButton(Previous Slide);
b3 = new JButton(Back to Start);
b4 = new JButton(Last Slide);
b5 = new JButton(Exit);
c.add( b1 , BorderLayout.NORTH );
c.add( b2 , BorderLayout.SOUTH );
c.add( b3 , BorderLayout.EAST );
c.add( b4 , BorderLayout.WEST );
c.add( b5 , BorderLayout.CENTER);
myFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
myFrame.setSize(300,150);
myFrame.setVisible(true);
} //end initGUI method
public BorderLayoutTest () { // default constructor
initGUI ();
CopyrightVirtualUniversityofPakistan
Page98
WebDesignandDevelopment(CS506)
}
public static void main (String args[ ]) {
BorderLayoutTest glTest = new BorderLayoutTest();
}
} // end of class
Points to Remember
Revisit the code of adding components, we specify the region in which we want
to add component or otherwise they will not be visible.
Consider the following segment of code: BorderLayout.NORTH, as you
guessed correctly NORTH is a constant (final) defined in BorderLayout class
public access modifier. Similarly the other ones are defined. Now you understand
why so much emphasis has been made on following the naming conventions.
Output:
MyCalculator
CopyrightVirtualUniversityofPakistan
Page99
WebDesignandDevelopment(CS506)
BorderLayout
NextSlide
LastSlide
Exit
BacktoStart
PreviousSlide
This GUI has 16 different buttons each of same size and text field on the top and a label my
calculator on the bottom.
So, how we can make this GUI? If Border Layout is selected, it has five regions (each region can
have at most one component) but here we have more than five components to add. Lets try Grid
Layout, but all the components in a Grid have same size and the text field at the top and label at
the bottom has different size. Flow Layout cannot be selected because if we stretch our GUI it will
destroy its shape.
Can we make this GUI? Yes, we can. Making of such GUI is a bit tricky business but General
Purpose Containers are there to provide the solution.
10.10.1 JPanel
It is general purpose container (cant exist alone, it has to be in some toplevel container)
in which we can put in different components (JButton , JTextField etc even other JPanels)
JPanel has its own layout that can be set while creating JPanel instance
JPanel myPanel = new JPanel ( new FlowLayout( ) );
Add components by using add method like shown below.
myPanel.add (button);
Must be added to a top level container (like JFrame etc) in order to be visible as
they (general purpose containers) cant exist alone.
CopyrightVirtualUniversityofPakistan
Page100
WebDesignandDevelopment(CS506)
10.10.2 Solution
To make the calculator GUI shown above, take JFrame (top level container) and set its layout to
border. Then take JPanel (general purpose container) and set its layout to Grid with 4 rows and 4
columns.
Add buttons to JPanel as they all have equal size and JPanel layout has been set to
GridLayout. Afterthat, add text field to the north region, label to the south region and
panel to the center region of the JFrames container. The east and west regions are left
blank and the center region will be stretched to cover up these. So, thats how we can build our
calculator GUI.
Code for Calculator GUI
// File CalculatorGUI.java
import java.awt.*;
import javax.swing.*;
public class CalculatorGUI {
JFrame fCalc;
JButton b1, b2, b3, b4, b5, b6, b7, b8, b9, b0;
JButton bPlus, bMinus, bMul, bPoint, bEqual, bClear;
JPanel pButtons;
JTextField tfAnswer;
JLabel lMyCalc;
//method used for setting layout of GUI
public void initGUI ( ) {
fCalc = new JFrame();
b0 = new JButton("0");
b1 = new JButton("1");
b2 = new JButton("2");
b3 = new JButton("3");
b4 = new JButton("4");
b5 = new JButton("5");
b6 = new JButton("6");
b7 = new JButton("7");
b8 = new JButton("8");
b9 = new JButton("9");
bPlus = new JButton("+");
bMinus = new JButton("-");
bMul = new JButton("*");
bPoint = new JButton(".");
bEqual = new JButton("=");
bClear = new JButton("C");
tfAnswer = new JTextField();
lMyCalc = new JLabel("My Clacualator");
//creating panel object and setting its layout
CopyrightVirtualUniversityofPakistan
Page101
WebDesignandDevelopment(CS506)
pButtons = new JPanel (new GridLayout(4,4));
//adding components (buttons) to panel
pButtons.add(b1);
pButtons.add(b2);
pButtons.add(b3);
pButtons.add(bClear);
pButtons.add(b4);
pButtons.add(b5);
pButtons.add(b6);
pButtons.add(bMul);
pButtons.add(b7);
pButtons.add(b8);
pButtons.add(b9);
pButtons.add(bMinus);
pButtons.add(b0);
pButtons.add(bPoint);
pButtons.add(bPlus);
pButtons.add(bEqual);
// getting componenet area of JFrame
Container con = fCalc.getContentPane();
con.setLayout(new BorderLayout());
//adding components to container
con.add(tfAnswer, BorderLayout.NORTH);
con.add(lMyCalc, BorderLayout.SOUTH);
con.add(pButtons, BorderLayout.CENTER);
fCalc.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
fCalc.setSize(300, 300);
fCalc.setVisible(true);
} //end initGUI method
public CalculatorGUI () {
// default constructor
initGUI ();
}
public static void main (String args[ ]) {
CalculatorGUI calGUI = new CalculatorGUI ();
}
} // end of class
10.11 Reference:
Sun java tutorial: http://java.sun.com/docs/books/tutorial/java
Thinking in java by Bruce Eckle
Beginning Java2 by Ivor Hortan
Java A Lab Course by Umair Javed
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page102
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page103
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page104
WebDesignandDevelopment(CS506)
11.3 Event Handling Process
CopyrightVirtualUniversityofPakistan
Page105
WebDesignandDevelopment(CS506)
Some Example Listeners, the way they are defined in JDK by Sun
public interface ActionListener {
public void actionPerformed(ActionEvent e);
}
public interface ItemListener {
public void itemStateChanged(ItemEvent e);
}
public interface ComponentListener {
public void componentHidden(ComponentEvent e);
public void componentMoved(ComponentEvent e);
public void componentResized(ComponentEvent e);
public void componentShown(ComponentEvent e);
}
o By implementing an interface the class agrees to implement all the methods that
are present in that interface. Implementing an interface is like signing a contract.
o Inside the method the class can do whatever it wants to do with that event
o Event Generator and Event Handler can be the same or different classes
o To handle events generated by Button. A class needs to implement
ActionListener interface and thus needs to provide the definition of
actionPerformed()method which is present in this interface.
public class Test implements ActionListener{
CopyrightVirtualUniversityofPakistan
Page106
WebDesignandDevelopment(CS506)
public void actionPerformed(ActionEvent ae) {
// do something
}
}
11.3.3 Step 3: Registering Handler with Generator
The event generator is told about the object which can handle its events
Event Generators have a method
o addXXXListener(_reference to the object of Handler class_)
For example, if b1 is JButtonthen
o
Hello
Message
Helloispressed
OK
CopyrightVirtualUniversityofPakistan
Page107
WebDesignandDevelopment(CS506)
We will take the simplest approach of creating handler and generator in a single class. Button is
our event generator and to handle that event our class needs to implement ActionListener
Interface and to override its actionPerformedmethod and in last to do the registration.
1. import java.awt.*;
2. import javax.swing.*;
3. import java.awt.event.*;
/* Implementing the interface according to the type of the event, i.e. creating event handler (first part
of step 2 of our process)
*/
4. public class ActionEventTest implements ActionListener{
5. JFrame frame;
6. JButton hello;
// setting layout components
7. public void initGUI ( ) {
8. frame = new JFrame();
9. Container cont = frame.getContentPane();
10. cont.setLayout(new FlowLayout());
//Creating event generator step-1 of our process
11. hello = new JButton("Hello");
/* Registering event handler with event generator. Since event handler is in same object that contains
button, we have used this to pass the reference.(step 3 of the process) */
12. hello.addActionListener(this);
13. cont.add(hello);
14. frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
15. frame.setSize(150, 150);
16. frame.setVisible(true);
17. }
//constructor
18. public ActionEventTest ( ) {
19. initGUI();
20. }
/* Override actionPerformed method of ActionListeners interfacemethod of which will be called
when event takes place (second part of step 2 of our process) */
21.
public void actionPerformed(ActionEvent event) {
22. JOptionPane.showMessageDialog(null,"Hello is pressed");
23. }
24.
public static void main(String args[]) {
25. ActionEventTest aeTest = new ActionEventTest();
26. }
27.} // end class
CopyrightVirtualUniversityofPakistan
Page108
WebDesignandDevelopment(CS506)
11.4 How Event Handling Participants Interact Behind the Scenes?
We have already seen that what a programmer needs to do handle events. Lets see what takes
place behind the scenes, i.e How JVM handles event. Before doing that lets revisit different
participants of Event Handling Process and briefly what they do.
Encapsulate information about event that occurred and the source of that event
For example, if you click a button, ActionEvent object is created
11.4.4 JVM
CopyrightVirtualUniversityofPakistan
Page109
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page110
WebDesignandDevelopment(CS506)
FirstOperand
FirstOperand
6
SecondOperand
SecondOperand
3
+
+
Answer
Answer
9
18
Page111
WebDesignandDevelopment(CS506)
26. cont.add(secondOperand);
27. cont.add(op2);
28. cont.add(plus);
29. cont.add(mul);
30. cont.add(answer);
31. cont.add(ans);
32. plus.addActionListener(this);
33. mul.addActionListener(this);
34. frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
35. frame.setSize(200, 220);
36. frame.setVisible(true);
37. }
38. //constructor
39. public SmallCalcApp ( ) {
40. initGUI();
41. }
42. public void actionPerformed(ActionEvent event) {
43. String oper, result;
44. int num1, num2, res;
/* All the information regarding an event is contained inside the event object. Here we are calling the
getSource() method on the event object to figure out the button that has generated that event.
*/
45. if (event.getSource() == plus) {
46. oper = op1.getText();
47. num1 = Integer.parseInt(oper);
48. oper = op2.getText();
49. num2 = Integer.parseInt (oper);
50. res = num1+num2;
51. result = res+"";
52. ans.setText(result);
53. }
54. else if (event.getSource() == mul) {
55. oper = op1.getText();
56. num1 = Integer.parseInt(oper);
57. oper = op2.getText();
58. num2 = Integer.parseInt (oper);
59. res = num1*num2;
60. result = res+"";
61. ans.setText(result);
62. }
63.
}
64. public static void main(String args[]) {
65. SmallCalcApp scApp = new SmallCalcApp();
66. }
67. }// end class
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page112
WebDesignandDevelopment(CS506)
Lecture 12: More Examples of Handling Events
MouseMotionListener
MouseListener
The class that wants to handle mouse event needs to implement the corresponding interface
and needs to provide the definition of all the methods in that interface.
Pressed
Released
Clicked (pressed & released without moving the cursor)
Enter (mouse cursor enters the bounds of component)
Exit (mouse cursor leaves the bounds of component)
Page113
WebDesignandDevelopment(CS506)
public void mouseClicked (MouseEvent me);
public void mouseReleased (MouseEvent me);
public void mouseEntered (MouseEvent me);
public void mouseExited (MouseEvent me);
}
Page114
WebDesignandDevelopment(CS506)
32. int y = me.getY();
33. coordinates.setText("Moved at [" + x + "," + y + "]");
34. }
35.
public static void main(String args[]) {
36. EventsEx ex = new EventsEx();
37. }
38. } // end class
Another Example: Handling Window Events
Task
We want to handle Window Exit event only
Why?
But, what if we want to display some message (Good Bye) before exiting?
Message
Message
Movedat(192,33)
Whenuserclosethe
window,Message
wouldbedisplayed
GoodBye
OK
AfterpressingOkbuttonprogramwillexit
How?
CopyrightVirtualUniversityofPakistan
Page115
WebDesignandDevelopment(CS506)
But, We have to provide definitions of all methods to make our class a concrete class
WindowListener interface is defined in the JDK as follows
public interface WindowListener {
public void windowActivated(WindowEvent we); public void
windowClosed(WindowEvent we); public void
windowClosing(WindowEvent we); public void
windowDeactivated(WindowEvent we); public void
windowDeiconified(WindowEvent we); public void
windowIconified(WindowEvent we); public void
windowOpened(WindowEvent we);
}
Page116
WebDesignandDevelopment(CS506)
19. initGUI();
20. }
// MouseMotionListener event hadler handling dragging
21. public void mouseDragged (MouseEvent me) {
22. int x = me.getX();
23. int y = me.getY();
24. coordinates.setText("Dragged at [" + x + "," + y + "]");
25. }
// MouseMotionListener event handler handling motion
26. public void mouseMoved (MouseEvent me) {
27. int x = me.getX();
28. int y = me.getY();
29.
30. coordinates.setText("Moved at [" + x + "," + y + "]");
31. }
// window listener event handler
32. public void windowActivated (WindowEvent we) {
33. public void windowClosed (WindowEvent we) {
34. public void windowClosing (WindowEvent we) {
35. JOptionPane.showMessageDialog(null, Good Bye);
36. System.exit(0);
37. }
38. public void windowDeactivated (WindowEvent we) {
39. public void windowDeiconified (WindowEvent we) {
40. public void windowIconified (WindowEvent we) {
41. public void windowOpened (WindowEvent we) {
42. public static void main(String args[]) {
43. EventsEx ex = new EventsEx();
44. }
45. } // end class
}
}
}
}
}
}
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page117
WebDesignandDevelopment(CS506)
Lecture 13: Adapter Classes
Problem in Last Code Example
Problem
Solution
For listener interfaces containing more than one event handling methods, jdk defines
adapter classes. Examples are
o For WindowListener WindowAdapter
o For MouseMotionListener MouseMotionAdapter
o and many more
Adapter classes provide definitions for all the methods (empty bodies) of their
corresponding Listener interface
It means that WindowAdapter class implements WindowListener interface and
provide the definition of all methods inside that Listener interface
Consider the following example of MouseMotionAdapter and its corresponding
MouseMotionListener interface
public interface MouseMotionListener {
public void mouseDragged (MouseEvent me);
public void mouseMoved (MouseEvent me); }
public class MouseMotionAdapter implements MouseMotionListener{
public void mouseDragged (MouseEvent me) {
}
public void mouseMoved (MouseEvent me) {
}
}
13.2 Available Adapter classes
CopyrightVirtualUniversityofPakistan
Page118
WebDesignandDevelopment(CS506)
Listener
Adapter Class
Registration Method
(If Any)
ActionListener
addActionListener
AdjustmentListener
addAdjustmentListener
ComponentListener
ComponentAdapter
addComponentListener
ContainerListener
ContainerAdapter
addContainerListener
FocusListener
FocusAdapter
addFocusListener
ItemListener
addItemListener
KeyListener
KeyAdapter
addKeyListener
MouseListener
MouseAdapter
addMouseListener
addTextListener
WindowAdapter
addWindowListener
Page119
WebDesignandDevelopment(CS506)
2. import javax.swing.*;
3. import java.awt.event.*;
4. public class EventsEx extends WindowAdapter {
5. JFrame frame;
6. JLabel coordinates;
// setting layout
7. public void initGUI ( ) {
// creating event generator
8. frame = new JFrame();
9. Container cont = frame.getContentPane();
10. cont.setLayout(new BorderLayout( ) );
11. coordinates = new JLabel ();
12. cont.add(coordinates, BorderLayout.NORTH);
// registering window handler with generator
13. frame.addWindowListener(this);
14. frame.setSize(350, 350);
15. frame.setVisible(true);
16. } // end initGUI method
//default constructor
17. public EventsEx ( ) {
18. initGUI();
19. }
//
As you can see that we have only implemented
//
our required method
20. public void windowClosing (WindowEvent we) {
21. JOptionPane.showMessageDialog(null, Good Bye);
22. System.exit(0);
23. }
24. public static void main(String args[]) {
25. EventsEx ex = new EventsEx();
26. }
27. } // end class
Problem in Last Code Example
Problem
Solution
CopyrightVirtualUniversityofPakistan
Page120
WebDesignandDevelopment(CS506)
Handlerclass:
Innerclass
Containseventhandlingcode
tfisaccessablehere
import java.awt.*;
import javax.swing.*;
import java.awt.event.*;
public class EventEx {
5. JFrame frame;
6. JLabel coordinates;
7. // setting layout
8. public void initGUI ( ) {
9. frame = new JFrame();
10. Container cont =frame.getContentPane();
11. cont.setLayout(new BorderLayout( ));
12. coordinates = new JLabel ();
CopyrightVirtualUniversityofPakistan
Page121
WebDesignandDevelopment(CS506)
13. cont.add(coordinates, BorderLayout.NORTH);
/* Creating an object of the class which is handling our
window events and registering it with generator
*/
14. WindowHandler handler = new WindowHandler ();
15. frame.addWindowListener(handler);
16. frame.setSize(350, 350);
17. frame.setVisible(true);
18. } // end initGUI
//default constructor
19. public EventEx ( ) {
20. initGUI();
21. }
/* Inner class implementation of window adapter. Outer
class is free to inherit from any other class. */
22. private class WindowHandler extends WindowAdapter {
// Event Handler for WindowListener
23. public void windowClosing (WindowEvent we) {
24. JOptionPane.showMessageDialog(null, Good Bye);
25. System.exit(0);
26. }
27. } // end of WindowHandler class
28. public static void main(String args[]) {
29. EventEx e = new EventEx();
30. }
31. } // end class
Example Code 13.3: Handling Window and Mouse Events with Inner
Class
Here we are modifying the window event code of the last example to handle window and
mouse events using inner classes. The diagram given below summarizes the approach.
CopyrightVirtualUniversityofPakistan
Page122
WebDesignandDevelopment(CS506)
Innerclass
handlingMouse
Events
Outerclassfor
GUIandother
code
Innerclasshandling
window
1.
import java.awt.*;
2.
import javax.swing.*;
3.
import java.awt.event.*;
4.
public class EventEx {
5. JFrame frame;
6. JLabel coordinates;
7. // setting layout
8. public void initGUI ( )
{
9. frame = new JFrame();
10. Container cont =frame.getContentPane();
11. cont.setLayout(new BorderLayout( ) );
12. coordinates = new JLabel ();
13. cont.add(coordinates, BorderLayout.NORTH);
/* Creating an object of the class which is handling our window events and registering it with
generator */
14. WindowHandler whandler = new WindowHandler ();
15. frame.addWindowListener(whandler);
/* Creating an object of the class which is handling our MouseMotion events & registering it with
generator */
16. MouseHandler mhandler = new MouseHandler ();
17. frame.addMouseMotionListener(mhandler);
18. frame.setSize(350, 350);
19. frame.setVisible(true);
CopyrightVirtualUniversityofPakistan
Page123
WebDesignandDevelopment(CS506)
20. }
//default constructor
21. public EventEx ( ) {
22. initGUI();
23. }
/* Inner class implementation of WindowAdapter. Outer class
is free to inherit from any other class. */
24. private class WindowHandler extends WindowAdapter {
// Event Handler for WindowListener
25. public void windowClosing (WindowEvent we) {
26. JOptionPane.showMessageDialog(null, Good Bye);
27. System.exit(0);
28. }
29. } // end of WindowHandler
//Inner class implementation of MouseMotionAdapter
30. private class MouseHandler extends MouseMotionAdapter {
// Event Handler for mouse motion events
31. public void mouseMoved (MouseEvent me) {
32. int x = me.getX();
33. int y = me.getY();
34. coordinates.setText(Moved at [" + x + "," + y + "] );
35. }
36. } // end of MouseHandler
37. public static void main(String args[]) {
38. EventEx e = new EventEx();
39. }
40. } // end clas
Example Code: Making Small Calculator using Inner classes
User enters numbers in the provided fields
On pressing + button, sum would be displayed in the answer field
On pressing * button, product would be displayed in the answer field
CopyrightVirtualUniversityofPakistan
Page124
WebDesignandDevelopment(CS506)
FirstOperand
FirstOperand
6
SecondOperand
Second Operand
3
+
*
Answer
*
Answer
18
1. import java.awt.*;
2. import javax.swing.*;
3. import java.awt.event.*;
4. public class SmallCalcApp{
5. JFrame frame;
6. JLabel firstOperand, secondOperand, answer;
7. JTextField op1, op2, ans;
8. JButton plus, mul;
9. // setting layout
10. public void initGUI ( ) {
11. frame = new JFrame();
12. firstOperand
= new JLabel("First Operand");
13. secondOperand = new JLabel("Second Operand");
14. answer
= new JLabel("Answer");
15. op1 = new JTextField (15);
16. op2 = new JTextField (15);
17. ans = new JTextField (15);
18. plus = new JButton("+");
19. plus.setPreferredSize(new Dimension(70,25));
20. mul = new JButton("*");
21. mul.setPreferredSize(new Dimension(70,25));
22. Container cont = frame.getContentPane();
23. cont.setLayout(new FlowLayout());
CopyrightVirtualUniversityofPakistan
Page125
WebDesignandDevelopment(CS506)
24. cont.add(firstOperand);
25. cont.add(op1);
26. cont.add(secondOperand);
27. cont.add(op2);
28. cont.add(plus);
29. cont.add(mul);
30. cont.add(answer);
31. cont.add(ans);
/* Creating an object of the class which is handling
button events & registering it with generators */
32. ButtonHandler bHandler = new ButtonHandler();
33. plus.addActionListener(bHandler);
34. mul.addActionListener(bHandler);
35. frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
36. frame.setSize(200, 220);
37. frame.setVisible(true);
38. }
39. //constructor
40. public SmallCalcApp ( ) {
41. initGUI();
42. }
//Inner class implementation of ActionListener
43. private class ButtonHandler implements ActionListener{
44. public void actionPerformed(ActionEvent event) {
45. String oper, result;
46. int num1, num2, res;
47. if (event.getSource() == plus) {
48. oper = op1.getText();
49. num1 = Integer.parseInt(oper);
50. oper = op2.getText();
51. num2 = Integer.parseInt (oper);
52. res = num1+num2;
53. result = res+"";
54. ans.setText(result);
55 }
56. else if (event.getSource() == mul) {
57. oper = op1.getText();
58. num1 = Integer.parseInt(oper);
59. oper = op2.getText();
60. num2 = Integer.parseInt (oper);
61. res = num1*num2;
62. result = res+"";
63. ans.setText(result);
64 }
65. } // end actionPerformed method
66. } // end inner class ButtonHandler
CopyrightVirtualUniversityofPakistan
Page126
WebDesignandDevelopment(CS506)
67. public static void main(String args[]) {
68. SmallCalcApp scApp = new SmallCalcApp();
69. }
70. }// end class
13.4 Anonymous Inner Classes
has no name
same as inner class in capabilities
much shorter
Difficult to understand
Page127
WebDesignandDevelopment(CS506)
42. public void windowClosing (WindowEvent we) {
43. JOptionPane.showMessageDialog(null, Good Bye);
44. System.exit(0);
45. } // end window closing
46. } // end WindowAdapter
47. ); // end of addWindowListener
48. frame.setSize(350, 350);
49. frame.setVisible(true);
50. } // end initGUI method
//default constructor
51.
public EventsEx ( ) {
52. initGUI();
53. }
54.
public static void main(String args[]) {
55. EventsEx ex = new EventsEx();
56. }
57. } // end class
13.6 Summary of Approaches for Handling Events
By implementing Interfaces
By extending from Adapter classes
To implement the above two techniques we can use
Same class
o putting event handler & generator in one class
Separate class
o Outer class
Putting event handlers & generator in two different classes
o Inner classes
o Anonymous Inner classes
13.7 References
Java A Lab Course by Umair Javed
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page128
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page129
WebDesignandDevelopment(CS506)
Save the data base in some folder. (Your database will be saved as an .mdb file)
14.3.2 Setup System DSN
After creating database, you have to setup a system Data Source Name (DSN). DSN is a
name through which your system recognizes the underlying data source.
Select Start -> Settings -> Control Panel -> Administrative Tools -> Data Sources
(ODBC).
The ODBC Data Source Administrator window would be opened as shown below:
Select System DSN tab. (If you are unable to use System DSN tab due to security
restrictions on your machine, you can use the User DSN tab)
CopyrightVirtualUniversityofPakistan
Page130
WebDesignandDevelopment(CS506)
Press Add button and choose Microsoft Access Driver (*.mdb) from Create New Data
Source window and press Finish button as shown in diagram:
CopyrightVirtualUniversityofPakistan
Page131
WebDesignandDevelopment(CS506)
After that, ODBC Microsoft Access Setup window would be opened as shown in
following diagram:
Enter the Data Source Name personDSN and select the database by pressing
Select button. The browsing window would be opened, select the desired folder
that contains the database (The database .mdb file you have created in the first
step) Press Ok button.
Import the package java.sql.* that contains useful classes and interfaces to access
& work with database.
CopyrightVirtualUniversityofPakistan
Page132
WebDesignandDevelopment(CS506)
Page133
WebDesignandDevelopment(CS506)
o executeQuery(sql) method
Used for SQL SELECT queries.
Returns the ResultSET object that contains the results of the query and
can be used to access the query results.
String sql
= SELECT * from sometable;
ResultSet rs = stmt.executeQuery(sql);
o executeUpdate(sql) method
This method is used for executing an update statement like INSERT,
UPDATE or DELETE
Returns an Integer value representing the number of rows updated
String sql = INSERT INTO tablename +
(columnNames) Values (values) ;
int count = stmt.executeUpdate(sql);
The ResultSet provides various getXXX methods that takes a column index
or name and returns the data
The ResultSet maintains the data in the form tables (rows & columns)
First row has index 1, not 0.
The next method of ResultSet returns true or false depending upon
whether the next row is available (exist) or not and moves the cursor
Always remember to call next()method at-least once
To retrieve the data of the column of the current row you need to use the various getters
provided by the ResultSet.
For example, the following code snippet will iterate over the whole
ResultSetand illustrates the usage of getters methods
while ( rs.next() ){
String name = rs.getString(columnName); //by using column name
String name = rs.getString(1); // or by using column index }
CopyrightVirtualUniversityofPakistan
Page134
WebDesignandDevelopment(CS506)
Page135
WebDesignandDevelopment(CS506)
Why? Because we are dealing with an external resource (database). If you can recall all IO
related operations involving external resources in java throw exceptions. These exceptions
are checked exceptions and we must need to handle these exceptions.
Compile & Execute
Since the Person table contains only three records, so the following output would be
produced on executing the above program.
C:\WINDOWS\system32\cmd.exe
14.5 References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page136
WebDesignandDevelopment(CS506)
15.1.1 executeUpdate( )
This program will take two command line arguments that are used to update records in the
database. executeUpdate( ) method will be used to achieve the purpose stated above.
// File JdbcDmlEx.java
//step 1:
import package import java.sql.*;
public class JdbcDmlEx {
public static void main (String args[ ]) {
try {
//Step 2: load driver
Class.forName(sun.jdbc.odbc.JdbcOdbcDriver);
//Step 3: define the connection URL
CopyrightVirtualUniversityofPakistan
Page137
WebDesignandDevelopment(CS506)
String url = jdbc:odbc:personDSN;
//Step 4: establish the connection
Connection con = DriverManager.getConnection(url);
//Step 5: create Statement
Statement st = con.createStatement();
// assigning first command line argument value
String addVar = args[0];
// assigning second command line argument value
String nameVar = args[1];
// preparing query - nameVar & addVar strings are embedded
// into query within + string +
String sql = UPDATE Person SET address = +addVar+ + WHERE
name = +nameVar+ ;
// executing query
int num = st.executeUpdate(sql);
// Step 7: process the results of the query
// printing number of records affected
System.out.println(num + records updated);
//Step 8: close the connection
con.close();
}catch(Exception sqlEx){
System.out.println(sqlEx);
} // end main
} // end class
Compile & Execute
The Person table is shown in the following diagram before execution of the program. We want to
update first row i.e. address of the person ali.
Page138
WebDesignandDevelopment(CS506)
C:\WINDOWS\system32\cmd.exe
The Person table is shown in the following diagram after the execution of the
program. Notice that address of the ali is now changed to defence.
Note
When we execute DML statements (insert, update, delete) we have to commit it in the
database explicitly to make the changes permanent or otherwise we can rollback the
previously executed statements.
But in the above code, you have never seen such a statement. This is due to the fact that java will
implicitly commit the changes. However, we can change this java behavior to manual commit.
We will cover these in some later handout.
Retrieves the number of seconds the driver will wait for a Statement object to
execute.
The current query time out limit in seconds, zero means there is no limit
CopyrightVirtualUniversityofPakistan
Page139
WebDesignandDevelopment(CS506)
As we have discussed in the previous handout that through Statement objects, SQL
queries are sent to the databases.
Three types of Statementobjects are available. These are:
15.2.1 Statement
15.2.2 PreparedStatement
The PreparedStatement are used for executing precompiled SQL statements and passing in
different parameters to it.
We will talk about it in detail shortly.
15.2.3 CallableStatement
What if we want to execute same query multiple times by only changing parameters.
PreparedStatement object differs from Statement object as that it is used to create a
statement in standard form that is sent to database for compilation, before actually
being used.
Each time you use it, you simply replace some of the marked parameters (?) using
some setter methods.
We can create PreparedStatement object by using prepareStatement method of the
connection class. The SQL query is passed to this method as an argument as
shown below.
PreparedStatement pStmt = con.prepareStatement (
UPDATE tableName SET columnName =
? + WHERE columnName = ? );
Notices that we used marked parameters (?) in query. We will replace them later on
CopyrightVirtualUniversityofPakistan
Page140
WebDesignandDevelopment(CS506)
Page141
WebDesignandDevelopment(CS506)
// assigning second command line argument value
String nameVar = args[1];
// setting first marked parameter (?) by using setString()
// method to address.
pStmt.setString(1 , addVar);
// setting second marked parameter(?) by using setString()
// method to name
pStmt.setString(2 , nameVar);
// suppose address is defence & name is ali
// by setting both marked parameters, the query will look
// like:
//
sql = UPDATE Person SET address = defence
//
WHERE name = ali
// executing update statemnt
int num = pStmt.executeUpdate();
// Step 7: process the results of the query
// printing number of records affected
System.out.println(num + records updated);
//Step 8: close the connection
con.close();
}catch(Exception sqlEx){
System.out.println(sqlEx);
}
} // end main
} // end class
Compile & Execute
Execute this code in a similar way as we showed you in execution of the last program. Dont
forget to pass the address & name values as the command line arguments.
15.3 References:
Entire material for this handout is taken from the book JAVA A Lab Course by Umair
Javed. This material is available just for the use of VU students of the course Web
Design and Development and not for any other commercial purpose without the consent
of author.
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page142
WebDesignandDevelopment(CS506)
Lecture 16: Result Set
This handout will familiarize you with another technique of inserting, updating & deleting
rows. Before moving on, first we look at ResultSet.
16.1 ResultSet
A default ResultSet object is not updatable and has a cursor that moves
forward only.
You can iterate over through it only once and only from the first row to last row.
Until now, we have worked & used it in various examples.
For a quick overview, here how we create a default ResultSet object.
String sql = SELECT * FROM Person; PreparedStatement pStmt =
con.prepareStatement(sql); ResultSet rs = pStmt.executeQuery( );
16.1.2 Useful ResultSets Methods
Following methods are used often to work with default ResultSetobject. We already seen and
used some of them in code examples.
CopyrightVirtualUniversityofPakistan
Page143
WebDesignandDevelopment(CS506)
16.1.2.1 next( )
16.1.2.2 getters
To retrieve the data of the column of the current row you need to use the various getters
provided by the ResultSet
These getters return the value from the column by specifying column name or column index.
For example, if the column name is Name and this column has index 3 in the ResultSet
object, then we can retrieve the values by using one of the following methods:
String name = rs.getString(Name);
String name = rs.getString(3);
These getter methods are also available for other types like getInt(
), getDouble( ) etc.
Consult the Java API documentation for more references.
Note: Remember that first column has an index 1, NOT zero (0).
16.1.2.3 close( )
It is possible to produce ResultSet objects that are scrollable and/or updatable (since JDK
1.2)
With the help of such ResultSet, it is possible to move forward as well as backward with in
ResultSet object.
Another advantage is, rows can be inserted, updated or deleted by using updatable
ResultSet object.
Page144
WebDesignandDevelopment(CS506)
String sql = SELECT * FROM Person; PreparedStatement pStmt =
con.prepareStatement(sql, ResultSet.TYPE_SCROLL_INSENSITIVE,
ResultSet.CONCUR_UPDATABLE);
ResultSet rs = pStmt.executeQuery( );
Two constants have been used of ResultSet class for producing a ResultSet rs that is
scrollable, will not show changes made by others and will be updatable
16.1.2.6 previous( )
Moves the cursor to the previous row in the ResultSet object, if available
Returns true if cursor is on a valid row, false it is off the result set.
Throws exception if result type is TYPE_FORWARD_ONLY.
Example Code 16.1: Use of previous ( ), next( ) & various getters methods
The ResultSetEx.javashows the use of previous, next and getters methods. We are using the
same Persontable of PersonInfo database, the one we had created earlier in this example and
later on.
1. // File ResultSetEx.java
2. import java.sql.*;
3. public class ResultSetEx {
4. public static void main (String args[ ]) {
5. try {
6. //Step 2: load driver
7. Class.forName(sun.jdbc.odbc.JdbcOdbcDriver);
8. //Step 3: define the connection URL
9. String url = jdbc:odbc:personDSN;
10. //Step 4: establish the connection
11. Connection con = DriverManager.getConnection(url);
12.//Step 5: creating PrepareStatement by passing sql and
13.//ResultSets constants so that the ResultSet that will
14.//produce as a result of executing query will be
15.//scrollable & updatable
16.String sql = SELECT * FROM Person;
17.PreparedStatement pStmt = con.prepareStatement(sql, ResultSet.TYPE_SCROLL_INSENSITIVE,
ResultSet.CONCUR_UPDATABLE);
20 //Step 6: execute the query
21 ResultSet rs = pStmt.executeQuery();
22 // moving cursor forward i.e. first row
23 rs.next( );
24 // printing column name value of current row (first)
CopyrightVirtualUniversityofPakistan
Page145
WebDesignandDevelopment(CS506)
25 System.out.println(moving cursor forward);
26 String name = rs.getString(Name);
27 System.out.println(name);
28 // moving cursor forward i.e. on to second row
29 rs.next( );
30 // moving cursor backward i.e to first row
31 rs.previous( );
32.// printing column name value of current row (first)
33.System.out.println(moving cursor forward);
34.name = rs.getString(Name);
35.System.out.println(name);
36.//Step 8: close the connection
37.con.close();
38.}catch(Exception sqlEx){
39.System.out.println(sqlEx);
40.}
41.} // end main
42.} // end class
16.1.2.7 absolute(int)
Moves the cursor to the given row number in the ResultSet object.
If given row number is positive, moves the cursor forward with respect to beginning of the
result set.
If the given row number is negative, the cursor moves to the absolute row position with
respect to the end of the result set.
For example, calling absolute(-1) positions the cursor on the last row; calling absolute(-2)
moves the cursor to next-to-last row, and so on.
Throws Exception if ResultSet type is TYPE_FORWARD_ONLY
CopyrightVirtualUniversityofPakistan
Page146
WebDesignandDevelopment(CS506)
16.1.2.8 updaters (for primitives, String and Object)
Used to update the column values in the current row or in insert row (discuss later)
Do not update the underlying database
Each update method is overloaded; one that takes column name while other takes column
index. For example String updater are available as:
updateString(String columnName, String value)
updateString(String columnIndex, String value)
16.1.2.9 updateRow( )
Updates the underlying database with new contents of the current row of this ResultSet
object
Page147
WebDesignandDevelopment(CS506)
22.// update address column of 2nd row in rs
23.rs.updateString(Address, model town);
24.// update the row in database
25.rs.updateRow( );
26.//Step 8: close the connection
27.con.close();
28.}catch(Exception sqlEx){
29.System.out.println(sqlEx);
30.}
31.} // end main
32.} // end class
16.1.2.10moveToInsertRow(int)
CopyrightVirtualUniversityofPakistan
Page148
WebDesignandDevelopment(CS506)
An updatable resultset object has a special row associate with it i.e. insert row
Insert row - a buffer, where a new row may be constructed by calling updater methods.
Doesnt insert the row into a result set or into a database.
For example, initially cursor is positioned on the first row as shown in the diagram:
CopyrightVirtualUniversityofPakistan
Page149
WebDesignandDevelopment(CS506)
Now, by calling various updaters, we can insert values into the columns of insert row as
shown below.
16.1.2.11 insertRow( )
Inserts the contents of the current row into this ResultSet object and into the database too.
Moves the cursor back to the position where it was before calling
moveToInsertRow()
This is shown in the given below diagram
Note: The cursor must be on the insert row before calling this method or exception
would be raised.
Example Code 16. 3: Inserting new row
The following code example illustrates how to add/insert new row into the
ResultSet as well into the database.
This code is the modification of the last one. Changes made are shown in bold face.
1. // File ResultSetEx.java
CopyrightVirtualUniversityofPakistan
Page150
WebDesignandDevelopment(CS506)
2. import java.sql.*;
3. public class ResultSetEx {
4. public static void main (String args[ ]) {
5. try {
6. //Step 2: load driver
7. Class.forName(sun.jdbc.odbc.JdbcOdbcDriver);
8. //Step 3: define the connection URL
9. String url = jdbc:odbc:personDSN;
10.//Step 4: establish the connection
11.Connection con = DriverManager.getConnection(url);
12.//Step 5: create PrepareStatement by passing sql and
13.// ResultSet appropriate fields
14.String sql = SELECT * FROM Person;
15.PreparedStatement pStmt = con.prepareStatement(sql, ResultSet.TYPE_SCROLL_INSENSITIVE,
ResultSet.CONCUR_UPDATABLE);
18.//Step 6: execute the query
19.ResultSet rs = pStmt.executeQuery();
20.// moving cursor to insert row
21.rs.moveToInsertRow();
22.// updating values in insert row
23.rs.updateString( Name ,
imitiaz );
24.rs.updateString( Address ,
cantt );
25.rs.updateString( phoneNum ,
9201211 );
26.// inserting row in resultset & into database
27.rs.insertRow( );
28.//Step 8: close the connection
29.con.close();
30.}catch(Exception sqlEx){
31.System.out.println(sqlEx);
32.}
33.} // end main
34.} // end class
Compile & Execute
Given below are two states of Person table. Note that after executing program, a newly added row
is present.
CopyrightVirtualUniversityofPakistan
Page151
WebDesignandDevelopment(CS506)
16.1.2.14 deleteRow( )
Deletes the current row from this ResultSet object and from the underlying database.
Throws exception if the cursor is on the insert row.
), getRow( )and
Page152
WebDesignandDevelopment(CS506)
deleteRow( )method.
This code is also the modification of the last one. Changes made are shown in bold face.
1. // File ResultSetEx.java
2. import java.sql.*;
3. public class ResultSetEx {
4. public static void main (String args[ ]) {
5.
try {
6.
7.
8.
9.
10.
11.
12.
13.
14.
//
ResultSet appropriate fields
String sql = SELECT * FROM Person;
15.
16.
17.
ResultSet.TYPE_SCROLL_INSENSITIVE,
ResultSet.CONCUR_UPDATABLE);
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
CopyrightVirtualUniversityofPakistan
Page153
WebDesignandDevelopment(CS506)
32.
33.
34.
} // end main
} // end class
Page154
WebDesignandDevelopment(CS506)
16.2 References:
Entire material for this handout is taken from the book JAVA A Lab Course by Umair
Javed. This material is available just for the use of VU students of the course Web
Design and Development and not for any other commercial purpose without the consent
of author.
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page155
WebDesignandDevelopment(CS506)
Lecture 17: Meta Data
In simple terms, Meta Data is data (information) about data. The actual data has no meaning
without existence of Meta data. To clarify this, lets look at an example. Given below are listed
some numeric values
1000
2000
4000
What this information about? We cannot state accurately. These values might be
representing some ones salaries, price, tax payable & utility bill etc. But if we specify Meta data
about this data like shown below:
Salary
1000
2000
4000
Now, just casting a glance on these values, you can conclude that its all about some ones
salaries.
Page156
WebDesignandDevelopment(CS506)
Now, rsmd can be used to look up number, names & types of columns.
17.1.2.1 getColumnCount ( )
Returns the SQL type for the column to compare against types in java.sql.Types
Page157
WebDesignandDevelopment(CS506)
48. try {
49. //Step 2: load driver
50. Class.forName(sun.jdbc.odbc.JdbcOdbcDriver);
51. //Step 3: define the connection URL
52. String url = jdbc:odbc:personDSN;
53. //Step 4: establish the connection
54. Connection con = null;
55. con = DriverManager.getConnection(url, , );
56. //Step 5: create PrepareStatement by passing sql and
57. //
ResultSet appropriate fields
58. String sql =
SELECT * FROM Person;
59. PreparedStatement pStmt = con.prepareStatement(sql,
60. ResultSet.TYPE_SCROLL_INSENSITIVE,
61. ResultSet.CONCUR_UPDATABLE);
62. //Step 6: execute the query
63. ResultSet rs = pStmt.executeQuery();
64. // get ResultSetMetaData object from rs
65. ResultSetMetaData rsmd = rs.getMetaData( );
66. // printing no. of column contained by rs
67. int numColumns = rsmd.getColumnCount();
68. System.out.println(Number of Columns: + numColumns);
69. // printing all column names by using for loop
70. String cName;
71. for(int i=1; i<= numColumns; i++) {
72. cName = rsmd.getColumnName(i);
73. System.out.println(cName);
74. System.out.println(\t);
75. }
76. // changing line or printing an empty string
77. System.out.println( );
78. // printing all values of ResultSet by iterating over it
79. String id, name, add, ph;
80. while( rs.next() )
81. {
82. id= rs.getString(1);
83. name = rs.getString(2);
84. add= rs.getString(3);
85. ph= rs.getString(4);
86. System.out.println(id);
87. System.out.println(\t);
88. System.out.println(name);
89. System.out.println(\t);
90. System.out.println(add);
91. System.out.println(\t);
92. System.out.println(ph);
93. System.out.println( );
CopyrightVirtualUniversityofPakistan
Page158
WebDesignandDevelopment(CS506)
94. }
95. //Step 8: close the connection
96. con.close();
97. }catch(Exception sqlEx){
98. System.out.println(sqlEx); }
99. } // end main
100.} // end class
7.2 DatabaseMetaData
Database Meta Data will help you in answering such questions
CopyrightVirtualUniversityofPakistan
Page159
WebDesignandDevelopment(CS506)
17.2.2.2 getDatabaseProductVersion( )
17.2.2.3 getDriverName( )
Returns the name of the JDBC driver used to established the connection
17.2.2.4 isReadOnly( )
Page160
WebDesignandDevelopment(CS506)
108.
Class.forName(sun.jdbc.odbc.JdbcOdbcDriver);
109.
//Step 3: define the connection URL
110.
String url = jdbc:odbc:personDSN;
111.
//Step 4: establish the connection
112.
Connection con = null;
113.
con = DriverManager.getConnection(url, , );
114.
// getting DatabaseMetaDat object
115.
DatabaseMetaData dbMetaData = con.getMetaData();
116.
// printing database product name
117.
String pName = dbMetaData.getDatabaseProductName();
118.
System.out.println(DataBase: + pName);
119.
// printing database product version
120.
String pVer = dbMetaData.getDatabaseProductVersion();
121.
System.out.println(Version: + pVer);
122.
// printing driver name used to establish connection &
123.
// to retrieve data
124.
String dName = dbMetaData.getDriverName();
125.
System.out.println(Driver: + dName);
126.
// printing whether database is read-only or not
127.
boolean rOnly = dbMetaData.isReadOnly();
128.
System.out.println(Read-Only: + rOnly);
129.
// you can create & execute statements and can
130.
// process results over here if needed
131.
//Step 8: close the connection
132.
con.close();
133.
}catch(Exception sqlEx){
134.
System.out.println(sqlEx);
135.
}
136.
} // end main
137.} // end class
Compile & Execute
On executing the above program, the following output will produce:
C:\WINDOWS\system32\cmd.exe
CopyrightVirtualUniversityofPakistan
Page161
WebDesignandDevelopment(CS506)
17.3 JDBC Driver Types
JDBC Driver Types are divided into four types or levels.
Each type defines a JDBC driver implementation with increasingly higher level of
platform independence, performance, deployment and administration.
The four types are:
o Type - 1: JDBC - ODBC Bridge
o Type 2: Native - API/partly Java driver
o Type 3: Net - protocol/all-Java driver
o Type 4: Native - protocol/all-Java driver
Now, lets look at each type in more detail
17.3.1 Type - 1: JDBC - ODBC Bridge
Translates all JDBC calls into ODBC (Open Database Connectivity) calls and
send them to the ODBC Driver
Generally used for Microsoft database.
Performance is degraded
Converts JDBC calls into database-specific calls such as SQL Server, Informix,
Oracle or Sybase.
Partly-Java drivers communicate with database-specific API (which may be in
C/C++) using the Java Native Interface.
Significantly better Performance than the JDBC-ODBC bridge.
CopyrightVirtualUniversityofPakistan
Page162
WebDesignandDevelopment(CS506)
Converts JDBC calls into the vendor-specific DBMS protocol so that client
application can communicate directly with the database server
Completely implemented in Java to achieve platform independence and eliminate
deployment issues.
Performance is typically very good
CopyrightVirtualUniversityofPakistan
Page163
WebDesignandDevelopment(CS506)
17.5 References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page164
WebDesignandDevelopment(CS506)
Lecture 18: Java Graphics
18.1 Painting
Window is like a painters canvas. All window paints on the same surface. More
importantly, windows dont remember what is under them. There is a need to repaint when
portions are newly exposed.
Java components are also able to paint themselves. Most of time, painting is done
automatically. However sometimes you need to do drawing by yourself.
Anythingelseisprogrammer
responsibility
Form1
Javacomponentspaint
themselves
Command1
Form1
Command1
CopyrightVirtualUniversityofPakistan
Page165
WebDesignandDevelopment(CS506)
myApp consist of a JPanel. The JPanel contains a JButton. Two rectangles, a circle & a lines are
also drawn on the JPanel.fter opening notepad and windows explorer window, diagram will look
like this:
Lets shuts off the windows explorer, the repaint event is sent to desktop first and then to myApp.
The figure shown below describes the situation after desktop repaint event get executed. Here
you can clearly see that only desktop repaints itself and window explorer remaining part is still
opened in front of myApp.
CopyrightVirtualUniversityofPakistan
Page166
WebDesignandDevelopment(CS506)
The following figure shows the situation when myApps JPanel calls its repaint method. Notice
that some portion of window explorer is still remains in front of JButton because yet not repaint event
is sent to it.
CopyrightVirtualUniversityofPakistan
Page167
WebDesignandDevelopment(CS506)
Next, JPanel forwards repaint event to JButton that causes the button to be displayed in its
original form. This is all done automatically and we cannot feel this process cause of
stunning speed of modern computers that performs all these steps in flash of eye.
CopyrightVirtualUniversityofPakistan
Page168
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page169
WebDesignandDevelopment(CS506)
18.1.2.1 paintComponent( )
18.1.2.2 paintBorder( )
18.1.2.3 paintChildren( )
The figure above illustrates the order in which each component that inherits from
JComponent paint itself.
Figure 1 to 2 -painting the background and performing custom painting is performed by the
paintComponent method
In Figure 3 - paintBorder is get called
And finally in figure 4 - paintChildern is called that causes the JButton to render itself.
Note: The important thing to note here is for JButton (since it is a JComponent), all these methods
are also called in the same order.
Your Painting Strategy
CopyrightVirtualUniversityofPakistan
Page170
WebDesignandDevelopment(CS506)
Subclass JPanel
When frame becomes visible through the paintChildren() method your panel become
visible
To become visible your panel will call paintComponent() method which will do your
custom drawing
HelloWorld
Page171
WebDesignandDevelopment(CS506)
// previous painting
super.paintComponent(g);
// Down casting Graphics object to Graphics2D
Graphics2D g2 = (Graphics2D)g;
// drawing rectanle
g2.drawRect(20,20,20,20);
// changing the color to blue
g2.setColor(Color.blue);
// drawing filled oval with color i.e. blue
g2.fillOval(50,50,20,20);
// drawing string
g2.drawString("Hello World", 120, 50);
}// end paintComponent
} // end Test class
The Test class that contains the main method as well uses MyPanel (previously built) class is given
below:
// importing required packages
import javax.swing.*;
import java.awt.*;
public class Test {
JFrame f;
// declaring Reference of MyPanel class
MyPanel p;
// parameter less constructor public Test(){
f = new JFrame();
Container c = f.getContentPane();
c.setLayout(new BorderLayout());
// instantiating reference
p = new MyPanel();
// adding MyPanel into container
c.add(p);
f.setSize(400,400);
f.setVisible(true);
f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
} // end constructor
// main method
CopyrightVirtualUniversityofPakistan
Page172
WebDesignandDevelopment(CS506)
public static void main(String args[ ]){
Test t = new Test();
}
} // end Test class
Note: Here we have used only some methods (drawRect( ) & fillOval( ) etc. ) of Graphics class.
For a complete list, see the Java API documentation.
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page173
WebDesignandDevelopment(CS506)
Lecture 19: How to Animate?
If we want to animate something like ball, moving from one place to another, we
constantly need to call paintComponent( ) method and to draw the shape (ball etc.) at new place
means at new coordinates.
Painting is managed by system, so calling paintComponent() directly is not recommended at all.
Similarly calling paint( ) method is also not recommended. Why? Because such code may be
invoked at times when it is not appropriate to paint -- for instance, before the component is
visible or has access to a valid Graphicsobject.
Java gives us a solution in the form of repaint( ) method. Whenever we need to repaint, we call
this method that in fact makes a call to paint( ) method at appropriate time.
19.1 Problem & Solution
What to do to move the shapes present in example code 18.1 (last example) when a mouse
is dragged
First time painting is what we already have done
When a mouse is clicked find the co-ordinates of that place and paint Rectangle at that
place by requesting, using repaint() call
Here instead of Hard-coding the position of co-ordinates uses some variables. For example
mx, my
o In the last example code, we draw a rectangle by passing hard-coded values like
20
g.drawRect(20,20,20,20);
o Now, well use variables so that change in a variable value causes to display a
rectangle at a new location
g.drawRect(mx,my,20,20);
Similarly, you have seen a tennis game (during lecture). Now, what to do code the paddle
movement.
In the coming up example. We are doing it using mouse, try it using mouse.
CopyrightVirtualUniversityofPakistan
Page174
WebDesignandDevelopment(CS506)
import javax.swing.*;
import java.awt.*;
// extending class from JPanel
public class MyPanel extends JPanel {
// variables used to draw rectangles at different locations
int mX = 20;
int mY = 20;
// overriding paintComponent method
public void paintComponent(Graphics g){
// erasing behaviour - this will clear all the previous painting
super.paintComponent(g);
// Down casting Graphics object to Graphics2D
Graphics2D g2 = (Graphics2D)g;
// changing the color to blue
g2.setColor(Color.blue);
// drawing filled oval with color i.e. blue
// using instance variables
g2.fillRect(mX,mY,20,20);
}// end paintComponent
CopyrightVirtualUniversityofPakistan
Page175
WebDesignandDevelopment(CS506)
} // end MyPanel class
The Test class is given below. Additionally this class also contains the code for handling mouse
events.
// importing required packages
import javax.swing.*;
import java.awt.*;
import java.awt.event.*;
public class Test {
JFrame f;
// declaring Reference of MyPanel class
MyPanel p;
// parameter less constructor
public Test(){
f = new JFrame();
Container c = f.getContentPane();
c.setLayout(new BorderLayout());
// instantiating reference
p = new MyPanel();
// adding MyPanel into container
c.add(p);
f.setSize(400,400);
f.setVisible(true);
f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
// creating inner class object
Handler h = new Handler();
// registering MyPanel to handle events
p.addMouseMotionListener(h);
} // end constructor
// inner class used for handling events
public class Handler extends MouseMotionAdapter{
// capturing mouse dagged events
public void mouseDragged(MouseEvent me){
// getting the X-Position of mouse and assigning
// value to instance variable mX of MyPanel class
p.mX =me.getX();
// getting the Y-Position of mouse and assigning
// value to instance variable mX of MyPanel class
p.mY = me.getY();
// call to repaint causes rectangle to be drawn on
// new location
CopyrightVirtualUniversityofPakistan
Page176
WebDesignandDevelopment(CS506)
p.repaint() ;
} // end mouseDragged
} // end Handler class
// main method
public static void main(String args[ ]){
Test t = new Test();
}
} // end MyPanel class
On executing this program, when you drag mouse from one location to another, rectangle
is also in sync with the movement of mouse. Notice that previously drawn rectangle is
erased first.
If we exclude or comment out the following line from MyPanel class
super.paintComponent(g);
Dragging a mouse will produce a similar kind of output shown next
CopyrightVirtualUniversityofPakistan
X
Page177
WebDesignandDevelopment(CS506)
Page178
WebDesignandDevelopment(CS506)
JFrame f;
MyPanel p;
// used to control the direction of ball int x, y;
public AnimTest(){
f = new JFrame();
Container c = f.getContentPane();
c.setLayout(new BorderLayout());
x = 5;
y = 3;
p = new MyPanel();
c.add(p);
f.setSize(400,400);
f.setVisible(true);
f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
// creating a Timer class object, used for firing
// one or more action events after a specified delay
// Timer class constructor requires time in
// milliseconds and object of class that handles
// action events
Timer t = new Timer (5, this);
// starts the timer, causing it to start sending
// action events to listeners
t.start();
} // end constructor
// event handler method
public void actionPerformed(ActionEvent ae){
// if ball reached to maximum width of frame minus
// 40 since diameter of ball is 40 then change the
// X-direction of ball
if (f.getWidth()-40 == p.mX)
x = -5;
// if ball reached to maximum height of frame
// minus 40 then change the Y-direction of ball
if (f.getHeight()-40 == p.mY)
y = -3;
// if ball reached to min. of width of frame,
// change the X-direction of ball
if (p.mX == 0 )
x = 5;
// if ball reached to min. of height of frame,
// change the Y-direction of ball
if (p.mY == 0 )
y = 3;
// Assign x,y direction to MyPanels mX & mY
p.mX += x;
CopyrightVirtualUniversityofPakistan
Page179
WebDesignandDevelopment(CS506)
p.mY += y;
// call to repaint() method so that ball is drawn on
// new locations
p.repaint();
} // end actionPerformed() method
// main method
public static void main(String args[ ]){
AnimTest at = new AnimTest();
}
} // end AnimTest class
19.2 References
CopyrightVirtualUniversityofPakistan
Page180
WebDesignandDevelopment(CS506)
Most modern browsers support Java 1.4 if they have the appropriate plugin
Sun provides an application appletviewer to view applets without using browser.
In general you should try to write applets that can be run with any browser
CopyrightVirtualUniversityofPakistan
Page181
WebDesignandDevelopment(CS506)
Example Code 20.1: Writing a Simple Applet
Below is the source code for an applet called HelloApplet. This displays a Hello World
string. Note that no main method has been provided.
// File HelloApplet.java
//step 1: importing required packages
import java.awt.*;
import javax.swing.*;
// extending class from JApplet so that our class also becomes an
//applet
public class HelloApplet extends JApplet {
// overriding paint method
public void paint(Graphics g) {
// write code here u want to display & draw by using
// Graphics object
g.drawString(Hello World, 30 , 30);
}
} // end class
After defining the HelloApplet.java, the next step is to write .html file. Below is the
source code of Test.html file. The Test.html contains the ordinary html code except one.
<html>
<head>
<title> Simple Applet </title> </head>
<body>
<!-- providing the class name of applet with width &
height
-->
<applet code="HelloApplet.class
width=150 height=100>
</applet>
</body>
</html>
Compile & Execute
By simply double clicking on Test.html file, you can view the applet in your browser.
However, you can also use the appletviewer java program for executing or running
applets.
CopyrightVirtualUniversityofPakistan
Page182
WebDesignandDevelopment(CS506)
The
applet
viewer
is
invoked
from
the
command
line
by
the
command
appletviewer htmlfile
where htmlfile is the name of the file that contains the html document. For our example, the
command looks like this:
appletviewer Test.html
As a result, you will see the following output
AppletVie
Applet
HelloWorld!
AppletStarted
The applets life cycle methods are called in the specific order shown below. Not every applet
needs to override every one of these methods.
CopyrightVirtualUniversityofPakistan
Page183
WebDesignandDevelopment(CS506)
Lets take a look on each method in detail and find out what they do:
20.5.1 init( )
20.5.2 start( )
20.5.3 paint( )
paint( ) is called for the first time when the applet becomes visible
Whenever applet needs to be repainted, paint( ) is called again
Do all your painting in paint( ), or in a method that is called from paint( )
CopyrightVirtualUniversityofPakistan
Page184
WebDesignandDevelopment(CS506)
20.5.4 stop( )
To stop the applet's execution, such as when the user leaves the applet's page or quits the
browser.
stop( ) is also called whenever the browser is minimized
20.5.5 destroy( )
Page185
WebDesignandDevelopment(CS506)
The DemoTest.html file is using this applet. The code snippet of it given below:
<html>
<head>
<title> Applet Life Cycle Methods </title> </head>
<body>
<!-- providing the class name of applet with width &
height
-->
<applet code="AppletDemo.class
width=150 height=100>
</applet>
</body>
</html>
Compile & Execute
To understand the calling sequence of applet life cycle methods, you have to execute it by using
appletviewer command. Do experiments like maximizing, minimizing the applet, bringing
another window in front of applet and keep an eye on console output.
Example Code 20.3: Animated Java Word
Sample Output
The browser output of the program is given below:
CopyrightVirtualUniversityofPakistan
Page186
WebDesignandDevelopment(CS506)
JavaJavajavajavajavajavajava
javajavajavajavajavajavajavajava
javajavajavajavajavajavajavajava
javajavajavajavajavajavajava
javajavajavajavajavajava
javajavajavajavajavajavajavajava
javajavajavajavajavajavajavajava
javajavajavajavajavajavajava
javajavajavajavajavajavajava
javajavajavajavajavajavajava
javajavajavajavajavajavajava
javajavajavajavajavajavajava
javajavajavajavajavajavajava
javajavajavajavajavajavajava
javajavajavajavajavajavajava
Design Process
The Program in a single call of paint method
o Draws string java on 40 random locations
o For every drawing, it selects random font out of 4 different fonts
o For every drawing, it selects random color out of 256 * 256 * 256 RGB colors
Repaint is called after every 1000 ms.
After 10 calls to repaint, screen is cleared
Generating Random Numbers
Math.random() ;
Returns positive double value greater than or equal to 0.0 or less than 1.0.
Multiply the number with appropriate scaling factor to increase the range and type cast it,
if needed.
o int i = (int)( Math.random() * 5 ); // will generate random numbers between 0 & 4.
Programs Modules
The program is build using many custom methods. Lets discuss each of them one
by one that will help in understanding the overall logic of the program.
CopyrightVirtualUniversityofPakistan
Page187
WebDesignandDevelopment(CS506)
drawJava( )
As name indicates, this method will be used to write String java on random
locations. The code is given below:
// method drawJava
public void drawJava(Graphics2D g2) {
// generate first number randomly. The panel width is 1000
int x = (int) (Math.random() * 1000);
// generate second number randomly. The panel height is 700
int y = (int) (Math.random() * 700);
// draw String on these randomly selected numbers
g2.drawString("java", x, y);
}
chooseColor( )
This method will choose color randomly out of 256 * 256 * 256 possible colors. The code
snippet is given below:
// method chooseColor
public Color chooseColor() {
// choosing red color value randomly
int r = (int) (Math.random() * 255);
// choosing green color value randomly
int g = (int) (Math.random() * 255);
// choosing blue color value randomly
int b = (int) (Math.random() * 255);
// constructing a color by providing R-G-B values
Color c = new Color(r, g, b);
// returning color
return c;
}
chooseFont( )
This method will choose a Font for text (java) to be displayed out of 4 available fonts. The code
snippet is given below:
// method chooseFont
public Font chooseFont() {
// generating a random value that helps in choosing a font
CopyrightVirtualUniversityofPakistan
Page188
WebDesignandDevelopment(CS506)
int fontChoice = (int) (Math.random() * 4) + 1;
// declaring font reference
Font f = null;
// using switch based logic for selecting font
switch (fontChoice) {
case 1:
f = new Font("Serif", Font.BOLD + Font.ITALIC, 20);
break;
case 2:
f = new Font("SansSerif", Font.PLAIN, 17);
break;
case 3:
f = new Font("Monospaced", Font.ITALIC, 23);
break;
case 4:
f = new Font("Dialog", Font.ITALIC, 30);
break;
} // end switch
// returns Font object
return f;
} //end chooseFont
paint( )
The last method to be discussed here is paint(). By overriding this method, we will print string
java on 40 random locations. For every drawing, it selects random font out of 4 different
fonts & random color out of 256 * 256 * 256 RGB colors.
Lets see, how it happens:
Page189
WebDesignandDevelopment(CS506)
Font f = chooseFont();
g2.setFont(f);
// drawing string java by calling drawJava() method
drawJava(g2);
}
// end for loop
Graphics2D g2 = (Graphics2D) g;
// checking if paint is called 10 times then clears the
// screen and set counter again to zero
if (clearCounter == 10) {
g2.clearRect(0, 0, 1000, 700);
clearCounter = 0;
}
} // end paint method
Merging Pieces
By inserting all method inside JavaAnim.java class, the program will look like one given below.
Notice that it contains methods discussed above with some extra code with which you are already
familiar.
// File JavaAnim.java
//step 1: importing required packages import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
public class JavaAnim extends JApplet implements ActionListener {
// used to count how many times paint is called int clearCounter;
// declaring Timer reference
Timer t;
// overriding init method, used to initialize variables
public void init() {
setBackground(Color.black);
clearCounter = 0;
Timer t = new Timer(1000, this);
t.start();
}
// overriding paint method - discussed above
public void paint(Graphics g) {
clearCounter++;
Graphics2D g2 = (Graphics2D) g;
if (clearCounter == 10) {
g2.clearRect(0, 0, 1000, 700);
clearCounter = 0;
}
CopyrightVirtualUniversityofPakistan
Page190
WebDesignandDevelopment(CS506)
for (int i = 1; i <= 40; i++) {
Color c = chooseColor();
g2.setColor(c);
Font f = chooseFont();
g2.setFont(f);
drawJava(g2);
}
}
// overriding actionPerformed()of ActionListener interface
// called by Timer object
public void actionPerformed(ActionEvent ae) {
repaint();
}
// chooseColor method - discussed above
public Color chooseColor() {
int r = (int) (Math.random() * 255);
int g = (int) (Math.random() * 255);
int b = (int) (Math.random() * 255);
Color c = new Color(r, g, b);
return c;
} // chooseFont method - discussed above
public Font chooseFont() {
int fontChoice = (int) (Math.random() * 4) + 1;
Font f = null;
switch (fontChoice) {
case 1:
f = new Font("Serif", Font.BOLD + Font.ITALIC, 20);
break;
case 2:
f = new Font("SansSerif", Font.PLAIN, 17);
break;
case 3:
f = new Font("Monospaced", Font.ITALIC, 23);
break;
case 4:
f = new Font("Dialog", Font.ITALIC, 30);
break;
}
return f;
}
// drawJava() method - discussed above
public void drawJava(Graphics2D g2) {
int x = (int) (Math.random() * 1000);
int y = (int) (Math.random() * 700);
g2.drawString("java", x, y);
CopyrightVirtualUniversityofPakistan
Page191
WebDesignandDevelopment(CS506)
}
} // end class
The AnimTest.html file is using this applet. The code snippet of it given below:
<html>
<head>
<title> Animated Java Word </title> </head>
<body>
<applet code="JavaAnim.class" width=1000 height=700> </applet>
</body>
</html>
Compile & Execute
You can execute it directly using browser or by using appletviewerapplication. For
having fun, you can use your name instead of java and watch it in different colors.
20.6 References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page192
WebDesignandDevelopment(CS506)
As you have already worked with files, you know that file is an abstraction of your
hard drive. Similarly you can think of a socket as an abstraction of the network.
Each end has input stream (to send data) and output stream (to receive data) wired up
to the other host.
You store and retrieve data through files from hard drive, without knowing the actual
dynamics of the hard drive. Similarly you send and receive data to and from network
through socket, without actually going into underlying mechanics.
You read and write data from/to a file using streams. To read and write data to socket,
you will also use streams.
Normally, a server runs on a specific computer and has a socket that is bound to a
specific port number.
The server just waits, listening to the socket for a client to make a connection request.
CopyrightVirtualUniversityofPakistan
Page193
WebDesignandDevelopment(CS506)
On the client side: The client knows the hostname of the machine on which the server
is running and the port number to which the server is connected.
As soon as client creates a socket that socket attempts to connect to the specified
server.
The server listens through a special kind of socket, which is named as server socket.
The sole purpose of the server socket is to listen for incoming request; it is not used
for communication.
If everything goes well, the server accepts the connection. Upon acceptance, the
server gets a new socket, a communication socket, bound to a different port number.
The server needs a new socket (and consequently a different port number) so that it
can continue to listen through the original server socket for connection requests while
tending to the needs of the connected client. This scheme is helpful when two or more
clients try to connect to a server simultaneously (a very common scenario).
On the server side, if the connection is accepted, a socket is successfully created and
the client can use the socket to communicate with the server.
Note that the socket on the client side is not bound to the port number used to make
contact with the server. Rather, the client is assigned a port number local to the
machine on which the client is running.
The client and server can now communicate by writing to or reading from their
sockets.
java.net.*;
CopyrightVirtualUniversityofPakistan
Page194
WebDesignandDevelopment(CS506)
java.io.*;
Page195
WebDesignandDevelopment(CS506)
the way you did with files
To send messages
pw.println(hello world);
To read messages
String recMsg = br.readLine();
serverPort: port local to the server i.e. a free port on the server machine. This is the same
port number that is given in the client socket constructor
Page196
WebDesignandDevelopment(CS506)
through the accept method.
Socket s = ss.accept();
The server program blocks ( stops ) at the accept method and waits for the incoming client
connection when a request for connection comes it opens a new communication socket (s) and use
this socket to communicate with the client.
Page197
WebDesignandDevelopment(CS506)
import javax.swing.*;
public class EchoServer{
public static void main(String args[]){
try {
//step 2: create a server socket
ServerSocket ss = new ServerSocket(2222);
System.out.println("Server started...");
/* Loop back to the accept method of the server socket and wait for a new connection request. So
server will continuously listen for requests
*/
while(true) {
// step 3: wait for incoming connection
Socket s = ss.accept();
System.out.println("connection request recieved");
// step 4: Get I/O streams
InputStream is = s.getInputStream();
InputStreamReader isr= new InputStreamReader(is);
BufferedReader br = new BufferedReader(isr);
OutputStream os = s.getOutputStream();
PrintWriter pw = new PrintWriter(os,true);
// step 5: Send / Receive message
// reading name sent by client
String name = br.readLine();
// appending hello with the received name
String msg = "Hello " + name + " from Server";
// sending back to client
pw.println(msg);
// closing communication sockey
s.close();
} // end while
}catch(Exception ex){
System.out.println(ex);
}
}
} // end class
EchoClient.java
The code of the client is given below
// step 1: importing required package
import java.net.*;
import java.io.*;
import javax.swing.*;
public class EchoClient{
CopyrightVirtualUniversityofPakistan
Page198
WebDesignandDevelopment(CS506)
public static void main(String args[]){
try {
//step 2: create a communication socket
/* if your server will run on the same machine then you can pass localhost as server address.Notice
that port no is similar to one passed while creating server socket */
Socket s = new Socket(localhost, 2222);
// step 3: Get I/O streams
InputStream is = s.getInputStream();
InputStreamReader isr= new InputStreamReader(is);
BufferedReader br = new BufferedReader(isr);
OutputStream os = s.getOutputStream();
PrintWriter pw = new PrintWriter(os,true);
// step 4: Send / Receive message
// asking user to enter his/her name
String msg = JOptionPane.showInputDialog( "Enter your name");
// sending name to server
pw.println(msg);
// reading message (name appended with hello) from
// server
msg = br.readLine();
// displaying received message
JOptionPane.showMessageDialog(null , msg);
// closing communication socket
s.close();
}catch(Exception ex){
System.out.println(ex);
}
}
} // end class
Compile & Execute
After compiling both files, run EchoServer.java first, from the command prompt window. Youll see
a message of server started as shown in the figure below. Also notice that cursor is continuously
blinking since server is waiting for client request
C:\WINDOWS\system32\cmd.exe
CopyrightVirtualUniversityofPakistan
Page199
WebDesignandDevelopment(CS506)
Now, open another command prompt window and run EchoClient.java from it. Look at
EchoServer window; youll see the message of request received. Sooner, the
EchoClient program will ask you to enter name in input dialog box. After entering name
press ok button, with in no time, a message dialog box will pop up containing your name
with appended hello from server. This whole process is illustrated below in pictorial
form:
C:\WINDOWS\system32\cmd.exe
C:\WINDOWS\system32\cmd.exe
D:\examples\socketprog> javaEchoServer
Server started
Connection request recieved
Input
X
EnteryourName
Umair
OK
Cancel
Input
X
HelloumairfromServer
OK
CopyrightVirtualUniversityofPakistan
Page200
WebDesignandDevelopment(CS506)
Response from server
Notice that server is still running, you can run again EchoClient.java as many times untill server is
running.
To have more fun, run the server on a different computer and client on a different. But
before doing that find the IP of the computer machine on which your EchoServer will
eventually run. Replace localhost with the new IP and start conversion over network
21.7 References
Entire material for this handout is taken from the book JAVA A Lab Course by Umair
Javed. This material is available just for the use of VU students of the course Web
Design and Development and not for any other commercial purpose without the consent
of author.
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page201
WebDesignandDevelopment(CS506)
Lecture 22:
22.1 Problem
22.1.1 What?
22.1.2 Motivation
Page202
WebDesignandDevelopment(CS506)
line = br.readLine();
}
As you have seen a lot of parsing code is required for converting a line into PersonInfo
objects. Serialization mechanism eases developers life by achieving all above in a very
simple way.
As you know, objects get created on heap and have some values therefore
Objects have some state in memory
o You need to save and restore that state.
o The good news is that java serialization takes care of it automatically
System knows how to recursively write out the state of an object to stream
If an object has the reference of another object, the java serialization mechanism takes
care of it and writes it too.
System knows how to read the data from Stream and re-create object in memory
The recreated object is of type Object therefore Down-casting is required to convert
it into actual type.
CopyrightVirtualUniversityofPakistan
Page203
WebDesignandDevelopment(CS506)
22.2.4 Serialization: How it works?
To read that
will be used
object
back, ObejctInputStream
and
its method
readObject()
ObejctInputStream in;
// reading PersonInfos object. Remember type
casting // is required
PersonInfo obj = (PersonInfo)in.readObject( );
Example Code 22.1: Reading / Writing PersonInfo objects
We want to send PersonInfo object to stream. You have already seen this class number of times
before. Here it will also implement serializable interface.
PersonInfo.java
import javax.swing.*;
import java.io.* ;
class PersonInfo implements Serializable{
String name;
String address;
String phoneNum;
//parameterized constructor
public PersonInfo(String n, String a, String p) {
name = n;
address = a;
phoneNum = p;
}
//method for displaying person record on GUI
public void printPersonInfo( ) {
JOptionPane.showMessageDialog(null ,name: + name + address: +address + phone no: +
phoneNum);
}
} // end class
WriteEx.java
The following class will serialize PersonInfo object to a file
CopyrightVirtualUniversityofPakistan
Page204
WebDesignandDevelopment(CS506)
import java.io.*;
public class WriteEx{
public static void main(String args[ ]){
PersonInfo pWrite = new PersonInfo("ali", "defence", "9201211");
try {
// attaching FileOutput stream with ali.dat
FileOutputStream fos = new FileOutputStream("ali.dat");
// attaching ObjectOutput stream over FileOutput stream
ObjectOutputStream out = new ObjectOutputStream(fos);
//serialization
// writing object to ali.dat
out.writeObject(pWrite);
// closing streams out.close();
fos.close();
} catch (Exception ex){ System.out.println(ex);
}
}
} // end class
ReadEx.java
The following class will read serialized object of PersonInfo from file i.e ali.dat
import java.io.*;
public class ReadEx{
public static void main(String args[ ]){
try {
// attaching FileInput stream with ali.dat
FileInputStream fis = new FileInputStream("ali.dat");
// attaching FileInput stream over ObjectInput stream
ObjectInputStream in = new ObjectInputStream(fis);
//de-serialization
// reading object from ali.dat
PersonInfo pRead = (PersonInfo)in.readObject( );
// calling printPersonInfo method to confirm that
// object contains same set of values before
// serializatoion
pRead.printPersonInfo();
// closing streams
in.close();
fis.close();
} catch (Exception ex){
System.out.println(ex);
}
}//end main function
} // end class
CopyrightVirtualUniversityofPakistan
Page205
WebDesignandDevelopment(CS506)
Compile & Execute
After compilation, first run the WriteEx.java file and visit the ali.dat file. Then run
ReadEx.javafrom different command or same command prompt.
All you need to do is attach your stream with socket rather than file.
The class version should be same on both sides (client & network) of the network .
Page206
WebDesignandDevelopment(CS506)
}
} // end class
Reading Objects over Network
The following class ServerReadNetEx.javawill read an object of PersonInfo sent by client.
import java.net.*;
import java.io.*;
import javax.swing.*;
public class ServerReadNetEx{
public static void main(String args[]){
try {
// create a server socket
ServerSocket ss = new ServerSocket(2222);
System.out.println("Server started...");
/* Loop back to the accept method of the server socket and wait for a new connection request. So
server will continuously listen for requests
*/
while(true) {
// wait for incoming connection
Socket s = ss.accept();
System.out.println("connection request recieved");
// Get I/O streams
InputStream is = s.getInputStream();
// attaching ObjectOutput stream over Input stream
ObjectInputStream ois = new ObjectInputStream(is);
// read PersonInfo object from network
PersonInfo p = (PersonInfo)ois.readObject( );
p.printPersonInfo();
// closing communication socket
s.close();
} // end while
}catch(Exception ex){
System.out.println(ex); }
}
} // end class
Compile & Execute
After compiling both files, run ServerReadNetEx.java first, from the command prompt
window. Open another command prompt window and run ClientWriteNetEx.java from it.
The ClientWriteNetEx.java will send an Object of PersonInfo to ServerReadNetEx.java
that displays that object values in dialog box after reading it from network.
CopyrightVirtualUniversityofPakistan
Page207
WebDesignandDevelopment(CS506)
22.4 Preventing Serialization
Often there is no need to serialize sockets, streams & DB connections etc because they do
not represent the state of object, rather connections to external resources
To do so, transient keyword is used to mark a field that should not be serialized
So we can mark them as,
o transient Socket s;
o transient OutputStream os;
o transient Connection con;
Transient fields are returned as null on reading
22.5 References
Entire material for this handout is taken from the book JAVA A Lab Course by Umair Javed.
This material is available just for the use of VU students of the course Web Design and
Development and not for any other commercial purpose without the consent of author.
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page208
WebDesignandDevelopment(CS506)
Lecture 23: Multithreading
23.1 Introduction
Multithreading is the ability to do multiple things at once within the same application. It provides
finer granularity of concurrency. A thread sometimes called an execution context or a
lightweight process is a single sequential flow of control within a program.
Threads are light weight as compared to processes because they take fewer resources then a process.
A thread is easy to create and destroy. Threads share the same address space i.e. multiple threads
can share the memory variables directly, and therefore may require more complex synchronization
logic to avoid deadlocks and starvation.
CopyrightVirtualUniversityofPakistan
Page209
WebDesignandDevelopment(CS506)
C:\WINDOWS\system32\cmd.exe
CopyrightVirtualUniversityofPakistan
Page210
WebDesignandDevelopment(CS506)
C:\WINDOWS\system32\cmd.e
Page211
WebDesignandDevelopment(CS506)
Notice the difference between the outputs of the two programs. In ThreeLoopTest each loop
generated a sequential output while in ThreadTest the output of the loops got intermingled
i.e. concurrency took place and loops executed simultaneously.
Let us code our first multithreaded program and try to learn how Java supports
multithreading.
Using Interface
Using Inheritance
Create a class where you want to put some code that can run in parallel with some other
code and let that class implement the Runnable interface.
Runnable interface has the run() method therefore provide the implementation for the
run() method and put your code that you want to run in parallel here.
Instantiate Thread class object by passing Runnable object in constructor
Start thread by calling start() method
Following are the steps to create threads by using Inheritance:
CopyrightVirtualUniversityofPakistan
Page212
WebDesignandDevelopment(CS506)
23.3.1.1 Threads Creation Steps Using Interface
To write a multithreaded program using Runnable interface, follow these steps:
CopyrightVirtualUniversityofPakistan
Page213
WebDesignandDevelopment(CS506)
23.4 Three Loops: Multi-Threaded Execution
So far we have explored:
What is multithreading?
What are Java Threads?
Two ways to write multithreaded Java programs
Now we will re-write the ThreeLoopTest program by using Java Threads. At first we will use the
Interface approach and then we will use Inheritance.
Code Example using Interface
// File Worker.java
public class Worker implements Runnable {
private String job ;
//Constructor of Worker class
public Worker (String j ){
job = j;
}
//Implement run() method of Runnable interface
public void run ( ) {
for(int i=1; i<= 10; i++)
System.out.println(job + " = " + i);
}
} // end class
// File ThreadTest.java
public class ThreadTest{
public static void main (String args[ ]){
//instantiate three objects
Worker first = new Worker (first job);
Worker second = new Worker (second job);
Worker third = new Worker (third job);
//create three objects of Thread class & passing worker
//(runnable) to them
Thread t1 = new Thread (first );
Thread t2 = new Thread (second);
Thread t3 = new Thread (third);
//start threads to execute
t1.start();
t2.start();
t3.start();
}//end main
CopyrightVirtualUniversityofPakistan
Page214
WebDesignandDevelopment(CS506)
} // end class
Page215
WebDesignandDevelopment(CS506)
as that of the creating thread i.e. parent thread.
A Threads priority can be any integer between 1 and 10. We can also use the following predefined
constants to assign priorities.
Thread.MAX_PRIORITY (typically 10)
Thread.NORM_PRIORITY (typically 5)
Thread.MIN_PRIORITY
(typically
1)
To change the priority of a thread, we can use the following method
setPriority(int priority)
It changes the priority of this thread to integer value that is passed. It throws an
IllegalArgumentExceptionif the priority is not in the range MIN_PRIORITY to
MAX_PRIORITY i.e. (1-10).
For example, we can write the following code to change a threads priority.
Thread t = new Thread (RunnableObject);
// by using predefined constant
t.setPriority (Thread.MAX_PRIORITY);
// by using integer constant
t.setPriority (7);
Then the second thread is given a chance to run, and so on, until the interpreter exits.
Consider the following figure in which threads of various priorities are represented by capital
CopyrightVirtualUniversityofPakistan
Page216
WebDesignandDevelopment(CS506)
alphabets A, B, , K. A and B have same priority (highest in this case). J and K have same
priority (lowest in this case). JVM start executing with A and B, and divides CPU time between
these two threads arbitrarily. When both A and B comes to an end, it chooses the next thread C to
execute.
// File PriorityEx.java
public class PriorityEx{
public static void main (String args[ ]){
//instantiate two objects
Worker first = new Worker (first job);
Worker second = new Worker (second job);
//create two objects
Thread t1 = new Thread (first );
Thread t2 = new Thread (second);
//set thread priorities
CopyrightVirtualUniversityofPakistan
Page217
WebDesignandDevelopment(CS506)
t1.setPriority (Thread.MIN_PRIORITY);
t2.setPriority (Thread.MAX_PRIORITY);
//start threads to execute
t1.start();
t2.start();
}//end main
} // end class
Output
C:\WINDOWS\system32\cmd.exe
Page218
WebDesignandDevelopment(CS506)
23.6 References:
Java, A Practical Guide by Umair Javed.
Java How to Program by Deitel and Deitel.
CS193j handouts on Stanford.
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page219
WebDesignandDevelopment(CS506)
Lecture 24: More on Multithreading
In this handout, well cover different aspects of multithreading. Some examples are given to make
you understand the topic of multithreading. First we will start with an example that reads data
from two text files simultaneously.
CopyrightVirtualUniversityofPakistan
Page220
WebDesignandDevelopment(CS506)
Following is the code of ReadFile.java that implements Runnable interface. The file reading code
will be written inside run ( )method
// File ReadFile.java
import java.io.*;
public class ReadFile implements Runnable{
//attribute used for name of file
String fileName;
// param constructor
public ReadFile(String fn){
fileName = fn;
}
// overriding run method
// this method contains the code for file reading
public void run ( ){
try
{
// connecting FileReader with attribute fileName
FileReader fr = new FileReader(fileName);
BufferedReader br = new BufferedReader(fr);
String line = "";
// reading line by line data from file
// and displaying it on console
line = br.readLine();
while(line != null) {
System.out.println(line);
line = br.readLine();
}
fr.close();
br.close();
}
catch (Exception e){
System.out.println(e);
}
} // end run() method
}
Next, look at the Test.javaclass that contains the main() method.
// File Test.java
public class Test {
public static void main (String args[]){
// creating ReadFile objects by passing file names to them
ReadFile first = new ReadFile("first.txt");
CopyrightVirtualUniversityofPakistan
Page221
WebDesignandDevelopment(CS506)
ReadFile second = new ReadFile("second.txt");
// Instantiating thread objects and passing
// runnable (ReadFile) objects to them
Thread t1 = new Thread(first);
Thread t2 = new Thread(second);
// starting threads that cause threads to read data from
// two different files simultaneously
t1.start();
t2.start();
}
}
Output
On executing Test class, following kind output would be generated:
C:\WINDOWS\system32\cmd.exe
CopyrightVirtualUniversityofPakistan
Page222
WebDesignandDevelopment(CS506)
24.1.1 sleep(int time) method
Causes the currently executing thread to wait for the time (milliseconds) specified
Waiting is efficient equivalent to non-busy. The waiting thread will not occupy the
processor
Threads come out of the sleep when the specified time interval expires or when
interrupted by some other thread
Thread coming out of sleep may go to the running or ready state depending upon the
availability of the processor. The different states of threads will be discussed later
High priority threads should execute sleep method after some time to give low
priority threads a chance to run otherwise starvation may occur
sleep()
method can be used for delay purpose i.e. anyone can call
Thread.sleep()method
Note that sleep()
method can throw InterruptedException. So, you
need try-catch block
Page223
WebDesignandDevelopment(CS506)
public class SleepEx {
public static void main (String args[ ]){
// Creating Worker objects
Worker first = new Worker (first job);
Worker second = new Worker (second job);
// Instantiating thread class objects
Thread t1 = new Thread (first );
Thread t2 = new Thread (second);
// starting thread
t1.start();
t2.start();
}
} // end class
Output
On executing SleepEx.java, the output will be produced with exact alternations between first thread
& second thread. On starting threads, first thread will go to sleep for 100 ms. It gives a chance to
second thread to execute. Later this thread will also go to sleep for 100 ms. In the mean time
the first thread will come out of sleep and got a chance on processor. It will print job on console and
again enters into sleep state and this cycle goes on until both threads finished the run()method.
C:\WINDOWS\system32\cmd.exe
Page224
WebDesignandDevelopment(CS506)
thread in existence. However, we can create more threads which can run concurrently with the
existing default thread.
sleep()method can be used for delay purpose. This is demonstrated in the
DelayEx.java given below:
// File DelayEx.java
public class DelayEx {
public static void main (String args[ ]){
System.out.println(main thread going to sleep);
try {
// the main thread will go to sleep causing delay
Thread.sleep(100);
}catch (Exception ex){
System.out.println(ex);
}
System.out.println(main thread coming out of sleep);
}
// end main()
} // end class
Output
On executing DelayEx class, you will experience a delay after the first statement
displayed. The second statement will print when the time interval expired. This has been show below
in the following two diagrams:
C:\WINDOWS\system32\cmd.exe
C:\WINDOWS\system32\cmd.exe
Allows any other threads of the same priority to execute (moves itself to the end of
the priority queue)
If all waiting threads have a lower priority, then the yielding thread resumes
execution on the CPU
Generally used in cooperative scheduling schemes
CopyrightVirtualUniversityofPakistan
Page225
WebDesignandDevelopment(CS506)
Example Code: Demonstrating yield ( ) usage
Below the modified code of Worker.javais given
// File Worker.java
public class Worker implements Runnable {
private String job ;
//Constructor of Worker class
public Worker (String j ){
job = j;
}
//Implement run() method of Runnable interface
public void run ( )
{
for(int i=1; i<= 10; i++) {
// giving chance to a thread to execute of same priority
Thread.yield( );
System.out.println(job + " = " + i);
} // end for
} // end run
} // end class
Below is the code of YieldEx.java that contains the main ()method.It will use the
Worker class created above.
// File YieldEx.java public class YieldEx {
public static void main (String args[ ]){
// Creating Worker objects
Worker first = new Worker (first job);
Worker second = new Worker (second job);
// Instantiating thread class objects
Thread t1 = new Thread (first );
Thread t2 = new Thread (second);
// starting thread
t1.start();
t2.start();
}
} // end class
Output
Since both threads have the same priority (until we change the priority of some thread explicitly).
CopyrightVirtualUniversityofPakistan
Page226
WebDesignandDevelopment(CS506)
Therefore both threads will execute on alternate basis. This can be confirmed from the
output given below:
C:\WINDOWS\system32\cmd.exe
CopyrightVirtualUniversityofPakistan
Page227
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page228
WebDesignandDevelopment(CS506)
24.2.4 Dead state
Used when a thread wants to wait for another thread to complete its run() method
For example, if thread2 sent the thread2.join() message, it causes the currently executing
thread to block efficiently until thread2 finishes its run() method
Calling join method can throw InterruptedException, so you must use try-catch block to
handle it
Page229
WebDesignandDevelopment(CS506)
try {
t1.join();
t2.join();
}
catch (Exception ex) {
System.out.println(ex);
}
System.out.println("All done ");
} // end main
}
Output
On executing JoinEx, notice that Starting is printed first followed by printing workers jobs.
Since main thread does not finish until both threads have finished their run (). Therefore All
done will be print on last.
C:\WINDOWS\system32\cmd.exe
CopyrightVirtualUniversityofPakistan
Page230
WebDesignandDevelopment(CS506)
Lecture 25: Web Application Development
25.1 Introduction
Because of the wide spread use of internet, web based applications are becoming vital part of
IT infrastructure of large organizations. For example web based employee performance
management systems are used by organizations for weekly or monthly reviews of
employees. On the other hand online course registration and examination systems can allow
students to study while staying at their homes.
A
Typical Web
Application
A web server is software which provides users, access to the services that are present on
the internet. These servers can provide support for many protocols used over internet or
intranet like HTTP, FTP, telnet etc
CopyrightVirtualUniversityofPakistan
Page231
WebDesignandDevelopment(CS506)
25.3 HTTP Basics
A protocol defines the method and way of communication between two parties. For example
when we talk to our teacher we use a certain way which is different from the way that we adopt
with our friends or parents. Similarly there are many different protocols used by computers to
communicate with each other depending on applications.
For example an Echo Server only listens to incoming name messages and sends back hello
message, while HTTP protocol uses various types of request-response messages.
HTTP Communication
Model
CopyrightVirtualUniversityofPakistan
Page232
WebDesignandDevelopment(CS506)
HTTP Request
Example
Body: Contains data sent by client to the server
Other request headers like FROM (email of the person responsible for request) and VIA
(used by gateways and proxies to show intermediate sites the request passes) can also be
used.
Request Parameters
o Request can also contain addition information in form of request parameters
In URL as query string e.g.
http://www.gmail.com/register?name=ali&state=punjab
As part of request body (see Figure 3)
CopyrightVirtualUniversityofPakistan
Page233
WebDesignandDevelopment(CS506)
Page234
WebDesignandDevelopment(CS506)
o
400-499
Values in the 400s indicate an error by the client.
404: Indicates that the requested resource is not available.
401: Indicates that the request requires HTTP authentication.
403: Indicates that access to the requested resource has been denied.
500-599
Codes in the 500s signify an error by the server.
503: Indicates that the HTTP server is temporarily overloaded and unable
to handle the request.
CopyrightVirtualUniversityofPakistan
Page235
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page236
WebDesignandDevelopment(CS506)
Static Web Page Request And Response
An example of static web page is given below
While in case of dynamic web page s server executes an application which generates HTML
web pages according to specific requests coming from client. These dynamically generated web
pages are sent back to client with the response.
CopyrightVirtualUniversityofPakistan
Page237
WebDesignandDevelopment(CS506)
25.4.1 Why build Pages Dynamically?
We need to create dynamic web pages when the content of site changes frequently and client specific
response is required. Some of the scenarios are listed below
The web page is based on data submitted by the user e.g. results page from search engines
and order confirmation pages at on line stores.
CopyrightVirtualUniversityofPakistan
Page238
WebDesignandDevelopment(CS506)
The Web page is derived from data that changes frequently e.g. a weather report or news
headlines page.
CopyrightVirtualUniversityofPakistan
Page239
WebDesignandDevelopment(CS506)
The Web page uses information from databases or other server-side resources e.g. an ecommerce site could use a servlet to build a Web page that lists the current price and
availability of each item that is for sale.
CopyrightVirtualUniversityofPakistan
Page240
WebDesignandDevelopment(CS506)
Using technologies for developing web pages that include dynamic content.
Developing web based applications which can produce web pages that contain
information that is connection-dependent or time-dependent.
CopyrightVirtualUniversityofPakistan
Page241
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page242
WebDesignandDevelopment(CS506)
Page243
WebDesignandDevelopment(CS506)
25.6 Java - Web Application Technologies
There are several Java technologies available for web application development which includes Java
Servlets, JavaServer Pages, and JavaServer Faces etc.
25.7 References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page244
WebDesignandDevelopment(CS506)
Servlets can do anything that a java class can do. For example, connecting with
database, reading/writing data to/from file etc.
Handles requests sent by the user (clients) and generates response dynamically
(normally HTML pages).
The dynamically generated content is send back to the user through a webserver
(client)
Page245
WebDesignandDevelopment(CS506)
26.2.1 Convenient
Servlets can use the whole java API e.g. JDBC. So if you already know java, why learn
Perl or C. Servlets have an extensive infrastructure for automatically parsing and decoding HTML
form data, reading and sending HTTP headers, handling cookies and tracking session etc and many
more utilities.
26.2.2 Efficient
With traditional CGI, a new process is started for each request while with servlets each request is
handled by a lightweight java thread, not a heavy weight operating system process. (more on this
later)
26.2.3 Powerful
Java servlets let you easily do several things that are difficult or impossible with regular CGI. For
example, servlets can also share data among each other
26.2.4 Portable
Since java is portable and servlets is a java based technology therefore they are generally portable
across web servers
26.2.5 Inexpensive
There are numbers of free or inexpensive web servers available that are good for personal use or low
volume web sites. For example Apache is a commercial grade webserver that is absolutely free.
However some very high end web and application servers are quite expensive e.g. BEA weblogic.
Well also use Apache in this course
Page246
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
WebDesignandDevelopment(CS506)
When the zip file will unzipped a directory structure will be created on your computer
such as:
JAVA_HOME indicates the root directory of your jdk. Set the JAVA_HOME
environment variable to tell Tomcat, where to find java
This variable should list the base JDK installation directory, not the bin
subdirectory
To set it, right click on My Computer icon. Select the advanced tab, a System
Properties window will appear in front of you like shown below. Select the
Environment Variables button to proceed.
CopyrightVirtualUniversityofPakistan
Page248
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page249
WebDesignandDevelopment(CS506)
Create a new User variable by clicking New button as shown above, the New
User Variable window will appear
Set name of variable JAVA_HOME
The value is the installation directory of JDK
(for example C:\Program
Files\j2sdk_nb\j2sdk1.4.2). This is shown below in the picture. Please note
that bin folder is not included in the path.
Page250
WebDesignandDevelopment(CS506)
CATALINA_HOME is used to tell the system about the root directory of the TOMCAT.
There are various files (classes, exe etc) needed by the system to run.
CATALINA_HOME is used to tell your system (in this case your web server Tomcat) where
the required files are.
To Set the CATALINA_HOME environment variable, create another User Variable.
Type CATALINA_HOME as the name of the environment variable.
Its value should be the path till your top-level Tomcat directory. If you have
unzipped the Tomcat in C drive. It should be C:\jakarta-tomcat-5.5.9. This is
shown below:
Note:
To run Tomcat (web server) you need to set only the two environment variables
and these are JAVA_HOME & CATALINA_HOME
CopyrightVirtualUniversityofPakistan
Page251
WebDesignandDevelopment(CS506)
Note: If default page doesnt displayed, open up an internet explorer window, move on to Tools
Internet Options Connections LAN Settings. Make sure that option of Bypass proxy server
for local addresses is unchecked.
CopyrightVirtualUniversityofPakistan
Page252
WebDesignandDevelopment(CS506)
There is another easier way to carry out the environment setup using .exe file. However, it is
strongly recommended that you must complete the environment setup using .zip file to know the
essential fundamentals.
CopyrightVirtualUniversityofPakistan
Page253
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page254
WebDesignandDevelopment(CS506)
The setup will automatically select the Java Virtual Machine path. Click
Install button to move ahead.
Finish the setup with the Run Apache Tomcat option selected. It will cause the tomcat
server to run in quick launch bar as shown in diagram below. The Apache Tomcat
shortcuts will also added to Programs menu.
Double clicking on this button will open up Apache Tomcat Properties window. From here
you
can
start
or
stop
your
web
server.
You
can
also
configure many options if you want to. This properties window is shown
below:
CopyrightVirtualUniversityofPakistan
Page255
WebDesignandDevelopment(CS506)
Open the Apache Tomcat properties window by clicking on the Apache Tomcat button
from Quick Launch.
Start the tomcat server if it is not running by clicking on Start button.
CopyrightVirtualUniversityofPakistan
Page256
WebDesignandDevelopment(CS506)
Open up a browser window and type http://localhost:8080. This should open the default
page of Tomcat as shown in the next diagram:
Note: If default page doesnt displayed, open up an internet explorer window, move on to Tools
Internet Options Connections LAN Settings. Make sure that option of Bypass proxy
server for local addresses is unchecked.
26.5 References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page257
WebDesignandDevelopment(CS506)
Unpack
o
o
Where each directory & file exists in the file system separately
Used mostly during development
Pack
To make a new application e.g myapp in tomcat you need a specific folder hierarchy.
CopyrightVirtualUniversityofPakistan
Page258
WebDesignandDevelopment(CS506)
All JSP and html files will be kept in main application folder (C:\jakartatomcat-5.5.9\webapps\myapp)
Create another folder inside myapp
folder and change its name to WEB-INF.
Remember WEB-INFis case sensitive and it is not WEB_INF
Configuration files such as web.xml
will go in WEB-INF
folder
(C:\jakarta-tomcat-5.5.9\webapps\myapp\WEB-INF)
Create another folder inside WEB-INF folder and change its name to classes.
Remember classesname is also case sensitive.
Servlets and Java Beans will go in classes folder (C:\jakarta-tomcat5.5.9\webapps\myapp\WEB-INF\classes)
Thats the minimum directory structure required in order to get started. This is also shown in
the figure below:
CopyrightVirtualUniversityofPakistan
file.
Page259
WebDesignandDevelopment(CS506)
Here you can see some other folders like lib& tags under the WEB-INF.
The lib folder is required if you want to use some achieve files (.jar). For
example an API in jar format that can help generating .pdffiles.
Similarly tags
folder is helpful for building custom tags or for using .tag
files.
Note: Restart Tomcat every time you create a new directory structure, a servlet or a java bean so
that it can recognize it. For JSP and html files you dont have to restart the server.
CopyrightVirtualUniversityofPakistan
Page260
WebDesignandDevelopment(CS506)
contains the servlets life cycle methods etc. (Life cycle methods will be discussed in
next handout)
In order to write your own servlet, you can subclass from GernericServlet
or HttpServlet
to
CopyrightVirtualUniversityofPakistan
Page261
WebDesignandDevelopment(CS506)
HttpServletRequest & HttpServletRespose are used for processing HTTP protocol specific
requests and generating HTTP specific response. Obviously these classes will be used in
conjunction with HttpServet class, which means you are making a HTTP protocol specific
servlet.
27.4 Types of HTTP requests
HTTP supports different types of request to be sent over to server. Each request has some
specific purpose. The most important ones are get & post. Given below a brief overview
of each request type is given. You can refer to RFC of HTTP for further details.
GET: Requests a page from the server. This is the normal request used when
browsing web pages.
POST: This request is used to pass information to the server. Its most common
use is with HTML forms.
PUT: Used to put a new web page on a server.
DELETE: Used to delete a web page from the server.
OPTIONS: Intended for use with the web server, listing the supported options.
TRACE: Used to trace servers
GET
o Attribute-Value pair is attached with requested URL after ?.
CopyrightVirtualUniversityofPakistan
Page262
WebDesignandDevelopment(CS506)
o For example if attribute is name and value is ali then the request will be
http://www.gmail.com/register?name=ali
o For HTTP based servlet, override doGet () methods of HttpServlet class to handle
these type of requests.
POST
o
Attribute-Value pair attached within the request body. For your reference HTTP
request diagram is given below again:
Page263
WebDesignandDevelopment(CS506)
5. Create a deployment descriptor (web.xml) and put it inside WEB-INF folder
6. Restart your server if already running
7. Access it using Web browser
Example Code: HelloWorldServlet.java
//File HelloWorldServlet.java
// importing required packages
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
// extending class from HttpServelt
public class HelloWorldServlet extends HttpServlet {
/* overriding doGet() method because writing a URL in the browser by default generate request of
GET type As you can see, HttpServletRequest and HttpServletResponse are passed to this method.
These objects will help in processing of HTTP request and generating response for HTTP This
method can throw ServletException or IOException, so we mention these exception types after
method signature
*/
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
/* getting output stream i.e PrintWriter from response object by calling getWriter method on it As
mentioned, for generating response, we will use HttpServletResponse object
*/
PrintWriter out = response.getWriter();
/* printing Hello World in the browser using PrintWriter object. You can also write HTML like
out.println(<h1> Hello World </h1>)
*/
out.println(Hello World! );
} // end doGet()
} // end HelloWorldServlet
Example Code: web.xml
eXtensible Markup Language (xml) contains custom defined tags which convey
information about the content. To learn more about XML visit http://ww.w3schools.com.
Inside web.xml, the <web-app> is the root tag representing the web application. All other tags
come inside of it.
<?xml version="1.0" encoding="ISO-8859-1"?>
<web-app>
CopyrightVirtualUniversityofPakistan
Page264
WebDesignandDevelopment(CS506)
<servlet>
<servlet-name>
HelloWorldServlet </servlet-name>
<servlet-class> HelloWorldServlet </servlet-class> </servlet>
<servlet-mapping>
<servlet-name> HelloWorldServlet </servlet-name> <url-pattern>
/myfirstservlet </url-pattern>
</servlet-mapping>
</web-app>
The <servlet> tag represents ones servlet name and its class. To specify the name of
servlet, <servlet-name> tag is used. Similarly to specify the class name of servlet (it is the
same name you used for making a servlet), <servlet-class>tag is used.
Note: It is important to note here that you can specify any name for a servlet inside
<servlet-name> tag. This name is used for referring to servlet in later part of
web.xml. You can think of it as your id assigned to you by your university while you have
actually different name (like <servlet-class>).
Next we will define the servlet mapping. By defining servlet mapping we are specifying URL to
access a servlet. <servlet-mapping> tag is used for this purpose.
Inside <servlet-mapping> tag, first you will write the name of the servlet for which you
want to specify the URL mapping using <servlet-name> tag and then you will define the URL
pattern using <url-pattern>tag. Notice the forward slash (/ ) is used before specifying the url.
You can specify any name of URL. The forward slash indicates the root of your
application.
<url-pattern> /myfirstservlet </url-pattern>
Now you can access HelloWorldServelt (if it is placed in myapp application) by giving the
following url in the browser
http://localhost:8080/myapp/myfirstservlet
Note: Save this web.xml file by placing double quotes(web.xml) around it as you did to save
.java files.
27.7 Compiling and Invoking Servlets
Page265
WebDesignandDevelopment(CS506)
restart your tomcat server if already running
http://localhost:8080/myapp/myfirstservlet
Note: By using IDEs like netBeans 4.1, you dont have to write web.xml
by yourself
or even to worry about creating directory structure and to copy files inappropriate locations.
However manually undergoing this process will strengthen your concepts and will help you to
understand the underlying mechanics.
27.8 References:
Entire material for this handout is taken from the book JAVA A Lab Course by Umair
Javed. This material is available just for the use of VU students of the course Web
Design and Development and not for any other commercial purpose without the consent
of author.
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page266
WebDesignandDevelopment(CS506)
Lecture 28: Servlets Lifecycle
In the last handout, we have seen how to write a simple servlet. In this handout we will look
more specifically on how servlets get created and destroyed. What different set of method are
invoked during the lifecycle of a typical servlet.
The second part consists on reading HTML form data through servlet technology. This will be
explored in detail using code example
Initialize
Service
Destroy
As you can conclude from the diagram below, that with the passage of time a
servlet passes through these stages one after another.
28.1.1 Initialize
When the servlet is first created, it is in the initialization stage. The webserver invokes he
init() method of the servlet in this stage. It should be noted here that init() is only called once
and is not called for each request. Since there is no constructor available in Servlet so this urges
its use for one time initialization (loading of resources, setting of parameters etc) just as the
CopyrightVirtualUniversityofPakistan
Page267
WebDesignandDevelopment(CS506)
init()method of applet.
Initialize stage has the following characteristics and usage
Executed once, when the servlet gets loaded for the first time
Not called for each client request
The above two points make it an ideal place to perform the startup tasks which are
done in constructor in a normal class.
28.1.2 Service
The service() method is the engine of the servlet, which actually processes the clients request.
On every request from the client, the server spawns a new thread and calls the service() method
as shown in the figure below. This makes it more efficient as compared to the
technologies that use single thread to respond to requests.
The figure below show both versions of the implementation of service cycle. In the upper
part of diagram, we assume that servlet is made by sub-classing from GenericServlet. (Remember,
GenericServlet is used for constructing protocol independent servlets.). To provide the desired
functionality, service() method is overridden. The client sends a request to the web server; a new
thread is created to serve this request followed by calling the service() method. Finally a response is
prepared and sent back to the user according to the request.
CopyrightVirtualUniversityofPakistan
Page268
WebDesignandDevelopment(CS506)
The second part of the figure illustrates a situation in which servlet is made using
HttpServlet class. Now, this servlet can only serves the HTTP type requests. In these
servlets doGet() and doPost() are overridden to provide desired behaviors. When a request is
sent to the web server, the web server after creating a thread, passes on this request to
service() method. The service() method checks the HTTP requests type (GET, POST etc) and
calls the doGet() or doPost() method depending on how the request is originally sent. After
forming the response by doGet() or doPost() method, the response is sent back to the service()
method that is finally sent to the user by the web server.
28.1.3 Destroy
The web server may decide to remove a previously loaded servlet instance, perhaps because it is
explicitly asked to do so by the server administrator, or perhaps servlet container shuts down or
the servlet is idle for a long time, or may be the server is overloaded. Before it does, however it
calls the servlets destroy()method. This makes it a perfect spot for releasing the acquired
resources.
CopyrightVirtualUniversityofPakistan
Page269
WebDesignandDevelopment(CS506)
28.2 Summary
The web sever creates a servlet instance. After successful creation, the servlet enters into
initialization phase. Here, init() method is invoked for once. In case web server fails in
previous two stages, the servlet instance is unloaded from the server.
After initialization stage, the Servlet becomes available to serve the clients requests and to
generate response accordingly. Finally, the servlet is destroyed and unloaded from web
server.
Page270
WebDesignandDevelopment(CS506)
HTML form data. To begin with, lets first identify in how many ways a client can send data
Form Data
Data that the user explicitly type into an HTML form. For example: registration
information provided for creating a new email account.
CopyrightVirtualUniversityofPakistan
Page271
WebDesignandDevelopment(CS506)
Data, which is automatically, appended to the HTTP Request from the client for
example, cookies, browser type, and browser IP address.
Based on our understanding of HTML, we now know how to create user forms. We also
know how to gather user data via all the form controls: text, password, select, checkbox,
radio buttons, etc. Now, the question arises: if I submit form data to a Servlet, how do I
extract this form data from servlet? Figuring this out, provides the basis for creating
interactive web applications that respond to user requests.
getParameter(String name)
o
Used to retrieve a single form parameter and returns String corresponding to name
specified.
o Empty String is returned in the case when user does not enter any thing in the
specified form field.
o If the name specified to retrieve the value does not exist, it returns null.
Note: You should only use this method when you are sure that the parameter has only one
value. If the parameter might have more than one value, use getParamterValues().
getParameterValues(String name)
o Returns an array of Strings objects containing all of the given values of the given
request parameter.
o If the name specified does not exist, nullis returned
getParameterNames()
o If you are unsure about the parameter names, this method will be helpful
o It returns Enumeration of String objects containing the names of the parameters
that
come with the request.
o If the request has no parameters, the method returns an empty Enumeration.
Note: All these methods discussed above work the same way regardless of the request
type(GET or POST). Also remember that form elements are case sensitive for example,
userName is not the same as the username.
CopyrightVirtualUniversityofPakistan
Page272
WebDesignandDevelopment(CS506)
Example Code: Reading Form Data using Servlet
This example consists of one HTML page (index.html), one servlet (MyServlet.java) and one
xml file (web.xml) file. The HTML page contains two form parameters: firstName and
surName. The Servlet extracts these specific parameters and echoes them back to the browser after
appending Hello.
Note: The example given below and examples later in coming handouts are built using
netBeans4.1. Its important to note that tomcat server bundled with netBeans runs on 8084
port by default.
index.html
CopyrightVirtualUniversityofPakistan
Page273
WebDesignandDevelopment(CS506)
Lets have a look on the HTML code used to construct the above page.
<html>
<head>
<title> Reading Two Parameters </title> </head>
<body>
<H2> Please fill out this form: </H2>
<FORM
METHOD="GET"
ACTION="http://localhost:8084/paramapp/formservlet"
NAME="myform" >
<BR> Firstname:
<INPUT TYPE = text NAME="firstName">
<BR> Surname:
<INPUT TYPE = text NAME="surName">
CopyrightVirtualUniversityofPakistan
Page274
WebDesignandDevelopment(CS506)
<BR>
<INPUT TYPE="submit" value="Submit Form">
<INPUT TYPE="reset" value="Reset">
</FORM>
</body>
</html>
Lets discuss the code of above HTML form. As you can see in the <FORM> tag, the attribute
METHODis set to GET. The possible values for this attribute can be GET and POST. Now what
do these values mean?
Setting the method attribite to GET means that we want to send the HTTP request
using the GET method which will evantually activate the doGet() method of the
servlet. In the GET method the information in the input fields entered by the user, merges
with the URL as the query string and are visible to the user.
Setting METHOD value to POST hides the entered information from the user as this
information becomes the part of request body and activates doPost() method of the
servlet.
Attribute ACTION of<FROM>tag is set to http://localhost:8084/paramapp/formservlet.
The form data will be transmitted to this URL. paramapp is the name of web application
created using netBeans. formservlet
is the value of <url-pattern> defined in the web.xml.The code of web.xml is given at the
end.
The NAMEattribute is set to myform that helps when the same page has more than one
forms. However, here it is used only for demonstration purpose.
To create the text fields where user can enter data, following lines of code come into play
<INPUT TYPE = text NAME="firstName">
<INPUT TYPE = text NAME="surName">
Each text field is distinguished on the basis of name assigned to them. Later these
names also help in extracting the values entered into these text fields.
MyServlet.java
Now lets take a look at the servlet code to which HTML form data is submitted.
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
CopyrightVirtualUniversityofPakistan
Page275
WebDesignandDevelopment(CS506)
public class MyServlet extends HttpServlet
{
public void doGet(HttpServletRequest req, HttpServletResponse res)
throws ServletException, IOException
{
// reading first name parameter/textfield
String fName = req.getParameter(firstName);
// reading surname parameter/textfield
String sName = req.getParameter(surName);
// gettting stream from HttpServletResponse object
PrintWriter out = res.getWriter();
out.println("Hello: " + fName + " " + sName);
out.close();
}
}// end FormServlet
We started the code with importing three packages.
import java.io.*,
import javax.servlet.*;
import javax.servlet.http.*;
These packages are imported to have the access on PrintWriter, HttpServlet,
HttpServletRequest, HttpServletResponse, ServletException and IOException classes.
The class MySevlet extends from HttpServlet to inherit the HTTP specific functionality.
If you recall HTML code (index.html) discussed above, the value of mehtod attribute was
set to GET. So in this case, we only need to override doGet() Method.
Entering inside doGet()method brings the crux of the code. These are:
String fName = req.getParameter(firstName); String sName =
req.getParameter(surName);
Two String variables fNameand sNameare declared that receive String values returned by
getParameter() method. As discussed earlier, this method
returns String corresponds
to the form parameter. Note that the values of nameattributes of input tags used in index.html
have same case with the ones passed to getParameter() methods as parameters. The part of
HTML code is reproduced over here again:
<INPUT TYPE = text NAME="firstName">
<INPUT TYPE = text NAME="surName">
CopyrightVirtualUniversityofPakistan
Page276
WebDesignandDevelopment(CS506)
In the last part of the code, we get the object of PrintWriter stream from the object of
HttpServletResponse. This object will be used to send data back the response. Using PrintWriter
object (out), the names are printed with appended Hello that becomes visible in the browser.
web.xml
<?xml version="1.0" encoding="ISO-8859-1"?> <web-app>
<servlet>
<servlet-name> FormServlet </servlet-name>
<servlet-class> MyServlet </servlet-class> </servlet>
<servlet-mapping>
<servlet-name> FormServlet </servlet-name>
<url-pattern> /formservlet </url-pattern>
</servlet-mapping>
</web-app>
The <servlet-mapping> tag contains two tags <servlet-name> and
<urlpatteren> containing name and pattern of the URL respectively. Recall the value of action
attribute of the <form>element in the HTML page. You can see it is exactly the same as
mentioned in <url-pattern> tag.
http://localhost:8084/paramapp/formservlet
28.4 References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page277
WebDesignandDevelopment(CS506)
29.1.1 ServletConfig
Every Servlet has an object called ServletConfig associated with it as shown in the fig.
below. It contains relevant information about the Servlet like initialization parameters
defined in web.xml
CopyrightVirtualUniversityofPakistan
Page278
WebDesignandDevelopment(CS506)
to
read
initialization
Page279
WebDesignandDevelopment(CS506)
import javax.servlet.*;
import javax.servlet.http.*;
public class MyServlet extends HttpServlet {
// attribute used to store init-parameter value
String fileName;
// overriding init() method
public void init(ServletConfig config)
throws ServletException{
super.init(config);
// reading init-parameter logfilename stored in web.xml
fileName = config.getInitParameter("logfilename");
}
/*
Both doGet() & doPost() methods are override over here. processRequest() is called from both these
methods. This makes possible for a servlet to handle both POST and GET requests identically.
*/
// Handles the HTTP GET request type
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
processRequest(request, response);
}
// Handles the HTTP POST request type
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
processRequest(request, response);
}
// called from doGet() & doPost()
protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
PrintWriter out = response.getWriter();
// writing init-parameter value that is store in fileName
out.println(fileName);
out.close();
}
} // end MyServlet
web.xml
<?xml version="1.0" encoding="UTF-8"?> <web-app>
<servlet>
CopyrightVirtualUniversityofPakistan
Page280
WebDesignandDevelopment(CS506)
<servlet-name> MyServlet </servlet-name>
<servlet-class> MyServlet </servlet-class>
<init-param>
<param-name> logfilename </param-name>
<param-value> logoutput.txt </param-value> </init-param>
</servlet>
<servlet-mapping>
<servlet-name> MyServlet </servlet-name>
<url-pattern> /myservlet </url-pattern>
</servlet-mapping>
</web-app>
Page281
WebDesignandDevelopment(CS506)
Page282
WebDesignandDevelopment(CS506)
register.html
The user is redirected to this page in case of providing incorrect login/password information.
The user can enter user id, address and phone number here to register.
Note: The code given below will only show fields to the user. It does not register user as no
such functionality is added into this small example.
<html>
<body>
<h2>Your login is incorrect. Please register yourself</h2>
<FORM METHOD="POST" ACTION="" NAME="myForm">
<BR> Name:
<INPUT TYPE="text" NAME="userid"/>
<BR> Address:
<INPUT TYPE="text" NAME="address"/>
<BR> Phone No:
<INPUT TYPE="text" NAME="phoneno"/>
<BR> <BR>
<input type="submit" value="Register"/>
</FORM>
</body>
</html>
MyServlet.java
MyServlet.java accepts requests from login.html and redirects the user to welcome.html or
register.html based on the verification of username & password provided. Username &
password are compared with fix values in this example, however you can verify these from
database or from a text file etc.
import java.io.*;
import java.net.*;
import javax.servlet.*;
import javax.servlet.http.*;
public class MyServlet extends HttpServlet {
// Handles the HTTP GET request type
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
processRequest(request, response);
}
// Handles the HTTP POST request type
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
CopyrightVirtualUniversityofPakistan
Page283
WebDesignandDevelopment(CS506)
processRequest(request, response);
}
protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
String id = request.getParameter("userid");
String pwd = request.getParameter("pwd");
// comparing id & password with fix values
if(id.equals("ali") && pwd.equals("vu")) {
// redirectign user to welcome.html
response.sendRedirect("welcome.html");
}
else {
// redirecting user to register.html
response.sendRedirect("register.html");
/* if you want to display an error message to the
user, you can use the following method
response.sendError( response.SC_PROXY_AUTHENTICATION_REQUIRED, "Send Error Demo" );
*/
} // end else
}
29.2 ServletContext
ServletContext belongs to one web application. Therefore it can be used for sharing
resources among servlets in the same web application.
As initialization parameters, for a single servlet are stored in ServletConfig,
ServetContext can store initialization parameters for the entire web application. These
parameters are also called context attributes and exist for the lifetime of the application.
The following figure illustrates the sharing of context attributes among all the servlets
of a web application.
Servlet Context
Servlet1
<uses>
Servlet2
<uses>
<uses>
Context
Attributes
Note:
CopyrightVirtualUniversityofPakistan
Page284
WebDesignandDevelopment(CS506)
To clarify the concepts, lets take the help from following figure. User initates the request to
servlet1. servlet1 forwards the request to servlet2 by calling forward(request,
response). Finally a response is returned back to the user by servlet2.
HTTPResponse
Servlet2
Servlet1
Person
HTTPRequest
CopyrightVirtualUniversityofPakistan
Forward(request
,response)
Page285
WebDesignandDevelopment(CS506)
It will be more cleared from the following figure. User sends a HTTPRequest to Servlet1.
Serlet2 is called by Servlet1 by using include(request, response) method. The response
generated by Servlet2 sends back to Servlet1. Servlet1 can also add its own response content and
finally send it back to user.
HTTPResponse
Returnfrom
include
Servlet2
Person
HTTPRequest
Servlet1
include(request,
response)
29.6 References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page286
WebDesignandDevelopment(CS506)
Lecture 30: Dispatching Requests
In this handout we will start with request dispatching techniques and give some examples related
to that. Further more some methods of HttpResponse and HttpRequest will also be discussed.
Finally, this handout will be concluded by discussing the importance of session racking. Before
starting, lets take a look at the summery of the previous lecture.
30.1 Recap
In the previous lecture we had some discussion about Response Redirection and Request
Dispatcher. We said that Response Redirection was used to redirect response of the Servlet to
another application resource. This resource might be another Servlet or any JSP page.
Two forms of Response redirection were discussed. These were:
30.1.1 Sending a standard request:
Using response.sendRedirect(path of resource) method, a new request is generated which
redirects the user to the given URL. If the URL is of another servlet, that second servlet will not
be able to access the original request object.
30.1.2 Redirection to an error page:
An error code is passed as a parameter along with message to response.sendError(int, msg)
method. This method redirects the user to the particular error page in case of occurrence of
specified error.
Similarly request dispatching provides us the facility to forward the request processing to another
servlet, or to include the output of another resource (servlet, JSP or HTML etc) in the response.
Unlike Response Redirection, request object of calling resource is available to called resource.
The two ways of Request Dispatching are:
30.1.3 Forward:
Forwards the responsibility of request processing to another resource.
30.1.4 Include:
Allows a servlet to include the results of another resource in its response. So unlike forward, the
first servlet to receive the request is the one which finishes the response.
CopyrightVirtualUniversityofPakistan
Page287
WebDesignandDevelopment(CS506)
Lets start with the example of include. We will see how a Servlet includes the output of another
resource in its response. The following example includes a calling Servlet MyServlet and Servlet
IncludeServlet, whos output will be included in the calling Servlet.
The code of MyServlet.java servlet is given below.
MyServlet.java
import java.io.*;
import java.net.*;
import javax.servlet.*;
import javax.servlet.http.*;
public class MyServlet extends HttpServlet {
/* this method is being called by both doGet() and doPost().We usually follow this practice, when we
are not sure about the type of incoming request to the servlet. So the actual processing is being done in
the processRequest().
*/
protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html");
PrintWriter out = response.getWriter();
out.println("<html>");
out.println("<body>");
out.println("<h1>Start of include request </h1>");
out.flush();
// getting the object of ServletContext, that will be used to
// obtain the object of RequestDispacther
ServletContext context = getServletContext();
// getting the object of RequestDispatcher by passing the path
// of included resource as a parameter
RequestDispatcher rd = context.getRequestDispatcher("/includeservlet");
// calling include method of RequestDispatcher by passing
// request and response objects as parameters. This will execute
//the second servlet and include its output in the first servlet
rd.include(request, response);
/* the statements below will be executed after including the output of the /includeservlet */
out.println("<h1>End of include request </h1>");
out.println("</body>");
out.println("</html>");
CopyrightVirtualUniversityofPakistan
Page288
WebDesignandDevelopment(CS506)
// closing PrintWriter stream out.close();
}
// This method only calls processRequest()
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws
ServletException, IOException {
processRequest(request, response);
}
// This method only calls processRequest()
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws
ServletException, IOException {
processRequest(request, response);
}
} // end MyServlet
Include Servlet
Now lets take a look at the code of IncludeServlet.java
import java.io.*;
import java.net.*;
import javax.servlet.*;
import javax.servlet.http.*;
public class IncludeServlet extends HttpServlet {
// this method is being called by both doGet() and doPost()
protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
// Obtaining the object of PrintWriter, this will return the
// same PrintWriter object we have in MyServlet
PrintWriter out = response.getWriter();
// Including a HTML tag using PrintWriter
out.println("<h1> <marquee>I am included </marquee></h1>");
}
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
processRequest(request, response);
}
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
processRequest(request, response);
}
CopyrightVirtualUniversityofPakistan
Page289
WebDesignandDevelopment(CS506)
} // end IncludeServlet
In the processRequest(), firstly we get the PrintWriter stream from the
HttpServletResponse object. Then we include an HTML tag to the output of the calling servlet.
One thing that must be considered is that PrintWriter stream is not closed in the end, because it is
the same stream that is being used in the calling servlet and this stream may also be used in the
calling servlet again. So, if it is closed over here, it can not be used again in the calling servlet.
web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app>
<servlet>
<servlet-name>MyServlet</servlet-name>
<servlet-class>MyServlet</servlet-class>
</servlet>
<servlet>
<servlet-name>IncludeServlet</servlet-name>
<servlet-class>IncludeServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>MyServlet</servlet-name>
<url-pattern>/myservlet</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>IncludeServlet</servlet-name>
<url-pattern>/includeservlet</url-pattern>
</servlet-mapping>
</web-app>
Code Example: Request Dispatcher forward
As discussed earlier, we can forward the request processing to another resource using forward
method of request dispatcher. In this example, the user enters his/her name and salary on the
index.htmland submits the form to FirstServlet,which calculates the tax on salary and forwards
the request to another servlet for further processing i.e. SecondServlet.
index.html
<html>
<body>
<form method="POST" ACTION = firstservlet" NAME="myForm">
<h2> Enter your name</h2>
<INPUT TYPE="text" name="name"/>
<br/>
<h2> Salary</h2>
<INPUT TYPE="text" name="salary"/>
CopyrightVirtualUniversityofPakistan
Page290
WebDesignandDevelopment(CS506)
<BR/><BR/>
<INPUT type="submit" value="Submit"/>
</form>
</body>
</html>
FirstServlet.java
import java.io.*;
import java.net.*;
import javax.servlet.*;
import javax.servlet.http.*;
public class FirstServlet extends HttpServlet {
// this method is being called by both doGet() and doPost()
protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
// getting value of salary text filed of the HTML form
String salary = request.getParameter("salary");
// converting it to the integer.
int sal = Integer.parseInt(salary);
// calculating 15% tax
int tax = (int)(sal * 0.15);
// converting tax into string
String taxValue = tax + "";
// request object can store values in key-value form, later it
// can be retrieved by using getAttribute() method
request.setAttribute("tax", taxValue);
// getting object of servletContext
ServletContext sContext = getServletContext();
// getting object of request dispatcher
RequestDispatcher rd = sContext.getRequestDispatcher("/secondservlet");
// calling forward method of request dispatcher
rd.forward(request, response);
}
// This method is calling processRequest()
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
processRequest(request, response);
}
// This method is calling processRequest()
CopyrightVirtualUniversityofPakistan
Page291
WebDesignandDevelopment(CS506)
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
processRequest(request, response);
}
}
Note: It the case of Forward, it is illegal to make the reference of PrintWriter stream in the
calling Servlet. Only the called resource can use PrintWriter stream to generate response
SecondServlet.java
import java.io.*;
import java.net.*;
import javax.servlet.*;
import javax.servlet.http.*;
public class SecondServlet extends HttpServlet {
// this method is being called by both doGet() and doPost()
protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html");
PrintWriter out = response.getWriter();
// obtaining values of name and salary text fields of index.html
String name = request.getParameter("name");
String salary = request.getParameter("salary");
/* getting attribute value that has been set by the calling servlet i.e. FirstServlet */
String tax = (String)request.getAttribute("tax");
// generating HTML tags using PrintWriter
out.println("<html>");
out.println("<head>");
out.println("<title>SecondServlet</title>");
out.println("</head>");
out.println("<body>");
out.println("<h1> Welcome " + name+ "</h1>");
out.println("<h3> Salary " + salary+ "</h3>");
out.println("<h3> Tax " + tax+ "</h3>");
out.println("</body>");
out.println("</html>");
out.close();
}
// This method is calling processRequest()
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
CopyrightVirtualUniversityofPakistan
Page292
WebDesignandDevelopment(CS506)
processRequest(request, response);
}
// This method is calling processRequest()
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
processRequest(request, response);
}
}
web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app>
<servlet>
<servlet-name>FirstServlet</servlet-name>
<servlet-class>FirstServlet</servlet-class>
</servlet>
<servlet>
<servlet-name>SecondServlet</servlet-name>
<servlet-class>SecondServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>FirstServlet</servlet-name>
<url-pattern>/firstservlet</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>SecondServlet</servlet-name>
<url-pattern>/secondservlet</url-pattern>
</servlet-mapping>
</web-app>
Page293
WebDesignandDevelopment(CS506)
30.2.2 getAttribute(String)
The objects set by the setAttribute() method can be accessed using getAttribute() method.
Passing the key in the form of string as a parameter to this method will return the object
associated with that particular key in the context. Cast the object into its appropriate type.
30.2.3 getMethod()
This method returns the name of HTTP method which was used to send the request. The
two possible returning values could be, get or post.
30.2.4 getRequestURL()
It can be used to track the source of Request. It returns the part of the requests URL with
out query string.
30.2.5 getProtocol()
It returns the name and version of the protocol used.
30.2.6 getHeaderNames()
It returns the enumeration of all available header names that are contained in the request.
30.2.7 getHearderName()
It takes a String parameter that represents the header name and returns that appropriate header.
Null value is returned if there is no header exists with the specified name.
30.3 HttpServletResponse Methods
Lets discuss some methods of HttpServletResponseclass
30.3.1 setContentType()
Almost every Servlet uses this header. It is used before getting the PrintWriter Stream. It is used
to set the Content Type that the PrintWriter is going to use. Usually we set text/html, when we
want to send text output or generate HTML tags on the clients browser.
30.3.2 setContentLength()
This method is used to set the content length. It takes length as an integer parameter.
30.3.3 addCookie()
This method is used to add a value to the Set-Cookie header. It takes a Cookie object as a
parameter and adds it to the Cookie-header. We will talk more about Cookies in the session
CopyrightVirtualUniversityofPakistan
Page294
WebDesignandDevelopment(CS506)
tracking part.
30.3.4 sendRedirect()
This method redirects the user to the specific URL. This method also accepts the relative URL. It
takes URL string as parameter and redirects the user to that resource.
30.4 Session Tracking
Many applications require a series of requests from the same client to be associated withone
another. For example, any online shopping application saves the state of a user's shopping cart
across multiple requests. Web-based applications are responsible for maintaining such state,
because HTTP protocol is stateless. To support applications that need to maintain state, Java
Servlet technology provides an API for managing sessions and allows several mechanisms for
implementing sessions.
Before looking inside the session tracking mechanism lets see the limitation of HTTP protocol to
get the real picture of problems that can happen with out maintaining thesession.
30.4.1 Continuity problem- users point of view
Server State
Page 1
Added book
to cart
Added book
to cart
Page 2
Page 3
CC#= XXX
Billing
address
Order
submitted
and logged
Page 4
Suppose a user logs on to the online bookshop, selects some books and adds them to his cart. He
CopyrightVirtualUniversityofPakistan
Page295
WebDesignandDevelopment(CS506)
enters his billing address and finally submits the order. HTTP cannot track session as it is
stateless in nature and user thinks that the choices made on page1 are remembered on page3.
30.4.2 Continuity problem- Servers point of view
Request1
PC1
Request2
PC2
PC3
PC4
The server has a very different point of view. It considers each request independent from other
even if the requests are made by the same client.
30.5 References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page296
WebDesignandDevelopment(CS506)
Page297
WebDesignandDevelopment(CS506)
2. URL Rewriting
3. Hidden Fields
31.3.1 Cookies
31.3.1.1 What a cookie is?
Dont be tempted? These are not, what you might be thinking off. In fact, in computer
terminology, a cookie is a piece of text that a web server can store on a clients(user)hard disk.
Cookies allow the web sites to store information on a client machine and later retrieve it. The pieces
of information are stored as name-value pair on the client. Later while reconnecting to the same site
(or same domain depending upon the cookie settings), client returns the same name-value pair to
the server.
Page298
WebDesignandDevelopment(CS506)
customizing a site. For example, you might like email-inbox in a different look form
others. This sort of information can be stored in the form of cookies on your machine and
latter can be used to format inbox according to your choice.
Focused Advertising. For example, a web site can store information in the form of
cookies about the kinds of books, you mostly hunt for.
Page299
WebDesignandDevelopment(CS506)
To read the cookies that come back from the client, following steps are generally followed.
1. Reading incoming cookies
To read incoming cookies, get them
HttpServeltRequestby calling following method
from
the request
object
of
the
Page300
WebDesignandDevelopment(CS506)
import java.io.*;
import java.net.*;
import javax.servlet.*;
import javax.servlet.http.*;
public class RepeatVisitorServlet extends HttpServlet {
// Handles the HTTP <code>GET</code> method.
protected void doGet(HttpServletRequest request,HttpServletResponse response)
throws ServletException, IOException
{
processRequest(request, response);
}
// Handles the HTTP <code>POST</code> method.
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
processRequest(request, response);
}
// called from both doGet() & doPost()
protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
response.setContentType("text/html");
PrintWriter out = response.getWriter();
// writing html
out.println("<html>");
out.println("<body>");
out.println("<h2>Cookie Example </h2>");
String msg = "";
boolean repeatVisitor = false;
// reading cookies
Cookie[] cookies = request.getCookies();
// if cookies are returned from request object
if (cookies != null) {
//search for cookie -- repeat
for (int i = 0; i < cookies.length; i++) {
// retrieving one cookie out of array
Cookie c = cookies[i];
// retrieving name & value of the cookie
String name = c.getName();
String val = c.getValue();
// confirming if cookie name equals repeat and
// value equals yes
if( name.equals("repeat") && val.equals("yes"))
{
msg= "Welcome Back"; repeatVisitor = true; break;
}
CopyrightVirtualUniversityofPakistan
Page301
WebDesignandDevelopment(CS506)
} // end for
} // end if
// if no cookie with name repeat is found
if (repeatVisitor == false)
{
// create a new cookie
Cookie c1 = new Cookie("repeat", "yes");
// setting time after which cookies expires
c1.setMaxAge(60);
// adding cookie to the response
response.addCookie(c1);
msg = "Welcome Aboard";
}
// displaying message value out.println("<h2>" + msg + "</h2>");
out.println("</body>");
out.println("</html>");
out.close();
}
}// end RepeatVisitorServlet
web.xml
<?xml version="1.0" encoding="UTF-8"?> <web-app>
<servlet>
<servlet-name> RepeatVisitorServlet </servlet-name>
<servlet-class> RepeatVisitorServlet </servlet-class> </servlet>
<servlet-mapping>
<servlet-name> RepeatVisitorServlet </servlet-name>
<url-pattern> /repeatexample </url-pattern>
</servlet-mapping>
</web-app>
Output
On first time visiting this URL, an output similar to the one given below would be displayed
Welcome Abroad - Netscape
File Edit View Bookmarks Tools
window
Help
http://localhost/302ervlet/coreservlets.RequestVisitor
Go
Welcome Abroad
On refreshing this page or revisiting it within an hour (since the age of cookie was set to 60 mins),
following output should be expected.
Welcome Abroad - Netscape
File Edit View Bookmarks Tools
window
Help
http://localhost/302ervlet/coreservlets.RequestVisitor
Welcome Back
CopyrightVirtualUniversityofPakistan
Go
Page302
WebDesignandDevelopment(CS506)
Example Code2: Online Book Store using cookies
A scale down version of online book store is going to be built using cookies. For the first time,
cookies will be used to maintain the session.
Three books will be displayed to the user along with check boxes. User can select any check box
to add the book in the shopping cart. The heart of the application is, it remembers the books
previously selected by the user.
The following figure will help you understand the theme of this example. Books displayed
under the heading of You have selected the following books were added to cart one after
another. The important thing is server that remembers the previously added books by the
same user and thus maintains the session. Session management is accomplished using
cookies.
AddtoCart
Page303
WebDesignandDevelopment(CS506)
import java.net.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;
public class ShoppingCartServlet extends HttpServlet {
// used to generate a unique value which is
// used as a cookie value
public static int S_ID = 1;
// used to store HashMaps of indiviual users
public static HashMap<String, HashMap> globalMap =<String, HashMap> new HashMap();
// Handles the HTTP GET method.
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
processRequest(request, response);
}
// Handles the HTTP <code>POST</code> method.
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
processRequest(request, response);
}
// called from both doGet() & doPost()
protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html;charset=UTF-8");
// declaring user's HashMap
HashMap<String, String> sessionInfo = null;
String sID = "";
// method findCookie is used to determine whether browser
// has send any cookie named "JSESSIONID"
Cookie c = findCookie(request);
// if no cookies named "JSESSIONID" is recieved, means that
// user is visiting the site for the first time.
if (c == null) {
// make a unique string
sID = makeUniqueString();
// creating a HashMap where books selected by the
// user will be stored
sessionInfo = new HashMap<String, String>();
// add the user's HashMap (sessionInfo) into the
// globalMap against unique string i.e. sID
CopyrightVirtualUniversityofPakistan
Page304
WebDesignandDevelopment(CS506)
globalMap.put(sID, sessionInfo);
// create a cookie named "JSESSIONID" alongwith
// value of sID i.e. unique string
Cookie sessionCookie = new Cookie("JSESSIONID", sID);
// add the cookie to the response
response.addCookie(sessionCookie);
} else {
// if cookie is found named "JSESSIONID",
// retrieve a HashMap from the globalMap against
// cookie value i.e. unique string which is your
//sessionID
sessionInfo = (HashMap<String, String>) globalMap.get(
c.getValue() );
}
PrintWriter out = response.getWriter();
out.println("<html>");
out.println("<head>");
out.println("<title>Shooping Cart Example</title>");
out.println("</head>");
out.println("<body>");
out.println("<h1>Online Book Store</h1>");
String url = "http://localhost:8084/cookiesessionex/shoppingcartex";
// user will submit the from to the same servlet out.println("<form action=" + url +">" +
"<h3><input type=checkbox name=firstCB value=firstCB />" +
" java core servlts</h3>" + "<br>"+
<h3><input type=checkbox name=secondCB value=secondCB />" + " java how to program</h3>" +
"<br>"+
"<h3><input type=checkbox name=thirdCB value=thirdCB />" + " java complete reference</h3>" +
"<br>"+
"<input type=submit value=\"Add to Cart\" />" + "</from>"
);
out.println("<br/>");
out.println("<h1>You have selected followig books</h1>");
out.println("<br/>");
//reteriving params of check boxes
CopyrightVirtualUniversityofPakistan
Page305
WebDesignandDevelopment(CS506)
String fBook = request.getParameter("firstCB");
String sBook = request.getParameter("secondCB"); String tBook = request.getParameter("thirdCB");
// if first book is selected then add it to
// user's HashMap i.e. sessionInfo
if ( fBook != null && fBook.equals("firstCB") ) {
sessionInfo.put("firstCB", "java core servlets");
}
// if second book is selected then add it to
// user's HashMap i.e. sessionInfo
if (sBook != null && sBook.equals("secondCB")){
sessionInfo.put("secondCB", "java how to program");
}
// if third book is selected then add it to
// user's HashMap i.e. sessionInfo
if (tBook != null && tBook.equals("thirdCB")){
sessionInfo.put("thirdCB", "java complete reference");
}
// used to display the books currently stored in
// the user's HashMap i.e. sessionInfo printSessionInfo(out, sessionInfo); out.println("</body>");
out.println("</html>");
out.close();
}
// end processRequest()
// method used to generate a unique string
public String makeUniqueString(){
return "ABC" + S_ID++;
}
// returns a reference global HashMap.
public static HashMap findTableStoringSessions(){
return globalMap;
}
// method used to find a cookie named "JSESSIONID" public Cookie findCookie(HttpServletRequest
request){
Cookie[] cookies = request.getCookies();
if (cookies != null) {
for(int i=0; i<cookies.length; i++) { Cookie c = cookies[i];
if (c.getName().equals("JSESSIONID")){
// doSomethingWith cookie
return c;
}
}
}
return null;
CopyrightVirtualUniversityofPakistan
Page306
WebDesignandDevelopment(CS506)
}
// used to print the books currently stored in
// user's HashMap. i.e. sessionInfo
public void printSessionInfo(PrintWriter out,
HashMap sessionInfo)
{
String title = "";
title= (String)sessionInfo.get("firstCB");
if (title != null){
out.println("<h3> "+ title +"</h3>");
}
title= (String)sessionInfo.get("secondCB");
if (title != null){
out.println("<h3> "+ title +"</h3>");
}
title= (String)sessionInfo.get("thirdCB");
if (title != null){
out.println("<h3> "+ title +"</h3>");
}
}
} // end ShoppingCartServlet
web.xml
<?xml version="1.0" encoding="UTF-8"?> <web-app>
<servlet>
<servlet-name> ShoppingCart </servlet-name>
<servlet-class> ShoppingCartServlet </servlet-class> </servlet>
<servlet-mapping>
<servlet-name> ShoppingCart </servlet-name>
<url-pattern> /shoppingcartex </url-pattern> </servlet- mapping>
</web-app>
31.4 References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page307
WebDesignandDevelopment(CS506)
Note: Due to limited space available in rewriting a URL, the extra information is usually limited to a
unique session ID.
The following URLs have been rewritten to pass the session ID 123
What if the user bookmarks the page and the problem get worse if server is not
assigning a unique session id.
Every URL on a page, which needs the session information, must be rewritten
each time page is served, which can cause
o Computationally expensive
o Can increase communication overhead
CopyrightVirtualUniversityofPakistan
Page308
WebDesignandDevelopment(CS506)
Page309
WebDesignandDevelopment(CS506)
import java.util.*;
public class URLRewriteServlet extends HttpServlet {
// used to generate a unique value which is
// used as a cookie value
public static int S_ID = 1;
// used to store HashMaps of indiviual users
public static HashMap<String, HashMap> globalMap = new HashMap<String, HashMap>();
// Handles the HTTP GET method.
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
processRequest(request, response);
}
// Handles the HTTP <code>POST</code> method.
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
processRequest(request, response);
}
// called from both doGet() & doPost()
protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
// declaring user's HashMap
HashMap<String, String> sessionInfo = null;
// reading sessionId
String sID = request.getParameter(JSESSIONID);
/* if parameter JSESSIONID is received, means that user is visiting the site for the first time. */
if (sID == null)
{
// make a unique string
sID = makeUniqueString();
// creating a HashMap where books selected by the
// user will be stored
sessionInfo = new HashMap<String, String>();
// add the user's HashMap (sessionInfo) into the
// globalMap against unique string i.e. sID
globalMap.put(sID, sessionInfo);
}else {
// if parameter "JSESSIONID" has some value
CopyrightVirtualUniversityofPakistan
Page310
WebDesignandDevelopment(CS506)
// retrieve a HashMap from the globalMap against
// sID i.e. unique string which is your sessionID
sessionInfo = (HashMap<String, String>) globalMap.get(sID);
}
response.setContentType("text/html;charset=UTF-8");
PrintWriter out = response.getWriter();
out.println("<html>");
out.println("<head>");
out.println("<title>Shopping Cart Example</title>");
out.println("</head>");
out.println("<body>");
out.println("<h1>Online Book Store</h1>");
// Making three URLS by using query string mechanism
// The attributes/parameters are JSSESSIONID and book name (like
// firstCB) along with values sID and book name respectively
String firsturl = "http://localhost:8084/urlbookstore/urlrewriteservlet?JSESSIONID= " + sID
+ "&firstCB=firstCB";
String secondurl = "http://localhost:8084/urlbookstore/urlrewriteservlet?JSESSIONID= " +
sID + "&secondCB=secondCB";
out.println("<h3><a href=" + firsturl + ">" + " java core servlts </a> </h3>" + "<br>" "<h3><a
href=" + secondurl + ">" + " java how to program </a> </h3>" + "<br>" );
out.println("<br/>");
out.println("<h1>You have selected following books</h1>");
out.println("<br/>");
//retrieving params that are emebded in URLs
String fBook = request.getParameter("firstCB"); String sBook = request.getParameter("secondCB");
// if first book is selected then add it to
// user's HashMap i.e. sessionInfo
if ( fBook != null && fBook.equals("firstCB") ) {
sessionInfo.put("firstCB", "java core servlets");
}
// if second book is selected then add it to
// user's HashMap i.e. sessionInfo
if (sBook != null && sBook.equals("secondCB")){
sessionInfo.put("secondCB", "java how to program");
}
// used to display the books currently stored in
// the user's HashMap i.e. sessionInfo printSessionInfo(out, sessionInfo);
out.println("</body>");
CopyrightVirtualUniversityofPakistan
Page311
WebDesignandDevelopment(CS506)
out.println("</html>");
out.close();
} // end processRequest()
// method used to generate a unique string
public String makeUniqueString(){
return "ABC" + S_ID++;
}
// returns a reference global HashMap.
public static HashMap findTableStoringSessions(){
return globalMap;
}
// used to print the books currently stored in
// user's HashMap. i.e. sessionInfo
public void printSessionInfo(PrintWriter out, HashMap sessionInfo)
{
String title = "";
title= (String)sessionInfo.get("firstCB");
if (title != null){
out.println("<h3> "+ title +"</h3>");
}
title= (String)sessionInfo.get("secondCB");
if (title != null){
out.println("<h3> "+ title +"</h3>");
}
}
} // end URLRewriteServlet
web.xml
<?xml version="1.0" encoding="UTF-8"?> <web-app>
<servlet>
<servlet-name> URLRewriteServlet </servlet-name>
<servlet-class> URLRewriteServlet </servlet-class>
</servlet>
<servlet-mapping>
<servlet-name> URLRewriteServlet </servlet-name>
<url-pattern> /urlrewriteservlet </url-pattern>
</servlet-mapping>
</web-app>
CopyrightVirtualUniversityofPakistan
Page312
WebDesignandDevelopment(CS506)
4591077290203>
<inputtype=hiddenname=colidvalue=>
<inputtype=hiddenname=templatenamevalue=>
<inputtype=hiddenname=storenamevalue=gateway>
<inputtype=hiddenname=mawvalue=1>
<inputtype=hiddenname=coliidvalue=>
<inputtype=hiddenname=dropdownselectionvalue=defaultaddress>
<tableborder=0width=100%cellspacing=0cellpadding=6>
In the above figure you can see the use of Hidden form fields for storing particular
information.
32.3 Java Solution for Session Tracking
Java provides an excellent solution to all the problems that occurred in tracking a session. The
Servlet API provides several methods and classes specifically designed to handle session
tracking. In other words, servlets have built in session tracking.
Sessions are represented by an HttpSession object. HttpSession tacking API built on
top of URL rewriting and cookies. All cookies and URL rewriting mechanism is hidden
and most application server uses cookies but automatically revert to URL
rewriting when cookies are unsupported or explicitly disabled. Using HttpSession API
in servlets is straightforward and involves looking up the session object associated with the
current request, creating new session object when necessary, looking up information
associated with a session, storing information in a session, and discarding completed or
abandoned sessions.
CopyrightVirtualUniversityofPakistan
Page313
WebDesignandDevelopment(CS506)
32.4 Working with HttpSession
Lets have a look on HttpSession working step by
step.
method
To store information in Session object (sess),
we use setAttribute()
HashMap, so it is able to store
of HttpSession class. Session object works like a
any java object against key. So you can store number of keys and their values in pair form. For
example,
sess.setAttribute(sessionid, 123);
3. Looking up information associated with a Session
To retrieve back the stored information from session object, getAttribute()method of
HttpSession class is used. For example,
String sid=(String)sess.getAttribute(sessionid);
Note: - getAttribute() method returns Object type, so typecast is required.
CopyrightVirtualUniversityofPakistan
Page314
WebDesignandDevelopment(CS506)
4. Terminating a Session
After the amount of time, session gets terminated automatically. We can see its
maximum activation time by using getMaxInactiveInterval() method of HttpSession class.
However, we can also terminate any existing session manually. For this, we
need to call invalidate () method of HttpSession class as shown below.
sess.invalidate()
Example Code: Showing Session Information
To understand HttpSessionAPI properly we need to have a look on an example. In this
example, we will get the session object and check whether it is a new user or not. If the
user is visiting for the first time, we will print Welcome and if we find the old one,
well print Welcome Back. Moreover, we will print the session information and count
the number of accesses for every user
import java.io.*;
import java.net.*;
import javax.servlet.*;
import javax.servlet.http.*;
public class ShowSessionServlet extends HttpServlet {
// Handles the HTTP <code>GET</code> method.
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
processRequest(request, response);
}
// Handles the HTTP <code>POST</code> method.
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
processRequest(request, response);
}
// called from both doGet() & doPost()
protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
// used for displaying message (like Welcomem, Newcomer) to
// user
CopyrightVirtualUniversityofPakistan
Page315
WebDesignandDevelopment(CS506)
String heading;
response.setContentType("text/html");
// Getting session object
HttpSession session = request.getSession(true);
/* Getting stored information using getAttribute() method */
Integer accessCount = (Integer)session.getAttribute("sessionCount");
/* If user comes for the first time, accessCount will be assigned null, so we can guess easily that this
a new user */
if (accessCount == null)
{
accessCount = new Integer(1);
heading = "Welcome, Newcomer";
} else
{
heading = "Welcome Back";
// Incrementing the value
accessCount = new Integer(accessCount.intValue() + 1);
}
/* Storing the new value of accessCount in the session using setAttribute() method */
session.setAttribute("sessionCount", accessCount);
// Getting the PrintWriter
PrintWriter out = response.getWriter();
/*Generating HTML tags using PrintWriter to print session info and no of times this user has
accessed this page */
out.println("<HTML>" +
" <BODY>" +
" <h1>Session Tracking Example</h1>" +
" <H2>Information on Your Session:</H2>\n" +
" <H3> Session ID: " + session.getId() + "</H3>" +
" <H3>Number of Previous Accesses: " + accessCount +
" </H3>" +
" </BODY>" + " </HTML>"
);
//Closing the PrintWriter stream
out.close();
} // end processRequest
} // end ShowSessionServlet class
web.xml
CopyrightVirtualUniversityofPakistan
Page316
WebDesignandDevelopment(CS506)
<?xml version="1.0" encoding="UTF-8"?>
<web-app>
<servlet>
<servlet-name> ShowSession </servlet-name>
<servlet-class> ShowSessionServlet </servlet-class>
</servlet>
<servlet-mapping>
<servlet-name> ShowSession </servlet-name>
<url-pattern> /showsession </url-pattern>
</servlet-mapping>
</web-app>
CopyrightVirtualUniversityofPakistan
Page317
WebDesignandDevelopment(CS506)
32.7 Difference between encodeURL() and encodeRedirectURL()
encodeURL() is used for URLs that are embedded in the webpage, that the servlet generates. For
example,
String URL = /servlet/sessiontracker; String eURL =
response.encodeURL(URL); out.println(<A HREF=\ + eURL
+ \ > </A>);
Whereas encodeRedirectURL() is used for URLs that refers yours site is in
sendRedirect() call. For example,
String URL = /servlet/sessiontracker;
String
eURL
=
Response.sendRedirect(eURL);
response.encodeRedirectURL(URL);
Page318
WebDesignandDevelopment(CS506)
throws ServletException, IOException {
response.setContentType("text/html;charset=UTF-8");
HttpSession session = request.getSession(true);
PrintWriter out = response.getWriter();
out.println("<html>");
out.println("<head>");
out.println("<title>Shopping Cart Example</title>");
out.println("</head>");
out.println("<body>");
out.println("<h1>Online Book Store</h1>");
// First URL built using query string, representing first book
String firstURL = "http://localhost:8084/urlrewritebookstore/shoppingcart?book=firs t";
// Second URL built using query string, representing second book
// Note that parameter name is still book, so that later we need
// to read only this parameter
String secondURL = "http://localhost:8084/urlrewritebookstore/shoppingcart?book=seco nd";
// Encoding URLs
String eURL1 = response.encodeURL( firstURL );
String eURL2 = response.encodeURL( secondURL );
out.println(
"<h3><a href=" + eURL1 + ">" +
" java core servlets </a> </h3>" + "<br>"+
"<h3><a href=" + eURL2 + ">" +
" java How to Program </a> </h3>"
);
out.println("<br/>");
out.println("<h1>You have selected following books</h1>");
out.println("<br/>");
//retrieving params that are emebded in URLs
String fBook = request.getParameter("firstCB");
String sBook = request.getParameter("secondCB");
out.println("<br/>");
out.println("<h1>You have selected following books</h1>");
out.println("<br/>");
//retrieving param that is embedded into URL
String book = request.getParameter("book");
if (book != null){
// if firstURL, value of first hyperlink is clicked
// then storing the book into session object against fBook
if (book.equals("first")){
session.setAttribute("fBook", "java core servlets");
}
// if secondURL, value of second hyperlink is clicked
CopyrightVirtualUniversityofPakistan
Page319
WebDesignandDevelopment(CS506)
// then storing the book into session object against sBook
else if(book.equals("second")){
session.setAttribute("sBook", "java how to program");
}
}//outer if ends
// used to display the books currently stored in
// the HttpSession object i.e. session
printSessionInfo(out, session);
out.println("</body>");
out.println("</html>"); out.close();
} // end processRequest()
// used to display values stored in HttpSession object
public void printSessionInfo(PrintWriter out, HttpSession session)
{
String title = "";
// reading value against key fBook from session,
// if exist displays it
title= (String)session.getAttribute("fBook");
if (title != null){
out.println("<h3> "+ title +"</h3>");
}
// reading value against key sBook from session,
// if exist displays it
title= (String)session.getAttribute("sBook");
if (title != null){
out.println("<h3> "+ title +"</h3>");
}
} // end printSessionInfo
} // end ShoppingCartServlet
web.xml
<?xml version="1.0" encoding="UTF-8"?> <web-app>
<servlet>
<servlet-name> ShoppingCartServlet </servlet-name>
<servlet-class> ShoppingCartServlet </servlet-class>
</servlet>
<servlet-mapping>
<servlet-name> ShoppingCartServlet </servlet-name>
<url-pattern> /shoppingcart </url-pattern>
CopyrightVirtualUniversityofPakistan
Page320
WebDesignandDevelopment(CS506)
</servlet-mapping>
</web-app>
removeAttribute(String)
o
getId( )
o
getCreationTime( )
o This method returns time at which session was first created
getMaxInactiveInterval( ) , setMaxInactiveInterval(int)
o To get or set the amount of time session should go without access before being
invalidated.
32.9 References:
CopyrightVirtualUniversityofPakistan
Page321
WebDesignandDevelopment(CS506)
Lecture 33: Address Book Case Study Using Servlets
Users
Presentationlayers
BusinessLayers
DataLayers
DataSources
Services
Presentation Layer
o
o
Provides a user interface for client to interact with application. This is the only
Part of application visible to client.
Business Layer
o
The business or service layer implements the actual business logic or functionality
of the application. For example in case of online shopping systems this layer
Handles transaction management.
CopyrightVirtualUniversityofPakistan
Page322
WebDesignandDevelopment(CS506)
Data Layer
o This layer consists of objects that represent real-world business objects such as an
Order, OrderLineItem, Product, and so on. It also encapsulates classes which are
used to interact with the data providing services such as databases, other
web services etc.
In our case study of address book, we will also try to make use of the
layered architecture. We will create a separate layer for working with data, and our
presentation and business logic will be merged into servlets. It means that we will not
have separate layers for presentation and business rather one layer (formed by servlets)
will do the job of both presentation and business logic. The extent to which you divide
your application into layers depends upon the size of the application and some other
factors such as scalability, portability etc.
33.2.1 Step 1
Person : Table
Name
Address
Saad
Model town
Usman
Defence
Ali
Gulberg
*
Record
I< <
phoneNum
437546
6342211
9201211
> >I Of 3
33.2.2 Step 2
The next step is to create a class that can hold the information of a single person.
Remember we have stored the information in the database, now when we extract this
information from the database as a result of some search, we will require some object to
store the data for that particular person. The PersonInfo class will be used at that point
to store the retrieved data and transport it to presentation layer. Also we extend this
application and add the functionality of AddingNewContacts in the database.
The PersonInfoclass can be used to transport data from front end to the database.
Make a PersonInfoclass with the following consideration
It has three three attributes: name, address, ph.
CopyrightVirtualUniversityofPakistan
Page323
WebDesignandDevelopment(CS506)
No.
It has a parameterized constructor which takes in the above mentioned parameters Override
the
toString()method:
//File: PersonInfo.java
public class PersonInfo {
String name;
String address;
String phoneNum;
public PersonInfo(String n, String a, String pn) {
name = n;
address = a;
phoneNum = pn;
}
public String toString( ){
return "Name: " + name + " Address: " + address + " Phone No: " + phoneNum;
}
}// end class PersonInfo
Note: To keep the code simple, attributes (name, address & phoneNum) are not
declared as private, which is indeed not a good programming approach.
33.2.3 Step 3
Now we will create a class that will be used to interact with the database for the search, insert,
update and delete operations. We will call it PersonDAOwhere DAO stands for the data access
object. The PersonDAO along with the PersonInfo class forms the data layer of our
application. As you can see that these two classes do not contain any code related to
presentation or business logic (There is not much of business logic in this application
anyway). So PersonDAOalong with PersonInfois used to retrieve and store data in this
application. If at some stage we choose to use some other way of storing data (e.g. files) only
the PersonDAO class will change and nothing else, which is a sign of better design as
compared to a design in which we put everything in a single class.
So, Make a PersonDAOclass which contains:
A searchPerson(String name)method that first establishes a connection to the
database and returns PersonInfo object after searching the information of
the specified person from the
database.
//File: PersonDAO.java
import java.sql.*;
CopyrightVirtualUniversityofPakistan
Page324
WebDesignandDevelopment(CS506)
public class PersonDAO {
// method searchPerson
public PersonInfo searchPerson(String sName){
PersonInfo person = null;
try {
Class.forName("sun.jdbc.odbc.JdbcOdbcDriver");
String url = "jdbc:odbc:AddressBookDSN";
Connection con = DriverManager.getConnection(url);
String sql = "SELECT * FROM Person WHERE name = ?";
PreparedStatement pStmt = con.prepareStatement(sql);
pStmt.setString(1, sName);
ResultSet rs = pStmt.executeQuery();
if (rs.next( ) ) {
String name = rs.getString("name");
String add = rs.getString("address");
String pNum = rs.getString("phoneNum");
person = new PersonInfo(name, add, pNum);
con.close();
}catch(Exception ex){
System.out.println(ex);
}
return person;
}// end method
}
33.2.4 Step 4
To find what user wants to search, we need to give user an interface through which he/she
can enter the input. The SearchPesonServlet.javawill do this job for us, It will collect the data
from the user and submit that data to another class. The SearchPersonServletforms the part of
our presentation layer. As you can see that it is being used to present a form to the user and
collect input.
Write SearchPersonServlet.java
Will take input for name to search in address
book
Submits the request to ShowPersonServlet
//File: SearchPersonServlet.java
import java.io.*;
import java.net.*;
import javax.servlet.*;
CopyrightVirtualUniversityofPakistan
Page325
WebDesignandDevelopment(CS506)
import javax.servlet.http.*;
public class SearchPersonServlet extends HttpServlet {
protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html");
PrintWriter out = response.getWriter();
out.println(
"<html>" + "<body>" +
"<h1> Address Book </h1>" + "<form action=showperson >" +
// showperson is alias or
// url pattern of
// ShowPersonServlet
"<h2> Enter name to search </h2> <br/>" + "<input type=text name=pName /> <br/>" + "<input
type=submit value=Search Person />" + "</form>" +
"</body>" + "</html>"
);
out.close();
}
// Handles the HTTP GET method.
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
processRequest(request, response);
}
// Handles the HTTP POST method.
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
processRequest(request, response);
}
}
33.2.5 Step 5
The data submitted by the SearchPersonServletwill be submitted to another servlet i.e.
ShowPersonServlet,which will interact with the DataLayer(Business logic processing) collects
the output and show it to the user. The ShowPersonServletforms the part of our presentation
layer and business layer. As you can see that it is being used to do processing on the
incoming data and giving it to data layer (business layer) and present data/output to the user
(presentation layer)
Write ShowPersonServlet.java
Receives request from SearchPersonServlet
Instantiate objects of PersonInfoand PersonDAOclass
Call searchPerson()method of PersonDAOclass Show results
//File : ShowPersonServlet.java
CopyrightVirtualUniversityofPakistan
Page326
WebDesignandDevelopment(CS506)
import java.io.*;
import java.net.*;
import javax.servlet.*;
import javax.servlet.http.*;
public class ShowPersonServlet extends HttpServlet {
protected void processRequest(HttpServletRequestrequest, HttpServletResponse response)
throws ServletException, IOException{
response.setContentType("text/html");
PrintWriter out = response.getWriter();
String name = request.getParameter("pName");
// creating PersonDAO object, and calling searchPerson() method
PersonDAO personDAO = new PersonDAO();
PersonInfo person = personDAO.searchPerson(name);
out.println("<html>");
out.println("<body>");
out.println("<h1>Search Results</h1>");
if (person != null){
out.println("<h3>"+ person.toString() +"</h3>" );
}
else{
out.println("<h3>Sorry! No records found</h3>" );
}
out.println("</body>"); out.println("</html>"); out.close();
}
// Handles the HTTP GET method.
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
processRequest(request, response);
} // Handles the HTTP POST method.
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
processRequest(request, response);
}
} // end ShowPersonServlet
CopyrightVirtualUniversityofPakistan
Page327
WebDesignandDevelopment(CS506)
Sequence Diagram: Address Book (search use case)
2. Press
submit
button
2.1.doPost(req,res)
2.1.1.2.
searchper
son(req,
res)
2.1.1.2.2.callsetters
1.AccessURL
1.1.doGet
(req,res)
2.1.2.Output
2.1.1.3
return
personinfo
object
User
1.1.1.processRequest(
req,res)
2.1.1.processRequest(
req,res)
2.1.1.1.create
2.1.1.2.1.create
CopyrightVirtualUniversityofPakistan
Page328
WebDesignandDevelopment(CS506)
33.3 Package
Many times when we get a chance to work on a small project, one thing we intend to do is to put
all java files into one single directory (folder). It is quick, easy and harmless. However if our small
project gets bigger, and the number of files is increasing, putting all these files into the same
directory would be a nightmare for us. In java we can avoid this sort of problem by using
Packages.
Page329
WebDesignandDevelopment(CS506)
java.utilas a package name for the ArrayList class (java.util.ArrayList). So our ArrayList
class can be named as "ArrayList" or we can put it into another package like
com.mycompany.ArrayListwithout fighting with anyone. The benefits of using package
reflect the ease of maintenance, organization, and increase collaboration among
developers. Understanding the concept of package will also help us manage and use files
stored in jar files in more efficient ways.
33.3.2 How to create a package
Suppose we have a file called HelloWorld.java, and we want to put this file in a package
world. First thing we have to do is to specify the keyword packagewith the name of the
package we want to use (worldin our case) on top of our source file, before the code that
defines the real classes in the package, as shown in our HelloWorldclass below:
// only comment can be here package
world;
public class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello World");
}
One thing you must do after creating a package for the class is to create nested subdirectories to
represent package hierarchy of the class. In our case, we have the worldpackage, which requires
only one directory. So, we create a directory (folder) worldand put our HelloWorld.javainto it.
CopyrightVirtualUniversityofPakistan
Page330
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page331
WebDesignandDevelopment(CS506)
33.4.2 The JSP Framework
Use regular HTML for most of the pages
Mark servlet code with special tags
Entire JSP page gets translated into a servlet (once), and servlet is what actually gets invoked
(for each request)
The Java Server Pages technology combine with Java code and HTML tags in the
same document to produce a JSP file.
Page332
WebDesignandDevelopment(CS506)
rules about CLASSPATH, install dirs, etc, still apply to regular classes used by JSP
33.5 References:
Java A Lab Course by Umair Javed
Java Package Tutorial by Patrick Bouklee http://jarticles.com/package/package_eng.html
JavaServer Pages Overview http://java.sun.com/products/jsp/overview.html
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page333
WebDesignandDevelopment(CS506)
Web
Browser
Request
Result
Web server
JSP
Source
Web
Page
(HTML)
JSP
Parser
Java
Source
JSP
Servlet
Java
Compiler
The web browser makes a request to JSP source code. This code is bifurcated into HTML
and java code by the JSP parser. The java source code is compiled by the Java compiler
resulting in producing a servlet equivalent code of a JSP.
The servlet code is intermixed
with HTML and displayed to the user. It is important to note that a JSP only passes
through all these phases when it is invoked for the first time or when the changes have
been made to JSP. Any later call to JSP does not undergo of compilation phase.
Convenient
o we already know java and HTML. So nothing new to be learned to work with
JSP.
o Like servlets (as seen, ultimately a JSP gets converted into a servlet), provides an
extensive infrastructure for
CopyrightVirtualUniversityofPakistan
Page334
WebDesignandDevelopment(CS506)
Tracking sessions
Reading and sending HTML headers
Parsing and decoding HTML form data
Efficient
o Every request for a JSP is handled by a simple JSP java thread as JSP gets
converted into a servlet. Hence, the time to execute a JSP document is not
dominated by starting a process.
Portable
o Like Servlets, JSP is also a specification and follows a well standardized API.The
JVM which is used to execute a JSP file is supported on many architectures and
operating systems.
Inexpensive
o There are number of free or inexpensive Web Servers that are good for
commercial quality websites.
Now, compare the JSP code above with the Servlet code given below that is also displaying the
current date.
//File: SearchPersonServlet.java
import java.io.*;
import java.net.*;
import javax.servlet.*;
CopyrightVirtualUniversityofPakistan
Page335
WebDesignandDevelopment(CS506)
import javax.servlet.http.*;
import java.util.*;
public class SearchPersonServlet extends HttpServlet {
protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html");
PrintWriter out = response.getWriter();
out.println( <html> + <body> + <h3> +
Current Date is: + new Date() +
</h3> + </body> + </html>
);
out.close();
}
// Handles the HTTP GET method.
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
processRequest(request, response);
}
// Handles the HTTP POST method.
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
processRequest(request, response);
}
}
Clearly, a lot of code is needed to be written in the case of servlet example to perform a
basic job.
34.2 JSP Ingredients
Besides HTML, a JSP may contain the following elements.
Directive Elements
o Provides global control of JSP ....<%@%>
Scripting Elements
o JSP comments ...<%----%>
o declarations...<%! %>
o Used to declare instance variables & methods
expressions...<%=%>
o A java code fragment which returns String
scriptlets...<%%>
o Blocks of java code
Action Elements
CopyrightVirtualUniversityofPakistan
Page336
WebDesignandDevelopment(CS506)
o
Well discuss in detail all the ingredients of JSP. This handout will cover only scripting elements,
remaining ones will be discussed in next handouts.
34.3.1 Comments
Comments are ignored by JSP-to-servlet translator. Two types of comments are possibly used in
JSP.
HTML comment:
These comments are shown in browser, means on taking view source of the web
page; these sorts of comments can be read. Format of HTML comments is like to:
<!-- comment text-->
JSP comment:
These comments are not displayed in browser and have format like:
<%-- comment text --%>
34.3.2 Expressions
The format of writing a Java expression is:
<%= Java expression %>
These expressions are evaluated, after converted to strings placed into HTML page at the place it
occurred in JSP page
Examples of writing Expressions are:
<h2> Time: <% new java.util.Date() %> </h2>
will print current data & time after converting it to String
<h2> Welcome: <% request.getParameter(name)%> </h2>
will print the name attribute
34.3.3 Scriptlets
CopyrightVirtualUniversityofPakistan
Page337
WebDesignandDevelopment(CS506)
The format of writing a scriptlet is: <% Java code %>
After opening up the scriptlet tag, any kind of java code can be written inside it. This code is
inserted verbatim into corresponding servlet.
Example of writing a scriptlet is:
<%String n = request.getParameter(name);
out.println(welcome + n);
%>
The above scriptlet reads the name attribute and prints it after appending welcome
34.3.4 Declarations
The format of writing a declaration tag is: <%! Java code %>
This tag is used to declare variables and methods at class level. The code written inside this tag is
inserted verbatim into servlets class definition.
Example of declaring a class level (attribute) variable is:
<%!
private int someField = 5; %>
%>
Example of declaring a class level method is:
<%!
public void someMethod ( ) {
.
}
%>
Page338
WebDesignandDevelopment(CS506)
<form name = "myForm" action="second.jsp" >
<h3> First Number </h3>
<input type="text" name="num1" />
<h3> Second Number </h3>
<input type="text" name="num2" /> <br/><br/>
<input type="submit" value="Calculate Sum" /> </form>
</body>
</html>
second.jsp
This page retrieves the values posted by first.jsp. After converting the numbers into integers,
displays their sum.
<html>
<body>
<!-- JSP to sum two numbers -->
<%-- Declaration--%>
<%!
// declaring a variable to store sum int res;
// method helps in calculating the sum public int sum(int op1, int op2) {
return op1 + op2;
}
%>
<%-- Scripltet--%>
<%
String op1 = request.getParameter("num1"); String op2 = request.getParameter("num2"); int
firstNum = Integer.parseInt(op1);
int secondNum = Integer.parseInt(op2);
// calling method sum(), declared above in declartion tag res = sum(firstNum, secondNum);
%>
<%-- expression used to display sum --%>
<h3>Sum is: <%=res%> </h3>
</body>
</html>
Page339
WebDesignandDevelopment(CS506)
Declaration:<jsp:declartion> </jsp:declaration>
Expression:<jsp:expression> </jsp:expression>
Scriptlet:<jsp:scriptlet>
</jsp:scriptlet>
Its important to note that every opening tag also have a closing tag too. The second.jspof last
example is given below in XML style.
<?xml version="1.0" encoding="UTF-8"?>
<jsp:root xmlns:jsp="http://java.sun.com/JSP/Page" version="2.0">
<!-- to change the content type or response encoding change the following line
-->
<jsp:directive.page contentType="text/xml;charset=UTF-8"/>
<!-- any content can be specified here, e.g.: -->
<jsp:element name="text">
<jsp:body>
<jsp:declaration>
int res;
public int sum(int op1, int op2) {
return op1 + op2;
}
</jsp:declaration>
<jsp:scriptlet>
String op1 = request.getParameter("num1"); String op2 = request.getParameter("num2"); int
firstNum = Integer.parseInt(op1);
int secondNum = Integer.parseInt(op2);
res = sum(firstNum, secondNum);
</jsp:scriptlet>
<jsp:text> Sum is: </jsp:text>
<jsp:expression> res </jsp:expression>
</jsp:body>
</jsp:element> </jsp:root>
34.5 References:
Java A Lab Course by Umair Javed
Core Servlets and JSP by Marty Hall
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page340
WebDesignandDevelopment(CS506)
We start our discussion from implicit objects. Lets find out what these
are?
35.1 Implicit Objects
To simplify code in JSP expressions and scriptlets, you are supplied with eight
automatically defined variables, sometimes called implicit objects. The three most
important variables are request, response & out. Details of these are given below:
request
This variable is of type HttpServletRequest, associated with the request. It gives
you access to the request parameters, the request type (e.g. GET or POST), and
the incoming HTTP request headers (e.g. cookies etc).
response
CopyrightVirtualUniversityofPakistan
Page341
WebDesignandDevelopment(CS506)
This variable is of type HttpServletResponse, associated with the
response to client. By using it, you can set HTTP status codes, content type and
response headers etc.
out
index.jsp
Controller.
jsp
If page == java
java.jsp
Page342
WebDesignandDevelopment(CS506)
<h3>
<input type="radio" name = "page" value="java"/>
Java
</h3>
<br>
<input type="submit" value="Submit" />
</form>
</body>
</html>
controller.jsp
<html>
<body>
<!-- scriptlet -->
<%
// reading parameter page, name of radio button using
// implicit object request
String pageName = request.getParameter("page");
// deciding which page to move on based on page value
// redirecting user by using response implicit object
if (pageName.equals("web")) {
response.sendRedirect("web.jsp");
} else if (pageName.equals("java") ) {
response.sendRedirect("java.jsp");
}
%>
</body>
</html>
web.jsp
<html>
<body>
// use of out implicit object, to generate HTML
<%
out.println( "<h2>" +
"Welcome to Web Design & Development Page" + "</h2>"
);
%>
</body>
</html>
java.jsp
<html>
CopyrightVirtualUniversityofPakistan
Page343
WebDesignandDevelopment(CS506)
<body>
// use of out implicit object, to generate HTML
<%
out.println( "<h2>" +
"Welcome to Java Page" + "</h2>"
);
%>
</body>
</html>
The details of remaining 5 implicit objects are given
below:
session
This variable is of type HttpSession, used to work with session object.
application
This variable is of type ServletContext. Allows to store values in key-value pair form that are
shared by all servlets in same web application/
config
This variable is of type ServletConfig. Represents the JSP configuration options e.g. initparameters etc.
pageContext
This variable is of type javax.servlet.jsp.PageContext, to give a single point of access to
many of the page attributes. This object is used to stores the object values associated with this
object.
exception
This variable is of type java.lang.Throwable. Represents the exception that is
passed to JSP error page.
page
This variable is of type java.lang.Object. It is synonym for this.
CopyrightVirtualUniversityofPakistan
Page344
WebDesignandDevelopment(CS506)
35.2 JSP Directives
JSP directives are used to convey special processing information about the page to JSP
container. It affects the overall structure of the servlet that results from the JSP page. It enables
programmer to:
35.2.1 Format
<%@ directive {attribute=val}* %>
In JSP, there are three types of directives: page, include & taglib. The formats of using
these are:
page:<%@ page{attribute=val}*%>
include:<%@ include{attribute=val}*%>
taglib:<%@ taglib{attribute=val}*%>
35.2.2 JSP page Directive
Give high level information about servlet that will result from JSP page. It can be used
anywhere in the document. It can control
The lists of attributes that can be used with page directive are:
language = java
extends = package.class
import = package.*,package.class
session = true | false
info= text
contentType = mimeType
isThreadSafe = true | false
errorPage= relativeURL
isErrorPage = true | false
CopyrightVirtualUniversityofPakistan
Page345
WebDesignandDevelopment(CS506)
Some example uses are:
Format
<%@include file=relativeURL%>
Purpose
To include a file in a JSP document at the time document is translated into a servlet. It
may contain JSP code that affects the main page such as response page header settings
etc.
Page346
WebDesignandDevelopment(CS506)
</marquee>
</body>
</html>
footer.jsp
<html>
<body>
<marquee>
<h3> Virtual University </h3>
</marquee>
</body>
</html>
index.jsp
<html>
<body>
// includes the output of header.jsp
<%@include file="header.jsp" %>
<TABLE BORDER=1>
<TR><TH></TH><TH>Apples<TH>Oranges
<TR><TH>First Quarter<TD>2307<TD>4706
<TR><TH>Second Quarter<TD>2982<TD>5104
<TR><TH>Third Quarter<TD>3011<TD>5220
<TR><TH>Fourth Quarter<TD>3055<TD>5287 </TABLE>
// includes the output of footer.jsp
<%@include file="footer.jsp" %>
</body>
</html>
Example Code: setting content type to generate excel spread sheet
In this example, index.jsp is modified to generate excel spread sheet of the last example. The
change is shown in bold face.
index.jsp
// setting content type to generate excel sheet using page directive
<%@page contentType="application/vnd.ms-excel" %>
<html>
<body>
// includes the output of header.jsp
<%@include file="header.jsp" %>
<TABLE BORDER=1>
<TR><TH></TH><TH>Apples<TH>Oranges
<TR><TH>First Quarter<TD>2307<TD>4706
<TR><TH>Second Quarter<TD>2982<TD>5104
CopyrightVirtualUniversityofPakistan
Page347
WebDesignandDevelopment(CS506)
<TR><TH>Third Quarter<TD>3011<TD>5220
<TR><TH>Fourth Quarter<TD>3055<TD>5287 </TABLE>
// includes the output of footer.jsp
<%@include file="footer.jsp" %>
</body>
</html>
35.3 JSP Life Cycle Methods
The life cycle methods of JSP are jspInit(), _jspService() and jspDesroy().
On receiving each request, _jspService() method is invoked that generates the response as
well.
jspInit()
Request
_jspServices()
Response
jspDestroy()
35.4 References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page348
WebDesignandDevelopment(CS506)
Lecture 36
In the last handout, we learned how to work with JSP directives and the use of implicit objects.
In this handout, well learn about JavaBeans and what affect they produce. Before learning
JavaBeans, lets start with an example that helps us to understand the impact of using JavaBeans.
Code Example: Displaying Course Outline
This example is actually the modification of the last one we had discussed in previous handout.
User will select either course web design and development or java. On submitting request,
course outline would be displayed of the selected course in tabular format. This course outline
actually loaded from database. The schema of the database used for this example is given below:
_
Relationships
Course
SessionDeta
il
coursed
courseName
Detailed
sessionNo
topic
assignment
coursed
Page349
WebDesignandDevelopment(CS506)
</form>
</body>
</html>
controller.jsp
Based upon the selection made by the user, this page will redirect the user to respective
pages. Those are web.jspand java.jsp
<html>
<body>
<!-- scriptlet -->
<%
// reading parameter named page
String pageName = request.getParameter("page");
// redirecting user based on selection made if (pageName.equals("web")) {
response.sendRedirect("web.jsp");
} else if (pageName.equals("java") ) {
response.sendRedirect("java.jsp");
}
%>
/body>
</html>
web.jsp
This page is used to display course outline of web design and development in a tabular
format after reading them from database. The code is:
// importing java.sql package using page directive, to work with
// database
<%@page import="java.sql.*"%>
<html>
<body>
<center>
<h2> Welcome to Web Design & Development Page </h2>
<h3> Course Outline</h3>
<TABLE BORDER="1" >
<TR>
<TH>Session No.</TH>
<TH>Topics</TH>
<TH>Assignments</TH>
CopyrightVirtualUniversityofPakistan
Page350
WebDesignandDevelopment(CS506)
</TR>
<%-- start of scriptlet --%>
<%
// establishing conection
Class.forName("sun.jdbc.odbc.JdbcOdbcDriver");
String conUrl = "jdbc:odbc:CourseDSN";
Connection con = DriverManager.getConnection(conUrl);
// preparing query using join statements
String sql = " SELECT sessionNo, topic, assignment " + " FROM Course, SessionDetail" +
" WHERE courseName = ? " +
" AND Course.courseId = SessionDetail.courseID";
PreparedStatement pStmt = con.prepareStatement(sql);
// setting parameter value web. pStmt.setString( 1 , "web");
ResultSet rs = pStmt.executeQuery(); String sessionNo;
String topic;
String assignment;
// iterating over resultset while (rs.next()) {
sessionNo = rs.getString("sessionNo");
topic = rs.getString("topic");
assignment = rs.getString("assignment");
if (assignment == null){
assignment = "";
}
%>
<%-- end of scriptlet --%>
<%-- The values are displayed in tabular format using expressions, however it can also be done using
out.println(sessionNo) like statements
--%>
<TR>
<TD> <%=sessionNo%> </TD>
<TD> <%=topic%> </TD>
<TD> <%=assignment%> </TD>
</TR>
<%
} // end while
%>
</TABLE >
CopyrightVirtualUniversityofPakistan
Page351
WebDesignandDevelopment(CS506)
</center>
</body>
</html>
java.jsp
The code of this page is very much alike of web.jsp. The only change is in making of
query. Here the value is set java instead of web
// importing java.sql package using page directive, to work with
// database
<%@page import="java.sql.*"%>
<html>
<body>
<center>
<h2> Welcome to Java Page </h2>
<h3> Course Outline</h3>
<TABLE BORDER="1" >
<TR>
<TH>Session No.</TH>
<TH>Topics</TH>
<TH>Assignments</TH>
</TR>
<%-- start of scriptlet --%>
<%
// establishing conection
Class.forName("sun.jdbc.odbc.JdbcOdbcDriver");
String conUrl = "jdbc:odbc:CourseDSN";
Connection con = DriverManager.getConnection(conUrl);
// preparing query using join statements
String sql = " SELECT sessionNo, topic, assignment " + " FROM Course, SessionDetail" +
" WHERE courseName = ? " +
" AND Course.courseId = SessionDetail.courseID";
PreparedStatement pStmt = con.prepareStatement(sql);
// setting parameter value web. pStmt.setString( 1 , "java");
ResultSet rs = pStmt.executeQuery(); String sessionNo;
String topic;
String assignment;
// iterating over resultset while (rs.next()) {
sessionNo = rs.getString("sessionNo");
topic = rs.getString("topic");
assignment = rs.getString("assignment");
if (assignment == null){
assignment = "";
}
CopyrightVirtualUniversityofPakistan
Page352
WebDesignandDevelopment(CS506)
%>
<%-- end of scriptlet --%>
<%-- The values are displayed in tabular format using expressions, however it can also be done using
out.println(sessionNo) like statements
--%>
<TR>
<TD> <%=sessionNo%> </TD>
<TD> <%=topic%> </TD>
<TD> <%=assignment%> </TD>
</TR>
<%
} // end while
%>
</TABLE >
</center>
</body>
</html>
36.1 JavaBeans
A java class that can be easily reused and composed together in an application.
Any java class that follows certain design conventions can be a JavaBean.
CopyrightVirtualUniversityofPakistan
Page353
WebDesignandDevelopment(CS506)
A Sample JavaBean
The code snippet of very basic JavaBean is given below that satisfies all the conventions
described above. The MyBean.java class has only one instance variable.
public class MyBean implements Serializable {
private String name;
// zero argument constructor
public MyBean( ){
name = ;
}
// standard setter
public void setName(String n) {
name = n;
}
// standard getter
public String getName( ) {
return name;
}
// any other method
public void print( ) {
System.out.println(Name is: + name);
}
} // end Bean class
Page354
WebDesignandDevelopment(CS506)
included in this example code. These are CourseOutlineBean& CourseDAO.
The CourseOutlineBean is used to represent one row of the table. It contains the
following attributes:
sessionNo
topic
assignment
The CourseDAO (where DAO stands of Data Acess Object) bean encapsulates database
connectivity and result processing logic.
The web.jsp and java.jsp will use both these JavaBeans. The code of these and the JSPs
used in this example are given below.
CourseOutlineBean.java
package vu;
import java.io.*;
public class CourseOutlineBean implements Serializable{
private int sessionNo; private String topic; private String assignment;
// no argument constructor public CourseOutlineBean() { sessionNo = 0;
topic = "";
assignment = "";
}
// setters
public void setSessionNo(int s){
sessionNo = s;
}
public void setTopic(String t){
topic = t;
}
public void setAssignment(String a){
assignment = a;
}
// getters
public int getSessionNo( ){
return sessionNo;
}
public String getTopic( ){
return topic;
}
public String getAssignment( ){
return assignment;
}
} // end class
CopyrightVirtualUniversityofPakistan
Page355
WebDesignandDevelopment(CS506)
CourseDAO.java
package vu;
import java.io.*;
import java.sql.*;
import java.util.*;
public class CourseDAO implements Serializable{
private Connection con;
public CourseDAO() {
establishConnection();
}
//********** establishConnection method ********************
// method used to make connection with database private void establishConnection(){
try{
// establishing conection
Class.forName("sun.jdbc.odbc.JdbcOdbcDriver");
String conUrl = "jdbc:odbc:CourseDSN";
con = DriverManager.getConnection(conUrl);
}catch(Exception ex){ System.out.println(ex);
}
//*********** retrieveCourseList method ********************
public ArrayList retrieveCourseList(String cName){ ArrayList courseList = new ArrayList();
try{
}
String sql = " SELECT sessionNo, topic, assignment " +
" FROM Course, SessionDetail" + " WHERE courseName = ? " +
" AND Course.courseId = SessionDetail.courseID ";
PreparedStatement pStmt = con.prepareStatement(sql);
pStmt.setString(1, cName);
ResultSet rs = pStmt.executeQuery();
int sNo; String topic; String assignment;
while ( rs.next() ) {
sNo = rs.getInt("sessionNo");
topic = rs.getString("topic");
assignment = rs.getString("assignment");
if (assignment == null){
assignment = "";
}
// creating a CourseOutlineBean object
CourseOutlineBean cBean = new CourseOutlineBean();
cBean.setSessionNo(sNo);
cBean.setTopic(topic);
cBean.setAssignment(assignment);
// adding a bean to arraylist
CopyrightVirtualUniversityofPakistan
Page356
WebDesignandDevelopment(CS506)
courseList.add(cBean);
}
}catch(Exception ex){ System.out.println(ex);
} finally {
// to close connection releaseResources();
}
// returning ArrayList object
return courseList;
} // end retrieveCourseOutline
//********** releaseResources method ********************
private void releaseResources(){
try{
if(con != null){
con.close();
}
}catch(Exception ex){ System.out.println();
}
}
} // end releaseResources
}// end CourseDAO
index.jsp
This page is used to display the course options to the user in the radio button form.
<html>
<body>
<h2>Select the page you want to visit</h2>
<form name="myForm" action="controller.jsp" >
<h3>
<input type="radio" name = "page" value="web"/>
Web Design & Develoment
</h3> <br>
<h3>
<input type="radio" name = "page" value="java"/> Java
</h3><br>
<input type="submit" value="Submit" />
CopyrightVirtualUniversityofPakistan
Page357
WebDesignandDevelopment(CS506)
</form>
</body>
</html>
controller.jsp
Based on user selection, redirects the user to desired page.
<html>
<body>
<!-- scriptlet -->
<%
String pageName = request.getParameter("page");
if (pageName.equals("web")) {
response.sendRedirect("web.jsp");
} else if (pageName.equals("java") ) {
response.sendRedirect("java.jsp");
}
%>
</body>
</html>
web.jsp
This page is used to display course outline of web design and development in a tabular
format after reading them from database. Moreover, this page also uses the JavaBeans
(CourseOutlineBean & CourseDAO).
<%@page import="java.util.*" %>
<%-- importing vu package that contains the JavaBeans--%>
<%@page import="vu.*" %>
<html>
<body>
<center>
<h2> Welcome to Web Design & Development Course </h2>
<h3> Course Outline</h3>
<TABLE BORDER="1" >
<TR>
<TH>Session No.</TH>
<TH>Topics</TH>
<TH>Assignments</TH>
</TR>
<%-- start of scriptlet --%>
<%
CopyrightVirtualUniversityofPakistan
Page358
WebDesignandDevelopment(CS506)
// creating CourseDAO object
CourseDAO courseDAO = new CourseDAO();
// calling retrieveCourseList() of CourseDAO class and
// passing web as value. This method returns ArrayList
ArrayList courseList = courseDAO.retrieveCourseList("web"); CourseOutlineBean webBean = null;
// iterating over ArrayList to display course outline
for(int i=0; i<courseList.size(); i++){
webBean = (CourseOutlineBean)courseList.get(i);
%>
<%-- end of scriptlet --%>
<TR>
<TD> <%= webBean.getSessionNo()%> </TD>
<TD> <%= webBean.getTopic()%> </TD>
<TD> <%= webBean.getAssignment()%> </TD>
</TR>
<%
} // end for
%>
</TABLE >
</center>
</body>
</html>
java.jsp
The code contains by this page is almost same of web.jsp. Here, java is passed to
retieveCourseList( ) method. This is shown in boldface.
<%@page import="java.util.*" %>
<%-- importing vu package that contains the JavaBeans--%>
<%@page import="vu.*" %>
<html>
<body>
<center>
<h2> Welcome to Java Course </h2>
<h3> Course Outline</h3>
<TABLE BORDER="1" >
<TR>
<TH>Session No.</TH>
<TH>Topics</TH>
<TH>Assignments</TH>
</TR>
<%-- start of scriptlet --%>
<%
// creating CourseDAO object
CourseDAO courseDAO = new CourseDAO();
CopyrightVirtualUniversityofPakistan
Page359
WebDesignandDevelopment(CS506)
// calling retrieveCourseList() of CourseDAO class and
// passing java as value. This method returns ArrayList
ArrayList courseList = courseDAO.retrieveCourseList("java");
CourseOutlineBean javaBean = null;
// iterating over ArrayList to display course outline
for(int i=0; i<courseList.size(); i++){
javaBean = (CourseOutlineBean)courseList.get(i);
%>
<%-- end of scriptlet --%>
<TR>
<TD> <%= javaBean.getSessionNo()%> </TD>
<TD> <%= javaBean.getTopic()%> </TD>
<TD> <%= javaBean.getAssignment()%> </TD>
</TR>
<%
} // end for
%>
</TABLE >
</center>
</body>
</html>
36.2 References:
Entire material for this handout is taken from the book JAVA A Lab Course by Umair
Javed. This material is available just for the use of VU students of the course Web
Design and Development and not for any other commercial purpose without the consent of
author.
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page360
WebDesignandDevelopment(CS506)
Lecture 37: JSP Action Elements and Scope
The journey we had started of JSP is very much covered except of JSP action elements. In this
handout, well study the use of JSP action elements. Further also learn how and where to store
JavaBean objects that can be shared among JSP pages.
Lets first quickly look on the JSP journey to find out where we have reached.
Page361
WebDesignandDevelopment(CS506)
Some JSP Action Elements
Page362
WebDesignandDevelopment(CS506)
<%
MyBean m = new MyBean( );
%>
Achieving above functionality using
<jsp:useBean id = m
scope = page
class=vu.MyBean
/>
m.setProperty(ali);
Achieving above functionality using jsp:setPropertyaction element will look like this:
<jsp:setProperty name = m property = name value = ali />
37.2.3 JSP getProperty Action Element
Use to retrieves the value of property, converts it to String and writes it to output stream.
The format of this action element is:
<jsp:getProperty name = beanName or idproperty = name/>
CopyrightVirtualUniversityofPakistan
Page363
WebDesignandDevelopment(CS506)
jsp:getProperty is being equivalent to following code of scriptlet. For example to retrieve the
name property of m (instance of MyBean) followed by writing it to output stream, scriptlet code will
look like:
<%
String name = m.getName( ); out.println(name);
%>
Achieving above functionality using jsp:getProperty action element will look like this:
<jsp:getProperty name = mproperty = name />
Example Code: Calculating sum of two numbers by using action elements and JavaBean
This example contains index.jspand result.jspand one JavaBean i.e. SumBean.
User will enter two numbers on index.jspand their sum will be displayed on
result.jsp. Lets examine these one after another
SumBean.java
The SumBean has following attributes
firstNumber
secondNumber
sum
The firstNumber and secondNumbers are write-only properties means for these only
setters would be defined. Whereas sum is a read-only property as only getter would be
defined for it.
The SumBeanalso contain one additional method for calculating sum i.e. calulateSum().
After performing addition of firstNumber with secondNumber, this method will assign the
result to sum attribute.
package vu;
import java.io.*;
public class SumBean implements Serializable{
private int firstNumber;
private int secondNumber;
private int sum;
// no argument constructor
public SumBean() {
CopyrightVirtualUniversityofPakistan
Page364
WebDesignandDevelopment(CS506)
firstNumber = 0;
secondNumber = 0;
sum = 0;
}
// firstNumber & secondNumber are writeonly properties
// setters
public void setFirstNumber(int n){
firstNumber = n;
}
public void setSecondNumber(int n){
secondNumber = n;
}
// no setter for sum
// sum is a read only property
public int getSum( ){
return sum;
}
// method to calculate sum
public void calculateSum() {
sum = firstNumber + secondNumber;
}
}
index.jsp
This page will display two text fields to enter number into them.
<html>
<body>
<h2>Enter two numbers to calculate their sum</h2>
<form name="myForm" action="result.jsp">
<h3>
Enter first number
<input type="text" name="num1" />
<br/>
Enter second number
<input type="text" name="num2" />
<br/>
<input type="submit" value="Calculate Sum" />
</h3>
</form>
</body>
</html>
CopyrightVirtualUniversityofPakistan
Page365
WebDesignandDevelopment(CS506)
result.jsp
This page will calculate the sum of two entered numbers by the user and displays the sum
back to user. The addition is performed using SumBean
<%-- importing vu package that contains the SumBean --%>
<%@page import="vu.*"%>
<html>
<body>
<h2>The sum is:
<%-- instantiating bean using action element -- %>
<%-//Servlet equivalent code of useBean
SumBean sBean = new SumBean();
--%>
<jsp:useBean id="sBean" class="vu.SumBean" scope="page"/>
<%-- setting firstNumber property of sBean using action elements
-- %>
<%-- implicit conversion from string to int as num1 is of type
String and firstNumber is of type int
--%>
<%-//Servlet equivalent code of setProperty for num1
int no = Integer.parseInt(request.getParameter("num1"));
sBean.setFirstNumber(no);
--%>
<jsp:setProperty name="sBean"
property="firstNumber" param="num1" />
<%-//Servlet equivalent code of setProperty for num2
int no = Integer.parseInt(request.getParameter("num2"));
sBean.setSecondNumber(no);
--%>
//Servlet equivalent code of setProperty for num2
int no = Integer.parseInt(request.getParameter("num2"));
sBean.setSecondNumber(no);
<jsp:setProperty name="sBean"
property="secondNumber" param="num2" />
<%
// calling calculateSum() method that will set the value of
// sum attribute
sBean.calculateSum();
%>
CopyrightVirtualUniversityofPakistan
Page366
WebDesignandDevelopment(CS506)
<%-// servlet equivalent code of displaying sum
int res = sBean.getSum();
out.println(res);
--%>
<jsp:getProperty name="sBean" property="sum" />
</h2>
</body>
</html>
Although the beans are indeed bound to local variables, that is not the only behavior. They are
also stored in four different locations, depending on the value of the optional scope attribute of
jsp:useBean. The scope attribute has the following possible values: page, request, sessionand
application.
Lets discover what impact these scopes can produce on JavaBeans objects which are stored in one
of these scopes.
37.3.1 page
This is the default value of scope attribute, if omitted. It indicates, in addition to being
bound to local variable, the bean object should be placed in the pageContext object.
The beans values are only available and persist on JSP in which bean is created.
In practice, beans created with page scope are always accessed (their values) by jsp:getProperty,
jsp:setProperty, scriptlets or expressions later in the same page. This will be more cleared with the
help of following diagram:
CopyrightVirtualUniversityofPakistan
Page367
WebDesignandDevelopment(CS506)
First.jsp
(1)request1
Second
.jsp
(2)create
MyBeanm=newMyBean();
m.setName(ali);
(3)request1
third.jsp
Orrequest2
(4)Valuesnot
Available
MvBeanm
Iname=alil
37.3.2 request
This value signifies that, in addition to being bound to local variable, the bean object
should be placed in ServletRequest object for the duration of the current request.
In other words, until you continue to forward the request to another
JSP/servlet, the beans values are available. This has been illustrated in the following
diagram.
CopyrightVirtualUniversityofPakistan
Page368
WebDesignandDevelopment(CS506)
First.jsp
(1)request1
Second
.jsp
(3)request1
(4)Values
Available
(2)create
third.jsp
(5)request2 Fourth
.jsp
(6)Valuesnot
Available
MvBeanm
[name=ali]
(1)request1
Second
.jsp
(4)request1
(3)create
(5)Values
Available
(7)Values
Available
MvBeanm
[name=ali]
HttpSession
CopyrightVirtualUniversityofPakistan
Page369
WebDesignandDevelopment(CS506)
In the diagram above, MyBeanis instantiated by specifying scope = session that results in
storing object in HttpSession. A value ali is also stored in m using setter method.
Irrespective of request forwarding or new request generation from second.jsp to other
resources, the values stored in HttpSession remains available until users session is
ended.
37.3.4 Application
This very useful value means that, in addition to being bound to local variable, the bean object
will be stored in ServletContext. The bean objects stored in ServletContextis shared by all
JSPs/servlets in the same web application. The diagram given below illustrates this scenario:
First.jsp
(1)request1
Second
.jsp
(4)request1
(3)create
(5)Values
Available
third.jsp
(6)request2 Fourth
.jsp
(7)Values
Available
MvBeanm
[name=ali]
ServletContext
CopyrightVirtualUniversityofPakistan
Page370
WebDesignandDevelopment(CS506)
37.4 Summary of Objects Scopes
Most visible
application
Withinallpagesbelongingtosameapplication
session
Onlyfrompagesbelongingtosamesessionas
theoneinwhichtheyarecreated
request
Onlywithinpagesprocessingtherequestin
whichtheyarecreated
page
Objectsmaybeaccessedonlywithinpages
wheretheyarecreated
Least visible
Lets take another view of session, request & page scopes in the next figure that helps us to
understand the under beneath things.
Client(PC)
Request
Response
Request
Response
Page1
Page2
Page3
Requestscope
Page4
Requestscope
Sessionscope
CopyrightVirtualUniversityofPakistan
Page371
WebDesignandDevelopment(CS506)
The figure shows four JavaServer Pages. Each page has its own page scope. Therefore
objects stored in page scope are only available to same pages on which they are created.
Suppose page1 forwards the request to page2. Objects stored in request scope remains available
to page1 as well to page 2. Similar case is true for page 3 & page 4.
If user makes a visit to all these pages in one session, objects values stored in session scope
remains available on all these pages.
To understand the difference between sessions & application scope, consider the
following figure:
Client1
Session1
SessionID1
server
SessionID2
Session2
Client2
Client1
SessionID1
server
application
SessionID2
Client2
As you can conclude from the figure, for each user (client), objects are stored in different
sessions. However, in the case of application scope, all users stores objects in single
place.
CopyrightVirtualUniversityofPakistan
Page372
WebDesignandDevelopment(CS506)
jsp:include is being equivalent to following code of scriptlet. For example to include the
output of one.jsp , scriptlet code will look like:
<%
RequestDispatcher rd =request.getRequestDispatcher(one.jsp);
rd.include(request, response);
%>
Achieving above functionality using jsp:include action element will look like this:
<jsp:include page = one.jsp
jsp:forward
action
jsp:forward is being equivalent to following code of scriptlet. For example to forward the
request to one.jsp , scriptlet code will look like:
<%
RequestDispatcher rd = request.getRequestDispatcher(one.jsp);
rd.forward(request, response);
%>
CopyrightVirtualUniversityofPakistan
Page373
WebDesignandDevelopment(CS506)
37.6 References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page374
WebDesignandDevelopment(CS506)
Lecture 38: JSP Custom Tags
To begin with, lets review our last code example of lecture 36 i.e. Displaying course
outline. We incorporated JavaBeans to minimize the database logic from the JSP. But
still, we have to write some lines of java code inside java.jsp & web.jsp. As discussed
earlier, JSPs are built for presentation purpose only, so all the other code that involves
business and database logic must be shifted elsewhere like we used JavaBeans for such
purpose.
There is also another problem attached to it. Generally web page designers which have enough
knowledge to work with HTML and some scripting language, faced lot of difficulties in
writing some simple lines of java code. To overcome these issues, java provides us the
mechanism of custom tags.
38.1 Motivation
To give you an inspiration, first have a glance over the code snippet we used in JSP of the course
outline example of last lecture. Of course, not all code is given here; its just for your reference to
give you a hint.
<%
CourseDAO courseDAO = new CourseDAO();
// iterating over ArrayList for
( ) {
//displaying courseoutline
}
%>
Can we replace all the above code with one single line? Yes, by using custom tag we can write like
this:
<mytag:coursetag
pageName=java />
By only specifying the course/page name, this tag will display the course outline in
tabular format. Now, you must have realized how significant changes custom tags can
bring on.
In simplistic terms, a user defined component that is used to perform certain action.
CopyrightVirtualUniversityofPakistan
Page375
WebDesignandDevelopment(CS506)
This action could be as simple as displaying hello world or it can be as complex as
displaying course outline of selected course after reading it from database.
It provides mechanism for encapsulating complex functionality for use in JSPs. Thus
facilitates the non-java coders.
We already seen & used many built in tags like:
o
o
o
CopyrightVirtualUniversityofPakistan
Page376
WebDesignandDevelopment(CS506)
<mytag:hello/>
TagName
TagLibrary
Prefix
optional_attributes >
some body
</ mytag:hello >
Page377
WebDesignandDevelopment(CS506)
Tag Handler is also a java class that is implicitly called when the associated tag is
encountered in the JSP.
Must implement SimpleTaginterface
Usually extend from SimpleTagSupport class that has already implemented
SimpleTaginterface.
For example,
public class MyTagHandler extends SimpelTagSupport {
}
doTag()method
o By default does nothing
o Need to implement / override to code/write functionality of tag
o Invoked when the end element of the tag encountered.
JSP implicit objects (e.g. out etc) are available to tag handler class through
pageContextobject.
pageContextobject can be obtained using getJspContext()method.
For example to get the reference of implicit outobject, we write.
o PageContext pc = (PageContext) getJspContext();
o JspWriter out = pc.getOut();
CopyrightVirtualUniversityofPakistan
Page378
WebDesignandDevelopment(CS506)
Note: If you are using any IDE (like netBeans 4.1, in order to build custom tags,
the IDE will write .tldfile for you.
38.6.4 Deployment
folder
of
web
Note: Any good IDE will also perform this step on your behalf
CopyrightVirtualUniversityofPakistan
and override
Page379
WebDesignandDevelopment(CS506)
doTag()method
Build TLD file
Deploy
Note: As mentioned earlier, if you are using any IDE (like netBeans 4.1), the last two steps will
be performed by the IDE.
WelcomeTagHandler.java
package vu;
// importing required packages
import javax.servlet.jsp.*;
import javax.servlet.jsp.tagext.*;
// inheriting from SimpleTagSupport class
public class WelcomeTagHandler extends SimpleTagSupport {
// overriding doTag() method
public void doTag() throws JspException {
// obtaining the reference of out implicit object
PageContext pageContext = (PageContext)getJspContext(); JspWriter out =
pageContext.getOut();
try {
out.println(" Hello World ");
} catch (java.io.IOException ex) {
throw new JspException(ex.getMessage());
}
} // end doTag() method
} // end WelcomeTagHandler class
customtags.tld
If using IDE, this file will be written automatically. In this file you specify the tag name
along with Tag Handler class.
<?xml version="1.0" encoding="UTF-8"?>
<taglib version="2.0" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee web- jsptaglibrary_2_0.xsd">
<tlib-version>1.0</tlib-version>
<short-name>mytag</short-name>
<!the value of uri will be used in JSP to refer to this tld -->
<uri>/WEB-INF/tlds/customtags</uri>
<!
Specifying the tag name and tag class. Also mentioning that this tag has no body
-->
<tag>
<name>welcome</name>
CopyrightVirtualUniversityofPakistan
Page380
WebDesignandDevelopment(CS506)
<tag-class>vu.WelcomeTagHandler</tag-class>
<body-content>empty</body-content>
</tag>
</taglib>
index.jsp
<%-using taglib directive, specifying the tld file name as well as
prefix. Note that you you use any value for the prefix attribtute
--%>
<%@taglib uri="/WEB-INF/tlds/customtags.tld" prefix="mytag" %>
<html>
<body>
<h2>A Simple Tag Example</h2>
<h3>
<%-- calling welcome tag with the help of prefix --%>
<mytag:welcome />
</h3>
</body>
</html>
Page381
WebDesignandDevelopment(CS506)
Approach
Page382
WebDesignandDevelopment(CS506)
}
} // end class
CourseDAO.java
No changes are made to this file too.
package vu;
import java.io.*;
import java.sql.*;
import java.util.*;
import vubean.*;
public class CourseDAO implements Serializable{
private Connection con;
public CourseDAO() {
establishConnection();
}
//********** establishConnection method ********************
// method used to make connection with database
private void establishConnection(){
try{
// establishing conection
Class.forName("sun.jdbc.odbc.JdbcOdbcDriver");
String conUrl = "jdbc:odbc:CourseDSN";
con = DriverManager.getConnection(conUrl);
}catch(Exception ex){
System.out.println(ex);
}
}
//*********** retrieveCourseList method ********************
public ArrayList retrieveCourseList(String cName){
ArrayList courseList = new ArrayList();
try{
String sql = " SELECT sessionNo, topic, assignment " + " FROM Course, SessionDetail" +
" WHERE courseName = ? " +
" AND Course.courseId = SessionDetail.courseID ";
PreparedStatement pStmt = con.prepareStatement(sql);
pStmt.setString(1, cName);
ResultSet rs = pStmt.executeQuery();
int sNo; String topic; String assignment;
while ( rs.next() ) {
sNo = rs.getInt("sessionNo");
topic = rs.getString("topic");
assignment = rs.getString("assignment");
CopyrightVirtualUniversityofPakistan
Page383
WebDesignandDevelopment(CS506)
if (assignment == null){
assignment = "";
}
// creating a CourseOutlineBean object
CourseOutlineBean cBean = new CourseOutlineBean();
cBean.setSessionNo(sNo);
cBean.setTopic(topic);
cBean.setAssignment(assignment);
// adding a bean to arraylist
courseList.add(cBean);
}
}catch(Exception ex){
System.out.println(ex);
} finally {
// to close connection
releaseResources();
}
// returning ArrayList object
return courseList;
} // end retrieveCourseOutline
//********** releaseResources method ********************
private void releaseResources(){
try{
if(con != null){
con.close();
}
}catch(Exception ex){
System.out.println();
}
} // end releaseResources
}// end CourseDAO
MyTagHandler.java
The tag handler class uses JavaBeans (CourseOutlineBean.java&
CourseDAO.java), and includes the logic of displaying course outline in tabular
format.
package vutag;
// importing package that contains the JavaBeans
import vubean.*;
import vu.*;
import javax.servlet.jsp.tagext.*;
CopyrightVirtualUniversityofPakistan
Page384
WebDesignandDevelopment(CS506)
import javax.servlet.jsp.*;
import java.util.*;
public class MyTagHandler extends SimpleTagSupport {
/*
Declaration of pageName property.
*/
private String pageName;
public void doTag() throws JspException {
CourseDAO courseDAO = new CourseDAO();
ArrayList courseList = courseDAO.retrieveCourseList(pageName);
// to display course outline in tabular form, this method is
// used define below
display(courseList);
}
/*
Setter for the pageName attribute.
*/
public void setPageName(java.lang.String value) {
this.pageName = value;
}
/*
display method used to print courseoutline in tabular form
*/
private void display(ArrayList courseList)throws JspException{
PageContext pc = (PageContext)getJspContext();
JspWriter out = pc.getOut();
try{
// displaying table headers
out.print("<TABLE BORDER=1 >");
out.print("<TR>");
out.print("<TH> Session No </TH>");
out.print("<TH> Topic </TH>");
out.print("<TH> Assignment </TH>");
out.print("</TR>");
// loop to iterate over courseList
for (int i=0; i<courseList.size(); i++){
CourseOutlineBean courseBean = (CourseOutlineBean)courseList.get(i);
// displaying one row
out.print("<TR>");
out.print("<TD>" + courseBean.getSessionNo() + "</TD>"); o
ut.print("<TD>" + courseBean.getTopic() + "</TD>");
out.print("<TD>" + courseBean.getAssignment() + "</TD>");
CopyrightVirtualUniversityofPakistan
Page385
WebDesignandDevelopment(CS506)
out.print("</TR>");
}catch(java.io.IOException ex){
throw new JspException(ex.getMessage());
}
}
} // end clas MyTagHandler.java
mytaglibrary.tld
<?xml version="1.0" encoding="UTF-8"?>
<taglib version="2.0" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee web- jsptaglibrary_2_0.xsd">
<tlib-version>1.0</tlib-version>
<short-name>mytaglibrary</short-name>
<!the value of uri will be used in JSP to refer to this tld -->
<uri>/WEB-INF/tlds/mytaglibrary</uri>
<!
Specifying the tag name and tag class. Also mentioning that this tag has no body
-->
<tag>
<name>coursetag</name>
<tag-class>vutag.MyTagHandler</tag-class>
<body-content>empty</body-content>
<!
Specifying the attribute name and its type
-->
<attribute>
<name>pageName</name>
<type>java.lang.String</type>
</attribute>
</tag>
</taglib>
out.print("</TABLE>");
index.jsp
This page is used to display the course options to the user in the radio button form.
<html>
<body>
<h2>Select the page you want to visit</h2>
<form name="myForm" action="controller.jsp" >
<h3>
CopyrightVirtualUniversityofPakistan
Page386
WebDesignandDevelopment(CS506)
<input type="radio" name = "page" value="web"/> Web Design & Development
</h3>
<br>
<h3>
<input type="radio" name = "page" value="java"/>
Java
</h3>
<br>
<input type="submit" value="Submit" />
</form>
</body>
</html>
controller.jsp
Based upon the selection made by the user, this page will redirect the user to respective
pages. Those are web.jspand java.jsp
<html>
<body>
<!-- scriptlet -->
<%
String pageName = request.getParameter("page");
if (pageName.equals("web")) {
response.sendRedirect("web.jsp");
} else if (pageName.equals("java") ) {
response.sendRedirect("java.jsp");
}
%>
</body>
</html>
java.jsp
<%-- using taglib directive, specifying the tld file and prefix -%>
<%@taglib uri="/WEB-INF/tlds/mytaglibrary.tld" prefix="mytag"%>
<html>
<body>
<center>
<h2> Welcome to Java Learning Center </h2>
<h3> Course Outline</h3>
CopyrightVirtualUniversityofPakistan
Page387
WebDesignandDevelopment(CS506)
<%-calling coursetag and specifying java as attribute
value
--%>
<mytag:coursetag pageName="java" />
</center>
</body>
</html>
web.jsp
<%-- using taglib directive, specifying the tld file and prefix -%>
<%@taglib uri="/WEB-INF/tlds/mytaglibrary.tld" prefix="mytag"%>
<html>
<body>
<center>
<h2> Welcome to Java Learning Center </h2>
<h3> Course Outline</h3>
<%-calling coursetag and specifying java as attribute value
--%>
<mytag:coursetag pageName="java" />
</center>
</body>
</html>
38.9 References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page388
WebDesignandDevelopment(CS506)
Lecture 39: MVC + Case Study
We have covered an adequate amount of Servlets and JSPs in detail. Now, the time has come to
learn different architectures that are most commonly used for the sake of web development. These
architectures also help us to understand where these components best fit in. In this handout,
well cover the most widely used/popular architecture i.e. Model
View Controller
(MVC).
A small case study Address Book is also part of this handout that is based on MVCModel 1.
Before moving on to MVC, lets see what error pages are and how they are
used?
39.1 Error Page
Error Pages enables you to customize error messages. You can even hide them from the
user's view entirely, if you want. This also makes possible to maintain a consistent look and feel
throughout an application, even when those dreaded error messages are thrown.
By means of page directive, a JSP can be given the responsibility of an Error page. An Error JSP
is called by the web server when an uncaught exception gets occurred. This exception is passed as
an instance of java.lang.Throwableto Error JSP (also accessible via implicit exceptionobject).
39.1.1 Defining and Using Error Pages
isErrorPageattribute of a page directive is used to declare a JSP as an error
page.
JSP pages are informed about the error page by setting errorPageattribute of page
directive
In the figure below, error.jsp is defined as JSP Error page and index.jsp is informed to call
error.jsp if any uncaught exception rose. This is done by setting attributes errorPage and
isErrorPageof the page directive on these JSPs.
Index.jsp
Error.jsp
<%@page...
errorPage=error.jsp%>
<%@page...
isErroPage=true%>
exception
CopyrightVirtualUniversityofPakistan
Page389
WebDesignandDevelopment(CS506)
Page390
WebDesignandDevelopment(CS506)
o In addition to that, it also displays the message associated with the received
exception to the user.
saveperson
.jsp
addperson
.jsp
PersonInfo
exception
JavaBeans
addbookerror
.jsp
PersonDAO
searchperson
.jsp
showperson
.jsp
addperson.jsp takes persons information from the user and sends it to saveperson.jsp. After
receiving request, saveperson.jspmakes an object of PersonInfousing received information
and saves it into the database using PersonDAO Java bean.
Similarly, searchperson.jsptakes search criteria (name) from the user and passes it to
showperson.jspthat searches the record in database using PersonDAOand shows the results to
the user.
If any uncaught exception is generated on these JSP, addbookerror.jspis called
implicitly, which displays an appropriate message to the user after identifying the exception type.
Code for the Case Study
Lets have a look on the code of each component used in the case study; first start from
JavaBeans.
PersonInfo
PersonInforepresents the record of one person and its objects are used to interrupt the
information about persons.
package vu;
import java.io.*;
public class PersonInfo implements Serializable{
CopyrightVirtualUniversityofPakistan
Page391
WebDesignandDevelopment(CS506)
private String name;
private String address;
private int phoneNum;
// no argument constructor
public PersonInfo() {
name = "";
address = "";
phoneNum = 0;
}
// setters
public void setName(String n){
name = n;
}
public void setAddress(String a){
address = a;
}
public void setPhoneNum(int pNo){
phoneNum = pNo;
}
// getters
public String getName( ){
return name;
}
public String getAddress( ){
return address;
}
public int getPhoneNum( ){
return phoneNum;
}
} // end class PersonInfo
PersonDAO
This class will help in retrieving and storing persons records in database. The
code is given below:
package vu;
import java.util.*;
import java.sql.*;
public class PersonDAO{
private Connection con;
// default constructor
public PersonDAO() throws ClassNotFoundException , SQLException
{
CopyrightVirtualUniversityofPakistan
Page392
WebDesignandDevelopment(CS506)
establishConnection();
}
// method used to establish connection with db
private void establishConnection() throws ClassNotFoundException , SQLException
{
// establishing conection
Class.forName("sun.jdbc.odbc.JdbcOdbcDriver");
String conUrl = "jdbc:odbc:PersonDSN";
con = DriverManager.getConnection(conUrl);
}
// used to search the person records against name and returns
// the ArrayList that contains only those PersonInfo objects
// which matches the search criteria i.e. name
public ArrayList retrievePersonList(String pName) throws SQLException
{
ArrayList personList = new ArrayList();
// preparing query
String sql = " SELECT * FROM Person WHERE name = ?";
PreparedStatement pStmt = con.prepareStatement(sql);
pStmt.setString( 1, pName);
// executing query
ResultSet rs = pStmt.executeQuery();
String name; String add; int pNo;
while ( rs.next() ) {
name = rs.getString("name");
add = rs.getString("address");
pNo = rs.getInt("phoneNumber");
// creating a CourseOutlineBean object
PersonInfo personBean = new PersonInfo();
personBean.setName(name);
personBean.setAddress(add);
personBean.setPhoneNum(pNo);
// adding a bean to arraylist
personList.add(personBean);
} // end while
return personList;
} // end retrievePersonList
// this method accepts an object of PersonInfo, and stores it
// into the database
public void addPerson(PersonInfo person) throws SQLException{
String sql = " INSERT INTO Person(name, address, phoneNumber) VALUES (?, ?, ?)";
PreparedStatement pStmt = con.prepareStatement(sql); String name = person.getName();
String add = person.getAddress();
CopyrightVirtualUniversityofPakistan
Page393
WebDesignandDevelopment(CS506)
int pNo = person.getPhoneNum();
pStmt.setString( 1 , name );
pStmt.setString( 2 , add );
pStmt.setInt( 3 , pNo );
pStmt.executeUpdate();
} // end addPerson
// overriding finalize method to release acquired resources
public void finalize( ) {
try{
if(con != null){
con.close();
}
}catch(SQLException sqlex){
System.out.println(sqlex);
}
} // end finalize
} // end PersonDAO class
Now lets take a look at the code for JSP pages
addperson.jsp
This JSP page gets person records information from the user. It contains three Input Fields for
name, address and phone number as shown in the diagram. This page sends this information to
saveperson.jspfor further processing.
AddressBook
AddNewPerson
Name
Address
PhoneNo
Save
Clear
SearchPerson
The code that is used to generate the above page is given below:
CopyrightVirtualUniversityofPakistan
Page394
WebDesignandDevelopment(CS506)
<%-Although there are no chances of exception to arise on this page, for consistency, error page is defined
on top of all JSPs
--%>
<%@page errorPage="addbookerror.jsp" %>
<html>
<body>
<center>
<h2> Address Book </h2>
<h3> Add New Person</h3>
<%-- Form that contains Text input fields and sending it to saveperson.jsp
--%>
<form name ="register" action="saveperson.jsp" />
<TABLE BORDER="1" >
<TR>
<TD> <h4 > Name </h4> </TD>
<TD> <input type="text" name="name" /> </TD>
</TR>
<TR>
<TD> <h4> Address </h4> </TD>
<TD> <input type="text" name="address" />
</TD>
</TR>
<TR>
<TD> <h4>Phone Number</h4> </TD>
<TD> <input type="text" name="phoneNum" /> </TD>
</TR>
<TR>
<TD COLSPAN="2" ALIGN="CENTER" >
<input type="submit" value="save" />
<input type="reset" value="clear" />
</TD>
</TR>
</TABLE>
</form>
<h4>
<%-- A link to searchperson.jsp --%>
<a href="searchperson.jsp" > Search Person </a>
</h4>
</center>
</body>
</html>
CopyrightVirtualUniversityofPakistan
Page395
WebDesignandDevelopment(CS506)
saveperson.jsp
This JSP page gets data from the addperson.jsp, makes an object of PersonInfo and saves it to
the database using PersonDAOclass. Apart from these, it also displays an informative message
to the user if new person record is saved successfully into thedatabase and two hyperlinks to
navigate on to the desired pages as shown in the following diagram:
Page396
WebDesignandDevelopment(CS506)
<h3> New Person Record is saved successfully!</h3>
<h4>
<a href="addperson.jsp" > Add Person </a>
</h4>
<h4>
<a href="searchperson.jsp" > Search Person </a>
</h4>
</center>
</body>
</html>
searchperson.jsp
It gets search criteria from the user (i.e. name) and sends it to showperson.jspto display the search
results. The outlook of the page is given below:
Address Book
Search Person
Name
Save
Clear
Add Person
used to generate the above page given page is:
<%-- defining error page --%>
<%@page errorPage="addbookerror.jsp" %>
<html>
<body>
<center>
<h2> Address Book </h2>
<h3> Search Person</h3>
<%-Form that contains Text input field and sending it to showperson.jsp
--%>
CopyrightVirtualUniversityofPakistan
Page397
WebDesignandDevelopment(CS506)
<form name ="search" action="showperson.jsp" />
<TABLE BORDER="1" >
<TR>
<TD> <h4 >Name</h4>
</TD>
<TD> <input type="text" name="name" /> </TD>
</TR>
<TR>
<TD COLSPAN="2" ALIGN="CENTER"">
<input type="submit" value="search" />
<input type="reset" value="clear" />
</TD>
</TR>
</TABLE>
</form>
<h4>
<a href="addperson.jsp" > Add Person </a>
</h4>
</center>
</body>
</html>
showperson.jsp
showperson.jspreceives search criteria (i.e. name) from the searchperson.jsp, that is entered
by the user to find the matching record. This page retrieves the complete list of matching records
from the database using PersonDAO, and shows them to the user.
This following figure gives you the sight, when person named saad is searched.
Address Book
Following Result meet your research criteria
Name
Address
PhoneNo.
Saad
Gulberg
9700234
Add Person
Search Person
CopyrightVirtualUniversityofPakistan
Page398
WebDesignandDevelopment(CS506)
Below, the code of showperson.jsp is given:
<%-- defining error page --%>
<%@page errorPage="addbookerror.jsp" %>
<%-- importing required packages --%>
<%@page import="java.util.*" %>
<%@page import="vu.*" %>
<html>
<body>
<center>
<h2> Address Book </h2>
<h3> Following results meet your search criteria</h3>
<TABLE BORDER="1" >
<TR>
<TH> Name </TH>
<TH> Address </TH>
<TH> PhoneNum </TH>
</TR>
<jsp:useBean id="pDAO" class="vu.PersonDAO" scope="page" />
<%
// getting search criteria sent by searchperson.jsp
String pName = request.getParameter("name");
// retrieving matching records from the Database using
// retrievePersonList() method of PersonDAO
ArrayList personList = personDAO.retrievePersonList(pName);
PersonInfo person = null;
// Showing all matching records by iterating over ArrayList
for(int i=0; i<personList.size(); i++) {
person = (PersonInfo)personList.get(i);
%>
<TR>
<TD> <%= person.getName()%> </TD>
<TD> <%= person.getAddress()%> </TD>
<TD> <%= person.getPhoneNum()%> </TD>
</TR>
<%
} // end for
%>
</TABLE >
<a href="addperson.jsp" > Add Person </a>
<a href="searchperson.jsp" > Search Person </a>
</center>
</body>
CopyrightVirtualUniversityofPakistan
Page399
WebDesignandDevelopment(CS506)
</html>
addbookerror.jsp
This JSP error page is called implicitly by all other JSP pages whenever any uncaught/unhandled
exception occurs. It also finds out the type of the exception that is generated,and shows an
appropriate message to the user:
<%-- indicating that this is an error page --%>
<%@page isErrorPage="true" %>
<%-- importing class --%>
<%@page import = "java.sql.SQLException" %>
<html>
<head>
<title>Error</title>
</head>
<body>
<h2>
Error Page
</h2>
<h3>
<%-- scriptlet to determine exception type --%>
<%
if (exception instanceof SQLException) {
%>
An SQL Exception
<%
} else if (exception instanceof ClassNotFoundException){
%>
A Class Not Found Exception
<%
} else {
%>
A Exception
<%
} // end if-else
%>
<%-- end scriptlet to determine exception type --%>
occured while interacting with the database
</h3>
<h3>
The Error Message was
CopyrightVirtualUniversityofPakistan
Page400
WebDesignandDevelopment(CS506)
<%= exception.getMessage() %>
</h3>
<h3 > Please Try Again Later!
</h3>
<%-hyperlinks to return back to addperson.jsp or
searchperson.sjp
--%>
<h3>
<a href="controller.jsp?action=addperson" >
Add Person
</a>
<a href="controller.jsp?action=searchperson" >
Search Person
</a>
</h3>
</body>
</html>
Wireless
customer
HTMLview
WMLview
Administrat
or
JFC/Swing
view
Supplier
B2B agent
XMLbased
vebservcies
Enterpriseinformationsystem
Also, several problems can arise when applications contain a mixture of data access code,business
logic code, and presentation code. Such applications are difficult to maintain,because
CopyrightVirtualUniversityofPakistan
Page401
WebDesignandDevelopment(CS506)
interdependencies between all of the components cause strong ripple effects whenever a change is
made anywhere. High coupling makes classes difficult or impossible to reuse because they
depend on so many other classes. Adding new data views often requires re-implementing or
cutting and pasting business logic code, which then requires maintenance in multiple places. Data
access code suffers from the same problem, being cut and pasted among business logic methods.
The Model-View-Controller architecture solves these problems by decoupling data access, business
logic, and data presentation and user interaction. Such separation allows multiple views to share
the same enterprise data model, which makes supporting multiple clients easier to
implement, test, and maintain.
39.3.1 Participants and Responsibilities
The individuals responsibility of three participants (model, view & controller) is given below:
Model
The model represents the state of the component (i.e. its data and the methods required to
manipulate it) independent of how the component is viewed or rendered.
View
The view renders the contents of a model and specifies how that data should be presented.
There can be multiple views for the same model within single applications or model may
have different views in different applications or operating systems.
Controller
The controller translates interactions with the view into actions to be performed by the
model. In a web application, they appear as GET and POST HTTP requests. The actions
performed by the model include activating business processes or changing the state of the
model. Based on the user interactions and the outcome of the model actions, the controller
responds by selecting an appropriate view.
39.3.2 Evolution of MVC Architecture
In the beginning, we used no MVC. Then we had MVC Model 1 and MVC Model 2 architectures.
And people came up with so called web application frameworks such as Apache Struts based on
Model 2 architecture. And finally we have a standard web based application framework i.e.
JavaServer Faces (JSF).
In this handout, well only talk about MVC Model 1.
Page402
WebDesignandDevelopment(CS506)
(JSP page, servlet, HTML page, and so on) is determined either by hyperlinks selected in the
source document or by request parameters.
1
request
Browser
4
response
JSP
pages
2
3
JavaBean
Servlet
Container
EIS
In Model 1 architecture, view selection is decentralized, because the current page being displayed
determines the next page to display. In addition, each JSP page or servlet processes its own inputs
(parameters from GET or POST). And this is hard to maintain, for example, if you have to change
the view selection, then several JSP pages need to be changed. In some Model 1 architectures,
choosing the next page to display occurs in scriptlet code, but this usage is considered poor form.
In MVC Model 1 architecture, the JSP page alone is responsible for processing the incoming
request and replying back to the client. There is still separation of presentation from content,
because all data access is performed using JavaBeans.
Although the Model 1 architecture should be perfectly suitable for simple applications, it may not
be desirable for complex implementations. Random usage of this architecture usually leads to a
significant amount of scriptlets or Java code embedded within the JSP page, especially if there is a
significant amount of request processing to be performed. While this may not seem to be much of
a problem for Java developers, it is certainly an issue if your JSP pages are created and maintained
by designers which are only aware of HTML and some scripting language.
Note: Probably some of you must be thinking about the case study discussed earlier inthis
handout. Indeed, it is based on MVC Model 1 architecture.
39.4 References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page403
WebDesignandDevelopment(CS506)
Lecture 40: Model 2 Architecture MVC
We have studied page-centric approach and page-with-bean approach until now. You must be
wondering when we had covered these. Probably these buzz words are new one for you but we
already covered these topics. Lets review these once again.
40.1 Page-Centric Approach
A web application that is collection of JSPs. Generally this approach is followed to get started with
developing web applications. This approach is represented in the following diagram:
request
User
JSP
database
respons
The page-centric approach has lot of draw backs such as the code becomes a mixture of
presentation, business and data access logic. The maintenance and up-gradation of the application
becomes a nightmare. Scaling of such kind of application is also difficult and lots of code is also
get duplicated.
40.1.1 Page-with-Bean Approach (MVC Model1)
This approach is different from page-centric approach in a way that all the business logic goes
into JavaBeans. Therefore, the web application is a collection of JSPs and JavaBeans. But still
this approach is insufficient to separate different kind of logics. We have made an address book
example in the last handout using this approach.
request
User
JSP
bean
database
database
respons
Page404
WebDesignandDevelopment(CS506)
It gives the single point of control to perform security checks and to record logging information
It also encapsulates the incoming data into a form that is usable by the back-end MVC model.
Well discuss it with the help of an example.
The following figure will help you to understand the architecture and functioning of the
application that is built using MVC Model 2 architecture.
MVCDesignPattern
request
(Controller)
Servlet
Browser
2
3
(View)
JSP
(View)
JavaBean
response
ServletContainer
(EIS)
The client (browser) sends all the requests to the controller. Servlet/JSP acts as the Controller and
is in charge of the request processing and creation of any beans or objects(Models) used by the
JSP.
JSP is working as View and there is not much processing logic within the JSP page itself,it is
simply responsible for retrieving objects and/or beans, created by the Servlet,extracting dynamic
content from them and put them into the static templates.
40.3 Case Study: Address Book using MVC Model 2
The address book example that is built using page-with-bean approach will be modified
to incorporate controller. Well show you how to implement controller using JSP as well as with
servlet. Lets first incorporate controller using JSP.
40.3.1 Introducing a JSP as Controller
Add another JSP (controller.jsp) that
CopyrightVirtualUniversityofPakistan
Page405
WebDesignandDevelopment(CS506)
The program flow of this example is shown in the following diagram:
addPerson
.jsp
savePerson
.jsp
Controller
(JSP/Servlet)
exception
addBookerror
.jsp
showPerson
searchPerson
.jsp
.jsp
PersonInfo
PersonDAO
Java Beans
As you can see in the diagram that all the requests are submitted to controller which uses the
JavaBeans and forwards/redirects the user to another view (JSP)? If any exception arises on
controller or JSPs, the control would automatically be transferred to addbookerror.jspto
display an appropriate message.
40.3.2 How controller differentiates between requests?
Most likely, you must be thinking about it. The simplest solution lies in using the consistent
name (e.g. action) of the submit button across all the pages but with different and unique
values.
The same rule applies to hyperlinks that send the action parameter along with value by using
query string technique.
This eases the controllers job to identify which page is actually generated the request and what
to do next. The controller simply retrieves the value of action parameter using
request.getParameter()method. Now, if-else structure can be used to compare the possible
values of action to act upon the requested task.
CopyrightVirtualUniversityofPakistan
Page406
WebDesignandDevelopment(CS506)
Now, lets first see the code of JavaBean that is used in this example.
PersonInfo
This JavaBean is used to represent one person record. The code is given below:
package vu;
import java.io.*;
public class PersonInfo implements Serializable{
private String name;
private String address;
private int phoneNum;
// no argument constructor
public PersonInfo() {
name = "";
address = "";
phoneNum = 0;
}
// setters
public void setName(String n){
name = n;
}
public void setAddress(String a){
address = a;
}
public void setPhoneNum(int pNo){
phoneNum = pNo;
}
// getters
public String getName( ){
return name;
CopyrightVirtualUniversityofPakistan
Page407
WebDesignandDevelopment(CS506)
}
public String getAddress( ){
return address;
}
public int getPhoneNum( ){
return phoneNum;
}
} // end class PersonInfo
PersonDAO
This class will help in retrieving and storing persons records in database. The code is given
below:
package vu;
import java.util.*;
import java.sql.*;
public class PersonDAO{
private Connection con;
// default constructor
public PersonDAO() throws ClassNotFoundException , SQLException
{
establishConnection();
}
// method used to establish connection with db
private void establishConnection() throws ClassNotFoundException ,SQLException
{
// establishing conection
Class.forName("sun.jdbc.odbc.JdbcOdbcDriver");
String conUrl = "jdbc:odbc:PersonDSN";
con = DriverManager.getConnection(conUrl);
}
// used to search the person records against name and returns
CopyrightVirtualUniversityofPakistan
Page408
WebDesignandDevelopment(CS506)
// the ArrayList that contains only those PersonInfo objects
// which matches the search criteria i.e. name
public ArrayList retrievePersonList(String pName) throws SQLException
{
ArrayList personList = new ArrayList();
// preparing query
String sql = " SELECT * FROM Person WHERE name = ?";
PreparedStatement pStmt = con.prepareStatement(sql);
pStmt.setString( 1, pName);
// executing query
ResultSet rs = pStmt.executeQuery();
String name; String add; int pNo;
while ( rs.next() ) {
name = rs.getString("name");
add = rs.getString("address");
pNo = rs.getInt("phoneNumber");
// creating a CourseOutlineBean object
PersonInfo personBean = new PersonInfo();
personBean.setName(name);
personBean.setAddress(add);
personBean.setPhoneNum(pNo);
// adding a bean to arraylist
personList.add(personBean);
} // end while
return personList;
} // end retrievePersonList
// this method accepts an object of PersonInfo, and stores it
// into the database
CopyrightVirtualUniversityofPakistan
Page409
WebDesignandDevelopment(CS506)
public void addPerson(PersonInfo person) throws SQLException{
String sql = " INSERT INTO Person(name, address, phoneNumber) VALUES (?, ?, ?)";
PreparedStatement pStmt = con.prepareStatement(sql);
String name = person.getName();
String add = person.getAddress();
int pNo = person.getPhoneNum();
pStmt.setString( 1 , name );
pStmt.setString( 2 , add );
pStmt.setInt( 3 , pNo );
pStmt.executeUpdate();
} // end addPerson
// overriding finalize method to release acquired resources
public void finalize( ) {
try{
if(con != null){
con.close();
}
}catch(SQLException sqlex){
System.out.println(sqlex);
}
} // end finalize
} // end PersonDAO class
addperson.jsp
This page is used for entering a new person record into the database. Note that a hyperlink is also
given at the bottom of the page that takes the user to searchperson.jsp.
Note: Since we are following MVC model 2 architecture, so all the hyperlinks will also sends the
request to controller first which redirects the user to requested page.
CopyrightVirtualUniversityofPakistan
Page410
WebDesignandDevelopment(CS506)
AddressBook
AddNewPerson
Name
Address
PhoneNo
Save
Clear
SearchPerson
Page411
WebDesignandDevelopment(CS506)
<TABLE BORDER="1" >
<TR>
<TD> <h4> Name </h4>
</TD>
</TD>
</TR>
<TR>
<TD> <h4> Address </h4>
</TD>
</TD>
Page412
WebDesignandDevelopment(CS506)
</a>
</h4>
</center>
</body>
</html>
searchperson.jsp
This JSP is used to search the person record against name given in the text field. A hyperlink is
also given at the bottom of addperson.jsp.
Address Book
Search Person
Name
Save
Clear
Add Person
The code that is used to generate that above page is given below:
<%-- defining error page --%>
<%@page errorPage="addbookerror.jsp" %>
<html>
<body>
<center>
<h2> Address Book </h2>
<h3> Search Person</h3>
<form name ="search" action="controller.jsp" />
<TABLE BORDER="1" >
<TR>
CopyrightVirtualUniversityofPakistan
Page413
WebDesignandDevelopment(CS506)
<TD> <h4> Name </h4></TD>
<TD> <input type="text" name="name" />
</TD>
</TR>
<TR>
<TD COLSPAN="2" ALIGN="CENTER">
<%-The name of the button is still action but with
different value search.
--%>
<input type="submit" name ="action" value="search" />
<input type="reset" value="clear" />
</TD>
</TR>
</TABLE>
</form>
<h4>
<%-The action parameter with different value addperson are
part of hyperlink here as well.
--%>
<a href="controller.jsp?action=addperson" >
Add Person
</a>
</h4>
</center>
</body>
</html>
controller.jsp
As mentioned earlier that controller.jspidentifies the page which initiates the request and use
JavaBeans to save/search persons to/from database. Also its job list includes redirecting the user
CopyrightVirtualUniversityofPakistan
Page414
WebDesignandDevelopment(CS506)
to appropriate page.
Since this JSP is doing only processing therefore no view available. Lets check it out its code:
<%-- defining error page --%>
<%@page errorPage="addbookerror.jsp" %>
<%-- importing required packages. package vu contains JavaBeans -%>
<%@page import ="java.util.*" %>
<%@page import = "vu.*" %>
<html>
<body>
<%-- declaring PersonDAO object--%>
<jsp:useBean id="pDAO" class="vu.PersonDAO" scope="page" />
<%-scriptlet to identify JSP for redirection purpose if request comes from hyperlinks
--%>
<%
// retrieving action parameter value
// Remember that action is the name of buttons as well
// it is used in hyperlinks in making of query string
String action = request.getParameter("action");
// if "Add Person" hyperlink is clicked if (action.equals("addperson") ){
response.sendRedirect("addperson.jsp");
// if "Search Person" hyperlink is clicked
} else if (action.equals("searchperson")){
response.sendRedirect("searchperson.jsp");
// if "save" button is clicked of addperson.jsp
}else if (action.equals("save")) {
%>
// declaring PersonInfo obeject
CopyrightVirtualUniversityofPakistan
Page415
WebDesignandDevelopment(CS506)
<jsp:useBean id="personBean" class="vu.PersonInfo" scope="page"/>
<%-setting all properties of personBean object with input parameters using *
--%>
<jsp:setProperty name="personBean" property="*" />
<%-- to insert record into database--%>
<%
pDAO.addPerson(personBean);
// redirecting user to saveperson.jsp response.sendRedirect("saveperson.jsp");
%>
<%-- if "search" button is clicked on searchperson.jsp --%>
<%
}else if (action.equals("search") ) {
String pName = request.getParameter("name");
ArrayList personList = pDAO.retrievePersonList(pName);
// storing personList(contains PersonInfo objects) into
// request hashmap
request.setAttribute("list", personList);
%>
<%-forwarding request to showperson.jsp to retrieve stored arraylist
(list)
--%>
<jsp:forward page="showperson.jsp" />
<%
} // end if page == search
%>
</body>
</html>
CopyrightVirtualUniversityofPakistan
Page416
WebDesignandDevelopment(CS506)
saveperson.jsp
This page displays a successful message indicating that person record is saved. Its also give the
options to the user to move on to addperson.jspor searchperson.jsp through hyperlinks. Note
that these hyperlinks also first take the user to controller.jspthen on to requested page.
CopyrightVirtualUniversityofPakistan
Page417
WebDesignandDevelopment(CS506)
showperson.jsp
This following figure gives you the view when name saad is searched.
Address Book
Following Result meet your research criteria
Name
Address
PhoneNo.
Saad
Gulberg
9700234
Add Person
Search Person
Below, the code of showperson.jspis given:
<%-- defining error page --%>
<%@page errorPage="addbookerror.jsp" %>
<%-- importing required packages --%>
<%@page import="java.util.*" %>
<%@page import="vu.*" %>
<html>
<body>
<center>
<h2> Address Book </h2>
<h3> Following results meet your search criteria</h3>
<TABLE BORDER="1" >
<TR>
<TH> Name
</TH>
Page418
WebDesignandDevelopment(CS506)
</TR>
<%
// retrieving arraylist stored on controller.jsp to display
// PersonInfo objects
ArrayList personList = (ArrayList)request.getAttribute("list");
PersonInfo person = null;
for(int i=0; i<personList.size(); i++) {
person = (PersonInfo)personList.get(i);
%>
<%-- displaying PersonInfo details--%>
<TR>
<TD> <%= person.getName()%> </TD>
<TD> <%= person.getAddress()%> </TD>
<TD> <%= person.getPhoneNum()%> </TD>
</TR>
<%
} // end for
%>
</TABLE >
<h4>
<a href="controller.jsp?action=addperson"> Add Person </a>
<a href="controller.jsp?action=searchperson">Search Person</a>
</h4>
</center>
</body>
</html>
addbookerror.jsp
User will view this page only when any sort of exception is generated. The code of this page is
given below:
<%-- indicating that this is an error page --%>
CopyrightVirtualUniversityofPakistan
Page419
WebDesignandDevelopment(CS506)
<%@page isErrorPage="true" %>
<%-- importing class --%>
<%@page import = "java.sql.SQLException" %>
<html>
<head>
<title>Error</title>
</head>
<body>
<h2>
Error Page
</h2>
<h3>
<%-- scriptlet to determine exception type --%>
<%
if (exception instanceof SQLException) {
%>
An SQL Exception
<%
} else if (exception instanceof ClassNotFoundException){
%>
A Class Not Found Exception
<%
} else {
%>
A Exception
<%
} // end if-else
%>
<%-- end scriptlet to determine exception type --%>
occured while interacting with the database
</h3>
CopyrightVirtualUniversityofPakistan
Page420
WebDesignandDevelopment(CS506)
<h3>
The Error Message was
<%= exception.getMessage() %>
</h3>
<h3 > Please Try Again Later!
</h3>
(a
Page421
WebDesignandDevelopment(CS506)
are previously pointing to controller.jsp. For example the value of actionattribute of
formtag & the address of hyperlink in all concerned pages.
If controller is defined in web.xml as an alias of ControllerServlet.java, consider the
following fragment of code which shows the value of action attribute of form tag before and after
introducing change.
When controller.jsp is acting as a controller
<form name ="register" action="controller.jsp" />
When ControllerServlet.java is acting as a controller then value of action attribute becomes:
<form name ="register" action="controller" />
Similarly, the following comparison shows the code of hyperlinks used in the previous example
before and after making changes
When controller.jsp is acting as a controller
<a href="controller.jsp?action=searchperson" >
Search Person
</a>
When ControllerServlet.java is acting as a controller
<a href="controller?action=searchperson" >
Search Person
</a>
Passing Exceptions to an Error JSP from a Servlet
Servlet can use existing error pages (like addbookerror.jsp) to pass on the exceptions. Set the
request attribute to javax.servlet.jsp.JspExcpetion with the exception object you want to pass.
After that forwards the request to error page.
For example, the following code snippet is taken from ControllerServlet.java to
demonstrate how to pass SQLExceptionto addbookerror.jsp
Page422
WebDesignandDevelopment(CS506)
} // end catch
ControllerServlet.java
The following code is of servlet that is acting as a controller
package controller;
import vu.*;
import java.io.*;
import java.net.*;
import java.sql.*;
import java.util.*;
import javax.servlet.*;
import javax.servlet.http.*;
public class ControllerServlet extends HttpServlet {
// This method only calls
processRequest() protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
processRequest(request, response);
}
// This method only calls processRequest() protected void doPost(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException
{
processRequest(request, response);
}
protected void processRequest(HttpServletRequest request, HttpServletResponse response) throws
ServletException, IOException{
// retrieving value of action parameter
String userAction = request.getParameter("action");
// if request comes to move to addperson.jsp from hyperlink if (userAction.equals("addperson") ) {
response.sendRedirect("addperson.jsp");
// if request comes to move to searchperson.jsp from hyperlink
CopyrightVirtualUniversityofPakistan
Page423
WebDesignandDevelopment(CS506)
} else if (userAction.equals("searchperson")) {
response.sendRedirect("searchperson.jsp");
//
if (userAction.equals("save")) {
Page424
WebDesignandDevelopment(CS506)
String pNo = request.getParameter("phoneNum");
int phoneNum = Integer.parseInt(pNo);
person.setPhoneNum(phoneNum);
// calling PersonDAO method to save data into database
pDAO.addPerson(person);
// redirecting page to saveperson.jsp
response.sendRedirect("saveperson.jsp");
}catch (SQLException sqlex){
// setting SQLException instance request.setAttribute("javax.servlet.jsp.JspException" , sqlex);
RequestDispatcher rd = request.getRequestDispatcher("addbookerror.jsp");
rd.forward(request, response);
}catch (ClassNotFoundException cnfe){
// setting ClassNotFoundException instance
request.setAttribute("javax.servlet.jsp.JspException" , cnfe);
RequestDispatcher rd = request.getRequestDispatcher("addbookerror.jsp");
rd.forward(request, response);
}
}// end addperson()
// if request comes to search person record from database
private void searchPerson(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException{
try {
// creating PersonDAO object
PersonDAO pDAO = new PersonDAO();
String pName = request.getParameter("name");
// calling DAO method to retrieve personlist from database
// against name
ArrayList personList = pDAO.retrievePersonList(pName);
request.setAttribute("list", personList);
// forwarding request to showpeson, so it can render personlist
RequestDispatcher rd = request.getRequestDispatcher("showperson.jsp");
CopyrightVirtualUniversityofPakistan
Page425
WebDesignandDevelopment(CS506)
rd.forward(request, response);
}catch (SQLException sqlex){
// setting SQLException instance
request.setAttribute("javax.servlet.jsp.JspException" , sqlex);
RequestDispatcher rd = request.getRequestDispatcher("addbookerror.jsp");
rd.forward(request, response);
}catch (ClassNotFoundException cnfe){
// setting ClassNotFoundException instance
request.setAttribute("javax.servlet.jsp.JspException" , cnfe);
RequestDispatcher rd = request.getRequestDispatcher("addbookerror.jsp");
rd.forward(request, response);
}
}// end searchPerson()
} // end ControllerServlet
web.xml
As you already familiar, for accessing a servlet, you need to define a URL pattern in
web.xml. This is shown below:
<?xml version="1.0" encoding="UTF-8"?>
<web-app>
<servlet>
<servlet-name> ControllerServlet </servlet-name>
<servlet-class> controller.ControllerServlet </servlet-class>
</servlet>
<servlet-mapping>
<servlet-name> ControllerServlet </servlet-name>
<url-pattern> /controller </url-pattern>
</servlet-mapping>
</web-app>
40.4 References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page426
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page427
WebDesignandDevelopment(CS506)
Users
Presentationlayers
BussinessLlayers
DataLlayers
DataSources
Services
Services
As you can see in the figure, users can only interact with the presentation layer. The presentation
layer passes the user request to the business layer, which further passes the request to the data
layer. The data layer communicates with the data sources (like Database etc.) or other external
services in order to accomplish the user request.
Lets discuss each layers responsibility in detail:
41.1.1.1 Presentation Layer
It provides a user interface to the client/user to interact with the application. This is the only part
of the application visible to client.
Its job list includes collecting users input, validating users input (on client side using JavaScript
like technologies OR on server side), presenting the results of the request made by the user and
controlling the screen flow (which page/view will be visible to the user).
41.1.1.2 Business Layer
Also called application layer, it is only concerned with the application specific functionality. It is
used to implement business rules and to perform business tasks.
For example, in a banking system, this layer will provide the functionality of banking functions
such as opening an account, transferring of balance from one account to another, calculation of
taxes etc.
41.1.1.3 Data Layer
It is concerned with the management of the data & data sources of the system. Data sources can
be database, XML, web services, flat file etc. Encapsulates data retrieval & storage logic For
example, the address book application needs to retrieve all person records from a database to
display them to the user.
CopyrightVirtualUniversityofPakistan
Page428
WebDesignandDevelopment(CS506)
41.1.2 Tiers
As mentioned, layers help in building a tiered architecture. Like layers, there is no restriction on
using number of tiers. An application can be based on Single-tier, Two-tier,Three-tier or N-Tier
(application which have more than three tiers). The choice of using a tiered architecture is
contingent to the business requirements and the size of the application etc.
Tiers are physically separated from each other. Layers are spread across tiers to build up an
application. Two or more layers can reside on one tier. The following figure presents a three-tier
architectural view of an application.
Browser
Web Server
PresentationLayers
Cliet machine
BussinessLayers
Server machine
Application
Server
DB Server
DataLayers
EISLayers
DB machine
The client tier represents the client machine where actually web browser is running and usually
displays HTML. You can think of a Presentation as of two parts; one is on client side, for
example, HTML. There is also a presentation layer that is used to generate the client presentation
often called server presentation. Well discuss about it later.
The server machine can consist on a single server machine or more. Therefore, it is possible web
server is running on one server machine while application server on another. Web server is used
to execute web pages like JSPs whereas application server is used to run special business objects
like Enterprise JavaBeans (discussed later). The web layer and applications server can be on two
separate machines or they can be on same tier as shown in the diagram.
The database server is often running on a separate tier, i.e. DB machine often called Enterprise
information tier.
41.2 Layers Support in Java
The secret of wide spread use of Java lies in providing specific technology for each layer.This
not only eases the development by freeing the programmer for caring operational features but
only reduces the production time of the software.
CopyrightVirtualUniversityofPakistan
Page429
WebDesignandDevelopment(CS506)
In the following figure, Presentation is bifurcated into two layers. These are Client Presentation
layer and Server Presentation Layer. What client sees in a browser forms client presentation
layer while server presentation layer includes the Java technology components (JSP and
Servlets etc.) that are used to generate the client presentation.
Layers
Java/J2EETechnology
ClientPresentation
HTML/Applets
ServerPresentation
JSP/Servlets
Frameworks(Struts,JSFetc)
Business
JavaBeans/EJB
Data
DAO/Connectors
On business layer, JavaBeans (also referred as Plain Old Java Objects (POJO) ) can be
used. While moving towards a bigger architecture, the J2EE provides the special class that fits
in business layer i.e. Enterprise JavaBean (EJB).
EJBs are special java classes that are used to encapsulate business logic. They provide
additional benefits in building up an application such as scalability, robustness,scalability etc.
On data layer, Data Access Objects (DAO) can be used. Similarly you can use connectors.
There are other different specialized components provided in java that ease the development
of data layer.
41.3 J2EE Multi-Tiered Applications
In a typical J2EE Multi-Tiered application, a client can either be a swing based application or a
web based. As you can see in the following figure, clients can access the web server from
behind the firewall as well.
Suppose, our client is HTML based. Client does some processing on HTML and transports it to
web server. JSP and Servlets are possible technologies that can be used in a web server. However,
there are some Frameworks such as JSF etc that can be used in a web server. The classes which
form the presentation layer reside on web server and of course controllers are also used over here.
CopyrightVirtualUniversityofPakistan
Page430
WebDesignandDevelopment(CS506)
Firewall
Client
Client
J2EE
Application
Server
Enterprise
Enterprise
JavaBean
JavaBean
WebServer
WebServer
JSP,
JSP,
Servlets
Servlets
Enterprise
Enterprise
JavaBean
JavaBean
Enterprise
Information
System(EIS):
Relational
Database,
Legacy
Application,
ERP Systems
Client
HTML/
XM
Client
Middle
Tier
OtherServices:
OtherServices:
JNDI,JMS,
JNDI,JMS,
JavaMail
JavaMail
Enterprise
Information
Tier
Client
Tier
If web server, wants to perform some business process, it usually gets help from some business
layer components. The business layer component can be a simple JavaBean (POJO) but in a
typical J2EE architecture, EJBs are used. Enterprise JavaBeans interacts with the database or
information system to store and retrieve data.
EJBs and JSP/Servlets works in two different servers. As you already know, JSP and Servlets
runs in a web server where as EJBs requires an application server. But, generally application
server contains the web server as well.
Application server including web server generally resides on a single tier (machine),which is
often called middle tier. This tier stores and retrieves data from the Enterprise Information Tier
(EIS) which is a separate tier. The response sends back to the client by the middle tier can be
HTML, XML etc. This response can be seen on the separate tier know as client tier.
41.4 Case Study: Matrix Multiplication using Layers
Problem Statement
Calculate product of two matrices of order 2 * 2
Result of multiplication should be stored in DB as well as shown to the user.
Format
Input format
o input will be in 4,2,6,5 format separated by commas where 4,2 represents entries of
the first row
Display format
o Displays the matrix as a square
Storage format for DB
o Matrix will be stored as a string in the database along with the order of the matrix
CopyrightVirtualUniversityofPakistan
Page431
WebDesignandDevelopment(CS506)
o
The following figure shows the table design that will be used to store the results.
_
Matrix : Table
* Field
Data Type
Name
id
AutoNumber
mOrder
Text
mValues
Text
Client side
Presentation
Sever side
Presentation
Matrixinput.j
sp
Matrixresult.j
sp
ControllerServlet
Business Layer
MartrixMultiplier
Data Layer
CopyrightVirtualUniversityofPakistan
MatrixBean
Controller Layer
MartrixDAO
Page432
WebDesignandDevelopment(CS506)
The data layer has a class MatrixDAOthat is used to save the matrix result into database. As
mentioned in the problem statement, that resultant matrix should be saved in the database. So,
MatrixDAOis used to accomplish that.
MatrixDAOcalled by the MatrixMultiplier, a business layer class. The functionality list of
MatrixMultiplierincludes:
-Converting the user input string (e.g. 2,3,4,1) into a proper object i.e. a matrix data structure.
[
-Helps in calculating product of two matrices.
Controller layers class ControllerServletcalls the MatrixMultiplier. This layer calls the
various business methods (like multiplication of two matrices) of business layer class and got
the resultant matrix. Furthermore, ControllerServlet sends the output to the matrixresult.jsp
and receives the input from
matrixinput.jsp.
The MatrixBean representing matrix data structure, as you can see in the figure is used across
several layers. In fact, the object formed by MatrixMultiplier from a user input string is of
MatrixBean type. It is used to transfer data from one layer to another.
First, look on the MatrixBean code given below:
MatrixBean
package bo;
import java.io.*;
public class MatrixBean implements Serializable{
// a 2D array representing matrix
public int matrix[ ][ ] ;
// constructor
public MatrixBean()
{
matrix = new int[2][2];
matrix[0][0] = 0;
matrix[0][1] = 0;
matrix[1][0] = 0;
matrix[1][1] = 0;
}
// setter that takes 4 int values and assigns these to array
public void setMatrix(int w, int x, int y, int z){
CopyrightVirtualUniversityofPakistan
Page433
WebDesignandDevelopment(CS506)
matrix[0][0] = w;
matrix[0][1] = x;
matrix[1][0] = y;
matrix[1][1] = z;
}
// getter returning a 2D array
public int[ ][ ] getMatrix(){
return matrix;
}
// used to convert 2D array into string
public String toString(){
return matrix[0][0] + "," + matrix[0][1] + "," + matrix[1][0] + "," +matrix[1][1] ;
}
} // end MatrixBean
matrixinput.jsp
This JSP is used to collect the input for two matrices in the form of string such as 2,3,5,8.The data
will be submitted to ControllerServletfrom this page.
<html>
<body>
<h2>
Enter Two Matrices of order 2 * 2 to compute Product
</h2>
<h3>
<%-controller is an alias/URL pattern of ControllerServlet
--%>
<form name="matrixInput" action="controller" > First Matrix:
<input type="text" name = "firstMatrix" /> E.g. 2,3,4,1
<br/>
Second Matrix:
CopyrightVirtualUniversityofPakistan
Page434
WebDesignandDevelopment(CS506)
<input type="text" name = "secondMatrix" />
<br/>
<input type = "submit" value = "Calculate Product" />
</form>
</h3>
</body>
</html>
ControllerServlet
This servlet acting as a controller receives the input from matrixinput.jsp. Furthermore,it will
interact with the business layer class MatrixMultiplier to convert the string into a MatrixBean
object, and to multiply two matrices.
package controller;
import bl.*;
import bo.* ;
import java.io.*;
import java.net.*;
import javax.servlet.*;
import javax.servlet.http.*;
public class ControllerServlet extends HttpServlet {
// This method only calls processRequest()
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException{
processRequest(request, response);
}
// This method only calls processRequest()
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException{
processRequest(request, response);
}
CopyrightVirtualUniversityofPakistan
Page435
WebDesignandDevelopment(CS506)
Page436
WebDesignandDevelopment(CS506)
form of MatrixBean. This class also has a method convertToObject that takes a String and
returns back a MatrixBean object. MatrixMultiplier will also interact with the data layer class
MatrixDAO to store results in the database.
package bl;
import bo.*;
import dal.*;
public class MatrixMultiplier {
//constructor
public MatrixMultiplier( ) {
}
// used to convert a String (like 2,3,4,5) into a MatrixBean object
public MatrixBean convertToObject(String sMatrix){
//splitting received string into tokens by passing , as
//delimeter
String tokens[] = sMatrix.split(",");
//creating MatrixBean object
MatrixBean matrixBO = new MatrixBean();
// converting tokens into integers
int w = Integer.parseInt(tokens[0]);
int x = Integer.parseInt(tokens[1]);
int y = Integer.parseInt(tokens[2]);
int z = Integer.parseInt(tokens[3]);
// setting values into MatrixBean object by calling setter
matrixBO.setMatrix(w , x , y, z);
return matrixBO;
} // end convertToObject()
// used to multiply two matrices , receives two MatrixBean objects
// and returns the product in the form of MatrixBean as well
CopyrightVirtualUniversityofPakistan
Page437
WebDesignandDevelopment(CS506)
public MatrixBean multiply(MatrixBean fMatrix , MatrixBean sMatrix)
{
// creating MatrixBean object where product of the matrices will
// be
// stored
MatrixBean resultMatrix = new MatrixBean();
// retrieving two dimensional arrays from MatrixBeans object to
// perform multipication
int matrixA[ ][ ] = fMatrix.getMatrix();
int matrixB[ ][ ] = sMatrix.getMatrix();
int matrixC[ ][ ] = resultMatrix.getMatrix();
// code to multiply two matrices
for (int i=0; i<2; i++) {
for (int j=0; j<2; j++) {
for (int k=0; k<2; k++) {
matrixC[i][j] += (matrixA[i][k] * matrixB[k][j]);
}
}
// storing the product from 2d array to MatrixBean object by
// calling setter
resultMatrix.setMatrix( matrixC[0][0], matrixC[0][1], matrixC[1][0], matrixC[1][1] );
return resultMatrix;
} // end multiply()
// save results (MatrixBean containg product of two matrices)
//into
// database using DAO
public void saveResult( MatrixBean resultMatrix )
{
MatrixDAo dao=null;
try{
CopyrightVirtualUniversityofPakistan
Page438
WebDesignandDevelopment(CS506)
dao = newMatrixDAO();
} catch(ClassNotFoundException e){
} catch(SQLException e){
} dao.saveMatrix(resultMatrix);
}
} // end MatrixMulitplier
MatrixDAO
As class name depicts, it is used to store product results into database. Lets look on the
code to see how it is accomplished.
package dal;
import java.util.*;
import java.sql.*;
import bo.*;
public class MatrixDAO{
private Connection con;
// constructor
public MatrixDAO() throws ClassNotFoundException , SQLException{
establishConnection();
}
// method used to establish connection with db
private void establishConnection() throws ClassNotFoundException,SQLException{
// establishing conection
class.forName("sun.jdbc.odbc.JdbcOdbcDriver");
String conUrl = "jdbc:odbc:MatrixDSN";
con = DriverManager.getConnection(conUrl);
}
// used to store MatrixBean into database after converting it to
// a String
public void saveMatrix(MatrixBean matrix){
CopyrightVirtualUniversityofPakistan
Page439
WebDesignandDevelopment(CS506)
try{
String sql = "INSERT INTO Matrix(mOrder, mValues) VALUES (?,?)";
PreparedStatement pStmt = con.prepareStatement(sql);
// converting MatrixBean into String by calling toString()
String sMatrix = matrix.toString();
// setting order of matrix
pStmt.setString( 1 , "2*2" );
// setting matrix values in the form of string
pStmt.setString( 2 , sMatrix );
pStmt.executeUpdate();
}catch(SQLException sqlex){
System.out.println(sqlex);
}
} // end saveMatrix
// overriding finalize method to release acquired resources
public void finalize( ) {
try{
if(con != null){
con.close();
}
}catch(SQLException sex){ System.out.println(sex);
}
} // end finalize
} // end MatrixDAO class
matrixresult.jsp
Used to display resultant product of two matrices. The code is given below:
<%-- importing bo package that contains MatrixBean --%>
<%@ page import="bo.*"%>
CopyrightVirtualUniversityofPakistan
Page440
WebDesignandDevelopment(CS506)
<html>
<body>
<h1>The resultant Matrix is </h1>
<%-retrieving MatrixBean object from request, that was set on
ControllerServlet
--%>
<%
MatrixBean productMatrix = (MatrixBean)request.getAttribute("product");
// retrieving values in 2d array so that it can be displayed
int matrix[][] = productMatrix.getMatrix() ;
%>
<%-- displaying MatrixBeans object values --%>
<TABLE>
<TR>
<TD> <%= matrix[0][0] %> </TD>
<TD> <%= matrix[0][1] %> </TD>
</TR>
<TR>
<TD> <%= matrix[1][0] %> </TD>
<TD> <%= matrix[1][1] %> </TD>
</TR>
</TABLE>
</body>
</html>
web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app>
<servlet>
<servlet-name> ControllerServlet </servlet-name>
CopyrightVirtualUniversityofPakistan
Page441
WebDesignandDevelopment(CS506)
<servlet-class> controller.ControllerServlet </servlet-class>
</servlet>
<servlet-mapping>
<servlet-name> ControllerServlet </servlet-name>
<url-pattern> /controller </url-pattern>
</servlet-mapping>
</web-app>
41.5 References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page442
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page443
WebDesignandDevelopment(CS506)
1.MustDeclare
2.MustKnowType
<%
Person p = (Person) request.getAttribute(person)
%>
-----------------Person Name :<% = p.getName() %>
----------------<% if (p.getAddress().equals(defence) { %>
<% }%>
3.AwkwadSyntax
4.KnowledgeofScripting
Languagerequiredeven
forsimplemanipulation
Contrary to the above figure, have a look on the subsequent figure that gives you a hint how
useful EL can be?
1.DirectAccess
2.EasierSyntax
3.Betteradopted
expressionlanguage
CopyrightVirtualUniversityofPakistan
4.Allappdataieasily
accessable
Page444
WebDesignandDevelopment(CS506)
42.3 Expression Language Nuggets
Well discuss the following important pieces of EL. These are:
Syntax of EL
Expressions & identifiers
Arithmetic, logical & relational operators
Automatic type conversion
Access to beans, arrays, lists & maps
Access to set of implicit objects
42.3.1 EL Syntax
The format of writing any EL expression is:
$ { validExpression }
The valid expressions can consist on these individuals or combination of these given below:
Literals
Operators
Variables (object references)
Implicit call to function using property name
EL Literals
The list of literals that can be used as an EL expression and their possible values are
given in the tabular format below:
Page445
WebDesignandDevelopment(CS506)
${ 8*3 }
<%-- evaluates to 24 --%>
EL Operators
The lists of operators that can be used in EL expression are given below:
Identifiers in the expression language represent the names of objects stored in one of the JSP
scopes: page, request, session, or application. These types of objects are referred to scoped
variables throughout this handout.
EL has 11 reserved identifiers, corresponding to 11 implicit objects. All other identifiers
assumed to refer to scoped variables.
EL implicit Objects
The Expression Language defines a set of implicit objects given below in tabular format:
CopyrightVirtualUniversityofPakistan
Page446
WebDesignandDevelopment(CS506)
Category
JSP
Implicit Object
pageContext
Operator
The context for the JSP page, used to access the JSP
implicit objects such as request, response, session,
Scopes
pageScope
requestScope
attributes
A Map associating names & values of request scoped
attributes
sessionScope
attributes
applicationScope A Map associating names & values of application
param
scoped attributes
Maps a request parameter name to a single String
paramValues
parameter value.
Maps a request parameter name to an array of values
Request
header
Headers
headerValues
Cookies
cookie
Request
Parameters
Initialization initParam
Parameters
${ pageContext.response }
o Evaluates to responseimplicit object of JSP
${ param.name }
o This expression is equivalent to calling request.getParameter(name);
${ cookie.name.value }
o Returns the value of the first cookie with the given name
o Equivalent to
if (cookie.getName().equals(name){
String val = cookie.getValue();
}
CopyrightVirtualUniversityofPakistan
Page447
WebDesignandDevelopment(CS506)
Example Code: Summation of Two Numbers using EL
This simple example demonstrates you the capabilities of EL. index.jspis used to collect
input for two numbers and their sum is displayed on result.jspusing EL.
Lets first see the code of index.jsp
index.jsp
<html>
<body>
Enter two numbers to see their sum
<form action="result.jsp" >
First Number :
<input type="text" name="num1" />
<br>
Second Number:
<input type="text" name="num2" />
<input type="submit" value="Calculate Sum" />
</form>
</body>
</html>
result.jsp
<html>
<body>
<%-- The code to sum two numbers if we used scriptlet
<%
String no1 = request .getParameter("num1"); String no2 = request .getParameter("num2");
int num1 = Integer.parseInt(no1);
int num2 = Integer.parseInt(no2);
CopyrightVirtualUniversityofPakistan
Page448
WebDesignandDevelopment(CS506)
%>
Result is: <%= num1 + num2 %>
--%>
<%-- implicit Object param is used to access request parameters
By Using EL summing two numbers
--%>
Result is: ${param.num1 + param.num2}
</body>
</html>
CopyrightVirtualUniversityofPakistan
Page449
WebDesignandDevelopment(CS506)
o Storing a variable in request scope using JSP action tag
If we want to store p of type PersonInfo in request scope by using JSP action tags,
then well write:
<jsp:useBean id=p class=PersonInfo
scope=request/>
Later, you can change the properties of object p by using action tag as well.For example
<jsp:setProperty
name=p
property=name
value=ali
/>
You are already very much familiar of retrieving any stored scoped variable by using java
code and JSP action tags. Here, well discuss how EL retrieves scoped variables. As already
mentioned, identifiers in the valid expression represent the names of objects stored in one of
the JSP scopes: page, request, session and application.
When the expression language encounters an identifier, it searches for a scoped variable with
that name first in page scope,then in request scope,then in session scope,and finally in
application scope
Note: - If no such object is located in four scopes, null is returned.
For example, if weve stored PersonInfo object p in session scope by mean of any
mechanism discussed previously and have written the following EL expression to access the name
property of p
${p.name}
Then EL searches for p first in page scope, then in request scope, then in session scope where it
found p. After that it calls p.getName()method. This is also shown in pictorial form below:
Page scope
request scope
application scope
pP
Found
CallgetName()
application scope
CopyrightVirtualUniversityofPakistan
Page450
WebDesignandDevelopment(CS506)
42.3.3 EL Accessors
The dot (.) and bracket ([ ]) operator let you access identifies and their properties. The dot
operator typically used for accessing the properties of an object and the bracket operator is
generally used to retrieve elements of arrays and collections.
Dot (.)
operator
Assume that JavaBean PersonInfohas name property and its object personis stored in some
scope. Then to access the name property of personobject, well write the following
expression using EL:
$ {person.name}
identifier
property
The EL accesses the objects properties using the JavaBeans conventions therefore getName()
must be defined in PersonInfo. Moreover, if property being accessed itself an object, the dot
operator can be applied recursively. For example
$ {user.address.city}
identifier
property
Propertyof
address
Bracket ([ ]) operator
This operator can be applied to arrays & collections implementing List interface e.g.
ArrayListetc.
o Index of the element appears inside brackets
o For example, ${ personList[2] }returns the 3rd element stored in it Moreover,
this operator can also be applied to collections implementing Map interface e.g. HashMap
etc.
o Key is specified inside brackets
o For example, ${ myMap[id] }returns the value associated with the
CopyrightVirtualUniversityofPakistan
Page451
WebDesignandDevelopment(CS506)
42.3.4 EL Robust Features
Some powerful characteristics of Expression Language
are:
Multiple expressions can be combined and intermixed with static text. For example
$ { Hello ${user.firstName} ${user.lastName} }
EL also supports automatic type conversion; as a result primitive can implicitly wrap
and unwrap into/from their corresponding java classes. For example
begin = $ { student.marks }
int
Integer
Assume that personis null, then no exception would be thrown and the result would also be
null.
42.3.5 Using Expression Language
Expression Language can be used in following situations
In template text the value of the expression is inserted into the current output. E.g.
<h3> $ { } </h3>
CopyrightVirtualUniversityofPakistan
Page452
WebDesignandDevelopment(CS506)
Page453
WebDesignandDevelopment(CS506)
// getters
public String getName( ){
return name;
}
public String getAddress( ){
return address;
}
public int getPhoneNum( ){
return phoneNum;
}
}
PersonDAO.java
It is used to retrieve/search person records from database.
package vu;
import java.util.*;
import java.sql.*;
public class PersonDAO{
private Connection con;
// constructor
public PersonDAO() throws ClassNotFoundException , SQLException {
establishConnection();
}//used to establish connection with database
private void establishConnection()
throws ClassNotFoundException , SQLException{
// establishing connection
Class.forName("sun.jdbc.odbc.JdbcOdbcDriver");
String conUrl = "jdbc:odbc:PersonDSN";
con = DriverManager.getConnection(conUrl);
}
CopyrightVirtualUniversityofPakistan
Page454
WebDesignandDevelopment(CS506)
// used to search person records against name
public ArrayList retrievePersonList(String pName) throws SQLException{
ArrayList personList = new ArrayList();
String sql = " SELECT * FROM Person WHERE name = ?";
PreparedStatement pStmt = con.prepareStatement(sql);
pStmt.setString( 1, pName);
System.out.println("retrieve person list");
ResultSet rs = pStmt.executeQuery();
String name;
String add;
int pNo;
while ( rs.next() ) {
name = rs.getString("name");
add = rs.getString("address");
pNo = rs.getInt("phoneNumber");
// creating a PersonInfo object
PersonInfo personBean = new PersonInfo();
personBean.setName(name);
personBean.setAddress(add);
personBean.setPhoneNum(pNo);
// adding a bean to arraylist
personList.add(personBean);
} // end while
return personList;
} // end retrievePersonList
//overriding finalize method to release resources
public void finalize( ) {
try{
if(con != null){
con.close();
CopyrightVirtualUniversityofPakistan
Page455
WebDesignandDevelopment(CS506)
}
}catch(SQLException sex){
System.out.println(sex);
}
} // end finalize
} // end class
searchperson.jsp
This JSP is used to gather persons name from the user and submits this data to the
ControllerServlet.
<html>
<body>
<center>
<h2> Address Book </h2>
<h3> Search Person</h3>
<FORM name ="search" action="controllerservlet" />
<TABLE BORDER="1" >
<TR>
<TD> <h4 >Name</h4> </TD>
<TD> <input type="text" name="name" />
</TD>
</TR>
<html>
<body>
<center>
<h2> Address Book </h2>
<h3> Search Person</h3>
<FORM name ="search" action="controllerservlet" />
<TABLE BORDER="1" >
<TR>
<TD> <h4 >Name</h4> </TD>
<TD> <input type="text" name="name" />
</TD>
</TR>
CopyrightVirtualUniversityofPakistan
Page456
WebDesignandDevelopment(CS506)
ControllerServlet.java
The Controller Servlet receives request from searchperson.jsp and after fetching search
results from database, forwards the request to showperson.jsp.
package controller;
import vu.*;
import java.util.*;
import java.io.*;
import java.net.*;
import javax.servlet.*;
import javax.servlet.http.*;
public class ControllerServlet extends HttpServlet {
// This method only calls processRequest()
protected void doGet(HttpServletRequest request, HttpServletResponse response throws
ServletException, IOException e){
processRequest(request, response);
}
// This method only calls processRequest()
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws
ServletException, IOException {
processRequest(request, response);
}
protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
// defined below
searchPerson(request, response);
} // end processRequest()
protected void searchPerson(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
try {
CopyrightVirtualUniversityofPakistan
Page457
WebDesignandDevelopment(CS506)
Page458
WebDesignandDevelopment(CS506)
<h2> Address Book </h2>
<h3> Following results meet your search criteria</h3>
<TABLE BORDER="1" >
<TR>
<TH>Name</TH>
<TH>Address</TH>
<TH>PhoneNum</TH>
</TR>
<%-- start of scriptlet --%>
<%
// retrieving ArrayList from request scope
ArrayList personList =(ArrayList)request.getAttribute("plist");
PersonInfo person = null;
for(int i=0; i<personList.size(); i++) {
person = (PersonInfo)personList.get(i);
// storing PersonInfo object in request scope
/* As mentioned, an object must be stored in
some scope to work with Expression Language*/
request.setAttribute("p", person);
%>
<%-- end of scriptlet --%>
<TR>
<%-- accessing properties of stored PersonInfo
object with name p using EL --%>
<TD> ${ p.name } </TD>
<TD> ${ p.address} </TD>
<TD> ${ p.phoneNum} </TD>
<%-- The following expressions are now replaced by EL statements written above--%>
<%-- <%= person.getName()%> --%>
<%-- <%= person.getAddress()%> --%>
CopyrightVirtualUniversityofPakistan
Page459
WebDesignandDevelopment(CS506)
<%-- <%= person.getPhoneNum()%> --%>
</TR>
<%
} // end for
%>
</TABLE >
</center>
</body>
</html>
web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app>
<servlet>
<servlet-name> ControllerServlet </servlet-name>
<servlet-class> controller.ControllerServlet </servlet-class>
</servlet>
<servlet-mapping>
<servlet-name> ControllerServlet </servlet-name>
<url-pattern> /controllerservlet </url-pattern>
</servlet-mapping>
</web-app>
42.4 References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page460
WebDesignandDevelopment(CS506)
CopyrightVirtualUniversityofPakistan
Page461
WebDesignandDevelopment(CS506)
43.4 Twin Tag Libraries
JSTL comes in two flavors to support various skill set personal
Prefix
Core
http://java.sun.com/jsp/jstl/core
SQL
http://java.sun.com/jsp/jstl/sql
sql
Internationalization/ http://java.sun.com/jsp/jstl/fmt
fmt
XML
URI
http://java.sun.com/jsp/jstl/xml
Dynamic attribute values of JSTL tags are specified using JSP expression
(i.e. <%= expression %>)
o The RT based JSTL tag libraries along with URIs and preferred prefixes are given
below in tabular format
Library
URI
Prefix
Core
http://java.sun.com/jsp/jstl/core_rt
c_rt
SQL
http://java.sun.com/jsp/jstl/sql_rt
sql_rt
Internationalization/ http://java.sun.com/jsp/jstl/fmt_rt
fmt_rt
XML
x_rt
http://java.sun.com/jsp/jstl/xml_rt
Page462
WebDesignandDevelopment(CS506)
<%@taglib prefix=c uri=http://java.sun.com/jsp/jstl/core %>
And to use RT based core tag library, the taglibdirective appears as:
<%@taglib prefix=c_rt uri=http://java.sun.com/jsp/jstl/core_rt
%>
43.6 Working with Core Actions (tags)
The set of tags that are available in the Core tag library come into play for probably most
anything you will be doing in your JSPs such as:
Page463
WebDesignandDevelopment(CS506)
In the third example, a page scoped variable email is set to value of request
parameteremail
by using paramimplicit object. If email parameter is defined in JSP page as:
<input type=text value = email />
Then c:settag would be used as:
<c:set var=email scope=request value=param.email />
Using c:set with JavaBeans & Map
c:settag can also be used to change the property of a bean or the value against some key. For
this purpose, the syntax of the c:settag would look like this:
<c:set
target=bean/map
property=property/key
value=value
/>
If target is a bean, sets the value of the property specified. This process is equivalent to
<jsp:setProperty />JSP action tag.
If target is a Map, sets the value of the key specified
And of course, these beans and maps must be stored in some scope prior to any attempt is made
to change their properties.
For example, consider the following snippet of code that stores PersonInfos object person into
request scope using <jsp:useBean />tag. Then using c:settag,
persons name property is set to ali.
<jsp:useBean
/>
id=person
class=vu.PersonInfo
scope=request
Page464
WebDesignandDevelopment(CS506)
Consider the following examples in which the usage of c:outtag has shown. In the first
example, string Hello would be displayed
<c:out
In the second example, if request parameter num evaluates to null or an empty string then default
value 0 would be displayed.
<c:out
value = ${param.num}
default = 0 />
Page465
WebDesignandDevelopment(CS506)
Iteration over an Integer range
To iterate over a range of integers, the syntax of the c:forEachtag will look like:
<c:forEach var=name begin=expression end=expression
step=expression >
Body Content
</c:forEach>
The beginand endattributes should be either constant integer values or expressions evaluating to
integer values. They specify the initial value of the index for the iteration and the index value
at which iteration should cease, respectively. When iterating over a range of integers using
c:forEach, these two attributes are required and all others are optional.
The stepattribute specifies the amount to be added to the index after each iteration. Thus the
index of the iteration starts at the value of the beginattribute, is incremented by the value of
the stepattribute, and halts iteration when it exceeds the value of the endattribute. Note that if
the stepattribute is omitted, the step size defaults to 1.
If the varattribute is specified, then a scoped variable with the indicated name will be created
and assigned the current value of the index for each pass through the iteration. This scoped
variable has nested visibility that is it can only be accessed within the body of the c:forEach tag.
For example to generate squares corresponding to range of integer values, the c:forEachtag will
be used as:
<c:forEach var=x begin=0 end=10 step=2 >
<c:out value=${x * x} />
</c:forEach>
By executing the above code, following output would appear:
4 16 36 64 100
Iteration over a Collection
When iterating over the members of a collection and arrays etc, one additional attribute of the
c:forEachtag is used: the itemsattribute. Now the c:forEachtag will look similar to this:
<c:forEach var=name items=expression >
Body Content
</c:forEach>
When you use this form of the c:forEach tag, the items attribute is the only required
attribute. The value of the itemsattribute should be the collection/array over whose members
the iteration is to occur, and is typically specified using an EL expression. If a variable name is
also specified using varattribute, then the named variable will be bound to successive elements
of the collection for each iteration pass.
CopyrightVirtualUniversityofPakistan
Page466
WebDesignandDevelopment(CS506)
For example, to iterate over a String array (messages) using java code, we used to write in JSP:
<
%
for(int i=0; i<messages.length; i++) { String msg =
messages[i];
%
>
<%= msg %>
<
%
} // end for
%
>
This can be done using c:forEachtag in much simpler way as shown below:
<c:forEach var=msg items=${messages} >
<c:out value= ${msg} />
</c:forEach>
Similarly, to iterate over a persons ArrayListthat contains PersonInfo objects, w used to write
in JSP:
<%
ArrayList persons = (ArrayList)request.getAttribute(pList);
for(int i=0; i<persons.size(); i++) { PersonInfo p ==
(PersonInfo)persons.get(i); String name = p.getName();
%>
<%= name %>
<%
} // end for
%>
Indeed, the above task can be achieved in much simpler way using c:forEachtag as shown
below:
<c:forEach var=p items=${persons} >
<c:out value= ${p.name} />
</c:forEach>
The c:forEachtag processes each element of this list(persons) in turn, assigning it to a
scoped variable named p. Note that typecast is also not required.
Furthermore, you can use the begin, end, and stepattributes to restrict which elements of the
collection are included in the iteration.
CopyrightVirtualUniversityofPakistan
Page467
WebDesignandDevelopment(CS506)
c:if
Like ordinary Javas if, used to conditionally process the body content. It simply evaluates a
single test expression and then processes its body content only if that expression evaluates to
true. If not, the tag's body content is ignored. The syntax for writing c:iftag is:
<c:if test= expression >
Body Content
</c:if>
For example, to display a message a equals b if two strings a & b are equal, the c:if tag is
used as:
<c:if test= ${a == b} >
<h2> A equals B </h2>
</c:if>
c:choose
c:choosethe second conditionalization tag, used in cases in which mutually exclusively test
are required to determine what content should be displayed. The syntax is shown below:
<c:choose>
<c:when test= expression >
Body content
</c:when>
<c:otherwise >
Body content
</c:otherwise>
</c:choose>
Each condition to be tested is represented by a corresponding <c:when>tag, of which there
must be at least one. Only the body content of the first <c:when>tag whose test evaluates to
true will be processed. If none of the <c:when>tests return true, then the body content of the
<c:otherwise>tag will be processed.
Note, though, that the <c:otherwise>tag is optional; a <c:choose>tag can have at most one
nested <c:otherwise>tag. If all <c:when>tests are false and no <c:otherwise> action is present,
then no <c:choose>body content will be processed.
The example code given below illustrates the usage of c:choosetag in which two strings a &
b are compared and appropriates messages are displayed:
<c:choose>
CopyrightVirtualUniversityofPakistan
Page468
WebDesignandDevelopment(CS506)
<c:when test= a == b >
<h2> a equals b</h2>
</c:when>
<c:when test= a <= b >
<h2> a is less than b</h2>
</c:when>
<c:otherwise >
<h2> Dont know what a equals to </h2>
</c:otherwise>
</c:choose>
:Projects
:Files
:Runtime
Jstl_ex2
WebPages
WebServices
ConfigurationFiles
.
Libraries
Add Project
Add Library
Add JAR/Folder
The Add Library dialog box opens in front of you. Select JSTL 1.1 option and press Add Library
button. Now you can refer to any JSTL library in your JSPs.
CopyrightVirtualUniversityofPakistan
Page469
WebDesignandDevelopment(CS506)
:AddLibraries
Libraries
AbsoluteLayout
JSTL1.1
JUnit
Note: Remember that the JSTL 1.1 library is only added to current project. You have to repeat
this step for each project in which you want to incorporate JSTL.
Example Code: AddressBook using JSTL core tags
This is the modified version of AddressBook that was built using Expression Language in the last
handout. Only showperson.jspis modified to incorporate JSTL core tags along with Expression
Language in place of scriptlets. The remaining participants searchperson.jsp, ControllerServlet,
PersonInfoand PersonDAOleft unchanged. Lets look on the
code of each of these components:
PersonInfo.java
The JavaBean used to represent one person record.
package vu;
import java.io.*;
public class PersonInfo implements Serializable{
private String name; private String address; private int phoneNum;
// no argument constructor public PersonInfo() {
name = ""; address = ""; phoneNum = 0;
}
// setters
public void setName(String n){
CopyrightVirtualUniversityofPakistan
Page470
WebDesignandDevelopment(CS506)
name = n;
}
public void setAddress(String a){
address = a;
}
public void setPhoneNum(int pNo){
phoneNum = pNo;
}
// getters
public String getName( ){
return name;
}
public String getAddress( ){
return address;
}
public int getPhoneNum( ){
return phoneNum;
}}
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page471
WebDesignandDevelopment(CS506)
It's a fast form of validation: if something's wrong, the alarm is triggered upon submission
of the form.
You can safely display only one error at a time and focus on the wrong field, to help ensure
that the user correctly fills in all the details you need.
CopyrightVirtualUniversityofPakistan
Page472
WebDesignandDevelopment(CS506)
Client Side Validation Example
Name:
Age:
Submit
Page473
WebDesignandDevelopment(CS506)
// if value of age is negative, displaying a message if (thisform.age.value < 0 )
{
alert("Age can't be negative");
return false;
} // end of function
</SCRIPT> <!-end of script-- >
</HEAD>
<BODY>
<!- validateForm method is called and specified as a value of onsubmit value, if this method returns
false, the user remains on the same page -->
<FORM method="post" onsubmit="return validateForm(this)" action = greeting.jsp >
<h2> Client Side Validation Example </h2>
<BR/>
Name: <INPUT type="text" name="name" size="30" />
<BR/> <BR/>
Age: <INPUT type="text" name="age" size="30" />
<BR/> <BR/>
<INPUT type="submit" value="Submit">
</FORM>
</BODY>
</HTML>
CopyrightVirtualUniversityofPakistan
Page474
WebDesignandDevelopment(CS506)
44.2 JavaServer Faces (JSF)
JSF technology simplifies building the user interface for web applications. It does this by
providing a higher-level framework for working with your web applications. Some distinct
features will be discussed provided by this technology. To begin with, have a look on some
popular existing frameworks
Representing UI components
Managing their state
Handling events
Input validation
Data binding
Automatic conversion
Defining page navigation
Supporting internationalization and accessibility.
If you are familiar with Struts and Swing (the standard Java user interface framework for desktop
applications), think of JavaServer Faces as a combination of those two frameworks. Like Swing,
JSF provides a rich component model that eases event handling and component rendering; and
like Struts, JSF provides Web application lifecycle management through a controller servlet.
44.2.3 JSF UI Components
Some of the standard JavaServer Faces components are shown below:
CopyrightVirtualUniversityofPakistan
Page475
WebDesignandDevelopment(CS506)
ApplicationFieldGroup
NewGroupExistingGroup
NewGroupExistingGroup
ApplicationFieldType
NewGroupExistingGroup
NewGroupCellPhoneNumber
ApplicationFieldDisplay
SelectCheckboxes
NameOne
Two
Three
CopyrightVirtualUniversityofPakistan
Page476
WebDesignandDevelopment(CS506)
And some open course JavaServer Faces components are also available like:
And some third-party Java Server Faces components are also available:
Page477
WebDesignandDevelopment(CS506)
particular event is fired. You do this by writing event listeners.In other words, a JSF application
is event-driven.
For example, if you write a JSF code to create a button, you will write:
<h:commandButton value="Login
actionListener=#{customer.loginActionListener}
action=#{customer.login} />
The value attribute specifies the text that appeared on the face of a button, the
actionListenerattributes specifies to call the loginActionListenermethod written somewhere in a
Customerclass if an event is triggered and on which to go next,is decided by the loginmethod of
Customer class and given as a value of actionattribute.
The method specified in action attribute should return a String value as the returned
Stringvalue is used in page navigation.
Note: Many IDE provides visual support for JSF so you can drag and drop components instead
of writing tedious coding for defining JSF components as shown above. Sun Studio Creator is
a free open source IDE that provides visual support for JSF and can be downloaded form Sun
site.
The code examples are also built using this IDE.
class Customer {
public void loginActionListener(ActionEvent e)
{
}
public String login() {
return OK;
}}
Example Code: Hello User
The example code (hello user 1) is given along with the handout. It is strongly advised that
you must see the lecture video in order to learn how this example is built.
User will provide a name in the text field and his/her name after appending hello to it,would
be displayed on the same page.
Page478
WebDesignandDevelopment(CS506)
needs.
Some built-in validators are:
DoubleRangeValidator
Any numeric type, between specified maximum and minimum values
LongRangeValidator
Any numeric type convertible to long, between specified maximum and minimum
values
LengthValidator
Ensures that the length of a component's local value falls into a certain range
(between minimum & maximum). The value must be of String type.
Here is an example of a managed-bean element whose scope is session, meaning that an instance
of this bean is created at the beginning of a user session.
<managed-bean>
<managed-bean-name>myBean</managed-bean-name>
<managed-bean-class>myPackage.MyBean</managed-bean-class>
<managed-bean-scope>session</managed-bean-scope>
</managed-bean>
44.2.7 JSF Value Binding
Value binding expressions can be used inside of JSF components to:
CopyrightVirtualUniversityofPakistan
Page479
WebDesignandDevelopment(CS506)
Quickly retrieve Map, List, and array contents from a JavaBean.
Synchronize form contents with value objects across a number of requests.
The syntax of binding expressions is based on the JavaServer Pages (JSP) 2.0 Expression
Language. In JSP, expressions are delimited with "${}", but in JSF they are delimited
with "#{}".
44.2.8 JSF Method Binding
Unlike a value binding, a method binding does not represent an accessor method. Instead,
a method binding represents an activation method.
For example, binding an event handler to a method
<h:commandButton
actionListener=#{customer.loginActionListener}
/>
44.2.9 JSF Navigation
Page navigation determines the control flow of a Web application. JSF provides a default
navigational handler and this behavior can be configured in configuration. However, you
can do it visually in most tools like Sun Studio Creator
Note: We have quickly breezed through the JSF technology essentials due to shortage of
time. You must explore it by yourself to excel on it. You can find the resources in
the last handout to acquire further skills.
44.3 References:
Note: Coding exercises in working condition for this lecture are also available on Downloads
section of LMS.
CopyrightVirtualUniversityofPakistan
Page480
WebDesignandDevelopment(CS506)
45.1.1 Introduction
Web services are Web-based enterprise applications that use open, XML-based standards and
transport protocols to exchange data with calling clients.
Web Service is becoming one of those overly overloaded buzzwords these days. Due to their
increasing popularity, Java platform Enterprise Edition (J2EE) provides the APIs and tools you
need to create and deploy interoperable web services and clients.
CopyrightVirtualUniversityofPakistan
Page481
WebDesignandDevelopment(CS506)
Server
Server
Server
Server
Server
Webbasedcomputing
Server
ClientServer
silos
Mobile
Internet
Webservices/peertopeer
In the beginning, things were built and deployed typically in the form of client and server
model in which clients talk to a single server, for example, remote procedure calls (RPC).
The second phase can be called web-based computing in which many clients talk to
many servers through the net. In this phase, communicating partners still have to go through
some pre- arrangement in terms of what common object model they have to use or what
common communication protocol they have to agree upon.
Finally, the web services model in which service users and service providers can be
dynamically connected. And the pretty much every computing device and application
participates as both service user and service provider.
CopyrightVirtualUniversityofPakistan
Page482
WebDesignandDevelopment(CS506)
45.1.5 Why Web services?
Interoperable
Connect across heterogeneous networks using ubiquitous web-based standards
Economical
Recycle components, no installation and tight integration of software
Automatic
No human intervention required even for highly complex transactions
Accessible
Legacy assets & internal apps are exposed and accessible on the web
Available
Services on any device, anywhere, anytime
Scalable
No limits on scope of applications and amount of heterogeneous applications
Web Service
Has a UI
No GUI
At the minimum, you need a standard way of describing a web service that is universally
CopyrightVirtualUniversityofPakistan
Page483
WebDesignandDevelopment(CS506)
understood by all potential service users and service providers. This is important because
without commonly agreed upon description of service, a service provider might have to
produce individually tailored way of describing its service to all its potential service users.
Web Service Description Language (WSDL pronounced as viz-dal) is industry agreed
upon XML language that can be used to describe web service. It provides XML format for
describing web services in terms of methods, properties, data types and protocols.
Service Invocation
Then there has to be standard way of invoking a service. Finally, for business transactions
in which secure and reliable message delivery is important, there has to be a standard
electronic business framework.
The following figure represents simplified web service architecture and summarizes the
working of web services:
Register
1. Service Register
PUBLISH
Web
Services
3.Clientcalls
service
BIND
2.ClientRequest
ServerLocation
FIND
Services
Client
45.3 References:
Java A Lab Course by Umair
Javed
Web services overview by sang
shin
Note: Coding exercises in working condition for this lecture are also available on
Downloads section of LMS.
CopyrightVirtualUniversityofPakistan
Page484
WebDesignandDevelopment(CS506)
45.4 Resources:
http://java.sun.com
http://www.javaworld.com
http://www.theserverside.com
http://www.jsfcentral.com
http://www.jspolympus.com
http://www.onjava.com
CopyrightVirtualUniversityofPakistan
Page485