jax-ws 生成soap_使用JAX-WS创建SOAP Web服务

2022-09-14 13:13:51 浏览数 (1)

大家好,又见面了,我是你们的朋友全栈君。

jax-ws 生成soap

本文中显示的Web服务已在此处实时部署

有多种创建Web服务的方法。 在本文中,我们将使用JAX-WS创建基于SOAP的Web服务,该服务是XML Web Services的Java API,并将其部署在Tomcat下。

要记住的重要一点是,可以使用JAX-WS构建SOAP和REST样式的Web服务。 有一个常见的误解,即JAX-WS用于创建基于SOAP的Web服务,而JAX-RS用于创建REST风格的Web服务。

JAX-WS API非常丰富,并提供了一些注释,使开发人员的工作变得轻松。

不同样式的基于SOAP的Web服务

基于SOAP的Web服务可以归类为

  • RPC样式– RPC样式用于创建包括简单数据类型(内置类型)的SOAP Web服务。
  • 文档样式–这是默认样式,用于创建包含复杂数据类型的SOAP Web服务

DiscoverIndia Web服务

我们将创建一个名为DiscoverIndia的基于SOAP的Web服务。 该网络服务的全部意义是,您将印度州的名称传递给该服务,然后您可以检索

  • 该州的首都
  • 该州的区数
  • 该州的当地语言
  • 该州的机场
  • 在该州参观的地方
  • 关于国家的一些有趣的事实

在开始实施之前,让我们了解基于SOAP的Web服务的体系结构。

因此,事不宜迟,让我们开始使用代码。

实施Web服务

这是该服务的服务端点接口(SEI)

代码语言:javascript复制
@WebService
public interface Country {

	@WebMethod
	String getCapital(String s);

	@WebMethod
	String getLanguages(String s);

	@WebMethod
	String getAirports(String s);

	@WebMethod
	int getDistricts(String s);

	@WebMethod
	String getPlacesToVisit(String s);

	@WebMethod
	String getInterestingFacts(String s);
}

CountryImpl是服务实现Bean(SIB),用于实现SEI的所有方法。

代码语言:javascript复制
@WebService
public class CountryImpl implements Country {
	private Utility states;
	public CountryImpl(){
		states=new Utility();
		states.loadData();
	}
	@WebMethod
	public String getCapital(String stateName) {
		return states.getState(stateName).getCapital();
	}
	@WebMethod
	public String getLanguages(String stateName) {
		return states.getState(stateName).getLanguages();
	}
	@WebMethod
	public String getAirports(String stateName) {
		return states.getState(stateName).getAirports();
	}
	@WebMethod
	public int getDistricts(String stateName) {
		return states.getState(stateName).getDistricts();
	}
	@WebMethod
	public String getPlacesToVisit(String stateName) {
		return states.getState(stateName).getPlacesToVisit();
	}
	@WebMethod
	public String getInterestingFacts(String stateName) {
		return states.getState(stateName).getInterestingFacts();
	}
}

请注意,在CountryImpl类中,我们有Utility类的成员,该类将状态信息存储在Map中。

这是国家类别,代表使用吸气剂和吸气剂的国家。

代码语言:javascript复制
public class State {
	private String name;
	private String capital;
	private int districts;
	private String languages;
	private String airports;
	private String placesToVisit;
	private String interestingFacts;

	State(String name,String capital,int districts,String languages,String airports,String placesToVisit,String interestingFacts){
		this.name=name;
		this.capital=capital;
		this.districts=districts;
		this.languages=languages;
		this.airports=airports;
		this.placesToVisit=placesToVisit;
		this.interestingFacts=interestingFacts;
	}

	public String getName(){
		return name;
	}
	public void setName(String name){
		this.name=name;
	}
	public String getAirports() {
		return airports;
	}
	public void setAirports(String airports) {
		this.airports = airports;
	}
	public String getCapital() {
		return capital;
	}
	public void setCapital(String capital) {
		this.capital = capital;
	}
	public String getLanguages() {
		return languages;
	}
	public void setLanguages(String languages) {
		this.languages = languages;
	}
	public int getDistricts() {
		return districts;
	}
	public void setDistricts(int districts) {
		this.districts = districts;
	}
	public String getPlacesToVisit() {
		return placesToVisit;
	}
	public void setPlacesToVisit(String placesToVisit) {
		this.placesToVisit = placesToVisit;
	}
	public String getInterestingFacts() {
		return interestingFacts;
	}
	public void setInterestingFacts(String interestingFacts) {
		this.interestingFacts = interestingFacts;
	}

}

我们有一个实用程序类,该类具有Map <String,State> state_map来存储状态信息(状态名称为键)。 Utility类还具有一个loadData()方法,该方法填充state_map

代码语言:javascript复制
public class Utility {

	Map<String, State> state_map;

	Utility() {
		state_map = new HashMap<String, State>();
	}

