13 java beans

© 2010 Marty Hall
Using JavaBeansg
in JSP
Originals of Slides and Source Code for Examples:
http://courses.coreservlets.com/Course-Materials/csajsp2.html
Customized Java EE Training: http://courses.coreservlets.com/
Servlets, JSP, JSF 2.0, Struts, Ajax, GWT 2.0, Spring, Hibernate, SOAP & RESTful Web Services, Java 6.
Developed and taught by well-known author and developer. At public venues or onsite at your location.2
© 2010 Marty Hall
For live Java EE training, please see training courses
at http://courses.coreservlets.com/.at http://courses.coreservlets.com/.
Servlets, JSP, Struts, JSF 1.x, JSF 2.0, Ajax (with jQuery, Dojo,
Prototype, Ext-JS, Google Closure, etc.), GWT 2.0 (with GXT),
Java 5, Java 6, SOAP-based and RESTful Web Services, Spring,g
Hibernate/JPA, and customized combinations of topics.
Taught by the author of Core Servlets and JSP, More
Servlets and JSP and this tutorial Available at public
Developed and taught by well-known author and developer. At public venues or onsite at your location.
Servlets and JSP, and this tutorial. Available at public
venues, or customized versions can be held on-site at your
organization. Contact hall@coreservlets.com for details.

Agenda
• Understanding the benefits of beans
– We will use standalone beans here. Later sections will
cover beans with MVC and the JSP expression language.
• Creating beans• Creating beans
• Installing bean classes on your server
• Accessing bean properties• Accessing bean properties
• Explicitly setting bean properties
• Automatically setting bean properties from• Automatically setting bean properties from
request parameters
• Sharing beans among multiple servlets andSharing beans among multiple servlets and
JSP pages
4
Uses of JSP Constructs
• Scripting elements calling servletScripting elements calling servlet
code directly
• Scripting elements calling servlet
Simple
Application
g g
code indirectly (by means of utility
classes)
B• Beans
• Servlet/JSP combo (MVC)
MVC ith JSP i l• MVC with JSP expression language
• Custom tags
MVC ith b t t d
Complex
Application • MVC with beans, custom tags, and
a framework like Struts or JSF
5
Application

Background: What Are Beans?
• Java classes that follow certain conventions
– Must have a zero-argument (empty) constructor
• You can satisfy this requirement either by explicitly
defining such a constructor or by omitting all constructorsg y g
– Should have no public instance variables (fields)
• You should already follow this practice and use accessor
methods instead of allowing direct access to fieldsmethods instead of allowing direct access to fields
– Persistent values should be accessed through methods
called getXxx and setXxx
• If class has method getTitle that returns a String, class is
said to have a String property named title
• Boolean properties may use isXxx instead of getXxx
• It is the name of the method, not instance var that matters!
– For more on beans, see http://java.sun.com/beans/docs/
6
More on Bean Properties
• Usual rule to turn method name into
property nameproperty name
– Drop the word “get” or “set” and change the next letter to
lowercase. Again, instance var name is irrelevant.
• Method name: getUserFirstName
• Property name: userFirstName
• Exception 1: boolean propertiesp p p
– If getter returns boolean or Boolean
• Method name: getPrime or isPrime
• Property name: primeProperty name: prime
• Exception 2: consecutive uppercase letters
– If two uppercase letters in a row after “get” or “set”
M th d tURL• Method name: getURL
• Property name: URL (not uRL)
7

