Raible's Wiki

Raible Designs
Wiki Home
News
Recent Changes

AppFuse

Homepage
  - Korean
  - Chinese
  - Italian
  - Japanese

QuickStart Guide
  - Chinese
  - French
  - German
  - Italian
  - Korean
  - Portuguese
  - Spanish
  - Japanese

User Guide
  - Korean
  - Chinese

Tutorials
  - Chinese
  - German
  - Italian
  - Korean
  - Portuguese
  - Spanish

FAQ
  - Korean

Latest Downloads

Other Applications

Struts Resume
Security Example
Struts Menu

Set your name in
UserPreferences


Referenced by
Articles
Articles_de
Articles_pt
Articles_zh




JSPWiki v2.2.33

[RSS]


Hide Menu

RichClient


This is version 32. It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]


Please note that this tutorial is under development and there are still some unsolved issues. If you find solutions to any of them I would very much appreciate your help. Contact: Radim Burget

Table of Contents

  • [1] About Spring-rcp
  • [2] Configuring Appfuse - map servlet to be listening on "ws/*" url address
  • [3] Configuring Appfuse - create ws servlet
  • [4] Configuring Appfuse - add *.jar library dependencies
  • [5] Configuring Appfuse - add interface to allow remote client logins

  • [6] Configuring RichClient - source code
  • [7] Configuring RichClient - libraries
  • [8] Unsolved issues

About Spring-rcp [#1]

The goal of the spring-richclient project is to provide a viable option for developers that need a platform and 'best-practices' guide for constructing professional Swing applications quickly.

My work is based on the Spring-rcp Pet Clinic Demo (in CVS only) and my efforts in integrating it with Appfuse.

RichClient/screenshot1.jpg

Configuring Appfuse - map servlet to be listening on "ws/*" url address [#2]

Add this portion of code to metadata/web/servlets.xml
    <!-- REMOTE ACCESS SERVELTET -->
	<servlet>
		<servlet-name>ws</servlet-name>
		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
		<load-on-startup>2</load-on-startup>
	</servlet>

 	<!--
	  - Dispatcher servlet mapping for HTTP web services.
	  - (see ws-servlet.xml for the controllers).
	  -->
	<servlet-mapping>
		<servlet-name>ws</servlet-name>
		<url-pattern>/ws/*</url-pattern>
	</servlet-mapping>

Configuring Appfuse - create ws servlet[#3]

Create a ws servlet XML beans descriptor. Because I am using Hessian instead of Burlap I have commented out Burlap-specific portions of the code. If you ever want to use Burlap instead just uncomment this part of the code.

The main difference between Hessian and Burlap is that Hessian is binary and Burlap is XML-based.

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">

<!--
  - $Id: ws-servlet.xml,v 1.1 2004/08/01 23:03:20 benalex Exp $
  -->
<beans>

	<!-- Hessian exporter for the Clinic -->
	<!-- Hessian is a slim binary HTTP remoting protocol -->
	<bean name="/Clinic-hessian" class="org.springframework.remoting.caucho.HessianServiceExporter">
		<property name="service"><ref bean="userManager"/></property>
		<property name="serviceInterface">
			<value>org.appfuse.service.UserManager</value>
		</property>
	</bean>

	<!-- Burlap exporter for the Clinic -->
	<!-- Burlap is a slim XML-based HTTP remoting protocol -->
	<!--bean name="/Clinic-burlap" class="org.springframework.remoting.caucho.BurlapServiceExporter">
		<property name="service"><ref bean="clinic"/></property>
		<property name="serviceInterface">
			<value>org.springframework.samples.petclinic.Clinic</value>
		</property>
	</bean-->

	<!-- Hessian exporter for the RemoteAuthenticationManager -->
	<bean name="/RemoteAuthenticationManager-hessian" class="org.springframework.remoting.caucho.HessianServiceExporter">
		<property name="service"><ref bean="remoteAuthenticationManager"/></property>
		<property name="serviceInterface">
			<value>net.sf.acegisecurity.providers.rcp.RemoteAuthenticationManager</value>
		</property>
	</bean>

	<!-- Burlap exporter for the RemoteAuthenticationManager -->
	<!--bean name="/RemoteAuthenticationManager-burlap" class="org.springframework.remoting.caucho.BurlapServiceExporter">
		<property name="service"><ref bean="remoteAuthenticationManager"/></property>
		<property name="serviceInterface">
			<value>net.sf.acegisecurity.providers.rcp.RemoteAuthenticationManager</value>
		</property>
	</bean-->

</beans>

Configuring Appfuse - add *.jar library dependencies [#4]

For more details read how to add a library into appfuse here.

Copy hessian.jar to appfuse/lib/hessian/hessian.jar

In lib/lib.properties add path info:


  #
  # Hessian
  #
  hessian.version=0.1
  hessian.dir=${lib.dir}/hessian-${hessian.version}
  hessian.jar=${hessian.dir}/hessian-${hessian.version}.jar

If you will ever need burlap do the same with the burlap *.jar files.

Add to build.xml the hessian library dependency:

<target name="package-web" ......
.......
...... 
<lib file="${hessian.jar}"/> 
...... 
</target> 

(properties.xml does not need any changes)

Configuring Appfuse - add interface to allow remote client logins[#5]

Add this bean to web/WEB-INF/applicationContextSecurity.xml:

<!-- Allows remote clients to check if a username/password is valid -->
<bean id="remoteAuthenticationManager" class="net.sf.acegisecurity.providers.rcp.RemoteAuthenticationManagerImpl">  
      <property name="authenticationManager"><ref bean="authenticationManager"/></property>
</bean>

Configuring RichClient - source code[#6]

Download the Appfuse Rich Client source code and copy them to your Appfuse project.

NOTE At first I tried to create a new standalone project that referenced the Appfuse project but was independent from it. Unfortunately I had some issues with compilation so I decided to integrate it directly to the project.

Configuring RichClient - libraries [#7]

You will need to download these jar archives and add them to the Eclipse classpath (Eclipse: Project/Properties/Java Build Path/Libraries/Add JARs). Be sure not to forget to refresh the appfuse directory structure afterwards.

appfuse/lib 
    /caucho
        (84 871) burlap.jar
        (83 245) hessian.jar
    /jgoodies
        (85 502)  forms.jar
        (338 486) looks.jar
    /spring-rcp
        (366 615) spring-richclient-resources.jar
         (59 691) spring-richclient-sandbox.jar
        (736 813) spring-richclient.jar
    /javahelp
        (531 676) javahelp.jar
    /spring
        (741 379) spring-sandbox.jar

My collection of JAR files can be downloaded from here.

Now you should be able to compile and run your application (org.appfuse.richclient.PetClinicClientServer)

NOTE: Please ensure that your server is running (http://localhost:8080/appfuse/ws/Clinic-hessian displays exception "HessianServiceExporter only supports POST requests")

Unsolved issues [#8]

TODO: (Currently in ML message "Integrating Spring Rich Client with Appfuse "- today I have no more energy ;)


Attachments:
appfuse-richclient.zip Info on appfuse-richclient.zip 44718 bytes
lib.zip Info on lib.zip 3189999 bytes
screenshot1.jpg Info on screenshot1.jpg 45557 bytes


Go to top   More info...   Attach file...
This particular version was published on 06-Nov-2006 13:52:49 MST by GlenMazza.