Project: PEtALS

Revision: 8836

Author: rnaudin

Date: 06 Aug 2008 12:26:53

• /trunk/petals-distribution/petals-standalone/pom.xml

  ......	@@ -4,7 +4,7 @@
  4	4	<parent>
  5	5	<artifactId>petals-parent</artifactId>
  6	6	<groupId>org.ow2.petals</groupId>
  7		<version>12</version>
  	7	<version>13-SNAPSHOT</version>
  8	8	</parent>
  9	9
  10	10	<groupId>org.ow2.petals</groupId>
  ......	@@ -134,4 +134,4 @@
  134	134	</build>
  135	135	</profile>
  136	136	</profiles>
  137		</project>
  138	137	\ No newline at end of file
  	138	</project>

• /trunk/petals-cdk/petals-cdk-core/pom.xml

  ......	@@ -4,7 +4,7 @@
  4	4	<parent>
  5	5	<artifactId>petals-parent</artifactId>
  6	6	<groupId>org.ow2.petals</groupId>
  7		<version>12</version>
  	7	<version>13-SNAPSHOT</version>
  8	8	</parent>
  9	9
  10	10	<name>PEtALS :: Component Development Kit Core Library</name>

• /trunk/petals-core/petals-kernel/pom.xml

  ......	@@ -4,7 +4,7 @@
  4	4	<parent>
  5	5	<artifactId>petals-parent</artifactId>
  6	6	<groupId>org.ow2.petals</groupId>
  7		<version>12</version>
  	7	<version>13-SNAPSHOT</version>
  8	8	</parent>
  9	9
  10	10	<groupId>org.ow2.petals</groupId>

• /trunk/petals-jmx/pom.xml

  ......	@@ -4,7 +4,7 @@
  4	4	<parent>
  5	5	<artifactId>petals-parent</artifactId>
  6	6	<groupId>org.ow2.petals</groupId>
  7		<version>12</version>
  	7	<version>13-SNAPSHOT</version>
  8	8	</parent>
  9	9
  10	10	<groupId>org.ow2.petals</groupId>

• /trunk/petals-tools/petals-external-generic-client/pom.xml

  ......	@@ -7,7 +7,7 @@
  7	7	<parent>
  8	8	<artifactId>petals-parent</artifactId>
  9	9	<groupId>org.ow2.petals</groupId>
  10		<version>10-SNAPSHOT</version>
  	10	<version>10</version>
  11	11	</parent>
  12	12
  13	13	<groupId>org.ow2.petals.tools</groupId>

• /trunk/petals-core/petals-ant/pom.xml

  ......	@@ -4,7 +4,7 @@
  4	4	<parent>
  5	5	<artifactId>petals-parent</artifactId>
  6	6	<groupId>org.ow2.petals</groupId>
  7		<version>12</version>
  	7	<version>13-SNAPSHOT</version>
  8	8	</parent>
  9	9
  10	10	<groupId>org.ow2.petals</groupId>

• /trunk/petals-components/petals-bc-filetransfer/pom.xml

  ......	@@ -4,7 +4,7 @@
  4	4	<parent>
  5	5	<artifactId>petals-parent</artifactId>
  6	6	<groupId>org.ow2.petals</groupId>
  7		<version>12</version>
  	7	<version>13-SNAPSHOT</version>
  8	8	</parent>
  9	9
  10	10	<name>Petals Binding Component :: File transfer</name>
  ......	@@ -37,7 +37,7 @@
  37	37	<dependency>
  38	38	<groupId>org.ow2.petals</groupId>
  39	39	<artifactId>petals-cdk-core</artifactId>
  40		<version>4.0.1</version>
  	40	<version>4.0.2-SNAPSHOT</version>
  41	41	</dependency>
  42	42
  43	43	<dependency>