Bean Properties: Examples
Method Names Property Name Example JSP Usage
getFirstName
setFirstName
firstName <jsp:getProperty … property="firstName"/>
<jsp:setProperty … property="firstName"/>
${customer.firstName}
isExecutive
setExecutive
(boolean property)
executive <jsp:getProperty … property="executive"/>
<jsp:setProperty … property="executive"/>
${customer.executive}
getExecutive
setExecutive
(boolean property)
executive <jsp:getProperty … property="executive"/>
<jsp:setProperty … property="executive"/>
${customer.executive}
getZIP
setZIP
ZIP <jsp:getProperty … property="ZIP"/>
<jsp:setProperty … property="ZIP"/>
${address.ZIP}
8
Note 1: property name does not exist anywhere in your code. It is just a shortcut for the method name.
Note 2: property name is derived only from method name. Instance variable name is irrelevant.
Why You Should Use
Accessors Not Public FieldsAccessors, Not Public Fields
• To be a bean, you cannot have public fields
• So, you should replace
public double speed;
• with• with
private double speed;
bli d bl d() {
Note: in Eclipse, after you create instance variable, if you R-click and choose “Source”,
it gives you option to generate getters and setters for you.
public double getSpeed() {
return(speed);
}
bli id tS d(d bl S d) {public void setSpeed(double newSpeed) {
speed = newSpeed;
}
Y h ld d thi i ll J d• You should do this in all your Java code
anyhow. Why?
9

Why You Should Use
• 1) You can put constraints on values
public void setSpeed(double newSpeed) {
if (newSpeed < 0) {
sendErrorMessage(...);
newSpeed = Math.abs(newSpeed);
}
speed = newSpeed;
}
– If users of your class accessed the fields directly, then
they would each be responsible for checking constraints.
10
Why You Should Use
• 2) You can change your internal
i i h h i i frepresentation without changing interface
// Now using metric units (kph, not mph)// g ( p , p )
public void setSpeed(double newSpeed) {
speedInKPH = convert(newSpeed);speedInKPH = convert(newSpeed);
}
p blic oid setSpeedInKPH(do ble ne Speed) {public void setSpeedInKPH(double newSpeed) {
speedInKPH = newSpeed;
}
11

Why You Should Use
• 3) You can perform arbitrary side effects
public double setSpeed(double newSpeed) {
speed = newSpeed;
updateSpeedometerDisplay();
}
– If users of your class accessed the fields directly, then
they would each be responsible for executing side effects.
Too much work and runs huge risk of having displayToo much work and runs huge risk of having display
inconsistent from actual values.
12
Using Beans: Basic Tasks
• jsp:useBean
I h i l hi l b ild b– In the simplest case, this element builds a new bean.
It is normally used as follows:
• <jsp:useBean id="beanName" class="package.Class" />
• jsp:setProperty
– This element modifies a bean property (i.e., calls a
setBlah method). It is normally used as follows:setBlah method). It is normally used as follows:
• <jsp:setProperty name="beanName"
property="propertyName"
value="propertyValue" />p p y
• jsp:getProperty
– This element reads and outputs the value of a bean
property It is used as follows:property. It is used as follows:
• <jsp:getProperty name="beanName"
property="propertyName" />
13

General Approach with Standalone
Pages and jsp:useBean TagsPages and jsp:useBean Tags
• Input form
– User submits form that refers to a JSP page
• <FORM ACTION="SomePage.jsp">
• JSP Page• JSP Page
– JSP page instantiates a bean
• <jsp:useBean id="myBean" class="…"/>j y
– You pass some request data to the bean
• <jsp:setProperty name="myBean"
property="customerID"property customerID
value="…"/>
– You output some value(s) derived from the request data
• <jsp:getProperty name="myBean"• <jsp:getProperty name= myBean
property="bankAccountBalance"/>
14
Building Beans: jsp:useBean
• Format
– <jsp:useBean id="name" class="package.Class" />
• Purpose
All i i i f J l i h li i J– Allow instantiation of Java classes without explicit Java
programming (XML-compatible syntax)
• NotesNotes
– Simple interpretation:
<jsp:useBean id="book1" class="coreservlets.Book" />
can be thought of as equivalent to the scriptletcan be thought of as equivalent to the scriptlet
<% coreservlets.Book book1 = new coreservlets.Book(); %>
– But jsp:useBean has two additional advantages:
• It is easier to derive object values from request parameters
• It is easier to share objects among pages or servlets
15

