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 2013/02/03 07:45:22 UTC
svn commit: r849204 [14/33] - in /websites/staging/felix/trunk/content: ./
documentation/subprojects/ documentation/subprojects/apache-felix-ipojo/
documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-devguide/
documentation/subprojects/apac...
Modified: websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-tools/ipojo-arch-command.html
==============================================================================
--- websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-tools/ipojo-arch-command.html (original)
+++ websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-tools/ipojo-arch-command.html Sun Feb 3 06:45:21 2013
@@ -20,9 +20,45 @@
<head>
<title>Apache Felix - iPOJO-Arch-Command</title>
<link rel="icon" href="/res/favicon.ico">
- <link rel="stylesheet" href="/res/site.css" type="text/css" media="all">
- <link rel="stylesheet" href="/res/codehilite.css" type="text/css" media="all">
+ <link rel="stylesheet" href="/site/media.data/site.css" type="text/css" media="all">
+ <link rel="stylesheet" href="/ipojo/site/superfish.css" type="text/css" media="all">
+ <link rel="stylesheet" href="/ipojo/site/style.css" type="text/css" media="all">
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+
+ <!--
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shCore.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushCSharp.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushPhp.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushJScript.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushVb.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushSql.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushXml.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushShell.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushDelphi.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushPython.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushJava.js"></script>
+ -->
+
+ <script type="text/javascript" src="/ipojo/site/jquery-1.js"></script>
+ <script type="text/javascript" src="/ipojo/site/hoverIntent.js"></script>
+ <script type="text/javascript" src="/ipojo/site/superfish.js"></script>
+ <script type="text/javascript" src="/ipojo/site/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>
+
</head>
<body>
<div class="title">
@@ -37,111 +73,206 @@
</a>
</div>
</div>
+
+ <div class="main">
+ <div class="main">
+ <div class="page-header">
+ <img src="/ipojo/site/header.png" class="header">
+ <a href="http://ipojo.org"><img src="/ipojo/site/ipojo.png" width="225" class="header-logo"></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></a>
+ <ul>
+ <li>
+ <a href="">Home</a>
+ </li>
+ <li>
+ <a href="">Why choose iPOJO</a>
+ </li>
+ <li>
+ <a href="">Success stories</a>
+ </li>
+ <li>
+ <a href="">Features</a>
+ </li>
+ </ul>
+ </li>
- <div class="menu">
- <p><a href="/news.html">news</a> <br />
-<a href="/license.html">license</a> <br />
-<a href="/downloads.cgi">downloads</a> <br />
-<a href="/documentation.html">documentation</a> <br />
-<a href="/mailinglists.html">mailing lists</a> <br />
-<a href="/documentation/community/contributing.html">contributing</a> <br />
-<a href="/sitemap.html">site map</a> <br />
-<a href="http://www.apache.org/">asf</a> <br />
-<a href="http://www.apache.org/security/">security</a> <br />
-<a href="http://www.apache.org/foundation/sponsorship.html">sponsorship</a> <br />
-<a href="http://www.apache.org/foundation/thanks.html">sponsors</a> <br />
-</p>
-<iframe
- src="http://www.apache.org/ads/button.html"
- style="border-width:0; float: left"
- frameborder="0"
- scrolling="no"
- width="135"
- height="135">
-</iframe>
- </div>
+ <li class="">
+ <!-- Menu download -->
+ <li>
+ <a href="/downloads.cgi">Download </a>
+ </li>
- <div class="main">
- <div class="breadcrump" style="font-size: 80%;">
- <a href="/">Home</a> » <a href="/documentation.html">Documentation</a> » <a href="/documentation/subprojects.html">Apache Felix Subproject Documentation</a> » <a href="/documentation/subprojects/apache-felix-ipojo.html">Apache Felix iPOJO</a> » <a href="/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-tools.html">apache-felix-ipojo-tools</a>
- </div>
-
+ <li class="">
+ <!-- Menu Documentation -->
+ <a href="#" class="sf-with-ul">Documentation<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+ <ul>
+ <!-- sub-menu : getting started -->
+ <li class="">
+ <a href="#" class="sf-with-ul">Getting Started<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+ <ul>
+ <li><a href="">iPOJO in 10 minutes</a></li>
+ <li><a href="">Using Annotations</a></li>
+ <li><a href="">Maven tutorial</a></li>
+ <li><a href="">Advanced tutorial</a></li>
+ <li><a href="">Using Distributed OSGi</a></li>
+ <li><a href="">Application Composition</a></li>
+ </ul>
+ </li> <!-- end of getting started -->
+ <!-- sub menu : Describing Components -->
+ <li class="">
+ <a href="" class="sf-with-ul">Describing components<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+ <ul>
+ <li><a href="">Requiring a service</a></li>
+ <li><a href="">Providing a service</a></li>
+ <li><a href="">Lifecycle management</a></li>
+ <li><a href="">Configuration</a></li>
+ <li><a href="">Introspection</a></li>
+ <li><a href="">Impacting the lifecycle</a></li>
+ <li><a href="">Asynchronous communication</a></li>
+ <li><a href="">JMX management</a></li>
+ <li><a href="">Extender pattern</a></li>
+ <li><a href="">Whiteboard pattern</a></li>
+ <li><a href="">Temporal dependencies</a></li>
+ </ul>
+ </li> <!-- End of describing components -->
+ <!-- sub-menu : User Guide -->
+ <li class="">
+ <a href="" class="sf-with-ul">User Guide<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+ <ul>
+ <li><a href="">iPOJO and config admin</a></li>
+ <li><a href="">Factories and Instances</a></li>
+ <li><a href="">XML Schemas</a></li>
+ <li><a href="">API</a></li>
+ <li><a href="">Testing components</a></li>
+ <li><a href="">Eclipse Integration</a></li>
+ <li><a href="">FAQ</a></li>
+ <li><a href="">Reference Card</a></li>
+ </ul>
+ </li> <!-- end of user guide -->
+ <!-- sub-menu : Dev Guide -->
+ <li>
+ <a href="#" class="sf-with-ul">Advanced Topics<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+ <ul>
+ <li><a href="http://felix.apache.org/ipojo/api/1.6.0">Javadoc</a></li>
+ <li><a href="">Handler development</a></li>
+ <li><a href="">Manipulation Metadata </a></li>
+ <li><a href="">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></a>
+ <ul>
+ <li><a href="">Ant Task</a></li>
+ <li><a href="">Eclipse Plugin</a></li>
+ <li><a href="">Maven Plugin</a></li>
+ <li><a href="">`arch` shell command</a></li>
+ <li><a href="">Online Manipulator</a></li>
+ <li><a href="">Webconsole plugin</a></li>
+ <li><a href="">Junit4OSGi</a></li>
+ </ul>
+ </li><!-- End of tools -->
+ <!-- Menu 5 : Support -->
+ <li>
+ <a href="">Support </a>
+ </li>
+ <!-- End of the menu 5 -->
+ <!-- Menu 6 : Misc -->
+ <li class="">
+ <a href="#" class="sf-with-ul">Misc<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+ <ul>
+ <li><a href="">Supported JVMs</a></li>
+ <li><a href="">Supported OSGi Implementations</a></li>
+ <li><a href="http://ipojo-dark-side.blogspot.com">iPOJO's Dark Side Blog</a></li>
+ <li><a href="">Article & Presentations</a></li>
+ <li><a href="http://www.apache.org/">ASF</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Sponsors</a></li>
+ </ul>
+ </li><!-- End of misc -->
+ </ul> <!-- End of the menu -->
+ </div> <!-- Page header -->
+
+ <!--
<div class="tip">
This page is a translated version of <a href="/site/ipojo-arch-command.html" target="felix_cwiki">/site/ipojo-arch-command.html</a>. In case of
doubt you might want to refer to the old page.
</div>
+ -->
<h1>iPOJO-Arch-Command</h1>
- <p>{include:apache-felix-ipojo-header}</p>
-<div class="content">
-
-# iPOJO `Arch` command
-*Architecture introspection is required when the system doesn't work as expected. In this case, having a quick access to instances states and interconnection is a stringent requirement. The `arch` command allows getting these data from the Felix Shell, from the Equinox shell and Gogo.*
-
-*Note* : The Gogo commands are not yet released but are available from the iPOJO trunk.
-
-{div:class=toc}
+
+ <div class="content">
+ <h1 id="ipojo-arch-command">iPOJO <code>Arch</code> command</h1>
+<p><em>Architecture introspection is required when the system doesn't work as expected. In this case, having a quick access to instances states and interconnection is a stringent requirement. The <code>arch</code> command allows getting these data from the Felix Shell, from the Equinox shell and Gogo.</em></p>
+<p><em>Note</em> : The Gogo commands are not yet released but are available from the iPOJO trunk.</p>
+<p>{div:class=toc}
[TOC]
-{div}
-
-## Download
-The Felix commands is available from the [download](/documentation/subprojects/apache-felix-ipojo/download.html) page.
-The Equinox command sources are available [http://svn.apache.org/repos/asf/felix/sandbox/clement/ipojo-utils/arch-equinox/](http://svn.apache.org/viewvc/felix/sandbox/clement/ipojo-utils/arch-equinox/). To compile sources, just launch the `mvn clean install` and deploy the resulting bundle.
-
-## Installation
-Once you get the bundle, just install and start it in the OSGi Framework shell:
+{div}</p>
+<h2 id="download">Download</h2>
+<p>The Felix commands is available from the <a href="/documentation/subprojects/apache-felix-ipojo/download.html">download</a> page.
+The Equinox command sources are available <a href="http://svn.apache.org/viewvc/felix/sandbox/clement/ipojo-utils/arch-equinox/">http://svn.apache.org/repos/asf/felix/sandbox/clement/ipojo-utils/arch-equinox/</a>. To compile sources, just launch the <code>mvn clean install</code> and deploy the resulting bundle.</p>
+<h2 id="installation">Installation</h2>
+<p>Once you get the bundle, just install and start it in the OSGi Framework shell:
{code:xml|title=Felix}
-start file:/BUNDLE_URL.jar
+start file:/BUNDLE_URL.jar</p>
+<div class="codehilite"><pre><span class="p">{</span><span class="n">code:xml</span><span class="o">|</span><span class="n">title</span><span class="o">=</span><span class="n">Equinox</span><span class="p">}</span>
+<span class="n">install</span> <span class="n">file:</span><span class="o">/</span><span class="n">BUNDLE_URL</span><span class="o">.</span><span class="n">jar</span>
+<span class="n">Bundle</span> <span class="n">X</span> <span class="n">installed</span>
+<span class="n">start</span> <span class="n">X</span>
+</pre></div>
- {code:xml|title=Equinox}
- install file:/BUNDLE_URL.jar
- Bundle X installed
- start X
-{code:xml|title=Gogo}
-install file:/ARCH*GOGO*URL.jar
+<p>{code:xml|title=Gogo}
+install file:/ARCH<em>GOGO</em>URL.jar
Bundle X installed
-start X
+start X</p>
+<div class="codehilite"><pre><span class="n">h2</span><span class="o">.</span> <span class="n">Equinox</span> <span class="ow">and</span> <span class="n">Felix</span> <span class="n">Shells</span>
- h2. Equinox and Felix Shells
+<span class="n">Then</span><span class="p">,</span> <span class="n">you</span> <span class="n">can</span> <span class="k">use</span> <span class="n">it</span> <span class="n">to</span> <span class="n">introspect</span> <span class="n">the</span> <span class="nb">system</span> <span class="n">by</span> <span class="n">launching</span> <span class="n">the</span> <span class="n">command</span><span class="o">.</span>
+</pre></div>
- Then, you can use it to introspect the system by launching the command.
-arch => displays instances name & state (equivalent to arch \-instances)
-arch -instance $instance*name => displays complete information about the instance $instance*name
-arch -factories => display the list of available factories
-arch -factory $factory*name => display complete information about the factory $factory*name
-arch -handlers => list available handlers
-
- h2. Gogo Shell Commands
- The set of commands available from Gogo is a little bit different:
- * (or just ) lists the instances and state
- * (or just ) displays the complete information about the specified $instance_name
- * (or just ) lists the available public factories
- * (or just ) displays complete information about the factory $factory_name
- * (or just lists available handlers
-
- h2. Reading instance architecture
- When you launch the command (or on Gogo), the list of created instances (enabling architecture introspection) is displayed.
- {code:title=Felix or Equinox}
- -> arch
- Instance ArchCommand -> valid
- Instance spell.english.EnglishDictionary-0 -> valid
- Instance spell.checker.SpellCheck-0 -> valid
- Instance spell.gui.SpellCheckerGui-0 -> valid
+<p>arch => displays instances name & state (equivalent to arch -instances)
+arch -instance $instance<em>name => displays complete information about the instance $instance</em>name
+arch -factories => display the list of available factories
+arch -factory $factory<em>name => display complete information about the factory $factory</em>name
+arch -handlers => list available handlers</p>
+<div class="codehilite"><pre><span class="n">h2</span><span class="o">.</span> <span class="n">Gogo</span> <span class="n">Shell</span> <span class="n">Commands</span>
+<span class="n">The</span> <span class="n">set</span> <span class="n">of</span> <span class="n">commands</span> <span class="n">available</span> <span class="n">from</span> <span class="n">Gogo</span> <span class="n">is</span> <span class="n">a</span> <span class="n">little</span> <span class="n">bit</span> <span class="n">different:</span>
+<span class="o">*</span> <span class="p">(</span><span class="ow">or</span> <span class="n">just</span> <span class="p">)</span> <span class="n">lists</span> <span class="n">the</span> <span class="n">instances</span> <span class="ow">and</span> <span class="n">state</span>
+<span class="o">*</span> <span class="p">(</span><span class="ow">or</span> <span class="n">just</span> <span class="p">)</span> <span class="n">displays</span> <span class="n">the</span> <span class="n">complete</span> <span class="n">information</span> <span class="n">about</span> <span class="n">the</span> <span class="n">specified</span> <span class="nv">$instance_name</span>
+<span class="o">*</span> <span class="p">(</span><span class="ow">or</span> <span class="n">just</span> <span class="p">)</span> <span class="n">lists</span> <span class="n">the</span> <span class="n">available</span> <span class="n">public</span> <span class="n">factories</span>
+<span class="o">*</span> <span class="p">(</span><span class="ow">or</span> <span class="n">just</span> <span class="p">)</span> <span class="n">displays</span> <span class="n">complete</span> <span class="n">information</span> <span class="n">about</span> <span class="n">the</span> <span class="n">factory</span> <span class="nv">$factory_name</span>
+<span class="o">*</span> <span class="p">(</span><span class="ow">or</span> <span class="n">just</span> <span class="n">lists</span> <span class="n">available</span> <span class="n">handlers</span>
+
+<span class="n">h2</span><span class="o">.</span> <span class="n">Reading</span> <span class="n">instance</span> <span class="n">architecture</span>
+<span class="n">When</span> <span class="n">you</span> <span class="n">launch</span> <span class="n">the</span> <span class="n">command</span> <span class="p">(</span><span class="ow">or</span> <span class="n">on</span> <span class="n">Gogo</span><span class="p">),</span> <span class="n">the</span> <span class="n">list</span> <span class="n">of</span> <span class="n">created</span> <span class="n">instances</span> <span class="p">(</span><span class="n">enabling</span> <span class="n">architecture</span> <span class="n">introspection</span><span class="p">)</span> <span class="n">is</span> <span class="n">displayed</span><span class="o">.</span>
+<span class="p">{</span><span class="n">code:title</span><span class="o">=</span><span class="n">Felix</span> <span class="ow">or</span> <span class="n">Equinox</span><span class="p">}</span>
+<span class="o">-></span> <span class="n">arch</span>
+<span class="n">Instance</span> <span class="n">ArchCommand</span> <span class="o">-></span> <span class="n">valid</span>
+<span class="n">Instance</span> <span class="n">spell</span><span class="o">.</span><span class="n">english</span><span class="o">.</span><span class="n">EnglishDictionary</span><span class="o">-</span><span class="mi">0</span> <span class="o">-></span> <span class="n">valid</span>
+<span class="n">Instance</span> <span class="n">spell</span><span class="o">.</span><span class="n">checker</span><span class="o">.</span><span class="n">SpellCheck</span><span class="o">-</span><span class="mi">0</span> <span class="o">-></span> <span class="n">valid</span>
+<span class="n">Instance</span> <span class="n">spell</span><span class="o">.</span><span class="n">gui</span><span class="o">.</span><span class="n">SpellCheckerGui</span><span class="o">-</span><span class="mi">0</span> <span class="o">-></span> <span class="n">valid</span>
+</pre></div>
-<DIV class="code panel" style="border-style: solid;border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><B>Gogo</B></DIV><DIV class="codeContent panelContent">
- $ instances
- Instance ArchCommand -> valid
- Instance spell.english.EnglishDictionary-0 -> valid
- Instance spell.checker.SpellCheck-0 -> valid
- Instance spell.gui.SpellCheckerGui-0 -> valid
-To get more information on an instance, launch `arch -instance the*instance*name` (or `instance the*instance*name` on Gogo)
+<p><DIV class="code panel" style="border-style: solid;border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><B>Gogo</B></DIV><DIV class="codeContent panelContent">
+ $ instances
+ Instance ArchCommand -> valid
+ Instance spell.english.EnglishDictionary-0 -> valid
+ Instance spell.checker.SpellCheck-0 -> valid
+ Instance spell.gui.SpellCheckerGui-0 -> valid</p>
+<p>To get more information on an instance, launch <code>arch -instance the*instance*name</code> (or <code>instance the*instance*name</code> on Gogo)
<DIV class="code panel" style="border-style: solid;border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><B>Felix or Equinox</B></DIV><DIV class="codeContent panelContent">
- -> arch -instance spell.checker.SpellCheck-0
+ -> arch -instance spell.checker.SpellCheck-0 <br />
instance component.type="spell.checker.SpellCheck" state="valid" bundle="8" name="spell.checker.SpellCheck-0"
handler state="valid" name="org.apache.felix.ipojo.handlers.dependency.DependencyHandler"
requires optional="false" aggregate="false" state="resolved" binding-policy="dynamic" specification="spell.services.DictionaryService"
@@ -149,10 +280,9 @@ To get more information on an instance,
provides service.id="36" state="registered" specifications="[spell.services.SpellChecker]"
property value="spell.checker.SpellCheck" name="factory.name"
property value="spell.checker.SpellCheck-0" name="instance.name"
- handler state="valid" name="org.apache.felix.ipojo.handlers.architecture.ArchitectureHandler"
-
-<DIV class="code panel" style="border-style: solid;border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><B>Gogo</B></DIV><DIV class="codeContent panelContent">
- $ipojo:instance spell.checker.SpellCheck-0
+ handler state="valid" name="org.apache.felix.ipojo.handlers.architecture.ArchitectureHandler"</p>
+<p><DIV class="code panel" style="border-style: solid;border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><B>Gogo</B></DIV><DIV class="codeContent panelContent">
+ $ipojo:instance spell.checker.SpellCheck-0 <br />
instance component.type="spell.checker.SpellCheck" state="valid" bundle="8" name="spell.checker.SpellCheck-0"
handler state="valid" name="org.apache.felix.ipojo.handlers.dependency.DependencyHandler"
requires optional="false" aggregate="false" state="resolved" binding-policy="dynamic" specification="spell.services.DictionaryService"
@@ -160,27 +290,27 @@ To get more information on an instance,
provides service.id="36" state="registered" specifications="[spell.services.SpellChecker]"
property value="spell.checker.SpellCheck" name="factory.name"
property value="spell.checker.SpellCheck-0" name="instance.name"
- handler state="valid" name="org.apache.felix.ipojo.handlers.architecture.ArchitectureHandler"
+ handler state="valid" name="org.apache.felix.ipojo.handlers.architecture.ArchitectureHandler"</p>
+<p>Instance architecture is organized as follows:
+On the first line, are displayed the component type (i.e. factory), the instance state (<code>valid</code> or <code>invalid</code>), the bundle from which the instance is created, and the instance name.
+Then, the information is organized handler by handler (a piece of container). For each handler plugged on the instance can participate to the instance architecture. For each handler its name (such as <code>org.apache.felix.ipojo.handlers.dependency.DependencyHandler</code> for iPOJO service dependencies, <code>org.apache.felix.ipojo.handlers.providedservice.ProvidedServiceHandler</code> for iPOJO service providing...) and the state (either <code>valid</code> or <code>invalid</code> are displayed. Remember that an instance is valid only and only if all plugged handlers are valid.
+The <code>org.apache.felix.ipojo.handlers.dependency.DependencyHandler</code> provides data on service dependencies and more precisely on the state of service dependencies. In the previous example, the dependency on <code>spell.services.DictionaryService</code> was resolved. On the following example, the same dependency is no more resolved:</p>
+<div class="codehilite"><pre><span class="n">instance</span> <span class="n">component</span><span class="o">.</span><span class="n">type</span><span class="o">=</span><span class="s">"spell.checker.SpellCheck"</span> <span class="n">state</span><span class="o">=</span><span class="s">"invalid"</span> <span class="n">bundle</span><span class="o">=</span><span class="s">"8"</span> <span class="n">name</span><span class="o">=</span><span class="s">"spell.checker.SpellCheck-0"</span>
+ <span class="n">handler</span> <span class="n">state</span><span class="o">=</span><span class="s">"invalid"</span> <span class="n">name</span><span class="o">=</span><span class="s">"org.apache.felix.ipojo.handlers.dependency.DependencyHandler"</span>
+ <span class="n">requires</span> <span class="n">optional</span><span class="o">=</span><span class="s">"false"</span> <span class="n">aggregate</span><span class="o">=</span><span class="s">"false"</span> <span class="n">state</span><span class="o">=</span><span class="s">"unresolved"</span> <span class="n">binding</span><span class="o">-</span><span class="n">policy</span><span class="o">=</span><span class="s">"dynamic"</span> <span class="n">specification</span><span class="o">=</span><span class="s">"spell.services.DictionaryService"</span>
+ <span class="n">handler</span> <span class="n">state</span><span class="o">=</span><span class="s">"valid"</span> <span class="n">name</span><span class="o">=</span><span class="s">"org.apache.felix.ipojo.handlers.providedservice.ProvidedServiceHandler"</span>
+ <span class="n">provides</span> <span class="n">state</span><span class="o">=</span><span class="s">"unregistered"</span> <span class="n">specifications</span><span class="o">=</span><span class="s">"[spell.services.SpellChecker]"</span>
+ <span class="n">property</span> <span class="n">value</span><span class="o">=</span><span class="s">"spell.checker.SpellCheck"</span> <span class="n">name</span><span class="o">=</span><span class="s">"factory.name"</span>
+ <span class="n">property</span> <span class="n">value</span><span class="o">=</span><span class="s">"spell.checker.SpellCheck-0"</span> <span class="n">name</span><span class="o">=</span><span class="s">"instance.name"</span>
+ <span class="n">handler</span> <span class="n">state</span><span class="o">=</span><span class="s">"valid"</span> <span class="n">name</span><span class="o">=</span><span class="s">"org.apache.felix.ipojo.handlers.architecture.ArchitectureHandler"</span>
+</pre></div>
-Instance architecture is organized as follows:
-On the first line, are displayed the component type (i.e. factory), the instance state (`valid` or `invalid`), the bundle from which the instance is created, and the instance name.
-Then, the information is organized handler by handler (a piece of container). For each handler plugged on the instance can participate to the instance architecture. For each handler its name (such as ` org.apache.felix.ipojo.handlers.dependency.DependencyHandler` for iPOJO service dependencies, ` org.apache.felix.ipojo.handlers.providedservice.ProvidedServiceHandler` for iPOJO service providing...) and the state (either `valid` or `invalid` are displayed. Remember that an instance is valid only and only if all plugged handlers are valid.
-The `org.apache.felix.ipojo.handlers.dependency.DependencyHandler` provides data on service dependencies and more precisely on the state of service dependencies. In the previous example, the dependency on ` spell.services.DictionaryService` was resolved. On the following example, the same dependency is no more resolved:
-
- instance component.type="spell.checker.SpellCheck" state="invalid" bundle="8" name="spell.checker.SpellCheck-0"
- handler state="invalid" name="org.apache.felix.ipojo.handlers.dependency.DependencyHandler"
- requires optional="false" aggregate="false" state="unresolved" binding-policy="dynamic" specification="spell.services.DictionaryService"
- handler state="valid" name="org.apache.felix.ipojo.handlers.providedservice.ProvidedServiceHandler"
- provides state="unregistered" specifications="[spell.services.SpellChecker]"
- property value="spell.checker.SpellCheck" name="factory.name"
- property value="spell.checker.SpellCheck-0" name="instance.name"
- handler state="valid" name="org.apache.felix.ipojo.handlers.architecture.ArchitectureHandler"
-Notes that, the instance also becomes invalid and that the provided service is unregistered.
-If the provider comes back, the dependency becomes `resolved` and the instance becomes `valid`
+<p>Notes that, the instance also becomes invalid and that the provided service is unregistered.
+If the provider comes back, the dependency becomes <code>resolved</code> and the instance becomes <code>valid</code>
If an instance begins to use a service, the bound providers are described in the instance architecture:
<DIV class="code panel" style="border-style: solid;border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><B>Felix or Equinox</B></DIV><DIV class="codeContent panelContent">
- -> arch -instance spell.checker.SpellCheck-0
+ -> arch -instance spell.checker.SpellCheck-0
instance component.type="spell.checker.SpellCheck" state="valid" bundle="8" name="spell.checker.SpellCheck-0"
object name="spell.checker.SpellCheck@e222eb"
handler state="valid" name="org.apache.felix.ipojo.handlers.dependency.DependencyHandler"
@@ -190,9 +320,8 @@ If an instance begins to use a service,
provides service.id="42" state="registered" specifications="[spell.services.SpellChecker]"
property value="spell.checker.SpellCheck" name="factory.name"
property value="spell.checker.SpellCheck-0" name="instance.name"
- handler state="valid" name="org.apache.felix.ipojo.handlers.architecture.ArchitectureHandler"
-
-<DIV class="code panel" style="border-style: solid;border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><B>Gogo</B></DIV><DIV class="codeContent panelContent">
+ handler state="valid" name="org.apache.felix.ipojo.handlers.architecture.ArchitectureHandler"</p>
+<p><DIV class="code panel" style="border-style: solid;border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><B>Gogo</B></DIV><DIV class="codeContent panelContent">
$instance spell.checker.SpellCheck-0
instance component.type="spell.checker.SpellCheck" state="valid" bundle="8" name="spell.checker.SpellCheck-0"
object name="spell.checker.SpellCheck@e222eb"
@@ -203,46 +332,42 @@ If an instance begins to use a service,
provides service.id="42" state="registered" specifications="[spell.services.SpellChecker]"
property value="spell.checker.SpellCheck" name="factory.name"
property value="spell.checker.SpellCheck-0" name="instance.name"
- handler state="valid" name="org.apache.felix.ipojo.handlers.architecture.ArchitectureHandler"
-
-In the previous case, the dependency on ` spell.services.DictionaryService` use the service 41 from the iPOJO instance named ` spell.english.EnglishDictionary-0`
-You can also check created POJO objects (implementation class objet). Here, only one object was created (`spell.checker.SpellCheck@e222eb`).
-
-## List available factories
-To list available factories (i.e. component types), launch the `arch -factories` command (or `factories` on Gogo):
+ handler state="valid" name="org.apache.felix.ipojo.handlers.architecture.ArchitectureHandler"</p>
+<p>In the previous case, the dependency on <code>spell.services.DictionaryService</code> use the service 41 from the iPOJO instance named <code>spell.english.EnglishDictionary-0</code>
+You can also check created POJO objects (implementation class objet). Here, only one object was created (<code>spell.checker.SpellCheck@e222eb</code>).</p>
+<h2 id="list-available-factories">List available factories</h2>
+<p>To list available factories (i.e. component types), launch the <code>arch -factories</code> command (or <code>factories</code> on Gogo):
<DIV class="code panel" style="border-style: solid;border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><B>Felix or Equinox</B></DIV><DIV class="codeContent panelContent">
- -> arch -factories
+ -> arch -factories
Factory spell.checker.SpellCheck (VALID)
Factory spell.gui.SpellCheckerGui (VALID)
- Factory spell.english.EnglishDictionary (VALID)
-
-<DIV class="code panel" style="border-style: solid;border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><B>Gogo</B></DIV><DIV class="codeContent panelContent">
+ Factory spell.english.EnglishDictionary (VALID)</p>
+<p><DIV class="code panel" style="border-style: solid;border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><B>Gogo</B></DIV><DIV class="codeContent panelContent">
$factories
Factory spell.checker.SpellCheck (VALID)
Factory spell.gui.SpellCheckerGui (VALID)
- Factory spell.english.EnglishDictionary (VALID)
+ Factory spell.english.EnglishDictionary (VALID)</p>
+<p>For each available (public) factories,the name and the sate are displayed. A factory is valid if and only if all required handlers are available. To get more information on a factory launch the <code>arch -factory factory*name</code> (or <code>factory factory*name</code> on Gogo) command:</p>
+<div class="codehilite"><pre><span class="n">factory</span> <span class="n">implementation</span><span class="o">-</span><span class="n">class</span><span class="o">=</span><span class="s">"spell.english.EnglishDictionary"</span> <span class="n">state</span><span class="o">=</span><span class="s">"valid"</span> <span class="n">bundle</span><span class="o">=</span><span class="s">"7"</span> <span class="n">name</span><span class="o">=</span><span class="s">"spell.english.EnglishDictionary"</span>
+ <span class="n">provides</span> <span class="n">specification</span><span class="o">=</span><span class="s">"spell.services.DictionaryService"</span>
+ <span class="n">missinghandlers</span> <span class="n">list</span><span class="o">=</span><span class="s">"[]"</span>
+ <span class="n">requiredhandlers</span> <span class="n">list</span><span class="o">=</span><span class="s">"[org.apache.felix.ipojo:provides, org.apache.felix.ipojo:architecture]"</span>
+</pre></div>
-For each available (public) factories,the name and the sate are displayed. A factory is valid if and only if all required handlers are available. To get more information on a factory launch the `arch -factory factory*name` (or `factory factory*name` on Gogo) command:
- factory implementation-class="spell.english.EnglishDictionary" state="valid" bundle="7" name="spell.english.EnglishDictionary"
- provides specification="spell.services.DictionaryService"
- missinghandlers list="[]"
- requiredhandlers list="[org.apache.felix.ipojo:provides, org.apache.felix.ipojo:architecture]"
-
-On the first line, you get the implementation class of the type, the state of the factory, the bundle declaring the type and the name of the type. You also get the list of required and missing handlers.
-## List available handlers
-You can also list available handlers with the `arch -handlers` (or `handlers` on Gogo) command.
+<p>On the first line, you get the implementation class of the type, the state of the factory, the bundle declaring the type and the name of the type. You also get the list of required and missing handlers.</p>
+<h2 id="list-available-handlers">List available handlers</h2>
+<p>You can also list available handlers with the <code>arch -handlers</code> (or <code>handlers</code> on Gogo) command.
<DIV class="code panel" style="border-style: solid;border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><B>Felix or Equinox</B></DIV><DIV class="codeContent panelContent">
- -> arch -handlers
+ -> arch -handlers
Handler org.apache.felix.ipojo:controller (VALID)
Handler org.apache.felix.ipojo:callback (VALID)
Handler org.apache.felix.ipojo:requires (VALID)
Handler org.apache.felix.ipojo:provides (VALID)
Handler org.apache.felix.ipojo:properties (VALID)
Handler org.apache.felix.ipojo:architecture (VALID)
- Handler org.apache.felix.ipojo.handler.whiteboard:wbp (VALID)
-
-<DIV class="code panel" style="border-style: solid;border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><B>Gogo</B></DIV><DIV class="codeContent panelContent">
+ Handler org.apache.felix.ipojo.handler.whiteboard:wbp (VALID)</p>
+<p><DIV class="code panel" style="border-style: solid;border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><B>Gogo</B></DIV><DIV class="codeContent panelContent">
$handlers
Handler org.apache.felix.ipojo:controller (VALID)
Handler org.apache.felix.ipojo:callback (VALID)
@@ -250,13 +375,14 @@ You can also list available handlers wit
Handler org.apache.felix.ipojo:provides (VALID)
Handler org.apache.felix.ipojo:properties (VALID)
Handler org.apache.felix.ipojo:architecture (VALID)
- Handler org.apache.felix.ipojo.handler.whiteboard:wbp (VALID)
-
-Handlers with the `org.apache.felix.ipojo` namespace (section before `:`) are core handlers (provided by the iPOJO core bundles). Others are external handlers (provided by others bundles).
+ Handler org.apache.felix.ipojo.handler.whiteboard:wbp (VALID)</p>
+<p>Handlers with the <code>org.apache.felix.ipojo</code> namespace (section before <code>:</code>) are core handlers (provided by the iPOJO core bundles). Others are external handlers (provided by others bundles).</p>
+ </div>
+
+ <img src="http://felix.apache.org/ipojo/site/footer.png" class="footer">
-{include:apache-felix-ipojo-footer}
<div class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
- Rev. 1422427 by fmeschbe on Sun, 16 Dec 2012 00:36:51 +0000
+ Rev. 1441864 by fmeschbe on Sun, 3 Feb 2013 06:44:40 +0000
</div>
<div class="trademarkFooter">
Apache Felix, Felix, Apache, the Apache feather logo, and the Apache Felix project
@@ -264,5 +390,18 @@ Handlers with the `org.apache.felix.ipoj
may be trademarks or registered trademarks of their respective owners.
</div>
</div>
+ </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 type="text/javascript">
+ try{
+ var pageTracker = _gat._getTracker("UA-1518442-4");
+ pageTracker._trackPageview();
+ } catch(err) {}
+ </script>
+
</body>
</html>
Modified: websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-tools/ipojo-eclipse-plug-in.html
==============================================================================
--- websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-tools/ipojo-eclipse-plug-in.html (original)
+++ websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-tools/ipojo-eclipse-plug-in.html Sun Feb 3 06:45:21 2013
@@ -20,9 +20,45 @@
<head>
<title>Apache Felix - iPOJO Eclipse Plug-in</title>
<link rel="icon" href="/res/favicon.ico">
- <link rel="stylesheet" href="/res/site.css" type="text/css" media="all">
- <link rel="stylesheet" href="/res/codehilite.css" type="text/css" media="all">
+ <link rel="stylesheet" href="/site/media.data/site.css" type="text/css" media="all">
+ <link rel="stylesheet" href="/ipojo/site/superfish.css" type="text/css" media="all">
+ <link rel="stylesheet" href="/ipojo/site/style.css" type="text/css" media="all">
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+
+ <!--
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shCore.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushCSharp.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushPhp.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushJScript.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushVb.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushSql.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushXml.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushShell.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushDelphi.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushPython.js"></script>
+ <script class="javascript" src="http://cwiki.apache.org/confluence/download/resources/confluence.ext.code:code/shBrushJava.js"></script>
+ -->
+
+ <script type="text/javascript" src="/ipojo/site/jquery-1.js"></script>
+ <script type="text/javascript" src="/ipojo/site/hoverIntent.js"></script>
+ <script type="text/javascript" src="/ipojo/site/superfish.js"></script>
+ <script type="text/javascript" src="/ipojo/site/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>
+
</head>
<body>
<div class="title">
@@ -37,189 +73,269 @@
</a>
</div>
</div>
+
+ <div class="main">
+ <div class="main">
+ <div class="page-header">
+ <img src="/ipojo/site/header.png" class="header">
+ <a href="http://ipojo.org"><img src="/ipojo/site/ipojo.png" width="225" class="header-logo"></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></a>
+ <ul>
+ <li>
+ <a href="">Home</a>
+ </li>
+ <li>
+ <a href="">Why choose iPOJO</a>
+ </li>
+ <li>
+ <a href="">Success stories</a>
+ </li>
+ <li>
+ <a href="">Features</a>
+ </li>
+ </ul>
+ </li>
- <div class="menu">
- <p><a href="/news.html">news</a> <br />
-<a href="/license.html">license</a> <br />
-<a href="/downloads.cgi">downloads</a> <br />
-<a href="/documentation.html">documentation</a> <br />
-<a href="/mailinglists.html">mailing lists</a> <br />
-<a href="/documentation/community/contributing.html">contributing</a> <br />
-<a href="/sitemap.html">site map</a> <br />
-<a href="http://www.apache.org/">asf</a> <br />
-<a href="http://www.apache.org/security/">security</a> <br />
-<a href="http://www.apache.org/foundation/sponsorship.html">sponsorship</a> <br />
-<a href="http://www.apache.org/foundation/thanks.html">sponsors</a> <br />
-</p>
-<iframe
- src="http://www.apache.org/ads/button.html"
- style="border-width:0; float: left"
- frameborder="0"
- scrolling="no"
- width="135"
- height="135">
-</iframe>
- </div>
+ <li class="">
+ <!-- Menu download -->
+ <li>
+ <a href="/downloads.cgi">Download </a>
+ </li>
- <div class="main">
- <div class="breadcrump" style="font-size: 80%;">
- <a href="/">Home</a> » <a href="/documentation.html">Documentation</a> » <a href="/documentation/subprojects.html">Apache Felix Subproject Documentation</a> » <a href="/documentation/subprojects/apache-felix-ipojo.html">Apache Felix iPOJO</a> » <a href="/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-tools.html">apache-felix-ipojo-tools</a>
- </div>
-
+ <li class="">
+ <!-- Menu Documentation -->
+ <a href="#" class="sf-with-ul">Documentation<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+ <ul>
+ <!-- sub-menu : getting started -->
+ <li class="">
+ <a href="#" class="sf-with-ul">Getting Started<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+ <ul>
+ <li><a href="">iPOJO in 10 minutes</a></li>
+ <li><a href="">Using Annotations</a></li>
+ <li><a href="">Maven tutorial</a></li>
+ <li><a href="">Advanced tutorial</a></li>
+ <li><a href="">Using Distributed OSGi</a></li>
+ <li><a href="">Application Composition</a></li>
+ </ul>
+ </li> <!-- end of getting started -->
+ <!-- sub menu : Describing Components -->
+ <li class="">
+ <a href="" class="sf-with-ul">Describing components<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+ <ul>
+ <li><a href="">Requiring a service</a></li>
+ <li><a href="">Providing a service</a></li>
+ <li><a href="">Lifecycle management</a></li>
+ <li><a href="">Configuration</a></li>
+ <li><a href="">Introspection</a></li>
+ <li><a href="">Impacting the lifecycle</a></li>
+ <li><a href="">Asynchronous communication</a></li>
+ <li><a href="">JMX management</a></li>
+ <li><a href="">Extender pattern</a></li>
+ <li><a href="">Whiteboard pattern</a></li>
+ <li><a href="">Temporal dependencies</a></li>
+ </ul>
+ </li> <!-- End of describing components -->
+ <!-- sub-menu : User Guide -->
+ <li class="">
+ <a href="" class="sf-with-ul">User Guide<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+ <ul>
+ <li><a href="">iPOJO and config admin</a></li>
+ <li><a href="">Factories and Instances</a></li>
+ <li><a href="">XML Schemas</a></li>
+ <li><a href="">API</a></li>
+ <li><a href="">Testing components</a></li>
+ <li><a href="">Eclipse Integration</a></li>
+ <li><a href="">FAQ</a></li>
+ <li><a href="">Reference Card</a></li>
+ </ul>
+ </li> <!-- end of user guide -->
+ <!-- sub-menu : Dev Guide -->
+ <li>
+ <a href="#" class="sf-with-ul">Advanced Topics<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+ <ul>
+ <li><a href="http://felix.apache.org/ipojo/api/1.6.0">Javadoc</a></li>
+ <li><a href="">Handler development</a></li>
+ <li><a href="">Manipulation Metadata </a></li>
+ <li><a href="">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></a>
+ <ul>
+ <li><a href="">Ant Task</a></li>
+ <li><a href="">Eclipse Plugin</a></li>
+ <li><a href="">Maven Plugin</a></li>
+ <li><a href="">`arch` shell command</a></li>
+ <li><a href="">Online Manipulator</a></li>
+ <li><a href="">Webconsole plugin</a></li>
+ <li><a href="">Junit4OSGi</a></li>
+ </ul>
+ </li><!-- End of tools -->
+ <!-- Menu 5 : Support -->
+ <li>
+ <a href="">Support </a>
+ </li>
+ <!-- End of the menu 5 -->
+ <!-- Menu 6 : Misc -->
+ <li class="">
+ <a href="#" class="sf-with-ul">Misc<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>
+ <ul>
+ <li><a href="">Supported JVMs</a></li>
+ <li><a href="">Supported OSGi Implementations</a></li>
+ <li><a href="http://ipojo-dark-side.blogspot.com">iPOJO's Dark Side Blog</a></li>
+ <li><a href="">Article & Presentations</a></li>
+ <li><a href="http://www.apache.org/">ASF</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Sponsors</a></li>
+ </ul>
+ </li><!-- End of misc -->
+ </ul> <!-- End of the menu -->
+ </div> <!-- Page header -->
+
+ <!--
<div class="tip">
This page is a translated version of <a href="/site/ipojo-eclipse-plug-in.html" target="felix_cwiki">/site/ipojo-eclipse-plug-in.html</a>. In case of
doubt you might want to refer to the old page.
</div>
+ -->
<h1>iPOJO Eclipse Plug-in</h1>
- <p>{include:apache-felix-ipojo-header}</p>
-<div class="content">
-
-# iPOJO Eclipse Plug-in
-
+
+ <div class="content">
+ <h1 id="ipojo-eclipse-plug-in">iPOJO Eclipse Plug-in</h1>
<div class="info" markdown="1">
**Update**
The iPOJO Eclipse plugin is now hosted and supported in the [iPOJO Toolbox project](http://ipojo-toolbox.wiki.sourceforge.net/iPOJO-Eclipse-plugin).
</div>
-----
-
-*iPOJO is based on a byte code manipulation. So, it requires a different packaging process as "normal" bundle. This plug-in allow to build an "iPOJO bundle" directly from Eclipse. Moreover, by collaborating with BND (see [http://www.aqute.biz/Code/Bnd](http://www.aqute.biz/Code/Bnd)), it simplifies the creation of bundles.*
-
-{div:class=toc}
+<hr />
+<p><em>iPOJO is based on a byte code manipulation. So, it requires a different packaging process as "normal" bundle. This plug-in allow to build an "iPOJO bundle" directly from Eclipse. Moreover, by collaborating with BND (see <a href="http://www.aqute.biz/Code/Bnd">http://www.aqute.biz/Code/Bnd</a>), it simplifies the creation of bundles.</em></p>
+<p>{div:class=toc}
[TOC]
-{div}
-
-## Installation
-
-The plug-in requires Eclipse 3.3 (Europa) or higher. The plug-in can be installed from the following update site : [http://clement.plop-plop.net/update/](http://clement.plop-plop.net/update/)
-
-## Usage
-
-Once installed, create a Java project to use the plug-in.
-
-!1-java-project.png!
-
-The new java project wizard appears. Enter the project name without spaces. Configure the Java project as you want.
-
-!2-new-java-project.png!
-
-Then, right click on the new project, go inside the iPOJO sub-menu and click on "create both files". This action will create two file in your java project. The $project_name.bnd file configure BND and contains the declaration of imported, private and exported packages. The second file (metadata.xml) contains the iPOJO bundle configuration.
-
-!3-create-files.png!
-
-As you create the two file, you should obtain something like :
-
-!4-project-view.png!
-
-Imagine that you implement a simple component displaying each message pushed inside the OSGi⢠Log Service. The following code snippet shows one possible implementation of this component :
-
- package org.apache.felix.ipojo.example.logcons;
-
- import java.text.DateFormat;
- import java.util.Date;
-
- import org.osgi.service.log.LogEntry;
- import org.osgi.service.log.LogListener;
- import org.osgi.service.log.LogReaderService;
- import org.osgi.service.log.LogService;
-
- public class LogCons implements LogListener{
-
- private LogReaderService reader;
-
- public void start() {
- reader.addLogListener(this);
- }
-
- public void stop() {
- reader.removeLogListener(this);
- }
-
- public void logged(LogEntry entry) {
- Date date = new Date(entry.getTime());
- String message = "";
- switch(entry.getLevel()) {
- case LogService.LOG_DEBUG: message = "[DEBUG] " +
- DateFormat.getInstance().format(date) + " - " +
- entry.getMessage(); break;
- case LogService.LOG_ERROR: message = "[ERROR] " +
- DateFormat.getInstance().format(date) + " - " +
- entry.getMessage(); break;
- case LogService.LOG_INFO: message = "[INFO] " +
- DateFormat.getInstance().format(date) + " - " +
- entry.getMessage(); break;
- case LogService.LOG_WARNING: message = "[WARNING] " +
- DateFormat.getInstance().format(date) + " - " +
- entry.getMessage(); break;
- default: message = "[UNKNOWN] " +
- DateFormat.getInstance().format(date) + " - " + entry.getMessage();
- break;
- }
- System.out.println(message);
- }
- }
-
-Once implemented, you need to fill out the BND file with following information:
-
- Import-Package: *
- Private-Package: org.apache.felix.ipojo.example.logcons
-
-Then, the metadata.xml file needs to be filled out. We declare the LogCons component type with a simple service requirement on the LogReaderService and two lifecycle callbacks. To finish, we declare an instance of this component type.
-
- <ipojo>
- <!-- Declare the component type for LogCons -->
- <component classname="org.apache.felix.ipojo.example.logcons.LogCons"
- name="LogCons">
- <requires field="reader"/>
- <callback transition="validate" method="start"/>
- <callback transition="invalidate" method="stop"/>
- </component>
-
- <!-- Create a LogCons instance -->
- <instance component="LogCons"/>
- </ipojo>
-
-Once all is complete, we can build the bundle by doing a right-click on the metadata.xml file. Then go to the iPOJO sub-menu and click on Create Bundle.
-
-!5-create-the-bundle.png!
-
-If all is correctly configured, the following message appears, else warnings or errors are displayed in a message box too.
-
-!6-manipulation-done.png!
-
-Your project contains now the build bundle. The bundle has the same name as your project.
-
-!7-final-project.png!
-
-## Plug-in options
-
-### On Java project
-
-!8-project-options.png!
-* Create both files : create both the BND file and the metadata.xml file (replace existing one)
-
-* Create metadata.xml file : create only the metadata.xml file
-
-* Create BND file : create only the BND file
-
-### On metadata.xml file
-
-!9-metadata-options.png!
-* Manipulate bundle: take an already created bundle and manipulate it. This option is use when you don't use BND to create a bundle
-
-* Create bundle: create a bundle "from scratch", first create a bundle with BND and then manipulate it.
-
-## Conclusion
-
-This page has presented the iPOJO Eclipe plug-in.
-Subscribe to the Felix users mailing list by sending a message to [mailto:users-subscribe@felix.apache.org](); after subscribing, email questions or feedback to [mailto:users@felix.apache.org]
+{div}</p>
+<h2 id="installation">Installation</h2>
+<p>The plug-in requires Eclipse 3.3 (Europa) or higher. The plug-in can be installed from the following update site : <a href="http://clement.plop-plop.net/update/">http://clement.plop-plop.net/update/</a></p>
+<h2 id="usage">Usage</h2>
+<p>Once installed, create a Java project to use the plug-in.</p>
+<p>!1-java-project.png!</p>
+<p>The new java project wizard appears. Enter the project name without spaces. Configure the Java project as you want.</p>
+<p>!2-new-java-project.png!</p>
+<p>Then, right click on the new project, go inside the iPOJO sub-menu and click on "create both files". This action will create two file in your java project. The $project_name.bnd file configure BND and contains the declaration of imported, private and exported packages. The second file (metadata.xml) contains the iPOJO bundle configuration.</p>
+<p>!3-create-files.png!</p>
+<p>As you create the two file, you should obtain something like :</p>
+<p>!4-project-view.png!</p>
+<p>Imagine that you implement a simple component displaying each message pushed inside the OSGi⢠Log Service. The following code snippet shows one possible implementation of this component :</p>
+<div class="codehilite"><pre><span class="nb">package</span> <span class="n">org</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">felix</span><span class="o">.</span><span class="n">ipojo</span><span class="o">.</span><span class="n">example</span><span class="o">.</span><span class="n">logcons</span><span class="p">;</span>
+
+<span class="nb">import</span> <span class="n">java</span><span class="o">.</span><span class="n">text</span><span class="o">.</span><span class="n">DateFormat</span><span class="p">;</span>
+<span class="nb">import</span> <span class="n">java</span><span class="o">.</span><span class="n">util</span><span class="o">.</span><span class="n">Date</span><span class="p">;</span>
+
+<span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">osgi</span><span class="o">.</span><span class="n">service</span><span class="o">.</span><span class="nb">log</span><span class="o">.</span><span class="n">LogEntry</span><span class="p">;</span>
+<span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">osgi</span><span class="o">.</span><span class="n">service</span><span class="o">.</span><span class="nb">log</span><span class="o">.</span><span class="n">LogListener</span><span class="p">;</span>
+<span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">osgi</span><span class="o">.</span><span class="n">service</span><span class="o">.</span><span class="nb">log</span><span class="o">.</span><span class="n">LogReaderService</span><span class="p">;</span>
+<span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">osgi</span><span class="o">.</span><span class="n">service</span><span class="o">.</span><span class="nb">log</span><span class="o">.</span><span class="n">LogService</span><span class="p">;</span>
+
+<span class="n">public</span> <span class="n">class</span> <span class="n">LogCons</span> <span class="n">implements</span> <span class="n">LogListener</span><span class="p">{</span>
+
+ <span class="n">private</span> <span class="n">LogReaderService</span> <span class="n">reader</span><span class="p">;</span>
+
+ <span class="n">public</span> <span class="n">void</span> <span class="n">start</span><span class="p">()</span> <span class="p">{</span>
+ <span class="n">reader</span><span class="o">.</span><span class="n">addLogListener</span><span class="p">(</span><span class="n">this</span><span class="p">);</span>
+ <span class="p">}</span>
+
+ <span class="n">public</span> <span class="n">void</span> <span class="n">stop</span><span class="p">()</span> <span class="p">{</span>
+ <span class="n">reader</span><span class="o">.</span><span class="n">removeLogListener</span><span class="p">(</span><span class="n">this</span><span class="p">);</span>
+ <span class="p">}</span>
+
+ <span class="n">public</span> <span class="n">void</span> <span class="n">logged</span><span class="p">(</span><span class="n">LogEntry</span> <span class="n">entry</span><span class="p">)</span> <span class="p">{</span>
+ <span class="n">Date</span> <span class="n">date</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Date</span><span class="p">(</span><span class="n">entry</span><span class="o">.</span><span class="n">getTime</span><span class="p">());</span>
+ <span class="n">String</span> <span class="n">message</span> <span class="o">=</span> <span class="s">""</span><span class="p">;</span>
+ <span class="n">switch</span><span class="p">(</span><span class="n">entry</span><span class="o">.</span><span class="n">getLevel</span><span class="p">())</span> <span class="p">{</span>
+ <span class="k">case</span> <span class="n">LogService</span><span class="o">.</span><span class="n">LOG_DEBUG:</span> <span class="n">message</span> <span class="o">=</span> <span class="s">"[DEBUG] "</span> <span class="o">+</span>
+ <span class="n">DateFormat</span><span class="o">.</span><span class="n">getInstance</span><span class="p">()</span><span class="o">.</span><span class="nb">format</span><span class="p">(</span><span class="n">date</span><span class="p">)</span> <span class="o">+</span> <span class="s">" - "</span> <span class="o">+</span>
+ <span class="n">entry</span><span class="o">.</span><span class="n">getMessage</span><span class="p">();</span> <span class="n">break</span><span class="p">;</span>
+ <span class="k">case</span> <span class="n">LogService</span><span class="o">.</span><span class="n">LOG_ERROR:</span> <span class="n">message</span> <span class="o">=</span> <span class="s">"[ERROR] "</span> <span class="o">+</span>
+ <span class="n">DateFormat</span><span class="o">.</span><span class="n">getInstance</span><span class="p">()</span><span class="o">.</span><span class="nb">format</span><span class="p">(</span><span class="n">date</span><span class="p">)</span> <span class="o">+</span> <span class="s">" - "</span> <span class="o">+</span>
+ <span class="n">entry</span><span class="o">.</span><span class="n">getMessage</span><span class="p">();</span> <span class="n">break</span><span class="p">;</span>
+ <span class="k">case</span> <span class="n">LogService</span><span class="o">.</span><span class="n">LOG_INFO:</span> <span class="n">message</span> <span class="o">=</span> <span class="s">"[INFO] "</span> <span class="o">+</span>
+ <span class="n">DateFormat</span><span class="o">.</span><span class="n">getInstance</span><span class="p">()</span><span class="o">.</span><span class="nb">format</span><span class="p">(</span><span class="n">date</span><span class="p">)</span> <span class="o">+</span> <span class="s">" - "</span> <span class="o">+</span>
+ <span class="n">entry</span><span class="o">.</span><span class="n">getMessage</span><span class="p">();</span> <span class="n">break</span><span class="p">;</span>
+ <span class="k">case</span> <span class="n">LogService</span><span class="o">.</span><span class="n">LOG_WARNING:</span> <span class="n">message</span> <span class="o">=</span> <span class="s">"[WARNING] "</span> <span class="o">+</span>
+ <span class="n">DateFormat</span><span class="o">.</span><span class="n">getInstance</span><span class="p">()</span><span class="o">.</span><span class="nb">format</span><span class="p">(</span><span class="n">date</span><span class="p">)</span> <span class="o">+</span> <span class="s">" - "</span> <span class="o">+</span>
+ <span class="n">entry</span><span class="o">.</span><span class="n">getMessage</span><span class="p">();</span> <span class="n">break</span><span class="p">;</span>
+ <span class="n">default:</span> <span class="n">message</span> <span class="o">=</span> <span class="s">"[UNKNOWN] "</span> <span class="o">+</span>
+ <span class="n">DateFormat</span><span class="o">.</span><span class="n">getInstance</span><span class="p">()</span><span class="o">.</span><span class="nb">format</span><span class="p">(</span><span class="n">date</span><span class="p">)</span> <span class="o">+</span> <span class="s">" - "</span> <span class="o">+</span> <span class="n">entry</span><span class="o">.</span><span class="n">getMessage</span><span class="p">();</span>
+ <span class="n">break</span><span class="p">;</span>
+ <span class="p">}</span>
+ <span class="n">System</span><span class="o">.</span><span class="n">out</span><span class="o">.</span><span class="n">println</span><span class="p">(</span><span class="n">message</span><span class="p">);</span>
+ <span class="p">}</span>
+<span class="p">}</span>
+</pre></div>
+
+
+<p>Once implemented, you need to fill out the BND file with following information:</p>
+<div class="codehilite"><pre><span class="n">Import</span><span class="o">-</span><span class="n">Package:</span> <span class="o">*</span>
+<span class="n">Private</span><span class="o">-</span><span class="n">Package:</span> <span class="n">org</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">felix</span><span class="o">.</span><span class="n">ipojo</span><span class="o">.</span><span class="n">example</span><span class="o">.</span><span class="n">logcons</span>
+</pre></div>
+
+
+<p>Then, the metadata.xml file needs to be filled out. We declare the LogCons component type with a simple service requirement on the LogReaderService and two lifecycle callbacks. To finish, we declare an instance of this component type.</p>
+<div class="codehilite"><pre><span class="nt"><ipojo></span>
+<span class="c"><!-- Declare the component type for LogCons --></span>
+<span class="nt"><component</span> <span class="na">classname=</span><span class="s">"org.apache.felix.ipojo.example.logcons.LogCons"</span>
+ <span class="na">name=</span><span class="s">"LogCons"</span><span class="nt">></span>
+ <span class="nt"><requires</span> <span class="na">field=</span><span class="s">"reader"</span><span class="nt">/></span>
+ <span class="nt"><callback</span> <span class="na">transition=</span><span class="s">"validate"</span> <span class="na">method=</span><span class="s">"start"</span><span class="nt">/></span>
+ <span class="nt"><callback</span> <span class="na">transition=</span><span class="s">"invalidate"</span> <span class="na">method=</span><span class="s">"stop"</span><span class="nt">/></span>
+<span class="nt"></component></span>
+
+<span class="c"><!-- Create a LogCons instance --></span>
+<span class="nt"><instance</span> <span class="na">component=</span><span class="s">"LogCons"</span><span class="nt">/></span>
+<span class="nt"></ipojo></span>
+</pre></div>
+
+
+<p>Once all is complete, we can build the bundle by doing a right-click on the metadata.xml file. Then go to the iPOJO sub-menu and click on Create Bundle.</p>
+<p>!5-create-the-bundle.png!</p>
+<p>If all is correctly configured, the following message appears, else warnings or errors are displayed in a message box too.</p>
+<p>!6-manipulation-done.png!</p>
+<p>Your project contains now the build bundle. The bundle has the same name as your project.</p>
+<p>!7-final-project.png!</p>
+<h2 id="plug-in-options">Plug-in options</h2>
+<h3 id="on-java-project">On Java project</h3>
+<p>!8-project-options.png!
+* Create both files : create both the BND file and the metadata.xml file (replace existing one)</p>
+<ul>
+<li>
+<p>Create metadata.xml file : create only the metadata.xml file</p>
+</li>
+<li>
+<p>Create BND file : create only the BND file</p>
+</li>
+</ul>
+<h3 id="on-metadataxml-file">On metadata.xml file</h3>
+<p>!9-metadata-options.png!
+* Manipulate bundle: take an already created bundle and manipulate it. This option is use when you don't use BND to create a bundle</p>
+<ul>
+<li>Create bundle: create a bundle "from scratch", first create a bundle with BND and then manipulate it.</li>
+</ul>
+<h2 id="conclusion">Conclusion</h2>
+<p>This page has presented the iPOJO Eclipe plug-in.
+Subscribe to the Felix users mailing list by sending a message to <a href="">mailto:users-subscribe@felix.apache.org</a>; after subscribing, email questions or feedback to [mailto:users@felix.apache.org]</p>
+ </div>
+
+ <img src="http://felix.apache.org/ipojo/site/footer.png" class="footer">
-{include:apache-felix-ipojo-footer}
<div class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
- Rev. 1422427 by fmeschbe on Sun, 16 Dec 2012 00:36:51 +0000
+ Rev. 1441864 by fmeschbe on Sun, 3 Feb 2013 06:44:40 +0000
</div>
<div class="trademarkFooter">
Apache Felix, Felix, Apache, the Apache feather logo, and the Apache Felix project
@@ -227,5 +343,18 @@ Subscribe to the Felix users mailing lis
may be trademarks or registered trademarks of their respective owners.
</div>
</div>
+ </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 type="text/javascript">
+ try{
+ var pageTracker = _gat._getTracker("UA-1518442-4");
+ pageTracker._trackPageview();
+ } catch(err) {}
+ </script>
+
</body>
</html>