You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@felix.apache.org by cl...@apache.org on 2014/03/10 16:48:49 UTC
svn commit: r1575977 [4/6] - /felix/site/trunk/content/site/
Modified: felix/site/trunk/content/site/how-to-write-your-own-handler.html
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/site/how-to-write-your-own-handler.html?rev=1575977&r1=1575976&r2=1575977&view=diff
==============================================================================
--- felix/site/trunk/content/site/how-to-write-your-own-handler.html (original)
+++ felix/site/trunk/content/site/how-to-write-your-own-handler.html Mon Mar 10 15:48:48 2014
@@ -28,11 +28,11 @@
</DIV>
<DIV class="main">
<STYLE type="text/css">
- @import url(http://felix.apache.org/ipojo/site/superfish.css);
+ @import url(http://felix.apache.org/ipojo/site/superfish.css);
</STYLE>
<STYLE type="text/css">
- @import url(http://felix.apache.org/ipojo/site/style.css);
+ @import url(http://felix.apache.org/ipojo/site/style.css);
</STYLE>
<P>
@@ -50,22 +50,22 @@
<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/jquery-1.js"></SCRIPT>
<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/hoverIntent.js"></SCRIPT>
-<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/superfish.js"></SCRIPT>
-<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/supersubs.js"></SCRIPT>
+<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/superfish.js"></SCRIPT>
+<SCRIPT type="text/javascript" src="http://felix.apache.org/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 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>
<DIV class="main">
<DIV class="page-header">
@@ -77,7 +77,7 @@
<A href="" class="sf-with-ul">Overview<SPAN class="sf-sub-indicator"> »</SPAN><SPAN class="sf-sub-indicator"> »</SPAN></A>
<UL>
<LI>
- <A href="apache-felix-ipojo.html" title="Apache Felix iPOJO">Home</A>
+ <A href="apache-felix-ipojo.html" title="Apache Felix iPOJO">Home</A>
</LI>
<LI>
<A href="apache-felix-ipojo-why-choose-ipojo.html" title="apache-felix-ipojo-why-choose-ipojo">Why choose iPOJO</A>
@@ -89,15 +89,15 @@
<A href="apache-felix-ipojo-feature-overview.html" title="Apache Felix iPOJO Feature Overview">Features</A>
</LI>
</UL>
-</LI>
+</LI>
-<LI class="">
+<LI class="">
<!-- Menu download -->
<LI>
<A href="download.html" title="Download">Download </A>
</LI>
-<LI class="">
+<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>
@@ -145,7 +145,7 @@
</UL>
</LI> <!-- end of user guide -->
<!-- sub- menu : Dev Guide -->
- <LI>
+ <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" class="external-link" rel="nofollow">Javadoc</A></LI>
@@ -154,7 +154,7 @@
<LI><A href="dive-into-the-ipojo-manipulation-depths.html" title="Dive into the iPOJO Manipulation depths">Dive into the iPOJO Manipulation depths</A></LI>
</UL>
</LI> <!-- End of Dev guide -->
-</UL>
+</UL>
</LI> <!-- End of doc -->
<!-- Menu 4 : Tools -->
<LI class="">
@@ -167,13 +167,13 @@
<LI><A href="apache-felix-ipojo-online-manipulator.html" title="apache-felix-ipojo-online-manipulator">Online Manipulator</A></LI>
<LI><A href="ipojo-webconsole-plugin.html" title="iPOJO Webconsole Plugin">Webconsole plugin</A></LI>
<LI><A href="apache-felix-ipojo-junit4osgi.html" title="apache-felix-ipojo-junit4osgi">Junit4OSGi</A></LI>
-</UL>
-</LI><!-- End of tools -->
+</UL>
+</LI><!-- End of tools -->
<!-- Menu 5 : Support -->
<LI>
<A href="ipojo-support.html" title="ipojo-support">Support </A>
</LI>
-<!-- End of the menu 5 -->
+<!-- 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>
@@ -193,6 +193,24 @@
<DIV class="content">
+ <div style="
+ background-color: #fdf7f7;
+ border-color: #d9534f;
+ margin: 40px 0;
+ padding: 20px;
+ border-left: 5px solid #d9534f;">
+ <h4 style="margin-top: 0;
+ font-size: 18px;
+ margin-bottom: 5px;
+ margin-top: 0;
+ margin-bottom: 10px;
+ font-weight: 500;
+ line-height: 1.1;
+ color: inherit;">The iPOJO documentation has moved </h4>
+ <p style="margin-top: 0px; padding-top: 0px; margin-bottom: 0px;">
+ The new web site is <a href="http://ipojo.org">here</a>, update your bookmark.</p>
+ </div>
+
<H1><A name="Howtowriteyourownhandler-HowtowriteyouriPOJOHandler"></A>How to write your iPOJO Handler</H1>
<P><EM>This document explains how developers can use iPOJO extensibility mechanism to extend the (primitive) component instance container. Such extensibility mechanism does not require to modify the iPOJO core.</EM></P>
@@ -275,13 +293,13 @@ Then, you must know that a handler is a
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-xml">
<SPAN class="code-tag"><ipojo></SPAN>
- ...
- <handler className=<SPAN class="code-quote">"your.handler.class"</SPAN>
- name=<SPAN class="code-quote">"HandlerName"</SPAN>
+ ...
+ <handler className=<SPAN class="code-quote">"your.handler.class"</SPAN>
+ name=<SPAN class="code-quote">"HandlerName"</SPAN>
namespace=<SPAN class="code-quote">"the.namespace.of.your.handler"</SPAN>>
...
- <SPAN class="code-tag"><provides interface=<SPAN class="code-quote">"a.provided.Service"</SPAN>></SPAN>
- <property field=<SPAN class="code-quote">"a_field"</SPAN>
+ <SPAN class="code-tag"><provides interface=<SPAN class="code-quote">"a.provided.Service"</SPAN>></SPAN>
+ <property field=<SPAN class="code-quote">"a_field"</SPAN>
name=<SPAN class="code-quote">"a.property"</SPAN> value=<SPAN class="code-quote">"a.value"</SPAN>/>
<SPAN class="code-tag"></provides></SPAN>
...
@@ -328,7 +346,7 @@ Then, you must know that a handler is a
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
- Element[] handlerConfig =
+ Element[] handlerConfig =
componentMetadata.getElements(<SPAN class="code-quote">"HandlerName"</SPAN>,
<SPAN class="code-quote">"the.namespace.of.your.handler"</SPAN>);
</PRE>
@@ -393,8 +411,8 @@ Then, you must know that a handler is a
<SPAN class="code-tag"><component className=<SPAN class="code-quote">"your.component.class"</SPAN>></SPAN>
...
<SPAN class="code-tag"><your-shortcut:HandlerName param1=<SPAN class="code-quote">"value1"</SPAN> ...></SPAN>
- <!--
- Configuration of your handler for
+ <!--
+ Configuration of your handler for
this component type
-->
<SPAN class="code-tag"></your-shortcut{noformat}:HandlerName></SPAN>
@@ -421,12 +439,12 @@ Then, you must know that a handler is a
<PRE class="code-xml">
<SPAN class="code-tag"><ipojo></SPAN>
<SPAN class="code-tag"><SPAN class="code-comment"><!-- Declare the handler --></SPAN></SPAN>
- <handler
- classname=<SPAN class="code-quote">"org.apache.felix.ipojo.handler.log.LogHandler"</SPAN>
- name=<SPAN class="code-quote">"log"</SPAN>
+ <handler
+ classname=<SPAN class="code-quote">"org.apache.felix.ipojo.handler.log.LogHandler"</SPAN>
+ name=<SPAN class="code-quote">"log"</SPAN>
namespace=<SPAN class="code-quote">"org.apache.felix.ipojo.log.handler.LogHandler"</SPAN> >
<SPAN class="code-tag"><SPAN class="code-comment"><!-- The log service dependency --></SPAN></SPAN>
- <requires field=<SPAN class="code-quote">"m_log"</SPAN> optional=<SPAN class="code-quote">"true"</SPAN>
+ <requires field=<SPAN class="code-quote">"m_log"</SPAN> optional=<SPAN class="code-quote">"true"</SPAN>
default-implementation=
<SPAN class="code-quote">"org.apache.felix.ipojo.handler.log.PrimitiveLogService"</SPAN>/>
<SPAN class="code-tag"></handler></SPAN>
@@ -452,21 +470,21 @@ The handler needs to be notified when co
<PRE class="code-java">
<SPAN class="code-keyword">public</SPAN> void initializeComponentFactory(ComponentTypeDescription typeDesc,
Element metadata)
- <SPAN class="code-keyword">throws</SPAN> ConfigurationException {
-
- <SPAN class="code-comment">// Get all Namespace:log element from the metadata
-</SPAN> Element[] log_elements = metadata.getElements(<SPAN class="code-quote">"log"</SPAN>, NAMESPACE);
+ <SPAN class="code-keyword">throws</SPAN> ConfigurationException {
+
+ <SPAN class="code-comment">// Get all Namespace:log element from the metadata
+</SPAN> Element[] log_elements = metadata.getElements(<SPAN class="code-quote">"log"</SPAN>, NAMESPACE);
<SPAN class="code-keyword">if</SPAN> (log elements.length == 1) { <SPAN class="code-comment">// There must be exactly one configuration element.
-</SPAN> Element log_element = log_elements[0]; <SPAN class="code-comment">// There must be a level attribute
-</SPAN> <SPAN class="code-comment">// in the configuration element
-</SPAN> <SPAN class="code-keyword">if</SPAN>(log_element.containsAttribute(<SPAN class="code-quote">"level"</SPAN>)) {
- <SPAN class="code-object">String</SPAN> level = log_element.getAttribute(<SPAN class="code-quote">"level"</SPAN>); <SPAN class="code-comment">// Check the value of the
+</SPAN> Element log_element = log_elements[0]; <SPAN class="code-comment">// There must be a level attribute
+</SPAN> <SPAN class="code-comment">// in the configuration element
+</SPAN> <SPAN class="code-keyword">if</SPAN>(log_element.containsAttribute(<SPAN class="code-quote">"level"</SPAN>)) {
+ <SPAN class="code-object">String</SPAN> level = log_element.getAttribute(<SPAN class="code-quote">"level"</SPAN>); <SPAN class="code-comment">// Check the value of the
</SPAN> <SPAN class="code-comment">// level attribute
</SPAN> <SPAN class="code-keyword">if</SPAN> (level == <SPAN class="code-keyword">null</SPAN>) {
<SPAN class="code-keyword">throw</SPAN> <SPAN class="code-keyword">new</SPAN> ConfigurationException(<SPAN class="code-quote">"No level attribute found in the configuration"</SPAN>);
}
- <SPAN class="code-keyword">if</SPAN> (!level.equalsIgnoreCase(<SPAN class="code-quote">"info"</SPAN>) &&
- !level.equalsIgnoreCase(<SPAN class="code-quote">"warning"</SPAN>) &&
+ <SPAN class="code-keyword">if</SPAN> (!level.equalsIgnoreCase(<SPAN class="code-quote">"info"</SPAN>) &&
+ !level.equalsIgnoreCase(<SPAN class="code-quote">"warning"</SPAN>) &&
!level.equalsIgnoreCase(<SPAN class="code-quote">"error"</SPAN>)) {
<SPAN class="code-keyword">throw</SPAN> <SPAN class="code-keyword">new</SPAN> ConfigurationException(<SPAN class="code-quote">"Bad log level specified, "</SPAN>
+ <SPAN class="code-quote">"accepted values are : info, warning, error"</SPAN>);
@@ -483,23 +501,23 @@ The handler needs to be notified when co
<PRE class="code-java">
<SPAN class="code-keyword">public</SPAN> void configure(Element metadata, Dictionary config)
<SPAN class="code-keyword">throws</SPAN> ConfigurationException {
-
+
<SPAN class="code-comment">// Get the configuration element
</SPAN> Element log_element = metadata.getElements(<SPAN class="code-quote">"log"</SPAN>, NAMESPACE)[0];
-
+
<SPAN class="code-comment">// Get the level attribute's value
</SPAN> <SPAN class="code-object">String</SPAN> level = log_element.getAttribute(<SPAN class="code-quote">"level"</SPAN>);
-
+
<SPAN class="code-comment">// Extract the log level
-</SPAN> <SPAN class="code-keyword">if</SPAN>(level.equalsIgnoreCase(<SPAN class="code-quote">"info"</SPAN>)) {
+</SPAN> <SPAN class="code-keyword">if</SPAN>(level.equalsIgnoreCase(<SPAN class="code-quote">"info"</SPAN>)) {
m_level = LogService.LOG_INFO;
- } <SPAN class="code-keyword">else</SPAN> <SPAN class="code-keyword">if</SPAN> (level.equalsIgnoreCase(<SPAN class="code-quote">"warning"</SPAN>)) {
+ } <SPAN class="code-keyword">else</SPAN> <SPAN class="code-keyword">if</SPAN> (level.equalsIgnoreCase(<SPAN class="code-quote">"warning"</SPAN>)) {
m_level = LogService.LOG_WARNING;
- } <SPAN class="code-keyword">else</SPAN> <SPAN class="code-keyword">if</SPAN> (level.equalsIgnoreCase(<SPAN class="code-quote">"error"</SPAN>)) {
+ } <SPAN class="code-keyword">else</SPAN> <SPAN class="code-keyword">if</SPAN> (level.equalsIgnoreCase(<SPAN class="code-quote">"error"</SPAN>)) {
m_level = LogService.LOG_ERROR;
}
-
- m_manager = getInstanceManager();
+
+ m_manager = getInstanceManager();
m_context = m_manager.getContext();
}
</PRE>
@@ -511,12 +529,12 @@ The handler needs to be notified when co
<PRE class="code-java">
<SPAN class="code-keyword">public</SPAN> void stateChanged(<SPAN class="code-object">int</SPAN> state) {
<SPAN class="code-comment">// Log the state changed events
-</SPAN> <SPAN class="code-keyword">if</SPAN> (state == InstanceManager.VALID) {
- m_log.log(m_level, <SPAN class="code-quote">"The component instance "</SPAN>
- + m_manager.getInstanceName() + <SPAN class="code-quote">" becomes VALID"</SPAN>);
- } <SPAN class="code-keyword">else</SPAN> <SPAN class="code-keyword">if</SPAN> (state == InstanceManager.INVALID) {
- m_log.log(m_level, <SPAN class="code-quote">"The component instance "</SPAN>
- + m_manager.getInstanceName() + <SPAN class="code-quote">" becomes INVALID"</SPAN>);
+</SPAN> <SPAN class="code-keyword">if</SPAN> (state == InstanceManager.VALID) {
+ m_log.log(m_level, <SPAN class="code-quote">"The component instance "</SPAN>
+ + m_manager.getInstanceName() + <SPAN class="code-quote">" becomes VALID"</SPAN>);
+ } <SPAN class="code-keyword">else</SPAN> <SPAN class="code-keyword">if</SPAN> (state == InstanceManager.INVALID) {
+ m_log.log(m_level, <SPAN class="code-quote">"The component instance "</SPAN>
+ + m_manager.getInstanceName() + <SPAN class="code-quote">" becomes INVALID"</SPAN>);
}
}
</PRE>
@@ -530,7 +548,7 @@ The handler needs to be notified when co
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-xml">
<SPAN class="code-tag"><ipojo <SPAN class="code-keyword">xmlns:log</SPAN>=<SPAN class="code-quote">"org.apache.felix.ipojo.log.handler.LogHandler"</SPAN>></SPAN>
-
+
<SPAN class="code-tag"><SPAN class="code-comment"><!-- Declare a component using the LogHandler --></SPAN></SPAN>
<SPAN class="code-tag"><component classname=<SPAN class="code-quote">"..."</SPAN>></SPAN>
...
@@ -583,53 +601,53 @@ The handler needs to be notified when co
<SPAN class="code-keyword">throws</SPAN> ConfigurationException {
<SPAN class="code-comment">// Parse metadata to get <properties file=<SPAN class="code-quote">"$file"</SPAN>/>
</SPAN> <SPAN class="code-comment">// Get all example.handler.properties:properties element
-</SPAN> Element[] elem = metadata.getElements(<SPAN class="code-quote">"properties"</SPAN>, NAMESPACE).
+</SPAN> Element[] elem = metadata.getElements(<SPAN class="code-quote">"properties"</SPAN>, NAMESPACE).
<SPAN class="code-keyword">switch</SPAN> (elem.length) {
- <SPAN class="code-keyword">case</SPAN> 0: <SPAN class="code-comment">// No matching element in metadata, <SPAN class="code-keyword">throw</SPAN> a configuration error.
+ <SPAN class="code-keyword">case</SPAN> 0: <SPAN class="code-comment">// No matching element in metadata, <SPAN class="code-keyword">throw</SPAN> a configuration error.
</SPAN> <SPAN class="code-keyword">throw</SPAN> <SPAN class="code-keyword">new</SPAN> ConfigurationException(<SPAN class="code-quote">"No properties found"</SPAN>);
<SPAN class="code-keyword">case</SPAN> 1: <SPAN class="code-comment">// One 'properties' found, get attributes
-</SPAN> m_file = elem[0].getAttribute(<SPAN class="code-quote">"file"</SPAN>);
- <SPAN class="code-keyword">if</SPAN> (m_file == <SPAN class="code-keyword">null</SPAN>) { <SPAN class="code-comment">// <SPAN class="code-keyword">if</SPAN> file is <SPAN class="code-keyword">null</SPAN>, <SPAN class="code-keyword">throw</SPAN> a configuration error.
-</SPAN> <SPAN class="code-keyword">throw</SPAN> <SPAN class="code-keyword">new</SPAN> ConfigurationException(<SPAN class="code-quote">"Malformed properties "</SPAN>
+</SPAN> m_file = elem[0].getAttribute(<SPAN class="code-quote">"file"</SPAN>);
+ <SPAN class="code-keyword">if</SPAN> (m_file == <SPAN class="code-keyword">null</SPAN>) { <SPAN class="code-comment">// <SPAN class="code-keyword">if</SPAN> file is <SPAN class="code-keyword">null</SPAN>, <SPAN class="code-keyword">throw</SPAN> a configuration error.
+</SPAN> <SPAN class="code-keyword">throw</SPAN> <SPAN class="code-keyword">new</SPAN> ConfigurationException(<SPAN class="code-quote">"Malformed properties "</SPAN>
+ <SPAN class="code-quote">" element : file attribute must be set"</SPAN>);
- }
+ }
<SPAN class="code-keyword">break</SPAN>;
- <SPAN class="code-keyword">default</SPAN>: <SPAN class="code-comment">// To simplify we handle only one properties element.
-</SPAN> <SPAN class="code-keyword">throw</SPAN> <SPAN class="code-keyword">new</SPAN> ConfigurationException(<SPAN class="code-quote">"Only one properties element is supported"</SPAN>);
- }
- <SPAN class="code-comment">// Look <SPAN class="code-keyword">if</SPAN> the instance configuration overrides file location :
-</SPAN> <SPAN class="code-object">String</SPAN> instanceFile = (<SPAN class="code-object">String</SPAN>) configuration.get(<SPAN class="code-quote">"properties.file"</SPAN>);
+ <SPAN class="code-keyword">default</SPAN>: <SPAN class="code-comment">// To simplify we handle only one properties element.
+</SPAN> <SPAN class="code-keyword">throw</SPAN> <SPAN class="code-keyword">new</SPAN> ConfigurationException(<SPAN class="code-quote">"Only one properties element is supported"</SPAN>);
+ }
+ <SPAN class="code-comment">// Look <SPAN class="code-keyword">if</SPAN> the instance configuration overrides file location :
+</SPAN> <SPAN class="code-object">String</SPAN> instanceFile = (<SPAN class="code-object">String</SPAN>) configuration.get(<SPAN class="code-quote">"properties.file"</SPAN>);
<SPAN class="code-keyword">if</SPAN> (instanceFile != <SPAN class="code-keyword">null</SPAN>) {
- m_file = instanceFile;
+ m_file = instanceFile;
}
<SPAN class="code-comment">// Load properties
</SPAN> <SPAN class="code-keyword">try</SPAN>{
loadProperties();
} <SPAN class="code-keyword">catch</SPAN>(IOException e) {
- <SPAN class="code-keyword">throw</SPAN> <SPAN class="code-keyword">new</SPAN> ConfigurationException(<SPAN class="code-quote">"Error when reading the "</SPAN>
- + m_file + <SPAN class="code-quote">" file : "</SPAN> + e.getMessage());
+ <SPAN class="code-keyword">throw</SPAN> <SPAN class="code-keyword">new</SPAN> ConfigurationException(<SPAN class="code-quote">"Error when reading the "</SPAN>
+ + m_file + <SPAN class="code-quote">" file : "</SPAN> + e.getMessage());
}
- <SPAN class="code-comment">// Register fields
-</SPAN> <SPAN class="code-comment">// By convention, properties file entries are field name,
+ <SPAN class="code-comment">// Register fields
+</SPAN> <SPAN class="code-comment">// By convention, properties file entries are field name,
</SPAN> <SPAN class="code-comment">// so looks <SPAN class="code-keyword">for</SPAN> each property to get field list.
</SPAN> <SPAN class="code-comment">//First get the Pojo Metadata metadata:
</SPAN> PojoMetadata pojoMeta = getPojoMetadata();
Enumeration e = m_properties.keys();
- <SPAN class="code-keyword">while</SPAN>(e.hasMoreElements()) {
+ <SPAN class="code-keyword">while</SPAN>(e.hasMoreElements()) {
<SPAN class="code-object">String</SPAN> field = (<SPAN class="code-object">String</SPAN>) e.nextElement();
FieldMetadata fm = pojoMeta.getField(field);
<SPAN class="code-keyword">if</SPAN>(fm==<SPAN class="code-keyword">null</SPAN>){
<SPAN class="code-comment">//The field does not exist
-</SPAN> <SPAN class="code-keyword">throw</SPAN> <SPAN class="code-keyword">new</SPAN> ConfigurationException(<SPAN class="code-quote">"The field "</SPAN> + field +
+</SPAN> <SPAN class="code-keyword">throw</SPAN> <SPAN class="code-keyword">new</SPAN> ConfigurationException(<SPAN class="code-quote">"The field "</SPAN> + field +
<SPAN class="code-quote">" is declared in the properties file but does not "</SPAN> +
<SPAN class="code-quote">" exist in the pojo"</SPAN>);
}
- <SPAN class="code-comment">// Then check that the field is a <SPAN class="code-object">String</SPAN> field
-</SPAN> <SPAN class="code-keyword">if</SPAN> (!fm.getFieldType().equals(<SPAN class="code-object">String</SPAN>.class.getName())) {
- <SPAN class="code-keyword">throw</SPAN> <SPAN class="code-keyword">new</SPAN> ConfigurationException(<SPAN class="code-quote">"The field "</SPAN> + field +
- <SPAN class="code-quote">" exists in the pojo, but is not a <SPAN class="code-object">String</SPAN>"</SPAN>);
- }
- <SPAN class="code-comment">// All checks are ok, register the interceptor.
+ <SPAN class="code-comment">// Then check that the field is a <SPAN class="code-object">String</SPAN> field
+</SPAN> <SPAN class="code-keyword">if</SPAN> (!fm.getFieldType().equals(<SPAN class="code-object">String</SPAN>.class.getName())) {
+ <SPAN class="code-keyword">throw</SPAN> <SPAN class="code-keyword">new</SPAN> ConfigurationException(<SPAN class="code-quote">"The field "</SPAN> + field +
+ <SPAN class="code-quote">" exists in the pojo, but is not a <SPAN class="code-object">String</SPAN>"</SPAN>);
+ }
+ <SPAN class="code-comment">// All checks are ok, register the interceptor.
</SPAN> getInstanceManager().register(fm, <SPAN class="code-keyword">this</SPAN>);
}
}
@@ -648,13 +666,13 @@ The handler needs to be notified when co
<P>The stop method stores properties inside the properties file.</P>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
-<SPAN class="code-keyword">public</SPAN> void stop() {
- <SPAN class="code-keyword">try</SPAN> {
+<SPAN class="code-keyword">public</SPAN> void stop() {
+ <SPAN class="code-keyword">try</SPAN> {
saveProperties();
- } <SPAN class="code-keyword">catch</SPAN> (IOException e) {
- <SPAN class="code-comment">// Log an error message by using the iPOJO logger
-</SPAN> error(<SPAN class="code-quote">"Cannot read the file : "</SPAN> + m_file, e);
- }
+ } <SPAN class="code-keyword">catch</SPAN> (IOException e) {
+ <SPAN class="code-comment">// Log an error message by using the iPOJO logger
+</SPAN> error(<SPAN class="code-quote">"Cannot read the file : "</SPAN> + m_file, e);
+ }
m_properties = <SPAN class="code-keyword">null</SPAN>;
}
</PRE>
@@ -664,17 +682,17 @@ The handler needs to be notified when co
<P>The onGet method is called when the POJO need a field value. When called, the method needs to return the stored value.The onSet method is called when the POJO modifies a field value. If the new value if null, the handler will remove this properties from the property list.</P>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
-<SPAN class="code-keyword">public</SPAN> <SPAN class="code-object">Object</SPAN> onGet(<SPAN class="code-object">Object</SPAN> pojo, <SPAN class="code-object">String</SPAN> field, <SPAN class="code-object">Object</SPAN> o) {
+<SPAN class="code-keyword">public</SPAN> <SPAN class="code-object">Object</SPAN> onGet(<SPAN class="code-object">Object</SPAN> pojo, <SPAN class="code-object">String</SPAN> field, <SPAN class="code-object">Object</SPAN> o) {
<SPAN class="code-comment">// When the pojo requires a value <SPAN class="code-keyword">for</SPAN> a managed field,
-</SPAN> <SPAN class="code-comment">// <SPAN class="code-keyword">this</SPAN> method is invoked.
-</SPAN> <SPAN class="code-comment">// So, we have just to <SPAN class="code-keyword">return</SPAN> the stored value.
+</SPAN> <SPAN class="code-comment">// <SPAN class="code-keyword">this</SPAN> method is invoked.
+</SPAN> <SPAN class="code-comment">// So, we have just to <SPAN class="code-keyword">return</SPAN> the stored value.
</SPAN> <SPAN class="code-keyword">return</SPAN> m_properties.get(field);
}
-<SPAN class="code-keyword">public</SPAN> void onSet(<SPAN class="code-object">Object</SPAN> pojo, <SPAN class="code-object">String</SPAN> field, <SPAN class="code-object">Object</SPAN> newvalue) {
- <SPAN class="code-comment">// When the pojo set a value to a managed field,
-</SPAN> <SPAN class="code-comment">// <SPAN class="code-keyword">this</SPAN> method is invoked.
-</SPAN> <SPAN class="code-comment">// So, we update the stored value.
+<SPAN class="code-keyword">public</SPAN> void onSet(<SPAN class="code-object">Object</SPAN> pojo, <SPAN class="code-object">String</SPAN> field, <SPAN class="code-object">Object</SPAN> newvalue) {
+ <SPAN class="code-comment">// When the pojo set a value to a managed field,
+</SPAN> <SPAN class="code-comment">// <SPAN class="code-keyword">this</SPAN> method is invoked.
+</SPAN> <SPAN class="code-comment">// So, we update the stored value.
</SPAN> m_properties.put(field, newvalue);
}
</PRE>
@@ -701,30 +719,30 @@ To do so, reconfigurable handlers must o
By default, only the handler's name and validity are displayed in component instance's description (informations displayed by the (<TT>arch -instance an.instance.name</TT> command). The standard way to add description to your handler is shown hereafter :</P>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
-<SPAN class="code-keyword">public</SPAN> class YourHandler <SPAN class="code-keyword">extends</SPAN> PrimitiveHandler {
- ...
- <SPAN class="code-comment">// Method returning the handler description.
-</SPAN> <SPAN class="code-keyword">public</SPAN> HandlerDescription getDescription() {
+<SPAN class="code-keyword">public</SPAN> class YourHandler <SPAN class="code-keyword">extends</SPAN> PrimitiveHandler {
+ ...
+ <SPAN class="code-comment">// Method returning the handler description.
+</SPAN> <SPAN class="code-keyword">public</SPAN> HandlerDescription getDescription() {
<SPAN class="code-keyword">return</SPAN> <SPAN class="code-keyword">new</SPAN> YourHandlerDescription(<SPAN class="code-keyword">this</SPAN>);
}
-
+
...
-
- <SPAN class="code-keyword">private</SPAN> class YourHandlerDescription <SPAN class="code-keyword">extends</SPAN> HandlerDescription {
- <SPAN class="code-keyword">public</SPAN> Description(PrimitiveHandler h) { <SPAN class="code-keyword">super</SPAN>(h); }
-
- <SPAN class="code-comment">// Method returning the custom description of <SPAN class="code-keyword">this</SPAN> handler.
-</SPAN> <SPAN class="code-keyword">public</SPAN> Element getHandlerInfo() {
- <SPAN class="code-comment">// Needed to get the root description element.
-</SPAN> Element elem = <SPAN class="code-keyword">super</SPAN>.getHandlerInfo();
- <SPAN class="code-comment">// Add here attributes and sub-elements
-</SPAN> <SPAN class="code-comment">// into the root description element.
-</SPAN> <SPAN class="code-comment">// Example : elem.addAttribute(<SPAN class="code-keyword">new</SPAN> Attribute(<SPAN class="code-quote">"param"</SPAN>, <SPAN class="code-quote">"value"</SPAN>));
-</SPAN> Element subElement = <SPAN class="code-keyword">new</SPAN> Element(<SPAN class="code-quote">"subElement"</SPAN>, "");
- subElement.addAttribute(<SPAN class="code-keyword">new</SPAN> Attribute(<SPAN class="code-quote">"subParam"</SPAN>, <SPAN class="code-quote">"subValue"</SPAN>));
+
+ <SPAN class="code-keyword">private</SPAN> class YourHandlerDescription <SPAN class="code-keyword">extends</SPAN> HandlerDescription {
+ <SPAN class="code-keyword">public</SPAN> Description(PrimitiveHandler h) { <SPAN class="code-keyword">super</SPAN>(h); }
+
+ <SPAN class="code-comment">// Method returning the custom description of <SPAN class="code-keyword">this</SPAN> handler.
+</SPAN> <SPAN class="code-keyword">public</SPAN> Element getHandlerInfo() {
+ <SPAN class="code-comment">// Needed to get the root description element.
+</SPAN> Element elem = <SPAN class="code-keyword">super</SPAN>.getHandlerInfo();
+ <SPAN class="code-comment">// Add here attributes and sub-elements
+</SPAN> <SPAN class="code-comment">// into the root description element.
+</SPAN> <SPAN class="code-comment">// Example : elem.addAttribute(<SPAN class="code-keyword">new</SPAN> Attribute(<SPAN class="code-quote">"param"</SPAN>, <SPAN class="code-quote">"value"</SPAN>));
+</SPAN> Element subElement = <SPAN class="code-keyword">new</SPAN> Element(<SPAN class="code-quote">"subElement"</SPAN>, "");
+ subElement.addAttribute(<SPAN class="code-keyword">new</SPAN> Attribute(<SPAN class="code-quote">"subParam"</SPAN>, <SPAN class="code-quote">"subValue"</SPAN>));
elem.addElement(subElement);
...
- <SPAN class="code-keyword">return</SPAN> elem;
+ <SPAN class="code-keyword">return</SPAN> elem;
}
}
}
@@ -752,7 +770,7 @@ Then, 'scalar' annotation attributes are
@Target(ElementType.TYPE)
<SPAN class="code-keyword">public</SPAN> @<SPAN class="code-keyword">interface</SPAN> Properties {
-
+
<SPAN class="code-object">String</SPAN> file();
}
@@ -790,13 +808,13 @@ Then, 'scalar' annotation attributes are
@Property(name=<SPAN class="code-quote">"prop"</SPAN>, notification=<SPAN class="code-keyword">true</SPAN>, rights=<SPAN class="code-quote">"w"</SPAN>) <SPAN class="code-comment">//External handler annotation
</SPAN> <SPAN class="code-object">String</SPAN> m_foo;
-
+
@Method(description=<SPAN class="code-quote">"set the foo prop"</SPAN>) <SPAN class="code-comment">//External handler annotation
</SPAN> <SPAN class="code-keyword">public</SPAN> void setFoo(<SPAN class="code-object">String</SPAN> mes) {
<SPAN class="code-object">System</SPAN>.out.println(<SPAN class="code-quote">"Set foo to "</SPAN> + mes);
m_foo = mes;
}
-
+
@Method(description=<SPAN class="code-quote">"get the foo prop"</SPAN>) <SPAN class="code-comment">//External handler annotation
</SPAN> <SPAN class="code-keyword">public</SPAN> <SPAN class="code-object">String</SPAN> getFoo() {
<SPAN class="code-keyword">return</SPAN> m_foo;
@@ -807,16 +825,16 @@ Then, 'scalar' annotation attributes are
<P>will be translated to:</P>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<DIV class="error"><SPAN class="error">Unable to find source-code formatter for language: shell.</SPAN> Available languages are: actionscript, html, java, javascript, none, sql, xhtml, xml</DIV><PRE>
-component {
+component {
$classname=<SPAN class="code-quote">"org.apache.felix.ipojo.test.scenarios.component.jmx.JMXSimple"</SPAN>
$<SPAN class="code-keyword">public</SPAN>=<SPAN class="code-quote">"<SPAN class="code-keyword">true</SPAN>"</SPAN> $name=<SPAN class="code-quote">"org.apache.felix.ipojo.test.scenarios.component.jmx.JMXSimple"</SPAN>
- org.apache.felix.ipojo.handlers.jmx:config {
- $usesmosgi=<SPAN class="code-quote">"<SPAN class="code-keyword">false</SPAN>"</SPAN> $domain=<SPAN class="code-quote">"my-domain"</SPAN>
- org.apache.felix.ipojo.handlers.jmx:property {
+ org.apache.felix.ipojo.handlers.jmx:config {
+ $usesmosgi=<SPAN class="code-quote">"<SPAN class="code-keyword">false</SPAN>"</SPAN> $domain=<SPAN class="code-quote">"my-domain"</SPAN>
+ org.apache.felix.ipojo.handlers.jmx:property {
$rights=<SPAN class="code-quote">"w"</SPAN> $notification=<SPAN class="code-quote">"<SPAN class="code-keyword">true</SPAN>"</SPAN> $field=<SPAN class="code-quote">"m_foo"</SPAN> $name=<SPAN class="code-quote">"prop"</SPAN> }
- org.apache.felix.ipojo.handlers.jmx:method {
+ org.apache.felix.ipojo.handlers.jmx:method {
$description=<SPAN class="code-quote">"set the foo prop"</SPAN> $method=<SPAN class="code-quote">"setFoo"</SPAN> }
- org.apache.felix.ipojo.handlers.jmx:method {
+ org.apache.felix.ipojo.handlers.jmx:method {
$description=<SPAN class="code-quote">"get the foo prop"</SPAN> $method=<SPAN class="code-quote">"getFoo"</SPAN> }
}
}
Modified: felix/site/trunk/content/site/ipojo-advanced-topics.html
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/site/ipojo-advanced-topics.html?rev=1575977&r1=1575976&r2=1575977&view=diff
==============================================================================
--- felix/site/trunk/content/site/ipojo-advanced-topics.html (original)
+++ felix/site/trunk/content/site/ipojo-advanced-topics.html Mon Mar 10 15:48:48 2014
@@ -28,11 +28,11 @@
</DIV>
<DIV class="main">
<STYLE type="text/css">
- @import url(http://felix.apache.org/ipojo/site/superfish.css);
+ @import url(http://felix.apache.org/ipojo/site/superfish.css);
</STYLE>
<STYLE type="text/css">
- @import url(http://felix.apache.org/ipojo/site/style.css);
+ @import url(http://felix.apache.org/ipojo/site/style.css);
</STYLE>
<P>
@@ -50,22 +50,22 @@
<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/jquery-1.js"></SCRIPT>
<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/hoverIntent.js"></SCRIPT>
-<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/superfish.js"></SCRIPT>
-<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/supersubs.js"></SCRIPT>
+<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/superfish.js"></SCRIPT>
+<SCRIPT type="text/javascript" src="http://felix.apache.org/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 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>
<DIV class="main">
<DIV class="page-header">
@@ -77,7 +77,7 @@
<A href="" class="sf-with-ul">Overview<SPAN class="sf-sub-indicator"> »</SPAN><SPAN class="sf-sub-indicator"> »</SPAN></A>
<UL>
<LI>
- <A href="apache-felix-ipojo.html" title="Apache Felix iPOJO">Home</A>
+ <A href="apache-felix-ipojo.html" title="Apache Felix iPOJO">Home</A>
</LI>
<LI>
<A href="apache-felix-ipojo-why-choose-ipojo.html" title="apache-felix-ipojo-why-choose-ipojo">Why choose iPOJO</A>
@@ -89,15 +89,15 @@
<A href="apache-felix-ipojo-feature-overview.html" title="Apache Felix iPOJO Feature Overview">Features</A>
</LI>
</UL>
-</LI>
+</LI>
-<LI class="">
+<LI class="">
<!-- Menu download -->
<LI>
<A href="download.html" title="Download">Download </A>
</LI>
-<LI class="">
+<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>
@@ -145,7 +145,7 @@
</UL>
</LI> <!-- end of user guide -->
<!-- sub- menu : Dev Guide -->
- <LI>
+ <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" class="external-link" rel="nofollow">Javadoc</A></LI>
@@ -154,7 +154,7 @@
<LI><A href="dive-into-the-ipojo-manipulation-depths.html" title="Dive into the iPOJO Manipulation depths">Dive into the iPOJO Manipulation depths</A></LI>
</UL>
</LI> <!-- End of Dev guide -->
-</UL>
+</UL>
</LI> <!-- End of doc -->
<!-- Menu 4 : Tools -->
<LI class="">
@@ -167,13 +167,13 @@
<LI><A href="apache-felix-ipojo-online-manipulator.html" title="apache-felix-ipojo-online-manipulator">Online Manipulator</A></LI>
<LI><A href="ipojo-webconsole-plugin.html" title="iPOJO Webconsole Plugin">Webconsole plugin</A></LI>
<LI><A href="apache-felix-ipojo-junit4osgi.html" title="apache-felix-ipojo-junit4osgi">Junit4OSGi</A></LI>
-</UL>
-</LI><!-- End of tools -->
+</UL>
+</LI><!-- End of tools -->
<!-- Menu 5 : Support -->
<LI>
<A href="ipojo-support.html" title="ipojo-support">Support </A>
</LI>
-<!-- End of the menu 5 -->
+<!-- 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>
@@ -193,6 +193,24 @@
<DIV class="content">
+ <div style="
+ background-color: #fdf7f7;
+ border-color: #d9534f;
+ margin: 40px 0;
+ padding: 20px;
+ border-left: 5px solid #d9534f;">
+ <h4 style="margin-top: 0;
+ font-size: 18px;
+ margin-bottom: 5px;
+ margin-top: 0;
+ margin-bottom: 10px;
+ font-weight: 500;
+ line-height: 1.1;
+ color: inherit;">The iPOJO documentation has moved </h4>
+ <p style="margin-top: 0px; padding-top: 0px; margin-bottom: 0px;">
+ The new web site is <a href="http://ipojo.org">here</a>, update your bookmark.</p>
+ </div>
+
<H1><A name="iPOJOAdvancedTopics-AdvancedTopics"></A>Advanced Topics</H1>
<P><EM>This page presents some advanced features.</EM></P>
Modified: felix/site/trunk/content/site/ipojo-advanced-tutorial.html
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/site/ipojo-advanced-tutorial.html?rev=1575977&r1=1575976&r2=1575977&view=diff
==============================================================================
--- felix/site/trunk/content/site/ipojo-advanced-tutorial.html (original)
+++ felix/site/trunk/content/site/ipojo-advanced-tutorial.html Mon Mar 10 15:48:48 2014
@@ -28,11 +28,11 @@
</DIV>
<DIV class="main">
<STYLE type="text/css">
- @import url(http://felix.apache.org/ipojo/site/superfish.css);
+ @import url(http://felix.apache.org/ipojo/site/superfish.css);
</STYLE>
<STYLE type="text/css">
- @import url(http://felix.apache.org/ipojo/site/style.css);
+ @import url(http://felix.apache.org/ipojo/site/style.css);
</STYLE>
<P>
@@ -50,22 +50,22 @@
<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/jquery-1.js"></SCRIPT>
<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/hoverIntent.js"></SCRIPT>
-<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/superfish.js"></SCRIPT>
-<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/supersubs.js"></SCRIPT>
+<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/superfish.js"></SCRIPT>
+<SCRIPT type="text/javascript" src="http://felix.apache.org/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 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>
<DIV class="main">
<DIV class="page-header">
@@ -77,7 +77,7 @@
<A href="" class="sf-with-ul">Overview<SPAN class="sf-sub-indicator"> »</SPAN><SPAN class="sf-sub-indicator"> »</SPAN></A>
<UL>
<LI>
- <A href="apache-felix-ipojo.html" title="Apache Felix iPOJO">Home</A>
+ <A href="apache-felix-ipojo.html" title="Apache Felix iPOJO">Home</A>
</LI>
<LI>
<A href="apache-felix-ipojo-why-choose-ipojo.html" title="apache-felix-ipojo-why-choose-ipojo">Why choose iPOJO</A>
@@ -89,15 +89,15 @@
<A href="apache-felix-ipojo-feature-overview.html" title="Apache Felix iPOJO Feature Overview">Features</A>
</LI>
</UL>
-</LI>
+</LI>
-<LI class="">
+<LI class="">
<!-- Menu download -->
<LI>
<A href="download.html" title="Download">Download </A>
</LI>
-<LI class="">
+<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>
@@ -145,7 +145,7 @@
</UL>
</LI> <!-- end of user guide -->
<!-- sub- menu : Dev Guide -->
- <LI>
+ <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" class="external-link" rel="nofollow">Javadoc</A></LI>
@@ -154,7 +154,7 @@
<LI><A href="dive-into-the-ipojo-manipulation-depths.html" title="Dive into the iPOJO Manipulation depths">Dive into the iPOJO Manipulation depths</A></LI>
</UL>
</LI> <!-- End of Dev guide -->
-</UL>
+</UL>
</LI> <!-- End of doc -->
<!-- Menu 4 : Tools -->
<LI class="">
@@ -167,13 +167,13 @@
<LI><A href="apache-felix-ipojo-online-manipulator.html" title="apache-felix-ipojo-online-manipulator">Online Manipulator</A></LI>
<LI><A href="ipojo-webconsole-plugin.html" title="iPOJO Webconsole Plugin">Webconsole plugin</A></LI>
<LI><A href="apache-felix-ipojo-junit4osgi.html" title="apache-felix-ipojo-junit4osgi">Junit4OSGi</A></LI>
-</UL>
-</LI><!-- End of tools -->
+</UL>
+</LI><!-- End of tools -->
<!-- Menu 5 : Support -->
<LI>
<A href="ipojo-support.html" title="ipojo-support">Support </A>
</LI>
-<!-- End of the menu 5 -->
+<!-- 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>
@@ -193,6 +193,24 @@
<DIV class="content">
+ <div style="
+ background-color: #fdf7f7;
+ border-color: #d9534f;
+ margin: 40px 0;
+ padding: 20px;
+ border-left: 5px solid #d9534f;">
+ <h4 style="margin-top: 0;
+ font-size: 18px;
+ margin-bottom: 5px;
+ margin-top: 0;
+ margin-bottom: 10px;
+ font-weight: 500;
+ line-height: 1.1;
+ color: inherit;">The iPOJO documentation has moved </h4>
+ <p style="margin-top: 0px; padding-top: 0px; margin-bottom: 0px;">
+ The new web site is <a href="http://ipojo.org">here</a>, update your bookmark.</p>
+ </div>
+
<H1><A name="iPOJOAdvancedTutorial-TheiPOJOSnackBar"></A>The iPOJO Snack Bar</H1>
<P><EM>This tutorial illustrates some advanced features of iPOJO</EM></P>
@@ -230,9 +248,9 @@ java -jar bin/felix.jar
The hot dog vendor requires at the same time the bun service and the wiener service. In our application these services are provided by the same component. This component can be implemented as follows (src\org\apache\felix\ipojo\example\vendor\provider\BunWienerProvider.java):</P>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
-<PRE class="code-java">
+<PRE class="code-java">
<SPAN class="code-keyword">public</SPAN> class BunWienerProvider <SPAN class="code-keyword">implements</SPAN> BunService, WienerService {
-
+
<SPAN class="code-keyword">public</SPAN> void getBun() {
<SPAN class="code-object">System</SPAN>.out.println(<SPAN class="code-quote">"Get a bun"</SPAN>);
}
@@ -247,8 +265,8 @@ The hot dog vendor requires at the same
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-xml">
<SPAN class="code-tag"><ipojo></SPAN>
-<component
- classname=<SPAN class="code-quote">"org.apache.felix.ipojo.example.vendor.provider.BunWienerProvider"</SPAN>
+<component
+ classname=<SPAN class="code-quote">"org.apache.felix.ipojo.example.vendor.provider.BunWienerProvider"</SPAN>
name=<SPAN class="code-quote">"buns_and_wieners"</SPAN> public=<SPAN class="code-quote">"false"</SPAN>>
<SPAN class="code-tag"><provides/></SPAN>
<SPAN class="code-tag"></component></SPAN>
@@ -276,21 +294,21 @@ The hot dog vendor only provides the Ven
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
<SPAN class="code-keyword">public</SPAN> class HotDogVendor <SPAN class="code-keyword">implements</SPAN> Vendor {
-
+
/**
* Bun provider (required service).
*/
<SPAN class="code-keyword">private</SPAN> Bun bunProvider;
-
+
/**
- * Wiener provider (required service).
+ * Wiener provider (required service).
*/
<SPAN class="code-keyword">private</SPAN> Wiener wienerProvider;
-
+
/**
* Sell method.
* To provide an hotdog, the vendor consume a bun and a wiener.
- * This method is <SPAN class="code-keyword">synchronized</SPAN> to avoid serving to client
+ * This method is <SPAN class="code-keyword">synchronized</SPAN> to avoid serving to client
* at the same time.
* @<SPAN class="code-keyword">return</SPAN> a hotdog.
* @see org.apache.felix.ipojo.example.vendor.service.Vendor#sell()
@@ -307,7 +325,7 @@ The hot dog vendor only provides the Ven
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-xml">
<SPAN class="code-tag"><ipojo></SPAN>
-<component
+<component
classname=<SPAN class="code-quote">"org.apache.felix.ipojo.example.vendor.hotdog.HotDogVendor"</SPAN>
name=<SPAN class="code-quote">"HD"</SPAN> public=<SPAN class="code-quote">"false"</SPAN>>
<SPAN class="code-tag"><provides/></SPAN>
@@ -325,8 +343,8 @@ The hot dog vendor only provides the Ven
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-xml">
<SPAN class="code-tag"><ipojo></SPAN>
-<component
- classname=<SPAN class="code-quote">"org.apache.felix.ipojo.example.vendor.hotdog.HotDogVendor"</SPAN>
+<component
+ classname=<SPAN class="code-quote">"org.apache.felix.ipojo.example.vendor.hotdog.HotDogVendor"</SPAN>
name=<SPAN class="code-quote">"HD"</SPAN> public=<SPAN class="code-quote">"false"</SPAN>>
<SPAN class="code-tag"><provides></SPAN>
<SPAN class="code-tag"><property name=<SPAN class="code-quote">"product"</SPAN> type=<SPAN class="code-quote">"string"</SPAN> value=<SPAN class="code-quote">"hotdog"</SPAN>/></SPAN>
@@ -350,9 +368,9 @@ To achieve this, we modify the current i
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
<SPAN class="code-keyword">public</SPAN> class BunWienerProvider <SPAN class="code-keyword">implements</SPAN> BunService, WienerService {
-
+
<SPAN class="code-keyword">private</SPAN> <SPAN class="code-object">int</SPAN> bunStock;
-
+
<SPAN class="code-keyword">private</SPAN> <SPAN class="code-object">int</SPAN> wienerStock;
<SPAN class="code-keyword">public</SPAN> <SPAN class="code-keyword">synchronized</SPAN> void getBun() {
@@ -371,8 +389,8 @@ To achieve this, we modify the current i
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-xml">
<SPAN class="code-tag"><ipojo></SPAN>
-<component
- classname=<SPAN class="code-quote">"org.apache.felix.ipojo.example.vendor.provider.BunProvider"</SPAN>
+<component
+ classname=<SPAN class="code-quote">"org.apache.felix.ipojo.example.vendor.provider.BunProvider"</SPAN>
name=<SPAN class="code-quote">"buns_and_wieners"</SPAN> public=<SPAN class="code-quote">"false"</SPAN>>
<SPAN class="code-tag"><provides></SPAN>
<SPAN class="code-tag"><property name=<SPAN class="code-quote">"buns"</SPAN> field=<SPAN class="code-quote">"bunStock"</SPAN> value=<SPAN class="code-quote">"10"</SPAN>/></SPAN>
@@ -394,7 +412,7 @@ To achieve this, we modify the current i
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-xml">
<SPAN class="code-tag"><ipojo></SPAN>
-<component
+<component
classname=<SPAN class="code-quote">"org.apache.felix.ipojo.example.vendor.provider.BunProvider"</SPAN>
name=<SPAN class="code-quote">"buns_and_wieners"</SPAN> public=<SPAN class="code-quote">"false"</SPAN>>
<SPAN class="code-tag"><provides></SPAN>
@@ -421,7 +439,7 @@ To achieve this, we modify the current i
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-xml">
<SPAN class="code-tag"><ipojo></SPAN>
-<component
+<component
classname=<SPAN class="code-quote">"org.apache.felix.ipojo.example.vendor.hotdog.HotDogVendor"</SPAN>
name=<SPAN class="code-quote">"HD"</SPAN> public=<SPAN class="code-quote">"false"</SPAN>>
<SPAN class="code-tag"><provides></SPAN>
@@ -459,13 +477,13 @@ When an instance becomes invalid, all it
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
<SPAN class="code-keyword">public</SPAN> class Customer {
-
+
<SPAN class="code-keyword">private</SPAN> VendorService vendor;
-
+
<SPAN class="code-keyword">private</SPAN> <SPAN class="code-object">String</SPAN> name;
-
+
<SPAN class="code-keyword">public</SPAN> Customer() {
- <SPAN class="code-object">System</SPAN>.out.println(<SPAN class="code-quote">"Customer "</SPAN> + name + <SPAN class="code-quote">" bought "</SPAN>
+ <SPAN class="code-object">System</SPAN>.out.println(<SPAN class="code-quote">"Customer "</SPAN> + name + <SPAN class="code-quote">" bought "</SPAN>
+ vendor.sell() + <SPAN class="code-quote">" from "</SPAN> + vendor.getName());
}
</PRE>
@@ -477,8 +495,8 @@ The first one uses the lifecycle callbac
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-xml">
<SPAN class="code-tag"><ipojo></SPAN>
-<component
- classname=<SPAN class="code-quote">"org.apache.felix.ipojo.example.vendor.customer.Customer"</SPAN>
+<component
+ classname=<SPAN class="code-quote">"org.apache.felix.ipojo.example.vendor.customer.Customer"</SPAN>
name=<SPAN class="code-quote">"customer"</SPAN> immediate=<SPAN class="code-quote">"true"</SPAN>>
<SPAN class="code-tag"><requires field=<SPAN class="code-quote">"vendor"</SPAN>/></SPAN>
<SPAN class="code-tag"><properties></SPAN>
@@ -588,18 +606,18 @@ Let's take the popcorn vendor with a cor
* The corn stock.
*/
<SPAN class="code-keyword">private</SPAN> <SPAN class="code-object">int</SPAN> m_corn_stock;
-
+
/**
* Lifecycle controller.
- * If set to <SPAN class="code-keyword">false</SPAN>, the instance becomes invalid.
+ * If set to <SPAN class="code-keyword">false</SPAN>, the instance becomes invalid.
*/
<SPAN class="code-keyword">private</SPAN> <SPAN class="code-object">boolean</SPAN> m_can_sell = <SPAN class="code-keyword">true</SPAN>;
/**
* The sell method.
* To provide popcorn, the vendor needs to decrease its corn stock level.
- * This method is <SPAN class="code-keyword">synchronized</SPAN> to avoid to client being serve at
- * the same time.
+ * This method is <SPAN class="code-keyword">synchronized</SPAN> to avoid to client being serve at
+ * the same time.
* @<SPAN class="code-keyword">return</SPAN>
* @see org.apache.felix.ipojo.example.vendor.service.Vendor#sell()
*/
@@ -611,7 +629,7 @@ Let's take the popcorn vendor with a cor
m_corn_stock--;
<SPAN class="code-keyword">if</SPAN> (m_corn_stock == 0 && m_can_sell) { <SPAN class="code-comment">// Last pop corn
</SPAN> m_can_sell = <SPAN class="code-keyword">false</SPAN>;
- <SPAN class="code-object">System</SPAN>.out.println("Stop selling popcorn
+ <SPAN class="code-object">System</SPAN>.out.println("Stop selling popcorn
... Run out of stock");
<SPAN class="code-keyword">return</SPAN> <SPAN class="code-keyword">new</SPAN> PopCorn();
} <SPAN class="code-keyword">else</SPAN> <SPAN class="code-keyword">if</SPAN> (m_corn_stock > 0) { <SPAN class="code-comment">// Normal <SPAN class="code-keyword">case</SPAN>
@@ -627,7 +645,7 @@ Let's take the popcorn vendor with a cor
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-xml">
<SPAN class="code-tag"><ipojo></SPAN>
-<component
+<component
classname=<SPAN class="code-quote">"org.apache.felix.ipojo.example.vendor.popcorn.PopCornVendor"</SPAN>
name=<SPAN class="code-quote">"popcorn"</SPAN> public=<SPAN class="code-quote">"false"</SPAN> architecture=<SPAN class="code-quote">"true"</SPAN>>
<SPAN class="code-tag"><provides/></SPAN>
@@ -665,7 +683,7 @@ First, we will change the pop corn vendo
<PRE class="code-java">
/**
* A transporter refills the stock of corn.
- * This method is <SPAN class="code-keyword">synchronized</SPAN> to avoid to client being served
+ * This method is <SPAN class="code-keyword">synchronized</SPAN> to avoid to client being served
* during the update.
* @param newStock : the stock of corn to add to the current stock.
*/
@@ -682,8 +700,8 @@ First, we will change the pop corn vendo
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-xml">
<SPAN class="code-tag"><ipojo></SPAN>
-<component
- classname=<SPAN class="code-quote">"org.apache.felix.ipojo.example.vendor.popcorn.PopCornVendor"</SPAN>
+<component
+ classname=<SPAN class="code-quote">"org.apache.felix.ipojo.example.vendor.popcorn.PopCornVendor"</SPAN>
name=<SPAN class="code-quote">"popcorn"</SPAN> architecture=<SPAN class="code-quote">"true"</SPAN>>
<SPAN class="code-tag"><provides/></SPAN>
<SPAN class="code-tag"><controller field=<SPAN class="code-quote">"m_can_sell"</SPAN>/></SPAN>
@@ -706,27 +724,27 @@ The implementation is contained in the <
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
<SPAN class="code-keyword">public</SPAN> class CornTransporter {
-
+
<SPAN class="code-keyword">private</SPAN> ConfigurationAdmin m_configAdmin;
-
-
+
+
/**
- * Reconfigure the popcorn vendor with the configuration admin.
+ * Reconfigure the popcorn vendor with the configuration admin.
*/
<SPAN class="code-keyword">public</SPAN> void refillStock() {
<SPAN class="code-keyword">try</SPAN> {
<SPAN class="code-comment">// Retrieve or Create the instance configuration
</SPAN> <SPAN class="code-comment">// from the configuration admin
-</SPAN> Configuration configuration =
- m_configAdmin.getConfiguration(<SPAN class="code-quote">"Super.PopCorn.Stock"</SPAN>,
+</SPAN> Configuration configuration =
+ m_configAdmin.getConfiguration(<SPAN class="code-quote">"Super.PopCorn.Stock"</SPAN>,
<SPAN class="code-quote">"file:../vendor.popcorn/output/vendor.popcorn.jar"</SPAN>);
configuration.setBundleLocation(
<SPAN class="code-quote">"file:../vendor.popcorn/output/vendor.popcorn.jar"</SPAN>);
Properties props = <SPAN class="code-keyword">new</SPAN> Properties();
props.put(<SPAN class="code-quote">"stock"</SPAN>, <SPAN class="code-keyword">new</SPAN> <SPAN class="code-object">Integer</SPAN>(15)); <SPAN class="code-comment">// Delivered corn
</SPAN> configuration.update(props);
- <SPAN class="code-object">System</SPAN>.out.println(<SPAN class="code-quote">"Update the configuration of "</SPAN>
- + configuration.getPid() + <SPAN class="code-quote">"("</SPAN>
+ <SPAN class="code-object">System</SPAN>.out.println(<SPAN class="code-quote">"Update the configuration of "</SPAN>
+ + configuration.getPid() + <SPAN class="code-quote">"("</SPAN>
+ configuration.getBundleLocation() + <SPAN class="code-quote">")"</SPAN>);
configuration.delete();
} <SPAN class="code-keyword">catch</SPAN> (IOException e) {
Modified: felix/site/trunk/content/site/ipojo-ant-task.html
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/site/ipojo-ant-task.html?rev=1575977&r1=1575976&r2=1575977&view=diff
==============================================================================
--- felix/site/trunk/content/site/ipojo-ant-task.html (original)
+++ felix/site/trunk/content/site/ipojo-ant-task.html Mon Mar 10 15:48:48 2014
@@ -28,11 +28,11 @@
</DIV>
<DIV class="main">
<STYLE type="text/css">
- @import url(http://felix.apache.org/ipojo/site/superfish.css);
+ @import url(http://felix.apache.org/ipojo/site/superfish.css);
</STYLE>
<STYLE type="text/css">
- @import url(http://felix.apache.org/ipojo/site/style.css);
+ @import url(http://felix.apache.org/ipojo/site/style.css);
</STYLE>
<P>
@@ -50,22 +50,22 @@
<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/jquery-1.js"></SCRIPT>
<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/hoverIntent.js"></SCRIPT>
-<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/superfish.js"></SCRIPT>
-<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/supersubs.js"></SCRIPT>
+<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/superfish.js"></SCRIPT>
+<SCRIPT type="text/javascript" src="http://felix.apache.org/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 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>
<DIV class="main">
<DIV class="page-header">
@@ -77,7 +77,7 @@
<A href="" class="sf-with-ul">Overview<SPAN class="sf-sub-indicator"> »</SPAN><SPAN class="sf-sub-indicator"> »</SPAN></A>
<UL>
<LI>
- <A href="apache-felix-ipojo.html" title="Apache Felix iPOJO">Home</A>
+ <A href="apache-felix-ipojo.html" title="Apache Felix iPOJO">Home</A>
</LI>
<LI>
<A href="apache-felix-ipojo-why-choose-ipojo.html" title="apache-felix-ipojo-why-choose-ipojo">Why choose iPOJO</A>
@@ -89,15 +89,15 @@
<A href="apache-felix-ipojo-feature-overview.html" title="Apache Felix iPOJO Feature Overview">Features</A>
</LI>
</UL>
-</LI>
+</LI>
-<LI class="">
+<LI class="">
<!-- Menu download -->
<LI>
<A href="download.html" title="Download">Download </A>
</LI>
-<LI class="">
+<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>
@@ -145,7 +145,7 @@
</UL>
</LI> <!-- end of user guide -->
<!-- sub- menu : Dev Guide -->
- <LI>
+ <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" class="external-link" rel="nofollow">Javadoc</A></LI>
@@ -154,7 +154,7 @@
<LI><A href="dive-into-the-ipojo-manipulation-depths.html" title="Dive into the iPOJO Manipulation depths">Dive into the iPOJO Manipulation depths</A></LI>
</UL>
</LI> <!-- End of Dev guide -->
-</UL>
+</UL>
</LI> <!-- End of doc -->
<!-- Menu 4 : Tools -->
<LI class="">
@@ -167,13 +167,13 @@
<LI><A href="apache-felix-ipojo-online-manipulator.html" title="apache-felix-ipojo-online-manipulator">Online Manipulator</A></LI>
<LI><A href="ipojo-webconsole-plugin.html" title="iPOJO Webconsole Plugin">Webconsole plugin</A></LI>
<LI><A href="apache-felix-ipojo-junit4osgi.html" title="apache-felix-ipojo-junit4osgi">Junit4OSGi</A></LI>
-</UL>
-</LI><!-- End of tools -->
+</UL>
+</LI><!-- End of tools -->
<!-- Menu 5 : Support -->
<LI>
<A href="ipojo-support.html" title="ipojo-support">Support </A>
</LI>
-<!-- End of the menu 5 -->
+<!-- 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>
@@ -193,6 +193,24 @@
<DIV class="content">
+ <div style="
+ background-color: #fdf7f7;
+ border-color: #d9534f;
+ margin: 40px 0;
+ padding: 20px;
+ border-left: 5px solid #d9534f;">
+ <h4 style="margin-top: 0;
+ font-size: 18px;
+ margin-bottom: 5px;
+ margin-top: 0;
+ margin-bottom: 10px;
+ font-weight: 500;
+ line-height: 1.1;
+ color: inherit;">The iPOJO documentation has moved </h4>
+ <p style="margin-top: 0px; padding-top: 0px; margin-bottom: 0px;">
+ The new web site is <a href="http://ipojo.org">here</a>, update your bookmark.</p>
+ </div>
+
<H1><A name="iPOJOAntTask-iPOJOAntTask"></A>iPOJO Ant Task</H1>
@@ -301,7 +319,7 @@ To be sure that the BND bundle is alread
<P>The manipulator can take a directory in input. In this case, classes from this folder is manipulated. You can also set the manifest file location too. Here in an example of configuration using this mode:</P>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-xml">
-<SPAN class="code-tag"><target name=<SPAN class="code-quote">"manipulate"</SPAN>></SPAN>
+<SPAN class="code-tag"><target name=<SPAN class="code-quote">"manipulate"</SPAN>></SPAN>
<ipojo
dir=<SPAN class="code-quote">"${output..}"</SPAN> <SPAN class="code-tag"><SPAN class="code-comment"><!-- Manipulated directory --></SPAN></SPAN>
metadata=<SPAN class="code-quote">"metadata.xml"</SPAN>
Modified: felix/site/trunk/content/site/ipojo-arch-command.html
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/site/ipojo-arch-command.html?rev=1575977&r1=1575976&r2=1575977&view=diff
==============================================================================
--- felix/site/trunk/content/site/ipojo-arch-command.html (original)
+++ felix/site/trunk/content/site/ipojo-arch-command.html Mon Mar 10 15:48:48 2014
@@ -28,11 +28,11 @@
</DIV>
<DIV class="main">
<STYLE type="text/css">
- @import url(http://felix.apache.org/ipojo/site/superfish.css);
+ @import url(http://felix.apache.org/ipojo/site/superfish.css);
</STYLE>
<STYLE type="text/css">
- @import url(http://felix.apache.org/ipojo/site/style.css);
+ @import url(http://felix.apache.org/ipojo/site/style.css);
</STYLE>
<P>
@@ -50,22 +50,22 @@
<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/jquery-1.js"></SCRIPT>
<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/hoverIntent.js"></SCRIPT>
-<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/superfish.js"></SCRIPT>
-<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/supersubs.js"></SCRIPT>
+<SCRIPT type="text/javascript" src="http://felix.apache.org/ipojo/site/superfish.js"></SCRIPT>
+<SCRIPT type="text/javascript" src="http://felix.apache.org/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 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>
<DIV class="main">
<DIV class="page-header">
@@ -77,7 +77,7 @@
<A href="" class="sf-with-ul">Overview<SPAN class="sf-sub-indicator"> »</SPAN><SPAN class="sf-sub-indicator"> »</SPAN></A>
<UL>
<LI>
- <A href="apache-felix-ipojo.html" title="Apache Felix iPOJO">Home</A>
+ <A href="apache-felix-ipojo.html" title="Apache Felix iPOJO">Home</A>
</LI>
<LI>
<A href="apache-felix-ipojo-why-choose-ipojo.html" title="apache-felix-ipojo-why-choose-ipojo">Why choose iPOJO</A>
@@ -89,15 +89,15 @@
<A href="apache-felix-ipojo-feature-overview.html" title="Apache Felix iPOJO Feature Overview">Features</A>
</LI>
</UL>
-</LI>
+</LI>
-<LI class="">
+<LI class="">
<!-- Menu download -->
<LI>
<A href="download.html" title="Download">Download </A>
</LI>
-<LI class="">
+<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>
@@ -145,7 +145,7 @@
</UL>
</LI> <!-- end of user guide -->
<!-- sub- menu : Dev Guide -->
- <LI>
+ <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" class="external-link" rel="nofollow">Javadoc</A></LI>
@@ -154,7 +154,7 @@
<LI><A href="dive-into-the-ipojo-manipulation-depths.html" title="Dive into the iPOJO Manipulation depths">Dive into the iPOJO Manipulation depths</A></LI>
</UL>
</LI> <!-- End of Dev guide -->
-</UL>
+</UL>
</LI> <!-- End of doc -->
<!-- Menu 4 : Tools -->
<LI class="">
@@ -167,13 +167,13 @@
<LI><A href="apache-felix-ipojo-online-manipulator.html" title="apache-felix-ipojo-online-manipulator">Online Manipulator</A></LI>
<LI><A href="ipojo-webconsole-plugin.html" title="iPOJO Webconsole Plugin">Webconsole plugin</A></LI>
<LI><A href="apache-felix-ipojo-junit4osgi.html" title="apache-felix-ipojo-junit4osgi">Junit4OSGi</A></LI>
-</UL>
-</LI><!-- End of tools -->
+</UL>
+</LI><!-- End of tools -->
<!-- Menu 5 : Support -->
<LI>
<A href="ipojo-support.html" title="ipojo-support">Support </A>
</LI>
-<!-- End of the menu 5 -->
+<!-- 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>
@@ -193,6 +193,24 @@
<DIV class="content">
+ <div style="
+ background-color: #fdf7f7;
+ border-color: #d9534f;
+ margin: 40px 0;
+ padding: 20px;
+ border-left: 5px solid #d9534f;">
+ <h4 style="margin-top: 0;
+ font-size: 18px;
+ margin-bottom: 5px;
+ margin-top: 0;
+ margin-bottom: 10px;
+ font-weight: 500;
+ line-height: 1.1;
+ color: inherit;">The iPOJO documentation has moved </h4>
+ <p style="margin-top: 0px; padding-top: 0px; margin-bottom: 0px;">
+ The new web site is <a href="http://ipojo.org">here</a>, update your bookmark.</p>
+ </div>
+
<H1><A name="iPOJO-Arch-Command-iPOJO%7B%7BArch%7D%7Dcommand"></A>iPOJO <TT>Arch</TT> command</H1>
<P><EM>Architecture introspection is required when the system doesn't work as expected. In this case, having a quick access to instances states and interconnection is a stringent requirement. The <TT>arch</TT> command allows getting these data from the Felix Shell, from the Equinox shell and Gogo.</EM></P>
@@ -283,7 +301,7 @@ Instance spell.gui.SpellCheckerGui-0 -&g
<P>To get more information on an instance, launch <TT>arch -instance the_instance_name</TT> (or <TT>instance the_instance_name</TT> on Gogo)</P>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;"><B>Felix or Equinox</B></DIV><DIV class="codeContent panelContent">
<PRE class="code-java">
--> arch -instance spell.checker.SpellCheck-0
+-> arch -instance spell.checker.SpellCheck-0
instance component.type=<SPAN class="code-quote">"spell.checker.SpellCheck"</SPAN> state=<SPAN class="code-quote">"valid"</SPAN> bundle=<SPAN class="code-quote">"8"</SPAN> name=<SPAN class="code-quote">"spell.checker.SpellCheck-0"</SPAN>
handler state=<SPAN class="code-quote">"valid"</SPAN> name=<SPAN class="code-quote">"org.apache.felix.ipojo.handlers.dependency.DependencyHandler"</SPAN>
requires optional=<SPAN class="code-quote">"<SPAN class="code-keyword">false</SPAN>"</SPAN> aggregate=<SPAN class="code-quote">"<SPAN class="code-keyword">false</SPAN>"</SPAN> state=<SPAN class="code-quote">"resolved"</SPAN> binding-policy=<SPAN class="code-quote">"dynamic"</SPAN> specification=<SPAN class="code-quote">"spell.services.DictionaryService"</SPAN>
@@ -296,7 +314,7 @@ instance component.type=<SPAN class="cod
</DIV></DIV>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;"><B>Gogo</B></DIV><DIV class="codeContent panelContent">
<PRE class="code-java">
-$ipojo:instance spell.checker.SpellCheck-0
+$ipojo:instance spell.checker.SpellCheck-0
instance component.type=<SPAN class="code-quote">"spell.checker.SpellCheck"</SPAN> state=<SPAN class="code-quote">"valid"</SPAN> bundle=<SPAN class="code-quote">"8"</SPAN> name=<SPAN class="code-quote">"spell.checker.SpellCheck-0"</SPAN>
handler state=<SPAN class="code-quote">"valid"</SPAN> name=<SPAN class="code-quote">"org.apache.felix.ipojo.handlers.dependency.DependencyHandler"</SPAN>
requires optional=<SPAN class="code-quote">"<SPAN class="code-keyword">false</SPAN>"</SPAN> aggregate=<SPAN class="code-quote">"<SPAN class="code-keyword">false</SPAN>"</SPAN> state=<SPAN class="code-quote">"resolved"</SPAN> binding-policy=<SPAN class="code-quote">"dynamic"</SPAN> specification=<SPAN class="code-quote">"spell.services.DictionaryService"</SPAN>
@@ -321,7 +339,7 @@ instance component.type=<SPAN class="cod
provides state=<SPAN class="code-quote">"unregistered"</SPAN> specifications=<SPAN class="code-quote">"[spell.services.SpellChecker]"</SPAN>
property value=<SPAN class="code-quote">"spell.checker.SpellCheck"</SPAN> name=<SPAN class="code-quote">"factory.name"</SPAN>
property value=<SPAN class="code-quote">"spell.checker.SpellCheck-0"</SPAN> name=<SPAN class="code-quote">"instance.name"</SPAN>
- handler state=<SPAN class="code-quote">"valid"</SPAN> name=<SPAN class="code-quote">"org.apache.felix.ipojo.handlers.architecture.ArchitectureHandler"</SPAN>
+ handler state=<SPAN class="code-quote">"valid"</SPAN> name=<SPAN class="code-quote">"org.apache.felix.ipojo.handlers.architecture.ArchitectureHandler"</SPAN>
</PRE>
</DIV></DIV>
<P>Notes that, the instance also becomes invalid and that the provided service is unregistered.<BR>
@@ -329,7 +347,7 @@ If the provider comes back, the dependen
If an instance begins to use a service, the bound providers are described in the instance architecture:</P>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;"><B>Felix or Equinox</B></DIV><DIV class="codeContent panelContent">
<PRE class="code-java">
--> arch -instance spell.checker.SpellCheck-0
+-> arch -instance spell.checker.SpellCheck-0
instance component.type=<SPAN class="code-quote">"spell.checker.SpellCheck"</SPAN> state=<SPAN class="code-quote">"valid"</SPAN> bundle=<SPAN class="code-quote">"8"</SPAN> name=<SPAN class="code-quote">"spell.checker.SpellCheck-0"</SPAN>
object name=<SPAN class="code-quote">"spell.checker.SpellCheck@e222eb"</SPAN>
handler state=<SPAN class="code-quote">"valid"</SPAN> name=<SPAN class="code-quote">"org.apache.felix.ipojo.handlers.dependency.DependencyHandler"</SPAN>
@@ -345,7 +363,7 @@ instance component.type=<SPAN class="cod
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeHeader panelHeader" style="border-bottom-width: 1px;"><B>Gogo</B></DIV><DIV class="codeContent panelContent">
<PRE class="code-java">
-$instance spell.checker.SpellCheck-0
+$instance spell.checker.SpellCheck-0
instance component.type=<SPAN class="code-quote">"spell.checker.SpellCheck"</SPAN> state=<SPAN class="code-quote">"valid"</SPAN> bundle=<SPAN class="code-quote">"8"</SPAN> name=<SPAN class="code-quote">"spell.checker.SpellCheck-0"</SPAN>
object name=<SPAN class="code-quote">"spell.checker.SpellCheck@e222eb"</SPAN>
handler state=<SPAN class="code-quote">"valid"</SPAN> name=<SPAN class="code-quote">"org.apache.felix.ipojo.handlers.dependency.DependencyHandler"</SPAN>