Update doc
git-svn-id: https://svn.apache.org/repos/asf/felix/trunk@796268 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/ipojo/handler/jmx/doc/ipojo-jmx-handler.html b/ipojo/handler/jmx/doc/ipojo-jmx-handler.html
index fd1d6d5..b80c735 100644
--- a/ipojo/handler/jmx/doc/ipojo-jmx-handler.html
+++ b/ipojo/handler/jmx/doc/ipojo-jmx-handler.html
@@ -12,28 +12,200 @@
<ul>
<li><a href="http://felix.apache.org/site/news.html" title="news">news</a></li>
<li><a href="http://felix.apache.org/site/license.html" title="license">license</a></li>
- <li><span class="nobr"><a href="http://felix.apache.org/site/downloads.cgi" title="Visit page outside Confluence" rel="nofollow">downloads<sup><img class="rendericon" src="ipojo-jmx-handler_files/linkext7.gif" alt="" align="absmiddle" border="0" width="7" height="7"></sup></a></span></li>
+ <li><a href="http://felix.apache.org/site/downloads.cgi" rel="nofollow">downloads</a></li>
<li><a href="http://felix.apache.org/site/documentation.html" title="documentation">documentation</a></li>
<li><a href="http://felix.apache.org/site/mailinglists.html" title="mailinglists">mailing lists</a></li>
<li><a href="http://felix.apache.org/site/contributing.html" title="Contributing">contributing</a></li>
- <li><span class="nobr"><a href="http://www.apache.org/" title="Visit page outside Confluence" rel="nofollow">asf<sup><img class="rendericon" src="ipojo-jmx-handler_files/linkext7.gif" alt="" align="absmiddle" border="0" width="7" height="7"></sup></a></span></li>
- <li><span class="nobr"><a href="http://www.apache.org/foundation/sponsorship.html" title="Visit page outside Confluence" rel="nofollow">sponsorship<sup><img class="rendericon" src="ipojo-jmx-handler_files/linkext7.gif" alt="" align="absmiddle" border="0" width="7" height="7"></sup></a></span></li>
- <li><span class="nobr"><a href="http://www.apache.org/foundation/thanks.html" title="Visit page outside Confluence" rel="nofollow">sponsors<sup><img class="rendericon" src="ipojo-jmx-handler_files/linkext7.gif" alt="" align="absmiddle" border="0" width="7" height="7"></sup></a></span>
+ <li><a href="http://www.apache.org/" rel="nofollow">asf</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" rel="nofollow">sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" rel="nofollow">sponsors</a>
<!-- ApacheCon Ad -->
-<iframe src="ipojo-jmx-handler_files/button.html" style="border-width: 0pt; float: left;" scrolling="no" width="135" frameborder="0" height="135"></iframe>
+<iframe src="ipojo-jmx-handler_files/button.html" style="border-width: 0pt; float: left;" scrolling="no" frameborder="0" height="135" width="135"></iframe>
<p style="height: 100px;">
<!-- ApacheCon Ad -->
</p></li></ul> </div>
<div class="main">
-<table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr>
-<td class="confluenceTd" valign="top" width="80%">
+<style type="text/css">
+ @import url(http://people.apache.org/~clement/ipojo/site/superfish.css);
+</style>
+
+<style type="text/css">
+ @import url(http://people.apache.org/~clement/ipojo/site/style.css);
+</style>
+
+<p>
+<script class="javascript" src="ipojo-jmx-handler_files/shCore.js"></script>
+<script class="javascript" src="ipojo-jmx-handler_files/shBrushCSharp.js"></script>
+<script class="javascript" src="ipojo-jmx-handler_files/shBrushPhp.js"></script>
+<script class="javascript" src="ipojo-jmx-handler_files/shBrushJScript.js"></script>
+<script class="javascript" src="ipojo-jmx-handler_files/shBrushVb.js"></script>
+<script class="javascript" src="ipojo-jmx-handler_files/shBrushSql.js"></script>
+<script class="javascript" src="ipojo-jmx-handler_files/shBrushXml.js"></script>
+<script class="javascript" src="ipojo-jmx-handler_files/shBrushShell.js"></script>
+<script class="javascript" src="ipojo-jmx-handler_files/shBrushDelphi.js"></script>
+<script class="javascript" src="ipojo-jmx-handler_files/shBrushPython.js"></script>
+<script class="javascript" src="ipojo-jmx-handler_files/shBrushJava.js"></script>
+
+<script type="text/javascript" src="ipojo-jmx-handler_files/jquery-1.js"></script>
+<script type="text/javascript" src="ipojo-jmx-handler_files/hoverIntent.js"></script>
+<script type="text/javascript" src="ipojo-jmx-handler_files/superfish.js"></script>
+<script type="text/javascript" src="ipojo-jmx-handler_files/supersubs.js"></script>
+
+<script type="text/javascript">
+
+ $(document).ready(function(){
+ $("ul.sf-menu").supersubs({
+ minWidth: 14, // minimum width of sub-menus in em units
+ maxWidth: 30, // maximum width of sub-menus in em units
+ extraWidth: 1 // extra width can ensure lines don't sometimes turn over
+ // due to slight rounding differences and font-family
+ }).superfish(); // call supersubs first, then superfish, so that subs are
+ // not display:none when measuring. Call before initialising
+ // containing tabs for same reason.
+ });
+
+</script>
+</p><div class="main">
+<div class="page-header">
+<img src="ipojo-jmx-handler_files/header.png" class="header">
+<a href="http://ipojo.org/"><img src="ipojo-jmx-handler_files/ipojo.png" class="header-logo" width="225"></a>
+<ul class="sf-menu sf-js-enabled sf-shadow" id="ipojo-menu">
+<li class="current">
+<!-- Menu Overview -->
+<a href="" class="sf-with-ul">Overview<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+<ul style="float: none; width: 14em; display: none; visibility: hidden;">
+ <li style="white-space: normal; float: left; width: 100%;">
+ <a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo.html" title="Apache Felix iPOJO">Home</a>
+ </li>
+ <li style="white-space: normal; float: left; width: 100%;">
+ <a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-why-choose-ipojo.html" title="apache-felix-ipojo-why-choose-ipojo">Why choose iPOJO</a>
+ </li>
+ <li style="white-space: normal; float: left; width: 100%;">
+ <a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-successstories.html" title="apache-felix-ipojo-successstories">Success stories</a>
+ </li>
+ <li style="white-space: normal; float: left; width: 100%;">
+ <a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-feature-overview.html" title="Apache Felix iPOJO Feature Overview">Features</a>
+ </li>
+</ul>
+</li>
+
+<li class="">
+<!-- Menu download -->
+</li><li>
+<a href="http://felix.apache.org/site/download.html" title="Download">Download </a>
+</li>
+
+<li class="">
+<!-- Menu Documentation -->
+<a href="" class="sf-with-ul">Documentation<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+<ul style="float: none; width: 14em; display: none; visibility: hidden;">
+ <!-- sub- menu : getting started -->
+ <li style="white-space: normal; float: left; width: 100%;" class="">
+ <a style="float: none; width: auto;" href="" class="sf-with-ul">Getting Started<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+ <ul style="left: 14em; float: none; width: 14em; display: none; visibility: hidden;">
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-in-10-minutes.html" title="iPOJO in 10 minutes">iPOJO in 10 minutes</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/how-to-use-ipojo-annotations.html" title="How to use iPOJO Annotations">Using Annotations</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-hello-word-maven-based-tutorial.html" title="iPOJO Hello Word (Maven-Based) tutorial">Maven tutorial</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-advanced-tutorial.html" title="iPOJO Advanced Tutorial">Advanced tutorial</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-dosgi.html" title="apache-felix-ipojo-dosgi">Using Distributed OSGi</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-composition-tutorial.html" title="iPOJO Composition Tutorial">Application Composition</a></li>
+ </ul>
+ </li> <!-- end of getting started -->
+ <!-- sub menu : Describing Components -->
+ <li style="white-space: normal; float: left; width: 100%;" class="">
+ <a style="float: none; width: auto;" href="http://felix.apache.org/site/describing-components.html" class="sf-with-ul">Describing components<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+ <ul style="left: 14em; float: none; width: 14em; display: none; visibility: hidden;">
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/service-requirement-handler.html" title="Service Requirement Handler">Requiring a service</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/providing-osgi-services.html" title="Providing OSGi services">Providing a service</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/lifecycle-callback-handler.html" title="Lifecycle Callback Handler">Lifecycle management</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/configuration-handler.html" title="Configuration Handler">Configuration</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/architecture-handler.html" title="Architecture Handler">Introspection</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/controller-lifecycle-handler.html" title="Controller Lifecycle Handler">Impacting the lifecycle</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/event-admin-handlers.html" title="Event Admin Handlers">Asynchronous communication</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="" title="iPOJO JMX Handler">JMX management</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/extender-pattern-handler.html" title="Extender Pattern Handler">Extender pattern</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/white-board-pattern-handler.html" title="White Board Pattern Handler">Whiteboard pattern</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/temporal-service-dependency.html" title="Temporal Service Dependency">Temporal dependencies</a></li>
+ </ul>
+ </li> <!-- End of describing components -->
+ <!-- sub- menu : User Guide -->
+ <li style="white-space: normal; float: left; width: 100%;" class="">
+ <a style="float: none; width: auto;" href="" class="sf-with-ul">User Guide<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+ <ul style="left: 14em; float: none; width: 14em; display: none; visibility: hidden;">
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/using-xml-schemas.html" title="Using XML Schemas">XML Schemas</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-api.html" title="apache-felix-ipojo-api">API</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-testing-components.html" title="apache-felix-ipojo-testing-components">Testing components</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-eclipse-integration.html" title="apache-felix-ipojo-eclipse-integration">Eclipse Integration</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-faq.html" title="iPOJO FAQ">FAQ</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-reference-card.html" title="iPOJO-Reference-Card">Reference Card</a></li>
+ </ul>
+ </li> <!-- end of user guide -->
+ <!-- sub- menu : Dev Guide -->
+ <li class="" style="white-space: normal; float: left; width: 100%;">
+ <a style="float: none; width: auto;" href="" class="sf-with-ul">Advanced Topics<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+ <ul style="left: 14em; float: none; width: 14em; display: none; visibility: hidden;">
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/ipojo/api/1.2.0" rel="nofollow">Javadoc</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/how-to-write-your-own-handler.html" title="How to write your own handler">Handler guide</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/how-to-use-ipojo-manipulation-metadata.html" title="How to use iPOJO Manipulation Metadata">Manipulation Metadata </a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/dive-into-the-ipojo-manipulation-depths.html" title="Dive into the iPOJO Manipulation depths">Dive into the iPOJO Manipulation depths</a></li>
+ </ul>
+ </li> <!-- End of Dev guide -->
+</ul>
+</li> <!-- End of doc -->
+<!-- Menu 4 : Tools -->
+<li class="">
+<a href="" class="sf-with-ul">Tools<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+<ul style="float: none; width: 14em; display: none; visibility: hidden;">
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-ant-task.html" title="iPOJO Ant Task">Ant Task</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-eclipse-plug-in.html" title="iPOJO Eclipse Plug-in">Eclipse Plugin</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-maven-plug-in.html" title="iPOJO Maven Plug-in">Maven Plugin</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-online-manipulator.html" title="apache-felix-ipojo-online-manipulator">Online Manipulator</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-webconsole-plugin.html" title="iPOJO Webconsole Plugin">Webconsole plugin</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-junit4osgi.html" title="apache-felix-ipojo-junit4osgi">Junit4OSGi</a></li>
+</ul>
+</li><!-- End of tools -->
+<!-- Menu 5 : Misc -->
+<li class="">
+<a href="" class="sf-with-ul">Misc<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+<ul style="float: none; width: 14em; display: none; visibility: hidden;">
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-issuestracker.html" title="apache-felix-ipojo-issuestracker">Issues Tracker</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-supportedvms.html" title="apache-felix-ipojo-supportedVMs">Supported JVMs</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-supportedosgi.html" title="apache-felix-ipojo-supportedOSGi">Supported OSGi Implementations</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://ipojo-dark-side.blogspot.com/" rel="nofollow">iPOJO's Dark Side Blog</a></li>
+ <li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/article-presentations.html" title="Article & Presentations">Article & Presentations</a></li>
+</ul>
+</li><!-- End of misc -->
+</ul> <!-- End of the menu -->
+</div> <!-- Page header -->
+
+
+<div class="content">
<h1><a name="iPOJOJMXHandler-iPOJOJMXHandler"></a>iPOJO JMX Handler</h1>
-<p>This handler provides JMX management of component instance. It could
-be useful to manage instance remotely. As the handler exposes MBeans,
-you must have a MBean server running on your platform (as the platform
-MBean server or the MOSGi MBean Server).</p>
+<p><em>This handler provides JMX management of component instance. It
+could be useful to manage instance remotely. As the handler exposes
+MBeans, you must have a MBean server running on your platform (as the
+platform MBean server or the MOSGi MBean Server).</em></p>
+
+<div class="toc">
+<ul>
+ <li><a href="#iPOJOJMXHandler-Features">Features</a></li>
+ <li><a href="#iPOJOJMXHandler-Prerequisites">Prerequisites</a></li>
+ <li><a href="#iPOJOJMXHandler-Download">Download</a></li>
+ <li><a href="#iPOJOJMXHandler-Howtouseit">How to use it</a></li>
+ <li><a href="#iPOJOJMXHandler-JMXHandleroptions">JMX Handler options</a></li>
+ <li><a href="#iPOJOJMXHandler-Globalhandlerattributes">Global handler attributes</a></li>
+ <li><a href="#iPOJOJMXHandler-Propertiesattributes">Properties attributes</a></li>
+ <li><a href="#iPOJOJMXHandler-Methodsattributes">Methods attributes</a></li>
+ <li><a href="#iPOJOJMXHandler-Examples">Examples</a></li>
+<ul>
+ <li><a href="#iPOJOJMXHandler-ExposingAttributes">Exposing Attributes</a></li>
+ <li><a href="#iPOJOJMXHandler-ExposingMethods">Exposing Methods</a></li>
+ <li><a href="#iPOJOJMXHandler-AttributeNotifications%253A">Attribute Notifications:</a></li>
+</ul>
+ <li><a href="#iPOJOJMXHandler-Configuringthehandlerwithannotations">Configuring the handler with annotations</a></li>
+</ul></div>
<h2><a name="iPOJOJMXHandler-Features"></a>Features</h2>
@@ -59,7 +231,7 @@
</ul>
-<p>You can find MOSGi documentation on <span class="nobr"><a href="http://cwiki.apache.org/FELIX/mosgi-managed-osgi-framework.html" title="Visit page outside Confluence" rel="nofollow">http://cwiki.apache.org/FELIX/mosgi-managed-osgi-framework.html<sup><img class="rendericon" src="ipojo-jmx-handler_files/linkext7.gif" alt="" align="absmiddle" border="0" width="7" height="7"></sup></a></span></p>
+<p>You can find MOSGi documentation on <a href="http://cwiki.apache.org/FELIX/mosgi-managed-osgi-framework.html" rel="nofollow">http://cwiki.apache.org/FELIX/mosgi-managed-osgi-framework.html</a></p>
<h2><a name="iPOJOJMXHandler-Download"></a>Download</h2>
@@ -68,23 +240,56 @@
<h2><a name="iPOJOJMXHandler-Howtouseit"></a>How to use it</h2>
<p>The handler needs to be added in the metadata.xml, you just add a namespace (e.g., jmx) :</p>
-<div class="code"><div class="codeContent">
-<pre class="code-xml"><span class="code-tag"><ipojo <span class="code-keyword">xmlns:jmx</span>=<span class="code-quote">"org.apache.felix.ipojo.handlers.jmx"</span>></span>
+<div class="code">
+<div class="dp-highlighter"><table class="dp-xml" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span></span><span class="tag"><</span><span>ipojo xmlns:</span><span class="attribute">jmx</span><span>=</span><span class="attribute-value">"org.apache.felix.ipojo.handlers.jmx"</span><span>> </span></td></tr><tr><td class="line2"> ... </td></tr><tr><td class="line1"><span class="tag"></</span><span>ipojo</span><span class="tag">></span><span> </span></td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="xml:nocontrols:nogutter" rows="10" readonly="readonly"><ipojo xmlns:jmx="org.apache.felix.ipojo.handlers.jmx">
...
-<span class="code-tag"></ipojo></span></pre>
-</div></div>
+</ipojo></textarea>
+<script class="javascript">
+ if(!window.newcodemacro_initialised)
+ {
+ window.newcodemacro_initialised = true;
+ window.oldonloadmethod = window.onload;
+ window.onload = function(){
+ dp.SyntaxHighlighter.HighlightAll('newcodemacro');
+ if(window.oldonloadmethod)
+ {
+ window.oldonloadmethod();
+ }
+ }
+ }
+
+</script>
+</div>
+
<p>So, you could now expose in JMX properties and methods of your component. They are surrounded by the <jmx:config><br>
tag.</p>
-<div class="code"><div class="codeContent">
-<pre class="code-xml"><span class="code-tag"><jmx:config></span>
- <span class="code-tag"><jmx:property name=<span class="code-quote">"message"</span> field=<span class="code-quote">"m_msg"</span> rights=<span class="code-quote">"w"</span> notification=<span class="code-quote">"true"</span>/></span>
- <span class="code-tag"><jmx:method name=<span class="code-quote">"doSomethingBad"</span>/></span>
- <span class="code-tag"><jmx:method name=<span class="code-quote">"doSomethingGood"</span>/></span>
-<span class="code-tag"></jmx:config></span></pre>
-</div></div>
-<p><em>Note:</em> Be careful that the argument and return type of
-methods must be serializable. In case of several methods have the same
-name, each of them will be exposed.</p>
+<div class="code">
+<div class="dp-highlighter"><table class="dp-xml" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span></span><span class="tag"><</span><span>jmx:config</span><span class="tag">></span><span> </span></td></tr><tr><td class="line2"> <span class="tag"><</span><span>jmx:property </span><span class="attribute">name</span><span>=</span><span class="attribute-value">"message"</span><span> </span><span class="attribute">field</span><span>=</span><span class="attribute-value">"m_msg"</span><span> </span><span class="attribute">rights</span><span>=</span><span class="attribute-value">"w"</span><span> </span><span class="attribute">notification</span><span>=</span><span class="attribute-value">"true"</span><span>/> </span></td></tr><tr><td class="line1"> <span class="tag"><</span><span>jmx:method </span><span class="attribute">name</span><span>=</span><span class="attribute-value">"doSomethingBad"</span><span>/> </span></td></tr><tr><td class="line2"> <span class="tag"><</span><span>jmx:method </span><span class="attribute">name</span><span>=</span><span class="attribute-value">"doSomethingGood"</span><span>/> </span></td></tr><tr><td class="line1"><span class="tag"></</span><span>jmx:config</span><span class="tag">></span><span> </span></td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="xml:nocontrols:nogutter" rows="10" readonly="readonly"><jmx:config>
+ <jmx:property name="message" field="m_msg" rights="w" notification="true"/>
+ <jmx:method name="doSomethingBad"/>
+ <jmx:method name="doSomethingGood"/>
+</jmx:config></textarea>
+<script class="javascript">
+ if(!window.newcodemacro_initialised)
+ {
+ window.newcodemacro_initialised = true;
+ window.oldonloadmethod = window.onload;
+ window.onload = function(){
+ dp.SyntaxHighlighter.HighlightAll('newcodemacro');
+ if(window.oldonloadmethod)
+ {
+ window.oldonloadmethod();
+ }
+ }
+ }
+
+</script>
+</div>
+
+<div class="panelMacro"><table class="infoMacro"><colgroup><col width="24"><col></colgroup><tbody><tr><td valign="top"><img src="ipojo-jmx-handler_files/information.gif" alt="" border="0" align="absmiddle" height="16" width="16"></td><td><b>Serialization</b><br><p>Be
+careful that the argument and return type of methods must be
+serializable. In case of several methods have the same name, each of
+them will be exposed.</p></td></tr></tbody></table></div>
<h2><a name="iPOJOJMXHandler-JMXHandleroptions"></a>JMX Handler options</h2>
@@ -95,7 +300,7 @@
below.</p>
<h2><a name="iPOJOJMXHandler-Globalhandlerattributes"></a>Global handler attributes</h2>
-<table class="confluenceTable"><tbody>
+<div class="borderedTable"><table class="confluenceTable"><tbody>
<tr>
<th class="confluenceTh">Attribute name </th>
<th class="confluenceTh"> Required </th>
@@ -142,10 +347,10 @@
carry out operations before and after being registered or unregistered
from the MBean server.</td>
</tr>
-</tbody></table>
+</tbody></table></div>
<h2><a name="iPOJOJMXHandler-Propertiesattributes"></a>Properties attributes</h2>
-<table class="confluenceTable"><tbody>
+<div class="borderedTable"><table class="confluenceTable"><tbody>
<tr>
<th class="confluenceTh">Attribute name</th>
<th class="confluenceTh">Required</th>
@@ -178,10 +383,9 @@
notification sending for this property. If set to "true", a
notification is sent each time the value of the field changes.</td>
</tr>
-</tbody></table>
-
+</tbody></table></div>
<h2><a name="iPOJOJMXHandler-Methodsattributes"></a>Methods attributes</h2>
-<table class="confluenceTable"><tbody>
+<div class="borderedTable"><table class="confluenceTable"><tbody>
<tr>
<th class="confluenceTh">Attribute name</th>
<th class="confluenceTh">Required</th>
@@ -197,8 +401,7 @@
<td class="confluenceTd">NO</td>
<td class="confluenceTd">The description of the exposed method, as it will appear in JMX.</td>
</tr>
-</tbody></table>
-
+</tbody></table></div>
<h2><a name="iPOJOJMXHandler-Examples"></a>Examples</h2>
@@ -207,79 +410,143 @@
<h3><a name="iPOJOJMXHandler-ExposingAttributes"></a>Exposing Attributes</h3>
<p>In first time we create a simple component named MyComponent. We have add two fields named m_level (int) and m_message (String).</p>
-<div class="code"><div class="codeContent">
-<pre class="code-java"><span class="code-keyword">public</span> class
+<div class="code">
+<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span></span><span class="keyword">public</span><span> </span><span class="keyword">class</span><span> </span></td></tr><tr><td class="line2">MyComponent ... { </td></tr><tr><td class="line1"> <span class="comment">// Exposed attributes</span><span> </span></td></tr><tr><td class="line2"> <span class="keyword">private</span><span> String m_message; </span></td></tr><tr><td class="line1"> <span class="keyword">private</span><span> int m_level; </span></td></tr><tr><td class="line2">} </td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">public class
MyComponent ... {
- <span class="code-comment">// Exposed attributes
-</span> <span class="code-keyword">private</span> <span class="code-object">String</span> m_message;
- <span class="code-keyword">private</span> <span class="code-object">int</span> m_level;
-}</pre>
-</div></div>
+ // Exposed attributes
+ private String m_message;
+ private int m_level;
+}</textarea>
+<script class="javascript">
+ if(!window.newcodemacro_initialised)
+ {
+ window.newcodemacro_initialised = true;
+ window.oldonloadmethod = window.onload;
+ window.onload = function(){
+ dp.SyntaxHighlighter.HighlightAll('newcodemacro');
+ if(window.oldonloadmethod)
+ {
+ window.oldonloadmethod();
+ }
+ }
+ }
+
+</script>
+</div>
+
<p>We expose now the attributes in the jmx:config<br>
tag in the metadata :</p>
-<div class="code"><div class="codeContent">
-<pre class="code-xml"><span class="code-tag"><?xml version=<span class="code-quote">"1.0"</span> encoding=<span class="code-quote">"UTF-8"</span>?></span>
-<span class="code-tag"><iPOJO <span class="code-keyword">xmlns:jmx</span>=<span class="code-quote">"org.apache.felix.ipojo.handlers.jmx"</span>></span>
- <component className=<span class="code-quote">"...MyComponent"</span>
- architecture=<span class="code-quote">"true"</span>
- immediate=<span class="code-quote">"true"</span>>
+<div class="code">
+<div class="dp-highlighter"><table class="dp-xml" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span></span><span class="tag"><?</span><span>xml </span><span class="attribute">version</span><span>=</span><span class="attribute-value">"1.0"</span><span> </span><span class="attribute">encoding</span><span>=</span><span class="attribute-value">"UTF-8"</span><span>?> </span></td></tr><tr><td class="line2"><span class="tag"><</span><span>iPOJO xmlns:</span><span class="attribute">jmx</span><span>=</span><span class="attribute-value">"org.apache.felix.ipojo.handlers.jmx"</span><span>> </span></td></tr><tr><td class="line1"> <span class="tag"><</span><span>component </span><span class="attribute">className</span><span>=</span><span class="attribute-value">"...MyComponent"</span><span> </span></td></tr><tr><td class="line2"> <span class="attribute">architecture</span><span>=</span><span class="attribute-value">"true"</span><span> </span></td></tr><tr><td class="line1"> <span class="attribute">immediate</span><span>=</span><span class="attribute-value">"true"</span><span>> </span></td></tr><tr><td class="line2"> </td></tr><tr><td class="line1"> <span class="tag"><</span><span>provides</span><span class="tag">/></span><span> </span></td></tr><tr><td class="line2"> <span class="tag"><</span><span>jmx:config</span><span class="tag">></span><span> </span></td></tr><tr><td class="line1"> <span class="comments"><!-- Exposed properties --></span><span> </span></td></tr><tr><td class="line2"> <span class="tag"><</span><span>jmx:property </span><span class="attribute">field</span><span>=</span><span class="attribute-value">"m_level"</span><span> </span></td></tr><tr><td class="line1"> <span class="attribute">name</span><span>=</span><span class="attribute-value">"The level"</span><span> </span></td></tr><tr><td class="line2"> <span class="attribute">rights</span><span>=</span><span class="attribute-value">"r"</span><span>/> </span></td></tr><tr><td class="line1"> <span class="tag"><</span><span>jmx:property </span><span class="attribute">field</span><span>=</span><span class="attribute-value">"m_message"</span><span> </span></td></tr><tr><td class="line2"> <span class="attribute">name</span><span>=</span><span class="attribute-value">"The message"</span><span> </span></td></tr><tr><td class="line1"> <span class="attribute">rights</span><span>=</span><span class="attribute-value">"w"</span><span>/> </span></td></tr><tr><td class="line2"> <span class="tag"></</span><span>jmx:config</span><span class="tag">></span><span> </span></td></tr><tr><td class="line1"> <span class="tag"></</span><span>component</span><span class="tag">></span><span> </span></td></tr><tr><td class="line2"> <span class="tag"><</span><span>instance </span></td></tr><tr><td class="line1"> <span class="attribute">component</span><span>=</span><span class="attribute-value">"...MyComponent"</span><span>/> </span></td></tr><tr><td class="line2"><span class="tag"></</span><span>iPOJO</span><span class="tag">></span><span> </span></td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="xml:nocontrols:nogutter" rows="10" readonly="readonly"><?xml version="1.0" encoding="UTF-8"?>
+<iPOJO xmlns:jmx="org.apache.felix.ipojo.handlers.jmx">
+ <component className="...MyComponent"
+ architecture="true"
+ immediate="true">
- <span class="code-tag"><provides/></span>
- <span class="code-tag"><jmx:config></span>
- <span class="code-tag"><span class="code-comment"><!-- Exposed properties --></span></span>
- <jmx:property field=<span class="code-quote">"m_level"</span>
- name=<span class="code-quote">"The level"</span>
- rights=<span class="code-quote">"r"</span>/>
- <jmx:property field=<span class="code-quote">"m_message"</span>
- name=<span class="code-quote">"The message"</span>
- rights=<span class="code-quote">"w"</span>/>
- <span class="code-tag"></jmx:config></span>
- <span class="code-tag"></component></span>
+ <provides/>
+ <jmx:config>
+ <!-- Exposed properties -->
+ <jmx:property field="m_level"
+ name="The level"
+ rights="r"/>
+ <jmx:property field="m_message"
+ name="The message"
+ rights="w"/>
+ </jmx:config>
+ </component>
<instance
- component=<span class="code-quote">"...MyComponent"</span>/>
-<span class="code-tag"></iPOJO></span></pre>
-</div></div>
+ component="...MyComponent"/>
+</iPOJO></textarea>
+<script class="javascript">
+ if(!window.newcodemacro_initialised)
+ {
+ window.newcodemacro_initialised = true;
+ window.oldonloadmethod = window.onload;
+ window.onload = function(){
+ dp.SyntaxHighlighter.HighlightAll('newcodemacro');
+ if(window.oldonloadmethod)
+ {
+ window.oldonloadmethod();
+ }
+ }
+ }
+
+</script>
+</div>
+
<p>Now, we could get and write the properties in the JConsole :<br>
-<img src="ipojo-jmx-handler_files/JMXHandler_1.png" align="absmiddle" border="0"></p>
+<img src="ipojo-jmx-handler_files/JMXHandler_1.png" border="0" align="absmiddle"></p>
<h3><a name="iPOJOJMXHandler-ExposingMethods"></a>Exposing Methods</h3>
<p>We could now add methods in the initial class :</p>
-<div class="code"><div class="codeContent">
-<pre class="code-java">/**
+<div class="code">
+<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span></span><span class="comment">/**</span></td></tr><tr><td class="line2"><span class="comment">Do something good</span></td></tr><tr><td class="line1"><span class="comment">*/</span><span> </span></td></tr><tr><td class="line2"><span class="keyword">public</span><span> </span><span class="keyword">void</span><span> doSomethingGood() { </span></td></tr><tr><td class="line1"> ... </td></tr><tr><td class="line2">} </td></tr><tr><td class="line1"> </td></tr><tr><td class="line2"><span class="comment">/**</span></td></tr><tr><td class="line1"><span class="comment">Do something bad</span></td></tr><tr><td class="line2"><span class="comment">*/</span><span> </span></td></tr><tr><td class="line1"><span class="keyword">public</span><span> </span><span class="keyword">void</span><span> doSomethingBad() { </span></td></tr><tr><td class="line2"> ... </td></tr><tr><td class="line1">} </td></tr><tr><td class="line2"> </td></tr><tr><td class="line1"><span class="comment">/**</span></td></tr><tr><td class="line2"><span class="comment">Do nothing</span></td></tr><tr><td class="line1"><span class="comment">*/</span><span> </span></td></tr><tr><td class="line2"><span class="keyword">public</span><span> </span><span class="keyword">void</span><span> doNothing() { </span></td></tr><tr><td class="line1"> ... </td></tr><tr><td class="line2">} </td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">/**
Do something good
*/
-<span class="code-keyword">public</span> void doSomethingGood() {
+public void doSomethingGood() {
...
}
/**
Do something bad
*/
-<span class="code-keyword">public</span> void doSomethingBad() {
+public void doSomethingBad() {
...
}
/**
Do nothing
*/
-<span class="code-keyword">public</span> void doNothing() {
+public void doNothing() {
...
-}</pre>
-</div></div>
+}</textarea>
+<script class="javascript">
+ if(!window.newcodemacro_initialised)
+ {
+ window.newcodemacro_initialised = true;
+ window.oldonloadmethod = window.onload;
+ window.onload = function(){
+ dp.SyntaxHighlighter.HighlightAll('newcodemacro');
+ if(window.oldonloadmethod)
+ {
+ window.oldonloadmethod();
+ }
+ }
+ }
+
+</script>
+</div>
+
<p>We add corresponding tags in the metadata to expose these methods:</p>
-<div class="code"><div class="codeContent">
-<pre class="code-xml"><span class="code-tag"><span class="code-comment"><!-- Exposed methods --></span></span>
-<jmx:method name=<span class="code-quote">"doSomethingGood"</span>
- description=<span class="code-quote">"Do something good."</span>/>
-<jmx:method name=<span class="code-quote">"doSomethingBad"</span>
- description=<span class="code-quote">"Do something bad."</span>/>
-<jmx:method name=<span class="code-quote">"doNothing"</span>
- description=<span class="code-quote">"Do absolutely nothing."</span>/></pre>
-</div></div>
+<div class="code">
+<div class="dp-highlighter"><table class="dp-xml" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span></span><span class="comments"><!-- Exposed methods --></span><span> </span></td></tr><tr><td class="line2"><span class="tag"><</span><span>jmx:method </span><span class="attribute">name</span><span>=</span><span class="attribute-value">"doSomethingGood"</span><span> </span></td></tr><tr><td class="line1"> <span class="attribute">description</span><span>=</span><span class="attribute-value">"Do something good."</span><span>/> </span></td></tr><tr><td class="line2"><span class="tag"><</span><span>jmx:method </span><span class="attribute">name</span><span>=</span><span class="attribute-value">"doSomethingBad"</span><span> </span></td></tr><tr><td class="line1"> <span class="attribute">description</span><span>=</span><span class="attribute-value">"Do something bad."</span><span>/> </span></td></tr><tr><td class="line2"><span class="tag"><</span><span>jmx:method </span><span class="attribute">name</span><span>=</span><span class="attribute-value">"doNothing"</span><span> </span></td></tr><tr><td class="line1"> <span class="attribute">description</span><span>=</span><span class="attribute-value">"Do absolutely nothing."</span><span>/> </span></td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="xml:nocontrols:nogutter" rows="10" readonly="readonly"><!-- Exposed methods -->
+<jmx:method name="doSomethingGood"
+ description="Do something good."/>
+<jmx:method name="doSomethingBad"
+ description="Do something bad."/>
+<jmx:method name="doNothing"
+ description="Do absolutely nothing."/></textarea>
+<script class="javascript">
+ if(!window.newcodemacro_initialised)
+ {
+ window.newcodemacro_initialised = true;
+ window.oldonloadmethod = window.onload;
+ window.onload = function(){
+ dp.SyntaxHighlighter.HighlightAll('newcodemacro');
+ if(window.oldonloadmethod)
+ {
+ window.oldonloadmethod();
+ }
+ }
+ }
+
+</script>
+</div>
+
<p>Now the three methods are exposed in the operations tab of the JConsole. We can invoked these methods :</p>
-<p><img src="ipojo-jmx-handler_files/JMXHandler_2.png" align="absmiddle" border="0"></p>
+<p><img src="ipojo-jmx-handler_files/JMXHandler_2.png" border="0" align="absmiddle"></p>
<h3><a name="iPOJOJMXHandler-AttributeNotifications:"></a>Attribute Notifications:</h3>
@@ -287,49 +554,79 @@
notification attribute in property tag. In our example if we want to be
notified when m_level is modified, we change the property line in the
metatada like this:</p>
-<div class="code"><div class="codeContent">
-<pre class="code-xml"><jmx:property field=<span class="code-quote">"m_level"</span>
- name=<span class="code-quote">"The level"</span>
- rights=<span class="code-quote">"r"</span>
- notification=<span class="code-quote">"true"</span>/></pre>
-</div></div>
+<div class="code">
+<div class="dp-highlighter"><table class="dp-xml" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span></span><span class="tag"><</span><span>jmx:property </span><span class="attribute">field</span><span>=</span><span class="attribute-value">"m_level"</span><span> </span></td></tr><tr><td class="line2"> <span class="attribute">name</span><span>=</span><span class="attribute-value">"The level"</span><span> </span></td></tr><tr><td class="line1"> <span class="attribute">rights</span><span>=</span><span class="attribute-value">"r"</span><span> </span></td></tr><tr><td class="line2"> <span class="attribute">notification</span><span>=</span><span class="attribute-value">"true"</span><span>/> </span></td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="xml:nocontrols:nogutter" rows="10" readonly="readonly"><jmx:property field="m_level"
+ name="The level"
+ rights="r"
+ notification="true"/></textarea>
+<script class="javascript">
+ if(!window.newcodemacro_initialised)
+ {
+ window.newcodemacro_initialised = true;
+ window.oldonloadmethod = window.onload;
+ window.onload = function(){
+ dp.SyntaxHighlighter.HighlightAll('newcodemacro');
+ if(window.oldonloadmethod)
+ {
+ window.oldonloadmethod();
+ }
+ }
+ }
+
+</script>
+</div>
+
<p>So now if we change the string through JConsole or if the POJO is
modified in other way, a notification will be sent to every listener.
For example, we subscribe in the notification tab, and we get
notification when the message changes :</p>
-<p><img src="ipojo-jmx-handler_files/JMXHandler_3.png" align="absmiddle" border="0"></p>
+<p><img src="ipojo-jmx-handler_files/JMXHandler_3.png" border="0" align="absmiddle"></p>
-<h2><a name="iPOJOJMXHandler-Configuringthehandlerwithannotations\Newin1.1.0SNAPSHOT\"></a>Configuring the handler with annotations [New in 1.1.0-SNAPSHOT]</h2>
+<h2><a name="iPOJOJMXHandler-Configuringthehandlerwithannotations"></a>Configuring the handler with annotations</h2>
-<p>It is possible to configure the handler with simple annotations
-available in the annotation pack ('annotation' project in the iPOJO
-trunk). Here is an example of usage:</p>
-<div class="code"><div class="codeContent">
-<pre class="code-java"><span class="code-keyword">import</span> org.apache.felix.ipojo.annotations.Component;
-<span class="code-keyword">import</span> org.apache.felix.ipojo.handlers.jmx.Config;
-<span class="code-keyword">import</span> org.apache.felix.ipojo.handlers.jmx.Method;
-<span class="code-keyword">import</span> org.apache.felix.ipojo.handlers.jmx.Property;
+<p>It is possible to configure the handler with simple annotations available with iPOJO annotations. Here is an example of usage:</p>
+<div class="code">
+<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span></span><span class="keyword">import</span><span> org.apache.felix.ipojo.annotations.Component; </span></td></tr><tr><td class="line2"><span class="keyword">import</span><span> org.apache.felix.ipojo.handlers.jmx.Config; </span></td></tr><tr><td class="line1"><span class="keyword">import</span><span> org.apache.felix.ipojo.handlers.jmx.Method; </span></td></tr><tr><td class="line2"><span class="keyword">import</span><span> org.apache.felix.ipojo.handlers.jmx.Property; </span></td></tr><tr><td class="line1"><span class="preprocessor"></span></td></tr><tr><td class="line2"><span class="preprocessor">@Component</span><span> </span></td></tr><tr><td class="line1"><span class="preprocessor">@Config(domain="my-domain", usesMOSGi=false)</span><span> </span></td></tr><tr><td class="line2"><span class="keyword">public</span><span> </span><span class="keyword">class</span><span> JMXSimple { </span></td></tr><tr><td class="line1"><span class="preprocessor"></span></td></tr><tr><td class="line2"><span class="preprocessor"> @Property(name="prop", notification=true, rights="w") // Field published in the MBean</span><span> </span></td></tr><tr><td class="line1"> String m_foo; </td></tr><tr><td class="line2"><span class="preprocessor"> </span></td></tr><tr><td class="line1"><span class="preprocessor"> @Method(description="set the foo prop") // Method published in the MBean</span><span> </span></td></tr><tr><td class="line2"> <span class="keyword">public</span><span> </span><span class="keyword">void</span><span> setFoo(String mes) { </span></td></tr><tr><td class="line1"> System.out.println(<span class="string">"Set foo to "</span><span> + mes); </span></td></tr><tr><td class="line2"> m_foo = mes; </td></tr><tr><td class="line1"> } </td></tr><tr><td class="line2"><span class="preprocessor"> </span></td></tr><tr><td class="line1"><span class="preprocessor"> @Method(description="get the foo prop") // Method published in the MBean</span><span> </span></td></tr><tr><td class="line2"> <span class="keyword">public</span><span> String getFoo() { </span></td></tr><tr><td class="line1"> <span class="keyword">return</span><span> m_foo; </span></td></tr><tr><td class="line2"> } </td></tr><tr><td class="line1">} </td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">import org.apache.felix.ipojo.annotations.Component;
+import org.apache.felix.ipojo.handlers.jmx.Config;
+import org.apache.felix.ipojo.handlers.jmx.Method;
+import org.apache.felix.ipojo.handlers.jmx.Property;
@Component
-@Config(domain=<span class="code-quote">"my-domain"</span>, usesMOSGi=<span class="code-keyword">false</span>)
-<span class="code-keyword">public</span> class JMXSimple {
+@Config(domain="my-domain", usesMOSGi=false)
+public class JMXSimple {
- @Property(name=<span class="code-quote">"prop"</span>, notification=<span class="code-keyword">true</span>, rights=<span class="code-quote">"w"</span>) <span class="code-comment">// Field published in the MBean
-</span> <span class="code-object">String</span> m_foo;
+ @Property(name="prop", notification=true, rights="w") // Field published in the MBean
+ String m_foo;
- @Method(description=<span class="code-quote">"set the foo prop"</span>) <span class="code-comment">// Method published in the MBean
-</span> <span class="code-keyword">public</span> void setFoo(<span class="code-object">String</span> mes) {
- <span class="code-object">System</span>.out.println(<span class="code-quote">"Set foo to "</span> + mes);
+ @Method(description="set the foo prop") // Method published in the MBean
+ public void setFoo(String mes) {
+ System.out.println("Set foo to " + mes);
m_foo = mes;
}
- @Method(description=<span class="code-quote">"get the foo prop"</span>) <span class="code-comment">// Method published in the MBean
-</span> <span class="code-keyword">public</span> <span class="code-object">String</span> getFoo() {
- <span class="code-keyword">return</span> m_foo;
+ @Method(description="get the foo prop") // Method published in the MBean
+ public String getFoo() {
+ return m_foo;
}
-}</pre>
-</div></div>
+}</textarea>
+<script class="javascript">
+ if(!window.newcodemacro_initialised)
+ {
+ window.newcodemacro_initialised = true;
+ window.oldonloadmethod = window.onload;
+ window.onload = function(){
+ dp.SyntaxHighlighter.HighlightAll('newcodemacro');
+ if(window.oldonloadmethod)
+ {
+ window.oldonloadmethod();
+ }
+ }
+ }
+
+</script>
+</div>
+
<p>The <tt>@org.apache.felix.ipojo.handlers.jmx.Config</tt> (<tt>@Config</tt> if the package it correctly imported) annotation is a type annotation (so placed on the <tt>class</tt> element. This annotation indicates that the instance will be exposed as an MBean. This annotation supports:</p>
<ul>
<li>usesMOSGi: set to <tt>true</tt> to use MOSGi. Otherwise, the MBean will be exposed in the MBean Platform Server (default: <tt>false</tt>).</li>
@@ -349,82 +646,26 @@
<p>The <tt>@org.apache.felix.ipojo.handlers.jmx.Method</tt> (<tt>@Method</tt>) annotation is a method annotation indicating that the method is exposed in the MBean. Only one attribute can be customized:</p>
<ul>
- <li>description: set the method description.</li>
-</ul>
-</td>
-<td class="confluenceTd" valign="top" width="20%">
-<h6><a name="iPOJOJMXHandler-Overview"></a><b>Overview</b></h6>
-<ul>
- <li><a href="http://felix.apache.org/site/apache-felix-ipojo.html" title="Apache Felix iPOJO">Home Page</a></li>
- <li><a href="http://felix.apache.org/site/apache-felix-ipojo-feature-overview.html" title="Apache Felix iPOJO Feature Overview">iPOJO Feature Overview</a></li>
- <li><a href="http://felix.apache.org/site/download.html" title="Download">Download & Install </a></li>
-</ul>
+ <li>description: set the method description.
+<br clear="all">
+<br clear="all">
-
-<h6><a name="iPOJOJMXHandler-GettingStarted"></a><b>Getting Started</b></h6>
-<ul>
- <li><a href="http://felix.apache.org/site/ipojo-in-10-minutes.html" title="iPOJO in 10 minutes">iPOJO in 10 minutes</a></li>
- <li><a href="http://felix.apache.org/site/how-to-use-ipojo-annotations.html" title="How to use iPOJO Annotations">How to use iPOJO Annotations</a></li>
- <li><a href="http://felix.apache.org/site/ipojo-hello-word-maven-based-tutorial.html" title="iPOJO Hello Word (Maven-Based) tutorial">iPOJO Hello Word (Maven-Based) tutorial</a></li>
- <li><a href="http://felix.apache.org/site/ipojo-advanced-tutorial.html" title="iPOJO Advanced Tutorial">iPOJO Advanced Tutorial</a></li>
- <li><a href="http://felix.apache.org/site/ipojo-composition-tutorial.html" title="iPOJO Composition Tutorial">iPOJO Composition Tutorial</a></li>
-</ul>
-
-
-<h6><a name="iPOJOJMXHandler-UserGuide"></a><b>User Guide</b></h6>
-<ul>
- <li><a href="http://felix.apache.org/site/describing-components.html" title="Describing components">Describing components (handler list) </a></li>
- <li><a href="http://felix.apache.org/site/using-xml-schemas.html" title="Using XML Schemas">Using XML Schemas</a></li>
- <li><a href="http://felix.apache.org/site/apache-felix-ipojo-testing-components.html" title="apache-felix-ipojo-testing-components">Testing components</a></li>
- <li><a href="http://felix.apache.org/site/ipojo-advanced-topics.html" title="iPOJO Advanced Topics">Advanced Topics</a></li>
- <li><a href="http://felix.apache.org/site/ipojo-faq.html" title="iPOJO FAQ">FAQ</a></li>
-</ul>
-
-
-<h6><a name="iPOJOJMXHandler-Tools"></a><b>Tools</b></h6>
-<ul>
- <li><a href="http://felix.apache.org/site/ipojo-eclipse-plug-in.html" title="iPOJO Eclipse Plug-in">iPOJO Eclipse Plug-in</a></li>
- <li><a href="http://felix.apache.org/site/ipojo-ant-task.html" title="iPOJO Ant Task">iPOJO Ant Task</a></li>
- <li><a href="http://felix.apache.org/site/ipojo-maven-plug-in.html" title="iPOJO Maven Plug-in">iPOJO Maven Plug-in</a></li>
- <li><a href="http://felix.apache.org/site/apache-felix-ipojo-junit4osgi.html" title="apache-felix-ipojo-junit4osgi">Junit4OSGi</a></li>
- <li><a href="http://felix.apache.org/site/ipojo-concepts-overview.html" title="iPOJO Concepts Overview">iPOJO concepts overview</a></li>
-</ul>
-
-
-<h6><a name="iPOJOJMXHandler-DeveloperGuide"></a><b>Developer Guide</b></h6>
-<ul>
- <li>API: <span class="nobr"><a href="http://people.apache.org/%7Eclement/ipojo/api/1.0/" title="Visit page outside Confluence" rel="nofollow">1.0<sup><img class="rendericon" src="ipojo-jmx-handler_files/linkext7.gif" alt="" align="absmiddle" border="0" width="7" height="7"></sup></a></span></li>
- <li><a href="http://felix.apache.org/site/how-to-write-your-own-handler.html" title="How to write your own handler">How to write your own handler</a></li>
- <li><a href="http://felix.apache.org/site/how-to-use-ipojo-manipulation-metadata.html" title="How to use iPOJO Manipulation Metadata">How to use iPOJO Manipulation Metadata</a></li>
- <li><a href="http://felix.apache.org/site/dive-into-the-ipojo-manipulation-depths.html" title="Dive into the iPOJO Manipulation depths">Dive into the iPOJO Manipulation depths</a></li>
-</ul>
-
-
-<h6><a name="iPOJOJMXHandler-Misc&Contact"></a><b>Misc & Contact</b></h6>
-<ul>
- <li><a href="http://felix.apache.org/site/apache-felix-ipojo-issuestracker.html" title="apache-felix-ipojo-issuestracker">Issues Tracker</a></li>
- <li><a href="http://felix.apache.org/site/apache-felix-ipojo-supportedvms.html" title="apache-felix-ipojo-supportedVMs">Supported JVMs</a></li>
- <li><a href="http://felix.apache.org/site/apache-felix-ipojo-supportedosgi.html" title="apache-felix-ipojo-supportedOSGi">Supported OSGi Implementations</a></li>
- <li><span class="nobr"><a href="http://ipojo-dark-side.blogspot.com/" title="Visit page outside Confluence" rel="nofollow">iPOJO's Dark Side Blog<sup><img class="rendericon" src="ipojo-jmx-handler_files/linkext7.gif" alt="" align="absmiddle" border="0" width="7" height="7"></sup></a></span></li>
- <li><a href="http://felix.apache.org/site/future-ideas.html" title="Future Ideas">Future Ideas</a></li>
- <li><a href="http://felix.apache.org/site/contact.html" title="Contact">Contact</a></li>
- <li><a href="http://felix.apache.org/site/related-works.html" title="Related Works">Related Works</a></li>
- <li><a href="http://felix.apache.org/site/article-presentations.html" title="Article & Presentations">Article & Presentations</a></li>
-</ul>
-
-
-<hr>
-<div class="" align="center">
-<p><span class="nobr"><a href="http://cwiki.apache.org/confluence/createrssfeed.action?types=blogpost&statuses=created&statuses=modified&spaces=FELIX&labelString=iPOJO&rssType=atom&maxResults=10&timeSpan=5&publicFeed=true&title=iPOJO%20Atom%20Feed" title="Stay tuned!" rel="nofollow"><img src="ipojo-jmx-handler_files/feed-icon-32x32.png" align="absmiddle" border="0"><sup><img class="rendericon" src="ipojo-jmx-handler_files/linkext7.gif" alt="" align="absmiddle" border="0" width="7" height="7"></sup></a></span></p></div>
+ </li></ul></div>
+ <img src="ipojo-jmx-handler_files/footer.png" class="footer">
+</div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script><script src="ipojo-jmx-handler_files/ga.js" type="text/javascript"></script>
<script type="text/javascript">
+try{
var pageTracker = _gat._getTracker("UA-1518442-4");
pageTracker._trackPageview();
+} catch(err) {}
</script>
-</td></tr></tbody></table>
+
+
+
</div>
</body></html>
\ No newline at end of file