html을 pdf로 변환하여 저장하고싶습니다.

Question

안녕하세요.

제가 하고자하는 건

외부 프로그램에서 버튼클릭시 이벤트가 발생됩니다.

이 이벤트는 java + spring boot로 되어있는 API서버에 /pdf 주소로 post요청을 합니다. (ID값을 넘겨줌)

그럼 해당 API에서 ID값을 받아 서비스단 로직 동작후에 HTML(view단)에 값을 넘겨줍니다.

이렇게 넘겨준 HTML페이지를 pdf로 변환하고 싶습니다.

여러 레퍼런스를 찾아봤는데 css가 깨지고 기본적인 것들만 먹는다는 글도 있고 한데

해당 html 파일은 차트도 들어가고 테이블도 여러개가 들어가야하고 background는 또 사진으로 될거같습니다....

이런 작업 관련하여 도움좀 부탁드립니다.

감사합니다.

S_J · Answer

찾아보셔서 아시겠지만 라이브러리등으로 pdf출력하면 지원 안되는 css 프로퍼티가 많아서 레이아웃이 깨지는 경우가 있습니다.
헤드리스 브라우저를 사용해서 pdf 출력 하는걸 추천드립니다. (크롬에서 페이지를 pdf로 다운로드 하는것과 같은 원리)
헤드리스 크롬 등으로 검색 해 보세요.

한안아 · Answer

잘해주는 라이브러리 찾아 쓰던가. 못 찾으면. 화면을 캔버스로 이미지화해서 pdf 로 전환하면 됩니다.

Clickin · Answer

캔버스 그리시던가 아니면 아에 프린팅 솔루션 사다 쓰시는 게 편할 수 있습니다.

B급 감성으로 · Answer

예전에 iText 라는 라이브러리 사용해서 했던기억이 있네요.

그것도 단순히 테이블형태로 된것만 스크립트로 지정하고 그려서 출력했던것 같습니다.

더미 · Answer

안녕하세요. HTML 페이지를 PDF로 변환하는 작업은 꽤 까다로울 수 있습니다. 특히 차트, 테이블, 배경 이미지 등 복잡한 요소가 포함된 경우 CSS 스타일이 깨지거나 레이아웃이 틀어지는 문제가 발생할 수 있습니다.

HTML to PDF 변환 라이브러리 선택:

가장 먼저, 적절한 HTML to PDF 변환 라이브러리를 선택해야 합니다. 몇 가지 추천 라이브러리는 다음과 같습니다.

Openhtmltopdf/Flying Saucer: Java 기반 라이브러리로, CSS 2.1 사양을 비교적 잘 지원합니다. 특히 Flying Saucer는 렌더링 엔진으로 사용되어 복잡한 CSS도 잘 처리하는 편입니다.
WKHTMLTOPDF: 웹킷(WebKit) 엔진을 사용하여 HTML을 PDF로 변환합니다. 렌더링 품질이 우수하며, JavaScript 실행도 지원합니다.
Itext7: Java 기반 PDF 생성 라이브러리로, HTML 변환 기능을 제공합니다. 하지만 CSS 지원이 제한적일 수 있습니다.

CSS 및 레이아웃 문제 해결:

CSS 2.1 호환성: 가능한 한 CSS 2.1 사양을 준수하여 스타일을 작성합니다. CSS3 이상의 속성은 라이브러리에 따라 지원 여부가 다를 수 있습니다.
인라인 스타일 사용: 중요한 스타일은 인라인 스타일로 적용하여 변환 과정에서 스타일이 유실되지 않도록 합니다.
미디어 쿼리 활용: PDF 변환 시 화면 크기에 맞춰 레이아웃을 조정해야 하는 경우, 미디어 쿼리를 활용하여 스타일을 적용할 수 있습니다.
웹 폰트 적용: 웹 폰트를 사용하는 경우, 라이브러리에 따라 별도의 설정이 필요할 수 있습니다.

Spring Boot 연동:

Spring Boot 환경에서 HTML to PDF 변환을 위해서는 다음과 같은 단계를 따릅니다.

의존성 추가: 선택한 라이브러리의 의존성을 pom.xml (Maven) 또는 build.gradle (Gradle) 파일에 추가합니다.
HTML 생성: Thymeleaf 또는 다른 템플릿 엔진을 사용하여 동적으로 HTML을 생성합니다.
PDF 변환: 라이브러리 API를 사용하여 생성된 HTML을 PDF로 변환합니다.
PDF 다운로드: 변환된 PDF 파일을 클라이언트에게 전송합니다.

예시 (Openhtmltopdf/Flying Saucer 사용):

Java

@RestController
public class PdfController {

    @PostMapping("/pdf")
    public ResponseEntity generatePdf(@RequestBody Map data) throws IOException {
        // 1. Thymeleaf 템플릿 엔진을 사용하여 HTML 생성
        String htmlContent = templateEngine.process("pdf_template", new Context(Locale.getDefault(), data));

        // 2. Openhtmltopdf/Flying Saucer를 사용하여 PDF 변환
        ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
        PdfRendererBuilder builder = new PdfRendererBuilder();
        builder.withHtmlContent(htmlContent, "/"); // base url 설정
        builder.toStream(outputStream);
        builder.run();

        // 3. PDF 다운로드
        byte[] pdfBytes = outputStream.toByteArray();
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_PDF);
        headers.setContentDispositionFormData("attachment", "report.pdf");
        return new ResponseEntity<>(pdfBytes, headers, HttpStatus.OK);
    }
}

코드를 사용할 때는 주의가 필요합니다.

content_copy

추가 고려 사항:

이미지 최적화: 배경 이미지 등 큰 이미지는 용량을 줄여 PDF 파일 크기를 최적화해야 합니다.
복잡한 차트: 매우 복잡한 차트는 SVG 형태로 변환하여 PDF에 포함시키는 것이 좋습니다.
테스트 및 디버깅: 다양한 브라우저 및 환경에서 PDF 변환 결과를 테스트하고, 문제 발생 시 디버깅 도구를 활용하여 원인을 분석해야 합니다.

참고 자료:

Openhtmltopdf: https://github.com/danfickle/openhtmltopdf
Flying Saucer: https://github.com/flyingsaucerproject/flyingsaucer
WKHTMLTOPDF: https://wkhtmltopdf.org/
iText 7: https://itextpdf.com/

마무리:

HTML to PDF 변환은 쉬운 작업은 아니지만, 위에서 제시된 방법들을 참고하고 꾸준히 노력하면 원하는 결과를 얻을 수 있을 것입니다.

html을 pdf로 변환하여 저장하고싶습니다.

5개의 답변

Q&A 목록