Blame - ipojo/api/doc/apache-felix-ipojo-api.html - onos-felix

<a href="" class="sf-with-ul">Overview<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>

76

77

78

79

</li>

80

81

<a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-why-choose-ipojo.html" title="apache-felix-ipojo-why-choose-ipojo">Why choose iPOJO</a>

82

</li>

83

84

<a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-successstories.html" title="apache-felix-ipojo-successstories">Success stories</a>

85

</li>

86

87

<a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-feature-overview.html" title="Apache Felix iPOJO Feature Overview">Features</a>

</li>

</ul>

</li>

94

</li><li>

95

<a href="http://felix.apache.org/site/download.html" title="Download">Download </a>

</li>

100

<a href="" class="sf-with-ul">Documentation<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>

101

102

103

104

<a style="float: none; width: auto;" href="" class="sf-with-ul">Getting Started<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>

105

106

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-in-10-minutes.html" title="iPOJO in 10 minutes">iPOJO in 10 minutes</a></li>

107

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/how-to-use-ipojo-annotations.html" title="How to use iPOJO Annotations">Using Annotations</a></li>

108

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-hello-word-maven-based-tutorial.html" title="iPOJO Hello Word (Maven-Based) tutorial">Maven tutorial</a></li>

109

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-advanced-tutorial.html" title="iPOJO Advanced Tutorial">Advanced tutorial</a></li>

110

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-dosgi.html" title="apache-felix-ipojo-dosgi">Using Distributed OSGi</a></li>

111

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-composition-tutorial.html" title="iPOJO Composition Tutorial">Application Composition</a></li>

112

</ul>

113

</li>

114

115

116

<a style="float: none; width: auto;" href="http://felix.apache.org/site/describing-components.html" class="sf-with-ul">Describing components<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>

117

118

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/service-requirement-handler.html" title="Service Requirement Handler">Requiring a service</a></li>

119

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/providing-osgi-services.html" title="Providing OSGi services">Providing a service</a></li>

120

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/lifecycle-callback-handler.html" title="Lifecycle Callback Handler">Lifecycle management</a></li>

121

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/configuration-handler.html" title="Configuration Handler">Configuration</a></li>

122

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/architecture-handler.html" title="Architecture Handler">Introspection</a></li>

123

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/controller-lifecycle-handler.html" title="Controller Lifecycle Handler">Impacting the lifecycle</a></li>

124

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/event-admin-handlers.html" title="Event Admin Handlers">Asynchronous communication</a></li>

125

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-jmx-handler.html" title="iPOJO JMX Handler">JMX management</a></li>

126

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/extender-pattern-handler.html" title="Extender Pattern Handler">Extender pattern</a></li>

127

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/white-board-pattern-handler.html" title="White Board Pattern Handler">Whiteboard pattern</a></li>

128

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/temporal-service-dependency.html" title="Temporal Service Dependency">Temporal dependencies</a></li>

129

</ul>

130

</li>

131

132

133

<a style="float: none; width: auto;" href="" class="sf-with-ul">User Guide<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>

134

135

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/using-xml-schemas.html" title="Using XML Schemas">XML Schemas</a></li>

136

137

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-testing-components.html" title="apache-felix-ipojo-testing-components">Testing components</a></li>

138

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-eclipse-integration.html" title="apache-felix-ipojo-eclipse-integration">Eclipse Integration</a></li>

139

140

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-reference-card.html" title="iPOJO-Reference-Card">Reference Card</a></li>

141

</ul>

142

</li>

143

144

145

<a style="float: none; width: auto;" href="" class="sf-with-ul">Advanced Topics<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>

146

147

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/ipojo/api/1.2.0" rel="nofollow">Javadoc</a></li>

148

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/how-to-write-your-own-handler.html" title="How to write your own handler">Handler guide</a></li>

149

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/how-to-use-ipojo-manipulation-metadata.html" title="How to use iPOJO Manipulation Metadata">Manipulation Metadata </a></li>

150

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/dive-into-the-ipojo-manipulation-depths.html" title="Dive into the iPOJO Manipulation depths">Dive into the iPOJO Manipulation depths</a></li>

151

</ul>

152

</li>

153

</ul>

154

</li>

155

156

157

<a href="" class="sf-with-ul">Tools<span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span><span class="sf-sub-indicator"> »</span></a>

158

159

160

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-eclipse-plug-in.html" title="iPOJO Eclipse Plug-in">Eclipse Plugin</a></li>

161

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-maven-plug-in.html" title="iPOJO Maven Plug-in">Maven Plugin</a></li>

162

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-online-manipulator.html" title="apache-felix-ipojo-online-manipulator">Online Manipulator</a></li>

163

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/ipojo-webconsole-plugin.html" title="iPOJO Webconsole Plugin">Webconsole plugin</a></li>

164

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-junit4osgi.html" title="apache-felix-ipojo-junit4osgi">Junit4OSGi</a></li>

165

</ul>

166

</li>

167

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-issuestracker.html" title="apache-felix-ipojo-issuestracker">Issues Tracker</a></li>

172

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-supportedvms.html" title="apache-felix-ipojo-supportedVMs">Supported JVMs</a></li>

173

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/apache-felix-ipojo-supportedosgi.html" title="apache-felix-ipojo-supportedOSGi">Supported OSGi Implementations</a></li>

174

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://ipojo-dark-side.blogspot.com/" rel="nofollow">iPOJO's Dark Side Blog</a></li>

