groupdocs conversion java: Konwertuj DWG do PDF z wybranymi układami

Jeśli potrzebujesz przekonwertować rysunek DWG na PDF tylko dla wybranych układów, jesteś we właściwym miejscu. W tym samouczku przeprowadzimy Cię przez groupdocs conversion java, pokazując, jak skonfigurować Maven, filtrować układy i zoptymalizować wydajność przy dużych plikach CAD. Po zakończeniu będziesz mógł osadzić konwersję wybranych układów w dowolnej aplikacji Java przy użyciu kilku linii kodu.

Szybkie odpowiedzi

  • Jaka jest podstawowa biblioteka? GroupDocs.Conversion for Java
  • Jak dodać wsparcie Maven? Dołącz repozytorium GroupDocs i zależność (patrz poniżej)
  • Czy mogę konwertować tylko wybrane układy? Tak – użyj CadLoadOptions.setLayoutNames
  • Jaka wersja Java jest wymagana? JDK 8 lub nowsza
  • Czy potrzebna jest licencja? Wymagana jest licencja próbna lub zakupiona, aby uzyskać pełne funkcje

Co to jest groupdocs conversion java?

GroupDocs.Conversion for Java jest biblioteką wysokiej wydajności, która przekształca ponad 50+ formatów dokumentów i CAD — w tym DWG, DXF i DGN — do plików PDF, HTML i obrazów, zachowując warstwy, czcionki i geometrię. Dostarcza prostego API dla programistów, obsługuje środowiska Windows i Linux oraz oferuje opcje licencjonowania od wersji próbnej po przedsiębiorstwa.

Dlaczego używać konwersji wybranych układów?

Konwersja wybranych układów zmniejsza rozmiar wyjściowy nawet o 80 % dla plików DWG z wieloma układami, skraca czas przetwarzania o około 60 % i zapewnia, że interesariusze widzą tylko istotne rysunki. Jest to szczególnie cenne dla firm architektonicznych obsługujących 200‑stronicowe plany główne, gdzie do przeglądu klienta potrzebna jest tylko garść planów pięter.

Prerequisites

  • Java Development Kit (JDK): 8 +
  • Maven: do zarządzania zależnościami
  • IDE: IntelliJ IDEA, Eclipse lub dowolny edytor kompatybilny z Java
  • Podstawowa znajomość Java

Jak wykonać konwersję wybranych układów przy użyciu groupdocs conversion java?

Wczytaj źródłowy DWG, określ układy, które chcesz, i wywołaj konwerter – wszystko w czterech prostych krokach. Poniższe fragmenty kodu (placeholdery) ilustrują każdy etap; zastąp placeholdery rzeczywistym kodem Java z oficjalnej dokumentacji. To podejście zapewnia przetwarzanie tylko wymaganych układów, minimalizując zużycie pamięci i przyspieszając konwersję. Postępuj zgodnie z poniższymi krokami, wstawiając rzeczywiste ścieżki plików i nazwy układów w wskazanych miejscach.

Krok 1: Konfiguracja Maven (jak konwertować CAD przy użyciu Maven)

Dodaj repozytorium GroupDocs i zależność do pliku pom.xml:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/conversion/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-conversion</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Krok 2: Inicjalizacja licencji

Zainicjalizuj bibliotekę przy użyciu pliku licencji, aby odblokować wszystkie funkcje, w tym filtrowanie układów:

// Load the license to unlock full features
License license = new License();
license.setLicense("path/to/license.lic");

Krok 3: Określ ścieżki plików i nazwy układów

Zdefiniuj ścieżkę wejściowego DWG, ścieżkę wyjściowego PDF oraz dokładne nazwy układów, które chcesz skonwertować:

String sourceFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.dwg";
String convertedFile = "YOUR_OUTPUT_DIRECTORY/ConvertCadAndSpecifyLayouts.pdf";

// Specify desired layout names
CadLoadOptions loadOptions = new CadLoadOptions();
loadOptions.setLayoutNames(new String[] { "Layout1", "Layout3" });

