개요   패키지    클래스  사용   계층 트리   비추천 API   색인   헬프  
JavaTM Platform
Standard Ed. 6
 앞의 클래스    다음의 클래스 프레임 있어    프레임 없음    
개요: 상자 | 필드  | 생성자  | 메소드 상세: 필드  | 생성자  | 메소드

javax.xml.soap
클래스 SOAPFactory

java.lang.Object 
  상위를 확장 javax.xml.soap.SOAPFactory

public abstract class SOAPFactory
extends Object

SOAPFactory 는, SOAP XML 트리에 존재하는 다양한 객체를 작성하기 위한 팩토리입니다. SOAPFactory 를 사용해, 최종적으로 SOAP 부가 되는 XML fragment를 작성할 수 있습니다. 이러한 fragment는,SOAPHeaderElement ,SOAPBodyElement ,SOAPEnvelope 또는, 다른 SOAPElement 객체의 아이로서 삽입할 수 있습니다. SOAPFactory 에는,java.xml.soap.Name 객체에 가세해 javax.xml.soap.Detail 객체를 작성하는 메소드도 있습니다.

생성자 의 개요
SOAPFactory ()
           
 
메소드의 개요
abstract  Detail createDetail ()
          DetailEntry 객체의 컨테이너로서 기능하는 Detail 객체를 작성합니다.
 SOAPElement createElement (Element  domElement)
          SOAPElement 객체를 기존의 Element 로부터 작성합니다.
abstract  SOAPElement createElement (Name  name)
          지정된 Name 객체를 사용해 초기화된 SOAPElement 객체를 작성합니다.
 SOAPElement createElement (QName  qname)
          지정된 QName 객체를 사용해 초기화된 SOAPElement 객체를 작성합니다.
abstract  SOAPElement createElement (String  localName)
          지정된 로컬명을 사용해 초기화된 SOAPElement 객체를 작성합니다.
abstract  SOAPElement createElement (String  localName, String  prefix, String  uri)
          지정한 로컬명, 접두사 및 URI 로 새로운 SOAPElement 객체를 작성합니다.
abstract  SOAPFault createFault ()
          새로운 디폴트의 SOAPFault 객체를 작성합니다.
abstract  SOAPFault createFault (String  reasonText, QName  faultCode)
          지정한 reasonText 및 faultCode 를 사용해 초기화된, 새로운 SOAPFault 객체를 작성합니다.
abstract  Name createName (String  localName)
          지정된 로컬명을 사용해 초기화된 새로운 Name 객체를 작성합니다.
abstract  Name createName (String  localName, String  prefix, String  uri)
          지정한 로컬명, 이름 공간 접두사 및 이름 공간 URI 를 사용해 초기화된 새로운 Name 객체를 작성합니다.
static SOAPFactory newInstance ()
          디폴트의 구현 (SOAP 1.1)의 인스턴스인, 새로운 SOAPFactory 를 작성합니다.
static SOAPFactory newInstance (String  protocol)
          지정한 구현의 인스턴스인 새로운 SOAPFactory 객체를 작성해, 이 메소드는 SAAJMetaFactory 를 사용해 구현 클래스의 장소를 특정해 SOAPFactory 인스턴스를 작성합니다.
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait
 

생성자 의 상세

SOAPFactory

public SOAPFactory()
메소드의 상세

createElement

public SOAPElement  createElement(Element  domElement)
                          throws SOAPException
SOAPElement 객체를 기존의 Element 로부터 작성합니다. 인수로서 건네받은 DOM Element 가 이미 SOAPElement 인 경우, 이 메소드는 변경을 더하지 않고 돌려줄 필요가 있습니다. 그렇지 않은 경우, 새로운 SOAPElement 가 작성되어 딥 카피가 domElement 인수로 작성됩니다. 반환되는 값의 구상형은,domElement 인수의 이름에 의존합니다. domElement 를 루트로 하는 트리의 일부에서도 SOAP 규칙에 위반하면(자),SOAPException 가 throw 됩니다.

