Software Information

Assertion in Java


Assertion facility is added in J2SE 1.4. In order to support this facility J2SE 1.4 added the keyword assert to the language, and AssertionError class. An assertion checks a boolean-typed expression that must be true during program runtime execution. The assertion facility can be enabled or disable at runtime.

Declaring Assertion

Assertion statements have two forms as given below

assert expression;

assert expression1 : expression2;

The first form is simple form of assertion, while second form takes another expression. In both of the form boolean expression represents condition that must be evaluate to true runtime.

If the condition evaluates to false and assertions are enabled, AssertionError will be thrown at runtime.

Some examples that use simple assertion form are as follows.

assert value > 5 ;

assert accontBalance > 0;

assert isStatusEnabled();

The expression that has to be asserted runtime must be boolean value. In third example isStatusEnabled() must return boolean value. If condition evaluates to true, execution continues normally, otherwise the AssertionError is thrown.

Following program uses simple form of assertion

//AssertionDemo.java

Class AssertionDemo{

Public static void main(String args[]){

System.out.println( withdrawMoney(1000,500) );

System.out.println( withdrawMoney(1000,2000) );

}

public double withdrawMoney(double balance , double amount){

assert balance >= amount;

return balance - amount;

}

}

In above given example, main method calls withdrawMoney method with balance and amount as arguments. The withdrawMoney method has a assert statement that checks whether the balance is grater than or equal to amount to be withdrawn. In first call the method will execute without any exception, but in second call it AssertionError is thrown if the assertion is enabled at runtime.

Enable/Disable Assertions

By default assertion are not enabled, but compiler complains if assert is used as an identifier or label. The following command will compile AssertionDemo with assertion enabled.

javac -source 1.4 AssertionDemo.java

The resulting AssertionDemo class file will contain assertion code.

By default assertion are disabled in Java runtime environment. The argument -eanbleassertion or -ea will enables assertion, while -disableassertion or -da will disable assertions at runtime.

The following command will run AssertionDemo with assertion enabled.

Java -ea AssertionDemo

or

Java -enableassertion AssertionDemo

Second form of Assertion

The second form of assertion takes another expression as an argument.

The syntax is,

assert expression1 : expression2;

where expression1 is the condition and must evaluate to true at runtime.

This statement is equivalent to

assert expression1 : throw new AssertionError(expression2);

Note: AssertionError is unchecked exception, because it is inherited from Error class.

Here, expression2 must evaluate to some value.

By default AssertionError doesn't provide useful message so this form can be helpful to display some informative message to the user.

Rahim Vindhani
Application Develper [Application Development & Webservices]
IBM Global Services, pune, India
email: rahim.vindhani@gmail.com
web: http://www.rahim.co.nr


MORE RESOURCES:

Sydney Morning Herald

New Apple software for iPhone 'bug fixes'
Newsday, NY - 15 hours ago
BY EMI ENDO | emi.endo@newsday.com Apple Inc. has released a software update for its iPhone aimed at improving its connection with faster wireless Internet ...
Apple's iPhone 2.0.2 software update didn't fix much Computerworld
Apple updates iPhone software to fix glitches Reuters
Jobs promises September iPhone software patch InfoWorld
ZDNet - NEWS.com.au
all 567 news articles


BuilderFusion(R) Inc. Named the 11th Fastest-Growing Software ...
MarketWatch - 1 hour ago
"Since its inception eight years ago, the BuilderFusion software has had a dramatic impact on professional associations across the United States, ...


Carnegie Learning(TM) Developmental Math Software Aligns with ...
MarketWatch - 4 hours ago
PITTSBURGH, Aug 21, 2008 (BUSINESS WIRE) -- Carnegie Learning, Inc. announced today that the company's developmental math software for higher education ...


BakBone Software Appoints New Chief Financial Officer
MarketWatch - 1 hour ago
The common shares of BakBone Software are currently subject to cease trade orders in the Canadian jurisdictions of Alberta, British Columbia and Ontario due ...


RTT News

Wall Street Beat: Salesforce, HP, M&A in the Spotlight
PC World - 1 hour ago
Salesforce is often seen as a bellwether for the SaaS (software-as-a-service) market, since it was one of the first companies to jump into hosted software, ...
Salesforce.com shares drop on outlook CNET News
Acquisition Costs Sink Salesforce (Update) TheStreet.com
Salesforce 2Q profit nearly triples, stock plunges Forbes
Register - Wall Street Journal Blogs
all 101 news articles


The Software, Called iClink, Allows Two-Way Wireless ...
MarketWatch - 7 hours ago
The software, called iClink, wirelessly synchronizes contacts, calendar events, and to-do items between the iPhone and Lotus Notes. The iClink software runs ...


American Software, Inc. Invites You to Join Its First Quarter ...
MarketWatch - 6 hours ago
What: American Software, Inc.'s First Quarter Fiscal Year 2009 Earnings Release When: September 4, 2008 5:00 pm ET Where: http://www.amsoftware.com How: ...


Tamale Software Launches Latest Version of Investment-Research ...
MarketWatch - 7 hours ago
The expanded scalability boosts the effectiveness of search and other functions -- making the software an ideal choice for an increasingly wide client base ...


Inc. Magazine Recognizes Nimsoft as the 36th Fastest Growing ...
MarketWatch - 8 hours ago
Last year, Nimsoft was ranked as the 49th Fastest Growing Software Company. This list is part of the Inc. 5000, the magazine's annual list of the fastest ...


Environmental Risk Services (ERS) Selects Locus' Environmental ...
MarketWatch - 11 hours ago
EIM's Software as a Service delivery model is also ideal for single site applications as the customer eliminates hardware/software purchases and maintenance ...

Software - Google News

home | site map
© 2006