| <!DOCTYPE HTML PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| <html><head> |
| |
| |
| |
| <title>Apache Felix - Apache Felix iPOJO Feature Overview</title> |
| <link rel="stylesheet" href="apache-felix-ipojo-feature-overview_files/site.css" type="text/css" media="all"> |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| </head><body> |
| <div class="title"><div class="logo"><a href="http://felix.apache.org/site/index.html"><img alt="Apache Felix" src="apache-felix-ipojo-feature-overview_files/logo.png" border="0"></a></div><div class="header"><a href="http://www.apache.org/"><img alt="Apache" src="apache-felix-ipojo-feature-overview_files/apache.png" border="0"></a></div></div> |
| <div class="menu"> |
| <ul> |
| <li><a href="http://felix.apache.org/site/news.html" title="news">news</a></li> |
| <li><a href="http://felix.apache.org/site/license.html" title="license">license</a></li> |
| <li><span class="nobr"><a href="http://felix.apache.org/site/downloads.cgi" title="Visit page outside Confluence" rel="nofollow">downloads<sup><img class="rendericon" src="apache-felix-ipojo-feature-overview_files/linkext7.gif" alt="" align="absmiddle" border="0" width="7" height="7"></sup></a></span></li> |
| <li><a href="http://felix.apache.org/site/documentation.html" title="documentation">documentation</a></li> |
| <li><a href="http://felix.apache.org/site/mailinglists.html" title="mailinglists">mailing lists</a></li> |
| <li><a href="http://felix.apache.org/site/contributing.html" title="Contributing">contributing</a></li> |
| <li><span class="nobr"><a href="http://www.apache.org/" title="Visit page outside Confluence" rel="nofollow">asf<sup><img class="rendericon" src="apache-felix-ipojo-feature-overview_files/linkext7.gif" alt="" align="absmiddle" border="0" width="7" height="7"></sup></a></span></li> |
| <li><span class="nobr"><a href="http://www.apache.org/foundation/sponsorship.html" title="Visit page outside Confluence" rel="nofollow">sponsorship<sup><img class="rendericon" src="apache-felix-ipojo-feature-overview_files/linkext7.gif" alt="" align="absmiddle" border="0" width="7" height="7"></sup></a></span></li> |
| <li><span class="nobr"><a href="http://www.apache.org/foundation/thanks.html" title="Visit page outside Confluence" rel="nofollow">sponsors<sup><img class="rendericon" src="apache-felix-ipojo-feature-overview_files/linkext7.gif" alt="" align="absmiddle" border="0" width="7" height="7"></sup></a></span> |
| <!-- ApacheCon Ad --> |
| <iframe src="apache-felix-ipojo-feature-overview_files/button.html" style="border-width: 0pt; float: left;" scrolling="no" width="135" frameborder="0" height="135"></iframe> |
| <p style="height: 100px;"> |
| <!-- ApacheCon Ad --> |
| </p></li></ul> </div> |
| <div class="main"> |
| <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr> |
| <td class="confluenceTd" valign="top" width="80%"> |
| <h1><a name="ApacheFelixiPOJOFeatureOverview-ApacheFelixiPOJOFeatureOverview"></a>Apache Felix iPOJO Feature Overview</h1> |
| |
| <p>This page is an attempt to put all of the features and benefits of |
| iPOJO into a single high-level list so that it is easy to see why you |
| will want to use iPOJO for your applications. This list is not |
| exhaustive, but represents the set of features that are potentially |
| most likely to be needed or are unique.</p> |
| |
| <h2><a name="ApacheFelixiPOJOFeatureOverview-CoreFeatures"></a>Core Features</h2> |
| |
| <ul> |
| <li><b>POJO-based approach</b> - Most components can simply be POJOs and need not have iPOJO- or OSGi-specific API in them.</li> |
| <li><b>Simple service provisioning</b> - iPOJO manages all aspects of providing an OSGi service. |
| <ul> |
| <li><b>Service property management</b> |
| <ul class="alternate" type="square"> |
| <li>Can be controlled by configuration properties.</li> |
| <li>Can |
| be mapped to member fields and automatically updated by the component |
| instance at run time by just changing the member field value.</li> |
| </ul> |
| </li> |
| <li><b>Service life cycle participation</b> |
| - The component instance can participate in the service life cycle by |
| declaring a boolean member field that indicates when the service is |
| actually valid (normally a service is assumed to be valid if the |
| component instance's dependencies are satisfied).</li> |
| </ul> |
| </li> |
| <li><b>Rich service dependency model</b> - Automatically manages a full spectrum of service dependencies. |
| <ul> |
| <li><b>Optional/mandatory</b> service dependencies.</li> |
| <li><b>Singular/aggregate</b> service dependencies.</li> |
| <li><b>Default service implementations</b> - The component can provide default implementations of dependent services if no providers are available.</li> |
| <li><b>Member field or method injection</b> - Also supported in combination. |
| <ul class="alternate" type="square"> |
| <li>Member field injection does not require cluttering component code with bind/unbind methods.</li> |
| <li>Member method injection supports various method signatures |
| <ul class="alternate" type="square"> |
| <li>method() - Acts as a simple event-callback mechanism.</li> |
| <li>method(<service-interface> svc) - Receives the service object cast to the appropriate interface.</li> |
| <li>method(ServiceReference ref) - Receives the OSGi ServiceReference for the service object.</li> |
| <li>method(ServiceReference |
| ref, <service-interface> svc) - Receives the OSGi |
| ServiceReference and the service object cast to the appropriate |
| interface.</li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| <li><b>Binding policies</b> - Allow components to control how/when their dependencies are bound. |
| <ul class="alternate" type="square"> |
| <li><b>Static</b> - Static dependencies <b>cannot</b> |
| change without invalidating the component instance, so injected |
| services typically do not change at run time and service departures |
| typically result in the component instance being destroyed and |
| potentially recreated.</li> |
| <li><b>Dynamic</b> - Dynamic dependencies <b>can</b> change without invalidating the component instance, so injected services can change at run time, but <b>do not</b> |
| change with respect to service priority changes (i.e., they do not |
| automatically switch if a higher priority service appears).</li> |
| <li><b>Dynamic priority</b> - Dynamic priority dependencies <b>can</b> change without invalidating the component instance and <b>do</b> dynamically update based on service priority rankings at run time.</li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| <li><b>Configuration property management</b> - Integrated with OSGi Configuration Admin service. |
| <ul> |
| <li><b>Member field/member method injection</b> - Also supported in combination.</li> |
| <li><b>Service property propagation</b> |
| - Configuration properties can be configured to update service |
| properties if the component instance is providing a service.</li> |
| </ul> |
| </li> |
| <li><b>Sophisticated concurrency handling</b> |
| - Externalizes concurrency issues so that component code does not need |
| to worry about services changing while they are in use (i.e., no |
| locking protocol in component code).</li> |
| <li><b>Deferred instance creation</b> - POJO instances are not created until they are actually needed, thus reducing start-up overhead.</li> |
| <li><b>Introspection support</b> - Supports introspecting a component instance and the state of its dependencies. |
| <ul> |
| <li>Interactive introspection is supported by an arch command for Felix' shell.</li> |
| </ul> |
| </li> |
| <li><b>Extensible</b> |
| - All iPOJO features are implemented via a set of handlers, which is an |
| extensibility mechanism open to developers by which they can support |
| custom functionality (e.g., exporting a provided service remotely, |
| etc.).</li> |
| </ul> |
| |
| |
| <h2><a name="ApacheFelixiPOJOFeatureOverview-Advanced/ExperimentalFeatures"></a>Advanced/Experimental Features</h2> |
| |
| <ul> |
| <li><b>Composite model</b> - iPOJO supports a flexible architectural-like model for composing services. |
| <ul> |
| <li><b>Flexible composites</b> - A composite is an abstract component implementation. |
| <ul class="alternate" type="square"> |
| <li><b>Sub-services and sub-components</b> |
| - Unlike traditional component composition, an iPOJO composite can be |
| described in terms of services in addition to sub-components; thus |
| sub-service implementation selection is deferred until run time.</li> |
| <li><b>Optional/mandatory</b> sub-services and/or sub-components.</li> |
| <li><b>Singular/aggregate</b> sub-services and/or sub-components.</li> |
| </ul> |
| </li> |
| <li><b>Hierarchical</b> - A composite component may contain other composite components. |
| <ul class="alternate" type="square"> |
| <li><b>Composite scoping</b> |
| - A composite acts as a scoping mechanism where |
| sub-services/sub-components are not visible externally and external |
| services are not visible internally.</li> |
| </ul> |
| </li> |
| <li><b>Service dependencies</b> |
| - A composite has the full expressive capabilities of primitive |
| components when it comes to service dependencies (see above description |
| of service dependencies in core features). <ul class="alternate" type="square"> |
| <li>For a composite, a |
| service dependency effectively imports an external service into the |
| composite scope from its parent composite (which may be the OSGi |
| service registry in the root case).</li> |
| </ul> |
| </li> |
| <li><b>Composite is just a component</b> - Composites can be instantiated and automatically managed just like a primitive component.</li> |
| </ul> |
| </li> |
| </ul> |
| |
| </td> |
| <td class="confluenceTd" valign="top" width="20%"> |
| <h6><a name="ApacheFelixiPOJOFeatureOverview-Overview"></a><b>Overview</b></h6> |
| <ul> |
| <li><a href="http://felix.apache.org/site/apache-felix-ipojo.html" title="Apache Felix iPOJO">Home Page</a></li> |
| <li><a href="" title="Apache Felix iPOJO Feature Overview">iPOJO Feature Overview</a></li> |
| <li><a href="http://felix.apache.org/site/download.html" title="Download">Download & Install </a></li> |
| </ul> |
| |
| |
| <h6><a name="ApacheFelixiPOJOFeatureOverview-GettingStarted"></a><b>Getting Started</b></h6> |
| <ul> |
| <li><a href="http://felix.apache.org/site/ipojo-in-10-minutes.html" title="iPOJO in 10 minutes">iPOJO in 10 minutes</a></li> |
| <li><a href="http://felix.apache.org/site/how-to-use-ipojo-annotations.html" title="How to use iPOJO Annotations">How to use iPOJO Annotations</a></li> |
| <li><a href="http://felix.apache.org/site/ipojo-hello-word-maven-based-tutorial.html" title="iPOJO Hello Word (Maven-Based) tutorial">iPOJO Hello Word (Maven-Based) tutorial</a></li> |
| <li><a href="http://felix.apache.org/site/ipojo-advanced-tutorial.html" title="iPOJO Advanced Tutorial">iPOJO Advanced Tutorial</a></li> |
| <li><a href="http://felix.apache.org/site/ipojo-composition-tutorial.html" title="iPOJO Composition Tutorial">iPOJO Composition Tutorial</a></li> |
| </ul> |
| |
| |
| <h6><a name="ApacheFelixiPOJOFeatureOverview-UserGuide"></a><b>User Guide</b></h6> |
| <ul> |
| <li><a href="http://felix.apache.org/site/describing-components.html" title="Describing components">Describing components (handler list) </a></li> |
| <li><a href="http://felix.apache.org/site/using-xml-schemas.html" title="Using XML Schemas">Using XML Schemas</a></li> |
| <li><a href="http://felix.apache.org/site/apache-felix-ipojo-testing-components.html" title="apache-felix-ipojo-testing-components">Testing components</a></li> |
| <li><a href="http://felix.apache.org/site/ipojo-advanced-topics.html" title="iPOJO Advanced Topics">Advanced Topics</a></li> |
| <li><a href="http://felix.apache.org/site/ipojo-faq.html" title="iPOJO FAQ">FAQ</a></li> |
| </ul> |
| |
| |
| <h6><a name="ApacheFelixiPOJOFeatureOverview-Tools"></a><b>Tools</b></h6> |
| <ul> |
| <li><a href="http://felix.apache.org/site/ipojo-eclipse-plug-in.html" title="iPOJO Eclipse Plug-in">iPOJO Eclipse Plug-in</a></li> |
| <li><a href="http://felix.apache.org/site/ipojo-ant-task.html" title="iPOJO Ant Task">iPOJO Ant Task</a></li> |
| <li><a href="http://felix.apache.org/site/ipojo-maven-plug-in.html" title="iPOJO Maven Plug-in">iPOJO Maven Plug-in</a></li> |
| <li><a href="http://felix.apache.org/site/apache-felix-ipojo-junit4osgi.html" title="apache-felix-ipojo-junit4osgi">Junit4OSGi</a></li> |
| <li><a href="http://felix.apache.org/site/ipojo-concepts-overview.html" title="iPOJO Concepts Overview">iPOJO concepts overview</a></li> |
| </ul> |
| |
| |
| <h6><a name="ApacheFelixiPOJOFeatureOverview-DeveloperGuide"></a><b>Developer Guide</b></h6> |
| <ul> |
| <li>API: <span class="nobr"><a href="http://people.apache.org/%7Eclement/ipojo/api/1.0/" title="Visit page outside Confluence" rel="nofollow">1.0<sup><img class="rendericon" src="apache-felix-ipojo-feature-overview_files/linkext7.gif" alt="" align="absmiddle" border="0" width="7" height="7"></sup></a></span></li> |
| <li><a href="http://felix.apache.org/site/how-to-write-your-own-handler.html" title="How to write your own handler">How to write your own handler</a></li> |
| <li><a href="http://felix.apache.org/site/how-to-use-ipojo-manipulation-metadata.html" title="How to use iPOJO Manipulation Metadata">How to use iPOJO Manipulation Metadata</a></li> |
| <li><a href="http://felix.apache.org/site/dive-into-the-ipojo-manipulation-depths.html" title="Dive into the iPOJO Manipulation depths">Dive into the iPOJO Manipulation depths</a></li> |
| </ul> |
| |
| |
| <h6><a name="ApacheFelixiPOJOFeatureOverview-Misc&Contact"></a><b>Misc & Contact</b></h6> |
| <ul> |
| <li><a href="http://felix.apache.org/site/apache-felix-ipojo-issuestracker.html" title="apache-felix-ipojo-issuestracker">Issues Tracker</a></li> |
| <li><a href="http://felix.apache.org/site/apache-felix-ipojo-supportedvms.html" title="apache-felix-ipojo-supportedVMs">Supported JVMs</a></li> |
| <li><a href="http://felix.apache.org/site/apache-felix-ipojo-supportedosgi.html" title="apache-felix-ipojo-supportedOSGi">Supported OSGi Implementations</a></li> |
| <li><span class="nobr"><a href="http://ipojo-dark-side.blogspot.com/" title="Visit page outside Confluence" rel="nofollow">iPOJO's Dark Side Blog<sup><img class="rendericon" src="apache-felix-ipojo-feature-overview_files/linkext7.gif" alt="" align="absmiddle" border="0" width="7" height="7"></sup></a></span></li> |
| <li><a href="http://felix.apache.org/site/future-ideas.html" title="Future Ideas">Future Ideas</a></li> |
| <li><a href="http://felix.apache.org/site/contact.html" title="Contact">Contact</a></li> |
| <li><a href="http://felix.apache.org/site/related-works.html" title="Related Works">Related Works</a></li> |
| <li><a href="http://felix.apache.org/site/article-presentations.html" title="Article & Presentations">Article & Presentations</a></li> |
| </ul> |
| |
| |
| <hr> |
| <div class="" align="center"> |
| <p><span class="nobr"><a href="http://cwiki.apache.org/confluence/createrssfeed.action?types=blogpost&statuses=created&statuses=modified&spaces=FELIX&labelString=iPOJO&rssType=atom&maxResults=10&timeSpan=5&publicFeed=true&title=iPOJO%20Atom%20Feed" title="Stay tuned!" rel="nofollow"><img src="apache-felix-ipojo-feature-overview_files/feed-icon-32x32.png" align="absmiddle" border="0"><sup><img class="rendericon" src="apache-felix-ipojo-feature-overview_files/linkext7.gif" alt="" align="absmiddle" border="0" width="7" height="7"></sup></a></span></p></div> |
| |
| <script type="text/javascript"> |
| var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www."); |
| document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E")); |
| </script><script src="apache-felix-ipojo-feature-overview_files/ga.js" type="text/javascript"></script> |
| <script type="text/javascript"> |
| var pageTracker = _gat._getTracker("UA-1518442-4"); |
| pageTracker._trackPageview(); |
| </script> |
| </td></tr></tbody></table> |
| |
| |
| </div> |
| </body></html> |