|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
java.lang.Object | +--org.xml.sax.helpers.NamespaceSupport
SAX 드라이버로 사용할 수 있게, 이름 공간 논리를 캡슐화합니다.
이 모듈은 원시 코드, 문서 모두 공개 도메인에 놓여져 있습니다. 따라서, 내용에 관한프로텍션은 일절 제공되지 않습니다.
이 클래스는 이름 공간 처리의 논리를 캡슐화합니다. 이 클래스를 사용해, 각 문맥으로 현재 유효한 선언을 추적해, XML 1.0 수식명으로부터 자동적으로 이름 공간 부분을 생성할 수가 있습니다. 이름 공간을 생성원의 XML 1.0 수식명에 되돌릴 수도 있습니다.
이름 공간 서포트 오브젝트는 재이용 가능합니다만, 다음의 세션까지의 사이에 reset 메소드를 호출할 필요가 있습니다.
이하에, 단순한 세션의 예를 나타냅니다.
String parts[] = new String[3];
NamespaceSupport support = new NamespaceSupport();
support.pushContext();
support.declarePrefix("", "http://www.w3.org/1999/xhtml");
support.declarePrefix("dc", "http://www.purl.org/dc#");
String parts[] = support.processName("p", parts, false);
System.out.println("Namespace URI: " + parts[0]);
System.out.println("Local name: " + parts[1]);
System.out.println("Raw name: " + parts[2]);
String parts[] = support.processName("dc:title", parts, false);
System.out.println("Namespace URI: " + parts[0]);
System.out.println("Local name: " + parts[1]);
System.out.println("Raw name: " + parts[2]);
support.popContext();
이 클래스는 이름 공간 선언을 포함한 요소가 거의 없는 것을 상정해 최적화되고 있습니다. 따라서, 모든 문맥으로 동일한 전치수식자와 URI 의 매핑이 반복해지는 것 같은 경우는 효율이 낮아질 가능성이 있습니다.
| 필드의 개요 | |
static String |
XMLNS
정수로 XML 이름 공간을 나타냅니다. |
| 생성자의 개요 | |
NamespaceSupport ()
새로운 이름 공간 서포트 오브젝트를 작성합니다. |
|
| 메소드의 개요 | |
boolean |
declarePrefix (String prefix,
String uri)
이름 공간앞치수식자를 선언합니다. |
Enumeration |
getDeclaredPrefixes ()
이 문맥내에 선언 떠날 수 있어 모든 전치수식자의 열거를 돌려줍니다. |
String |
getPrefix (String uri)
이름 공간 URI 에 매핑 되고 있기 전치수식자를 1 개 돌려줍니다. |
Enumeration |
getPrefixes ()
현재 선언 떠날 수 있어 모든 전치수식자의 열거를 돌려줍니다. |
Enumeration |
getPrefixes (String uri)
URI 에 대해서 현재 선언 떠날 수 있어 모든 전치수식자의 열거를 돌려줍니다. |
String |
getURI (String prefix)
전치수식자를 검색해, 현재 매핑 되고 있는 이름 공간 URI 를 취득합니다. |
void |
popContext ()
이전의 이름 공간 문맥에 되돌립니다. |
String [] |
processName (String qName,
String [] parts,
boolean isAttribute)
raw XML 1.0 명을 처리합니다. |
void |
pushContext ()
새로운 이름 공간 문맥을 개시합니다. |
void |
reset ()
이 이름 공간 서포트 오브젝트를 재이용하기 위해(때문에), 리셋트 합니다. |
| 클래스 java.lang. Object 에서 상속받은 메소드 |
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait |
| 필드의 상세 |
public static final String XMLNS
이것은 전치수식자 "xml" 에 자동적으로 매핑 되는 이름 공간 URI 입니다.
| 생성자의 상세 |
public NamespaceSupport()
| 메소드의 상세 |
public void reset()
이름 공간 서포트 오브젝트를 새로운 세션으로 재이용하는 경우는 그 전에 이 메소드를 호출할 필요가 있습니다.
public void pushContext()
통상은 각 XML 요소의 처음에 새로운 문맥을 푸쉬 할 필요가 있습니다. 새로운 문맥은 친문맥의 선언을 자동적으로 계승하는 것과 동시에, 이 문맥내에서 작성된 선언을 계속해 추적합니다.
이름 공간 서포트 오브젝트는 벌써 유효하게 되어 있는 베이스 문맥으로 개시합니다. 이 문맥에 선언되고 있는 것은 "xml" 전치수식자 뿐입니다.
popContext() public void popContext()
통상은 각 XML 요소의 끝나에 문맥을 팝 합니다. 문맥을 팝 하면(자), 이전에 유효했던 모든 이름 공간앞치수식자 매핑이 복원됩니다.
문맥을 팝 한 뒤, 새롭게 이름 공간 전치사를 선언할 필요가 있는 경우는 그 전에 다른 문맥을 푸쉬 합니다.
pushContext()
public boolean declarePrefix(String prefix,
String uri)
이 메소드는 현재의 이름 공간 문맥내에 전치수식자를 선언합니다. 일전에치수식자는 하위 문맥으로 그림자화 되지 않는 한, 현재의 문맥이 팝 될 때까지 유효합니다.
디폴트의 이름 공간을 선언하려면 공문자열을 사용합니다. 전치수식자 "xml" 및 "xmlns" 는 사용할 수 없습니다.
다른 이름 공간을 푸쉬 해 팝 한 뒤, 전치수식자를 선언할 수 없습니다.
이 프로그램 라이브러리에는 비대칭성이 있습니다. 디폴트의 전치수식자 "" 를 선언해도,getPrefix 는 이것을 돌려주지 않습니다. 디폴트의 전치수식자를 확인할 필요가 있는 경우는 getURI 를 사용해 명시적으로 검색을 실시합니다. 이 비대칭성에 의해, 디폴트의 전치수식자를 사용할 수 없는 환경에서도, 속성명으로부터 전치수식자를 검색하기 쉬워지고 있습니다.
prefix - 선언하기 전치수식자. 공문자열의 경우는 nulluri - 전치수식자에 관련짓는 이름 공간 URI
processName(java.lang.String, java.lang.String[], boolean) ,
getURI(java.lang.String) ,
getPrefix(java.lang.String)
public String [] processName(String qName,
String [] parts,
boolean isAttribute)
이 메소드는 전치수식자를 삭제해, 현재 선언되고 있기 전치수식자중에서 이것을 검색하는 것으로써, 현재의 문맥에 포함되는 raw XML 1.0 명을 처리합니다. 반환값은 호출원이 지정한 배열입니다. 이하를 참조해 주세요.
배열내의 모든 캐릭터 라인이 내부화 됩니다. raw 명에 아직 선언되어 있지 않은 전치수식자가 포함되어 있는 경우, 반환값은 null 가 됩니다.
속성명의 처리 방법은 요소명의 처리 방법과는 다릅니다. 전치수식자를 가지지 않는 요소명이 디폴트의 이름 공간 (존재하는 경우)을 받는데 대해, 전치수식자를 가지지 않는 요소명은 이것을 받지 않습니다.
qName - 처리되는 raw XML 1.0 명parts - 호출원이 지정한 배열 (3 개 이상의 멤버를 저장할 수 있다)isAttribute - 속성명 (true)일까 요소명 (false)인지를 나타내는 플래그
declarePrefix(java.lang.String, java.lang.String) ,
String.intern() public String getURI(String prefix)
이 메소드는 현재의 문맥내에서 전치수식자를 검색합니다. 디폴트의 이름 공간을 검색하는 경우는 공문자열 ("")을 사용합니다.
prefix - 검색하기 전치수식자
getPrefix(java.lang.String) ,
getPrefixes() public Enumeration getPrefixes()
주: 디폴트의 전치수식자는 반환값의 열거에는 포함되지 않습니다. 디폴트의 전치수식자를 확인하고 싶은 경우는 인수 "" 를 지정해 getURI 를 사용해 주세요.
getDeclaredPrefixes() ,
getURI(java.lang.String) public String getPrefix(String uri)
같은 URI 에 복수의 전치수식자가 매핑 되고 있는 경우, 이 메소드는 그 중에서 무작위로 1 개를 돌려줍니다. 모든 전치수식자를 확인하고 싶은 경우는 이 메소드는 아니고 getPrefixes() 메소드를 사용해 주세요.
주: 이 메소드는 하늘 (디폴트)의 앞치수식자는 돌려주지 않습니다. 디폴트의 전치수식자를 확인하고 싶은 경우는 인수 "" 를 지정해 getURI 를 사용해 주세요.
uri - 이름 공간 URI
getPrefixes(java.lang.String) ,
getURI(java.lang.String) public Enumeration getPrefixes(String uri)
이 메소드는 특정의 이름 공간 URI 에 매핑 되고 있기 전치수식자를 돌려줍니다. 반환값에는 전치수식자 xml: 가 포함됩니다. 이름 공간 URI 에 매핑 되고 있기 전치수식자를 무작위로 1 개만 취득하고 싶은 경우는 이 메소드는 아니고 getPrefix 메소드를 사용합니다.
주: 공 (디폴트)의 전치수식자는 반환값의 열거에는 포함되지 않습니다. 디폴트의 전치수식자를 확인하고 싶은 경우는 인수 "" 를 지정해 getURI 를 사용해 주세요.
uri - 이름 공간 URI
getPrefix(java.lang.String) ,
getDeclaredPrefixes() ,
getURI(java.lang.String) public Enumeration getDeclaredPrefixes()
getPrefix(java.lang.String) 나 getPrefixes() 를 사용하는 경우와는 달라, 반환값의 열거에는 하늘 (디폴트)의 앞치수식자도 포함됩니다.
getPrefixes() ,
getURI(java.lang.String)
|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.