파라미터:
domElement - - 카피되는 Element
반환값:
domElement 의 카피인 새로운 SOAPElement
예외:
SOAPException - SOAPElement 객체의 작성으로 에러가 발생했을 경우
도입된 버젼:
SAAJ 1.3

createElement

public abstract SOAPElement  createElement(Name  name)
                                   throws SOAPException
지정된 Name 객체를 사용해 초기화된 SOAPElement 객체를 작성합니다. 반환되는 값의 구상형은, 새로운 SOAPElement 에게 줄 수 있었던 이름에 의존합니다. 예를 들어,"{http://www.w3.org/2003/05/soap-envelope}Envelope" 라는 이름의 새로운 SOAPElement 은, SOAP 1.2 동작을 지원하는 SOAPEnvelope 가 작성됩니다.

파라미터:
name - 신규 요소의 XML 명이 붙었다 Name 객체
반환값:
작성된 새롭다 SOAPElement 객체
예외:
SOAPException - SOAPElement 객체의 작성으로 에러가 발생했을 경우
관련 항목:
createElement(javax.xml.namespace.QName)

createElement

public SOAPElement  createElement(QName  qname)
                          throws SOAPException
지정된 QName 객체를 사용해 초기화된 SOAPElement 객체를 작성합니다. 반환되는 값의 구상형은, 새로운 SOAPElement 에게 줄 수 있었던 이름에 의존합니다. 예를 들어,"{http://www.w3.org/2003/05/soap-envelope}Envelope" 라는 이름의 새로운 SOAPElement 은, SOAP 1.2 동작을 지원하는 SOAPEnvelope 가 작성됩니다.

파라미터:
qname - 신규 요소의 XML 명이 붙었다 QName 객체
반환값:
작성된 새롭다 SOAPElement 객체
예외:
SOAPException - SOAPElement 객체의 작성으로 에러가 발생했을 경우
도입된 버젼:
SAAJ 1.3
관련 항목:
createElement(Name)

createElement

public abstract SOAPElement  createElement(String  localName)
                                   throws SOAPException
지정된 로컬명을 사용해 초기화된 SOAPElement 객체를 작성합니다.

파라미터:
localName - 신규 요소의 로컬명을 지정했다 String
반환값:
작성된 새롭다 SOAPElement 객체
예외:
SOAPException - SOAPElement 객체의 작성으로 에러가 발생했을 경우

createElement

public abstract SOAPElement  createElement(String  localName,
                                          String  prefix,
                                          String  uri)
                                   throws SOAPException
지정한 로컬명, 접두사 및 URI 로 새로운 SOAPElement 객체를 작성합니다. 반환되는 값의 구상형은, 새로운 SOAPElement 에게 줄 수 있었던 이름에 의존합니다. 예를 들어,"{http://www.w3.org/2003/05/soap-envelope}Envelope" 라는 이름의 새로운 SOAPElement 은, SOAP 1.2 동작을 지원하는 SOAPEnvelope 가 작성됩니다.

파라미터:
localName - 신규 요소의 로컬명을 지정했다 String
prefix - 이 SOAPElement 용의 접두사
uri - 새로운 요소가 속하는 이름 공간의 URI 를 지정하는 String
예외:
SOAPException - SOAPElement 객체의 작성으로 에러가 발생했을 경우

createDetail

public abstract Detail  createDetail()
                             throws SOAPException
DetailEntry 객체의 컨테이너로서 기능하는 Detail 객체를 작성합니다.  

이 팩토리 메소드는,SOAPFault 추상화 객체를 사용하는 것이 실제적이지 않은 상황으로 사용하기 위해서,Detail 객체를 작성합니다.

반환값:
Detail 객체
예외:
SOAPException - SOAP 에러가 존재하는 경우
UnsupportedOperationException - SOAPFactory 용으로 지정된 프로토콜이 DYNAMIC_SOAP_PROTOCOL 였을 경우

