Mailing-List: contact users-help@cocoon.apache.org; run by ezmlm
Precedence: bulk
Reply-To: users@cocoon.apache.org
Date: Thu, 15 Oct 2015 15:30:24 -0400
From: "Mark H. Wood" <mwood@IUPUI.Edu>
To: users@cocoon.apache.org
Subject: Re: Documentation for component-configurations, global-variables?
Message-ID: <20151015193024.GB18631@IUPUI.Edu>
References: <20110119185443.GA29729@IUPUI.Edu>
 <ih7kvn$jq2$1@dough.gmane.org>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="PmA2V3Z32TCmWXqI"
Content-Disposition: inline
In-Reply-To: <ih7kvn$jq2$1@dough.gmane.org>
User-Agent: Mutt/1.5.23 (2014-03-12)

--PmA2V3Z32TCmWXqI
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Wed, Jan 19, 2011 at 10:27:40PM +0100, Luca Morandini wrote:
> On 01/19/2011 07:54 PM, Mark H. Wood wrote:
> >
> > It appears that 2.2 wants us to use Spring to do something analogous,
> > but first I need to know in detail what the old way is doing so that I
> > can work out how to do the same thing the new way.
>=20
> In 2.1 you can use global variables throughout the sitemap (it is just an=
other=20
> input module), like in:
> <map:generate element=3D"body" src=3D"cocoon://{global:theme-path}/index.=
html"/>
>=20
> In 2.2 you can use the Cocoon-Spring configurator to the same effect, but=
 it is=20
> way more flexible then the old "global-variables" definition.

Yes, but specifically how is the old way used, and how is the new way
used to do the same thing?  I've found no documentation for the deprecated
<map:component-configurations/> element, and no examples of the
<configurator:*/> elements, nor a definitive description of the
configurator namespace.

[spend half a day grubbing through the code]

The deprecation message in question appears to come from
org.apache.cocoon.core.container.spring.avalon.SitemapHelper.getGlobalSitem=
apVariables.
That code winkles out the global-variables element and pokes its
content into a Properties, which is then used by the caller
(createDefinition) which seems to be building a StringBuffer that
eventually contains a Spring <beans/> element and lots of content,
which is returned to createContainer (which returns a
WebApplicationContext to somewhere).  So it looks like the translation
of:

<map:sitemap xmlns:map=3D"http://apache.org/cocoon/sitemap/1.0">
  <map:pipelines>

    <map:component-configurations>
      <global-variables>
        <theme-path>IUPUIScholarWorks</theme-path>
	<theme-name>IUPUIScholarWORKS theme</theme-name>
      </global-variables>
    </map:component-configurations>
		    ...

is:

<beans
        xmlns=3D"http://www.springframework.org/schema/beans"
        xmlns:xsi=3D"http://www.w3.org/2001/XMLSchema-instance"
        xmlns:util=3D"http://www.springframework.org/schema/util"
        xmlns:configurator=3D"http://cocoon.apache.org/schema/configurator"
        xmlns:avalon=3D"http://cocoon.apache.org/schema/avalon"
        xsi:schemaLocation=3D"http://www.springframework.org/schema/beans
	        http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
        	http://www.springframework.org/schema/util
        	http://www.springframework.org/schema/util/spring-util-2.0.xsd
        	http://cocoon.apache.org/schema/configurator
        	http://cocoon.apache.org/schema/configurator/cocoon-configurator-1=
=2E0.xsd
        	http://cocoon.apache.org/schema/avalon/cocoon-avalon-1.0.xsd\">

  <configurator:child-settings name=3D'SITEMAP LOCATION'>
    <configurator:property name=3D'theme-path'
                           value=3D'IUPUIScholarWorks'/>
    <configurator:property name=3D'theme-name'
                           value=3D'IUPUIScholarWORKS theme'/>
  </configurator:child-settings>
</beans>
			...

I'm still figuring out for certain what SITEMAP LOCATION is supposed
to be, though it does seem somewhat obvious.

--=20
Mark H. Wood
Lead Technology Analyst

University Library
Indiana University - Purdue University Indianapolis
755 W. Michigan Street
Indianapolis, IN 46202
317-274-0749
www.ulib.iupui.edu

--PmA2V3Z32TCmWXqI
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: Digital signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2

iEYEAREIAAYFAlYf/tAACgkQs/NR4JuTKG8sugCgiX8uWym6o66lY4dloq5boQXC
/W0AnRLiRGtM6jdgF+S7WP9GqXpaBS1i
=ndIn
-----END PGP SIGNATURE-----

--PmA2V3Z32TCmWXqI--