Setting Simple Bean Properties:
jsp:setPropertyjsp:setProperty
• Format
– <jsp:setProperty name="name"
property="property"
value="value" />value value /
• Purpose
– Allow setting of bean properties (i.e., calls to setXxxg p p (
methods) without explicit Java programming
• Notes
j P "b k1"– <jsp:setProperty name="book1"
property="title"
value="Core Servlets and JavaServer Pages" />
i i l h f ll i i lis equivalent to the following scriptlet
<% book1.setTitle("Core Servlets and JavaServer Pages"); %>
16
Accessing Bean Properties:
jsp:getPropertyjsp:getProperty
• Format
– <jsp:getProperty name="name" property="property" />
• Purpose
All b i (i ll X– Allow access to bean properties (i.e., calls to getXxx
methods) without explicit Java programming
• NotesNotes
– <jsp:getProperty name="book1" property="title" />
is equivalent to the following JSP expressionq g p
<%= book1.getTitle() %>
17

Example: StringBean
package coreservlets;
public class StringBean {
private String message = "No message specified";
public String getMessage() {
return(message);
}
public void setMessage(String message) {
hithis.message = message;
}
}
• Beans installed in normal Java directory• Beans installed in normal Java directory
– MyEclipse: src/folderMatchingPackage
– Deployment: WEB-INF/classes/folderMatchingPackagep y f g g
• Beans must always be in packages!
18
JSP Page That Uses StringBean
(Code)(Code)
<jsp:useBean id="stringBean"
class="coreservlets.StringBean" />g /
<OL>
<LI>Initial value (from jsp:getProperty):
<I><jsp:getProperty name="stringBean"
property="message" /></I>property="message" /></I>
<LI>Initial value (from JSP expression):
<I><%= stringBean.getMessage() %></I>
<LI><jsp:setProperty name="stringBean"
property="message"
value="Best string bean: Fortex" />
Value after setting property with jsp:setProperty:
<I><jsp:getProperty name="stringBean"<I><jsp:getProperty name= stringBean
property="message" /></I>
<LI><% stringBean.setMessage
("My favorite: Kentucky Wonder"); %>
Value after setting property with scriptlet:
<I><%= stringBean.getMessage() %></I>
</OL>
19

JSP Page That Uses StringBean
(Result)(Result)
20
Setting Bean Properties Case 1:
Explicit Conversion & AssignmentExplicit Conversion & Assignment
<!DOCTYPE ...>
...
<jsp:useBean id="entry"
class="coreservlets.SaleEntry" />
<%-- setItemID expects a String --%>
<jsp:setPropertyj p p y
name="entry"
property="itemID"
value='<%= request.getParameter("itemID") %>' />q g
21

<%
int numItemsOrdered = 1;int numItemsOrdered = 1;
try {
numItemsOrdered =
Integer parseInt(request getParameter("numItems"));Integer.parseInt(request.getParameter( numItems ));
} catch(NumberFormatException nfe) {}
%>
<%-- setNumItems expects an int --%>
<jsp:setPropertyjsp:set ope ty
name="entry"
property="numItems"
value="<%= numItemsOrdered %>" />/
22
<%
double discountCode = 1 0;double discountCode = 1.0;
try {
String discountString =
request getParameter("discountCode");request.getParameter( discountCode );
discountCode =
Double.parseDouble(discountString);
} catch(NumberFormatException nfe) {}} catch(NumberFormatException nfe) {}
%>
<%-- setDiscountCode expects a double --%>% set scou tCode e pects a doub e %
<jsp:setProperty
name="entry"y
property="discountCode"
value="<%= discountCode %>" />
23

24
Case 2: Associating Individual
Properties with Input ParametersProperties with Input Parameters
• Use the param attribute of jsp:setProperty
i di hto indicate that
– Value should come from specified request parameter
Simple automatic type conversion should be performed– Simple automatic type conversion should be performed
for properties that expect values of standard types
• boolean, Boolean, byte, Byte, char, Character, double,
D bl i t I t fl t Fl t l LDouble, int, Integer, float, Float, long, or Long.
25

Case 2: Associating Individual
Properties with Input ParametersProperties with Input Parameters
class="coreservlets SaleEntry" />class="coreservlets.SaleEntry" />
<jsp:setProperty
name="entry"
property="itemID"
param="itemID" />
<jsp:setProperty
name="entry"
property="numItems"
param="numItems" />p /
<jsp:setProperty
name="entry"
property="discountCode"property= discountCode
param="discountCode" />
26
Case 3: Associating All Properties
with Input Parameterswith Input Parameters
• Use "*" for the value of the property
ib f j P i di hattribute of jsp:setProperty to indicate that
– Value should come from request parameter whose name
matches property namematches property name
– Simple automatic type conversion should be performed
27

Case 3: Associating All Properties
with Input Parameterswith Input Parameters
l " l t S l E t " />class="coreservlets.SaleEntry" />
<jsp:setProperty name="entry" property="*" />
• This is extremely convenient for making
"form beans" -- objects whose properties
fill d i f f b i iare filled in from a form submission.
– You can even divide the process up across multiple
forms, where each submission fills in part of the object.forms, where each submission fills in part of the object.
28
Sharing Beans
• You can use the scope attribute to specify
ddi i l l h b i dadditional places where bean is stored
– Still also bound to local variable in _jspService
<jsp:useBean id=" " class=" "– <jsp:useBean id="…" class="…"
scope="…" />
• Lets multiple servlets or JSP pagesp p g
share data
• Also permits conditional bean creation
– Creates new object only if it can't find existing one
29

Sharing Beans: Example
• page1.jsp
j B id "f " l " " " li i "/<jsp:useBean id="foo" class="…" scope="application"/>
<jsp:setProperty name="foo" property="message"
value="Hello"/>
<jsp:getProperty name="foo" property="message"/>
• page2.jsp
<jsp:useBean id="foo" class="…" scope="application"/>j p p pp
<jsp:getProperty name="foo" property="message"/>
• Possible scenario 1
J t 2 ( t t i "D f lt M ")– Joe goes to page 2 (output is "Default Message")
– Jane goes to page 1 (output is "Hello")
• Possible scenario 2
– Joe goes to page 1 (output is "Hello")
– Jane goes to page 2 (output is "Hello")
30
Values of the scope Attribute
• page (<jsp:useBean … scope="page"/> or
j B )<jsp:useBean…>)
– Default value. Bean object should be placed in the
PageContext object for the duration of the currentPageContext object for the duration of the current
request. Lets methods in same servlet access bean
• application
(<jsp:useBean … scope="application"/>)
– Bean will be stored in ServletContext (available through
the application variable or by call to getServletContext())the application variable or by call to getServletContext()).
ServletContext is shared by all servlets in the same Web
application (or all servlets on server if no explicit Web
li i d fi d)applications are defined).
31