• /trunk/petals-cdk/src/doc/docbook/doc-en/petals-component-framework-content.xml

  ......	@@ -25,7 +25,7 @@
  25	25	bootstraps</para>
  26	26	</abstract>
  27	27
  28		<date>July 2007</date>
  	28	<date>July 2008</date>
  29	29	</bookinfo>
  30	30
  31	31	<preface>
  ......	@@ -36,7 +36,7 @@
  36	36	</preface>
  37	37
  38	38	<chapter>
  39		<title>Component Development Kit 3.0</title>
  	39	<title>Component Development Kit 4.x</title>
  40	40
  41	41	<section>
  42	42	<title>Default bootstrap</title>
  ......	@@ -45,18 +45,20 @@
  45	45	<classname>org.ow2.petals.component.framework.DefaultBootstrap</classname>
  46	46	class extends the
  47	47	<classname>org.ow2.petals.component.framework.DefaultBootstrap</classname>.
  48		This bootstrap provides advanced features for management through
  49		JMX:</para>
  	48	This bootstrap provides features to automatically expose attributes and
  	49	methods in the InstallationConfiguration MBean. Thus, during the
  	50	installation of the component, you can:</para>
  50	51
  51	52	<itemizedlist>
  52	53	<listitem>
  53		<para>Change jbi.xml extension values. The modified values will be
  54		persisted in a file that will be used for startup component
  55		configuration.</para>
  	54	<para>Set component specific parameters. The new parameters are
  	55	persisted into the JBI descriptor installed on the JBI container at
  	56	the installation.</para>
  56	57	</listitem>
  57	58
  58	59	<listitem>
  59		<para>Invoke bootstrap methods.</para>
  	60	<para>Invoke methods to prepare the installer to install the
  	61	component.</para>
  60	62	</listitem>
  61	63	</itemizedlist>
  62	64
  ......	@@ -69,11 +71,34 @@
  69	71	component installation.</para>
  70	72
  71	73	<section>
  72		<title>Modifying the component properties</title>
  	74	<title>Modifying the component parameters</title>
  73	75
  74		<para>The component properties are defined in the extensions element
  75		of the jbi.xml component descriptor file. These values can be modified
  76		during the bootstrap phase via JMX.</para>
  	76	<para>To define the component parameter you want to expose as
  	77	attribute of the custom MBean, you must extends the have to define
  	78	setter and optionally getter of the attribute as for a Bean, and add
  	79	the list of attribute name to the attribute list.</para>
  	80
  	81	<screen>package org.objectweb.petals.sample;
  	82
  	83	public class SampleBootstrap extends DefaultBootstrap {
  	84
  	85	@Override
  	86	protected void doComponentConfiguration(Properties componentProperties,
  	87	List&lt;String&gt; methods) {
  	88
  	89	// expose a method for management
  	90	methods.add(new String("exposedMethod"));
  	91	}
  	92
  	93	/**
  	94	* Expose me through JMX
  	95	*
  	96	*/
  	97	public String exposedMethod(String parameter) {
  	98	System.out.println("I am an exposed method on bootstrap");
  	99	}
  	100
  	101	}</screen>
  77	102
  78	103	<figure>
  79	104	<title>Sample of component parameters modification via JMX</title>
  ......	@@ -150,5 +175,48 @@
  150	175	can now be invoked via JMX.</para>
  151	176	</section>
  152	177	</section>
  	178
  	179	<section id="usrgd-conf-optim">
  	180	<title>JBI Exchange Optimizations</title>
  	181
  	182	<section>
  	183	<title>Optimization setup</title>
  	184
  	185	<para>The following optimization can be used by setting a parameter in
  	186	the ServiceUnit configuration.</para>
  	187	</section>
  	188
  	189	<section id="usrgd-optim-bypass">
  	190	<title>Acknowledgement bypassing</title>
  	191
  	192	<para>Each JBI MessageExchange pattern ends with a "DONE" or "ERROR"
  	193	message. The sender has to accept such messages, otherwise they are
  	194	accumulated in the <acronym>NMR</acronym> (<emphasis
  	195	role="bold">N</emphasis>ormalized <emphasis
  	196	role="bold">M</emphasis>essage <emphasis
  	197	role="bold">R</emphasis>outer). This generate extra trafic, too, even
  	198	in an In-Only exchange.</para>
  	199
  	200	<para>Setting the <varname>org.ow2.petals.messaging.noack</varname>
  	201	property to <literal>true</literal> on the MessageExchange indicates
  	202	that the <literal>DONE</literal> or <literal>ERROR</literal> message
  	203	will not be sent through the <acronym>NMR</acronym>.</para>
  	204
  	205	<para>This feature is unactivated when using synchronous sends.</para>
  	206	</section>
  	207
  	208	<section id="usrgd-src-compress">
  	209	<title>Source content compression</title>
  	210
  	211	<para>When large and redondant information is contained in the payload
  	212	of a MessageExchange, it can be interestting to compress the payload
  	213	to reduce the data volume transfered between two PEtALS nodes.</para>
  	214
  	215	<para>Setting the <varname>org.ow2.petals.transport.compress</varname>
  	216	property to <literal>true</literal> on the MessageExchange indicates
  	217	that the PEtALS transport layer will compress the Source content of
  	218	the exchange messages.</para>
  	219	</section>
  	220	</section>
  153	221	</chapter>
  154	222	</book>
  155	223	\ No newline at end of file

• /trunk/petals-security/pom.xml

  ......	@@ -30,6 +30,10 @@
  30	30	<version>SNAPSHOT</version>
  31	31	<packaging>pom</packaging>
  32	32
  	33	<properties>
  	34	<topDirectoryLocation>..</topDirectoryLocation>
  	35	</properties>
  	36
  33	37	<modules>
  34	38	<module>petals-jaas</module>
  35	39	</modules>

• /trunk/petals-parent/pom.xml

  ......	@@ -330,6 +330,7 @@
  330	330	<groupId>org.ow2.petals</groupId>
  331	331	<artifactId>petals-jbi</artifactId>
  332	332	<version>1.0.1</version>
  	333	<scope>provided</scope>
  333	334	</dependency>
  334	335	<dependency>
  335	336	<groupId>commons-lang</groupId>

• /trunk/petals-security/petals-jaas/pom.xml

  ......	@@ -3,7 +3,7 @@
  3	3	<parent>
  4	4	<artifactId>petals-parent</artifactId>
  5	5	<groupId>org.ow2.petals</groupId>
  6		<version>10</version>
  	6	<version>12</version>
  7	7	</parent>
  8	8
  9	9	<modelVersion>4.0.0</modelVersion>
  ......	@@ -13,10 +13,14 @@
  13	13	<packaging>jar</packaging>
  14	14	<version>1.1-SNAPSHOT</version>
  15	15
  	16	<properties>
  	17	<topDirectoryLocation>..</topDirectoryLocation>
  	18	</properties>
  	19
  16	20	<dependencies>
  17	21	<dependency>
  18	22	<groupId>junit</groupId>
  19	23	<artifactId>junit</artifactId>
  20	24	</dependency>
  21	25	</dependencies>
  22		</project>
  23	26	\ No newline at end of file
  	27	</project>