[Springframework-developer] Re: Building WebFlow samples

[<kat...@ho...>]

It's step 3, "tweak the copied 'build.properties'" that isn't straight 
forward (it's important to get people up and running ASAP). The entry:

# location where development tools reside (e.g apps, libs, templates, etc.)
devtools.dir=c:/development/devtools

...leaves you scratching your head and reading through the build files 
to see where they should point to. While we should leave the property 
names as is (unless you do a complete refactor), how about some better 
default values and descriptions. E.g.

# location of spring root directory
devtools.dir=c:/java/spring-framework-1.2-rc2

# location where spring lib dependencies reside
devtools.lib.dir=${devtools.dir}/lib

# location of spring.jar
spring.dir=${devtools.dir}/dist

... or am I on the wrong track? I'd presume everyone would organise 
their java library directories differently, so a reference to a spring 
root directory is the essential property (again maybe a refactor of 
property names is required). What do you think?

Finally, you could just combine all the Ant commands required to:
1. build alljars webflow.jar webflow.support.jar

...which is still quite readable, and less steps.

PS. My problem below was missing the webflow.support.jar. Thanks for the 
   help.

Keith Donald wrote:
> I updated the readme.txt instructions.  Please let me know if these could
> still be improved.
> 
> /*
>  * webflow-samples
>  *
>  * phonebook - central sample demonstrating most webflow features
>  * itemlist - demonstrates application transaction tokens and expired flow
> cleanup
>  * fileupload - demonstrates multipart file upload with webflow
>  * birthdate - demonstrates Struts integration and the MultiAction
>  * sellitem - demonstrates a wizard with conditional transitions and
> continuations
>  *
>  * @author Keith Donald
>  * @since Mar 2005
>  * @version $Id: readme.txt,v 1.2 2005/04/11 06:19:53 kdonald Exp $
>  */
> 
> HOW TO BUILD WEBFLOW SAMPLES - FROM RELEASED DISTRIBUTION
> 
> 1. copy in the template 'build.properties' file in the same directory as
> this file to the root directory of the sample you wish to run.
> 
> 2. cd to the root directory of the sample you wish to run.
> 
> 3. tweak the copied 'build.properties' to your environment
> 
> 4. tweak 'build.bat' to point your environemnt so the ant build system can
> execute.
> 
> 5. run 'build dist' to build the application .war file, ready for
> deployment.
> 
> 6. if tomcat is installed on your system, run 'build tomcat.server.start' to
> start it and deploy the
> sample application in one step.
> 
> 7. access the sample at the appropriate URL, e.g
> http://localhost:8080/phonebook
> 
> HOW TO BUILD WEBFLOW SAMPLES - FROM CVS
> 
> From the spring root directory, execute from the command line:
> 
> 1. build alljars
> 
> 2. build webflow.jar
> 
> 3. build webflow.support.jar
> 
> 4. Proceed with the RELEASED DISTRIBUTION instructions above, customizing
> your local build.properties for each sample as necessary.  Note: If all want
> to do is build the sample .war file for manual deployment, you shouldn't
> have to do any build.properties customization--the default properties will
> suffice.  Property customization is only necessary if you have custom paths
> to dependent jar files or wish to automate deployment with a local tomcat
> installation.
> 
> -----Original Message-----
> From: spr...@li...
> [mailto:spr...@li...] On Behalf Of
> kat...@ho...
> Sent: Thursday, May 05, 2005 1:04 AM
> To: spr...@li...
> Subject: [Springframework-developer] Building WebFlow samples
> 
> I was building the phonebook sample and found it wouldn't compile as the 
> sandbox classes were missing. How is everyone else obtaining/generating 
> the samples?
> 
> I added a patch (see below) which fixes the problem - but there may be 
> another approach. What are other doing? :)
> 
> If there is a better way, maybe we can improve the build instructions in 
> the distro.
> 
> Cheers.
> 
> 
> Compiling 9 source files to 
> C:\work\spring\samples\webflow\phonebook\target\classes
> C:\work\spring\samples\webflow\phonebook\src\org\springframework\samples\pho
> nebook\web\flow\PersonDetailFlowBuilder.java:18: 
> package org.springframework.binding.convert does not exist
> import org.springframework.binding.convert.ConversionExecutor;
> 
> 
> ===================================================================
> RCS file: /cvsroot/springframework/spring/builds/build.xml,v
> retrieving revision 1.2
> diff -u -r1.2 build.xml
> --- build.xml	27 Apr 2005 00:14:44 -0000	1.2
> +++ build.xml	5 May 2005 04:44:26 -0000
> @@ -15,6 +15,7 @@
>   		<pathelement location="${target.classes.dir}" />
>   		<pathelement location="${commons.logging.jar}" />
>   		<pathelement location="${spring.jar}" />
> +		<pathelement location="${spring.sandbox.jar}" />
>   		<pathelement location="${spring.mock.jar}" />
>   	</path>
> 
> 
> 
> -------------------------------------------------------
> This SF.Net email is sponsored by: NEC IT Guy Games.
> Get your fingers limbered up and give it your best shot. 4 great events, 4
> opportunities to win big! Highest score wins.NEC IT Guy Games. Play to
> win an NEC 61 plasma display. Visit http://www.necitguy.com/?r=20
> _______________________________________________
> Springframework-developer mailing list
> Spr...@li...
> https://lists.sourceforge.net/lists/listinfo/springframework-developer
> 
> 
> 
> -------------------------------------------------------
> This SF.Net email is sponsored by: NEC IT Guy Games.
> Get your fingers limbered up and give it your best shot. 4 great events, 4
> opportunities to win big! Highest score wins.NEC IT Guy Games. Play to
> win an NEC 61 plasma display. Visit http://www.necitguy.com/?r=20