Google Git
Sign in
apache / juddi / refs/heads/asf-site / . / juddi-client / apidocs / org / apache / juddi / v3 / client / mapping / ServiceLocator.html
blob: a320e8520f228088c04b78810f690a21290434ed [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 (1.8.0_101) on Mon Sep 19 17:00:58 EDT 2022 -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>ServiceLocator (jUDDI Client side Code 3.3.11-SNAPSHOT API)</title>
<meta name="date" content="2022-09-19">
<link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="Style">
<script type="text/javascript" src="../../../../../../script.js"></script>
</head>
<body>
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="ServiceLocator (jUDDI Client side Code 3.3.11-SNAPSHOT API)";
}
}
catch(err) {
}
//-->
var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10};
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
var activeTableTab = "activeTableTab";
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a name="navbar.top">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
<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/ServiceLocator.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>
<li><a href="../../../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../../../../org/apache/juddi/v3/client/mapping/SelectionPolicy.html" title="interface in org.apache.juddi.v3.client.mapping"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
<li><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceRegistrationResponse.html" title="class in org.apache.juddi.v3.client.mapping"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../../../index.html?org/apache/juddi/v3/client/mapping/ServiceLocator.html" target="_top">Frames</a></li>
<li><a href="ServiceLocator.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../../../../../allclasses-noframe.html">All&nbsp;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><a href="#constructor.summary">Constr</a>&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><a href="#constructor.detail">Constr</a>&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.juddi.v3.client.mapping</div>
<h2 title="Class ServiceLocator" class="title">Class ServiceLocator</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li><a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li>org.apache.juddi.v3.client.mapping.ServiceLocator</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr>
<br>
<pre>public class <span class="typeNameLabel">ServiceLocator</span>
extends <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">The ServiceLocator contacts the UDDI registry to lookup an Endpoint given a UDDI ServiceKey.<br>
This class does NOT chase down WSDL, hosting redirectors or other binding references from
access point useType values. See
<a href="../../../../../../org/apache/juddi/v3/client/config/UDDIClerk.html#getEndpoints-java.lang.String-"><code>UDDIClerk.getEndpoints</code></a></div>
<dl>
<dt><span class="simpleTagLabel">Author:</span></dt>
<dd><a href="mailto:kstam@apache.org">Kurt T Stam</a></dd>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../../../../org/apache/juddi/v3/client/subscription/SubscriptionCallbackListener.html" title="class in org.apache.juddi.v3.client.subscription"><code>SubscriptionCallbackListener</code></a></dd>
</dl>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- -->
</a>
<h3>Constructor Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
<caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html#ServiceLocator-org.apache.juddi.v3.client.config.UDDIClerk-">ServiceLocator</a></span>(<a href="../../../../../../org/apache/juddi/v3/client/config/UDDIClerk.html" title="class in org.apache.juddi.v3.client.config">UDDIClerk</a>&nbsp;clerk)</code>
<div class="block">Requirement in the config is a clerk with access credentials to the UDDI server
you want the locator to do lookups to.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html#ServiceLocator-org.apache.juddi.v3.client.config.UDDIClerk-org.apache.juddi.v3.client.mapping.URLLocalizer-java.util.Properties-">ServiceLocator</a></span>(<a href="../../../../../../org/apache/juddi/v3/client/config/UDDIClerk.html" title="class in org.apache.juddi.v3.client.config">UDDIClerk</a>&nbsp;clerk,
<a href="../../../../../../org/apache/juddi/v3/client/mapping/URLLocalizer.html" title="interface in org.apache.juddi.v3.client.mapping">URLLocalizer</a>&nbsp;urlLocalizer,
<a href="https://docs.oracle.com/javase/6/docs/api/java/util/Properties.html?is-external=true" title="class or interface in java.util">Properties</a>&nbsp;properties)</code>&nbsp;</td>
</tr>
</table>
</li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- -->
</a>
<h3>Method Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr id="i0" class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html#clearCaches--">clearCaches</a></span>()</code>&nbsp;</td>
</tr>
<tr id="i1" class="rowColor">
<td class="colFirst"><code><a href="../../../../../../org/apache/juddi/v3/client/mapping/SelectionPolicy.html" title="interface in org.apache.juddi.v3.client.mapping">SelectionPolicy</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html#getPolicy--">getPolicy</a></span>()</code>
<div class="block">Returns the selection policy in use by this instance of the ServiceLocator.</div>
</td>
</tr>
<tr id="i2" class="altColor">
<td class="colFirst"><code><a href="../../../../../../org/apache/juddi/v3/client/mapping/UDDIServiceCache.html" title="class in org.apache.juddi.v3.client.mapping">UDDIServiceCache</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html#getUDDIServiceCache--">getUDDIServiceCache</a></span>()</code>&nbsp;</td>
</tr>
<tr id="i3" class="rowColor">
<td class="colFirst"><code><a href="https://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html#lookupEndpoint-javax.xml.namespace.QName-java.lang.String-">lookupEndpoint</a></span>(<a href="https://docs.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</a>&nbsp;serviceQName,
<a href="https://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;portName)</code>
<div class="block">Looks up the Endpoints for a Service.</div>
</td>
</tr>
<tr id="i4" class="altColor">
<td class="colFirst"><code><a href="https://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html#lookupEndpoint-java.lang.String-">lookupEndpoint</a></span>(<a href="https://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;serviceKey)</code>
<div class="block">Looks up the Endpoints for a Service.</div>
</td>
</tr>
<tr id="i5" class="rowColor">
<td class="colFirst"><code><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html" title="class in org.apache.juddi.v3.client.mapping">ServiceLocator</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html#setPolicy-java.lang.String-">setPolicy</a></span>(<a href="https://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;policy)</code>
<div class="block">The policy selection can be set as property "juddi.client.selection.policy"
or it can be set programmatically using this method.</div>
</td>
</tr>
<tr id="i6" class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html#shutdown--">shutdown</a></span>()</code>&nbsp;</td>
</tr>
<tr id="i7" class="rowColor">
<td class="colFirst"><code><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html" title="class in org.apache.juddi.v3.client.mapping">ServiceLocator</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html#withCache-java.net.URL-">withCache</a></span>(<a href="https://docs.oracle.com/javase/6/docs/api/java/net/URL.html?is-external=true" title="class or interface in java.net">URL</a>&nbsp;baseCallbackURL)</code>
<div class="block">Creates a new UDDIServiceCache, which brings up a new WebService Endpoint.</div>
</td>
</tr>
<tr id="i8" class="altColor">
<td class="colFirst"><code><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html" title="class in org.apache.juddi.v3.client.mapping">ServiceLocator</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html#withLiveCache-java.net.URL-">withLiveCache</a></span>(<a href="https://docs.oracle.com/javase/6/docs/api/java/net/URL.html?is-external=true" title="class or interface in java.net">URL</a>&nbsp;baseCallbackURL)</code>
<div class="block">A live cache will receive callbacks from the UDDI server in case there is an update to
a service's bindings.</div>
</td>
</tr>
<tr id="i9" class="rowColor">
<td class="colFirst"><code><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html" title="class in org.apache.juddi.v3.client.mapping">ServiceLocator</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html#withSimpleCache--">withSimpleCache</a></span>()</code>&nbsp;</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;java.lang.<a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3>
<code><a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone--" title="class or interface in java.lang">clone</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals-java.lang.Object-" title="class or interface in java.lang">equals</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize--" title="class or interface in java.lang">finalize</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass--" title="class or interface in java.lang">getClass</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode--" title="class or interface in java.lang">hashCode</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify--" title="class or interface in java.lang">notify</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll--" title="class or interface in java.lang">notifyAll</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#toString--" title="class or interface in java.lang">toString</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait--" title="class or interface in java.lang">wait</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait-long-" title="class or interface in java.lang">wait</a>, <a href="https://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="class or interface in java.lang">wait</a></code></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- -->
</a>
<h3>Constructor Detail</h3>
<a name="ServiceLocator-org.apache.juddi.v3.client.config.UDDIClerk-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>ServiceLocator</h4>
<pre>public&nbsp;ServiceLocator(<a href="../../../../../../org/apache/juddi/v3/client/config/UDDIClerk.html" title="class in org.apache.juddi.v3.client.config">UDDIClerk</a>&nbsp;clerk)</pre>
<div class="block">Requirement in the config is a clerk with access credentials to the UDDI server
you want the locator to do lookups to. When a live cache is used the clerk
will register a callback into this UDDI server and the clerk will therefore need
inquiry and publish access. The credentials can be set in the uddi-client.xml
configuration file.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>clerk</code> - a UDDI Clerk with publish access to the UDDI Server.</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code>org.apache.commons.configuration.ConfigurationException</code></dd>
</dl>
</li>
</ul>
<a name="ServiceLocator-org.apache.juddi.v3.client.config.UDDIClerk-org.apache.juddi.v3.client.mapping.URLLocalizer-java.util.Properties-">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>ServiceLocator</h4>
<pre>public&nbsp;ServiceLocator(<a href="../../../../../../org/apache/juddi/v3/client/config/UDDIClerk.html" title="class in org.apache.juddi.v3.client.config">UDDIClerk</a>&nbsp;clerk,
<a href="../../../../../../org/apache/juddi/v3/client/mapping/URLLocalizer.html" title="interface in org.apache.juddi.v3.client.mapping">URLLocalizer</a>&nbsp;urlLocalizer,
<a href="https://docs.oracle.com/javase/6/docs/api/java/util/Properties.html?is-external=true" title="class or interface in java.util">Properties</a>&nbsp;properties)
throws org.apache.commons.configuration.ConfigurationException</pre>
<dl>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code>org.apache.commons.configuration.ConfigurationException</code></dd>
</dl>
</li>
</ul>
</li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- -->
</a>
<h3>Method Detail</h3>
<a name="withCache-java.net.URL-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>withCache</h4>
<pre>public&nbsp;<a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html" title="class in org.apache.juddi.v3.client.mapping">ServiceLocator</a>&nbsp;withCache(<a href="https://docs.oracle.com/javase/6/docs/api/java/net/URL.html?is-external=true" title="class or interface in java.net">URL</a>&nbsp;baseCallbackURL)
throws org.apache.commons.configuration.ConfigurationException</pre>
<div class="block">Creates a new UDDIServiceCache, which brings up a new WebService Endpoint. This
EndPoint will be called by the UDDI server if any service changes. A callback
will result in cleaning the cache.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>baseCallbackURL</code> - </dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code>org.apache.commons.configuration.ConfigurationException</code></dd>
</dl>
</li>
</ul>
<a name="withLiveCache-java.net.URL-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>withLiveCache</h4>
<pre>public&nbsp;<a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html" title="class in org.apache.juddi.v3.client.mapping">ServiceLocator</a>&nbsp;withLiveCache(<a href="https://docs.oracle.com/javase/6/docs/api/java/net/URL.html?is-external=true" title="class or interface in java.net">URL</a>&nbsp;baseCallbackURL)
throws org.apache.commons.configuration.ConfigurationException,
<a href="https://docs.oracle.com/javase/6/docs/api/java/net/BindException.html?is-external=true" title="class or interface in java.net">BindException</a></pre>
<div class="block">A live cache will receive callbacks from the UDDI server in case there is an update to
a service's bindings. All callbacks will clear the UDDIClientCache ensuring that subsequent
lookups will contact the UDDI server for the latest binding information.
The baseCallbackURL can be set to solve binding issue. If</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>baseCallbackURL</code> - </dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>a service locator object</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code>org.apache.commons.configuration.ConfigurationException</code></dd>
<dd><code><a href="https://docs.oracle.com/javase/6/docs/api/java/net/BindException.html?is-external=true" title="class or interface in java.net">BindException</a></code></dd>
</dl>
</li>
</ul>
<a name="withSimpleCache--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>withSimpleCache</h4>
<pre>public&nbsp;<a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html" title="class in org.apache.juddi.v3.client.mapping">ServiceLocator</a>&nbsp;withSimpleCache()</pre>
</li>
</ul>
<a name="getUDDIServiceCache--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getUDDIServiceCache</h4>
<pre>public&nbsp;<a href="../../../../../../org/apache/juddi/v3/client/mapping/UDDIServiceCache.html" title="class in org.apache.juddi.v3.client.mapping">UDDIServiceCache</a>&nbsp;getUDDIServiceCache()</pre>
</li>
</ul>
<a name="setPolicy-java.lang.String-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setPolicy</h4>
<pre>public&nbsp;<a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceLocator.html" title="class in org.apache.juddi.v3.client.mapping">ServiceLocator</a>&nbsp;setPolicy(<a href="https://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;policy)</pre>
<div class="block">The policy selection can be set as property "juddi.client.selection.policy"
or it can be set programmatically using this method. A Policy is a class which
implements the SelectionPolicy interface. Known implementations are
org.apache.juddi.v3.client.mapping.PolicyLocalFirst and
org.apache.juddi.v3.client.mapping.PolicyRoundRobin. If the policy is not
set the default org.apache.juddi.v3.client.mapping.PolicyLocalFirst is used.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>policy</code> - - the desired policy.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>ServiceLocator</dd>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../../../../org/apache/juddi/v3/client/mapping/PolicyLocalFirst.html" title="class in org.apache.juddi.v3.client.mapping"><code>PolicyLocalFirst</code></a>,
<a href="../../../../../../org/apache/juddi/v3/client/mapping/PolicyRoundRobin.html" title="class in org.apache.juddi.v3.client.mapping"><code>PolicyRoundRobin</code></a></dd>
</dl>
</li>
</ul>
<a name="getPolicy--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getPolicy</h4>
<pre>public&nbsp;<a href="../../../../../../org/apache/juddi/v3/client/mapping/SelectionPolicy.html" title="interface in org.apache.juddi.v3.client.mapping">SelectionPolicy</a>&nbsp;getPolicy()
throws org.apache.commons.configuration.ConfigurationException</pre>
<div class="block">Returns the selection policy in use by this instance of the ServiceLocator.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>SelectionPolicy - the selection policy.</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code>org.apache.commons.configuration.ConfigurationException</code></dd>
</dl>
</li>
</ul>
<a name="clearCaches--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>clearCaches</h4>
<pre>public&nbsp;void&nbsp;clearCaches()</pre>
</li>
</ul>
<a name="shutdown--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>shutdown</h4>
<pre>public&nbsp;void&nbsp;shutdown()
throws <a href="https://docs.oracle.com/javase/6/docs/api/java/rmi/RemoteException.html?is-external=true" title="class or interface in java.rmi">RemoteException</a>,
org.apache.commons.configuration.ConfigurationException,
<a href="../../../../../../org/apache/juddi/v3/client/transport/TransportException.html" title="class in org.apache.juddi.v3.client.transport">TransportException</a></pre>
<dl>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="https://docs.oracle.com/javase/6/docs/api/java/rmi/RemoteException.html?is-external=true" title="class or interface in java.rmi">RemoteException</a></code></dd>
<dd><code>org.apache.commons.configuration.ConfigurationException</code></dd>
<dd><code><a href="../../../../../../org/apache/juddi/v3/client/transport/TransportException.html" title="class in org.apache.juddi.v3.client.transport">TransportException</a></code></dd>
</dl>
</li>
</ul>
<a name="lookupEndpoint-java.lang.String-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>lookupEndpoint</h4>
<pre>public&nbsp;<a href="https://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;lookupEndpoint(<a href="https://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;serviceKey)
throws <a href="https://docs.oracle.com/javase/6/docs/api/java/rmi/RemoteException.html?is-external=true" title="class or interface in java.rmi">RemoteException</a>,
org.apache.commons.configuration.ConfigurationException,
<a href="../../../../../../org/apache/juddi/v3/client/transport/TransportException.html" title="class in org.apache.juddi.v3.client.transport">TransportException</a></pre>
<div class="block">Looks up the Endpoints for a Service. If the cache is in use it will try to
obtain them from the cache. If no Endpoints are found, or if the cache is not
in use, the clerk will do a lookup for this service. After Endpoints are found
it will use a policy to pick one Endpoint to return. Returns null if no endpoints
are found.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>serviceKey</code> - </dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>endpoint</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="https://docs.oracle.com/javase/6/docs/api/java/rmi/RemoteException.html?is-external=true" title="class or interface in java.rmi">RemoteException</a></code></dd>
<dd><code>org.apache.commons.configuration.ConfigurationException</code></dd>
<dd><code><a href="../../../../../../org/apache/juddi/v3/client/transport/TransportException.html" title="class in org.apache.juddi.v3.client.transport">TransportException</a></code></dd>
</dl>
</li>
</ul>
<a name="lookupEndpoint-javax.xml.namespace.QName-java.lang.String-">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>lookupEndpoint</h4>
<pre>public&nbsp;<a href="https://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;lookupEndpoint(<a href="https://docs.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</a>&nbsp;serviceQName,
<a href="https://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;portName)
throws <a href="https://docs.oracle.com/javase/6/docs/api/java/rmi/RemoteException.html?is-external=true" title="class or interface in java.rmi">RemoteException</a>,
org.apache.commons.configuration.ConfigurationException,
<a href="../../../../../../org/apache/juddi/v3/client/transport/TransportException.html" title="class in org.apache.juddi.v3.client.transport">TransportException</a></pre>
<div class="block">Looks up the Endpoints for a Service. If the cache is in use it will try to
obtain them from the cache. If no Endpoints are found, or if the cache is not
in use, the clerk will do a lookup for this service. After Endpoints are found
it will use a policy to pick one Endpoint to return. Returns null if no endpoints
are found.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>serviceQName</code> - </dd>
<dd><code>portName</code> - </dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>Returns null if no endpoints
are found.</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="../../../../../../org/apache/juddi/v3/client/transport/TransportException.html" title="class in org.apache.juddi.v3.client.transport">TransportException</a></code></dd>
<dd><code>org.apache.commons.configuration.ConfigurationException</code></dd>
<dd><code><a href="https://docs.oracle.com/javase/6/docs/api/java/rmi/RemoteException.html?is-external=true" title="class or interface in java.rmi">RemoteException</a></code></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>
<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
<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/ServiceLocator.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>
<li><a href="../../../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../../../../org/apache/juddi/v3/client/mapping/SelectionPolicy.html" title="interface in org.apache.juddi.v3.client.mapping"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
<li><a href="../../../../../../org/apache/juddi/v3/client/mapping/ServiceRegistrationResponse.html" title="class in org.apache.juddi.v3.client.mapping"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../../../index.html?org/apache/juddi/v3/client/mapping/ServiceLocator.html" target="_top">Frames</a></li>
<li><a href="ServiceLocator.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../../../../../allclasses-noframe.html">All&nbsp;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><a href="#constructor.summary">Constr</a>&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><a href="#constructor.detail">Constr</a>&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; 2004&#x2013;2022 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p>
</body>
</html>