Clement Escoffier | 130ca57 | 2008-10-13 07:33:03 +0000 | [diff] [blame^] | 1 | |
| 2 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| 3 | <HTML> |
| 4 | |
| 5 | <!-- Mirrored Site: felix.apache.org. File: /site/white-board-pattern-handler.html. Date: Mon, 13 Oct 2008 06:52:59 GMT --> |
| 6 | <HEAD> |
| 7 | <TITLE>Apache Felix - White Board Pattern Handler</TITLE> |
| 8 | <LINK rel="stylesheet" href="media.data/site.css" type="text/css" media="all"> |
| 9 | <META http-equiv="Content-Type" content="text/html;charset=UTF-8"> |
| 10 | </HEAD> |
| 11 | <BODY> |
| 12 | <DIV class="title"><DIV class="logo"><A href="index.html"><IMG border="0" alt="Apache Felix" src="media.data/logo.png"></A></DIV><DIV class="header"><A href="http://www.apache.org/"><IMG border="0" alt="Apache" src="media.data/apache.png"></A></DIV></DIV> |
| 13 | <DIV class="menu"> |
| 14 | <UL> |
| 15 | <LI><A href="news.html" title="news">news</A></LI> |
| 16 | <LI><A href="license.html" title="license">license</A></LI> |
| 17 | <LI><SPAN class="nobr"><A href="downloads.html" title="Visit page outside Confluence" rel="nofollow">downloads<SUP><IMG class="rendericon" src="../../cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI> |
| 18 | <LI><A href="documentation.html" title="documentation">documentation</A></LI> |
| 19 | <LI><A href="mailinglists.html" title="mailinglists">mailing lists</A></LI> |
| 20 | <LI><A href="contributing.html" title="Contributing">contributing</A></LI> |
| 21 | <LI><SPAN class="nobr"><A href="http://www.apache.org/" title="Visit page outside Confluence" rel="nofollow">asf<SUP><IMG class="rendericon" src="../../cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI> |
| 22 | <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="../../cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI> |
| 23 | <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="../../cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN> |
| 24 | <!-- ApacheCon Ad --> |
| 25 | <IFRAME src="http://www.apache.org/ads/button.html" style="border-width:0; float: left" frameborder="0" scrolling="no" width="135" height="135"></IFRAME> |
| 26 | <P style="height: 100px"> |
| 27 | <!-- ApacheCon Ad --></LI> |
| 28 | </UL> |
| 29 | </DIV> |
| 30 | <DIV class="main"> |
| 31 | <TABLE class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><TBODY><TR> |
| 32 | <TD class="confluenceTd" valign="top" width="80%"> |
| 33 | <H1><A name="WhiteBoardPatternHandler-Thewhiteboardpatternhandler"></A>The white board pattern handler</H1> |
| 34 | <P>The objective of this handler is to simplify the development of white-board architecture. This architecture-style is based is very close to the extender architecture style but use services instead of bundles.<BR> |
| 35 | A whiteboard is based on two different roles:</P> |
| 36 | <UL class="alternate" type="square"> |
| 37 | <LI>A consumer looking to special services or a services published with a special mark</LI> |
| 38 | <LI>Looked services</LI> |
| 39 | </UL> |
| 40 | |
| 41 | |
| 42 | <P>More information on this pattern is available in this <SPAN class="nobr"><A href="http://www.osgi.org/wiki/uploads/Links/whiteboard.pdf" title="Visit page outside Confluence" rel="nofollow">document<SUP><IMG class="rendericon" src="../../cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN><BR> |
| 43 | Implementing a white board pattern could be complex as the extender needs to track these services dynamically. Indeed looked services can be highly dynamic; they can arrive, leave or be modified at runtime.<BR> |
| 44 | Several services specified in the OSGi specification use white board pattern such as the Device Access Manager.</P> |
| 45 | <H2><A name="WhiteBoardPatternHandler-Usingthehandler"></A>Using the handler</H2> |
| 46 | <P>First of all, you need to configure the component type to use the handler such as:</P> |
| 47 | <DIV class="code"><DIV class="codeContent"> |
| 48 | <PRE class="code-xml"><SPAN class="code-tag"><ipojo <SPAN class="code-keyword">xmlns:wbp</SPAN>=<SPAN class="code-quote">"org.apache.felix.ipojo.white-board-pattern"</SPAN>></SPAN> |
| 49 | <component |
| 50 | className=<SPAN class="code-quote">"org.apache.felix.ipojo.test.FooWhiteBoardPattern"</SPAN> |
| 51 | > |
| 52 | <wbp:wbp |
| 53 | filter=<SPAN class="code-quote">"(my.property=1)"</SPAN> |
| 54 | onArrival=<SPAN class="code-quote">"onArrival"</SPAN> |
| 55 | onDeparture=<SPAN class="code-quote">"onDeparture"</SPAN> |
| 56 | onModification=<SPAN class="code-quote">"onModification"</SPAN> |
| 57 | /> |
| 58 | |
| 59 | <SPAN class="code-tag"><provides/></SPAN> |
| 60 | <SPAN class="code-tag"></component></SPAN></PRE> |
| 61 | </DIV></DIV> |
| 62 | <P>Notice that, this handler is an external handler. So, it uses the "org.apache.felix.ipojo.white-board-patter" namespace.<BR> |
| 63 | Once described, you can implement your component. The methods specified methods will be called when a matching services arrives or leaves or are modified. The modification callback is optional. A matching service is detected by confronting the service reference against the specified filter.<BR> |
| 64 | The filter can target specific service interface (with the objectclass property) or property values.<BR> |
| 65 | In the previous example, these methods could be: </P> |
| 66 | <DIV class="code"><DIV class="codeContent"> |
| 67 | <PRE class="code-java"><SPAN class="code-keyword">public</SPAN> class FooWhiteBoardPattern <SPAN class="code-keyword">implements</SPAN> Observable { |
| 68 | List list = <SPAN class="code-keyword">new</SPAN> ArrayList(); |
| 69 | <SPAN class="code-object">int</SPAN> modifications = 0; |
| 70 | <SPAN class="code-keyword">public</SPAN> <SPAN class="code-keyword">synchronized</SPAN> void onArrival(ServiceReference ref) { |
| 71 | list.add(ref); |
| 72 | } |
| 73 | <SPAN class="code-keyword">public</SPAN> <SPAN class="code-keyword">synchronized</SPAN> void onDeparture(ServiceReference ref) { |
| 74 | list.remove(ref); |
| 75 | } |
| 76 | <SPAN class="code-keyword">public</SPAN> <SPAN class="code-keyword">synchronized</SPAN> void onModification(ServiceReference ref) { |
| 77 | modifications = modifications + 1; |
| 78 | } |
| 79 | <SPAN class="code-keyword">public</SPAN> <SPAN class="code-keyword">synchronized</SPAN> Map getObservations() { |
| 80 | Map map = <SPAN class="code-keyword">new</SPAN> HashMap(); |
| 81 | map.put(<SPAN class="code-quote">"list"</SPAN>, list); |
| 82 | map.put(<SPAN class="code-quote">"modifications"</SPAN>, <SPAN class="code-keyword">new</SPAN> <SPAN class="code-object">Integer</SPAN>(modifications)); |
| 83 | <SPAN class="code-keyword">return</SPAN> map; |
| 84 | }</PRE> |
| 85 | </DIV></DIV> |
| 86 | <P>All method received the arriving, leaving or modified service reference.</P> |
| 87 | <H2><A name="WhiteBoardPatternHandler-Configuration"></A>Configuration</H2> |
| 88 | <P>The handler has only three mandatory attributes:</P> |
| 89 | <UL> |
| 90 | <LI>Filter: filter use to discover matching filter.</LI> |
| 91 | <LI>onArrival: declaring the method to invoke when a matching service arrives</LI> |
| 92 | <LI>onDeparture: declaring the method to invoke when a matching service leaves</LI> |
| 93 | </UL> |
| 94 | |
| 95 | |
| 96 | <P>The onModification attribute is optional. This method is called when an injected service reference is modified but stills valid against the filter.</P> |
| 97 | <TABLE cellpadding="5" width="85%" cellspacing="8px" class="noteMacro" border="0" align="center"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="../../cwiki.apache.org/confluence/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD> |
| 98 | <P>The implementation will be notified of arrivals, modifications and departures, despite the instance is invalid. Indeed, the implementation must release all objects created from another bundle as soon it leaves.</P></TD></TR></TABLE> |
| 99 | <H2><A name="WhiteBoardPatternHandler-Download"></A>Download</H2> |
| 100 | <P>The handler is available on the <A href="download.html" title="Download">download</A> page.<BR> |
| 101 | Sources are available on the Felix trunk at the following location: <SPAN class="nobr"><A href="http://svn.apache.org/repos/asf/felix/trunk/ipojo/handler/whiteboard" title="Visit page outside Confluence" rel="nofollow">http://svn.apache.org/repos/asf/felix/trunk/ipojo/handler/whiteboard<SUP><IMG class="rendericon" src="../../cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN></P></TD> |
| 102 | <TD class="confluenceTd" valign="top" width="20%"> |
| 103 | <H6><A name="WhiteBoardPatternHandler-Overview"></A><B>Overview</B></H6> |
| 104 | <UL> |
| 105 | <LI><A href="apache-felix-ipojo.html" title="Apache Felix iPOJO">Home Page</A></LI> |
| 106 | <LI><A href="apache-felix-ipojo-feature-overview.html" title="Apache Felix iPOJO Feature Overview">iPOJO Feature Overview</A></LI> |
| 107 | <LI><A href="download.html" title="Download">Download & Install </A></LI> |
| 108 | </UL> |
| 109 | |
| 110 | |
| 111 | <H6><A name="WhiteBoardPatternHandler-GettingStarted"></A><B>Getting Started</B></H6> |
| 112 | <UL> |
| 113 | <LI><A href="ipojo-in-10-minutes.html" title="iPOJO in 10 minutes">iPOJO in 10 minutes</A></LI> |
| 114 | <LI><A href="ipojo-hello-word-maven-based-tutorial.html" title="iPOJO Hello Word (Maven-Based) tutorial">iPOJO Hello Word (Maven-Based) tutorial</A></LI> |
| 115 | <LI><A href="ipojo-advanced-tutorial.html" title="iPOJO Advanced Tutorial">iPOJO Advanced Tutorial</A></LI> |
| 116 | </UL> |
| 117 | |
| 118 | |
| 119 | <H6><A name="WhiteBoardPatternHandler-UserGuide"></A><B>User Guide</B></H6> |
| 120 | <UL> |
| 121 | <LI><A href="describing-components.html" title="Describing components">Describing components (handler list) </A></LI> |
| 122 | <LI><A href="how-to-use-ipojo-annotations.html" title="How to use iPOJO Annotations">How to use iPOJO Annotations</A></LI> |
| 123 | <LI><A href="using-xml-schemas.html" title="Using XML Schemas">Using XML Schemas</A></LI> |
| 124 | <LI><A href="ipojo-advanced-topics.html" title="iPOJO Advanced Topics">Advanced Topics</A></LI> |
| 125 | <LI><A href="ipojo-faq.html" title="iPOJO FAQ">FAQ</A></LI> |
| 126 | </UL> |
| 127 | |
| 128 | |
| 129 | <H6><A name="WhiteBoardPatternHandler-Tools"></A><B>Tools</B></H6> |
| 130 | <UL> |
| 131 | <LI><A href="ipojo-eclipse-plug-in.html" title="iPOJO Eclipse Plug-in">iPOJO Eclipse Plug-in</A></LI> |
| 132 | <LI><A href="ipojo-ant-task.html" title="iPOJO Ant Task">iPOJO Ant Task</A></LI> |
| 133 | <LI><A href="ipojo-maven-plug-in.html" title="iPOJO Maven Plug-in">iPOJO Maven Plug-in</A></LI> |
| 134 | <LI><A href="ipojo-concepts-overview.html" title="iPOJO Concepts Overview">iPOJO concepts overview</A></LI> |
| 135 | </UL> |
| 136 | |
| 137 | |
| 138 | <H6><A name="WhiteBoardPatternHandler-DeveloperGuide"></A><B>Developer Guide</B></H6> |
| 139 | <UL> |
| 140 | <LI>API: <SPAN class="nobr"><A href="http://people.apache.org/~clement/ipojo/api/0.8/" title="Visit page outside Confluence" rel="nofollow">0.8<SUP><IMG class="rendericon" src="../../cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI> |
| 141 | <LI><A href="how-to-write-your-own-handler.html" title="How to write your own handler">How to write your own handler</A></LI> |
| 142 | <LI><A href="how-to-use-ipojo-manipulation-metadata.html" title="How to use iPOJO Manipulation Metadata">How to use iPOJO Manipulation Metadata</A></LI> |
| 143 | </UL> |
| 144 | |
| 145 | |
| 146 | <H6><A name="WhiteBoardPatternHandler-Misc%26Contact"></A><B>Misc & Contact</B></H6> |
| 147 | <UL> |
| 148 | <LI><A href="apache-felix-ipojo-issuestracker.html" title="apache-felix-ipojo-issuestracker">Issues Tracker</A></LI> |
| 149 | <LI><A href="apache-felix-ipojo-supportedvms.html" title="apache-felix-ipojo-supportedVMs">Supported JVMs</A></LI> |
| 150 | <LI><A href="apache-felix-ipojo-supportedosgi.html" title="apache-felix-ipojo-supportedOSGi">Supported OSGi Implementations</A></LI> |
| 151 | <LI><A href="future-ideas.html" title="Future Ideas">Future Ideas</A></LI> |
| 152 | <LI><A href="contact.html" title="Contact">Contact</A></LI> |
| 153 | <LI><A href="related-works.html" title="Related Works">Related Works</A></LI> |
| 154 | <LI><A href="article-presentations.html" title="Article & Presentations">Article & Presentations</A></LI> |
| 155 | </UL> |
| 156 | |
| 157 | |
| 158 | <HR> |
| 159 | <DIV class="" align="center"> |
| 160 | <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="../../cwiki.apache.org/confluence/images/icons/feed-icon-32x32.png" align="absmiddle" border="0"><SUP><IMG class="rendericon" src="../../cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN></P></DIV></TD></TR></TBODY></TABLE> |
| 161 | </DIV> |
| 162 | </BODY> |
| 163 | |
| 164 | <!-- Mirrored Site: felix.apache.org. File: /site/white-board-pattern-handler.html. Date: Mon, 13 Oct 2008 06:52:59 GMT --> |
| 165 | </HTML> |