4 * License : The MIT License
5 * Copyright(c) 2010 MikuToga Partners
8 package jp.sourceforge.mikutoga.xml;
10 import java.util.Iterator;
11 import java.util.LinkedList;
12 import java.util.List;
13 import java.util.NoSuchElementException;
14 import javax.xml.bind.DatatypeConverter;
15 import org.w3c.dom.Element;
16 import org.w3c.dom.Node;
21 public final class DomUtils {
29 throw new AssertionError();
33 * 要素からxsd:string型属性値を読み取る。
37 * @throws TogaXmlException 属性値が見つからなかった。
39 public static String getStringAttr(Element elem, String attrName)
40 throws TogaXmlException{
41 if( ! elem.hasAttribute(attrName) ){
42 String message = "Attr:[" + attrName + "] "
44 + "Elem:[" + elem.getTagName()+"]";
45 throw new TogaXmlException(message);
50 result = elem.getAttribute(attrName);
51 }catch(IllegalArgumentException e){
52 String message = "Invalid attribute form [" + attrName + "]";
53 throw new TogaXmlException(message, e);
60 * 要素からxsd:boolean型属性値を読み取る。
64 * @throws TogaXmlException 属性値が見つからなかった。
66 public static boolean getBooleanAttr(Element elem, String attrName)
67 throws TogaXmlException{
68 String value = getStringAttr(elem, attrName);
72 result = DatatypeConverter.parseBoolean(value);
73 }catch(IllegalArgumentException e){
75 "Invalid boolean attribute form "
76 + "[" + attrName + "][" + value + "]";
77 throw new TogaXmlException(message, e);
84 * 要素からxsd:integer型属性値を読み取る。
88 * @throws TogaXmlException 属性値が見つからなかった。
90 public static int getIntegerAttr(Element elem, String attrName)
91 throws TogaXmlException{
92 String value = getStringAttr(elem, attrName);
96 result = DatatypeConverter.parseInt(value);
97 }catch(IllegalArgumentException e){
99 "Invalid integer attribute form "
100 + "[" + attrName + "][" + value + "]";
101 throw new TogaXmlException(message, e);
108 * 要素からxsd:float型属性値を読み取る。
110 * @param attrName 属性名
112 * @throws TogaXmlException 属性値が見つからなかった。
114 public static float getFloatAttr(Element elem, String attrName)
115 throws TogaXmlException{
116 String value = getStringAttr(elem, attrName);
120 result = DatatypeConverter.parseFloat(value);
121 }catch(IllegalArgumentException e){
123 "Invalid float attribute form "
124 + "[" + attrName + "][" + value + "]";
125 throw new TogaXmlException(message, e);
132 * 要素から日本語Windows用ファイル名を属性値として読み取る。
133 * 念のため文字U+00A5は文字U-005Cに変換される。
135 * @param attrName 属性名
137 * @throws TogaXmlException 属性値が見つからなかった。
139 public static String getSjisFileNameAttr(Element elem, String attrName)
140 throws TogaXmlException{
143 result = getStringAttr(elem, attrName);
144 }catch(IllegalArgumentException e){
146 "Invalid winfile attribute form "
147 + "[" + attrName + "]";
148 throw new TogaXmlException(message, e);
151 result.replace("" + '\u00a5', "" + '\u005c\u005c');
157 * 指定された名前の子要素を1つだけ返す。
159 * @param tagName 子要素名
161 * @throws TogaXmlException 1つも見つからなかった
163 public static Element getChild(Element parent, String tagName)
164 throws TogaXmlException{
165 Element result = null;
167 for(Node node = parent.getFirstChild();
169 node = node.getNextSibling() ){
171 if(node.getNodeType() != Node.ELEMENT_NODE) continue;
172 Element elem = (Element) node;
174 String elemTagName = elem.getTagName();
175 if( tagName.equals(elemTagName) ){
183 "Elem:[" + tagName + "] was not found in "
184 +"Elem:[" + parent.getTagName() + "]";
185 throw new TogaXmlException(message);
192 * 親要素が指定された名前の子要素を持つか判定する。
194 * @param tagName 子要素名
195 * @return 指定名の子要素が存在すればtrue
197 public static boolean hasChild(Element parent, String tagName){
198 for(Node node = parent.getFirstChild();
200 node = node.getNextSibling() ){
202 if(node.getNodeType() != Node.ELEMENT_NODE) continue;
203 Element elem = (Element) node;
205 String elemTagName = elem.getTagName();
206 if( tagName.equals(elemTagName) ) return true;
213 * 指定された名前の子要素のリストを返す。
215 * @param childTag 子要素名
218 public static List<Element> getChildList(Element parent,
220 List<Element> result = new LinkedList<Element>();
222 for(Node node = parent.getFirstChild();
224 node = node.getNextSibling() ){
226 if(node.getNodeType() != Node.ELEMENT_NODE) continue;
227 Element elem = (Element) node;
229 String tagName = elem.getTagName();
230 if( ! childTag.equals(tagName) ) continue;
239 * 指定された名前の子要素の列挙子を返す。
241 * @param childTag 子要素名
244 public static Iterator<Element> getChildIterator(Element parent,
248 firstElem = getChild(parent, childTag);
249 }catch(TogaXmlException e){
253 Iterator<Element> result = new ElemIterator(firstElem);
259 * 指定された名前の子要素のforeachを返す。
261 * @param childTag 子要素名
262 * @return 子要素のforeach
264 public static Iterable<Element> getEachChild(Element parent,
266 final Iterator<Element> iterator = getChildIterator(parent, childTag);
267 Iterable<Element> result = new Iterable<Element>(){
269 public Iterator<Element> iterator(){
279 * @return 次の要素。なければnull
281 public static Element nextElement(Element elem){
282 Node nextNode = elem;
284 nextNode = nextNode.getNextSibling();
285 if(nextNode == null) break;
286 if(nextNode.getNodeType() == Node.ELEMENT_NODE){
291 return (Element) nextNode;
297 * @return 次の要素。なければnull
299 public static Element nextNamedElement(Element elem){
300 String tagName = elem.getTagName();
301 Element nextElem = elem;
303 nextElem = nextElement(nextElem);
304 if(nextElem == null) break;
305 if(tagName.equals(nextElem.getTagName())) break;
312 * 同じ親要素と同じ要素名を持つ兄弟要素を列挙する列挙子。
314 private static class ElemIterator implements Iterator<Element>{
315 private Element next;
319 * @param elem 最初の要素。nullを指定すれば空列挙子となる。
321 private ElemIterator(Element elem){
328 * @return {@inheritDoc}
331 public boolean hasNext(){
332 if(this.next == null) return false;
338 * @return {@inheritDoc}
339 * @throws NoSuchElementException {@inheritDoc}
342 public Element next() throws NoSuchElementException{
343 if(this.next == null) throw new NoSuchElementException();
344 Element result = this.next;
345 this.next = nextNamedElement(this.next);
354 public void remove(){
355 throw new UnsupportedOperationException();