JAX-WS注解说明
WebService的注解都位于javax.jws包下:
@WebService-定义服务,在public class上边
targetNamespace:指定命名空间
name:portType的名称
portName:port的名称
serviceName:服务名称
endpointInterface:SEI接口地址,如果一个服务类实现了多个接口,只需要发布一个接口的方法,可通过此注解指定要发布服务的接口。
@WebMethod-定义方法,在公开方法上边
operationName:方法名
exclude:设置为true表示此方法不是webservice方法,反之则表示webservice方法
@WebResult-定义返回值,在方法返回值前边
name:返回结果值的名称
@WebParam-定义参数,在方法参数前边
name:指定参数的名称
作用:
通过注解,可以更加形像的描述Web服务。对自动生成的wsdl文档进行修改,为使用者提供一个更加清晰的wsdl文档。
当修改了WebService注解之后,会影响客户端生成的代码。调用的方法名和参数名也发生了变化
示例:
/**
* 注意,这里的@WebService必须加,是要告诉系统这是个WebService的程序
*/
@WebService(targetNamespace="http://www.ckinghan.com/service",name="weatherWSSOAP",portName="weatherService",serviceName="weatherWSSOAP")
public class WeatherServiceImpl implements WeatherService{
/**
* 实现接口中的方法
*/
@Override
@WebMethod(operationName="getWeatherInfo",exclude=false)
public @WebResult(name="weatherInfo")String getWeatherInfo(@WebParam(name= "cityName")String city) {
System.out.println("接收到来自客户端的请求数据:"+city);
return "这是个晴天";
}
}
结果如下: