What is "dwr"

The DWR project was started by Joe Walker in 2004, 1.0 released at 29 Aug 2005. DWR, or Direct Web Remoting, is a Java open source library that helps developers write web sites that include Ajax technology. It allows code in a web browser to use Java functions running on a web server as if those functions were within the browser.

It consists of two main parts:

• Code to allow JavaScript to retrieve data from a servlet-based web server using Ajax principles.
• A JavaScript library that makes it easier for the web site developer to dynamically update the web page with the retrieved data.

DWR takes a novel approach to Ajax by dynamically generating JavaScript code based on Java classes. Thus the web developer can use Java code from JavaScript as if it were local to the web browser; whereas in reality the Java code runs in the web server and has full access to web server resources. For security reasons the web developer must configure exactly which Java classes are safe to export (which is often called web.xml or dwr.xml).

This method of remoting functions from Java to JavaScript gives DWR users a feel much like conventional RPC mechanisms like RMI or SOAP, with the benefit that it runs over the web without requiring web browser plug-ins.

DWR does not consider the web browser / web server protocol to be important, and prefers to ensure that the programmer's interface is natural. The greatest challenge to this is to marry the asynchronous nature of Ajax with the synchronous nature of normal Java method calls.

In the asynchronous model, result data is only available some time after the initial call is made. DWR solves this problem by allowing the web developer to specify a function to be called when the data is returned using an extra method parameter. This extra method is called CallBack Method. The value returned from the java function will be passed to the callback method.

Here is a sample Callback:

MJavaClassOnJs.getListProducts(selectedCategory,{ callback:function(returnedList){ dwr.util.addOptions(myComboId,returnedList,"productId","productName") } })

The callback is that function inside the Json object passed as an additional parameter to the remoted function.

With version 2.0, DWR supports Comet (also called "Reverse Ajax) where Java code running on the server can deliberately send dedicated JavaScript to a browser.

DWR is an acronym that could stand for:

• California Department of Water Resources, a department within the state cabinet-level California Natural Resources Agency
• Direct Web Remoting, a Java open source library
• Durable water repellent, a type of fabric coating
• The Duke of Wellington's Regiment (West Riding), a regiment within the British Army
• D. W. Robertson, Jr., a prominent Chaucer scholar at Princeton University from 1946 - 1980.
• Design Within Reach