blob: f3343b2208940a5416a68027775bc8d8f88c871f [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc (version 1.7.0_25) on Tue Oct 08 19:30:29 CEST 2013 -->
<meta http-equiv="Content-Type" content="text/html" charset="UTF-8">
<title>TrackerCustomizer (Apache Felix iPOJO ~ JavaDoc 1.10.1 API)</title>
<meta name="date" content="2013-10-08">
<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
</head>
<body>
<script type="text/javascript"><!--
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="TrackerCustomizer (Apache Felix iPOJO ~ JavaDoc 1.10.1 API)";
}
//-->
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a name="navbar_top">
<!-- -->
</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/TrackerCustomizer.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../../index-all.html">Index</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../../../org/apache/felix/ipojo/util/Tracker.Tracked.html" title="class in org.apache.felix.ipojo.util"><span class="strong">Prev Class</span></a></li>
<li>Next Class</li>
</ul>
<ul class="navList">
<li><a href="../../../../../index.html?org/apache/felix/ipojo/util/TrackerCustomizer.html" target="_top">Frames</a></li>
<li><a href="TrackerCustomizer.html" target="_top">No Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../../../../allclasses-noframe.html">All Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_top");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method_summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method_detail">Method</a></li>
</ul>
</div>
<a name="skip-navbar_top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
<!-- ======== START OF CLASS DATA ======== -->
<div class="header">
<div class="subTitle">org.apache.felix.ipojo.util</div>
<h2 title="Interface TrackerCustomizer" class="title">Interface TrackerCustomizer</h2>
</div>
<div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>All Known Implementing Classes:</dt>
<dd><a href="../../../../../org/apache/felix/ipojo/ComponentFactory.html" title="class in org.apache.felix.ipojo">ComponentFactory</a>, <a href="../../../../../org/apache/felix/ipojo/composite/CompositeFactory.html" title="class in org.apache.felix.ipojo.composite">CompositeFactory</a>, <a href="../../../../../org/apache/felix/ipojo/composite/CompositeServiceContext.html" title="class in org.apache.felix.ipojo.composite">CompositeServiceContext</a>, <a href="../../../../../org/apache/felix/ipojo/util/ContextSourceManager.SourceTracker.html" title="class in org.apache.felix.ipojo.util">ContextSourceManager.SourceTracker</a>, <a href="../../../../../org/apache/felix/ipojo/HandlerManagerFactory.html" title="class in org.apache.felix.ipojo">HandlerManagerFactory</a>, <a href="../../../../../org/apache/felix/ipojo/dependency/impl/ServiceReferenceManager.html" title="class in org.apache.felix.ipojo.dependency.impl">ServiceReferenceManager</a>, <a href="../../../../../org/apache/felix/ipojo/composite/util/SourceManager.SourceTracker.html" title="class in org.apache.felix.ipojo.composite.util">SourceManager.SourceTracker</a>, <a href="../../../../../org/apache/felix/ipojo/util/Tracker.html" title="class in org.apache.felix.ipojo.util">Tracker</a></dd>
</dl>
<hr>
<br>
<pre>public interface <a href="../../../../../src-html/org/apache/felix/ipojo/util/TrackerCustomizer.html#line.27">TrackerCustomizer</a></pre>
<div class="block">Tracker Customizer.</div>
<dl><dt><span class="strong">Author:</span></dt>
<dd><a href="mailto:dev@felix.apache.org">Felix Project Team</a></dd></dl>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method_summary">
<!-- -->
</a>
<h3>Method Summary</h3>
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
<caption><span>Methods</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../../../org/apache/felix/ipojo/util/TrackerCustomizer.html#addedService(org.osgi.framework.ServiceReference)">addedService</a></strong>(<a href="http://www.osgi.org/javadoc/r4v43/core/org/osgi/framework/ServiceReference.html?is-external=true" title="class or interface in org.osgi.framework">ServiceReference</a>&nbsp;reference)</code>
<div class="block">A service tracked by the Tracker object has been added in the list.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../../org/apache/felix/ipojo/util/TrackerCustomizer.html#addingService(org.osgi.framework.ServiceReference)">addingService</a></strong>(<a href="http://www.osgi.org/javadoc/r4v43/core/org/osgi/framework/ServiceReference.html?is-external=true" title="class or interface in org.osgi.framework">ServiceReference</a>&nbsp;reference)</code>
<div class="block">A service is being added to the Tracker object.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../../../org/apache/felix/ipojo/util/TrackerCustomizer.html#modifiedService(org.osgi.framework.ServiceReference, java.lang.Object)">modifiedService</a></strong>(<a href="http://www.osgi.org/javadoc/r4v43/core/org/osgi/framework/ServiceReference.html?is-external=true" title="class or interface in org.osgi.framework">ServiceReference</a>&nbsp;reference,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;service)</code>
<div class="block">A service tracked by the Tracker object has been modified.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../../../org/apache/felix/ipojo/util/TrackerCustomizer.html#removedService(org.osgi.framework.ServiceReference, java.lang.Object)">removedService</a></strong>(<a href="http://www.osgi.org/javadoc/r4v43/core/org/osgi/framework/ServiceReference.html?is-external=true" title="class or interface in org.osgi.framework">ServiceReference</a>&nbsp;reference,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;service)</code>
<div class="block">A service tracked by the Tracker object has been removed.</div>
</td>
</tr>
</table>
</li>
</ul>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method_detail">
<!-- -->
</a>
<h3>Method Detail</h3>
<a name="addingService(org.osgi.framework.ServiceReference)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>addingService</h4>
<pre>boolean&nbsp;<a href="../../../../../src-html/org/apache/felix/ipojo/util/TrackerCustomizer.html#line.39">addingService</a>(<a href="http://www.osgi.org/javadoc/r4v43/core/org/osgi/framework/ServiceReference.html?is-external=true" title="class or interface in org.osgi.framework">ServiceReference</a>&nbsp;reference)</pre>
<div class="block">A service is being added to the Tracker object.
This method is called before a service which matched the search parameters of the Tracker object is added to
it. This method should return the service object to be tracked for this ServiceReference object.
If this method returns <code>true</code>, the service object becomes available from the <a href="../../../../../org/apache/felix/ipojo/util/Tracker.html#getService()"><code>Tracker.getService()</code></a> and
<a href="../../../../../org/apache/felix/ipojo/util/Tracker.html#getServices()"><code>Tracker.getServices()</code></a> methods. However notice that the service is still not accessible at that time.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>reference</code> - the Reference to service being added to the Tracker object.</dd>
<dt><span class="strong">Returns:</span></dt><dd><code>true</code> if the service reference must be tracked. <code>false</code> ff the service reference must be
ignored (un-tracked)</dd></dl>
</li>
</ul>
<a name="addedService(org.osgi.framework.ServiceReference)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>addedService</h4>
<pre>void&nbsp;<a href="../../../../../src-html/org/apache/felix/ipojo/util/TrackerCustomizer.html#line.49">addedService</a>(<a href="http://www.osgi.org/javadoc/r4v43/core/org/osgi/framework/ServiceReference.html?is-external=true" title="class or interface in org.osgi.framework">ServiceReference</a>&nbsp;reference)</pre>
<div class="block">A service tracked by the Tracker object has been added in the list.
This method is called when a service has been added in the managed list (after addingService) and if the
service has not disappeared before during the callback.
In this method, the service object is accessible from the <a href="../../../../../org/apache/felix/ipojo/util/Tracker.html#getService()"><code>Tracker.getService()</code></a> and
<a href="../../../../../org/apache/felix/ipojo/util/Tracker.html#getServices()"><code>Tracker.getServices()</code></a> method.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>reference</code> - the added reference.</dd></dl>
</li>
</ul>
<a name="modifiedService(org.osgi.framework.ServiceReference, java.lang.Object)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>modifiedService</h4>
<pre>void&nbsp;<a href="../../../../../src-html/org/apache/felix/ipojo/util/TrackerCustomizer.html#line.57">modifiedService</a>(<a href="http://www.osgi.org/javadoc/r4v43/core/org/osgi/framework/ServiceReference.html?is-external=true" title="class or interface in org.osgi.framework">ServiceReference</a>&nbsp;reference,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;service)</pre>
<div class="block">A service tracked by the Tracker object has been modified.
This method is called when a service tracked by the Tracker has its properties modified.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>reference</code> - the reference to service that has been modified.</dd><dd><code>service</code> - The service object for the modified service.</dd></dl>
</li>
</ul>
<a name="removedService(org.osgi.framework.ServiceReference, java.lang.Object)">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>removedService</h4>
<pre>void&nbsp;<a href="../../../../../src-html/org/apache/felix/ipojo/util/TrackerCustomizer.html#line.67">removedService</a>(<a href="http://www.osgi.org/javadoc/r4v43/core/org/osgi/framework/ServiceReference.html?is-external=true" title="class or interface in org.osgi.framework">ServiceReference</a>&nbsp;reference,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;service)</pre>
<div class="block">A service tracked by the Tracker object has been removed.
This method is called when a tracked service is no longer being tracked by the Tracker object.
Notice that some OSGi implementations does not support getting the service object from the bundle context in
this method. The cached (given) object must be used.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>reference</code> - the reference to service that has been removed.</dd><dd><code>service</code> - The service object for the removed service.</dd></dl>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<!-- ========= END OF CLASS DATA ========= -->
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a name="navbar_bottom">
<!-- -->
</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/TrackerCustomizer.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../../index-all.html">Index</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../../../org/apache/felix/ipojo/util/Tracker.Tracked.html" title="class in org.apache.felix.ipojo.util"><span class="strong">Prev Class</span></a></li>
<li>Next Class</li>
</ul>
<ul class="navList">
<li><a href="../../../../../index.html?org/apache/felix/ipojo/util/TrackerCustomizer.html" target="_top">Frames</a></li>
<li><a href="TrackerCustomizer.html" target="_top">No Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../../../../allclasses-noframe.html">All Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_bottom");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method_summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method_detail">Method</a></li>
</ul>
</div>
<a name="skip-navbar_bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<p class="legalCopy"><small>Copyright &#169; 2013. All rights reserved.</small></p>
</body>
</html>