Values of the scope Attribute
• session
( j B " i "/ )(<jsp:useBean … scope="session"/>)
– Bean will be stored in the HttpSession object associated
with the current request where it can be accessed fromwith the current request, where it can be accessed from
regular servlet code with getAttribute and setAttribute, as
with normal session objects.
• request
(<jsp:useBean … scope="request"/>)
Bean object should be placed in the ServletRequest object– Bean object should be placed in the ServletRequest object
for the duration of the current request, where it is
available by means of getAttribute
32
Sharing Beans in Four Different
WaysWays
• Using unshared (page-scoped) beans.
• Sharing request-scoped beans.
• Sharing session-scoped beans.
• Sharing application-scoped (i.e.,
ServletContext-scoped) beans.
• Important:
Use different names (i e id in jsp:useBean) for different– Use different names (i.e., id in jsp:useBean) for different
beans
• Don't store beans in different places with same id33

Sharing Beans Four Ways:
Bean CodeBean Code
package coreservlets;
……
public class BakedBean implements Serializable {
private String level = "half-baked";
private String goesWith = "hot dogs";
public String getLevel() {
return(level);
}}
public void setLevel(String newLevel) {
level = newLevel;
}
public String getGoesWith() {
return(goesWith);
}
public void setGoesWith(String dish) {public void setGoesWith(String dish) {
goesWith = dish;
}
}34
Sharing Beans Example 1:
Page-Scoped (Unshared)Page-Scoped (Unshared)
• Create the bean
– Use jsp:useBean with scope="page" (or no scope at all,
since page is the default).
• Modify the bean• Modify the bean
– Use jsp:setProperty with property="*".
– Then, supply request parameters that match the bean, pp y q p
property names.
• Access the bean
– Use jsp:getProperty.
35

