Как сделать вызов веб-службы SOAP из класса Java?
Я относительно новичок в мире веб-сервисов, и мои исследования, похоже, смутили меня больше, чем просветили меня, моя проблема в том, что мне дали библиотеку(jar), которую я должен расширить с помощью некоторых функций веб-сервиса.
эта библиотека будет совместно использоваться другими разработчиками, и среди классов в jar будут классы, которые имеют метод, который вызывает веб-сервис (который по существу устанавливает атрибут класса, выполняет некоторую бизнес-логику, например, хранение объекта в БД и т. д и возвращает объект с этими изменениями). Я хочу сделать вызов этой службы максимально простым, надеюсь, настолько простым, что разработчику, использующему класс, нужно только сделать.
Car c = new Car("Blue");
c.webmethod();
Я изучал JAX-WS для использования на сервере, но мне кажется, что мне не нужно создавать wsimport
на сервере, ни wsimport
на клиенте, так как я знаю, что у обоих есть классы, мне просто нужно некоторое взаимодействие между классами, общими как на сервере, так и на клиенте. Как вы думаете, имеет смысл делать веб-сервис и вызов в классе?
2 ответов
Я понимаю, что ваша задача сводится к как вызвать веб-службу SOAP (JAX-WS) из Java и получить ее возвращаемый объект. В этом случае у вас есть два возможных подхода:
- генерировать классы Java через
wsimport
и использовать их; или - создайте клиент SOAP, который:
- сериализует параметры сервиса в XML;
- вызывает веб-метод через HTTP-манипуляции; и
- парсить возврат XML-ответа обратно в объект.
о первом подходе (используя wsimport
):
Я вижу, что у вас уже есть бизнес-классы сервисов (сущностей или других), и это факт, что wsimport
генерирует целый новый набор классов (которые каким-то образом дублируют классы, которые у вас уже есть).
боюсь, однако, в этом сценарии вы можете только либо:
- адаптировать (изменять)
wsimport
сгенерированный код, чтобы использовать код бизнес-классы (это сложно и как - то не стоит-имейте в виду каждый раз, когда WSDL изменяется, вам придется регенерировать и переадресовывать код); или - и
wsimport
созданных классов. (В этом решении бизнес-код может "использовать" созданные классы как сервис из другого архитектурного слоя.)
о второй подход (создайте свой собственный клиент SOAP):
чтобы реализовать второй подход, вам придется:
- звоните:
- используйте saaj (SOAP with Attachments API for Java) framework (см. ниже, он поставляется с Java SE 1.6 или выше) для совершения вызовов; или
- вы также можете сделать это с помощью
java.net.HttpUrlconnection
(и некоторыхjava.io
обработки).
- Поверните объекты в и назад от XML:
- используйте структуру OXM (Object to XML Mapping), такую как JAXB для сериализации/десериализации XML из/в объекты
- или, если необходимо, вручную создайте / проанализируйте XML (это может быть лучшим решением, если полученный объект только немного отличается от отправленного).
создание SOAP-клиента с помощью classic java.net.HttpUrlConnection
- это не так сложно (но и не так просто), и вы можете найти в этой ссылке a очень хороший стартовый код.
я рекомендую вам использовать структуру SAAJ:
SOAP с вложениями API для Java (SAAJ) в основном используется для работы непосредственно с SOAP-запросами / ответными сообщениями, которые происходят за кулисами в любом API веб-службы. Это позволяет разработчикам напрямую отправлять и получать сообщения soap вместо использования JAX-WS.
см. ниже рабочий пример (запустите его!) вызова веб-службы SOAP с помощью SAAJ. Он зовет этот веб-сервис.
import javax.xml.soap.*;
public class SOAPClientSAAJ {
// SAAJ - SOAP Client Testing
public static void main(String args[]) {
/*
The example below requests from the Web Service at:
https://www.w3schools.com/xml/tempconvert.asmx?op=CelsiusToFahrenheit
To call other WS, change the parameters below, which are:
- the SOAP Endpoint URL (that is, where the service is responding from)
- the SOAP Action
Also change the contents of the method createSoapEnvelope() in this class. It constructs
the inner part of the SOAP envelope that is actually sent.
*/
String soapEndpointUrl = "https://www.w3schools.com/xml/tempconvert.asmx";
String soapAction = "https://www.w3schools.com/xml/CelsiusToFahrenheit";
callSoapWebService(soapEndpointUrl, soapAction);
}
private static void createSoapEnvelope(SOAPMessage soapMessage) throws SOAPException {
SOAPPart soapPart = soapMessage.getSOAPPart();
String myNamespace = "myNamespace";
String myNamespaceURI = "https://www.w3schools.com/xml/";
// SOAP Envelope
SOAPEnvelope envelope = soapPart.getEnvelope();
envelope.addNamespaceDeclaration(myNamespace, myNamespaceURI);
/*
Constructed SOAP Request Message:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:myNamespace="https://www.w3schools.com/xml/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<myNamespace:CelsiusToFahrenheit>
<myNamespace:Celsius>100</myNamespace:Celsius>
</myNamespace:CelsiusToFahrenheit>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
*/
// SOAP Body
SOAPBody soapBody = envelope.getBody();
SOAPElement soapBodyElem = soapBody.addChildElement("CelsiusToFahrenheit", myNamespace);
SOAPElement soapBodyElem1 = soapBodyElem.addChildElement("Celsius", myNamespace);
soapBodyElem1.addTextNode("100");
}
private static void callSoapWebService(String soapEndpointUrl, String soapAction) {
try {
// Create SOAP Connection
SOAPConnectionFactory soapConnectionFactory = SOAPConnectionFactory.newInstance();
SOAPConnection soapConnection = soapConnectionFactory.createConnection();
// Send SOAP Message to SOAP Server
SOAPMessage soapResponse = soapConnection.call(createSOAPRequest(soapAction), soapEndpointUrl);
// Print the SOAP Response
System.out.println("Response SOAP Message:");
soapResponse.writeTo(System.out);
System.out.println();
soapConnection.close();
} catch (Exception e) {
System.err.println("\nError occurred while sending SOAP Request to Server!\nMake sure you have the correct endpoint URL and SOAPAction!\n");
e.printStackTrace();
}
}
private static SOAPMessage createSOAPRequest(String soapAction) throws Exception {
MessageFactory messageFactory = MessageFactory.newInstance();
SOAPMessage soapMessage = messageFactory.createMessage();
createSoapEnvelope(soapMessage);
MimeHeaders headers = soapMessage.getMimeHeaders();
headers.addHeader("SOAPAction", soapAction);
soapMessage.saveChanges();
/* Print the request message, just for debugging purposes */
System.out.println("Request SOAP Message:");
soapMessage.writeTo(System.out);
System.out.println("\n");
return soapMessage;
}
}
об использовании JAXB для сериализации / десериализации, очень легко найти информацию об этом. Вы можете начать здесь: http://www.mkyong.com/java/jaxb-hello-world-example/.
или просто использовать Wsdl2java от Apache CXF для создания объектов, которые вы можете использовать.
Он включен в бинарный пакет можно скачать с их сайта. Вы можете просто запустить такую команду:
$ ./wsdl2java -p com.mynamespace.for.the.api.objects -autoNameResolution http://www.someurl.com/DefaultWebService?wsdl
Он использует wsdl для создания объектов, которые вы можете использовать следующим образом (имена объектов также захватываются из wsdl, поэтому ваши будут немного отличаться):
DefaultWebService defaultWebService = new DefaultWebService();
String res = defaultWebService.getDefaultWebServiceHttpSoap11Endpoint().login("webservice","dadsadasdasd");
System.out.println(res);
существует даже плагин Maven, который генерирует источники: https://cxf.apache.org/docs/maven-cxf-codegen-plugin-wsdl-to-java.html
Примечание: Если вы создаете источники с помощью CXF и IDEA, вы можете посмотреть на это:https://stackoverflow.com/a/46812593/840315