36.3. 바인딩되지 않은 특성 사용
36.3.1. 개요
XML 스키마에는 복잡한 형식 정의에서 임의의 속성에 대한 자리 표시자를 남겨 둘 수 있는 메커니즘이 있습니다. 이 메커니즘을 사용하여 모든 특성이 있을 수 있는 복잡한 유형을 정의할 수 있습니다. 예를 들어 세 가지 속성을 지정하지 않고 <robot name="epsilon" />, <robot age="10000" /> 또는 <robot type="weevil" /> 요소를 정의하는 유형을 생성할 수 있습니다. 이는 데이터의 유연성이 필요할 때 특히 유용할 수 있습니다.
36.3.2. XML 스키마로 정의
선언되지 않은 특성은 anyAttribute 요소를 사용하여 XML 스키마에서 정의됩니다. 특성 요소를 사용할 수 있는 위치에서 사용할 수 있습니다.It can be used wherever an attribute element can be used. anyAttribute 요소에는 예 36.7. “Undeclared Attribute를 사용하는 복합 유형” 과 같이 속성이 없습니다.
예 36.7. Undeclared Attribute를 사용하는 복합 유형
<complexType name="arbitter">
<sequence>
<element name="name" type="xsd:string" />
<element name="rate" type="xsd:float" />
</sequence>
<anyAttribute />
</complexType>
정의된 유형인 arbitter 에는 두 개의 요소가 있으며 모든 유형의 하나의 특성을 가질 수 있습니다. 예 36.8. “와일드 카드 특성을 사용하여 정의된 요소의 예” 에 표시된 세 가지 요소는 모두 복잡한 유형 중재에서 생성될 수 있습니다.
예 36.8. 와일드 카드 특성을 사용하여 정의된 요소의 예
<officer rank="12"><name>...</name><rate>...</rate></officer> <lawyer type="divorce"><name>...</name><rate>...</rate></lawyer> <judge><name>...</name><rate>...</rate></judge>
36.3.3. Java로의 매핑
anyAttribute 요소를 포함하는 복잡한 형식이 Java에 매핑되면 코드 생성기는 otherAttributes 라는 멤버를 생성된 클래스에 추가합니다. otherAttributes 는 java.util.Map<QName, String > 유형이며 맵의 라이브 인스턴스를 반환하는 getter 메서드가 있습니다. getter에서 반환된 맵이 실시간이므로 맵에 대한 수정 사항이 자동으로 적용됩니다. 예 36.9. “Undeclared Attribute를 사용하여 Complex Type의 클래스” 예 36.7. “Undeclared Attribute를 사용하는 복합 유형” 에 정의된 복잡한 유형에 대해 생성된 클래스를 보여줍니다.
예 36.9. Undeclared Attribute를 사용하여 Complex Type의 클래스
public class Arbitter {
@XmlElement(required = true)
protected String name;
protected float rate;
@XmlAnyAttribute private Map<QName, String> otherAttributes = new HashMap<QName, String>();
public String getName() {
return name;
}
public void setName(String value) {
this.name = value;
}
public float getRate() {
return rate;
}
public void setRate(float value) {
this.rate = value;
}
public Map<QName, String> getOtherAttributes() { return otherAttributes; }
}36.3.4. 선언되지 않은 속성으로 작업
생성된 클래스의 otherAttributes 멤버는 Map 오브젝트로 채워집니다. 맵은 QNames 를 사용하여 키가 지정됩니다. 맵이 표시되면 오브젝트에 설정된 모든 속성에 액세스하고 오브젝트에 대한 새 특성을 설정할 수 있습니다.
예 36.10. “Undeclared Attributes로 작업” 선언되지 않은 특성을 사용하기 위한 샘플 코드를 보여줍니다.
예 36.10. Undeclared Attributes로 작업
Arbitter judge = new Arbitter();
Map<QName, String> otherAtts = judge.getOtherAttributes();
QName at1 = new QName("test.apache.org", "house");
QName at2 = new QName("test.apache.org", "veteran");
otherAtts.put(at1, "Cape");
otherAtts.put(at2, "false");
String vetStatus = otherAtts.get(at2);예 36.10. “Undeclared Attributes로 작업” 의 코드는 다음을 수행합니다.
선언되지 않은 속성이 포함된 맵을 가져옵니다.
특성을 사용할 QNames를 생성합니다.
속성 값을 맵으로 설정합니다.
특성 중 하나에 대한 값을 검색합니다.