175

<li style="white-space: normal; float: left; width: 100%;"><a style="float: none; width: auto;" href="http://felix.apache.org/site/article-presentations.html" title="Article & Presentations">Article & Presentations</a></li>

176

</ul>

177

</li>

178

</ul>

179

</div>

<h1><a name="apache-felix-ipojo-api-iPOJOAPI"></a>iPOJO API</h1>

185

186

<p><em>The iPOJO API provides a third way to describe iPOJO components.

187

With the API, you can dynamically create new components types and

188

create instances from them. Your component types are described with an

189

API. To use the API, deploy and start the iPOJO-API bundle and the

190

iPOJO core bundle.</em></p>

<ul>

<li><a href="#apache-felix-ipojo-api-Asimpleexample">A simple example</a></li>

195

<li><a href="#apache-felix-ipojo-api-PrimitiveComponentTypebasics">Primitive Component Type basics</a></li>

196

<li><a href="#apache-felix-ipojo-api-ImmediateComponent%252CValidateandInvalidateMethod">Immediate Component, Validate and Invalidate Method</a></li>

197

<li><a href="#apache-felix-ipojo-api-Declaringservices">Declaring services</a></li>

198

<li><a href="#apache-felix-ipojo-api-ServiceDependencies">Service Dependencies</a></li>

199

<li><a href="#apache-felix-ipojo-api-Properties">Properties</a></li>

200

<li><a href="#apache-felix-ipojo-api-TemporalDependencies">Temporal Dependencies</a></li>

201

<li><a href="#apache-felix-ipojo-api-Instancecreation">Instance creation</a></li>

202

<li><a href="#apache-felix-ipojo-api-ManagedServiceandPropagation">Managed Service and Propagation</a></li>

203

<li><a href="#apache-felix-ipojo-api-ManagingiPOJOFactory">Managing iPOJO Factory</a></li>

204

<li><a href="#apache-felix-ipojo-api-AccesstotheintrospectionAPI">Access to the introspection API</a></li>

205

<li><a href="#apache-felix-ipojo-api-SingletonComponentType">Singleton Component Type</a></li>

206

<li><a href="#apache-felix-ipojo-api-Usingexternalhandlers">Using external handlers</a></li>

207

<li><a href="#apache-felix-ipojo-api-CreatingcompositionwiththeAPI">Creating composition with the API</a></li>

</ul></div>

<div class="panelMacro"><table class="infoMacro"><colgroup><col width="24"><col></colgroup><tbody><tr><td valign="top"><img src="apache-felix-ipojo-api_files/information.gif" alt="" border="0" align="absmiddle" height="16" width="16"></td><td><b>1.3.0-SNAPSHOT feature</b><br><p>The API is a 1.3.0-SNAPSHOT feature, and is not available in the 1.2.0 release.</p></td></tr></tbody></table></div>

212

213

<h2><a name="apache-felix-ipojo-api-Asimpleexample"></a>A simple example</h2>

214

215

<p>Let's imagine a simple component providing a service Foo. The following code is the implementation class of our component:</p>

216

217

