JavaTM Platform
Standard Ed. 6

javax.xml.soap
클래스 MimeHeaders

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


public class MimeHeaders
extends Object

MimeHeader 객체의 컨테이너로, 메세지의 MIME 부분에 있는 MIME 헤더를 나타냅니다.  

이 클래스는, 주로 MIME 헤더와 값에 근거해 어플리케이션에 특정의 첨부를 취득 시키려고 할 때 사용합니다. 또, 이 클래스는 AttachmentPart 나, SAAJ API 외 MIME 의존 부분의 구현에 많이 사용됩니다.

관련 항목:
SOAPMessage.getAttachments() , AttachmentPart

생성자 의 개요
MimeHeaders ()
          빈 상태(empty)의 Vector 객체에 의해 초기화되는 디폴트의 MimeHeaders 객체를 구축합니다.
 
메소드의 개요
 void addHeader (String  name, String  value)
          지정의 이름과 값의 MimeHeader 를, 이 MimeHeaders 객체의 헤더 리스트에 추가합니다.
 Iterator getAllHeaders ()
          이 MimeHeaders 객체의 모든 MimeHeader 를 돌려줍니다.
 String [] getHeader (String  name)
          지정의 헤더의 모든 값을 String 객체의 배열로서 돌려줍니다.
 Iterator getMatchingHeaders (String [] names)
          지정의 이름 배열에 있는 이름과 일치하는 MimeHeader 객체를 모두 돌려줍니다.
 Iterator getNonMatchingHeaders (String [] names)
          지정의 이름 배열에 있는 이름과 일치하지 않는 MimeHeader 객체를 모두 돌려줍니다.
 void removeAllHeaders ()
          이 MimeHeaders 객체로부터 모든 헤더 엔트리를 삭제합니다.
 void removeHeader (String  name)
          지정의 이름에 일치하는 MimeHeader 객체를 모두 삭제합니다.
 void setHeader (String  name, String  value)
          지정의 값에 대해, 지정의 이름이 일치하는 최초의 헤더 엔트리의 현재의 값을 옮겨놓습니다.
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait
 

생성자 의 상세

MimeHeaders

public MimeHeaders()
빈 상태(empty)의 Vector 객체에 의해 초기화되는 디폴트의 MimeHeaders 객체를 구축합니다.

메소드의 상세

getHeader

public String [] getHeader(String  name)
지정의 헤더의 모든 값을 String 객체의 배열로서 돌려줍니다.

파라미터:
name - 반환되는 값의 헤더명
반환값:
지정의 헤더의 모든 값을 가진다 String 배열
관련 항목:
setHeader(java.lang.String, java.lang.String)

setHeader

public void setHeader(String  name,
                      String  value)
지정의 값에 대해, 지정의 이름이 일치하는 최초의 헤더 엔트리의 현재의 값을 옮겨놓습니다. 기존의 헤더로 일치하는 것이 없는 경우, 새롭게 헤더를 추가합니다. 이 메소드는, 최초의 1 개의 뒤, 일치하는 헤더를 모두 삭제합니다.  

RFC822 헤더는 US-ASCII 문자만을 포함하는 것이 가능한 점에 주의해 주세요.

파라미터:
name - 검색하는 헤더명을 가진다 String
value - 지정의 헤더의 현재의 값과 옮겨놓는다 값을 가지는 String
예외:
IllegalArgumentException - 설정되어 있는 MIME 헤더명이나 그 값에 문제가 발생했을 경우
관련 항목:
getHeader(java.lang.String)

addHeader

public void addHeader(String  name,
                      String  value)
지정의 이름과 값의 MimeHeader 를, 이 MimeHeaders 객체의 헤더 리스트에 추가합니다.  

RFC822 헤더는 US-ASCII 문자만을 포함하는 것이 가능한 점에 주의해 주세요.

파라미터:
name - 추가하는 헤더명을 가진다 String
value - 추가하는 헤더치를 가진다 String
예외:
IllegalArgumentException - 추가되고 있는 MIME 헤더명이나 그 값에 문제가 발생했을 경우

removeHeader

public void removeHeader(String  name)
지정의 이름에 일치하는 MimeHeader 객체를 모두 삭제합니다.

파라미터:
name - 검색하는 헤더명을 가진다 String

removeAllHeaders

public void removeAllHeaders()
MimeHeaders 객체로부터 모든 헤더 엔트리를 삭제합니다.


getAllHeaders

public Iterator  getAllHeaders()
MimeHeaders 객체의 모든 MimeHeader 를 돌려줍니다.

반환값:
MimeHeaders 객체의 MimeHeader 객체 리스트에 있다 Iterator 객체

getMatchingHeaders

public Iterator  getMatchingHeaders(String [] names)
지정의 이름 배열에 있는 이름과 일치하는 MimeHeader 객체를 모두 돌려줍니다.

파라미터:
names - 검색하는 이름을 가지는 String 객체의 배열
반환값:
지정의 리스트의 이름의 어느쪽이든일치하는 MimeHeader 객체의 Iterator 객체

getNonMatchingHeaders

public Iterator  getNonMatchingHeaders(String [] names)
지정의 이름 배열에 있는 이름과 일치하지 않는 MimeHeader 객체를 모두 돌려줍니다.

파라미터:
names - 검색하는 이름을 가지는 String 객체의 배열
반환값:
지정의 리스트의 이름의 머지않아와도 일치하지 않는 MimeHeader 객체의 Iterator 객체

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 도 참조해 주세요.