You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@felix.apache.org by gu...@apache.org on 2013/10/08 11:12:32 UTC
svn commit: r1530195 - in
/felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo:
apache-felix-ipojo-devguide/ apache-felix-ipojo-tools/
apache-felix-ipojo-userguide/
apache-felix-ipojo-userguide/ipojo-advanced-topics/
Author: guillaume
Date: Tue Oct 8 09:12:32 2013
New Revision: 1530195
URL: http://svn.apache.org/r1530195
Log:
* Add missing titles on some pages
* Try to have better formatting
Modified:
felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-devguide/how-to-write-your-own-handler.mdtext
felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-tools/ipojo-arch-command.mdtext
felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/apache-felix-ipojo-api.mdtext
felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/instance-vs-service-controller.mdtext
felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-advanced-topics/constructing-pojo-objects-with-factory-methods.mdtext
felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-advanced-topics/ipojo-extender-configuration.mdtext
felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-advanced-topics/ipojo-factory-service.mdtext
felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-faq.mdtext
Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-devguide/how-to-write-your-own-handler.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-devguide/how-to-write-your-own-handler.mdtext?rev=1530195&r1=1530194&r2=1530195&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-devguide/how-to-write-your-own-handler.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-devguide/how-to-write-your-own-handler.mdtext Tue Oct 8 09:12:32 2013
@@ -236,7 +236,7 @@ Once your handler has been declared, you
Configuration of your handler for
this component type
-->
- </your-shortcut{noformat}:HandlerName>
+ </your-shortcut:HandlerName>
...
</component>
...
Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-tools/ipojo-arch-command.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-tools/ipojo-arch-command.mdtext?rev=1530195&r1=1530194&r2=1530195&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-tools/ipojo-arch-command.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-tools/ipojo-arch-command.mdtext Tue Oct 8 09:12:32 2013
@@ -41,7 +41,6 @@ For example:
property value="spell.checker.SpellCheck-0" name="instance.name"
handler state="valid" name="org.apache.felix.ipojo.handlers.architecture.ArchitectureHandler"
-
## Equinox and Felix Shells
On Equinox and Felix (old) shell, the command is named _arch_:
@@ -52,6 +51,7 @@ On Equinox and Felix (old) shell, the co
* arch -factory $factory*name => display complete information about the factory $factory*name
* arch -handlers => list available handlers
+
:::sh
-> arch
Instance ArchCommand -> valid
Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/apache-felix-ipojo-api.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/apache-felix-ipojo-api.mdtext?rev=1530195&r1=1530194&r2=1530195&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/apache-felix-ipojo-api.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/apache-felix-ipojo-api.mdtext Tue Oct 8 09:12:32 2013
@@ -88,7 +88,8 @@ The Service object can be configured. By
* Set the creation strategy
* Set the exposed service specifications
- :::java
+
+ :::java
new PrimitiveComponentType()
.setBundleContext(context)
.setClassName(org.example.service.impl.MyComponentImpl.class.getName())
@@ -99,7 +100,6 @@ The Service object can be configured. By
.setCreationStrategy(Service.INSTANCE_STRATEGY))
.createInstance();
-
## Service Dependencies
To declare a service dependency, create and add a Dependency object. The dependency object offers all the iPOJO service dependency features. You can set the injected field and/or bind/unbind methods. Here is an example:
Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/instance-vs-service-controller.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/instance-vs-service-controller.mdtext?rev=1530195&r1=1530194&r2=1530195&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/instance-vs-service-controller.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/instance-vs-service-controller.mdtext Tue Oct 8 09:12:32 2013
@@ -1,3 +1,6 @@
+translation_pending: true
+Title: Instance Controller or Service Controller
+
# Instance Controller or Service Controller ?
When the component implementation needs to impact the instance container, it uses _controllers_ on Boolean fields. iPOJO provides two controllers:
@@ -50,6 +53,7 @@ Unlike the instance lifecycle controller
* be set to `false` at startup (to not publish the services by default).
* fluctuate between `true` and `false` to reflect the decision of the component implementation to publish or not the services.
+
:::java
@Component
@Provides
Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-advanced-topics/constructing-pojo-objects-with-factory-methods.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-advanced-topics/constructing-pojo-objects-with-factory-methods.mdtext?rev=1530195&r1=1530194&r2=1530195&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-advanced-topics/constructing-pojo-objects-with-factory-methods.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-advanced-topics/constructing-pojo-objects-with-factory-methods.mdtext Tue Oct 8 09:12:32 2013
@@ -12,10 +12,8 @@ iPOJO allows you describing a factory me
To use this feature you need to add the `factory-method` attribute in the Component element as illustrated below:
:::xml
- <component
- className="org.apache.felix.ipojo.test.scenarios.component.FooProvider"
- factory-method="createProvider"
- >
+ <component className="org.apache.felix.ipojo.test.scenarios.component.FooProvider"
+ factory-method="createProvider">
...
</component>
Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-advanced-topics/ipojo-extender-configuration.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-advanced-topics/ipojo-extender-configuration.mdtext?rev=1530195&r1=1530194&r2=1530195&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-advanced-topics/ipojo-extender-configuration.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-advanced-topics/ipojo-extender-configuration.mdtext Tue Oct 8 09:12:32 2013
@@ -92,7 +92,6 @@ General synchronous processing can be co
The synchronous behavior can be selected per-bundle (given that it does not conflict with existing system wide configuration).
Synchronous/Asynchronous behavior can be expressed in the Bundle's Manifest (case is not significant, but an uppercase first letter is recommended):
- :::properties
IPOJO-Queue-Preference SYNC
3 values are supported:
Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-advanced-topics/ipojo-factory-service.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-advanced-topics/ipojo-factory-service.mdtext?rev=1530195&r1=1530194&r2=1530195&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-advanced-topics/ipojo-factory-service.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-advanced-topics/ipojo-factory-service.mdtext Tue Oct 8 09:12:32 2013
@@ -1,3 +1,6 @@
+translation_pending: true
+Title: Using the iPOJO Factory service
+
# Using the Factory service interface
[TOC]
Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-faq.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-faq.mdtext?rev=1530195&r1=1530194&r2=1530195&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-faq.mdtext (original)
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-ipojo/apache-felix-ipojo-userguide/ipojo-faq.mdtext Tue Oct 8 09:12:32 2013
@@ -65,12 +65,9 @@ For Ant, just configure the classpath of
:::xml
<taskdef name="ipojo"
- classname="org.apache.felix.ipojo.task.IPojoTask"
- classpath="../ipojo/manipulator/org.apache.felix.ipojo.manipulator-1.7.0-SNAPSHOT.jar; lib/org.apache.felix.ipojo.ant-1.7.0-SNAPSHOT.jar;" />
- />
+ classname="org.apache.felix.ipojo.task.IPojoTask"
+ classpath="../ipojo/manipulator/org.apache.felix.ipojo.manipulator-1.7.0-SNAPSHOT.jar; lib/org.apache.felix.ipojo.ant-1.7.0-SNAPSHOT.jar;" />
-
-
## Callbacks order.
A lot of handlers define callbacks to notify the implementation class. The 'core' callbacks are called in the following order:
@@ -173,7 +170,6 @@ Sometimes it is useful to check if an op
@Requires(proxy=false)
private LogService log;
-
* The injected object will be a direct reference. By default, iPOJO injects a `Nullable` object, on which you can call service method without checking for `null`. To detect Nullable objects, just use `instanceof`
:::java
@@ -188,7 +184,6 @@ Sometimes it is useful to check if an op
}
}
-
* If you prefer injecting `null` instead of a `Nullable`, just disable Nullable injection too. However, be care to check for `null` before each invocation.
:::java
@@ -203,7 +198,6 @@ Sometimes it is useful to check if an op
}
}
-
## Setting the iPOJO log level
By default, iPOJO logs only warning and error messages. There are two different methods to configure the log level. First, you can set the global log level by setting the _ipojo.log.level_ system property. This replaces the default log level (warning). All iPOJO instances will be impacted. However, each bundle containing component types can specify a different log level. To set this level, add the _ipojo-log-level_ header in your manifest. The possible values for these two properties are: