RESTful вызов в Java

Question

Я собираюсь сделать RESTful-вызов в Java. Однако я не знаю, как сделать звонок. Нужно ли использовать URLConnection или другие? Может кто-нибудь мне помочь. спасибо.

Answer 1

Обновление: Прошло почти 5 лет с тех пор, как я написал ответ ниже; сегодня у меня другая точка зрения.

99% случаев, когда люди используют термин REST, они действительно означают HTTP; они могли бы меньше заботиться о «ресурсах», «представлениях», «передачах состояний», «унифицированных интерфейсах», «гипермедиа» или любых других ограничениях или аспектах стиля архитектуры REST, определенных Fielding . Поэтому абстракции, предоставляемые различными средами REST, сбивают с толку и бесполезны.

Итак: вы хотите отправлять HTTP-запросы с использованием Java в 2015 году. Вам нужен API, который будет понятным, выразительным, интуитивно понятным, идиоматическим, простым. Что использовать? Я больше не использую Java, но за последние несколько лет клиентская библиотека Java HTTP, которая показалась наиболее перспективной и интересной, - OkHttp . Проверьте это.

---

Определенно вы можете взаимодействовать с веб-службами RESTful, используя URLConnection или HTTPClient для кодирования HTTP-запросов.

Однако, как правило, более желательно использовать библиотеку или среду, которая предоставляет более простой и более семантический API, специально разработанный для этой цели. Это облегчает написание, чтение и отладку кода и уменьшает дублирование усилий. Эти структуры обычно реализуют некоторые замечательные функции, которые не обязательно присутствуют или которые легко использовать в библиотеках более низкого уровня, такие как согласование содержимого, кэширование и аутентификация.

Некоторые из наиболее зрелых вариантов: Джерси , RESTEasy и Restlet .

Я больше всего знаком с Рестлетом и Джерси, давайте посмотрим, как мы сделаем запрос POST с обоими API.

Пример из Джерси

Form form = new Form();
form.add("x", "foo");
form.add("y", "bar");

Client client = ClientBuilder.newClient();

WebTarget resource = client.target("http://localhost:8080/someresource");

Builder request = resource.request();
request.accept(MediaType.APPLICATION_JSON);

Response response = request.get();

if (response.getStatusInfo().getFamily() == Family.SUCCESSFUL) {
    System.out.println("Success! " + response.getStatus());
    System.out.println(response.getEntity());
} else {
    System.out.println("ERROR! " + response.getStatus());    
    System.out.println(response.getEntity());
}

Пример рестлета

Form form = new Form();
form.add("x", "foo");
form.add("y", "bar");

ClientResource resource = new ClientResource("http://localhost:8080/someresource");

Response response = resource.post(form.getWebRepresentation());

if (response.getStatus().isSuccess()) {
    System.out.println("Success! " + response.getStatus());
    System.out.println(response.getEntity().getText());
} else {
    System.out.println("ERROR! " + response.getStatus());
    System.out.println(response.getEntity().getText());
}

Конечно, GET-запросы еще проще, и вы также можете указывать такие вещи, как теги сущностей и Accept заголовки, но, надеюсь, эти примеры полезны, но не слишком сложны.

Как видите, Рестлет и Джерси имеют похожие клиентские API. Я считаю, что они были разработаны примерно в одно и то же время и поэтому влияли друг на друга.

API Restlet мне кажется немного более семантическим и, следовательно, немного более понятным, но YMMV.

Как я уже сказал, я больше всего знаком с Restlet, я использовал его во многих приложениях в течение многих лет, и я очень доволен этим. Это очень зрелая, надежная, простая, эффективная, активная и хорошо поддерживаемая среда. Я не могу говорить с Джерси или RESTEasy, но у меня сложилось впечатление, что они оба также являются солидным выбором.

Answer 2

Если вы звоните в службу RESTful от поставщика услуг (например, Facebook, Twitter), вы можете сделать это с любым ароматом на ваш выбор:

Если вы не хотите использовать внешние библиотеки, вы можете использовать java.net.HttpURLConnection или javax.net.ssl.HttpsURLConnection (для SSL), но это вызов, инкапсулированный в шаблон типа фабрики в java.net.URLConnection. Чтобы получить результат, вам нужно будет connection.getInputStream(), что вернет вам InputStream. Затем вам нужно будет преобразовать входной поток в строку и проанализировать строку в ее представительном объекте (например, XML, JSON и т. Д.).

В качестве альтернативы, Apache HttpClient (последняя версия 4). Он более стабилен и надежен, чем Java по умолчанию URLConnection, и поддерживает большинство (если не все) HTTP-протоколов (а также может быть установлен в строгом режиме). Ваш ответ по-прежнему будет в InputStream, и вы можете использовать его, как указано выше.

---

Документация по HttpClient: http://hc.apache.org/httpcomponents-client-ga/tutorial/html/index.html

Answer 3

Это очень сложно в Java, поэтому я бы предложил использовать абстракцию Spring * RestTemplate:

String result = 
restTemplate.getForObject(
    "http://example.com/hotels/{hotel}/bookings/{booking}",
    String.class,"42", "21"
);

Ссылка:

• Spring Blog: Отдых в Spring 3 (RestTemplate)
• Spring Reference: Доступ к службам RESTful на клиенте
• JavaDoc:RestTemplate

Answer 4