Page-Scoped (Unshared)Page-Scoped (Unshared)
…
<BODY><BODY>
<H1>Baked Bean Values: page-based Sharing</H1>
<jsp:useBean id="pageBean"
class="coreservlets BakedBean" />class="coreservlets.BakedBean" />
<jsp:setProperty name="pageBean" property="*" />
<H2>Bean level:
<j tP t " B "<jsp:getProperty name="pageBean"
property="level" />
</H2>
2<H2>Dish bean goes with:
<jsp:getProperty name="pageBean"
property="goesWith" />
</H2>
</BODY></HTML>
36
Result (Initial Request)Result (Initial Request)
37

Result (Later Request)Result (Later Request)
38
Request-Based SharingRequest-Based Sharing
• Create the bean
U j B ith " t"– Use jsp:useBean with scope="request".
• Modify the bean
– Use jsp:setProperty with property="*".j p p y p p y
– Then, supply request parameters that match the bean
property names.
• Access the bean in the 1st (main) page• Access the bean in the 1st (main) page
– Use jsp:getProperty.
– Then, use jsp:include to invoke the second page.
• Access the bean in the 2nd (included) page
– Use jsp:useBean with the same id as on the first page,
again with scope="request".again with scope request .
– Then, use jsp:getProperty.
39

Request-Based Sharing:
Code for Main PageCode for Main Page
…
<BODY><BODY>
<H1>Baked Bean Values: request-based Sharing</H1>
<jsp:useBean id="requestBean"
class="coreservlets BakedBean"class= coreservlets.BakedBean
scope="request" />
<jsp:setProperty name="requestBean"
property="*" />property />
<H2>Bean level:
<jsp:getProperty name="requestBean"
property="level" /></H2>p ope ty e e / /
<H2>Dish bean goes with:
property="goesWith" /></H2>p p y g / /
<jsp:include page=
"/WEB-INF/includes/BakedBeanDisplay-snippet.jsp"/>
</BODY></HTML>40
Code for Included PageCode for Included Page
<H1>Repeated Baked Bean Values:
request-based Sharing</H1>request-based Sharing</H1>
<jsp:useBean id="requestBean"
class="coreservlets.BakedBean"
scope="request" />scope="request" />
<H2>Bean level:
t "l l" />property="level" />
</H2>
</H2>
41

42
Result (Later Request)Result (Later Request)
43

Session-Based SharingSession-Based Sharing
• Create the bean
U j B i h " i "– Use jsp:useBean with scope="session".
• Modify the bean
– Then, supply request parameters that match the bean property
names.
• Access the bean in the initial requestAccess the bean in the initial request
– Use jsp:getProperty in the request in which jsp:setProperty is
invoked.
• Access the bean later• Access the bean later
– Use jsp:getProperty in a request that does not include request
parameters and thus does not invoke jsp:setProperty. If this request
is from the same client (within the session timeout) the previouslyis from the same client (within the session timeout), the previously
modified value is seen. If this request is from a different client (or
after the session timeout), a newly created bean is seen.
44
Session-Based Sharing: Code
…
<BODY><BODY>
<H1>Baked Bean Values: session-based Sharing</H1>
<jsp:useBean id="sessionBean"
class="coreservlets BakedBean"class="coreservlets.BakedBean"
scope="session" />
<jsp:setProperty name="sessionBean"
t "*" />property="*" />
<H2>Bean level:
<jsp:getProperty name="sessionBean"
/property="level" />
</H2>
<jsp:getProperty name="sessionBean"
</H2></BODY></HTML>45

Session-Based Sharing: Result
(Initial Request)(Initial Request)
46
(Later Request -- Same Client)(Later Request -- Same Client)
47