<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span></span><span class="keyword">package</span><span> org.example.service.impl; </span></td></tr><tr><td class="line2"> </td></tr><tr><td class="line1"><span class="keyword">import</span><span> org.example.service.Foo; </span></td></tr><tr><td class="line2"> </td></tr><tr><td class="line1"><span class="keyword">public</span><span> </span><span class="keyword">class</span><span> FooImpl </span><span class="keyword">implements</span><span> Foo { </span></td></tr><tr><td class="line2"> </td></tr><tr><td class="line1">    <span class="keyword">public</span><span> </span><span class="keyword">void</span><span> doSomething() { </span></td></tr><tr><td class="line2">        <span class="comment">// Do something...</span><span> </span></td></tr><tr><td class="line1">    } </td></tr><tr><td class="line2"> </td></tr><tr><td class="line1">} </td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">package org.example.service.impl;

218

219

import org.example.service.Foo;

220

221

public class FooImpl implements Foo {

222

223

public void doSomething() {

// Do something...

}

}</textarea>

if(!window.newcodemacro_initialised)

230

{

231

window.newcodemacro_initialised = true;

232

window.oldonloadmethod = window.onload;

233

window.onload = function(){

234

dp.SyntaxHighlighter.HighlightAll('newcodemacro');

235

if(window.oldonloadmethod)

236

{

237

window.oldonloadmethod();

}

}

}

</script>

</div>

<p>To create the component type and an instance of the component type

247

just create a class, get the bundle context (either from a

248

Bundle-Activator, or from an iPOJO component), and write the following

249

code:</p>

250

251

<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span>new PrimitiveComponentType() </span></td></tr><tr><td class="line2">    .setBundleContext(context) </td></tr><tr><td class="line1">    .setClassName(FooImpl.<span class="keyword">class</span><span>.getName()) </span></td></tr><tr><td class="line2">    .addService(new Service()) <span class="comment">// Provide the Foo service</span><span> </span></td></tr><tr><td class="line1">    .createInstance(); <span class="comment">// Create the instance</span><span> </span></td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">new PrimitiveComponentType()

252

.setBundleContext(context)

253

.setClassName(FooImpl.class.getName())

254

.addService(new Service()) // Provide the Foo service

255

.createInstance(); // Create the instance</textarea>

256

257

if(!window.newcodemacro_initialised)

258

{

259

window.newcodemacro_initialised = true;

260

window.oldonloadmethod = window.onload;

261

window.onload = function(){

262

dp.SyntaxHighlighter.HighlightAll('newcodemacro');

263

if(window.oldonloadmethod)

264

{

265

window.oldonloadmethod();

}

}

}

</script>

</div>

<p>So, now let's imagine another component using this service. The

275

following code is the implementation class of this component type:</p>

276

277

<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span></span><span class="keyword">package</span><span> org.example.service.impl; </span></td></tr><tr><td class="line2"> </td></tr><tr><td class="line1"><span class="keyword">import</span><span> org.example.service.Foo; </span></td></tr><tr><td class="line2"> </td></tr><tr><td class="line1"><span class="keyword">public</span><span> </span><span class="keyword">class</span><span> MyComponentImpl { </span></td></tr><tr><td class="line2">    <span class="keyword">private</span><span> Foo myFoo; </span></td></tr><tr><td class="line1"> </td></tr><tr><td class="line2">    <span class="keyword">public</span><span> </span><span class="keyword">void</span><span> start() { </span></td></tr><tr><td class="line1">        myFoo.doSomething(); </td></tr><tr><td class="line2">    } </td></tr><tr><td class="line1"> </td></tr><tr><td class="line2">} </td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">package org.example.service.impl;

278

279

import org.example.service.Foo;

280

281

public class MyComponentImpl {

282

private Foo myFoo;

283

284

public void start() {

myFoo.doSomething();

}

}</textarea>

if(!window.newcodemacro_initialised)

291

{

292

window.newcodemacro_initialised = true;

293

window.oldonloadmethod = window.onload;

294

window.onload = function(){

295

dp.SyntaxHighlighter.HighlightAll('newcodemacro');

296

if(window.oldonloadmethod)

297

{

298

window.oldonloadmethod();

}

}

}

</script>

</div>

<p>It is a regular iPOJO component expecting to get a Foo service in the <tt>myFoo</tt>

308

field. It also has a method executed when the instance is valid using

309

the Foo service. To describe this component, just write the following

310

lines:</p>

311

312

<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span>new PrimitiveComponentType() </span></td></tr><tr><td class="line2">    .setBundleContext(context) </td></tr><tr><td class="line1">    .setClassName(MyComponentImpl.<span class="keyword">class</span><span>.getName()) </span></td></tr><tr><td class="line2">    .addDependency(new Dependency().setField(<span class="string">"myFoo"</span><span>)) </span></td></tr><tr><td class="line1">    .setValidateMethod(<span class="string">"start"</span><span>) </span></td></tr><tr><td class="line2">    .createInstance(); </td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">new PrimitiveComponentType()

313

.setBundleContext(context)

314

.setClassName(MyComponentImpl.class.getName())

315

.addDependency(new Dependency().setField("myFoo"))

316

.setValidateMethod("start")

317

.createInstance();</textarea>

318

319

if(!window.newcodemacro_initialised)

320

{

321

window.newcodemacro_initialised = true;

322

window.oldonloadmethod = window.onload;

323

window.onload = function(){

324

dp.SyntaxHighlighter.HighlightAll('newcodemacro');

325

if(window.oldonloadmethod)

326

{

327

window.oldonloadmethod();

}

}

}

</script>

</div>

<h2><a name="apache-felix-ipojo-api-PrimitiveComponentTypebasics"></a>Primitive Component Type basics</h2>

337

338

<p>When you create a new Primitive component type (so, using a Java

339

class as implementation), you must set the bundle context and the class

340

name. Everything else is optional. </p>

341

342

<p>Note about inner classes: iPOJO is based on a bytecode manipulation.

343

The API embeds the manipulator. So, when you initialize the component

344

type, the specified class name is manipulated (if not already

345

manipulated). So, as this force using a customized classloader, inner

346

classes cannot be manipulated. So, inner class injection is not

347

supported with the API.</p>

348

349

<h2><a name="apache-felix-ipojo-api-ImmediateComponent,ValidateandInvalidateMethod"></a>Immediate Component, Validate and Invalidate Method</h2>

350

<p>To set the component type as immediate, just call the <tt>setImmediate(immediate)</tt> method on the primitive component type object. <br>

351

To set validate and invalidate methods, just call the <tt>setValidate(method)</tt> and <tt>setInvalidate(method)</tt>. Specify the method name that you want to call in argument. </p>

352

353

<h2><a name="apache-felix-ipojo-api-Declaringservices"></a>Declaring services</h2>

354

<p>To declare that a component provides a service, add a new service to your primitive component type.<br>

355

The Service object can be configured. By default, it exposed every implemented interface (regular iPOJO behavior). So, you can:</p>

356

<ul>

357

<li>Add service property</li>

358

<li>Set the creation strategy</li>

359

<li>Set the exposed service specifications</li>

</ul>

<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span>new PrimitiveComponentType() </span></td></tr><tr><td class="line2">    .setBundleContext(context) </td></tr><tr><td class="line1">    .setClassName(org.example.service.impl.MyComponentImpl.<span class="keyword">class</span><span>.getName()) </span></td></tr><tr><td class="line2">    .addService(new Service() </td></tr><tr><td class="line1">        .addProperty(new ServiceProperty() </td></tr><tr><td class="line2">            .setField(<span class="string">"myServiceProperty"</span><span>) </span></td></tr><tr><td class="line1">            .setName(<span class="string">"sample.myProperty"</span><span>)) </span></td></tr><tr><td class="line2">        .setCreationStrategy(Service.INSTANCE_STRATEGY)) </td></tr><tr><td class="line1">    .createInstance(); </td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">new PrimitiveComponentType()

365

.setBundleContext(context)

366

.setClassName(org.example.service.impl.MyComponentImpl.class.getName())

367

.addService(new Service()

368

.addProperty(new ServiceProperty()

369

.setField("myServiceProperty")

370

.setName("sample.myProperty"))

371

.setCreationStrategy(Service.INSTANCE_STRATEGY))

372

.createInstance();</textarea>

373

374

if(!window.newcodemacro_initialised)

375

{

376

window.newcodemacro_initialised = true;

377

window.oldonloadmethod = window.onload;

378

window.onload = function(){

379

dp.SyntaxHighlighter.HighlightAll('newcodemacro');

380

if(window.oldonloadmethod)

381

{

382

window.oldonloadmethod();

}

}

}

</script>

</div>

<h2><a name="apache-felix-ipojo-api-ServiceDependencies"></a>Service Dependencies</h2>

392

<p>To declare a service dependency, create and add a Dependency object.

393

The dependency object offers all the iPOJO service dependency features.

394

You can set the injected field and/or bind/unbind methods. Here is an

395

example:</p>

396

397

<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span>new PrimitiveComponentType() </span></td></tr><tr><td class="line2">    .setBundleContext(context) </td></tr><tr><td class="line1">    .setClassName(org.example.service.impl.MyComponentImpl.<span class="keyword">class</span><span>.getName()) </span></td></tr><tr><td class="line2">    .addDependency( </td></tr><tr><td class="line1">        new Dependency().setField(<span class="string">"myFoo"</span><span>) </span></td></tr><tr><td class="line2">       .setOptional(<span class="keyword">true</span><span>) </span></td></tr><tr><td class="line1">       .setDefaultImplementation(<span class="string">"org.sample.FooDefaultImplementation"</span><span>) </span></td></tr><tr><td class="line2">       ) </td></tr><tr><td class="line1">    .createInstance(); </td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">new PrimitiveComponentType()

398

.setBundleContext(context)

399

.setClassName(org.example.service.impl.MyComponentImpl.class.getName())

400

.addDependency(

401

new Dependency().setField("myFoo")

402

.setOptional(true)

403

.setDefaultImplementation("org.sample.FooDefaultImplementation")

404

)

405

.createInstance();</textarea>

406

407

if(!window.newcodemacro_initialised)

408

{

409

window.newcodemacro_initialised = true;

410

window.oldonloadmethod = window.onload;

411

window.onload = function(){

412

dp.SyntaxHighlighter.HighlightAll('newcodemacro');

413

if(window.oldonloadmethod)

414

{

415

window.oldonloadmethod();

}

}

}

</script>

</div>

<h2><a name="apache-felix-ipojo-api-Properties"></a>Properties</h2>

425

<p>Thanks to the <tt>addProperty</tt> method, you can create component properties. Here is some example of properties:</p>

426

427

<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span>new PrimitiveComponentType() </span></td></tr><tr><td class="line2">    .setBundleContext(context) </td></tr><tr><td class="line1">    .setClassName(MyComponentImpl.<span class="keyword">class</span><span>.getName()) </span></td></tr><tr><td class="line2">    .addProperty(new Property() </td></tr><tr><td class="line1">        .setField(<span class="string">"myProperty"</span><span>) </span></td></tr><tr><td class="line2">        .setValue(<span class="string">"default-value"</span><span>) </span></td></tr><tr><td class="line1">        ) </td></tr><tr><td class="line2">    .addProperty(new Property() </td></tr><tr><td class="line1">        .setMethod(<span class="string">"setMethod"</span><span>) </span></td></tr><tr><td class="line2">        .setName(<span class="string">"prop"</span><span>) </span></td></tr><tr><td class="line1">    ) </td></tr><tr><td class="line2">    .createInstance(); </td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">new PrimitiveComponentType()

428

.setBundleContext(context)

429

.setClassName(MyComponentImpl.class.getName())

430

.addProperty(new Property()

431

.setField("myProperty")

432

.setValue("default-value")

433

)

434

.addProperty(new Property()

435

.setMethod("setMethod")

436

.setName("prop")

437

)

438

.createInstance();</textarea>

439

440

if(!window.newcodemacro_initialised)

441

{

442

window.newcodemacro_initialised = true;

443

window.oldonloadmethod = window.onload;

444

window.onload = function(){

445

dp.SyntaxHighlighter.HighlightAll('newcodemacro');

446

if(window.oldonloadmethod)

447

{

448

window.oldonloadmethod();

}

}

}

</script>

</div>

<h2><a name="apache-felix-ipojo-api-TemporalDependencies"></a>Temporal Dependencies</h2>

458

<p>Temporal dependencies are also supported: </p>

459

460

<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span>new PrimitiveComponentType() </span></td></tr><tr><td class="line2">        .setBundleContext(context) </td></tr><tr><td class="line1">        .setClassName(MyComponentImpl.<span class="keyword">class</span><span>.getName()) </span></td></tr><tr><td class="line2">        .addDependency( </td></tr><tr><td class="line1">             new TemporalDependency().setField(<span class="string">"myFoo"</span><span>) </span></td></tr><tr><td class="line2">            .setOnTimeoutPolicy(TemporalDependency.NULLABLE) </td></tr><tr><td class="line1">            .setTimeout(3000) </td></tr><tr><td class="line2">            .setProxy(<span class="keyword">true</span><span>) </span></td></tr><tr><td class="line1">            ) </td></tr><tr><td class="line2">        .createInstance(); </td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">new PrimitiveComponentType()

461

.setBundleContext(context)

462

.setClassName(MyComponentImpl.class.getName())

463

.addDependency(

464

new TemporalDependency().setField("myFoo")

465

.setOnTimeoutPolicy(TemporalDependency.NULLABLE)

.setTimeout(3000)

.setProxy(true)

)

.createInstance();</textarea>

470

471

if(!window.newcodemacro_initialised)

472

{

473

window.newcodemacro_initialised = true;

474

window.oldonloadmethod = window.onload;

475

window.onload = function(){

476

dp.SyntaxHighlighter.HighlightAll('newcodemacro');

477

if(window.oldonloadmethod)

478

{

479

window.oldonloadmethod();

}

}

}

</script>

</div>

<h2><a name="apache-felix-ipojo-api-Instancecreation"></a>Instance creation</h2>

489

<p>The API allows you to create instances from the component type you described. Three differents methods.<br>

490

The <tt>createInstance()</tt> method just creates an instance. The <tt>createInstance(String name)</tt> method allows to set the instance name. Finally, the <tt>createInstance(Dictionary configuration)</tt>

491

allows setting the instance configuration. All those methods returns

492

the ComponentInstance object allowing to manage the instance (stop,

493

start, dispose). </p>

494

495

<h2><a name="apache-felix-ipojo-api-ManagedServiceandPropagation"></a>Managed Service and Propagation</h2>

496

<p>You can enable/disable the property propagation thanks to the <tt>setPropagation</tt> method on the PrimitiveComponentType object. <br>

497

You can also set the the managed service PID with the <tt>setManagedServicePID</tt>

498

method. This method should be only use to give a default value of for

499

singleton component. In all other case, the managed service pid has to

500

be provided inside the instance configuration.</p>

501

502

<h2><a name="apache-felix-ipojo-api-ManagingiPOJOFactory"></a>Managing iPOJO Factory</h2>

503

<p>Beyond the PrimitiveComponentType, an iPOJO factory is hidden. You can configure this factory to be public or private with the <tt>setPublic</tt> method. You can also set the name of the factory with the <tt>setName</tt> method. </p>

504

505

<p>Then, you can access to the Factory object by calling the <tt>getFactory</tt> method.</p>

506

507

<h2><a name="apache-felix-ipojo-api-AccesstotheintrospectionAPI"></a>Access to the introspection API</h2>

508

<p>The API provides bridge to get access to the iPOJO introspection

509

API. The introspection API allows reconfiguring at runtime an instance

510

(properties, service dependencies...). From Service and Dependency,

511

Property and ServiceProperty objects, call the <tt>getXXXDescription</tt>

512

method. You must give the instance that you want to introspect in

513

argument. If the lookup success, you get an object allowing

514

reconfiguring the service, dependency or property. </p>

515

516

<h2><a name="apache-felix-ipojo-api-SingletonComponentType"></a>Singleton Component Type</h2>

517

<p>If you are sure to create only one instance of your component type,

518

you can use the singleton component type class. This is a kind of

519

primitive component type, but when you start it (with the <tt>create</tt> method), it will automatically create an instance.</p>

520

521

<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span>PrimitiveComponentType type = new SingletonComponentType() </span></td></tr><tr><td class="line2">            .setBundleContext(context) </td></tr><tr><td class="line1">            .setClassName(org.example.service.impl.MyComponentImpl.<span class="keyword">class</span><span>.getName()) </span></td></tr><tr><td class="line2">            .addDependency(new Dependency().setField(<span class="string">"myFoo"</span><span>)) </span></td></tr><tr><td class="line1">            .setValidateMethod(<span class="string">"start"</span><span>); </span></td></tr><tr><td class="line2">         </td></tr><tr><td class="line1">        ((SingletonComponentType) type) </td></tr><tr><td class="line2">            .setObject(new MyComponentImpl(5)) <span class="comment">// Inject a pojo object</span><span> </span></td></tr><tr><td class="line1">            .create();<span class="comment">// Create an instance</span><span> </span></td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">PrimitiveComponentType type = new SingletonComponentType()

522

.setBundleContext(context)

523

.setClassName(org.example.service.impl.MyComponentImpl.class.getName())

524

.addDependency(new Dependency().setField("myFoo"))

525

.setValidateMethod("start");

526

527

((SingletonComponentType) type)

528

.setObject(new MyComponentImpl(5)) // Inject a pojo object

529

.create();// Create an instance</textarea>

530

531

if(!window.newcodemacro_initialised)

532

{

533

window.newcodemacro_initialised = true;

534

window.oldonloadmethod = window.onload;

535

window.onload = function(){

536

dp.SyntaxHighlighter.HighlightAll('newcodemacro');

537

if(window.oldonloadmethod)

538

{

539

window.oldonloadmethod();

}

}

}

</script>

</div>

<p>The type created with the singleton component type are set to <tt>private</tt> by default. Instead of calling the <tt>start</tt> method, you have to call one of the <tt>create</tt> methods to start the type and create the instance.</p>

549

550

<p>You can also set the contained POJO object by using the <tt>setObject</tt> method. The given object MUST be compatible with the component implementation class.</p>

551

552

<h2><a name="apache-felix-ipojo-api-Usingexternalhandlers"></a>Using external handlers</h2>

553

<p>iPOJO is extensible... So, it makes sense that the API is also

554

extensible. So component type provides a method allowing to add

555

external handler configuration:</p>

556

557

<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span></span><span class="keyword">return</span><span> new PrimitiveComponentType() </span></td></tr><tr><td class="line2">        .setBundleContext(context) </td></tr><tr><td class="line1">        .setClassName(HostImpl.<span class="keyword">class</span><span>.getName()) </span></td></tr><tr><td class="line2">        .addHandler(new Whiteboard() </td></tr><tr><td class="line1">            .onArrival(<span class="string">"arrival"</span><span>) </span></td></tr><tr><td class="line2">            .onDeparture(<span class="string">"departure"</span><span>) </span></td></tr><tr><td class="line1">            .setFilter(<span class="string">"(foo=foo)"</span><span>) </span></td></tr><tr><td class="line2">         ); </td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">return new PrimitiveComponentType()

558

.setBundleContext(context)

559

.setClassName(HostImpl.class.getName())

560

.addHandler(new Whiteboard()

561

.onArrival("arrival")

562

.onDeparture("departure")

563

.setFilter("(foo=foo)")

564

);</textarea>

565

566

if(!window.newcodemacro_initialised)

567

{

568

window.newcodemacro_initialised = true;

569

window.oldonloadmethod = window.onload;

570

window.onload = function(){

571

dp.SyntaxHighlighter.HighlightAll('newcodemacro');

572

if(window.oldonloadmethod)

573

{

574

window.oldonloadmethod();

}

}

}

</script>

</div>

<p>The <tt>addHandler</tt> method allows you to add any handler description. A handler description is an object of a class implementing <tt>org.apache.felix.ipojo.api.HandlerConfiguration</tt>. Handler provider willing to support the API have to provide this class. For example, the example above uses <tt>Whiteboard</tt> that is the Whiteboard pattern handler description. This class is very simple, and is shown below:</p>

584

585

<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span></span><span class="keyword">public</span><span> </span><span class="keyword">class</span><span> Whiteboard </span><span class="keyword">implements</span><span> HandlerConfiguration { </span></td></tr><tr><td class="line2">     </td></tr><tr><td class="line1">    <span class="keyword">public</span><span> </span><span class="keyword">static</span><span> </span><span class="keyword">final</span><span> String NAME = </span><span class="string">"wbp"</span><span>; </span></td></tr><tr><td class="line2">     </td></tr><tr><td class="line1">    <span class="keyword">public</span><span> </span><span class="keyword">static</span><span> </span><span class="keyword">final</span><span> String NAMESPACE = </span><span class="string">"org.apache.felix.ipojo.whiteboard"</span><span>; </span></td></tr><tr><td class="line2">     </td></tr><tr><td class="line1">    <span class="keyword">private</span><span> String arrival; </span></td></tr><tr><td class="line2">     </td></tr><tr><td class="line1">    <span class="keyword">private</span><span> String departure; </span></td></tr><tr><td class="line2">     </td></tr><tr><td class="line1">    <span class="keyword">private</span><span> String modification; </span></td></tr><tr><td class="line2">     </td></tr><tr><td class="line1">    <span class="keyword">private</span><span> String filter; </span></td></tr><tr><td class="line2">     </td></tr><tr><td class="line1">    <span class="keyword">public</span><span> Whiteboard onArrival(String method) { </span></td></tr><tr><td class="line2">        arrival = method; </td></tr><tr><td class="line1">        <span class="keyword">return</span><span> </span><span class="keyword">this</span><span>; </span></td></tr><tr><td class="line2">    } </td></tr><tr><td class="line1">     </td></tr><tr><td class="line2">    <span class="keyword">public</span><span> Whiteboard onDeparture(String method) { </span></td></tr><tr><td class="line1">        departure = method; </td></tr><tr><td class="line2">        <span class="keyword">return</span><span> </span><span class="keyword">this</span><span>; </span></td></tr><tr><td class="line1">    } </td></tr><tr><td class="line2">     </td></tr><tr><td class="line1">    <span class="keyword">public</span><span> Whiteboard onModification(String method) { </span></td></tr><tr><td class="line2">        modification = method; </td></tr><tr><td class="line1">        <span class="keyword">return</span><span> </span><span class="keyword">this</span><span>; </span></td></tr><tr><td class="line2">    } </td></tr><tr><td class="line1">     </td></tr><tr><td class="line2">    <span class="keyword">public</span><span> Whiteboard setFilter(String fil) { </span></td></tr><tr><td class="line1">        filter = fil; </td></tr><tr><td class="line2">        <span class="keyword">return</span><span> </span><span class="keyword">this</span><span>; </span></td></tr><tr><td class="line1">    } </td></tr><tr><td class="line2"> </td></tr><tr><td class="line1">    <span class="keyword">public</span><span> Element getElement() { </span></td></tr><tr><td class="line2">        ensureValidity(); </td></tr><tr><td class="line1">        <span class="comment">// Create the root element.</span><span> </span></td></tr><tr><td class="line2">        Element element = new Element(NAME, NAMESPACE); </td></tr><tr><td class="line1">        <span class="comment">// Mandatory attributes</span><span> </span></td></tr><tr><td class="line2">        element.addAttribute(new Attribute(<span class="string">"onArrival"</span><span>, arrival)); </span></td></tr><tr><td class="line1">        element.addAttribute(new Attribute(<span class="string">"onDeparture"</span><span>, departure)); </span></td></tr><tr><td class="line2">        element.addAttribute(new Attribute(<span class="string">"filter"</span><span>, filter)); </span></td></tr><tr><td class="line1">         </td></tr><tr><td class="line2">        <span class="comment">// Optional attribute</span><span> </span></td></tr><tr><td class="line1">        <span class="keyword">if</span><span> (modification != </span><span class="keyword">null</span><span>) { </span></td></tr><tr><td class="line2">            element.addAttribute(new Attribute(<span class="string">"onModification"</span><span>, modification)); </span></td></tr><tr><td class="line1">        }         </td></tr><tr><td class="line2">         </td></tr><tr><td class="line1">        <span class="keyword">return</span><span> element; </span></td></tr><tr><td class="line2">    } </td></tr><tr><td class="line1"> </td></tr><tr><td class="line2">    <span class="keyword">private</span><span> </span><span class="keyword">void</span><span> ensureValidity() { </span></td></tr><tr><td class="line1">        <span class="keyword">if</span><span> (arrival == </span><span class="keyword">null</span><span>) { </span></td></tr><tr><td class="line2">            <span class="keyword">throw</span><span> new IllegalStateException(</span><span class="string">"The whiteboard pattern configuration must have a onArrival method"</span><span>); </span></td></tr><tr><td class="line1">        } </td></tr><tr><td class="line2">        <span class="keyword">if</span><span> (departure == </span><span class="keyword">null</span><span>) { </span></td></tr><tr><td class="line1">            <span class="keyword">throw</span><span> new IllegalStateException(</span><span class="string">"The whiteboard pattern configuration must have a onDeparture method"</span><span>); </span></td></tr><tr><td class="line2">        } </td></tr><tr><td class="line1">        <span class="keyword">if</span><span> (filter == </span><span class="keyword">null</span><span>) { </span></td></tr><tr><td class="line2">            <span class="keyword">throw</span><span> new IllegalStateException(</span><span class="string">"The whiteboard pattern configuration must have a filter"</span><span>); </span></td></tr><tr><td class="line1">        } </td></tr><tr><td class="line2">         </td></tr><tr><td class="line1">    } </td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">public class Whiteboard implements HandlerConfiguration {

586

587

public static final String NAME = "wbp";

588

589

public static final String NAMESPACE = "org.apache.felix.ipojo.whiteboard";

590

591

private String arrival;

592

593

private String departure;

594

595

private String modification;

596

597

private String filter;

598

599

public Whiteboard onArrival(String method) {

arrival = method;

return this;

}

public Whiteboard onDeparture(String method) {

departure = method;

return this;

}

public Whiteboard onModification(String method) {

610

modification = method;

return this;

}

public Whiteboard setFilter(String fil) {

filter = fil;

return this;

}

public Element getElement() {

620

ensureValidity();

621

// Create the root element.

622

Element element = new Element(NAME, NAMESPACE);

623

// Mandatory attributes

624

element.addAttribute(new Attribute("onArrival", arrival));

625

element.addAttribute(new Attribute("onDeparture", departure));

626

element.addAttribute(new Attribute("filter", filter));

627

628

// Optional attribute

629

if (modification != null) {

630

element.addAttribute(new Attribute("onModification", modification));

}

return element;

}

private void ensureValidity() {

637

if (arrival == null) {

638

throw new IllegalStateException("The whiteboard pattern configuration must have a onArrival method");

639

}

640

if (departure == null) {

641

throw new IllegalStateException("The whiteboard pattern configuration must have a onDeparture method");

642

}

643

if (filter == null) {

644

throw new IllegalStateException("The whiteboard pattern configuration must have a filter");

}

}</textarea>

if(!window.newcodemacro_initialised)

650

{

651

window.newcodemacro_initialised = true;

652

window.oldonloadmethod = window.onload;

653

window.onload = function(){

654

dp.SyntaxHighlighter.HighlightAll('newcodemacro');

655

if(window.oldonloadmethod)

656

{

657

window.oldonloadmethod();

}

}

}

</script>

</div>

<p>The only required method is <tt>getElement</tt> returning the

667

Element-Attribute structure representing the handler configuration

668

(this uses the internal iPOJO data format). If the metadata cannot be

669

generated, the class throws IllegalStateExceptions.</p>

670

671

<h2><a name="apache-felix-ipojo-api-CreatingcompositionwiththeAPI"></a>Creating composition with the API</h2>

672

<p>The API also allows you to create iPOJO compositions in a pretty simple way. So you can create compositions:</p>

673

<ul>

674

<li>containing internal instances</li>

675

<li>importing services</li>

676

<li>instantiating sub-services</li>

677

<li>exporting services</li>

678

<li>providing services (by delegation)</li>

</ul>

<p>Here are some examples:</p>

683

684

<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span>PrimitiveComponentType prov = createAProvider(); </span><span class="comment">// Create a primitive type</span><span> </span></td></tr><tr><td class="line2"> PrimitiveComponentType cons = createAConsumer(); <span class="comment">// Create another primitive type</span><span> </span></td></tr><tr><td class="line1">        </td></tr><tr><td class="line2">       CompositeComponentType type = new CompositeComponentType() </td></tr><tr><td class="line1">           .setBundleContext(context) </td></tr><tr><td class="line2">           .setComponentTypeName(<span class="string">"comp1"</span><span>) </span></td></tr><tr><td class="line1">           .addInstance(new Instance(prov.getFactory().getName())) <span class="comment">// Create an instance in the composite</span><span> </span></td></tr><tr><td class="line2">           .addInstance(new Instance(cons.getFactory().getName()));  </td></tr><tr><td class="line1">        </td></tr><tr><td class="line2">       ComponentInstance ci = type.createInstance(); </td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">PrimitiveComponentType prov = createAProvider(); // Create a primitive type

685

PrimitiveComponentType cons = createAConsumer(); // Create another primitive type

686

687

CompositeComponentType type = new CompositeComponentType()

688

.setBundleContext(context)

689

.setComponentTypeName("comp1")

690

.addInstance(new Instance(prov.getFactory().getName())) // Create an instance in the composite

691

.addInstance(new Instance(cons.getFactory().getName()));

692

693

ComponentInstance ci = type.createInstance();</textarea>

694

695

if(!window.newcodemacro_initialised)

696

{

697

window.newcodemacro_initialised = true;

698

window.oldonloadmethod = window.onload;

699

window.onload = function(){

700

dp.SyntaxHighlighter.HighlightAll('newcodemacro');

701

if(window.oldonloadmethod)

702

{

703

window.oldonloadmethod();

}

}

}

</script>

</div>

<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span>CompositeComponentType type = new CompositeComponentType() </span></td></tr><tr><td class="line2">           .setBundleContext(context) </td></tr><tr><td class="line1">           .setComponentTypeName(<span class="string">"comp3"</span><span>) </span></td></tr><tr><td class="line2">           .addSubService(new InstantiatedService() <span class="comment">// Importation</span><span> </span></td></tr><tr><td class="line1">              .setSpecification(Foo.<span class="keyword">class</span><span>.getName()) </span></td></tr><tr><td class="line2">              .setOptional(<span class="keyword">true</span><span>)); </span></td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">CompositeComponentType type = new CompositeComponentType()

713

.setBundleContext(context)

714

.setComponentTypeName("comp3")

715

.addSubService(new InstantiatedService() // Importation

716

.setSpecification(Foo.class.getName())

717

.setOptional(true));</textarea>

718

719

if(!window.newcodemacro_initialised)

720

{

721

window.newcodemacro_initialised = true;

722

window.oldonloadmethod = window.onload;

723

window.onload = function(){

724

dp.SyntaxHighlighter.HighlightAll('newcodemacro');

725

if(window.oldonloadmethod)

726

{

727

window.oldonloadmethod();

}

}

}

</script>

</div>

<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span>CompositeComponentType type = new CompositeComponentType() </span></td></tr><tr><td class="line2">           .setBundleContext(context) </td></tr><tr><td class="line1">           .setComponentTypeName(<span class="string">"comp2"</span><span>) </span></td></tr><tr><td class="line2">           .addSubService(new InstantiatedService()  <span class="comment">// Instantiated service</span><span> </span></td></tr><tr><td class="line1">              .setSpecification(Foo.<span class="keyword">class</span><span>.getName())) </span></td></tr><tr><td class="line2">           .addInstance(new Instance(cons.getFactory().getName())); </td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">CompositeComponentType type = new CompositeComponentType()

737

.setBundleContext(context)

738

.setComponentTypeName("comp2")

739

.addSubService(new InstantiatedService() // Instantiated service

740

.setSpecification(Foo.class.getName()))

741

.addInstance(new Instance(cons.getFactory().getName()));</textarea>

742

743

if(!window.newcodemacro_initialised)

744

{

745

window.newcodemacro_initialised = true;

746

window.oldonloadmethod = window.onload;

747

window.onload = function(){

748

dp.SyntaxHighlighter.HighlightAll('newcodemacro');

749

if(window.oldonloadmethod)

750

{

751

window.oldonloadmethod();

}

}

}

</script>

</div>

<div class="dp-highlighter"><table class="dp-c" border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="line1"><span>CompositeComponentType type = new CompositeComponentType() </span></td></tr><tr><td class="line2">           .setBundleContext(context) </td></tr><tr><td class="line1">           .setComponentTypeName(<span class="string">"compExport"</span><span>) </span></td></tr><tr><td class="line2">           .addSubService(new InstantiatedService().setSpecification(Foo.<span class="keyword">class</span><span>.getName())) </span></td></tr><tr><td class="line1">           .addService(new ExportedService() </td></tr><tr><td class="line2">                .setSpecification(Foo.<span class="keyword">class</span><span>.getName())); </span><span class="comment">// Exports a service</span><span> </span></td></tr></tbody></table></div><textarea style="display: none;" name="newcodemacro" class="java:nocontrols:nogutter" rows="10" readonly="readonly">CompositeComponentType type = new CompositeComponentType()

761

.setBundleContext(context)

762

.setComponentTypeName("compExport")

763

.addSubService(new InstantiatedService().setSpecification(Foo.class.getName()))

764

.addService(new ExportedService()

765

.setSpecification(Foo.class.getName())); // Exports a service</textarea>

766

767