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 [7/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/apach...
Modified: websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-gettingstarted/ipojo-hello-word-maven-based-tutorial.html
==============================================================================
--- websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-gettingstarted/ipojo-hello-word-maven-based-tutorial.html (original)
+++ websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-gettingstarted/ipojo-hello-word-maven-based-tutorial.html Sun Feb 3 06:45:21 2013
@@ -20,9 +20,45 @@
<head>
<title>Apache Felix - iPOJO Hello Word (Maven-Based) tutorial</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,190 +73,272 @@
</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-gettingstarted.html">apache-felix-ipojo-gettingstarted</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-hello-word-maven-based-tutorial.html" target="felix_cwiki">/site/ipojo-hello-word-maven-based-tutorial.html</a>. In case of
doubt you might want to refer to the old page.
</div>
+ -->
<h1>iPOJO Hello Word (Maven-Based) tutorial</h1>
- <p>{include:apache-felix-ipojo-header}</p>
-<div class="content">
-
-# iPOJO Hello World
-
-*This page presents how to use the iPOJO runtime and its associated service component model. The concepts of the service component model are introduced, followed by a simple example that demonstrates the features of iPOJO.*
-
-## Introduction
-
-iPOJO aims to simplify service-oriented programming on OSGi frameworks; the name iPOJO is an abbreviation for *injected POJO*. iPOJO provides a new way to develop OSGi service components with the main goal being to simplify service component implementation by transparently managing the dynamics of the environment as well as other non-functional requirements. The iPOJO framework allows developers to more clearly separate functional code (i.e., the POJO) from the non-functional code (i.e., dependency management, service provision, configuration, etc.). iPOJO combines the functional and non-functional aspects at run time. To achieve this, iPOJO provides a simple and extensible service component model based on POJOs.
-
-## The POJO concept
-
-POJO is an acronym for Plain Old Java Object, but it embodies a concept that the simpler and less intrusive the design of a given framework, the better. The name is used to emphasize that a given object is not somehow special, but is an ordinary Java Object. Martin Fowler, Rebecca Parsons and Josh Mackenzie coined the term POJO in September 2000: "We wondered why people were so against using regular objects in their systems and concluded that it was because simple objects lacked a fancy name. So we gave them one, and it's caught on very nicely." From the developer's perspective, the iPOJO framework strives to only require POJOs in as much as it is possible.
-
-## iPOJO service component overview
-
-A service component is able to provide and/or require services, where a service is an object that implements a given service interface embodied as a Java interface. In addition, iPOJO introduces a callback concept to notify a component about various state changes.
-
-The component is the central concept in iPOJO. In the core iPOJO model, a component describes service dependencies, provided services, and callbacks; this information is recorded in the component's metadata. Then, the second important concept in iPOJO is component instances. A component instances is a special *version* of the component. By merging component metadata and instance configuration, the iPOJO runtime is able to manage the component, i.e., manage its life cycle, inject required services, publish provided services, discover needed services.
-
-## A simple example
+
+ <div class="content">
+ <h1 id="ipojo-hello-world">iPOJO Hello World</h1>
+<p><em>This page presents how to use the iPOJO runtime and its associated service component model. The concepts of the service component model are introduced, followed by a simple example that demonstrates the features of iPOJO.</em></p>
+<h2 id="introduction">Introduction</h2>
+<p>iPOJO aims to simplify service-oriented programming on OSGi frameworks; the name iPOJO is an abbreviation for <em>injected POJO</em>. iPOJO provides a new way to develop OSGi service components with the main goal being to simplify service component implementation by transparently managing the dynamics of the environment as well as other non-functional requirements. The iPOJO framework allows developers to more clearly separate functional code (i.e., the POJO) from the non-functional code (i.e., dependency management, service provision, configuration, etc.). iPOJO combines the functional and non-functional aspects at run time. To achieve this, iPOJO provides a simple and extensible service component model based on POJOs.</p>
+<h2 id="the-pojo-concept">The POJO concept</h2>
+<p>POJO is an acronym for Plain Old Java Object, but it embodies a concept that the simpler and less intrusive the design of a given framework, the better. The name is used to emphasize that a given object is not somehow special, but is an ordinary Java Object. Martin Fowler, Rebecca Parsons and Josh Mackenzie coined the term POJO in September 2000: "We wondered why people were so against using regular objects in their systems and concluded that it was because simple objects lacked a fancy name. So we gave them one, and it's caught on very nicely." From the developer's perspective, the iPOJO framework strives to only require POJOs in as much as it is possible.</p>
+<h2 id="ipojo-service-component-overview">iPOJO service component overview</h2>
+<p>A service component is able to provide and/or require services, where a service is an object that implements a given service interface embodied as a Java interface. In addition, iPOJO introduces a callback concept to notify a component about various state changes.</p>
+<p>The component is the central concept in iPOJO. In the core iPOJO model, a component describes service dependencies, provided services, and callbacks; this information is recorded in the component's metadata. Then, the second important concept in iPOJO is component instances. A component instances is a special <em>version</em> of the component. By merging component metadata and instance configuration, the iPOJO runtime is able to manage the component, i.e., manage its life cycle, inject required services, publish provided services, discover needed services.</p>
+<h2 id="a-simple-example">A simple example</h2>
+<p>The following is a simple example illustrating how to use the core iPOJO concepts. The example is comprised of two components, one providing a <em>Hello</em> service and one requiring any number of <em>Hello</em> services. The components are packaged into three different bundles using Maven. The <em>hello.service</em> bundle contains the service interface. The <em>hello.impl</em> bundle contains a component implementing the service. The <em>hello.client</em> bundle contains the consumer component.</p>
+<p>Download the tutorial archive <a href="http://people.apache.org/~clement/ipojo/tutorials/maven/tutorial.zip">here</a>. This archive contains a version of Felix (configured with iPOJO), and the projects explained below.</p>
+<h3 id="preparing-maven-installing-the-tutorial">Preparing Maven & Installing the tutorial</h3>
+<p>The first step is to download and install Maven; the example was created using Maven 2.1+. Once maven is installed on your machine, you can compile the tutorial by unzipping the archive, and by launching the '<em>mvn clean install</em>' command at the root of tutorial.</p>
+<p><em>Be aware that Maven outputs a lot of information while it executes and often downloads a lot of required JAR files into its local repository.</em></p>
+<h3 id="hello-service">Hello Service</h3>
+<p>The first project is the <em>hello.service</em> project. This project contains only the <em>hello</em> service interface. Look at the <code>src/main/java/ipojo/example/hello/Hello.java</code> file.
+{code:java}
+/*<em>
+ * Hello Interface.
+ * @author <a href="mailto:dev@felix.apache.org">Felix Project Team</a>
+ </em>/
+public interface Hello {</p>
+<div class="codehilite"><pre><span class="o">/**</span>
+ <span class="o">*</span> <span class="n">Returns</span> <span class="n">a</span> <span class="n">message</span> <span class="n">like:</span> <span class="s">"Hello $user_name"</span><span class="o">.</span>
+ <span class="o">*</span> <span class="nv">@param</span> <span class="n">name</span> <span class="n">the</span> <span class="n">name</span>
+ <span class="o">*</span> <span class="nv">@return</span> <span class="n">the</span> <span class="n">hello</span> <span class="n">message</span>
+ <span class="o">*/</span>
+<span class="n">String</span> <span class="n">sayHello</span><span class="p">(</span><span class="n">String</span> <span class="n">name</span><span class="p">);</span>
+</pre></div>
-The following is a simple example illustrating how to use the core iPOJO concepts. The example is comprised of two components, one providing a *Hello* service and one requiring any number of *Hello* services. The components are packaged into three different bundles using Maven. The *hello.service* bundle contains the service interface. The *hello.impl* bundle contains a component implementing the service. The *hello.client* bundle contains the consumer component.
-Download the tutorial archive [here](http://people.apache.org/~clement/ipojo/tutorials/maven/tutorial.zip). This archive contains a version of Felix (configured with iPOJO), and the projects explained below.
+<p>}</p>
+<div class="codehilite"><pre>In the project directory, the pom.xml file contains the instructions to build the bundle. The bundle uses the _maven-bundle-plugin_ (see here for more information on this plug-in).
+{div:class=pom}
+<span class="nt"><project></span>
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"><modelVersion></span>4.0.0<span class="nt"></modelVersion></span>
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"><packaging></span>bundle<span class="nt"></packaging></span>
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> {color:#ff0000}<span class="nt"><groupId></span>ipojo.example<span class="nt"></groupId></span>{color}
+{color:#ff0000}<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"><artifactId></span>hello.service<span class="nt"></artifactId></span>{color}
+{color:#ff0000}<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"><version></span>1.0.0<span class="nt"></version></span>{color}
+{color:#ff0000}<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"><name></span>Hello Service<span class="nt"></name></span>{color}
+
+<span class="nt"><build></span>
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"><plugins></span>
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"><plugin></span>
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"><groupId></span>org.apache.felix<span class="nt"></groupId></span>
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"><artifactId></span>maven-bundle-plugin<span class="nt"></artifactId></span>
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"><version></span>2.0.1<span class="nt"></version></span>
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"><extensions></span>true<span class="nt"></extensions></span>
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"><configuration></span>
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"><instructions></span>
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"><Bundle-SymbolicName></span>
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> $\{pom.artifactId}
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"></Bundle-SymbolicName></span>
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> {color:#ff0000}<span class="nt"><Export-Package></span>{color}
+{color:#ff0000}<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;</span> <span class="ni">&nbsp;</span> <span class="ni">&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> ipojo.example.hello{color}
+{color:#ff0000}<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"></Export-Package></span>{color}
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"></instructions></span>
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"></configuration></span>
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"></plugin></span>
+<span class="ni">&nbsp;&nbsp;&nbsp;</span> <span class="nt"></plugins></span>
+<span class="nt"></build></span>
-### Preparing Maven & Installing the tutorial
+<span class="nt"></project></span>
+{div}
+Then, the project is ready to be built issuing the following Maven command inside the project directory:
+</pre></div>
-The first step is to download and install Maven; the example was created using Maven 2.1+. Once maven is installed on your machine, you can compile the tutorial by unzipping the archive, and by launching the '*mvn clean install*' command at the root of tutorial.
-*Be aware that Maven outputs a lot of information while it executes and often downloads a lot of required JAR files into its local repository.*
+<p>mvn clean install</p>
+<div class="codehilite"><pre>Maven should report that the build was a success; if an error was reported then verify the previous steps. Upon success the _Hello_ service component JAR file is installed into the local Maven repository. A copy of the bundle JAR file will also be present in the "target" directory inside the project directory.
-### Hello Service
+h3. Hello Service Provider
-The first project is the *hello.service* project. This project contains only the *hello* service interface. Look at the `src/main/java/ipojo/example/hello/Hello.java` file.
+The component implementation of the service is a simple Java class implementing the _Hello_ service interface. The implementation is in the _hello.impl_ project. The file contains the following service implementation:
{code:java}
/**
- * Hello Interface.
- * @author <a href="mailto:dev@felix.apache.org">Felix Project Team</a>
+ * Component implementing the Hello service.
+ * @author <span class="nt"><a</span> <span class="na">href=</span><span class="s">"mailto:dev@felix.apache.org"</span><span class="nt">></span>Felix Project Team<span class="nt"></a></span>
*/
-public interface Hello {
+public class HelloImpl implements Hello {
/**
- * Returns a message like: "Hello $user_name".
- * @param name the name
- * @return the hello message
+ * Returns an 'Hello' message.
+ * @param name : name
+ * @return Hello message
+ * @see ipojo.example.hello.Hello#sayHello(java.lang.String)
*/
- String sayHello(String name);
+ public String sayHello(String name) { return "hello " + name; }
}
+</pre></div>
- In the project directory, the pom.xml file contains the instructions to build the bundle. The bundle uses the _maven-bundle-plugin_ (see here for more information on this plug-in).
- {div:class=pom}
- <project>
- <modelVersion>4.0.0</modelVersion>
- <packaging>bundle</packaging>
- {color:#ff0000}<groupId>ipojo.example</groupId>{color}
- {color:#ff0000} <artifactId>hello.service</artifactId>{color}
- {color:#ff0000} <version>1.0.0</version>{color}
- {color:#ff0000} <name>Hello Service</name>{color}
-
- <build>
- <plugins>
- <plugin>
- <groupId>org.apache.felix</groupId>
- <artifactId>maven-bundle-plugin</artifactId>
- <version>2.0.1</version>
- <extensions>true</extensions>
- <configuration>
- <instructions>
- <Bundle-SymbolicName>
- $\{pom.artifactId}
- </Bundle-SymbolicName>
- {color:#ff0000}<Export-Package>{color}
- {color:#ff0000} ipojo.example.hello{color}
- {color:#ff0000} </Export-Package>{color}
- </instructions>
- </configuration>
- </plugin>
- </plugins>
- </build>
-
- </project>
- {div}
- Then, the project is ready to be built issuing the following Maven command inside the project directory:
-
-mvn clean install
- Maven should report that the build was a success; if an error was reported then verify the previous steps. Upon success the _Hello_ service component JAR file is installed into the local Maven repository. A copy of the bundle JAR file will also be present in the "target" directory inside the project directory.
+<p>To manage the component, iPOJO needs some metadata to understand that the component provides the <em>Hello</em> service. iPOJO metadata file is at the root of the <em>hello.impl</em> project ("metadata.xml"). It contains the following metadata (Note: iPOJO also supports a JAR manifest-based syntax):</p>
+<div class="codehilite"><pre><span class="cp"><?xml version="1.0" encoding="UTF-8"?></span>
+<span class="nt"><ipojo</span>
+ <span class="na">xmlns:xsi=</span><span class="s">"http://www.w3.org/2001/XMLSchema-instance"</span>
+ <span class="na">xsi:schemaLocation=</span><span class="s">"org.apache.felix.ipojo http://felix.apache.org/ipojo/schemas/CURRENT/core.xsd"</span>
+ <span class="na">xmlns=</span><span class="s">"org.apache.felix.ipojo"</span><span class="nt">></span>
- h3. Hello Service Provider
+ <span class="nt"><component</span> <span class="na">classname=</span><span class="s">"ipojo.example.hello.impl.HelloImpl"</span>
+ <span class="na">name=</span><span class="s">"HelloProvider"</span><span class="nt">></span>
+ <span class="nt"><provides</span> <span class="nt">/></span>
+ <span class="nt"></component></span>
- The component implementation of the service is a simple Java class implementing the _Hello_ service interface. The implementation is in the _hello.impl_ project. The file contains the following service implementation:
- {code:java}
- /**
- * Component implementing the Hello service.
- * @author <a href="mailto:dev@felix.apache.org">Felix Project Team</a>
- */
- public class HelloImpl implements Hello {
+ <span class="nt"><instance</span> <span class="na">component=</span><span class="s">"HelloProvider"</span> <span class="na">name=</span><span class="s">"HelloService"</span> <span class="nt">/></span>
+<span class="nt"></ipojo></span>
+</pre></div>
- /**
- * Returns an 'Hello' message.
- * @param name : name
- * @return Hello message
- * @see ipojo.example.hello.Hello#sayHello(java.lang.String)
- */
- public String sayHello(String name) { return "hello " + name; }
- }
-
-To manage the component, iPOJO needs some metadata to understand that the component provides the *Hello* service. iPOJO metadata file is at the root of the *hello.impl* project ("metadata.xml"). It contains the following metadata (Note: iPOJO also supports a JAR manifest-based syntax):
-
- <?xml version="1.0" encoding="UTF-8"?>
- <ipojo
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="org.apache.felix.ipojo http://felix.apache.org/ipojo/schemas/CURRENT/core.xsd"
- xmlns="org.apache.felix.ipojo">
-
- <component classname="ipojo.example.hello.impl.HelloImpl"
- name="HelloProvider">
- <provides />
- </component>
- <instance component="HelloProvider" name="HelloService" />
- </ipojo>
-
-In the above XML-based metadata, the *component* element has a mandatory '*classname'*attribute. This attribute tells iPOJO the implementation class of the component. Since the component in this example provides a service, the component element also specifies a child '*provides*' element. The '*provides*' element informs iPOJO that it must manage the publishing of a service. When the '*provides*' element does not contain an interface attribute, as is the case in this example, iPOJO will expose all implemented interfaces of the component as a service; it is also possible to specify the precise service interface. The '*instance*' element asks iPOJO to create an instance of your component when the bundle is started.
-
-Finally, the "pom.xml" file contains instructions to build the bundle:
+<p>In the above XML-based metadata, the <em>component</em> element has a mandatory '<em>classname'</em>attribute. This attribute tells iPOJO the implementation class of the component. Since the component in this example provides a service, the component element also specifies a child '<em>provides</em>' element. The '<em>provides</em>' element informs iPOJO that it must manage the publishing of a service. When the '<em>provides</em>' element does not contain an interface attribute, as is the case in this example, iPOJO will expose all implemented interfaces of the component as a service; it is also possible to specify the precise service interface. The '<em>instance</em>' element asks iPOJO to create an instance of your component when the bundle is started.</p>
+<p>Finally, the "pom.xml" file contains instructions to build the bundle:
{div:class=pom}
<project>
<modelVersion>4.0.0</modelVersion>
<packaging>bundle</packaging>
{color:red}<groupId>ipojo.example</groupId>{color}
{color:red} <artifactId>hello.impl</artifactId>{color}
-{color:red} <version>1.0.0</version>{color}
-
- {color:red}<name>Hello Service Provider</name>{color}
-
-{color:red} <dependencies>{color}
+{color:red} <version>1.0.0</version>{color}</p>
+<p> {color:red}<name>Hello Service Provider</name>{color}</p>
+<p>{color:red} <dependencies>{color}
{color:red} <dependency> <!--Compilation (i.e. class) dependency on the service interface -->{color}
{color:red} <groupId>ipojo.example</groupId>{color}
{color:red} <artifactId>hello.service</artifactId>{color}
{color:red} <version>{color}{color:#ff0000}1.0.0{color}{color:red}</version>{color}
{color:red} </dependency>{color}
-{color:red} </dependencies>{color}
-
- <build>
+{color:red} </dependencies>{color}</p>
+<p> <build>
<plugins>
<plugin>
<groupId>org.apache.felix</groupId>
@@ -229,7 +347,7 @@ Finally, the "pom.xml" file contains ins
<extensions>true</extensions>
<configuration>
<instructions>
- <Bundle-SymbolicName>$\{pom.artifactId}</Bundle-SymbolicName>
+ <Bundle-SymbolicName>${pom.artifactId}</Bundle-SymbolicName>
{color:red}<Private-Package>ipojo.example.hello.impl</Private-Package>{color}
</instructions>
</configuration>
@@ -250,117 +368,115 @@ Finally, the "pom.xml" file contains ins
</build>
</project>
{div}
-The text highlighted in {color:red}{*}red{*}{color} above indicates the important information related to the project. The first part of the POM file indicates that the packaging format is an iPOJO bundle and also includes some information about the project (name, groupId, and artifactId). This information is not used by iPOJO, but is used by Maven. The rest of the POM file contains the bundle configuration. In the *instructions* element, you need to enter the bundle name, the bundle description, and the exported packages. The service provider bundle exports the package of *Hello* interface.
-
-Then, the project is ready to be built issuing the following Maven command inside the project directory:
-
- mvn clean install
-
-Maven should report that the build was a success; if an error was reported then verify the previous steps. Upon success the *Hello* service component JAR file is installed into the local Maven repository. A copy of the bundle JAR file will also be present in the "target" directory inside the project directory.
+The text highlighted in {color:red}{<em>}red{</em>}{color} above indicates the important information related to the project. The first part of the POM file indicates that the packaging format is an iPOJO bundle and also includes some information about the project (name, groupId, and artifactId). This information is not used by iPOJO, but is used by Maven. The rest of the POM file contains the bundle configuration. In the <em>instructions</em> element, you need to enter the bundle name, the bundle description, and the exported packages. The service provider bundle exports the package of <em>Hello</em> interface.</p>
+<p>Then, the project is ready to be built issuing the following Maven command inside the project directory:</p>
+<div class="codehilite"><pre><span class="n">mvn</span> <span class="n">clean</span> <span class="n">install</span>
+</pre></div>
-### Hello Service Client
-The Hello service consumer is inside the *hello.client* project. The file `src/main/java/ipojo/example/hello/client/HelloClient.java` contains the following *Hello* service client:
+<p>Maven should report that the build was a success; if an error was reported then verify the previous steps. Upon success the <em>Hello</em> service component JAR file is installed into the local Maven repository. A copy of the bundle JAR file will also be present in the "target" directory inside the project directory.</p>
+<h3 id="hello-service-client">Hello Service Client</h3>
+<p>The Hello service consumer is inside the <em>hello.client</em> project. The file <code>src/main/java/ipojo/example/hello/client/HelloClient.java</code> contains the following <em>Hello</em> service client:
{code:java}
-package ipojo.example.hello.client;
-
-import ipojo.example.hello.Hello;
-
-/**
+package ipojo.example.hello.client;</p>
+<p>import ipojo.example.hello.Hello;</p>
+<p>/*<em>
* Hello Service simple client.
* @author <a href="mailto:dev@felix.apache.org">Felix Project Team</a>
- */
-public class HelloClient implements Runnable {
-
- /**
- * Delay between two invocations.
- */
- private static final int DELAY = 10000;
-
- /**
- * Hello services.
- * Injected by the container.
- * */
- private Hello[]() m_hello;
-
- /**
- * End flag.
- * */
- private boolean m_end;
+ </em>/
+public class HelloClient implements Runnable {</p>
+<div class="codehilite"><pre><span class="o">/**</span>
+ <span class="o">*</span> <span class="n">Delay</span> <span class="n">between</span> <span class="n">two</span> <span class="n">invocations</span><span class="o">.</span>
+ <span class="o">*/</span>
+<span class="n">private</span> <span class="n">static</span> <span class="n">final</span> <span class="nb">int</span> <span class="n">DELAY</span> <span class="o">=</span> <span class="mi">10000</span><span class="p">;</span>
+
+<span class="o">/**</span>
+ <span class="o">*</span> <span class="n">Hello</span> <span class="n">services</span><span class="o">.</span>
+ <span class="o">*</span> <span class="n">Injected</span> <span class="n">by</span> <span class="n">the</span> <span class="n">container</span><span class="o">.</span>
+ <span class="o">*</span> <span class="o">*/</span>
+<span class="n">private</span> <span class="n">Hello</span><span class="o">[]</span><span class="p">()</span> <span class="n">m_hello</span><span class="p">;</span>
+
+<span class="o">/**</span>
+ <span class="o">*</span> <span class="n">End</span> <span class="n">flag</span><span class="o">.</span>
+ <span class="o">*</span> <span class="o">*/</span>
+<span class="n">private</span> <span class="n">boolean</span> <span class="n">m_end</span><span class="p">;</span>
+
+<span class="o">/**</span>
+ <span class="o">*</span> <span class="n">Run</span> <span class="n">method</span><span class="o">.</span>
+ <span class="o">*</span> <span class="nv">@see</span> <span class="n">java</span><span class="o">.</span><span class="n">lang</span><span class="o">.</span><span class="n">Runnable</span><span class="c1">#run()</span>
+ <span class="o">*/</span>
+<span class="n">public</span> <span class="n">void</span> <span class="n">run</span><span class="p">()</span> <span class="p">{</span>
+ <span class="k">while</span> <span class="p">(</span><span class="o">!</span><span class="n">m_end</span><span class="p">)</span> <span class="p">{</span>
+ <span class="n">try</span> <span class="p">{</span>
+ <span class="n">invokeHelloServices</span><span class="p">();</span>
+ <span class="n">Thread</span><span class="o">.</span><span class="nb">sleep</span><span class="p">(</span><span class="n">DELAY</span><span class="p">);</span>
+ <span class="p">}</span> <span class="n">catch</span> <span class="p">(</span><span class="n">InterruptedException</span> <span class="n">ie</span><span class="p">)</span> <span class="p">{</span>
+ <span class="sr">/* will recheck end */</span>
+ <span class="p">}</span>
+ <span class="p">}</span>
+<span class="p">}</span>
+
+<span class="o">/**</span>
+ <span class="o">*</span> <span class="n">Invoke</span> <span class="n">hello</span> <span class="n">services</span><span class="o">.</span>
+ <span class="o">*/</span>
+<span class="n">public</span> <span class="n">void</span> <span class="n">invokeHelloServices</span><span class="p">()</span> <span class="p">{</span>
+ <span class="k">for</span> <span class="p">(</span><span class="nb">int</span> <span class="n">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="n">i</span> <span class="o"><</span> <span class="n">m_hello</span><span class="o">.</span><span class="nb">length</span><span class="p">;</span> <span class="n">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span>
+ <span class="sr">//</span> <span class="n">Update</span> <span class="n">with</span> <span class="n">your</span> <span class="n">name</span><span class="o">.</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">m_hello</span><span class="p">[</span><span class="n">i</span><span class="p">]()</span><span class="o">.</span><span class="n">sayHello</span><span class="p">(</span><span class="s">"world"</span><span class="p">));</span>
+ <span class="p">}</span>
+<span class="p">}</span>
+
+<span class="o">/**</span>
+ <span class="o">*</span> <span class="n">Starting</span><span class="o">.</span>
+ <span class="o">*/</span>
+<span class="n">public</span> <span class="n">void</span> <span class="n">starting</span><span class="p">()</span> <span class="p">{</span>
+ <span class="n">Thread</span> <span class="n">thread</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Thread</span><span class="p">(</span><span class="n">this</span><span class="p">);</span>
+ <span class="n">m_end</span> <span class="o">=</span> <span class="n">false</span><span class="p">;</span>
+ <span class="n">thread</span><span class="o">.</span><span class="n">start</span><span class="p">();</span>
+<span class="p">}</span>
+
+<span class="o">/**</span>
+ <span class="o">*</span> <span class="n">Stopping</span><span class="o">.</span>
+ <span class="o">*/</span>
+<span class="n">public</span> <span class="n">void</span> <span class="n">stopping</span><span class="p">()</span> <span class="p">{</span>
+ <span class="n">m_end</span> <span class="o">=</span> <span class="n">true</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+
+
+<p>}</p>
+<div class="codehilite"><pre><span class="n">The</span> <span class="n">_Hello_</span> <span class="n">service</span> <span class="n">client</span> <span class="n">creates</span> <span class="n">a</span> <span class="n">thread</span> <span class="n">that</span> <span class="n">periodically</span> <span class="n">invokes</span> <span class="n">the</span> <span class="n">available</span> <span class="n">_Hello_</span> <span class="n">services</span><span class="o">.</span> <span class="n">The</span> <span class="n">thread</span> <span class="n">starts</span> <span class="n">when</span> <span class="n">at</span> <span class="n">least</span> <span class="n">one</span> <span class="n">_Hello_</span> <span class="n">service</span> <span class="n">provider</span> <span class="n">is</span> <span class="n">present</span> <span class="n">using</span> <span class="n">iPOJO</span><span class="s">'s call back mechanism. In the client code, to use the _hello_ the component implementat
ion simply declares a field of the type of the service and then simply uses it directly in its code. In this example, it is the m_hello field is declared as the service field; notice that the field is an array of _Hello_. In iPOJO an array of services represents an aggregate or multiple cardinality dependency, whereas if a scalar value represents a singular or unary cardinality dependency. In other words, for a singular dependency simply remove the array brackets from the example (e.g., HelloService m_hello\[\]. After declaring a field for the service, the rest of the component code can simply assume that the service field will be initialized, e.g., m_hello\[i\].sayHello("world").</span>
+
+<span class="s">Notice that iPOJO manages service synchronization too. So, the service invocations do not require synchronization blocks. This synchronization is maintained on a per thread basis, where each method that accesses a service is instrumented to attach the given service instance to the thread so that the thread will continue to see the same service instances even across nested method invocations. The thread will not see different service instances until it completely exits from the first method it entered which used a services. Thus, you would not want to access services in the method above, because the thread would always see the same service instance.</span>
+
+<span class="s">The component provides two callback methods for its activation and deactivation, starting() and stopping(), respectively. Callbacks are used when the component needs to be informed about a component state change. In iPOJO, the component state is either *INVALID* (i.e., not all of the component'</span><span class="n">s</span> <span class="n">constraints</span> <span class="n">are</span> <span class="n">satisfied</span><span class="p">)</span> <span class="ow">or</span> <span class="o">*</span><span class="n">VALID</span><span class="o">*</span> <span class="p">(</span><span class="n">i</span><span class="o">.</span><span class="n">e</span><span class="o">.</span><span class="p">,</span> <span class="n">all</span> <span class="n">of</span> <span class="n">the</span> <span class="n">component</span><span class="s">'s constraints are satisfied). In this example, the starting callback method creates and starts a thread; the stopping callback method stops t
he thread. The component metadata will instruct iPOJO to invoke these methods when the component'</span><span class="n">s</span> <span class="n">state</span> <span class="n">changes</span> <span class="n">to</span> <span class="o">*</span><span class="n">VALID</span><span class="o">*</span> <span class="ow">or</span> <span class="o">*</span><span class="n">INVALID</span><span class="o">*</span> <span class="n">respectively</span><span class="o">.</span>
+
+<span class="n">The</span> <span class="n">iPOJO</span> <span class="n">metadata</span> <span class="n">file</span> <span class="n">describing</span> <span class="n">the</span> <span class="n">component</span> <span class="n">is</span> <span class="s">"metadata.xml"</span> <span class="ow">and</span> <span class="n">contains</span> <span class="n">the</span> <span class="n">following</span> <span class="n">metadata:</span>
+<span class="p">{</span><span class="n">code:xml</span><span class="p">}</span>
+<span class="o"><</span><span class="p">?</span><span class="n">xml</span> <span class="n">version</span><span class="o">=</span><span class="s">"1.0"</span> <span class="n">encoding</span><span class="o">=</span><span class="s">"UTF-8"</span><span class="p">?</span><span class="o">></span>
+<span class="o"><</span><span class="n">ipojo</span>
+ <span class="n">xmlns:xsi</span><span class="o">=</span><span class="s">"http://www.w3.org/2001/XMLSchema-instance"</span>
+ <span class="n">xsi:schemaLocation</span><span class="o">=</span><span class="s">"org.apache.felix.ipojo http://felix.apache.org/ipojo/schemas/CURRENT/core.xsd"</span>
+ <span class="n">xmlns</span><span class="o">=</span><span class="s">"org.apache.felix.ipojo"</span><span class="o">></span>
+
+ <span class="o"><</span><span class="n">component</span> <span class="n">classname</span><span class="o">=</span><span class="s">"ipojo.example.hello.client.HelloClient"</span><span class="o">></span>
+ <span class="o"><</span><span class="n">requires</span> <span class="n">field</span><span class="o">=</span><span class="s">"m_hello"</span> <span class="o">/></span>
+ <span class="o"><</span><span class="n">callback</span> <span class="n">transition</span><span class="o">=</span><span class="s">"validate"</span> <span class="n">method</span><span class="o">=</span><span class="s">"starting"</span> <span class="o">/></span>
+ <span class="o"><</span><span class="n">callback</span> <span class="n">transition</span><span class="o">=</span><span class="s">"invalidate"</span> <span class="n">method</span><span class="o">=</span><span class="s">"stopping"</span> <span class="o">/></span>
+ <span class="sr"><properties></span>
+ <span class="o"><</span><span class="n">property</span> <span class="n">field</span><span class="o">=</span><span class="s">"m_name"</span> <span class="n">name</span><span class="o">=</span><span class="s">"hello.name"</span> <span class="o">/></span>
+ <span class="sr"></properties></span>
+ <span class="sr"></component></span>
+
+ <span class="o"><</span><span class="n">instance</span> <span class="n">component</span><span class="o">=</span><span class="s">"ipojo.example.hello.client.HelloClient"</span><span class="o">></span>
+ <span class="o"><</span><span class="n">property</span> <span class="n">name</span><span class="o">=</span><span class="s">"hello.name"</span> <span class="n">value</span><span class="o">=</span><span class="s">"clement"</span> <span class="o">/></span>
+ <span class="sr"></instance></span>
+<span class="sr"></ipojo></span>
+</pre></div>
- /**
- * Run method.
- * @see java.lang.Runnable#run()
- */
- public void run() {
- while (!m_end) {
- try {
- invokeHelloServices();
- Thread.sleep(DELAY);
- } catch (InterruptedException ie) {
- /* will recheck end */
- }
- }
- }
-
- /**
- * Invoke hello services.
- */
- public void invokeHelloServices() {
- for (int i = 0; i < m_hello.length; i++) {
- // Update with your name.
- System.out.println(m_hello[i]().sayHello("world"));
- }
- }
- /**
- * Starting.
- */
- public void starting() {
- Thread thread = new Thread(this);
- m_end = false;
- thread.start();
- }
-
- /**
- * Stopping.
- */
- public void stopping() {
- m_end = true;
- }
-}
-
- The _Hello_ service client creates a thread that periodically invokes the available _Hello_ services. The thread starts when at least one _Hello_ service provider is present using iPOJO's call back mechanism. In the client code, to use the _hello_ the component implementation simply declares a field of the type of the service and then simply uses it directly in its code. In this example, it is the m_hello field is declared as the service field; notice that the field is an array of _Hello_. In iPOJO an array of services represents an aggregate or multiple cardinality dependency, whereas if a scalar value represents a singular or unary cardinality dependency. In other words, for a singular dependency simply remove the array brackets from the example (e.g., HelloService m_hello\[\]. After declaring a field for the service, the rest of the component code can simply assume that the service field will be initialized, e.g., m_hello\[i\].sayHello("world").
-
- Notice that iPOJO manages service synchronization too. So, the service invocations do not require synchronization blocks. This synchronization is maintained on a per thread basis, where each method that accesses a service is instrumented to attach the given service instance to the thread so that the thread will continue to see the same service instances even across nested method invocations. The thread will not see different service instances until it completely exits from the first method it entered which used a services. Thus, you would not want to access services in the method above, because the thread would always see the same service instance.
-
- The component provides two callback methods for its activation and deactivation, starting() and stopping(), respectively. Callbacks are used when the component needs to be informed about a component state change. In iPOJO, the component state is either *INVALID* (i.e., not all of the component's constraints are satisfied) or *VALID* (i.e., all of the component's constraints are satisfied). In this example, the starting callback method creates and starts a thread; the stopping callback method stops the thread. The component metadata will instruct iPOJO to invoke these methods when the component's state changes to *VALID* or *INVALID* respectively.
-
- The iPOJO metadata file describing the component is "metadata.xml" and contains the following metadata:
- {code:xml}
- <?xml version="1.0" encoding="UTF-8"?>
- <ipojo
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="org.apache.felix.ipojo http://felix.apache.org/ipojo/schemas/CURRENT/core.xsd"
- xmlns="org.apache.felix.ipojo">
-
- <component classname="ipojo.example.hello.client.HelloClient">
- <requires field="m_hello" />
- <callback transition="validate" method="starting" />
- <callback transition="invalidate" method="stopping" />
- <properties>
- <property field="m_name" name="hello.name" />
- </properties>
- </component>
-
- <instance component="ipojo.example.hello.client.HelloClient">
- <property name="hello.name" value="clement" />
- </instance>
- </ipojo>
-
-The component element again has the '*classname'* attribute that refers to the component implementation class. The '*requires*' element describes the *Hello* service dependency by simply specifying its associated component field. The '*callback'*elements describe which method to invoke when the component's state changes. Then the '*instance*' element asks iPOJO to create an instance of the component (notice that no instance name is provided here, iPOJO will give an instance name to the instance automatically).
-
-Finally, the "pom.xml" file contains instructions to build the bundle:
+<p>The component element again has the '<em>classname'</em> attribute that refers to the component implementation class. The '<em>requires</em>' element describes the <em>Hello</em> service dependency by simply specifying its associated component field. The '<em>callback'</em>elements describe which method to invoke when the component's state changes. Then the '<em>instance</em>' element asks iPOJO to create an instance of the component (notice that no instance name is provided here, iPOJO will give an instance name to the instance automatically).</p>
+<p>Finally, the "pom.xml" file contains instructions to build the bundle:
{div:class=pom}
<project>
<modelVersion>4.0.0</modelVersion>
@@ -368,17 +484,15 @@ Finally, the "pom.xml" file contains ins
{color:red}<groupId>ipojo.example</groupId>{color}
{color:red} <artifactId>hello.client</artifactId>{color}
{color:red} <version>1.0.0</version>{color}
-{color:red} <name>Hello Client</name>{color}
-
-{color:red} <dependencies>{color}
-{color:red} <dependency> <\!-\-{color} {color:red}Compilation (i.e. class) dependency on the service interface \-\-{color}{color:red}>{color}
+{color:red} <name>Hello Client</name>{color}</p>
+<p>{color:red} <dependencies>{color}
+{color:red} <dependency> <!--{color} {color:red}Compilation (i.e. class) dependency on the service interface --{color}{color:red}>{color}
{color:red} <groupId>ipojo.example</groupId>{color}
{color:red} <artifactId>hello.service</artifactId>{color}
{color:red} <version>{color}{color:#ff0000}1.0.0{color}{color:red}</version>{color}
{color:red} </dependency>{color}
-{color:red} </dependencies>{color}
-
- <build>
+{color:red} </dependencies>{color}</p>
+<p> <build>
<plugins>
<plugin>
<groupId>org.apache.felix</groupId>
@@ -387,7 +501,7 @@ Finally, the "pom.xml" file contains ins
<extensions>true</extensions>
<configuration>
<instructions>
- <Bundle-SymbolicName>$\{pom.artifactId}</Bundle-SymbolicName>
+ <Bundle-SymbolicName>${pom.artifactId}</Bundle-SymbolicName>
{color:red}<Private-Package>ipojo.example.hello.client</Private-Package>{color}
</instructions>
</configuration>
@@ -408,52 +522,50 @@ Finally, the "pom.xml" file contains ins
</build>
</project>
{div}
-The text highlighted in {color:red}{*}red{*}{color} above indicates the information related to the project. The *dependencies* element tells Maven that the client bundle has a compilation dependency on the service provider bundle. In this case, the client bundle needs the *Hello* service interface to compile. After building the service provider bundle JAR file, Maven installs it into a local repository on your machine. To resolve compilation dependencies, Maven looks in the local repository to find required JAR files.
+The text highlighted in {color:red}{<em>}red{</em>}{color} above indicates the information related to the project. The <em>dependencies</em> element tells Maven that the client bundle has a compilation dependency on the service provider bundle. In this case, the client bundle needs the <em>Hello</em> service interface to compile. After building the service provider bundle JAR file, Maven installs it into a local repository on your machine. To resolve compilation dependencies, Maven looks in the local repository to find required JAR files.
After the skeleton "pom.xml" file is modified, the project is ready to be built issuing the following Maven command inside the project directory:
mvn clean install
-Maven should report that the build was a success; if an error was reported then verify the previous steps. Upon success the *Hello* service component JAR file is installed into the local Maven repository. A copy of the bundle JAR file will also be present in the "target" directory inside the project directory.
-
-## Running the example
-
-To run the example, start Felix. A distribution of Felix is provided in the felix-1.0.3 directory. This version is configured to launch iPOJO automatically. From the Felix directory, launch the following command to start the framework
-
- java -jar bin/felix.jar
+Maven should report that the build was a success; if an error was reported then verify the previous steps. Upon success the <em>Hello</em> service component JAR file is installed into the local Maven repository. A copy of the bundle JAR file will also be present in the "target" directory inside the project directory.</p>
+<h2 id="running-the-example">Running the example</h2>
+<p>To run the example, start Felix. A distribution of Felix is provided in the felix-1.0.3 directory. This version is configured to launch iPOJO automatically. From the Felix directory, launch the following command to start the framework</p>
+<div class="codehilite"><pre><span class="n">java</span> <span class="o">-</span><span class="n">jar</span> <span class="n">bin</span><span class="o">/</span><span class="n">felix</span><span class="o">.</span><span class="n">jar</span>
+</pre></div>
+
+
+<p>You can check installed bundles by using the '<em>ps'</em> command:</p>
+<div class="codehilite"><pre><span class="o">-></span> <span class="n">ps</span>
+<span class="n">START</span> <span class="n">LEVEL</span> <span class="mi">1</span>
+ <span class="n">ID</span> <span class="n">State</span> <span class="n">Level</span> <span class="n">Name</span>
+<span class="p">[</span> <span class="mi">0</span><span class="p">]</span> <span class="p">[</span><span class="n">Active</span> <span class="p">]</span> <span class="p">[</span> <span class="mi">0</span><span class="p">]</span> <span class="n">System</span> <span class="n">Bundle</span> <span class="p">(</span><span class="mf">2.0.5</span><span class="p">)</span>
+<span class="p">[</span> <span class="mi">1</span><span class="p">]</span> <span class="p">[</span><span class="n">Active</span> <span class="p">]</span> <span class="p">[</span> <span class="mi">1</span><span class="p">]</span> <span class="n">Apache</span> <span class="n">Felix</span> <span class="n">Bundle</span> <span class="n">Repository</span> <span class="p">(</span><span class="mf">1.4.3</span><span class="p">)</span>
+<span class="p">[</span> <span class="mi">2</span><span class="p">]</span> <span class="p">[</span><span class="n">Active</span> <span class="p">]</span> <span class="p">[</span> <span class="mi">1</span><span class="p">]</span> <span class="n">Apache</span> <span class="n">Felix</span> <span class="n">iPOJO</span> <span class="p">(</span><span class="mf">1.6.0</span><span class="p">)</span>
+<span class="p">[</span> <span class="mi">3</span><span class="p">]</span> <span class="p">[</span><span class="n">Active</span> <span class="p">]</span> <span class="p">[</span> <span class="mi">1</span><span class="p">]</span> <span class="n">Apache</span> <span class="n">Felix</span> <span class="n">iPOJO</span> <span class="n">Arch</span> <span class="n">Command</span> <span class="p">(</span><span class="mf">1.6.0</span><span class="p">)</span>
+<span class="p">[</span> <span class="mi">4</span><span class="p">]</span> <span class="p">[</span><span class="n">Active</span> <span class="p">]</span> <span class="p">[</span> <span class="mi">1</span><span class="p">]</span> <span class="n">Apache</span> <span class="n">Felix</span> <span class="n">Shell</span> <span class="n">Service</span> <span class="p">(</span><span class="mf">1.4.2</span><span class="p">)</span>
+<span class="p">[</span> <span class="mi">5</span><span class="p">]</span> <span class="p">[</span><span class="n">Active</span> <span class="p">]</span> <span class="p">[</span> <span class="mi">1</span><span class="p">]</span> <span class="n">Apache</span> <span class="n">Felix</span> <span class="n">Shell</span> <span class="n">TUI</span> <span class="p">(</span><span class="mf">1.4.1</span><span class="p">)</span>
+<span class="o">-></span>
+</pre></div>
-You can check installed bundles by using the '*ps'* command:
- -> ps
- START LEVEL 1
- ID State Level Name
- [ 0] [Active ] [ 0] System Bundle (2.0.5)
- [ 1] [Active ] [ 1] Apache Felix Bundle Repository (1.4.3)
- [ 2] [Active ] [ 1] Apache Felix iPOJO (1.6.0)
- [ 3] [Active ] [ 1] Apache Felix iPOJO Arch Command (1.6.0)
- [ 4] [Active ] [ 1] Apache Felix Shell Service (1.4.2)
- [ 5] [Active ] [ 1] Apache Felix Shell TUI (1.4.1)
- ->
-
-iPOJO runtime is the bundle 4. The bundle 5 is a Felix shell command allowing the introspection of iPOJO component instances (see herefor further information).
-
-Install the Hello service bundle, the *Hello* service provider and the client that were created above:
+<p>iPOJO runtime is the bundle 4. The bundle 5 is a Felix shell command allowing the introspection of iPOJO component instances (see herefor further information).</p>
+<p>Install the Hello service bundle, the <em>Hello</em> service provider and the client that were created above:
{div:class=shell}
start file:../hello.service/target/hello.service-1.0.0.jar
start file:../hello.impl/target/hello.impl-1.0.0.jar
start file:../hello.client/target/hello.client-1.0.0.jar
{div}
-By starting the *Hello* service provider bundle, the client component will automatically be activated. So, the *'hello world'* messages are displayed.
+By starting the <em>Hello</em> service provider bundle, the client component will automatically be activated. So, the <em>'hello world'</em> messages are displayed.
{div:class=shell}
-\-> hello world
+-> hello world
hello world
{div}
-Stop the provider (with the '*stop 7*' command) and the client will automatically be deactivated since its dependency is no longer valid. If multiple Hello services are deployed, the client will connect to all of them. If you restart the bundle (with the *start 7* command), the client becomes valid.
-
-During these operations, you can use the arch command to check the state of instances.
+Stop the provider (with the '<em>stop 7</em>' command) and the client will automatically be deactivated since its dependency is no longer valid. If multiple Hello services are deployed, the client will connect to all of them. If you restart the bundle (with the <em>start 7</em> command), the client becomes valid.</p>
+<p>During these operations, you can use the arch command to check the state of instances.
{div:class=shell}
-\-> stop 7
-\-> arch
-Instance ArchCommand \-> valid
-{color:red}Instance ipojo.example.hello.client.HelloClient-0 \-> invalid{color}
-\-> arch \-instance ipojo.example.hello.client.HelloClient-0
+-> stop 7
+-> arch
+Instance ArchCommand -> valid
+{color:red}Instance ipojo.example.hello.client.HelloClient-0 -> invalid{color}
+-> arch -instance ipojo.example.hello.client.HelloClient-0
instance name="ipojo.example.hello.client.HelloClient-0"
component.type="ipojo.example.hello.client.HelloClient"
state="{color:red}invalid{color}" bundle="8"
@@ -462,13 +574,13 @@ instance name="ipojo.example.hello.clien
{color:red} {color}{color:red}requires aggregate="true" optional="false" state="resolved" specification="ipojo.example.hello.Hello"{color}
handler name="org.apache.felix.ipojo.handlers.lifecycle.callback.LifecycleCallbackHandler" state="valid"
handler name="org.apache.felix.ipojo.handlers.architecture.ArchitectureHandler" state="valid"
-\-> start 7
+-> start 7
hello world
-\-> arch
-Instance ArchCommand \-> valid
-{color:red}Instance ipojo.example.hello.client.HelloClient-0 \-> valid{color}
-Instance HelloService \-> valid
-\-> arch \-instance ipojo.example.hello.client.HelloClient-0
+-> arch
+Instance ArchCommand -> valid
+{color:red}Instance ipojo.example.hello.client.HelloClient-0 -> valid{color}
+Instance HelloService -> valid
+-> arch -instance ipojo.example.hello.client.HelloClient-0
instance name="ipojo.example.hello.client.HelloClient-0"
component.type="ipojo.example.hello.client.HelloClient"
state="valid" bundle="8"
@@ -478,14 +590,15 @@ instance name="ipojo.example.hello.clien
{color:red} {color} {color:red}uses service.id="38" instance.name="HelloService"{color}
handler name="org.apache.felix.ipojo.handlers.lifecycle.callback.LifecycleCallbackHandler" state="valid"
handler name="org.apache.felix.ipojo.handlers.architecture.ArchitectureHandler" state="valid"
-{div}
-
-## Conclusion
-We saw how to use easily iPOJO to build service-oriented components. 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="conclusion">Conclusion</h2>
+<p>We saw how to use easily iPOJO to build service-oriented components. 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
@@ -493,5 +606,18 @@ We saw how to use easily iPOJO to build
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>