One of the most common scenarios is that where you have a service which you may or not manage and this service has a WSDL. In this case you’ll often want to generate a client from the WSDL. This provides you with a strongly typed interface by which to interact with the service. Once you’ve generated a client, typical usage of it will look like so:
HelloService service = new HelloService(); Hello client = service.getHelloHttpPort(); String result = client.sayHi("Joe");
The WSDL2Java tool will generate JAX-WS clients from your WSDL. You can run WSDL2java one of three ways:
For more in depth information read Developing a JAX-WS consumer or see the Hello World demos inside the distribution.
JAX-WS Proxy
Instead of using a wsdl2java-generated stub client directly, you can use Service.create to create Service instances, the following code illustrates this process:
import java.net.URL; import javax.xml.ws.Service; . URL wsdlURL = new URL("http://localhost/hello?wsdl"); QName SERVICE_NAME = new QName("http://apache.org/hello_world_soap_http", "SOAPService"); Service service = Service.create(wsdlURL, SERVICE_NAME); Greeter client = service.getPort(Greeter.class); String result = client.greetMe("test");
JAX-WS Dispatch APIs
JAX-WS provides the «dispatch» mechanism which makes it easy to dynamically invoke services which you have not generated a client for. Using the Dispatch mechanism you can create messages (which can be JAXB objects, Source objects, or a SAAJMessage) and dispatch them to the server. A simple example might look like this:
import java.net.URL; import javax.xml.transform.Source; import javax.xml.ws.Dispatch; import javax.xml.ws.Service; . URL wsdlURL = new URL("http://localhost/hello?wsdl"); Service service = Service.create(wsdlURL, new QName("HelloService")); Dispatch disp = service.createDispatch(new QName("HelloPort"), Source.class, Service.Mode.PAYLOAD); Source request = new StreamSource("") Source response = disp.invoke(request);
NOTE: you can also use dispatches without a WSDL.
For more in depth information see the Hello World demos inside the distribution.
If you’ve developed a service using the simple frontend, you can use the ClientProxyFactoryBean API to create a Java proxy client for your service. This way you can use the service interface to talk to your service. For more information see the Simple Frontend documentation.
Dynamic Client
CXF includes a Client interface which allows you to invoke operations and pass parameters for those operations. For instance:
Client client = . ; Object[] result = client.invoke("sayHi", "Dan");
There are two ways to create Clients at runtime. The first choice is to use the ClientFactoryBean or JaxWsClientFactoryBean classes. These will create proxy objects for the SEI for the service. These proxies cannot handle complex objects.
The second to use the DynamicClientFactory or one of its subclasses. The DynamicClientFactory goes the additional step of generating and compiling JAXB POJOs for complex objects described in the WSDL, for use at runtime via reflection.
This is most useful when you’re using a dynamic language such as Groovy with CXF, but it is possible to use reflection directly from Java.
Privacy Policy — (edit page) (add comment) Apache CXF, CXF, Apache, the Apache feather logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
Following Client application is used with the help of generated src using the above pom . Once everything is set up in eclipse you can see the generated src in target folder. Or you can run a maven build
package com.smoothexample.pro; /** * Please modify this class to meet your needs * This class is not complete */ import java.io.File; import java.net.MalformedURLException; import java.net.URL; import javax.xml.namespace.QName; import com.smoothexample.cxf.soap.ws.AddressSoapService; import com.smoothexample.cxf.soap.ws.impl.AddressSoapServiceImplService; public final class AddressSoapServiceClient < private static final QName SERVICE_NAME = new QName("http://impl.ws.soap.cxf.smoothexample.com/", "AddressSoapServiceImplService"); private AddressSoapServiceClient() < >public static void main(String args[]) throws java.lang.Exception < URL wsdlURL = AddressSoapServiceImplService.WSDL_LOCATION; if (args.length >0 && args[0] != null && !"".equals(args[0])) < File wsdlFile = new File(args[0]); try < if (wsdlFile.exists()) < wsdlURL = wsdlFile.toURI().toURL(); >else < wsdlURL = new URL(args[0]); >> catch (MalformedURLException e) < e.printStackTrace(); >> AddressSoapServiceImplService ss = new AddressSoapServiceImplService(wsdlURL, SERVICE_NAME); AddressSoapService port = ss.getAddressSoapServiceImplPort(); < System.out.println("Invoking getAddress. "); try < com.smoothexample.cxf.soap.ws.Address address = port.getAddress(); System.out.println("getAddress.result=" + address.getCountry()); >catch (Exception e) < System.out.println("Expected exception: Exception has occurred."); System.out.println(e.toString()); >> System.exit(0); > >
Generated WSDL
This wsdl is just for your reference, location of theWSDL is defined in
Разработка SOAP Web-сервиса с использованием Apache CXF
В последнем посте я рассмотрел шаги по разработке простого сервиса RESTFull с использованием apache CXF . В этой статье я расскажу о разработке веб-службы SOAP с использованием CXF. Прежде чем двигаться вперед, давайте разберемся с некоторыми концепциями / элементами, которые составляют веб-сервис SOAP.
SOAP или простой протокол доступа к объектам
SOAP — это протокол обмена сообщениями на основе XML по сети, использующий в качестве носителя протоколы приложений, такие как http, smtp и т. Д. Сообщение SOAP состоит из конверта SOAP. Конверт можно разбить на заголовок и тело. Заголовок содержит определения, связанные с контекстом, такие как безопасность, а тело содержит фактические данные приложения. Типичное сообщение SOAP выглядит так
WSDL или язык описания веб-сервисов
WSDL — это стандартный язык XML, который используется для описания веб-службы. WSDL полностью описывает, какой публичный интерфейс предоставляет веб-служба, какой параметр он ожидает, структуру вывода, которую он возвращает, местоположение веб-службы. WSDL определяет веб-сервис как совокупность конечных точек связи, которые способны обмениваться сообщениями. Эти конечные точки связи называются портами. Порт состоит из двух частей.
Содержит открытый интерфейс, предоставляемый веб-службой. Интерфейс содержит все методы, параметры, необходимые для их вызова, и структуру ответа, возвращаемую ими.
Вторая часть связывает общедоступный интерфейс с сетевым протоколом, таким как http. Привязка содержит информацию, такую как местоположение открытого интерфейса и формат сообщения для службы.
SOAP стили общения
Существует два типа стилей общения
Стиль связи, используемый веб-службой SOAP, определен в его WSDL.
В стиле документа данные приложения, являющиеся частью мыльного тела, отправляются в виде документа XML. Этот документ может быть полностью подтвержден XML-схемой, которая также является частью WSDL. Поскольку XML может содержать структуру по желанию разработчика сервиса, следовательно, ответственность за маршалинг и демаршализацию полезной нагрузки xml лежит на конце кода поставщика и потребителя.
В стиле RPC, как следует из названия, потребитель вызывает методы обслуживания, как если бы он вызывал локальный метод. Для этого сообщение RPC состоит из списка методов открытого интерфейса, которые может вызвать потребитель. Эти методы перечислены по именам как элементы xml. Параметры метода, необходимые для этого метода, образуют подэлементы элемента метода. Ответственность за маршалинг / демаршалинг лежит в основе веб-сервиса. Каркас содержит свои собственные библиотеки маршалинга / демаршалинга. Стиль RPC приводит к тесно связанному коду между кодом приложения и структурой веб-службы, поэтому нормой является создание служб стиля документа. Имея ключевые концепции, давайте рассмотрим пример написания мыльного веб-сервиса с использованием Apache CXF.
Получение исходного кода для этого урока
Я передал исходные файлы для этого урока в SVN.
Примечание. Оба проекта являются проектами ItelliJ maven, поэтому вы можете напрямую импортировать их в вашу IDE IntelliJ или вручную скопировать файлы в другие IDE.
Создайте скелетное приложение struts2, в котором будет содержаться ваш сервис.
Вы можете использовать любой MVC-фреймворк, но я предпочитаю struts2 по моим собственным причинам. Вы можете увидеть пример того, как создать пустое приложение struts2 в eclipse, используя maven здесь .
Добавить зависимости CXF
В вашем проекте POM добавьте следующие зависимости для загрузки CXF jars