(Later Request -- New Client)(Later Request -- New Client)
48
Application-Based SharingApplication-Based Sharing
• Create the bean
U j B i h " li i "– Use jsp:useBean with scope="application".
• Modify the bean
– Then, supply request parameters that match the bean property
names.
• Access the bean in the initial requestAccess the bean in the initial request
– Use jsp:getProperty in the request in which jsp:setProperty is
invoked.
• Access the bean later• Access the bean later
– Use jsp:getProperty in a request that does not include request
parameters and thus does not invoke jsp:setProperty. Whether this
request is from the same client or a different client (regardless of therequest is from the same client or a different client (regardless of the
session timeout), the previously modified value is seen.
49

Application-Based Sharing:
CodeCode
<BODY>
<H1>Baked Bean Values:<H1>Baked Bean Values:
application-based Sharing</H1>
<jsp:useBean id="applicationBean"
class="coreservlets BakedBean"class="coreservlets.BakedBean"
scope="application" />
<jsp:setProperty name="applicationBean"
t "*" />property="*" />
<H2>Bean level:
<jsp:getProperty name="applicationBean"
/property="level" />
</H2>
<jsp:getProperty name="applicationBean"
property="goesWith"/>
</H2></BODY></HTML>50
Application-Based Sharing:
51

Application-Based Sharing: Result
(Later Request -- Same Client)(Later Request -- Same Client)
52
Application-Based Sharing: Result
(Later Request -- New Client)(Later Request New Client)
53

Conditional Bean Operations
• Bean conditionally created
– jsp:useBean results in new bean being instantiated only if
no bean with same id and scope can be found.
– If a bean with same id and scope is found the preexisting– If a bean with same id and scope is found, the preexisting
bean is simply bound to variable referenced by id.
• Bean properties conditionally setp p y
– <jsp:useBean ... />
replaced by
<jsp:useBean >statements</jsp:useBean><jsp:useBean ...>statements</jsp:useBean>
– The statements (jsp:setProperty elements) are executed
only if a new bean is created, not if an existing bean is
found.
54
Conditional Bean Creation:
AccessCountBeanAccessCountBean
public class AccessCountBean {
private String firstPage;p g g
private int accessCount = 1;
public String getFirstPage() {
return(firstPage);return(firstPage);
}
public void setFirstPage(String firstPage) {
this firstPage = firstPage;this.firstPage = firstPage;
}
public int getAccessCount() {
t ( C t)return(accessCount);
}
public void setAccessCountIncrement(int increment) {
accessCount = accessCount + increment;
}
}
55

Conditional Bean Creation:
SharedCounts1 jspSharedCounts1.jsp
<jsp:useBean id="counter"
class="coreservlets.AccessCountBean"
scope="application">
<jsp:setProperty name="counter"
property="firstPage"
value="SharedCounts1.jsp" />value SharedCounts1.jsp />
</jsp:useBean>
Of SharedCounts1.jsp (this page),
<A HREF="SharedCounts2.jsp">SharedCounts2.jsp</A>, and
<A HREF="SharedCounts3 jsp">SharedCounts3 jsp</A><A HREF="SharedCounts3.jsp">SharedCounts3.jsp</A>,
<jsp:getProperty name="counter" property="firstPage" />
was the first page accessed.
<P>
C ll ti l th th h b dCollectively, the three pages have been accessed
<jsp:getProperty name="counter" property="accessCount" />
times.
<jsp:setProperty name="counter"
property="accessCountIncrement"
value="1" />
56
Accessing SharedCounts1,
SharedCounts2 SharedCounts3SharedCounts2, SharedCounts3
• SharedCounts2.jsp was accessed first.
• Pages have been accessed twelve previous
times by an arbitrary number of clients
57

Summary
• Benefits of jsp:useBean
– Hides the Java syntax
– Makes it easier to associate request parameters with Java
objects (bean properties)objects (bean properties)
– Simplifies sharing objects among multiple requests or
servlets/JSPs
j B• jsp:useBean
– Creates or accesses a bean
• jsp:setProperty• jsp:setProperty
– Sets bean property (i.e. passes value to setXxx)
• You usually use property="*" to pass in request paramsy p p y p q p
• jsp:getProperty
– Puts bean property (i.e. getXxx call) into servlet output58
© 2010 Marty Hall
Questions?
Developed and taught by well-known author and developer. At public venues or onsite at your location.59

13 java beans

More Related Content

What's hot (18)

Similar to 13 java beans (20)

More from snopteck (13)

Recently uploaded (20)

13 java beans