Kotwica definicji: CadLoadOptions to klasa, która pozwala kontrolować sposób ładowania pliku CAD, w tym które układy mają być uwzględnione.

Krok 4: Utwórz instancję konwertera

Klasa Converter koordynuje proces konwersji. Otrzymuje plik źródłowy oraz opcje ładowania, które właśnie skonfigurowałeś:

Converter converter = new Converter(sourceFilePath, () -> loadOptions);

Kotwica definicji: Converter to rdzeniowy silnik GroupDocs.Conversion, który przyjmuje plik źródłowy i generuje wyjście w żądanym formacie.

Krok 5: Ustaw opcje konwersji PDF

Dostosuj DPI, rozmiar strony i osadzanie czcionek za pomocą PdfConvertOptions, aby dopasować ostateczny PDF do swoich potrzeb:

PdfConvertOptions convertOptions = new PdfConvertOptions();

Krok 6: Wykonaj konwersję

Uruchom konwersję. Powstały PDF będzie zawierał tylko układy, które określiłeś:

converter.convert(convertedFile, convertOptions);

Praktyczne zastosowania

  • Przeglądy projektów architektonicznych: Eksportuj tylko plany pięter będące przedmiotem dyskusji.
  • Analiza inżynieryjna: Konwertuj konkretne przekroje do testów wytrzymałościowych.
  • Archiwizacja dokumentów: Przechowuj zwięzłe PDFy dla zgodności regulacyjnej, oszczędzając do 70 % miejsca na dysku.

Rozważania dotyczące wydajności przy dużych plikach DWG

  • Zarządzanie pamięcią: Użyj opcji JVM, takich jak -Xmx4g, dla plików przekraczających 200 MB.
  • Przetwarzanie wsadowe: Grupuj pliki w partie po 10–20, aby utrzymać stabilne zużycie pamięci.
  • Konwersja strumieniowa: Skorzystaj z ConversionHandler (dostępny w nowszych wersjach), aby przetwarzać strony bez ładowania całego pliku do pamięci.

Częste problemy i rozwiązania

  • Brakujące układy: Nazwy układów są wrażliwe na wielkość liter; zweryfikuj je w przeglądarce CAD przed przekazaniem do setLayoutNames.
  • Błędy Out‑Of‑Memory: Zwiększ rozmiar sterty lub włącz konwersję strumieniową.
  • Błędy licencji: Upewnij się, że ścieżka do pliku licencji jest bezwzględna i pasuje do wersji biblioteki.

Najczęściej zadawane pytania

Q: Jakie są wymagania systemowe dla groupdocs conversion java?
A: JDK 8+, Maven oraz 64‑bitowy system operacyjny; biblioteka działa na Windows, Linux i macOS.

Q: Czy mogę konwertować bardzo duże pliki DWG (np. 500 MB)?
A: Tak – przydziel wystarczającą pamięć sterty (-Xmx8g) i użyj przetwarzania wsadowego lub strumieniowego, aby uniknąć błędów OOM.

Q: Czy groupdocs conversion java obsługuje inne formaty CAD?
A: Oczywiście; obsługuje DXF, DGN oraz ponad 30 dodatkowych formatów oprócz DWG.

Q: Dlaczego otrzymuję tylko pusty PDF?
A: Sprawdź, czy podane nazwy układów rzeczywiście istnieją w pliku źródłowym i czy plik nie jest uszkodzony.

Q: Jak mogę udostępnić tę konwersję w usłudze webowej?
A: Wdroż kod Java w aplikacji Spring Boot lub Jakarta EE i udostępnij endpoint REST, który przyjmuje przesłany plik DWG, wykonuje konwersję i zwraca strumień PDF.

Zasoby

Ostatnia aktualizacja: 2026-07-24
Testowano z: GroupDocs.Conversion 25.2 for Java
Autor: GroupDocs

Powiązane samouczki