http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/80ff9b74/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 929ccc2..e4f2fa9 100644
--- a/content/site/apidocs/org/apache/juneau/rest/client/RestClient.html
+++ b/content/site/apidocs/org/apache/juneau/rest/client/RestClient.html
@@ -18,7 +18,7 @@
catch(err) {
}
//-->
-var methods =
{"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10};
+var methods =
{"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10};
var tabs = {65535:["t0","All Methods"],2:["t2","Instance
Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
@@ -75,13 +75,13 @@ var activeTableTab = "activeTableTab";
<li>Summary: </li>
<li>Nested | </li>
<li><a
href="#fields.inherited.from.class.org.apache.juneau.CoreObject">Field</a> | </li>
-<li><a href="#constructor.summary">Constr</a> | </li>
+<li>Constr | </li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail: </li>
<li>Field | </li>
-<li><a href="#constructor.detail">Constr</a> | </li>
+<li>Constr | </li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
@@ -113,7 +113,7 @@ var activeTableTab = "activeTableTab";
<li class="blockList">
<hr>
<br>
-<pre>public class <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.52">RestClient</a>
+<pre>public class <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.55">RestClient</a>
extends <a href="../../../../../org/apache/juneau/CoreObject.html"
title="class in org.apache.juneau">CoreObject</a></pre>
<div class="block">Utility class for interfacing with remote REST interfaces.
@@ -151,41 +151,6 @@ extends <a
href="../../../../../org/apache/juneau/CoreObject.html" title="class
</ul>
</li>
</ul>
-<!-- ======== 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"> </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/juneau/rest/client/RestClient.html#RestClient-org.apache.juneau.PropertyStore-org.apache.http.impl.client.CloseableHttpClient-boolean-org.apache.juneau.serializer.Serializer-org.apache.juneau.parser.Parser-org.apache.juneau.urlencoding.UrlEncodingSerializer-java.util.Map-java.util.List-java.lang.String-java.util.Map-java.lang.String-org.apache.juneau.rest.client.RetryOn-int-long-boolean-java.util.concurrent.ExecutorService-boolean-">RestClient</a></span>(<a
href="../../../../../org/apache/juneau/PropertyStore.html" title="class in
org.apache.juneau">PropertyStore</a> propertyStore,
- org.apache.http.impl.client.CloseableHttpClient httpClient,
- boolean keepHttpClientOpen,
- <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,
- <a
href="../../../../../org/apache/juneau/urlencoding/UrlEncodingSerializer.html"
title="class in
org.apache.juneau.urlencoding">UrlEncodingSerializer</a> urlEncodingSerializer,
- <a
href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true";
title="class or interface in java.util">Map</a><<a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
title="class or interface in java.lang">String</a>,<a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
title="class or interface in java.lang">String</a>> headers,
- <a
href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true";
title="class or interface in java.util">List</a><<a
href="../../../../../org/apache/juneau/rest/client/RestCallInterceptor.html"
title="class in
org.apache.juneau.rest.client">RestCallInterceptor</a>> interceptors,
- <a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
title="class or interface in java.lang">String</a> remoteableServletUri,
- <a
href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true";
title="class or interface in java.util">Map</a><<a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true";
title="class or interface in java.lang.reflect">Method</a>,<a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
title="class or interface in
java.lang">String</a>> remoteableServiceUriMap,
- <a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
title="class or interface in java.lang">String</a> rootUri,
- <a href="../../../../../org/apache/juneau/rest/client/RetryOn.html"
title="interface in org.apache.juneau.rest.client">RetryOn</a> retryOn,
- int retries,
- long retryInterval,
- boolean debug,
- <a
href="http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/ExecutorService.html?is-external=true";
title="class or interface in
java.util.concurrent">ExecutorService</a> executorService,
- boolean executorServiceShutdownOnClose)</code>
-<div class="block">Create a new REST client.</div>
-</td>
-</tr>
-</table>
-</li>
-</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
@@ -259,45 +224,51 @@ extends <a
href="../../../../../org/apache/juneau/CoreObject.html" title="class
</tr>
<tr id="i9" class="rowColor">
<td class="colFirst"><code><a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a
href="../../../../../org/apache/juneau/rest/client/RestClient.html#doPost-java.lang.Object-">doPost</a></span>(<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> url)</code>
+<div class="block">Same as <a
href="../../../../../org/apache/juneau/rest/client/RestClient.html#doPost-java.lang.Object-java.lang.Object-"><code>doPost(Object,
Object)</code></a> but don't specify the input yet.</div>
+</td>
+</tr>
+<tr id="i10" class="altColor">
+<td class="colFirst"><code><a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a
href="../../../../../org/apache/juneau/rest/client/RestClient.html#doPost-java.lang.Object-java.lang.Object-">doPost</a></span>(<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> url,
<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> o)</code>
<div class="block">Perform a <code>POST</code> request against the specified
URL.</div>
</td>
</tr>
-<tr id="i10" class="altColor">
+<tr id="i11" class="rowColor">
<td class="colFirst"><code><a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a
href="../../../../../org/apache/juneau/rest/client/RestClient.html#doPut-java.lang.Object-java.lang.Object-">doPut</a></span>(<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> url,
<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> o)</code>
<div class="block">Perform a <code>PUT</code> request against the specified
URL.</div>
</td>
</tr>
-<tr id="i11" class="rowColor">
+<tr id="i12" class="altColor">
<td class="colFirst"><code>protected org.apache.http.HttpResponse</code></td>
<td class="colLast"><code><span class="memberNameLink"><a
href="../../../../../org/apache/juneau/rest/client/RestClient.html#execute-org.apache.http.client.methods.HttpUriRequest-">execute</a></span>(org.apache.http.client.methods.HttpUriRequest req)</code>
<div class="block">Execute the specified request.</div>
</td>
</tr>
-<tr id="i12" class="altColor">
+<tr id="i13" class="rowColor">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a
href="../../../../../org/apache/juneau/rest/client/RestClient.html#finalize--">finalize</a></span>()</code> </td>
</tr>
-<tr id="i13" class="rowColor">
+<tr id="i14" class="altColor">
<td class="colFirst"><code><T> T</code></td>
<td class="colLast"><code><span class="memberNameLink"><a
href="../../../../../org/apache/juneau/rest/client/RestClient.html#getRemoteableProxy-java.lang.Class-">getRemoteableProxy</a></span>(<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)</code>
-<div class="block">Create a new proxy interface for the specified remoteable
service interface.</div>
+<div class="block">Create a new proxy interface against a REST interface.</div>
</td>
</tr>
-<tr id="i14" class="altColor">
+<tr id="i15" class="rowColor">
<td class="colFirst"><code><T> T</code></td>
<td class="colLast"><code><span class="memberNameLink"><a
href="../../../../../org/apache/juneau/rest/client/RestClient.html#getRemoteableProxy-java.lang.Class-java.lang.Object-">getRemoteableProxy</a></span>(<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> proxyUrl)</code>
-<div class="block">Create a new proxy interface for the specified REST PROXY
interface.</div>
+ <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)</code>
+<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>
</td>
</tr>
-<tr id="i15" class="rowColor">
+<tr id="i16" class="altColor">
<td class="colFirst"><code><T> T</code></td>
<td class="colLast"><code><span class="memberNameLink"><a
href="../../../../../org/apache/juneau/rest/client/RestClient.html#getRemoteableProxy-java.lang.Class-java.lang.Object-org.apache.juneau.serializer.Serializer-org.apache.juneau.parser.Parser-">getRemoteableProxy</a></span>(<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> proxyUrl,
+ <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)</code>
<div class="block">Same as <a
href="../../../../../org/apache/juneau/rest/client/RestClient.html#getRemoteableProxy-java.lang.Class-java.lang.Object-"><code>getRemoteableProxy(Class,
Object)</code></a> but allows you to override the serializer and parser
used.</div>
@@ -326,60 +297,6 @@ extends <a
href="../../../../../org/apache/juneau/CoreObject.html" title="class
<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="RestClient-org.apache.juneau.PropertyStore-org.apache.http.impl.client.CloseableHttpClient-boolean-org.apache.juneau.serializer.Serializer-org.apache.juneau.parser.Parser-org.apache.juneau.urlencoding.UrlEncodingSerializer-java.util.Map-java.util.List-java.lang.String-java.util.Map-java.lang.String-org.apache.juneau.rest.client.RetryOn-int-long-boolean-java.util.concurrent.ExecutorService-boolean-">
-<!-- -->
-</a>
-<ul class="blockListLast">
-<li class="blockList">
-<h4>RestClient</h4>
-<pre>public <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.93">RestClient</a>(<a
href="../../../../../org/apache/juneau/PropertyStore.html" title="class in
org.apache.juneau">PropertyStore</a> propertyStore,
-
org.apache.http.impl.client.CloseableHttpClient httpClient,
- boolean keepHttpClientOpen,
- <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,
- <a
href="../../../../../org/apache/juneau/urlencoding/UrlEncodingSerializer.html"
title="class in
org.apache.juneau.urlencoding">UrlEncodingSerializer</a> urlEncodingSerializer,
- <a
href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true";
title="class or interface in java.util">Map</a><<a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
title="class or interface in java.lang">String</a>,<a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
title="class or interface in java.lang">String</a>> headers,
- <a
href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true";
title="class or interface in java.util">List</a><<a
href="../../../../../org/apache/juneau/rest/client/RestCallInterceptor.html"
title="class in
org.apache.juneau.rest.client">RestCallInterceptor</a>> interceptors,
- <a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
title="class or interface in java.lang">String</a> remoteableServletUri,
- <a
href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true";
title="class or interface in java.util">Map</a><<a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/reflect/Method.html?is-external=true";
title="class or interface in java.lang.reflect">Method</a>,<a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
title="class or interface in
java.lang">String</a>> remoteableServiceUriMap,
- <a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
title="class or interface in java.lang">String</a> rootUri,
- <a
href="../../../../../org/apache/juneau/rest/client/RetryOn.html"
title="interface in org.apache.juneau.rest.client">RetryOn</a> retryOn,
- int retries,
- long retryInterval,
- boolean debug,
- <a
href="http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/ExecutorService.html?is-external=true";
title="class or interface in
java.util.concurrent">ExecutorService</a> executorService,
- boolean executorServiceShutdownOnClose)</pre>
-<div class="block">Create a new REST client.</div>
-<dl>
-<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>propertyStore</code> - </dd>
-<dd><code>httpClient</code> - </dd>
-<dd><code>keepHttpClientOpen</code> - </dd>
-<dd><code>serializer</code> - </dd>
-<dd><code>parser</code> - </dd>
-<dd><code>urlEncodingSerializer</code> - </dd>
-<dd><code>headers</code> - </dd>
-<dd><code>interceptors</code> - </dd>
-<dd><code>remoteableServletUri</code> - </dd>
-<dd><code>remoteableServiceUriMap</code> - </dd>
-<dd><code>rootUri</code> - </dd>
-<dd><code>retryOn</code> - </dd>
-<dd><code>retries</code> - </dd>
-<dd><code>retryInterval</code> - </dd>
-<dd><code>debug</code> - </dd>
-<dd><code>executorService</code> - </dd>
-<dd><code>executorServiceShutdownOnClose</code> - </dd>
-</dl>
-</li>
-</ul>
-</li>
-</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
@@ -392,7 +309,7 @@ extends <a
href="../../../../../org/apache/juneau/CoreObject.html" title="class
<ul class="blockList">
<li class="blockList">
<h4>close</h4>
-<pre>public void <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.149">close</a>()
+<pre>public void <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.133">close</a>()
throws <a
href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true";
title="class or interface in java.io">IOException</a></pre>
<div class="block">Calls <a
href="http://docs.oracle.com/javase/7/docs/api/java/io/Closeable.html?is-external=true#close--";
title="class or interface in java.io"><code>Closeable.close()</code></a> on
the underlying <code>CloseableHttpClient</code>.
It's good practice to call this method after the client is no longer
used.</div>
@@ -408,7 +325,7 @@ extends <a
href="../../../../../org/apache/juneau/CoreObject.html" title="class
<ul class="blockList">
<li class="blockList">
<h4>closeQuietly</h4>
-<pre>public void <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.162">closeQuietly</a>()</pre>
+<pre>public void <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.146">closeQuietly</a>()</pre>
<div class="block">Same as <a
href="../../../../../org/apache/juneau/rest/client/RestClient.html#close--"><code>close()</code></a>,
but ignores any exceptions.</div>
</li>
</ul>
@@ -418,7 +335,7 @@ extends <a
href="../../../../../org/apache/juneau/CoreObject.html" title="class
<ul class="blockList">
<li class="blockList">
<h4>execute</h4>
-<pre>protected org.apache.http.HttpResponse <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.182">execute</a>(org.apache.http.client.methods.HttpUriRequest req)
+<pre>protected org.apache.http.HttpResponse <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.166">execute</a>(org.apache.http.client.methods.HttpUriRequest req)
throws <a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true";
title="class or interface in java.lang">Exception</a></pre>
<div class="block">Execute the specified request.
Subclasses can override this method to provide specialized handling.</div>
@@ -438,7 +355,7 @@ extends <a
href="../../../../../org/apache/juneau/CoreObject.html" title="class
<ul class="blockList">
<li class="blockList">
<h4>doGet</h4>
-<pre>public <a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a> <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.194">doGet</a>(<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> url)
+<pre>public <a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a> <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.178">doGet</a>(<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> url)
throws <a
href="../../../../../org/apache/juneau/rest/client/RestCallException.html"
title="class in org.apache.juneau.rest.client">RestCallException</a></pre>
<div class="block">Perform a <code>GET</code> request against the specified
URL.</div>
<dl>
@@ -458,7 +375,7 @@ extends <a
href="../../../../../org/apache/juneau/CoreObject.html" title="class
<ul class="blockList">
<li class="blockList">
<h4>doPut</h4>
-<pre>public <a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a> <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.214">doPut</a>(<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> url,
+<pre>public <a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a> <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.198">doPut</a>(<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> url,
<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> o)
throws <a
href="../../../../../org/apache/juneau/rest/client/RestCallException.html"
title="class in org.apache.juneau.rest.client">RestCallException</a></pre>
<div class="block">Perform a <code>PUT</code> request against the specified
URL.</div>
@@ -487,7 +404,7 @@ extends <a
href="../../../../../org/apache/juneau/CoreObject.html" title="class
<ul class="blockList">
<li class="blockList">
<h4>doPost</h4>
-<pre>public <a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a> <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.234">doPost</a>(<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> url,
+<pre>public <a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a> <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.218">doPost</a>(<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> url,
<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> o)
throws <a
href="../../../../../org/apache/juneau/rest/client/RestCallException.html"
title="class in org.apache.juneau.rest.client">RestCallException</a></pre>
<div class="block">Perform a <code>POST</code> request against the specified
URL.</div>
@@ -510,13 +427,36 @@ extends <a
href="../../../../../org/apache/juneau/CoreObject.html" title="class
</dl>
</li>
</ul>
+<a name="doPost-java.lang.Object-">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>doPost</h4>
+<pre>public <a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a> <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.233">doPost</a>(<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> url)
+ throws <a
href="../../../../../org/apache/juneau/rest/client/RestCallException.html"
title="class in org.apache.juneau.rest.client">RestCallException</a></pre>
+<div class="block">Same as <a
href="../../../../../org/apache/juneau/rest/client/RestClient.html#doPost-java.lang.Object-java.lang.Object-"><code>doPost(Object,
Object)</code></a> but don't specify the input yet.
+ <p>
+ You must call either <a
href="../../../../../org/apache/juneau/rest/client/RestCall.html#input-java.lang.Object-"><code>RestCall.input(Object)</code></a>
or <a
href="../../../../../org/apache/juneau/rest/client/RestCall.html#formData-java.lang.String-java.lang.Object-"><code>RestCall.formData(String,
Object)</code></a>
+ to set the contents on the result object.</div>
+<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>url</code> - The URL of the remote REST resource. Can be any of the
following: <a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
title="class or interface in java.lang"><code>String</code></a>, <a
href="http://docs.oracle.com/javase/7/docs/api/java/net/URI.html?is-external=true";
title="class or interface in java.net"><code>URI</code></a>, <a
href="http://docs.oracle.com/javase/7/docs/api/java/net/URL.html?is-external=true";
title="class or interface in java.net"><code>URL</code></a>.</dd>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>A <a href="../../../../../org/apache/juneau/rest/client/RestCall.html"
title="class in org.apache.juneau.rest.client"><code>RestCall</code></a> object
that can be further tailored before executing the request
+ and getting the response as a parsed object.</dd>
+<dt><span class="throwsLabel">Throws:</span></dt>
+<dd><code><a
href="../../../../../org/apache/juneau/rest/client/RestCallException.html"
title="class in org.apache.juneau.rest.client">RestCallException</a></code></dd>
+</dl>
+</li>
+</ul>
<a name="doDelete-java.lang.Object-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>doDelete</h4>
-<pre>public <a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a> <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.246">doDelete</a>(<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> url)
+<pre>public <a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a> <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.245">doDelete</a>(<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> url)
throws <a
href="../../../../../org/apache/juneau/rest/client/RestCallException.html"
title="class in org.apache.juneau.rest.client">RestCallException</a></pre>
<div class="block">Perform a <code>DELETE</code> request against the specified
URL.</div>
<dl>
@@ -536,7 +476,7 @@ extends <a
href="../../../../../org/apache/juneau/CoreObject.html" title="class
<ul class="blockList">
<li class="blockList">
<h4>doOptions</h4>
-<pre>public <a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a> <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.258">doOptions</a>(<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> url)
+<pre>public <a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a> <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.257">doOptions</a>(<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> url)
throws <a
href="../../../../../org/apache/juneau/rest/client/RestCallException.html"
title="class in org.apache.juneau.rest.client">RestCallException</a></pre>
<div class="block">Perform an <code>OPTIONS</code> request against the
specified URL.</div>
<dl>
@@ -556,7 +496,7 @@ extends <a
href="../../../../../org/apache/juneau/CoreObject.html" title="class
<ul class="blockList">
<li class="blockList">
<h4>doFormPost</h4>
-<pre>public <a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a> <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.272">doFormPost</a>(<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> url,
+<pre>public <a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a> <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.271">doFormPost</a>(<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> url,
<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> o)
throws <a
href="../../../../../org/apache/juneau/rest/client/RestCallException.html"
title="class in org.apache.juneau.rest.client">RestCallException</a></pre>
<div class="block">Perform a <code>POST</code> request with a content type of
<code>application/x-www-form-urlencoded</code> against the specified URL.</div>
@@ -579,7 +519,7 @@ extends <a
href="../../../../../org/apache/juneau/CoreObject.html" title="class
<ul class="blockList">
<li class="blockList">
<h4>doCallback</h4>
-<pre>public <a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a> <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.297">doCallback</a>(<a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
title="class or interface in java.lang">String</a> callString)
+<pre>public <a
href="../../../../../org/apache/juneau/rest/client/RestCall.html" title="class
in org.apache.juneau.rest.client">RestCall</a> <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.296">doCallback</a>(<a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
title="class or interface in java.lang">String</a> callString)
throws <a
href="../../../../../org/apache/juneau/rest/client/RestCallException.html"
title="class in org.apache.juneau.rest.client">RestCallException</a></pre>
<div class="block">Performs a REST call where the entire call is specified in
a simple string.
<p>
@@ -627,6 +567,7 @@ extends <a
href="../../../../../org/apache/juneau/CoreObject.html" title="class
<li><a
href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true";
title="class or interface in java.io"><code>InputStream</code></a> - Raw
contents of <code>InputStream</code> will be serialized to remote resource.
<li><a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true";
title="class or interface in java.lang"><code>Object</code></a> - POJO to be
converted to text using the <a
href="../../../../../org/apache/juneau/serializer/Serializer.html" title="class
in org.apache.juneau.serializer"><code>Serializer</code></a> registered with
the <a href="../../../../../org/apache/juneau/rest/client/RestClient.html"
title="class in org.apache.juneau.rest.client"><code>RestClient</code></a>.
<li><code>HttpEntity</code> - Bypass Juneau serialization and pass
HttpEntity directly to HttpClient.
+ <li><a
href="../../../../../org/apache/juneau/rest/client/NameValuePairs.html"
title="class in org.apache.juneau.rest.client"><code>NameValuePairs</code></a>
- Converted to a URL-encoded FORM post.
</ul>
This parameter is IGNORED if <a
href="../../../../../org/apache/juneau/rest/client/HttpMethod.html#hasContent--"><code>HttpMethod.hasContent()</code></a>
is <jk>false</jk>.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -667,16 +608,61 @@ 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.431">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 for the specified remoteable
service interface.</div>
+<pre>public <T> T <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.476">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:
+ <ul>
+ <li>The <a
href="../../../../../org/apache/juneau/remoteable/Remoteable.html#path--"><code>@Remoteable.path()</code></a>
annotation on the interface (<code>remoteable-path</code>).
+ <li>The <a
href="../../../../../org/apache/juneau/rest/client/RestClientBuilder.html#rootUrl-java.lang.Object-"><code>rootUrl</code></a>
on the client (<code>root-url</code>).
+ <li>The fully-qualified class name of the interface
(<code>class-name</code>).
+ </ul>
+ <p>
+ The URL calculation is as follows:
+ <ul>
+ <li><code>remoteable-path</code> - If remoteable path is absolute.
+ <li><code>root-url/remoteable-path</code> - If remoteable path is relative
and root-url has been specified.
+ <li><code>root-url/class-name</code> - If remoteable path is not specified.
+ </ul>
+ <p>
+ If the information is not available to resolve to an absolute URL, a <a
href="../../../../../org/apache/juneau/remoteable/RemoteableMetadataException.html"
title="class in
org.apache.juneau.remoteable"><code>RemoteableMetadataException</code></a> is
thrown.
+ <p>
+ Examples:
+ <p class='bcode'>
+ <jk>package</jk> org.apache.foo;
+
+ <ja>@Remoteable</ja>(path=<js>"http://hostname/resturl/myinterface1";</js>)
+ <jk>public interface</jk> MyInterface1 { ... }
+
+ <ja>@Remoteable</ja>(path=<js>"/myinterface2"</js>)
+ <jk>public interface</jk> MyInterface2 { ... }
+
+ <jk>public interface</jk> MyInterface3 { ... }
+
+ <jc>// Resolves to "http://localhost/resturl/myinterface1";</jc>
+ MyInterface1 i1 = <jk>new</jk> RestClientBuilder()
+ .build()
+ .getRemoteableProxy(MyInterface1.<jk>class</jk>);
+
+ <jc>// Resolves to "http://hostname/resturl/myinterface2";</jc>
+ MyInterface2 i2 = <jk>new</jk> RestClientBuilder()
+ .rootUrl(<js>"http://hostname/resturl";</js>)
+ .build()
+ .getRemoteableProxy(MyInterface2.<jk>class</jk>);
+
+ <jc>// Resolves to
"http://hostname/resturl/org.apache.foo.MyInterface3";</jc>
+ MyInterface3 i3 = <jk>new</jk> RestClientBuilder()
+ .rootUrl(<js>"http://hostname/resturl";</js>)
+ .build()
+ .getRemoteableProxy(MyInterface3.<jk>class</jk>);
+ </p></div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>interfaceClass</code> - The interface to create a proxy for.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>The new proxy interface.</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
-<dd><code><a
href="http://docs.oracle.com/javase/7/docs/api/java/lang/RuntimeException.html?is-external=true";
title="class or interface in java.lang">RuntimeException</a></code> - If the
Remotable service URI has not been specified on this
- client by calling <a
href="../../../../../org/apache/juneau/rest/client/RestClientBuilder.html#remoteableServletUri-java.lang.String-"><code>RestClientBuilder.remoteableServletUri(String)</code></a>.</dd>
+<dd><code><a
href="../../../../../org/apache/juneau/remoteable/RemoteableMetadataException.html"
title="class in
org.apache.juneau.remoteable">RemoteableMetadataException</a></code> - If the
REST URI cannot be determined based on the information given.</dd>
</dl>
</li>
</ul>
@@ -686,13 +672,13 @@ 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.444">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> proxyUrl)</pre>
-<div class="block">Create a new proxy interface for the specified REST PROXY
interface.</div>
+<pre>public <T> T <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.487">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>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>interfaceClass</code> - The interface to create a proxy for.</dd>
-<dd><code>proxyUrl</code> - The URL of the REST method annotated with
<code><ja>@RestMethod</ja>(name=<js>"PROXY"</js>)</code>.</dd>
+<dd><code>restUrl</code> - The URL of the REST interface.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>The new proxy interface.</dd>
</dl>
@@ -704,15 +690,15 @@ 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.458">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> proxyUrl,
+<pre>public <T> T <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.501">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>
<div class="block">Same as <a
href="../../../../../org/apache/juneau/rest/client/RestClient.html#getRemoteableProxy-java.lang.Class-java.lang.Object-"><code>getRemoteableProxy(Class,
Object)</code></a> but allows you to override the serializer and parser
used.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>interfaceClass</code> - The interface to create a proxy for.</dd>
-<dd><code>proxyUrl</code> - The URL of the REST method annotated with
<code><ja>@RestMethod</ja>(name=<js>"PROXY"</js>)</code>.</dd>
+<dd><code>restUrl</code> - The URL of the REST interface.</dd>
<dd><code>serializer</code> - The serializer used to serialize POJOs to the
body of the HTTP request.</dd>
<dd><code>parser</code> - The parser used to parse POJOs from the body of the
HTTP response.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -726,7 +712,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.525">finalize</a>()
+<pre>protected void <a
href="../../../../../src-html/org/apache/juneau/rest/client/RestClient.html#line.615">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>
@@ -790,13 +776,13 @@ extends <a
href="../../../../../org/apache/juneau/CoreObject.html" title="class
<li>Summary: </li>
<li>Nested | </li>
<li><a
href="#fields.inherited.from.class.org.apache.juneau.CoreObject">Field</a> | </li>
-<li><a href="#constructor.summary">Constr</a> | </li>
+<li>Constr | </li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail: </li>
<li>Field | </li>
-<li><a href="#constructor.detail">Constr</a> | </li>
+<li>Constr | </li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
