JavaTM Platform
Standard Ed. 6

javax.jws
주석형 WebService



@Retention (value =RUNTIME )
@Target (value =TYPE )
public @interface WebService

Web 서비스를 구현하는 Java 클래스로서 또는 Web 서비스 인터페이스를 정의하는 Java 인터페이스로서 마크 합니다.


임의 요소의 개요
 String endpointInterface
          서비스의 추상 Web 서비스 규약을 정의하는 서비스 엔드 포인트 인터페이스의 완전한 이름입니다.
 String name
          Web 서비스의 이름입니다.
 String portName
          Web 서비스의 포트명입니다.
 String serviceName
          Web 서비스의 서비스명입니다.
 String targetNamespace
          서비스 엔드 포인트 인터페이스에 @WebService.targetNamespace 주석이 있는 경우, targetNamespace 는 wsdl:portType ( 및 관련지을 수 있었던 XML 요소)의 이름 공간으로서 사용됩니다.
 String wsdlLocation
          서비스를 기술하는 정의가 끝난 WSDL 의 장소입니다.
 

name

public abstract String  name
Web 서비스의 이름입니다.  

WSDL 1.1 에 매핑 될 때 wsdl:portType 의 이름으로서 사용됩니다.

디폴트:
""

targetNamespace

public abstract String  targetNamespace
서비스 엔드 포인트 인터페이스에 @WebService.targetNamespace 주석이 있는 경우, targetNamespace 는 wsdl:portType ( 및 관련지을 수 있었던 XML 요소)의 이름 공간으로서 사용됩니다.  

서비스 엔드 포인트 인터페이스를 (endpointInterface 속성을 개입시켜) 참조하지 않는 서비스 구현 Bean 에 @WebService.targetNamespace 주석이 있는 경우, targetNamespace 는 wsdl:portType 와 wsdl:service 의 양쪽 모두 ( 및 관련지을 수 있었던 XML 요소)에 사용됩니다.  

서비스 엔드 포인트 인터페이스를 (endpointInterface 속성을 개입시켜) 참조하는 서비스 구현 Bean 에 @WebService.targetNamespace 주석이 있는 경우, targetNamespace 는 wsdl:service ( 및 관련지을 수 있었던 XML 요소)인 만큼 사용됩니다.

디폴트:
""

serviceName

public abstract String  serviceName
Web 서비스의 서비스명입니다.  

WSDL 1.1 에 매핑 될 때 wsdl:service 의 이름으로서 사용됩니다.  

이 멤버치는, 엔드 포인트 인터페이스에서는 사용할 수 없습니다.

디폴트:
""

portName

public abstract String  portName
Web 서비스의 포트명입니다.  

WSDL 1.1 에 매핑 될 때 wsdl:port 의 이름으로서 사용됩니다.  

이 멤버치는, 엔드 포인트 인터페이스에서는 사용할 수 없습니다.

도입된 버젼:
2.0
디폴트:
""

wsdlLocation

public abstract String  wsdlLocation
서비스를 기술하는 정의가 끝난 WSDL 의 장소입니다.  

wsdlLocation 는, 기존의 WSDL 파일을 참조하는, 상대 URL 또는 절대 URL 입니다. wsdlLocation 치의 존재는, 서비스 구현 Bean 가 정의가 끝난 WSDL 규약을 구현하는 것을 나타내고 있습니다. 서비스 구현 Bean 가, 이 WSDL 로 선언되고 있는 portType 나 바인딩에 모순되고 있는 경우, JSR-181 툴은 피드백을 제공할 필요가 있습니다. 단일의 WSDL 파일에 복수의 portTypes 나 복수의 바인딩이 포함되는 경우도 있습니다. 서비스 구현 Bean 의 주석에 의해, Web 서비스에 대응하는 특정의 portType 와 바인딩이 정해집니다.

디폴트:
""

endpointInterface

public abstract String  endpointInterface
서비스의 추상 Web 서비스 규약을 정의하는 서비스 엔드 포인트 인터페이스의 완전한 이름입니다.  

개발자는 이 주석을 사용해, 인터페이스 규약을 구현으로부터 분리할 수가 있습니다. 이 주석이 존재하는 경우, 서비스 엔드 포인트 인터페이스는 추상 Web 서비스 규약 (portType 와 바인딩)을 결정하기 위해서(때문에) 사용됩니다. Java 로부터 WSDL 에의 매핑을 커스터마이즈 하기 위해서, 서비스 엔드 포인트 인터페이스에 JSR-181 주석을 포함할 수도 있습니다.
서비스 구현 Bean 로 서비스 엔드 포인트 인터페이스를 구현할 수도 있습니다만, 필수가 아닙니다.
이 멤버치가 존재하지 않는 경우, Web 서비스 규약은 서비스 구현 Bean 의 주석으로부터 생성됩니다. 타겟 환경에서 서비스 엔드 포인트 인터페이스가 필요한 경우는, 구현으로 정의된 패키지안에, 구현으로 정의된 이름으로 서비스 엔드 포인트 인터페이스가 생성됩니다.

이 멤버치는, 엔드 포인트 인터페이스에서는 사용할 수 없습니다.

디폴트:
""

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.