com.google.gwt.user.client.rpc

## Class RpcRequestBuilder

- java.lang.Object
- - com.google.gwt.user.client.rpc.RpcRequestBuilder

-     public class RpcRequestBuilder
      extends java.lang.Object

  This class encapsulates the logic necessary to configure a RequestBuilder for use with an RPC proxy object. Users who wish to alter the specifics of the HTTP requests issued by RPC proxy objects may override the protected `doXyz` methods and pass an instance of the subclass to `ServiceDefTarget.setRpcRequestBuilder(com.google.gwt.user.client.rpc.RpcRequestBuilder)`.

- - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `static java.lang.String` | `CONTENT_TYPE_HEADER` Used by `doSetContentType(com.google.gwt.http.client.RequestBuilder, java.lang.String)`.
    `static java.lang.String` | `MODULE_BASE_HEADER` Used by `doFinish(com.google.gwt.http.client.RequestBuilder)`.
    `static java.lang.String` | `STRONG_NAME_HEADER` Used by `doFinish(com.google.gwt.http.client.RequestBuilder)`.

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `RpcRequestBuilder()`

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `RpcRequestBuilder` | `create(java.lang.String serviceEntryPoint)` Initialize the RpcRequestBuilder.
    `protected RequestBuilder` | `doCreate(java.lang.String serviceEntryPoint)` Called by `create(java.lang.String)` to instantiate the RequestBuilder object.
    `protected void` | `doFinish(RequestBuilder rb)` Called by `finish()` prior to returning the RequestBuilder to the caller.
    `protected void` | `doSetCallback(RequestBuilder rb, RequestCallback callback)` Called by `setCallback(com.google.gwt.http.client.RequestCallback)`.
    `protected void` | `doSetContentType(RequestBuilder rb, java.lang.String contentType)` Called by `setContentType(java.lang.String)`.
    `protected void` | `doSetRequestData(RequestBuilder rb, java.lang.String data)` Called by `setRequestData(java.lang.String)`.
    `protected void` | `doSetRequestId(RequestBuilder rb, int id)` Called by `setRequestId(int)`.
    `RequestBuilder` | `finish()` This method must be called to return the RequestBuilder that the RPC request will be made with.
    `RpcRequestBuilder` | `setCallback(RequestCallback callback)` Sets the RequestCallback to be used by the RequestBuilder.
    `RpcRequestBuilder` | `setContentType(java.lang.String contentType)` Sets the MIME content type to be used by the RequestBuilder.
    `RpcRequestBuilder` | `setRequestData(java.lang.String data)` Sets the request data to be sent in the request.
    `RpcRequestBuilder` | `setRequestId(int id)` Sets the request id of the request.

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### Field Detail

    - #### CONTENT_TYPE_HEADER

          public static final java.lang.String CONTENT_TYPE_HEADER

      Used by `doSetContentType(com.google.gwt.http.client.RequestBuilder, java.lang.String)`.
      See Also:
        Constant Field Values

    - #### MODULE_BASE_HEADER

          public static final java.lang.String MODULE_BASE_HEADER

      Used by `doFinish(com.google.gwt.http.client.RequestBuilder)`.
      See Also:
        Constant Field Values

    - #### STRONG_NAME_HEADER

          public static final java.lang.String STRONG_NAME_HEADER

      Used by `doFinish(com.google.gwt.http.client.RequestBuilder)`.
      See Also:
        Constant Field Values

  - ### Constructor Detail

    - #### RpcRequestBuilder

          public RpcRequestBuilder()

  - ### Method Detail

    - #### create

          public final RpcRequestBuilder create(java.lang.String serviceEntryPoint)

      Initialize the RpcRequestBuilder. This method must be called before any of the other methods in this class may be called. Calling `create` before calling `finish()` will reset the state of the RpcRequestBuilder.

      This method delegates to `doCreate(java.lang.String)` to instantiate the RequestBuilder.

      Parameters:
        `serviceEntryPoint` - The URL entry point
      Returns:
        `this`
      See Also:
        `ServiceDefTarget.setServiceEntryPoint(String)`

    - #### finish

          public final RequestBuilder finish()

      This method must be called to return the RequestBuilder that the RPC request will be made with.

      This method will call `doFinish(com.google.gwt.http.client.RequestBuilder)` before returning the current RequestBuilder.

    - #### setCallback

          public final RpcRequestBuilder setCallback(RequestCallback callback)

      Sets the RequestCallback to be used by the RequestBuilder. Delegates to `doSetCallback(com.google.gwt.http.client.RequestBuilder, com.google.gwt.http.client.RequestCallback)`.
      Parameters:
        `callback` - the RequestCallback to be used by the RequestBuilder
      Returns:
        `this`

    - #### setContentType

          public final RpcRequestBuilder setContentType(java.lang.String contentType)

      Sets the MIME content type to be used by the RequestBuilder. Delegates to `doSetContentType(com.google.gwt.http.client.RequestBuilder, java.lang.String)`.
      Parameters:
        `contentType` - the MIME content type to be used in the request
      Returns:
        `this`

    - #### setRequestData

          public final RpcRequestBuilder setRequestData(java.lang.String data)

      Sets the request data to be sent in the request. Delegates to `doSetRequestData(com.google.gwt.http.client.RequestBuilder, java.lang.String)`.
      Parameters:
        `data` - the data to send
      Returns:
        `this`

    - #### setRequestId

          public final RpcRequestBuilder setRequestId(int id)

      Sets the request id of the request. Delegates to `doSetRequestId(com.google.gwt.http.client.RequestBuilder, int)`.
      Parameters:
        `id` - the issue number of the request
      Returns:
        `this`

    - #### doCreate

          protected RequestBuilder doCreate(java.lang.String serviceEntryPoint)

      Called by `create(java.lang.String)` to instantiate the RequestBuilder object.

      The default implementation creates a `POST` RequestBuilder with the given entry point.

      Parameters:
        `serviceEntryPoint` - the URL to which the request should be issued
      Returns:
        the RequestBuilder that should be ultimately passed to the RpcRequestBuilder's caller.

    - #### doFinish

          protected void doFinish(RequestBuilder rb)

      Called by `finish()` prior to returning the RequestBuilder to the caller.

      The default implementation sets the "X-GWT-Permutation" header to the value returned by `GWT.getPermutationStrongName()`.

      Parameters:
        `rb` - The RequestBuilder that is currently being configured

    - #### doSetCallback

          protected void doSetCallback(RequestBuilder rb,
                           RequestCallback callback)

      Called by `setCallback(com.google.gwt.http.client.RequestCallback)`.

      The default implementation calls `RequestBuilder.setCallback(RequestCallback)`.

      Parameters:
        `rb` - the RequestBuilder that is currently being configured
        `callback` - the user-provided callback

    - #### doSetContentType

          protected void doSetContentType(RequestBuilder rb,
                              java.lang.String contentType)

      Called by `setContentType(java.lang.String)`.

      The default implementation sets the "Content-Type" header to the value specified by `contentType` by calling `RequestBuilder.setHeader(String, String)`.

      Parameters:
        `rb` - the RequestBuilder that is currently being configured
        `contentType` - the desired MIME type of the request's contents

    - #### doSetRequestData

          protected void doSetRequestData(RequestBuilder rb,
                              java.lang.String data)

      Called by `setRequestData(java.lang.String)`.

      The default implementation invokes `RequestBuilder.setRequestData(String)`.

      Parameters:
        `rb` - the RequestBuilder that is currently being configured
        `data` - the data to send

    - #### doSetRequestId

          protected void doSetRequestId(RequestBuilder rb,
                            int id)

      Called by `setRequestId(int)`.

      The default implementation is a no-op.

      Parameters:
        `rb` - the RequestBuilder that is currently being configured
        `id` - the request's issue id