createFault

public abstract SOAPFault  createFault(String  reasonText,
                                      QName  faultCode)
                               throws SOAPException
지정한 reasonText 및 faultCode 를 사용해 초기화된, 새로운 SOAPFault 객체를 작성합니다.

파라미터:
reasonText - fault용의 ReasonText/FaultString
faultCode - fault용의 FaultCode
반환값:
SOAPFault 객체
예외:
SOAPException - SOAP 에러가 존재하는 경우
도입된 버젼:
SAAJ 1.3

createFault

public abstract SOAPFault  createFault()
                               throws SOAPException
새로운 디폴트의 SOAPFault 객체를 작성합니다.

반환값:
SOAPFault 객체
예외:
SOAPException - SOAP 에러가 존재하는 경우
도입된 버젼:
SAAJ 1.3

createName

public abstract Name  createName(String  localName,
                                String  prefix,
                                String  uri)
                         throws SOAPException
지정한 로컬명, 이름 공간 접두사 및 이름 공간 URI 를 사용해 초기화된 새로운 Name 객체를 작성합니다.  

이 팩토리 메소드는,SOAPEnvelope 추상화 객체를 사용하는 것이 실제적이지 않은 상황으로 사용하기 위해서,Name 객체를 작성합니다.

파라미터:
localName - 로컬명을 지정한 String
prefix - 이름 공간의 접두사를 지정하는 String
uri - 이름 공간의 URI 를 지정하는 String
반환값:
지정한 로컬명, 이름 공간 접두사 및 이름 공간 URI 를 사용해 초기화되었다 Name 객체
예외:
SOAPException - SOAP 에러가 존재하는 경우

createName

public abstract Name  createName(String  localName)
                         throws SOAPException
지정된 로컬명을 사용해 초기화된 새로운 Name 객체를 작성합니다.  

이 팩토리 메소드는,SOAPEnvelope 추상화 객체를 사용하는 것이 실제적이지 않은 상황으로 사용하기 위해서,Name 객체를 작성합니다.

파라미터:
localName - 로컬명을 지정한 String
반환값:
지정한 로컬명을 사용해 초기화되었다 Name 객체
예외:
SOAPException - SOAP 에러가 존재하는 경우

newInstance

public static SOAPFactory  newInstance()
                               throws SOAPException
디폴트의 구현 (SOAP 1.1)의 인스턴스인, 새로운 SOAPFactory 를 작성합니다. 이 메소드는 다음의 순서의 검색 순서로, 로드하는 SOAPFactory 구현 클래스를 결정합니다.

반환값:
SOAPFactory 의 새로운 인스턴스
예외:
SOAPException - 디폴트의 SOAPFactory 의 작성중에 에러가 발생했을 경우
관련 항목:
SAAJMetaFactory

newInstance

public static SOAPFactory  newInstance(String  protocol)
                               throws SOAPException
지정한 구현의 인스턴스인 새로운 SOAPFactory 객체를 작성해, 이 메소드는 SAAJMetaFactory 를 사용해 구현 클래스의 장소를 특정해 SOAPFactory 인스턴스를 작성합니다.

파라미터:
protocol - 지정한 SOAP 팩토리 구현의 프로토콜을 표현한다 캐릭터 라인 정수. 이것은, DYNAMIC_SOAP_PROTOCOL, DEFAULT_SOAP_PROTOCOL (와 같은) SOAP_1_1_PROTOCOL, 또는 SOAP_1_2_PROTOCOL
반환값:
SOAPFactory 의 새로운 인스턴스
예외:
SOAPException - 지정한 SOAPFactory 의 작성중에 에러가 발생했을 경우
도입된 버젼:
SAAJ 1.3
관련 항목:
SAAJMetaFactory
개요   패키지    클래스  사용   계층 트리   비추천 API   색인   헬프  
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 도 참조해 주세요.