	void loadData(){

		State rajasthan=new State("Rajasthan","Jaipur",33,"Hindi, Rajasthani","Jaipur, Jodhpur, Udaipur","Ajmer, Udaipur, Jaipur","Rajasthan is famous for its marbles");
		State punjab=new State("Punjab","Chandigarh",22,"Hindi, Punjabi","Amritsar","Amritsar, Ludhiana","Punjab is popular for its joyful punjabi people");
		State mp=new State("Madhya Pradesh","Bhopal",51 ,"Hindi","Bhopal, Gwalior","Bhopal, Gwalior","Madhya Pradesh is well known for its wildlife and monuments");
		State haryana=new State("Haryana","Chandigarh",21 ,"Hindi, Haryanvi","","Hisar, Rohtak, Fridabad","Haryana is popular for its haryanvi language");
		State gujrat=new State("Gujrat","Gandhinagar",33 ,"Hindi, Gujrati","Ahmedabad, Vadodara, Gandhinagar","Ahmedabad, Vadodara","Gujrat is famous for its rich culture and dandiya nights");

		state_map.put("Rajasthan", rajasthan);
		state_map.put("Punjab", punjab);
		state_map.put("Madhya Pradesh", mp);
		state_map.put("Haryana", haryana);
		state_map.put("Gujrat", gujrat);	

		}

	State getState(String stateName) {
		State state = null;
		state = state_map.get(stateName);
		return state;
	}

}

配置Web服务

由于在本例中为Apache Tomcat,因此将Web服务部署在Web容器中,因此我们必须在web.xml文件中配置Web服务,如下所示。

代码语言:javascript复制
<listener>
		<listener-class>
			com.sun.xml.ws.transport.http.servlet.WSServletContextListener
		</listener-class>
</listener>
<servlet>
		<servlet-name>xyz</servlet-name>
		<servlet-class>
			com.sun.xml.ws.transport.http.servlet.WSServlet
		</servlet-class>
		<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
		<servlet-name>xyz</servlet-name>
		<url-pattern>/discoverIndia</url-pattern>
</servlet-mapping>

最后一种配置是必需的–在WEB-INF文件夹中创建一个文件sun-jaxws.xml,该文件定义了Service实现类。

代码语言:javascript复制
<endpoints xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime"
	version="2.0">
	<endpoint name="WebServicImpl"
		implementation="net.mahtabalam.ws.CountryImpl"
		url-pattern="/discoverIndia" />
</endpoints>

请注意,您将需要额外的jax-ws库才能在Tomcat下发布基于SOAP的Web服务。 您可以从jax-ws.net下载这些库,并将它们放在WEB-INF / lib文件夹中。

现在运行该项目,您的Web服务将被部署并可以在web.xml文件(在本例中为/ discoverIndia)中提到的任何URL下使用。

您可以通过在已部署的Web服务URL的末尾附加?wsdl来访问WSDL(服务合同)。

Eclipse IDE中项目结构的快照。

发布Web服务后,您可以使用任何语言的Python,Perl,C#,Java等针对Web服务编写客户端。

这就是Web服务的美,它们独立于语言。 让我们编写一个Java客户端来使用Web服务。

我们将使用JDK6附带的wsimport实用程序来生成客户端构件,以使其很容易针对discoverIndia Web服务编写客户端。

上面的命令将生成人工制品,我们将使用它们来编写一个简单的客户端。

这是Client.java,它使用wsimport生成的类编写简单的Web服务客户端。

代码语言:javascript复制
package wsclient;
 public class Client {

	public static void main(String[] args) {
		CountryImplService service=new CountryImplService();
		CountryImpl country=service.getCountryImplPort();
		System.out.println("Capital of Kerala : " country.getCapital("Kerala"));
		System.out.println("No. of districts in Telangna : " country.getDistricts("Telangna"));
		System.out.println("Local languages of Gujrat : " country.getLanguages("Gujrat"));
		System.out.println("Airports in Uttrakhand : " country.getAirports("Uttrakhand"));
		System.out.println("Places to visit in Rajasthan : " country.getPlacesToVisit("Rajasthan"));
		System.out.println("Interesting Facts about Meghalaya : " country.getInterestingFacts("Meghalaya"));
	}
 }

现在编译Client.java并运行它。

请记住,如果使用状态名称调用该Web服务,而该名称未由Web服务处理,则将获得SOAP Fault作为响应。

获取源代码:如果您有兴趣亲自尝试该代码,可以从GitHub获得它。

使用实时Web服务:此Web服务已在mathabalam.net上实时部署,并且WSDL文件在此处 。

翻译自: https://jaxenter.com/creating-soap-web-services-using-jax-ws-117689.html

jax-ws 生成soap

发布者:全栈程序员栈长,转载请注明出处:https://javaforall.cn/159688.html原文链接:https://javaforall.cn

0 人点赞