You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@felix.apache.org by bu...@apache.org on 2014/09/04 12:13:06 UTC
svn commit: r921220 - in /websites/staging/felix/trunk/content: ./
documentation/subprojects/apache-felix-event-admin.html
Author: buildbot
Date: Thu Sep 4 10:13:06 2014
New Revision: 921220
Log:
Staging update by buildbot for felix
Modified:
websites/staging/felix/trunk/content/ (props changed)
websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-event-admin.html
Propchange: websites/staging/felix/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Sep 4 10:13:06 2014
@@ -1 +1 @@
-1622442
+1622444
Modified: websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-event-admin.html
==============================================================================
--- websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-event-admin.html (original)
+++ websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-event-admin.html Thu Sep 4 10:13:06 2014
@@ -66,15 +66,9 @@
</div>
- <div class="tip">
- This page is a translated version of <a href="/site/apache-felix-event-admin.html" target="felix_cwiki">/site/apache-felix-event-admin.html</a>. In case of
- doubt you might want to refer to the old page.
- </div>
-
<h1>Apache Felix Event Admin</h1>
- <h1 id="apache-felix-event-admin">Apache Felix Event Admin</h1>
-<p>The Event Admin Service Specification, part of the OSGi Compendium specification, defines a general inter-bundle communication mechanism. The communication conforms to the popular publish/subscribe paradigm and can be performed in a synchronous or asysnchronous manner.</p>
+ <p>The Event Admin Service Specification, part of the OSGi Compendium specification, defines a general inter-bundle communication mechanism. The communication conforms to the popular publish/subscribe paradigm and can be performed in a synchronous or asysnchronous manner.</p>
<p>The main components in a publish/subscribe communication are:</p>
<ul>
<li><em>Event Publisher</em> - sends events or messages related to a specific <em>topic</em></li>
@@ -209,53 +203,53 @@
A timeout can be configured which is used for event handlers. If an event handler takes longer than the configured timeout to process an event, it is blacklisted. Once a handler is in a blacklist, it doesn't get sent any events anymore.
The Felix Event Admin can be configured either through framework properties or through the configuration admin using PID <code>org.apache.felix.eventadmin.impl.EventAdmin</code>. This is a list of configuration properties:</p>
<hr />
-<p><strong>Thread Pool Size</strong>
-<em>Property</em>: org.apache.felix.eventadmin.ThreadPoolSize
-<em>Default</em>: 20
-<em>Type</em>: Integer
-The size of the thread pool used for event delivery. The default value is 20. Increase in case of a large amount of events. A value of less then 2 triggers the default value. If the pool is exhausted, event delivery is blocked until a thread becomes available from the pool. Each event is delivered in a thread from the pool unless the ignore timeouts is configured for the receiving event handler.</p>
-<hr />
-<p><strong>Async/sync Thread Pool Ratio</strong>
-<em>Property</em>: org.apache.felix.eventadmin.AsyncToSyncThreadRatio
-<em>Since</em>: Release 1.4.2
-<em>Default</em>: 0.5
-<em>Type</em>: Double
-The ratio of asynchronous to synchronous threads in the internal thread pool. Ratio must be positive and may be adjusted to represent the distribution of post to send operations. Applications with higher number of post operations should have a higher ratio.</p>
-<hr />
-<p><strong>Timeout</strong>
-<em>Property</em>: org.apache.felix.eventadmin.Timeout
-<em>Default</em>: 5000
-<em>Type</em>: Integer
-The black-listing timeout in milliseconds. The default value is 5000. Increase or decrease at own discretion. A value of less then 100 turns timeouts off. Any other value is the time in milliseconds granted to each event handler before it gets blacklisted.</p>
-<hr />
-<p><strong>Require Topic</strong>
-<em>Property</em>: org.apache.felix.eventadmin.RequireTopic
-<em>Default</em>: true
-<em>Type</em>: Boolean
-Are event handlers required to be registered with a topic? This is enabled by default. The specification says that event handlers must register with a list of topics they are interested in. Disabling this setting will enable that handlers without a topic are receiving all events (i.e., they are treated the same as with a topic=*).</p>
-<hr />
-<p><strong>Ignore Timeouts</strong>
-<em>Property</em>: org.apache.felix.eventadmin.IgnoreTimeout
-<em>Default</em>: empty
-<em>Type</em>: String
-Configure event handlers to be called without a timeout. If a timeout is configured by default all event handlers are called using the timeout. For performance optimization it is possible to configure event handlers where the timeout handling is not used - this reduces the thread usage from the thread pools as the timout handling requires an additional thread to call the event handler. However, the application should work without this configuration property. It is a pure optimization! The value is a list of strings. If a string ends with a dot, all handlers in exactly this package are ignored. If the string ends with a star, all handlers in this package and all subpackages are ignored. If the string neither ends with a dot nor with a start, this is assumed to define an exact class name.</p>
-<hr />
-<p><strong>Ignore Topics</strong>
-<em>Property</em>: org.apache.felix.eventadmin.IgnoreTopic
-<em>Since</em>: Release 1.4.0
-<em>Default</em>: empty
-<em>Type</em>: String
-For performance optimization it is possible to configure topics which are ignored by the event admin implementation. In this case, a event is not delivered to registered event handlers. The value is a list of strings (separated by comma). " +If a single value ends with a dot, all topics in exactly this package are ignored. If a single value ends with a star, all topics in this package and all sub packages are ignored. If a single value neither ends with a dot nor with a start, this is assumed to define an exact topic. A single star can be used to disable delivery completely.</p>
-<hr />
-<p><strong>Log Level</strong>
-<em>Property</em>: org.apache.felix.eventadmin.LogLevel
-<em>Note</em>: This property can't be set through the OSGi configuration.
-<em>Default</em>: 2 (=WARNING)
-<em>Type</em>: Integer
-This sets the log level used for messages outputted by the event admin implementation. Valid values are 1 (=ERROR), 2 (=WARNING), 3 (=INFO), and 4 (=DEBUG). The default is 2 and an invalid value sets the level to the default value.</p>
+<p><strong>Thread Pool Size</strong></p>
+<p><em>Property</em>: org.apache.felix.eventadmin.ThreadPoolSize<br />
+<em>Default</em>: 20<br />
+<em>Type</em>: Integer</p>
+<p>The size of the thread pool used for event delivery. The default value is 20. Increase in case of a large amount of events. A value of less then 2 triggers the default value. If the pool is exhausted, event delivery is blocked until a thread becomes available from the pool. Each event is delivered in a thread from the pool unless the ignore timeouts is configured for the receiving event handler.</p>
+<hr />
+<p><strong>Async/sync Thread Pool Ratio</strong></p>
+<p><em>Property</em>: org.apache.felix.eventadmin.AsyncToSyncThreadRatio<br />
+<em>Since</em>: Release 1.4.2<br />
+<em>Default</em>: 0.5<br />
+<em>Type</em>: Double</p>
+<p>The ratio of asynchronous to synchronous threads in the internal thread pool. Ratio must be positive and may be adjusted to represent the distribution of post to send operations. Applications with higher number of post operations should have a higher ratio.</p>
+<hr />
+<p><strong>Timeout</strong></p>
+<p><em>Property</em>: org.apache.felix.eventadmin.Timeout<br />
+<em>Default</em>: 5000<br />
+<em>Type</em>: Integer</p>
+<p>The black-listing timeout in milliseconds. The default value is 5000. Increase or decrease at own discretion. A value of less then 100 turns timeouts off. Any other value is the time in milliseconds granted to each event handler before it gets blacklisted.</p>
+<hr />
+<p><strong>Require Topic</strong></p>
+<p><em>Property</em>: org.apache.felix.eventadmin.RequireTopic<br />
+<em>Default</em>: true<br />
+<em>Type</em>: Boolean</p>
+<p>Are event handlers required to be registered with a topic? This is enabled by default. The specification says that event handlers must register with a list of topics they are interested in. Disabling this setting will enable that handlers without a topic are receiving all events (i.e., they are treated the same as with a topic=*).</p>
+<hr />
+<p><strong>Ignore Timeouts</strong></p>
+<p><em>Property</em>: org.apache.felix.eventadmin.IgnoreTimeout<br />
+<em>Default</em>: empty<br />
+<em>Type</em>: String</p>
+<p>Configure event handlers to be called without a timeout. If a timeout is configured by default all event handlers are called using the timeout. For performance optimization it is possible to configure event handlers where the timeout handling is not used - this reduces the thread usage from the thread pools as the timout handling requires an additional thread to call the event handler. However, the application should work without this configuration property. It is a pure optimization! The value is a list of strings. If a string ends with a dot, all handlers in exactly this package are ignored. If the string ends with a star, all handlers in this package and all subpackages are ignored. If the string neither ends with a dot nor with a start, this is assumed to define an exact class name.</p>
+<hr />
+<p><strong>Ignore Topics</strong></p>
+<p><em>Property</em>: org.apache.felix.eventadmin.IgnoreTopic<br />
+<em>Since</em>: Release 1.4.0<br />
+<em>Default</em>: empty<br />
+<em>Type</em>: String</p>
+<p>For performance optimization it is possible to configure topics which are ignored by the event admin implementation. In this case, a event is not delivered to registered event handlers. The value is a list of strings (separated by comma). " +If a single value ends with a dot, all topics in exactly this package are ignored. If a single value ends with a star, all topics in this package and all sub packages are ignored. If a single value neither ends with a dot nor with a start, this is assumed to define an exact topic. A single star can be used to disable delivery completely.</p>
+<hr />
+<p><strong>Log Level</strong></p>
+<p><em>Property</em>: org.apache.felix.eventadmin.LogLevel<br />
+<em>Note</em>: This property can't be set through the OSGi configuration.<br />
+<em>Default</em>: 2 (=WARNING)<br />
+<em>Type</em>: Integer</p>
+<p>This sets the log level used for messages outputted by the event admin implementation. Valid values are 1 (=ERROR), 2 (=WARNING), 3 (=INFO), and 4 (=DEBUG). The default is 2 and an invalid value sets the level to the default value.</p>
<hr />
<div class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
- Rev. 1622442 by cziegeler on Thu, 4 Sep 2014 10:01:30 +0000
+ Rev. 1622444 by cziegeler on Thu, 4 Sep 2014 10:12:53 +0000
</div>
<div class="trademarkFooter">
Apache Felix, Felix, Apache, the Apache feather logo, and the Apache Felix project