Если вам просто нужно сделать простой вызов службы REST из java, вы используете что-то вроде этого

/*
 * Stolen from http://xml.nig.ac.jp/tutorial/rest/index.html
 * and http://www.dr-chuck.com/csev-blog/2007/09/calling-rest-web-services-from-java/
*/
import java.io.*;
import java.net.*;

public class Rest {

    public static void main(String[] args) throws IOException {
        URL url = new URL(INSERT_HERE_YOUR_URL);
        String query = INSERT_HERE_YOUR_URL_PARAMETERS;

        //make connection
        URLConnection urlc = url.openConnection();

        //use post mode
        urlc.setDoOutput(true);
        urlc.setAllowUserInteraction(false);

        //send query
        PrintStream ps = new PrintStream(urlc.getOutputStream());
        ps.print(query);
        ps.close();

        //get result
        BufferedReader br = new BufferedReader(new InputStreamReader(urlc
            .getInputStream()));
        String l = null;
        while ((l=br.readLine())!=null) {
            System.out.println(l);
        }
        br.close();
    }
}

Answer 5

Вокруг есть несколько API RESTful. Я бы порекомендовал Джерси;

https://jersey.java.net/

Документация по клиентскому API находится здесь;

https://jersey.java.net/documentation/latest/index.html

Обновление
Расположение для документов OAuth в комментарии ниже является неработающей ссылкой и перемещено в https://jersey.java.net/nonav/documentation/latest/security.html#d0e12334

Answer 6

Я хочу поделиться своим личным опытом вызова REST WS с вызовом Post JSON:

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.PrintStream;
import java.net.URL;
import java.net.URLConnection;

public class HWS {

    public static void main(String[] args) throws IOException {
        URL url = new URL("INSERT YOUR SERVER REQUEST");
        //Insert your JSON query request
        String query = "{'PARAM1': 'VALUE','PARAM2': 'VALUE','PARAM3': 'VALUE','PARAM4': 'VALUE'}";
        //It change the apostrophe char to double colon char, to form a correct JSON string
        query=query.replace("'", "\"");

        try{
            //make connection
            URLConnection urlc = url.openConnection();
            //It Content Type is so importan to support JSON call
            urlc.setRequestProperty("Content-Type", "application/xml");
            Msj("Conectando: " + url.toString());
            //use post mode
            urlc.setDoOutput(true);
            urlc.setAllowUserInteraction(false);

            //send query
            PrintStream ps = new PrintStream(urlc.getOutputStream());
            ps.print(query);
            Msj("Consulta: " + query);
            ps.close();

            //get result
            BufferedReader br = new BufferedReader(new InputStreamReader(urlc.getInputStream()));
            String l = null;
            while ((l=br.readLine())!=null) {
                Msj(l);
            }
            br.close();
        } catch (Exception e){
            Msj("Error ocurrido");
            Msj(e.toString());
        }
    }

    private static void Msj(String texto){
        System.out.println(texto);
    }
}

Answer 7

Вы можете проверить CXF . Вы можете посетить JAX-RS Артикул здесь

Звонить так же просто (цитата):

BookStore store = JAXRSClientFactory.create("http://bookstore.com", BookStore.class);
// (1) remote GET call to http://bookstore.com/bookstore
Books books = store.getAllBooks();
// (2) no remote call
BookResource subresource = store.getBookSubresource(1);
// {3} remote GET call to http://bookstore.com/bookstore/1
Book b = subresource.getDescription();

Answer 8

Наиболее простым решением будет использование клиентской библиотеки Apache http. см. следующий пример кода .. этот код использует базовую безопасность для аутентификации.

Добавить следующую зависимость.

<dependency>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpclient</artifactId>
<version>4.4</version>
</dependency>

CredentialsProvider credentialsProvider = new BasicCredentialsProvider();
Credentials credentials = new UsernamePasswordCredentials("username", "password");
credentialsProvider.setCredentials(AuthScope.ANY, credentials);
HttpClient client = HttpClientBuilder.create().setDefaultCredentialsProvider(credentialsProvider).build();
HttpPost request = new HttpPost("https://api.plivo.com/v1/Account/MAYNJ3OT/Message/");HttpResponse response = client.execute(request);
    // Get the response
    BufferedReader rd = new BufferedReader(new InputStreamReader(response.getEntity().getContent()));
    String line = "";
    while ((line = rd.readLine()) != null) {    
    textView = textView + line;
    }
    System.out.println(textView);

Answer 9

Действительно, это «очень сложно в Java»:

От: https://jersey.java.net/documentation/latest/client.html

Client client = ClientBuilder.newClient();
WebTarget target = client.target("http://foo").path("bar");
Invocation.Builder invocationBuilder = target.request(MediaType.TEXT_PLAIN_TYPE);
Response response = invocationBuilder.get();

Answer 10

Вы можете использовать Async Http Client (библиотека также поддерживает протокол WebSocket ), например:

    String clientChannel = UriBuilder.fromPath("http://localhost:8080/api/{id}").build(id).toString();

    try (AsyncHttpClient asyncHttpClient = new AsyncHttpClient())
    {
        BoundRequestBuilder postRequest = asyncHttpClient.preparePost(clientChannel);
        postRequest.setHeader(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON);
        postRequest.setBody(message.toString()); // returns JSON
        postRequest.execute().get();
    }