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 2013/09/30 10:19:33 UTC
svn commit: r1527484 -
/felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/describing-components/service-requirement-handler.mdtext
Author: clement
Date: Mon Sep 30 08:19:33 2013
New Revision: 1527484
URL: http://svn.apache.org/r1527484
Log:
Fix some bugs in the documentation.
Modified:
felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/describing-components/service-requirement-handler.mdtext
Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/describing-components/service-requirement-handler.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/describing-components/service-requirement-handler.mdtext?rev=1527484&r1=1527483&r2=1527484&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/describing-components/service-requirement-handler.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/describing-components/service-requirement-handler.mdtext Mon Sep 30 08:19:33 2013
@@ -679,7 +679,8 @@ For example, the following component use
@Requires(optional=true, default-implementation=MyLogService.class)
private LogService m_log;
-or
+or
+
:::xml
<requires field="m_log" optional="true"
default-implementation=
@@ -689,14 +690,14 @@ If the log service is not available, iPO
Finally, you can also instructs iPOJO to throw a runtime exception when there are no service providers available. This option is often use in combination with the `timeout` option, that delay the decision. To throw an exception, use the `exception` attribute specifying the exception class to use. It must be a subclass of `RuntimeException`. Obvisouly, you can use `java.lang.RuntimeException` directly.
- :::java
- @Requires(optional=true, exception=NoServiceException.class)
- private LogService m_log;
+ :::java
+ @Requires(optional=true, exception=NoServiceException.class)
+ private LogService m_log;
or
- :::xml
- <requires field="m_log" optional="true"
+ :::xml
+ <requires field="m_log" optional="true"
exception=
"org.apache.felix.ipojo.example.default.NoServiceException"/>
@@ -706,9 +707,9 @@ For scalar optional dependencies injecte
In the following example, the `AuthenticationService` is essential, but also may be subjected to updates. When the service is not there, you don't want to fail immediately, but give it a chance to re-appear _soon_:
- :::java
- @Requires(optional=true, exception=UpdateInProgessException.class, timeout=1000)
- private AuthenticationService m_auth;
+ :::java
+ @Requires(optional=true, exception=UpdateInProgessException.class, timeout=1000)
+ private AuthenticationService m_auth;
## Note about Callbacks