RESTful вызов на Java
Я собираюсь сделать спокойный вызов на Java. Однако я не знаю, как позвонить. Нужно ли использовать URLConnection или другие? Кто-нибудь может мне помочь. спасибо.
10 ответов
если вы вызываете службу RESTful от поставщика услуг (e.G Facebook, Twitter), вы можете сделать это с любым вкус на ваш выбор:
если вы не хотите использовать внешние библиотеки, вы можете использовать java.net.HttpURLConnection
или javax.net.ssl.HttpsURLConnection
(для SSL), но это вызов, инкапсулированный в шаблон заводского типа в java.net.URLConnection
.
Чтобы получить результат, вам придется connection.getInputStream()
который возвращает вам InputStream
. Затем вам нужно будет преобразовать входной поток в string и проанализировать строку в это репрезентативный объект (например, XML, JSON и т. д.).
кроме того, Apache HttpClient (версия 4 является последней). Он более стабилен и надежен, чем Java по умолчанию URLConnection
и он поддерживает большинство (если не все) HTTP-протокол (а также он может быть установлен в строгий режим). Ваш ответ все еще будет в InputStream
и вы можете использовать его как упоминалось выше.
документация по HttpClient: http://hc.apache.org/httpcomponents-client-ga/tutorial/html/index.html
обновление: прошло почти 5 лет с тех пор, как я написал ответ ниже; сегодня у меня другая перспектива.
99% времени, когда люди используют термин REST, они действительно означают HTTP; они могут меньше заботиться о "ресурсах", "представлениях", "государственных передачах", "единых интерфейсах", "гипермедиа" или любом другом ограничения или аспекты стиля архитектуры REST, определенные Филдингом. Абстракции, предоставляемые различными фреймворками REST поэтому они сбивают с толку и бесполезны.
Итак: вы хотите отправить HTTP-запросы с помощью Java в 2015 году. Вы хотите API, который ясен, выразителен, интуитивно понятен, идиоматичен, прост. Что использовать? Я больше не использую Java, но в течение последних нескольких лет клиентская библиотека JAVA HTTP, которая казалась наиболее перспективной и интересной, -OkHttp. Проверить его.
вы можете определенно взаимодействовать с веб-службами RESTful с помощью URLConnection
или С помощью HttpClient to код HTTP-запросов.
однако, как правило, более желательно использовать библиотеку или фреймворк, который предоставляет более простой и семантический API, специально разработанный для этой цели. Это упрощает написание, чтение и отладку кода и уменьшает дублирование усилий. Эти фреймворки обычно реализуют некоторые отличные функции, которые не обязательно присутствуют или просты в использовании в библиотеках более низкого уровня, таких как согласование контента, кэширование и аутентификация.
некоторые из самые зрелые варианты Джерси, RESTEasy и Restlet.
Я больше всего знаком с 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());
}
Пример Restlet
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());
}
конечно, получить запросы еще проще, и вы также можете указать такие вещи, как теги сущностей и Accept
заголовки, но, надеюсь, эти примеры полезно нетривиально, но не слишком сложно.
как вы можете видеть, Restlet и Jersey имеют аналогичные клиентские API. Я считаю, что они были разработаны примерно в одно и то же время и поэтому влияли друг на друга.
Я нахожу API Restlet немного более семантическим и, следовательно, немного более ясным, но YMMV.
как я уже сказал, Я лучше всего знаком с Restlet, я использовал его во многих приложениях в течение многих лет, и я очень доволен этим. Это очень зрелый, надежный, простой, эффективный, активный, и хорошо поддерживаемые рамки. Я не могу говорить с Джерси или RESTEasy, но у меня впечатление, что они оба также твердый выбор.
Это очень сложно в java, поэтому я бы предложил использовать Spring's RestTemplate
абстракция:
String result =
restTemplate.getForObject(
"http://example.com/hotels/{hotel}/bookings/{booking}",
String.class,"42", "21"
);
ссылки:
- Весна Блог: отдых весной 3 (RestTemplate)
- Весна Ссылка: Доступ К RESTful услуги по клиенту
- JavaDoc:
RestTemplate
Если вам просто нужно сделать простой вызов службы 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();
}
}
есть несколько RESTful API вокруг. Я бы рекомендовал Джерси;
документация API клиента здесь;
https://jersey.java.net/documentation/latest/index.html
обновление
Расположение документов OAuth в комментарии ниже является мертвой ссылкой и переместилось в https://jersey.java.net/nonav/documentation/latest/security.html#d0e12334
Я хочу поделиться своим личным опытом, вызывая 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);
}
}
вы можете проверить 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();
действительно, это "очень сложно в Java":
From: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();
наиболее простым решением будет использование клиентской библиотеки 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);
можно использовать Асинхронный Http-Клиент (библиотека также поддерживает 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();
}