Mailing-List: contact dev-help@cocoon.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@cocoon.apache.org
Received-SPF: pass (nike.apache.org: domain of simone.tripodi@gmail.com
 designates 209.85.212.51 as permitted sender)
MIME-Version: 1.0
Sender: simone.tripodi@gmail.com
In-Reply-To: 
 <78B923726E7D59429936580CF127E943A1F35896CD@eu1rdcrdc1wx032.exi.nxp.com>
References: 
 <CAAqLGLPB5vbPUjK7Hfp++6OOygRH6n4-iEgD4rvbEs89OXFC1w@mail.gmail.com>
	<78B923726E7D59429936580CF127E943A1F35896CD@eu1rdcrdc1wx032.exi.nxp.com>
Date: Thu, 15 Dec 2011 17:47:01 +0100
Message-ID: 
 <CAAqLGLMqO-WzADxv5zava1+5qZdREkzdv49jErHvL9ccYBUMnQ@mail.gmail.com>
Subject: Re: [C3] new pipeline component: variabelExpander
From: Simone Tripodi <simonetripodi@apache.org>
To: dev@cocoon.apache.org
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

Hi Robby!

The Stringtemplate generator is much more sophisticated (you have
iterators, access to objects methods, ...) compared to this simple
component, that simply provides variable expansion.

The other difference is: Stringtemplate is a generator, the
VariableExpander is a component you can put in the middle of the
pipeline whenever you need - in my case, I needed to plug it at the
3rd stage of the pipeline.

For what it worths, Stringtemplate generator brings a 3rd party
dependency, VariableExpander comes dependencies-free inside the
cocoon-sax package.

Hope this clarifies, don't hesitate to ask if you need to know more!
All the best,
-Simo

http://people.apache.org/~simonetripodi/
http://simonetripodi.livejournal.com/
http://twitter.com/simonetripodi
http://www.99soft.org/


On Thu, Dec 15, 2011 at 5:32 PM, Robby Pelssers <Robby.Pelssers@nxp.com> wr=
ote:
> Hi Simone,
>
> This sounds useful. But it's not really clear to me as to how this differ=
s from the Stringtemplate generator which is also part of C3.
>
> Robby
>
> -----Original Message-----
> From: simone.tripodi@gmail.com [mailto:simone.tripodi@gmail.com] On Behal=
f Of Simone Tripodi
> Sent: Thursday, December 15, 2011 5:25 PM
> To: dev@cocoon.apache.org
> Subject: [C3] new pipeline component: variabelExpander
>
> Hi all guys,
> I just committed r1214835 a new component I need for work, so I
> thought it would have been a good idea contributing back to OSS since
> C3 is the foundation of the XML processor I am writing.
>
> Basically, I needed to put variables inside our XML document that can
> be replaced depending by the context the pipeline works, so the idea
> came from Ant/Maven and some code I already did in Commons-Digester,
> using the ${} marker for variables have to be expanded.
>
> Using that new component is very simple: given the XML
>
> <project>
> =C2=A0<target>
> =C2=A0 =C2=A0<delete dir=3D"${build.home}" />
> =C2=A0 =C2=A0<delete dir=3D"${dist.home}" />
> =C2=A0 =C2=A0<echo>A property '${text.property}' inside the text</echo>
> =C2=A0</target>
> </project>
>
> users can define their variables (in form of Properties/Map<String,String=
>):
>
> =C2=A0 =C2=A0 =C2=A0 =C2=A0Properties variables =3D new Properties();
> =C2=A0 =C2=A0 =C2=A0 =C2=A0variables.setProperty( "build.base", "/Users/c=
ocoon" );
> =C2=A0 =C2=A0 =C2=A0 =C2=A0variables.setProperty( "build.home", "${build.=
base}/workspace" );
> =C2=A0 =C2=A0 =C2=A0 =C2=A0variables.setProperty( "dist.home", "${build.b=
ase}/downloads" );
> =C2=A0 =C2=A0 =C2=A0 =C2=A0variables.setProperty( "text.property", "Cocoo=
n3 rocks!" );
>
> then creating and run their pipeline adding the VariableExpander:
>
> =C2=A0 =C2=A0 =C2=A0 =C2=A0newNonCachingPipeline().setURLGenerator(
> getClass().getResource( "/variables-expander.xml" ) )
> =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 .addVariableExpander( variables )
> =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 .addSerializer()
> =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 .withEmptyConfiguration()
> =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 .setup( System.out )
> =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 .execute();
>
> the XML document will be processed by the next component in the
> pipeline will look like:
>
> <project>
> =C2=A0<target>
> =C2=A0 =C2=A0<delete dir=3D"Users/cocoon/workspace" />
> =C2=A0 =C2=A0<delete dir=3D"Users/cocoon/download" />
> =C2=A0 =C2=A0<echo>A property 'Cocoon3 rocks!' inside the text</echo>
> =C2=A0</target>
> </project>
>
> WDYT? I hope it will be useful for you as well it is for me :P
> Have a nice day, all the best!
> -Simo
>
> http://people.apache.org/~simonetripodi/
> http://simonetripodi.livejournal.com/
> http://twitter.com/simonetripodi
> http://www.99soft.org/