You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@juneau.apache.org by ja...@apache.org on 2017/06/01 23:55:42 UTC
[24/32] incubator-juneau-website git commit: Update javadocs
http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/19e9b7df/content/site/apidocs/org/apache/juneau/rest/client/RestClient.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/rest/client/RestClient.html b/content/site/apidocs/org/apache/juneau/rest/client/RestClient.html
index 5c9b145..ab4ad3a 100644
--- a/content/site/apidocs/org/apache/juneau/rest/client/RestClient.html
+++ b/content/site/apidocs/org/apache/juneau/rest/client/RestClient.html
@@ -608,7 +608,7 @@ extends <a href="../../../../../org/apache/juneau/CoreObject.html" title="class
<ul class="blockList">
<li class="blockList">
<h4>getRemoteableProxy</h4>
-<pre>public <T> T <a href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.482">getRemoteableProxy</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> interfaceClass)</pre>
+<pre>public <T> T <a href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.488">getRemoteableProxy</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> interfaceClass)</pre>
<div class="block">Create a new proxy interface against a REST interface.
<p>
The URL to the REST interface is based on the following values:
@@ -655,7 +655,13 @@ extends <a href="../../../../../org/apache/juneau/CoreObject.html" title="class
.rootUrl(<js>"http://hostname/resturl"</js>)
.build()
.getRemoteableProxy(MyInterface3.<jk>class</jk>);
- </p></div>
+ </p>
+ <h5 class='section'>Notes:</h5>
+ <ul>
+ <li>If you plan on using your proxy in a multi-threaded environment, you'll want to use an underlying
+ pooling client connection manager. The easiest way to do this is to use the <a href="../../../../../org/apache/juneau/rest/client/RestClientBuilder.html#pooled--"><code>RestClientBuilder.pooled()</code></a>
+ method. If you don't do this, you may end up seeing "Connection still allocated" exceptions.
+ </ul></div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>interfaceClass</code> - The interface to create a proxy for.</dd>
@@ -672,7 +678,7 @@ extends <a href="../../../../../org/apache/juneau/CoreObject.html" title="class
<ul class="blockList">
<li class="blockList">
<h4>getRemoteableProxy</h4>
-<pre>public <T> T <a href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.493">getRemoteableProxy</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> interfaceClass,
+<pre>public <T> T <a href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.499">getRemoteableProxy</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> interfaceClass,
<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> restUrl)</pre>
<div class="block">Same as <a href="../../../../../org/apache/juneau/rest/client/RestClient.html#getRemoteableProxy-java.lang.Class-"><code>getRemoteableProxy(Class)</code></a> except explicitly specifies the URL of the REST interface.</div>
<dl>
@@ -690,7 +696,7 @@ extends <a href="../../../../../org/apache/juneau/CoreObject.html" title="class
<ul class="blockList">
<li class="blockList">
<h4>getRemoteableProxy</h4>
-<pre>public <T> T <a href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.507">getRemoteableProxy</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> interfaceClass,
+<pre>public <T> T <a href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.513">getRemoteableProxy</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a><T> interfaceClass,
<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> restUrl,
<a href="../../../../../org/apache/juneau/serializer/Serializer.html" title="class in org.apache.juneau.serializer">Serializer</a> serializer,
<a href="../../../../../org/apache/juneau/parser/Parser.html" title="class in org.apache.juneau.parser">Parser</a> parser)</pre>
@@ -712,7 +718,7 @@ extends <a href="../../../../../org/apache/juneau/CoreObject.html" title="class
<ul class="blockListLast">
<li class="blockList">
<h4>finalize</h4>
-<pre>protected void <a href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.687">finalize</a>()
+<pre>protected void <a href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.702">finalize</a>()
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</a></pre>
<dl>
<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>