Aspose.Words for Java에서 문서 속성 사용하기

문서 속성 소개

문서 속성은 모든 문서에서 중요한 부분입니다. 제목, 작성자, 주제, 키워드 등과 같은 문서 자체에 대한 추가 정보를 제공합니다. Aspose.Words for Java에서는 내장 문서 속성과 사용자 정의 문서 속성을 모두 조작할 수 있습니다.

문서 속성 열거

내장 속성

내장된 문서 속성을 검색하고 작업하려면 다음 코드 조각을 사용할 수 있습니다.

@Test
public void enumerateProperties() throws Exception
{
    Document doc = new Document("Your Directory Path" + "Properties.docx");
    System.out.println(MessageFormat.format("1. Document name: {0}", doc.getOriginalFileName()));
    System.out.println("2. Built-in Properties");
    for (DocumentProperty prop : doc.getBuiltInDocumentProperties())
        System.out.println(MessageFormat.format("{0} : {1}", prop.getName(), prop.getValue()));
}

이 코드는 “제목”, “작성자” 및 “키워드"와 같은 속성을 포함하여 문서 이름과 기본 제공 속성을 표시합니다.

사용자 정의 속성

사용자 정의 문서 속성으로 작업하려면 다음 코드 조각을 사용할 수 있습니다.

@Test
public void addCustomDocumentProperties() throws Exception
{
    Document doc = new Document("Your Directory Path" + "Properties.docx");
    CustomDocumentProperties customDocumentProperties = doc.getCustomDocumentProperties();

    if (customDocumentProperties.get("Authorized") != null) return;

    customDocumentProperties.add("Authorized", true);
    customDocumentProperties.add("Authorized By", "John Smith");
    customDocumentProperties.add("Authorized Date", new Date());
    customDocumentProperties.add("Authorized Revision", doc.getBuiltInDocumentProperties().getRevisionNumber());
    customDocumentProperties.add("Authorized Amount", 123.45);
}

이 코드 조각은 부울 값, 문자열, 날짜, 개정 번호 및 숫자 값을 포함한 사용자 정의 문서 속성을 추가하는 방법을 보여줍니다.

문서 속성 제거

특정 문서 속성을 제거하려면 다음 코드를 사용할 수 있습니다.

@Test
public void removeCustomDocumentProperties() throws Exception
{
    Document doc = new Document("Your Directory Path" + "Properties.docx");
    doc.getCustomDocumentProperties().remove("Authorized Date");
}

이 코드는 문서에서 사용자 정의 속성 “승인된 날짜"를 제거합니다.

콘텐츠에 대한 링크 구성

어떤 경우에는 문서 내에 링크를 만들고 싶을 수도 있습니다. 방법은 다음과 같습니다.

@Test
public void configuringLinkToContent() throws Exception
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);
    builder.startBookmark("MyBookmark");
    builder.writeln("Text inside a bookmark.");
    builder.endBookmark("MyBookmark");

    CustomDocumentProperties customProperties = doc.getCustomDocumentProperties();

    // 콘텐츠 속성에 링크를 추가합니다.
    DocumentProperty customProperty = customProperties.addLinkToContent("Bookmark", "MyBookmark");
    customProperty = customProperties.get("Bookmark");
    boolean isLinkedToContent = customProperty.isLinkToContent();
    String linkSource = customProperty.getLinkSource();
    String customPropertyValue = customProperty.getValue().toString();
}

이 코드 조각은 문서에 책갈피를 만들고 해당 책갈피에 연결되는 사용자 정의 문서 속성을 추가하는 방법을 보여줍니다.

측정 단위 간 변환

Aspose.Words for Java에서는 측정 단위를 쉽게 변환할 수 있습니다. 이를 수행하는 방법의 예는 다음과 같습니다.

@Test
public void convertBetweenMeasurementUnits() throws Exception
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);
    PageSetup pageSetup = builder.getPageSetup();

    // 여백을 인치 단위로 설정합니다.
    pageSetup.setTopMargin(ConvertUtil.inchToPoint(1.0));
    pageSetup.setBottomMargin(ConvertUtil.inchToPoint(1.0));
    pageSetup.setLeftMargin(ConvertUtil.inchToPoint(1.5));
    pageSetup.setRightMargin(ConvertUtil.inchToPoint(1.5));
    pageSetup.setHeaderDistance(ConvertUtil.inchToPoint(0.2));
    pageSetup.setFooterDistance(ConvertUtil.inchToPoint(0.2));
}

이 코드 조각은 다양한 여백과 거리를 포인트로 변환하여 인치 단위로 설정합니다.

제어 문자 사용

제어 문자는 텍스트를 다룰 때 유용할 수 있습니다. 텍스트에서 제어 문자를 바꾸는 방법은 다음과 같습니다.

@Test
public void useControlCharacters()
{
    final String TEXT = "test\r";

    // "\r" 제어 문자를 "\r\n"으로 바꾸십시오.
    String replace = TEXT.replace(ControlChar.CR, ControlChar.CR_LF);
}

이 예에서는 캐리지 리턴(\r) 캐리지 리턴과 줄 바꿈(\r\n).

결론

문서 속성은 Aspose.Words for Java에서 문서를 효과적으로 관리하고 구성하는 데 중요한 역할을 합니다. 기본 제공 속성, 사용자 정의 속성 또는 제어 문자를 사용하여 작업하는 경우 문서 관리 기능을 향상시키는 데 사용할 수 있는 다양한 도구가 있습니다.

FAQ

기본 제공 문서 속성에 어떻게 액세스합니까?

Aspose.Words for Java에 내장된 문서 속성에 액세스하려면 다음을 사용할 수 있습니다.getBuiltInDocumentProperties 에 대한 방법Document 물체. 이 메서드는 반복할 수 있는 기본 제공 속성 컬렉션을 반환합니다.

문서에 사용자 정의 문서 속성을 추가할 수 있나요?

예, 다음을 사용하여 문서에 사용자 정의 문서 속성을 추가할 수 있습니다.CustomDocumentProperties 수집. 문자열, 부울, 날짜 및 숫자 값을 포함한 다양한 데이터 유형으로 사용자 정의 속성을 정의할 수 있습니다.

특정 사용자 정의 문서 속성을 제거하려면 어떻게 해야 합니까?

특정 사용자 정의 문서 속성을 제거하려면remove 에 대한 방법CustomDocumentProperties컬렉션, 제거하려는 속성의 이름을 매개 변수로 전달합니다.

문서 내의 콘텐츠에 연결하는 목적은 무엇입니까?

문서 내의 콘텐츠에 연결하면 문서의 특정 부분에 대한 동적 참조를 만들 수 있습니다. 이는 대화형 문서를 생성하거나 섹션 간 상호 참조를 만드는 데 유용할 수 있습니다.

Aspose.Words for Java에서 다양한 측정 단위 간에 어떻게 변환할 수 있나요?

Aspose.Words for Java에서는 다음을 사용하여 다양한 측정 단위 간에 변환할 수 있습니다.ConvertUtil 수업. 인치와 같은 단위를 포인트로, 포인트를 센티미터로 변환하는 방법을 제공합니다.