Getting Started with SweetDEV RIA
Follow this steps to install sweetDEV RIA in your application :
Installation
- Download SweetDEV RIA from sourceforge following the Download
section.
The required archive is the last version of sweetdev-ria-core-X.X.jar.
The jar's dependencies can be gathered either by the pom file contained in the jar or simply download the blank application in the section download and copy the content of the lib folder.
- Place the core jar and the dependencies of sweetDEV RIA in your webapp lib directory.
- Your project tree structure should now be :
+ROOT
--+WEB-INF
----+lib
------sweetdev-ria-core-XXX.jar
------%dependencies%.jar
Configuration
Now that sweetDEV RIA is installed, follow this steps to use sweetDEV RIA in your application :
- Add these lines to your web.xml :
<!-- JSO filter -->
<filter>
<filter-name>BrowserCacheFilter</filter-name>
<filter-class>com.ideo.jso.filter.BrowserCacheFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>BrowserCacheFilter</filter-name>
<url-pattern>*.js</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>BrowserCacheFilter</filter-name>
<url-pattern>*.css</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>BrowserCacheFilter</filter-name>
<url-pattern>*.jpg</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>BrowserCacheFilter</filter-name>
<url-pattern>*.gif</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>BrowserCacheFilter</filter-name>
<url-pattern>*.png</url-pattern>
</filter-mapping>
<!-- SweetDEV RIA listener -->
<listener>
<listener-class>com.ideo.sweetdevria.webapp.RiaLoaderListener</listener-class>
</listener>
<!-- SweetDEV RIA main servlet -->
<servlet>
<servlet-name>SweetDevRiaServlet</servlet-name>
<servlet-class>com.ideo.sweetdevria.servlet.SweetDevRiaServlet</servlet-class>
</servlet>
<!-- SweetDEV RIA resources provider servlet -->
<servlet>
<servlet-name>SweetDevRiaResourcesProvider</servlet-name>
<servlet-class>com.ideo.sweetdevria.servlet.SweetDevRiaResourcesProvider</servlet-class>
</servlet>
<!-- JSO servlet -->
<servlet>
<servlet-name>jso</servlet-name>
<servlet-class>com.ideo.jso.servlet.JsoServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>SweetDevRiaServlet</servlet-name>
<url-pattern>/RiaController</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>SweetDevRiaResourcesProvider</servlet-name>
<url-pattern>/resources/*</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>jso</servlet-name>
<url-pattern>/jso/*</url-pattern>
</servlet-mapping>
- Add the tag
<ria:resourcesImport /> in the head tag of your jsp.
Note : Regarding the backward compatibility of the resources (that are now stored into the jar), the SweetDevRiaResourcesProvider servlet will look up for resources in your webapp "resources" folder (which name can be changed) first, so you dont need to copy this folder outside the jar anymore (version < 2.2-SNPASHOT).
That's it !
You can now use all the SweetDEV RIA components !