From portal-commits at lists.jboss.org Wed Jul 30 06:50:28 2008 Content-Type: multipart/mixed; boundary="===============1109689552124638325==" MIME-Version: 1.0 From: portal-commits at lists.jboss.org To: portal-commits at lists.jboss.org Subject: [portal-commits] JBoss Portal SVN: r11653 - in docs/branches/JBoss_Portal_Branch_2_7/referenceGuide: en and 1 other directories. Date: Wed, 30 Jul 2008 06:50:28 -0400 Message-ID: --===============1109689552124638325== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: thomas.heute(a)jboss.com Date: 2008-07-30 06:50:28 -0400 (Wed, 30 Jul 2008) New Revision: 11653 Added: docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/en/modules/coordina= tion.xml Modified: docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/en/master.xml docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/pom.xml Log: Adding coordination chapter Modified: docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/en/master.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/en/master.xml 2008= -07-30 10:06:12 UTC (rev 11652) +++ docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/en/master.xml 2008= -07-30 10:50:28 UTC (rev 11653) @@ -50,6 +50,7 @@ + Added: docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/en/modules/coor= dination.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/en/modules/coordin= ation.xml (rev 0) +++ docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/en/modules/coordin= ation.xml 2008-07-30 10:50:28 UTC (rev 11653) @@ -0,0 +1,202 @@ + + + + + + Boleslaw + Dawidowicz + + + JBoss Portal Explicit Coordination + + Explicit vs implicit coordination + + Portlet 2.0 coordination features are mediated by the portal betw= een several + portlet windows, therefore the portal at runtime needs to be able= to define + relationships between windows. Relationship can be established fr= om an implicit + model (i.e a set of predicates applied on some state that will an= swer TRUE/FALSE + to the question are the portlet windows foo and bar in a relation= ship) or from an + explicit model (that states that foo and bar have a relationship)= . The implicit + model is very good for defining default configuration as it does = not require much + configuration but is not able to cover the exceptional case, that= 's why we need + to combine it with an explicit model that will take precedence ov= er the implicit + model, it is the well known principle of convention over configur= ation. + + + Currently all explicit coordination happens only in the scope of = the same page. + + + + Bindings and wirings + + + Event wiring + + + Wires JSR-286 events. With implicit wirings the event producer= and the + consumer declares the same event namespace and local name to g= et event + delivered in the scope of the same page. With explicit wiring = any pairs of + Window:Event can be connected. + + + + Parameter binding + + + Binds JSR-286 shared parameters. With implicit binding paramet= ers with the + same public name are shared. With explicit binding any public = parameters can + share values. Windows for which such binding applies are expli= citly defined. + + + + Alias binding + + + Explicit alias binding define a name of page scoped parameter = that will apply + value to specified portlet windows public parameters. + + + + + + + Coordination configuration + + + Configuration takes place in -object.xml file. The <coordin= ation> tag + can be used in both <page> and <portal> tags. When= used in + <portal> tag only <implicit-mode> tag can be defin= ed for wirings + and bindings: + + + + + ... + + + + TRUE + + + FALSE + + + +]]> + + When used within the <page> tag coordination event wirin= gs and bindings + can be defined:</page> + + + = + + TRUE + + eventWiring1 + + + ShoppingCatalogPortletWindow1 + {urn:jboss:portal:samples:event}CartEvent + + + + + ShoppingCartPortletWindow2 + {urn:jboss:portal:samples:event}CartEvent + + + ShoppingCartPortletWindow3 + {urn:jboss:portal:samples:event}CartEvent + + + + + eventWiring2 + + + ShoppingCatalogPortletWindow2 + {urn:jboss:portal:samples:event}CartEvent + + + + + ShoppingCartPortletWindow1 + {urn:jboss:portal:samples:event}CartEvent + + + ShoppingCartPortletWindow4 + {urn:jboss:portal:samples:event}CartEvent + + + + + = + + = + FALSE + = + + parameterBinding1 + + SomePortletWindow1 + foo + + + SomePortletWindow2 + foo + + + SomePortletWindow3 + foo + + + + + parameterBinding2 + + SomePortletWindow1 + bar1 + + + SomePortletWindow2 + {urn:jboss:portal:samples:daa1}daa1 + + + + + aliasBinding1 + foo + + + + aliasBinding2 + bar1 + {urn:jboss:portal:samples:daa2}daa2 + + = + +]]> + + + <implicit-mode> + + + This tag can be applied for both <bindings> and &l= t;wirings> + tags. It defines if implicit coordination is enabled or = disabled for + this given portal object. Value of this setting is casca= ded to all + children in portal object tree unless overwritten somewh= ere in the + hierarchy. If no <implicit-mode> is defined in por= tal object tree + default value is TRUE. + + + + + Coordination Samples + + JBoss Portal comes with several examples in 'Coordination Samples= ' page. Its good + to follow them looking at the configuration file that can be foun= d in + portal-coordination-samples.war/WEB-INF/default-object.xml + + + \ No newline at end of file Modified: docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/pom.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/pom.xml 2008-07-30= 10:06:12 UTC (rev 11652) +++ docs/branches/JBoss_Portal_Branch_2_7/referenceGuide/pom.xml 2008-07-30= 10:50:28 UTC (rev 11653) @@ -7,7 +7,7 @@ org.jboss.portal jboss-portal-docs-parent - 1.0.0-SNAPSHOT + 1.0.0 = org.jboss.portal --===============1109689552124638325==--