Jak używać IronPdfEngine

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPdfEngine to gRPC server zaprojektowany do zarządzania różnymi operacjami IronPDF, w tym do tworzenia, pisania, edytowania i odczytywania plików PDF.

Link do pobrania IronPDF for Java na ironpdf.com

IronPdf for Java i IronPdfEngine

IronPdf for Java wymaga IronPdfEngine do działania. Kod Java działa jako maska API nad IronPdfEngine gRPC. Gdy wywołujesz dowolną metodę w IronPdf for Java, rzeczywiste przetwarzanie odbywa się wewnątrz IronPdfEngine!

Domyślnie, IronPdf for Java uruchomi IronPdfEngine jako podproces i będzie z nim współpracować, aż Twoja aplikacja się zamknie.

Zwróć uwagęKażda wersja IronPdf for Java wymaga specyficznej wersji IronPdfEngine. Kompatybilność między wersjami nie jest obsługiwana.

IronPdf for Java z lokalnym IronPdfEngine

Opcja 1: Pobierz IronPdfEngine w trakcie działania Domyślnie, po zainstalowaniu IronPdf w projekcie Java, przy pierwszym uruchomieniu, IronPdf wykryje Twoją platformę (np. Windows x64) i pobierze odpowiednie binaria IronPdfEngine z Internetu.

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>20xx.xx.xx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>20xx.xx.xx</version>
</dependency>
XML

Zalety

  • Pakiet aplikacji będzie niewielki.
  • Można wdrażać na wielu platformach.

Wady

  • Dostęp do Internetu jest wymagany przy pierwszych uruchomieniach.
  • Wolny czas uruchamiania.

Opcja 2 (zalecana): Zainstaluj IronPdfEngine jako zależność IronPdf Java pozwala na dodanie IronPdfEngine bezpośrednio jako zależność. Te zależności pakują IronPdfEngine do pliku .zip, automatycznie go rozpakowując i używając.

Możesz wybrać instalację jednej lub więcej z tych zależności IronPdfEngine.

Zwróć uwagęironpdf i ironpdf-engine-xxx-xxx wersja zależności musi być taka sama. ironpdf-engine-xxx-xxx nie odnosi się do wewnętrznej wersji IronPdfEngine.

Dla Windows x64

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

Dla Windows x86

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x86</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x86</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

Dla Linux x64

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-linux-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-linux-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

Dla macOS x64

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

Dla macOS arm

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-arm64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-arm64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

Zwróć uwagęKażda zależność jest dość duża, więc instalowanie ich wszystkich nie jest zalecane.

Zalety

  • Szybszy czas uruchamiania.
  • Dostęp do Internetu nie jest potrzebny po zainstalowaniu zależności.

Wady

  • Pakiet aplikacji będzie duży.
  • Potrzeba określić docelowe platformy.

IronPdf for Java z zdalnym IronPdfEngine

Do użycia zdalnego IronPdfEngine potrzebna jest specyficzna wersja. Na przykład, jeśli IronPdf for Java w wersji 2024.2.2 wymaga IronPdfEngine w wersji 2024.2.2, nie używaj wersji 2024.2.1. Użyj metody getIronPdfEngineVersion, aby sprawdzić wymaganą wersję.

// Get the version of the IronPdfEngine needed for the current Java version
String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();
// Get the version of the IronPdfEngine needed for the current Java version
String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();
JAVA

Jak się połączyć

Zakłada się, że IronPdfEngine działa zdalnie na 123.456.7.8:33350.

Aby się połączyć, określ lokalizację IronPdfEngine (upewnij się, że adres jest dostępny i nie jest blokowany przez zapory sieciowe). Dodaj ten kod na początkowym etapie działania aplikacji (lub tuż przed wywołaniem dowolnej metody IronPDF).

// Set the host and port for a remote IronPdfEngine connection
com.ironsoftware.ironpdf.Settings.setIronPdfEngineHost("123.456.7.8");
com.ironsoftware.ironpdf.Settings.setIronPdfEnginePort(33350);
// Set the host and port for a remote IronPdfEngine connection
com.ironsoftware.ironpdf.Settings.setIronPdfEngineHost("123.456.7.8");
com.ironsoftware.ironpdf.Settings.setIronPdfEnginePort(33350);
JAVA

