Aspose.Words Document Object Model (DOM)
Aspose.Words Document Object Model(DOM)는 Word 문서의 메모리 내 표현입니다. Aspose.Words DOM을 사용하면 Word 문서의 내용과 서식을 프로그래밍 방식으로 읽고, 조작하고, 수정할 수 있습니다.
이 섹션에서는 Aspose.Words DOM의 주요 클래스와 그 관계를 설명합니다. Aspose.Words DOM 클래스를 사용하면 문서 요소 및 서식에 프로그래밍 방식으로 액세스할 수 있습니다.
Document 개체 트리 {#create-a-document-objects-tree} 만들기
문서를 Aspose.Words DOM로 읽어오면 객체 트리가 작성되고 소스 문서의 다양한 유형의 요소에는 다양한 속성을 가진 자체 DOM 트리 객체가 있습니다.
문서 노드 트리 구축
Aspose.Words는 Word 문서를 메모리로 읽을 때 다양한 문서 요소를 나타내는 다양한 유형의 개체를 만듭니다. 텍스트, 단락, 표 또는 섹션의 모든 실행은 노드이며 문서 자체도 노드입니다. Aspose.Words는 모든 문서 노드 유형에 대한 클래스를 정의합니다.
Aspose.Words의 문서 트리는 복합 디자인 패턴을 따릅니다
- 모든 노드 클래스는 궁극적으로 Aspose.Words Document Object Model의 기본 클래스인 Node 클래스에서 파생됩니다.
- 다른 노드를 포함할 수 있는 노드(예: Section 또는 Paragraph)는 CompositeNode 클래스에서 파생되고 이 클래스는 다시 Node 클래스에서 파생됩니다.
아래 제공된 다이어그램은 Aspose.Words Document Object Model(DOM)의 노드 클래스 간 상속을 보여줍니다. 추상 클래스의 이름은 이탤릭체로 표시됩니다.
예를 살펴보겠습니다. 다음 이미지는 다양한 유형의 콘텐츠가 포함된 Microsoft Word 문서를 보여줍니다.
위 문서를 Aspose.Words DOM로 읽어오면 아래 스키마와 같이 객체 트리가 생성됩니다.
다이어그램의 Document, Section, Paragraph, Table, Shape, Run 및 기타 모든 줄임표는 Word 문서의 요소를 나타내는 Aspose.Words 개체입니다.
Node 유형 {#get-a-node-type} 받기
Node 클래스는 다양한 노드를 서로 구별하기에 충분하지만 Aspose.Words는 특정 유형의 노드 선택과 같은 일부 API 작업을 단순화하기 위해 NodeType 열거형을 제공합니다.
각 노드의 유형은 Node.node_type 속성을 사용하여 얻을 수 있습니다. 이 속성은 NodeType 열거형 값을 반환합니다. 예를 들어 Paragraph 클래스로 표시되는 단락 노드는 NodeType.PARAGRAPH를 반환하고, Table 클래스로 표시되는 테이블 노드는 NodeType.TABLE를 반환합니다.
다음 예에서는 NodeType 열거형을 사용하여 노드 유형을 얻는 방법을 보여줍니다
문서 트리 탐색
Aspose.Words는 문서를 노드 트리로 표현하므로 노드 간을 탐색할 수 있습니다. 이 섹션에서는 Aspose.Words에서 문서 트리를 탐색하고 탐색하는 방법을 설명합니다.
앞서 제시된 샘플 문서를 문서 탐색기에서 열면 노드 트리가 Aspose.Words에 표시된 것과 똑같이 나타납니다.
문서 노드 관계
트리의 노드에는 다음과 같은 관계가 있습니다
- 다른 노드를 포함하는 노드는 *parent.*입니다
- 상위 노드에 포함된 노드는 *child.*입니다. 동일한 상위 노드의 하위 노드는 sibling 노드입니다.
- root 노드는 항상 Document 노드입니다.
다른 노드를 포함할 수 있는 노드는 CompositeNode 클래스에서 파생되며 모든 노드는 궁극적으로 Node 클래스에서 파생됩니다. 이러한 두 기본 클래스는 트리 구조 탐색 및 수정을 위한 공통 메서드와 속성을 제공합니다.
다음 UML 개체 다이어그램은 샘플 문서의 여러 노드와 부모, 자식 및 형제 속성을 통한 노드 간의 관계를 보여줍니다
문서가 노드 소유자임
스타일 및 목록과 같은 중요한 문서 전체 구조가 Document 노드에 저장되기 때문에 노드는 트리에서 방금 생성되었거나 제거된 경우에도 항상 특정 문서에 속합니다. 예를 들어, 각 단락에는 문서에 대해 전역적으로 정의된 할당된 스타일이 있으므로 Document 없이 Paragraph를 가질 수 없습니다. 이 규칙은 새 노드를 생성할 때 사용됩니다. 새 Paragraph를 DOM에 직접 추가하려면 생성자에 전달된 문서 개체가 필요합니다.
DocumentBuilder를 사용하여 새 단락을 생성할 때 빌더에는 항상 DocumentBuilder.document 속성을 통해 연결된 Document 클래스가 있습니다.
다음 코드 예제는 노드를 생성할 때 노드를 소유할 문서가 항상 정의된다는 것을 보여줍니다
상위 노드
각 노드에는 parent_node 속성으로 지정된 상위 노드가 있습니다. 다음과 같은 경우 노드에는 상위 노드가 없습니다. 즉, parent_node는 None입니다
- 노드가 방금 생성되었으며 아직 트리에 추가되지 않았습니다.
- 노드가 트리에서 제거되었습니다.
- 항상 None 상위 노드를 갖는 루트 Document 노드입니다.
Node.remove 메서드를 호출하여 상위 노드에서 노드를 제거할 수 있습니다. 다음 코드 예제에서는 상위 노드에 액세스하는 방법을 보여줍니다
하위 노드
CompositeNode의 하위 노드에 액세스하는 가장 효율적인 방법은 각각 첫 번째 하위 노드와 마지막 하위 노드를 반환하는 first_child 및 last_child 속성을 사용하는 것입니다. 하위 노드가 없으면 이러한 속성은 None를 반환합니다.
CompositeNode는 또한 하위 노드에 대한 색인화되거나 열거된 액세스를 가능하게 하는 get_child_nodes 컬렉션을 제공합니다. get_child_nodes 메서드는 노드의 라이브 컬렉션을 반환합니다. 즉, 노드가 제거되거나 추가되는 등 문서가 변경될 때마다 get_child_nodes 컬렉션이 자동으로 업데이트됩니다.
노드에 자식이 없으면 get_child_nodes 메서드는 빈 컬렉션을 반환합니다. has_child_nodes 속성을 사용하여 CompositeNode에 하위 노드가 포함되어 있는지 확인할 수 있습니다.
다음 코드 예제에서는 get_child_nodes 컬렉션에서 제공하는 열거자를 사용하여 CompositeNode의 직계 자식 노드를 열거하는 방법을 보여줍니다
형제 노드
각각 previous_sibling 및 next_sibling 속성을 사용하여 특정 노드 바로 앞이나 뒤에 있는 노드를 얻을 수 있습니다. 노드가 상위 노드의 마지막 하위 노드인 경우 next_sibling 속성은 None입니다. 반대로, 노드가 상위 노드의 첫 번째 하위 노드인 경우 previous_sibling 속성은 None입니다.
다음 코드 예제에서는 복합 노드의 모든 직접 및 간접 하위 노드를 효율적으로 방문하는 방법을 보여줍니다
하위 및 상위 노드 {#typed-access-to-child-and-parent-nodes}에 대한 형식화된 액세스
지금까지 기본 유형(Node 또는 CompositeNode) 중 하나를 반환하는 속성에 대해 논의했습니다. 그러나 때로는 Run이나 Paragraph와 같은 특정 노드 클래스로 값을 캐스팅해야 하는 상황이 있습니다. 즉, 복합적인 Aspose.Words DOM로 작업할 때 캐스팅에서 완전히 벗어날 수는 없습니다.
캐스팅의 필요성을 줄이기 위해 대부분의 Aspose.Words 클래스는 강력한 형식의 액세스를 제공하는 속성과 컬렉션을 제공합니다. 입력된 액세스에는 세 가지 기본 패턴이 있습니다
- 상위 노드는 형식화된 첫_XXX 및 마지막_XXX 속성을 노출합니다. 예를 들어 Document에는 first_section 및 last_section 속성이 있습니다. 마찬가지로 Table에는 first_row, last_row 등과 같은 속성이 있습니다.
- 상위 노드는 Document.sections, Body.paragraphs 등과 같은 형식화된 하위 노드 컬렉션을 노출합니다.
- 하위 노드는 Run.parent_paragraph, Paragraph.parent_section 등과 같은 상위 노드에 대한 형식화된 액세스를 제공합니다.
형식화된 속성은 Node.parent_node 및 CompositeNode.first_child에서 상속된 일반 속성보다 더 쉽게 액세스할 수 있는 유용한 바로 가기일 뿐입니다.
다음 코드 예제에서는 형식화된 속성을 사용하여 문서 트리의 노드에 액세스하는 방법을 보여줍니다