XML Element
노드의 표현입니다.
// Adds up the values listed in a sample XML document and adds a new element with the total. var xml = '<things>' + '<plates>12</plates>' + '<bowls>18</bowls>' + '<cups>25</cups>' + '</things>'; var document = XmlService.parse(xml); var root = document.getRootElement(); var items = root.getChildren(); var total = 0; for (var i = 0; i < items.length; i++) { total += Number(items[i].getText()); } var totalElement = XmlService.createElement('total').setText(total); root.addContent(totalElement); xml = XmlService.getPrettyFormat().format(document); Logger.log(xml);
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
addContent(content) | Element | 지정된 노드를 Element 노드의 마지막 하위 요소로 추가합니다. |
addContent(index, content) | Element | 지정된 노드의 Element 노드의 바로 하위 노드인 모든 노드 간에 지정된 노드를 삽입합니다. |
cloneContent() | Content[] | {@code 요소} 노드의 바로 하위 노드인 모든 노드의 연결되지 않은 사본을 만듭니다. |
detach() | Content | 상위 Element 노드에서 노드를 분리합니다. |
getAllContent() | Content[] | {@code Element} 노드의 바로 하위 노드인 모든 노드를 가져옵니다. |
getAttribute(name) | Attribute | 네임스페이스가 아닌 지정된 이름으로 이 Element 노드의 속성을 가져옵니다. |
getAttribute(name, namespace) | Attribute | 지정된 이름과 네임스페이스로 이 Element 노드의 속성을 가져옵니다. |
getAttributes() | Attribute[] | 이 Element 노드의 모든 속성을 문서에 표시되는 순서대로 가져옵니다. |
getChild(name) | Element | 지정된 이름의 첫 번째 Element 노드를 가져오고 이 Element 노드의 직계 하위인 네임스페이스를 가져오지 않습니다. |
getChild(name, namespace) | Element | 이 Element 노드의 직계 하위 요소인 지정된 이름과 네임스페이스를 가진 첫 번째 Element 노드를 가져옵니다. |
getChildText(name) | String | 노드가 Element 노드의 하위 노드인 경우 지정된 이름이 없는 노드의 텍스트 값을 가져옵니다. |
getChildText(name, namespace) | String | 노드가 Element 노드의 직계 하위 요소인 경우 지정된 이름과 네임스페이스가 있는 노드의 텍스트 값을 가져옵니다. |
getChildren() | Element[] | 이 Element 노드의 바로 하위 노드인 모든 Element 노드를 문서에 표시되는 순서대로 가져옵니다. |
getChildren(name) | Element[] | 지정된 이름의 모든 Element 노드를 가져오고 이 Element 노드의 바로 하위 요소인 네임스페이스를 문서에 표시되는 순서대로 가져옵니다. |
getChildren(name, namespace) | Element[] | 이 Element 노드의 직계 하위 요소인 지정된 이름과 네임스페이스를 가진 모든 Element 노드를 문서에 표시되는 순서대로 가져옵니다. |
getContent(index) | Content | {@code Element} 노드의 바로 하위 노드인 모든 노드 간에 지정된 색인의 노드를 가져옵니다. |
getContentSize() | Integer | {@code Element} 노드의 바로 하위 노드인 노드 수를 가져옵니다. |
getDescendants() | Content[] | {@code Element} 노드의 직접 또는 간접 하위 노드를 문서에 표시되는 순서대로 모두 가져옵니다. |
getDocument() | Document | {@code 요소} 노드가 포함된 XML 문서를 가져옵니다. |
getName() | String | Element 노드의 로컬 이름을 가져옵니다. |
getNamespace() | Namespace | Element 노드의 네임스페이스를 가져옵니다. |
getNamespace(prefix) | Namespace | Element 노드에 지정된 접두사가 있는 네임스페이스를 가져옵니다. |
getParentElement() | Element | 노드의 상위 Element 노드를 가져옵니다. |
getQualifiedName() | String | Element 노드의 로컬 이름 및 네임스페이스 프리픽스를 [namespacePrefix]:[localName] 형식으로 가져옵니다. |
getText() | String | Element 노드의 텍스트 값을 가져옵니다. |
getValue() | String | 노드의 직접 또는 간접 하위 요소인 모든 노드의 텍스트 값을 문서에 표시되는 순서대로 가져옵니다. |
isAncestorOf(other) | Boolean | 이 Element 노드가 지정된 Element 노드의 직접 또는 간접 상위 항목인지 확인합니다. |
isRootElement() | Boolean | Element 노드가 문서의 루트 노드인지 확인합니다. |
removeAttribute(attribute) | Boolean | 이 Element 노드에 해당 속성이 있으면 이 속성을 삭제합니다. |
removeAttribute(attributeName) | Boolean | 지정된 이름이 있고 이 네임스페이스가 있는 경우 네임스페이스가 없는 Element 노드의 속성을 삭제합니다. |
removeAttribute(attributeName, namespace) | Boolean | 지정된 이름과 네임스페이스가 있는 경우 이 Element 노드의 속성을 삭제합니다. |
removeContent() | Content[] | {@code Element} 노드의 바로 아래에 있는 하위 노드를 모두 제거합니다. |
removeContent(content) | Boolean | 노드가 {@code 요소} 노드의 직계 하위 노드인 경우 지정된 노드를 삭제합니다. |
removeContent(index) | Content | 지정된 색인에서 {@code Element} 노드의 바로 하위 노드인 모든 노드 간에 노드를 삭제합니다. |
setAttribute(attribute) | Element | 이 Element 노드에 지정된 속성을 설정합니다. |
setAttribute(name, value) | Element | 지정된 이름, 값, 네임스페이스 없이 이 Element 노드의 속성을 설정합니다. |
setAttribute(name, value, namespace) | Element | 지정된 이름, 값, 네임스페이스로 이 Element 노드의 속성을 설정합니다. |
setName(name) | Element | Element 노드의 로컬 이름을 설정합니다. |
setNamespace(namespace) | Element | Element 노드의 네임스페이스를 설정합니다. |
setText(text) | Element | Element 노드의 텍스트 값을 설정합니다. |
자세한 문서
addContent(content)
지정된 노드를 Element
노드의 마지막 하위 요소로 추가합니다. content
인수는 Element
객체이거나 ContentType
에 나열된 유형에 해당하는 노드 객체일 수 있습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
content | Content | 추가할 노드 |
Return
Element
— 체이닝용 Element
노드
addContent(index, content)
지정된 노드의 Element
노드의 바로 하위 노드인 모든 노드 간에 지정된 노드를 삽입합니다. content
인수는 Element
객체이거나 ContentType
에 나열된 유형에 해당하는 노드 객체일 수 있습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
index | Integer | Element 노드의 바로 하위 노드인 모든 노드 간에 노드를 삽입할 색인입니다. |
content | Content | 삽입할 노드 |
Return
Element
— 체이닝용 Element
노드
cloneContent()
{@code 요소} 노드의 바로 하위 노드인 모든 노드의 연결되지 않은 사본을 만듭니다.
Return
Content[]
— {@code Element} 노드의 즉시 하위 요소인 모든 노드의 연결되지 않은 사본 배열입니다.
getAllContent()
{@code Element} 노드의 바로 하위 노드인 모든 노드를 가져옵니다.
Return
Content[]
— {@code Element} 노드의 바로 하위 노드인 모든 노드의 배열입니다.
getAttribute(name)
네임스페이스가 아닌 지정된 이름으로 이 Element
노드의 속성을 가져옵니다. 이러한 속성이 없으면 이 메서드는 null
를 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 속성 이름 |
Return
Attribute
: 속성 또는 해당 이름을 사용하는 속성이 없고 네임스페이스도 없는 경우 null
입니다.
getAttribute(name, namespace)
getAttributes()
getChild(name)
지정된 이름의 첫 번째 Element
노드를 가져오고 이 Element
노드의 직계 하위인 네임스페이스를 가져오지 않습니다. 이러한 노드가 없으면 이 메서드는 null
를 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 하위 Element 노드의 이름 |
Return
Element
: Element
노드 또는 해당 이름을 사용하는 즉각적인 하위 Element
노드가 없고 네임스페이스가 없는 경우 null
입니다.
getChild(name, namespace)
getChildText(name)
노드가 Element
노드의 하위 노드인 경우 지정된 이름이 없는 노드의 텍스트 값을 가져옵니다. 이러한 노드가 없으면 이 메서드는 null
를 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 하위 노드의 이름 |
Return
String
: 하위 노드의 텍스트 값입니다. 이름이 지정된 네임스페이스가 즉시 있는 하위 노드가 없으면 null
입니다.
getChildText(name, namespace)
노드가 Element
노드의 직계 하위 요소인 경우 지정된 이름과 네임스페이스가 있는 노드의 텍스트 값을 가져옵니다. 이러한 노드가 없으면 이 메서드는 null
를 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 하위 노드의 이름 |
namespace | Namespace | 하위 노드의 네임스페이스입니다. |
Return
String
: 하위 노드의 텍스트 값입니다. 지정된 이름과 네임스페이스가 있는 즉시 하위 노드가 없으면 null
입니다.
getChildren()
이 Element
노드의 바로 하위 노드인 모든 Element
노드를 문서에 표시되는 순서대로 가져옵니다.
Return
Element[]
: 이 Element
노드의 바로 하위 요소인 모든 Element
노드의 배열입니다.
getChildren(name)
지정된 이름의 모든 Element
노드를 가져오고 이 Element
노드의 바로 하위 요소인 네임스페이스를 문서에 표시되는 순서대로 가져옵니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 하위 Element 노드의 이름 |
Return
Element[]
- 지정된 이름을 사용하고 이 Element
노드의 바로 하위 요소인 네임스페이스가 없는 모든 Element
노드의 배열입니다.
getChildren(name, namespace)
getContent(index)
{@code Element} 노드의 바로 하위 노드인 모든 노드 간에 지정된 색인의 노드를 가져옵니다. 지정된 색인에 노드가 없으면 이 메서드는 null
를 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
index | Integer | {@code 요소} 노드의 바로 하위 노드인 모든 노드의 노드 색인입니다. |
Return
Content
: 노드 또는 지정된 색인에 노드가 없는 경우 null
입니다.
getContentSize()
{@code Element} 노드의 바로 하위 노드인 노드 수를 가져옵니다.
Return
Integer
— {@code Element} 노드의 바로 하위 노드인 노드 수입니다.
getDescendants()
{@code Element} 노드의 직접 또는 간접 하위 노드를 문서에 표시되는 순서대로 모두 가져옵니다.
Return
Content[]
: {@code Element} 노드의 직접 또는 간접 하위 요소인 모든 노드의 배열입니다.
getDocument()
getName()
Element
노드의 로컬 이름을 가져옵니다. 노드에 네임스페이스 프리픽스가 있는 경우 getQualifiedName()
또는 getNamespace()
를 사용합니다.getPrefix()
: 프리픽스를 가져옵니다.
Return
String
— Element
노드의 로컬 이름
getNamespace()
getNamespace(prefix)
Element
노드에 지정된 접두사가 있는 네임스페이스를 가져옵니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
prefix | String | 네임스페이스 프리픽스 |
Return
Namespace
: Element
노드에 지정된 프리픽스가 있는 네임스페이스입니다.
getParentElement()
getQualifiedName()
Element
노드의 로컬 이름 및 네임스페이스 프리픽스를 [namespacePrefix]:[localName]
형식으로 가져옵니다. 노드에 네임스페이스 프리픽스가 없는 경우 getName()
를 사용합니다.
Return
String
: Element
노드의 로컬 이름 및 네임스페이스 프리픽스([namespacePrefix]:[localName]
형식)입니다.
getText()
Element
노드의 텍스트 값을 가져옵니다.
Return
String
: Element
노드의 텍스트 값입니다.
getValue()
노드의 직접 또는 간접 하위 요소인 모든 노드의 텍스트 값을 문서에 표시되는 순서대로 가져옵니다.
Return
String
: 노드의 직접 또는 간접 하위 노드인 모든 노드의 텍스트 값입니다.
isAncestorOf(other)
이 Element
노드가 지정된 Element
노드의 직접 또는 간접 상위 항목인지 확인합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
other | Element | 다른 Element 노드 |
Return
Boolean
— 이 Element
노드가 지정된 Element
노드의 직접 또는 간접 상위 항목인 경우 true
이고 그렇지 않은 경우 false
입니다.
isRootElement()
Element
노드가 문서의 루트 노드인지 확인합니다.
Return
Boolean
— Element
노드가 문서의 루트 노드인 경우 true
, 그렇지 않은 경우 false
입니다.
removeAttribute(attribute)
이 Element
노드에 해당 속성이 있으면 이 속성을 삭제합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
attribute | Attribute | 속성 |
Return
Boolean
: 속성이 존재하고 삭제된 경우 true
, 그렇지 않은 경우 false
removeAttribute(attributeName)
지정된 이름이 있고 이 네임스페이스가 있는 경우 네임스페이스가 없는 Element
노드의 속성을 삭제합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
attributeName | String | 속성 이름 |
Return
Boolean
: 속성이 존재하고 삭제된 경우 true
, 그렇지 않은 경우 false
removeAttribute(attributeName, namespace)
지정된 이름과 네임스페이스가 있는 경우 이 Element
노드의 속성을 삭제합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
attributeName | String | 속성 이름 |
namespace | Namespace | 속성의 네임스페이스입니다. |
Return
Boolean
: 속성이 존재하고 삭제된 경우 true
, 그렇지 않은 경우 false
removeContent()
{@code Element} 노드의 바로 아래에 있는 하위 노드를 모두 제거합니다.
Return
Content[]
— 삭제되기 전에 {@code Element} 노드의 바로 하위 노드인 모든 노드의 배열입니다.
removeContent(content)
노드가 {@code 요소} 노드의 직계 하위 노드인 경우 지정된 노드를 삭제합니다. content
인수는 Element
객체이거나 ContentType
에 나열된 유형에 해당하는 노드 객체일 수 있습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
content | Content | 삭제할 노드 |
Return
Boolean
— 노드가 직계 하위 요소이고 삭제된 경우 true
, 삭제되지 않은 경우 false
입니다.
removeContent(index)
지정된 색인에서 {@code Element} 노드의 바로 하위 노드인 모든 노드 간에 노드를 삭제합니다. 지정된 색인에 노드가 없으면 이 메서드는 null
를 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
index | Integer | {@code 요소} 노드의 바로 하위 노드인 모든 노드의 노드 색인입니다. |
Return
Content
: 삭제된 노드 또는 지정된 색인에 노드가 없는 경우 null
입니다.
setAttribute(attribute)
setAttribute(name, value)
지정된 이름, 값, 네임스페이스 없이 이 Element
노드의 속성을 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 설정할 속성의 이름 |
value | String | 설정할 속성의 값 |
Return
Element
— 체이닝용 Element
노드
setAttribute(name, value, namespace)
setName(name)
Element
노드의 로컬 이름을 설정합니다. 노드의 네임스페이스 프리픽스를 설정하려면 setNamespace(namespace)
을 XmlService.getNamespace(prefix, uri)
과 함께 사용합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 설정할 로컬 이름 |
Return
Element
— 체이닝용 Element
노드
setNamespace(namespace)
setText(text)
Element
노드의 텍스트 값을 설정합니다. 노드에 텍스트 값이나 하위 노드가 이미 있는 경우 이 메서드는 이전 콘텐츠를 덮어씁니다. 콘텐츠를 추가하거나 삽입하려면 addContent(content)
또는 addContent(index, content)
를 사용하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | String | 설정할 텍스트 |
Return
Element
— 체이닝용 Element
노드