Client client = ClientBuilder.newClient() If the target REST resource is expecting an HTTP POST request, call the method. String response = myResource.request(MediaType.TEXT_PLAIN) The return type should correspond to the entity returned by the target REST resource. These methods are:įor example, if the target REST resource is for an HTTP GET request, call the method. Invocation.Builder builder = myResource.request("text/plain") Īfter setting the media type, invoke the request by calling one of the methods of the Invocation.Builder instance that corresponds to the type of HTTP request the target REST resource expects. Using a MediaType constant is equivalent to using the string defining the MIME type. Invocation.Builder builder = myResource.request(MediaType.TEXT_PLAIN) The WebTarget.request method returns an instance of .rs., a helper object that provides methods for preparing the client request. This is usually accomplished by passing to WebTarget.request the accepted media response type for the request either as a string of the MIME type or using one of the constants in .rs.core.MediaType. The WebTarget.path method creates a new WebTarget instance by appending the current target URI with the path that was passed in.Īfter setting and applying any configuration options to the target, call one of the WebTarget.request methods to begin creating the request. In the following example, a base target is used to construct several other targets that represent different services provided by a REST resource. WebTarget myResource = client.target("") įor complex REST resources, it may be beneficial to create several instances of WebTarget. You obtain a WebTarget instance by calling the Client.target method and passing in the URI of the target REST resource. The target of a client, the REST resource at a particular URI, is represented by an instance of the .rs.client.WebTarget interface. The .rs. method invokes the service using an HTTP GET request, setting the type of the returned entity to String. The .rs. method sets the media type for the returned entity. The Client.target method sets the target based on a URI. Then, the request is configured and invoked by chaining method calls together in one line of code. In this example, the client instance is first created by calling the .rs. method. The Client API is designed to be fluent, with method invocations chained together to configure and submit a request to a REST resource in only a few lines of code. Obtain an instance of the .rs.client.Client interface.Ĭonfigure the Client instance with a target. The following steps are needed to access a REST resource using the Client API.
30.1.1 Creating a Basic Client Request Using the Client API
0 kommentar(er)