To takie proste! Po uruchomieniu tego kodu aplikacja łączy się ze zdalnym IronPdfEngine!

W przypadku zdalnego IronPdfEngine nie jest wymagana instalacja IronPdfEngine jako zależności.

Często Zadawane Pytania

Czym jest IronPdfEngine i jaki ma związek z operacjami PDF w Javie?

IronPdfEngine to serwer gRPC obsługujący operacje związane z plikami PDF, takie jak tworzenie, edycja i odczyt. W Javie funkcjonuje jako backend dla IronPDF, który służy jako maska API nad IronPdfEngine.

Jak mogę przekonwertować HTML na PDF w Javie przy użyciu IronPdfEngine?

Możesz użyć biblioteki IronPDF w Javie do renderowania HTML do plików PDF. Proces ten obejmuje skonfigurowanie IronPdfEngine i użycie jego metod, takich jak RenderHtmlAsPdf, do konwersji treści HTML do formatu PDF.

Dlaczego operacje PDF w Javie wymagają zgodności wersji z IronPdfEngine?

Kompatybilność wersji ma kluczowe znaczenie, ponieważ każda wersja IronPDF for Java jest zaprojektowana do współpracy z konkretną wersją IronPdfEngine, co zapewnia płynne działanie i zapobiega problemom z kompatybilnością.

Jakie są zalety lokalnego korzystania z IronPdfEngine w projektach Java?

Lokalne korzystanie z IronPdfEngine może skrócić czas uruchamiania i wyeliminować potrzebę dostępu do Internetu po instalacji. Pozwala to na bardziej wydajne przetwarzanie plików PDF bezpośrednio w aplikacji Java.

Jak skonfigurować IronPdfEngine do pracy na serwerze zdalnym w Javie?

Aby skonfigurować IronPdfEngine do użytku zdalnego, należy ustawić host i port serwera za pomocą metod setIronPdfEngineHost i setIronPdfEnginePort w aplikacji Java, upewniając się, że serwer jest dostępny.

Co należy wziąć pod uwagę, decydując się na pobranie plików binarnych IronPdfEngine w czasie wykonywania?

Pobieranie plików binarnych w czasie wykonywania skutkuje mniejszym rozmiarem pakietu aplikacji i elastycznością wdrażania na różnych platformach. Wymaga to jednak początkowego dostępu do Internetu i może skutkować dłuższym czasem uruchamiania.

Czy z IronPdfEngine można korzystać bez instalowania go jako zależności?

Tak, IronPdfEngine można używać bez instalacji jako zależności, pobierając niezbędne pliki binarne w czasie wykonywania. Takie podejście jest odpowiednie dla środowisk dynamicznych, w których rozmiar aplikacji ma znaczenie.

Jak upewnić się, że moja biblioteka Java PDF korzysta z właściwej wersji IronPdfEngine?

Możesz sprawdzić wersję IronPdfEngine wymaganą dla biblioteki PDF w Javie, korzystając z metody getIronPdfEngineVersion, co zapewni kompatybilność i prawidłowe działanie.

Jakie kroki należy wykonać, aby zainstalować IronPdfEngine w projekcie Java?

Aby zainstalować IronPdfEngine, należy dołączyć bibliotekę IronPDF Java do projektu, skonfigurować host i port serwera oraz połączyć się z IronPdfEngine, używając odpowiednich ustawień w kodzie aplikacji.

Czy podczas korzystania z IronPdfEngine w Javie konieczny jest dostęp do Internetu?

Dostęp do Internetu jest niezbędny w przypadku pobierania plików binarnych IronPdfEngine w czasie wykonywania. Jeśli jednak IronPdfEngine jest zainstalowany jako zależność, dostęp do Internetu nie jest wymagany po wstępnej konfiguracji.

Czy IronPDF jest kompatybilny z .NET 10 i jakie korzyści z tego wynikają?

Tak. IronPDF obsługuje .NET 10 bez konieczności stosowania obejść, zapewniając lepszą wydajność, większą stabilność działania oraz zgodność z nowymi funkcjami języka. Działa płynnie ze wszystkimi nowoczesnymi wersjami .NET, w tym .NET 8, 9 i 10.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Wersja: 2026.4 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu?
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.