Author: buildbot Date: Tue Oct 17 18:48:57 2017 New Revision: 1019656 Log: Staging update by buildbot for aries
Modified: websites/staging/aries/trunk/content/ (props changed) websites/staging/aries/trunk/content/modules/blueprint-maven-plugin.html Propchange: websites/staging/aries/trunk/content/ ------------------------------------------------------------------------------ --- cms:source-revision (original) +++ cms:source-revision Tue Oct 17 18:48:57 2017 @@ -1 +1 @@ -1811848 +1812438 Modified: websites/staging/aries/trunk/content/modules/blueprint-maven-plugin.html ============================================================================== --- websites/staging/aries/trunk/content/modules/blueprint-maven-plugin.html (original) +++ websites/staging/aries/trunk/content/modules/blueprint-maven-plugin.html Tue Oct 17 18:48:57 2017 @@ -295,7 +295,7 @@ The generated blueprint can also be used <div class="codehilite"><pre><span class="nt"><plugin></span> <span class="nt"><groupId></span>org.apache.aries.blueprint<span class="nt"></groupId></span> <span class="nt"><artifactId></span>blueprint-maven-plugin<span class="nt"></artifactId></span> - <span class="nt"><version></span>1.5.0<span class="nt"></version></span> + <span class="nt"><version></span>1.9.0<span class="nt"></version></span> <span class="nt"><configuration></span> <span class="nt"><scanPaths></span> <span class="nt"><scanPath></span>org.my.package<span class="nt"></scanPath></span> @@ -345,13 +345,6 @@ The generated blueprint can also be used <li>@PostConstruct Marks a method to be called after DI is finished (init-method)</li> <li>@PreDestroy Marks a method to be called before the bean is destroyed (destroy-method)</li> </ul> -<h3 id="pax-cdi">pax-cdi<a class="headerlink" href="#pax-cdi" title="Permanent link">¶</a></h3> -<ul> -<li>@OsgiServiceProvider(classes={TaskService.class}) Publishes a bean as an OSGi service with the given interfaces</li> -<li>@OsgiService creates a reference to an OSGi service. On optional filter is also possible</li> -<li>@Properties Defines service properties for OSGiServiceProvider</li> -<li>@Property Defines a service property</li> -</ul> <h3 id="javaxpersistence">javax.persistence<a class="headerlink" href="#javaxpersistence" title="Permanent link">¶</a></h3> <ul> <li>@PersistenceContext(unitName="tasklist") inject a managed EntityManager for the given persistence unit into a field</li> @@ -363,6 +356,34 @@ The generated blueprint can also be used <li>@Config Creates cm:property-placehoder</li> <li>@DefaultProperty Configure default values for properties in property-placeholder</li> </ul> +<h3 id="collection-annotations-orgapacheariesblueprintannotationcollection">Collection annotations (org.apache.aries.blueprint.annotation.collection)<a class="headerlink" href="#collection-annotations-orgapacheariesblueprintannotationcollection" title="Permanent link">¶</a></h3> +<ul> +<li>@CollectionInject Inject list, set or array of existing beans of provided interface</li> +</ul> +<h3 id="bean-annotations-orgapacheariesblueprintannotationbean">Bean annotations (org.apache.aries.blueprint.annotation.bean)<a class="headerlink" href="#bean-annotations-orgapacheariesblueprintannotationbean" title="Permanent link">¶</a></h3> +<ul> +<li>@Bean Mark a class as a bean or method as factory of bean</li> +</ul> +<h3 id="reference-listener-annotations-orgapacheariesblueprintannotationreferencelistener">Reference listener annotations (org.apache.aries.blueprint.annotation.referencelistener)<a class="headerlink" href="#reference-listener-annotations-orgapacheariesblueprintannotationreferencelistener" title="Permanent link">¶</a></h3> +<ul> +<li>@ReferenceListener Marks bean as reference listener</li> +<li>@Bind Method of referenence listener to be called when service registers</li> +<li>@Unbind Method of referenence listener to be called when service unregisters</li> +</ul> +<h3 id="service-annotations-orgapacheariesblueprintannotationservice">Service annotations (org.apache.aries.blueprint.annotation.service)<a class="headerlink" href="#service-annotations-orgapacheariesblueprintannotationservice" title="Permanent link">¶</a></h3> +<ul> +<li>@Service Publishes a bean as an OSGi service with the given interfaces</li> +<li>@ServiceProperty Defines a service property </li> +<li>@Reference Creates a reference to an OSGi service</li> +<li>@ReferenceList Creates a list of references of an OSGi services</li> +</ul> +<h3 id="pax-cdi-supported-in-version-1x-probably-dropped-in-next-major-versions">pax-cdi (supported in version 1.x, probably dropped in next major versions)<a class="headerlink" href="#pax-cdi-supported-in-version-1x-probably-dropped-in-next-major-versions" title="Permanent link">¶</a></h3> +<ul> +<li>@OsgiServiceProvider(classes={TaskService.class}) Publishes a bean as an OSGi service with the given interfaces</li> +<li>@OsgiService creates a reference to an OSGi service. On optional filter is also possible</li> +<li>@Properties Defines service properties for OSGiServiceProvider</li> +<li>@Property Defines a service property </li> +</ul> <h3 id="spring-supported-in-version-1x-probably-dropped-in-next-major-versions">Spring (supported in version 1.x, probably dropped in next major versions)<a class="headerlink" href="#spring-supported-in-version-1x-probably-dropped-in-next-major-versions" title="Permanent link">¶</a></h3> <ul> <li>@Autowired Inject a bean by type and optionally further qualifiers</li> @@ -381,12 +402,6 @@ The generated blueprint can also be used <span class="nt"><optional></span>true<span class="nt"></optional></span> <span class="nt"></dependency></span> <span class="nt"><dependency></span> - <span class="nt"><groupId></span>org.ops4j.pax.cdi<span class="nt"></groupId></span> - <span class="nt"><artifactId></span>pax-cdi-api<span class="nt"></artifactId></span> - <span class="nt"><version></span>0.8.0<span class="nt"></version></span> - <span class="nt"><optional></span>true<span class="nt"></optional></span> -<span class="nt"></dependency></span> -<span class="nt"><dependency></span> <span class="nt"><groupId></span>javax.enterprise<span class="nt"></groupId></span> <span class="nt"><artifactId></span>cdi-api<span class="nt"></artifactId></span> <span class="nt"><version></span>1.2<span class="nt"></version></span> @@ -407,7 +422,13 @@ The generated blueprint can also be used <span class="nt"><dependency></span> <span class="nt"><groupId></span>org.apache.aries.blueprint<span class="nt"></groupId></span> <span class="nt"><artifactId></span>blueprint-maven-plugin-annotation<span class="nt"></artifactId></span> - <span class="nt"><version></span>1.0.0<span class="nt"></version></span> + <span class="nt"><version></span>1.3.0<span class="nt"></version></span> + <span class="nt"><optional></span>true<span class="nt"></optional></span> +<span class="nt"></dependency></span> +<span class="nt"><dependency></span> + <span class="nt"><groupId></span>org.ops4j.pax.cdi<span class="nt"></groupId></span> + <span class="nt"><artifactId></span>pax-cdi-api<span class="nt"></artifactId></span> + <span class="nt"><version></span>0.8.0<span class="nt"></version></span> <span class="nt"><optional></span>true<span class="nt"></optional></span> <span class="nt"></dependency></span> <span class="nt"><dependency></span> @@ -425,7 +446,7 @@ The generated blueprint can also be used <div class="codehilite"><pre><span class="nt"><dependency></span> <span class="nt"><groupId></span>org.apache.aries.blueprint<span class="nt"></groupId></span> <span class="nt"><artifactId></span>blueprint-maven-plugin-spi<span class="nt"></artifactId></span> - <span class="nt"><version></span>1.0.0<span class="nt"></version></span> + <span class="nt"><version></span>1.1.0<span class="nt"></version></span> <span class="nt"></dependency></span> </pre></div> @@ -434,7 +455,7 @@ The generated blueprint can also be used <div class="codehilite"><pre><span class="nt"><plugin></span> <span class="nt"><groupId></span>org.apache.aries.blueprint<span class="nt"></groupId></span> <span class="nt"><artifactId></span>blueprint-maven-plugin<span class="nt"></artifactId></span> - <span class="nt"><version></span>1.5.0<span class="nt"></version></span> + <span class="nt"><version></span>1.9.0<span class="nt"></version></span> ... <span class="nt"><dependencies></span> <span class="nt"><dependency></span> @@ -448,6 +469,17 @@ The generated blueprint can also be used </pre></div> +<h2 id="additional-configuration">Additional configuration<a class="headerlink" href="#additional-configuration" title="Permanent link">¶</a></h2> +<p>Bean from factories are named by bean class nams or as defined in @Named or @Bean annotations. +If you want to name such beans after producing method name then add configuration parameter:</p> +<div class="codehilite"><pre><span class="nt"><configuration></span> + <span class="nt"><customParameters></span> + <span class="nt"><blueprint.beanFromFactory.nameFromFactoryMethodName></span>true<span class="nt"></blueprint.beanFromFactory.nameFromFactoryMethodName></span> + <span class="nt"></customParameters></span> +<span class="nt"></configuration></span> +</pre></div> + + <h2 id="example">Example<a class="headerlink" href="#example" title="Permanent link">¶</a></h2> <p>For a complete example see <a href="https://github.com/cschneider/Karaf-Tutorial/tree/master/tasklist-blueprint-cdi">tasklist-blueprint-cdi</a> on github or <a href="http://svn.apache.org/repos/asf/aries/trunk/blueprint/plugin/blueprint-maven-plugin/src/test/">tests of blueprint-maven-plugin</a>.</p></div> <!-- Content -->