Documentation – Creați sau încărcați un Document în Java

Java: Specificați opțiunile de încărcare în Java

Mon, 01 Jan 0001 00:00:00 +0000

Când încărcați un document, puteți seta câteva proprietăți avansate. Aspose.Words vă oferă clasa LoadOptions, care permite un control mai precis al procesului de încărcare. Unele formate de încărcare au o clasă corespunzătoare care conține opțiuni de încărcare pentru acest format de încărcare, de exemplu, există PdfLoadOptions pentru încărcare în format PDF sau TxtLoadOptions pentru încărcare în TXT. Acest articol oferă exemple de lucru cu opțiunile clasei LoadOptions.

Setați versiunea Microsoft Word pentru a schimba aspectul

Diferite versiuni ale aplicației Microsoft Word pot afișa documente în mod diferit. De exemplu, există o problemă bine cunoscută cu documentele OOXML, cum ar fi DOCX sau DOTX produse folosind WPS Office. În astfel de cazuri, elementele esențiale de marcare a documentului pot lipsi sau pot fi interpretate diferit, determinând Microsoft Word 2019 să arate un astfel de document diferit față de Microsoft Word 2010.

Implicit Aspose.Words deschide documente folosind Microsoft Word 2019 reguli. Dacă aveți nevoie pentru a face încărcarea documentului să apară așa cum s-ar întâmpla într-una dintre versiunile anterioare ale aplicației Microsoft Word, ar trebui să specificați în mod explicit versiunea dorită folosind proprietatea MswVersion a clasei LoadOptions.

Următorul exemplu de cod arată cum să setați versiunea Microsoft Word cu opțiuni de încărcare:

Setați preferințele de limbă pentru a schimba aspectul

Detaliile afișării unui document în Microsoft Word depind nu numai de versiunea aplicației și de valoarea proprietății MswVersion, ci și de setările de limbă. Microsoft Word poate afișa documentele în mod diferit, în funcție de setările de dialog" Preferințe limbă Office", care pot fi găsite în"Fișier Opțiuni pentru limba". Folosind acest dialog, un utilizator poate selecta, de exemplu, limba primară, limbile de verificare, limbile de afișare și așa mai departe. Aspose.Words oferă proprietatea LanguagePreferences ca echivalent al acestui dialog. Dacă ieșirea Aspose.Words diferă de ieșirea Microsoft Word, setați valoarea corespunzătoare pentru EditingLanguage – Aceasta poate îmbunătăți documentul de ieșire.

Următorul exemplu de cod arată cum să setați Japoneza ca EditingLanguage:

Utilizați WarningCallback pentru a controla problemele în timpul încărcării unui Document

Unele documente pot fi corupte, conțin intrări nevalide sau au caracteristici care nu sunt acceptate în prezent de Aspose.Words. Dacă doriți să aflați despre problemele apărute în timpul încărcării unui document, Aspose.Words oferă interfața IWarningCallback.

Următorul exemplu de cod arată implementarea interfeței IWarningCallback:

Pentru a obține informații despre toate problemele de-a lungul timpului de încărcare, utilizați proprietatea WarningCallback.

Următorul exemplu de cod arată cum să utilizați această proprietate:

Utilizați ResourceLoadingCallback pentru a controla încărcarea resurselor externe

Un document poate conține legături externe către imagini situate undeva pe un disc local, rețea sau Internet. Aspose.Words încarcă automat astfel de imagini într-un document, dar există situații în care acest proces trebuie controlat. De exemplu, pentru a decide dacă într-adevăr trebuie să încărcăm o anumită imagine sau poate să o omitem. Opțiunea de încărcare ResourceLoadingCallback vă permite să controlați acest lucru.

Următorul exemplu de cod arată implementarea interfeței IResourceLoadingCallback:

Următorul exemplu de cod arată cum să utilizați proprietatea ResourceLoadingCallback:

Utilizați TempFolder pentru a evita o excepție de memorie

Aspose.Words suportă documente extrem de mari, care au mii de pagini pline de conținut bogat. Încărcarea unor astfel de documente poate necesita mult RAM. În procesul de încărcare, Aspose.Words are nevoie de mai multă memorie pentru a deține structuri temporare utilizate pentru a analiza un document.

Dacă aveți o problemă cu excepția din memorie în timp ce încărcați un document, încercați să utilizați proprietatea TempFolder. În acest caz, Aspose.Words va stoca unele date în fișiere temporare în loc de memorie, iar acest lucru poate ajuta la evitarea unei astfel de excepții.

Următorul exemplu de cod arată cum să setați TempFolder:

Setați codificarea în mod explicit

Majoritatea formatelor moderne de documente își stochează conținutul în Unicode și nu necesită o manipulare specială. Pe de altă parte, există încă multe documente care utilizează o codificare pre-Unicode și uneori fie ratează informațiile de codificare, fie nici măcar nu acceptă codificarea informațiilor prin natură. Aspose.Words încearcă să detecteze automat codificarea corespunzătoare în mod implicit, dar într-un caz rar poate fi necesar să utilizați o codificare diferită de cea detectată de algoritmul nostru de recunoaștere a codificării. În acest caz, utilizați proprietatea Encoding pentru a obține sau seta codificarea.

Următorul exemplu de cod arată cum să setați codificarea pentru a suprascrie codificarea aleasă automat:

Încărcați Documente Criptate

Puteți încărca documente Word criptate cu o parolă. Pentru a face acest lucru, utilizați o supraîncărcare specială a constructorului, care acceptă un obiect LoadOptions. Acest obiect conține proprietatea Password, care specifică șirul de parole.

Următorul exemplu de cod arată cum să încărcați un document criptat cu o parolă:

Dacă nu știți în prealabil Dacă fișierul este criptat, puteți utiliza clasa FileFormatUtil, care oferă metode utilitare pentru lucrul cu formate de fișiere, cum ar fi detectarea formatului de fișier sau conversia extensiilor de fișiere în/din enumerările formatului de fișier. Pentru a detecta dacă documentul este criptat și necesită o parolă pentru a-l deschide, utilizați proprietatea IsEncrypted.

Următorul exemplu de cod arată cum se verifică OpenDocument fie că este criptat, fie că nu:

Java: Detectează Formatul Fișierului

Mon, 01 Jan 0001 00:00:00 +0000

Uneori este necesar să se determine formatul unui document înainte de deschidere, deoarece extensia de fișier nu garantează că conținutul fișierului este adecvat. De exemplu, se știe că Crystal Reports emite adesea documente în format RTF, dar le dă .extensie doc.

Aspose.Words oferă posibilitatea de a obține informații despre tipul de fișier pentru a evita o excepție dacă nu sunteți sigur care este conținutul real al fișierului.

Detectați formatul de fișier fără excepție

Când aveți de-a face cu mai multe documente în diferite formate de fișiere, poate fi necesar să separați acele fișiere care pot fi procesate de Aspose.Words de cele care nu pot. De asemenea, poate doriți să știți de ce unele dintre documente nu pot fi procesate.

Dacă încercați să încărcați un fișier într-un obiect Document și Aspose.Words nu poate recunoaște formatul de fișier sau formatul nu este acceptat, Aspose.Words va arunca o excepție. Puteți prinde aceste excepții și le puteți analiza, dar Aspose.Words oferă și metoda DetectFileFormat care ne permite să determinăm rapid formatul fișierului fără a încărca un document cu posibile excepții. Această metodă returnează un obiect FileFormatInfo care conține informațiile detectate despre tipul de fișier.

DetectFileFormat verifică doar formatul de fișier, dar nu validează formatul de fișier. Nu există nicio garanție că fișierul va fi deschis cu succes, chiar dacă DetectFileFormat returnează că este unul dintre formatele acceptate. Acest lucru se datorează faptului că metoda DetectFileFormat citește doar date parțiale ale formatului de fișier, suficiente pentru verificarea formatului de fișier, dar nu suficiente pentru validarea completă.

Verificați Compatibilitatea Formatului Fișierelor

Putem verifica compatibilitatea formatelor tuturor fișierelor din folderul selectat și le putem sorta după format în subfoldere corespunzătoare.

Deoarece avem de-a face cu conținut într-un folder, primul lucru pe care trebuie să-l facem este să obținem o colecție a tuturor fișierelor din acest folder folosind metoda GetFiles a clasei Directory (din spațiul de nume System.IO).

Următorul exemplu de cod arată cum să obțineți o listă cu toate fișierele din folder:

Când toate fișierele sunt colectate, restul lucrării se face prin metoda DetectFileFormat, care verifică formatul fișierului.

Următorul exemplu de cod arată cum să iterați lista colectată de fișiere, să verificați formatul fiecărui fișier și să mutați fiecare fișier în folderul corespunzător:

Fișierele sunt mutate în subfoldere corespunzătoare folosind metoda Move a clasei File, din același spațiu de nume System.IO.

Următoarele fișiere sunt utilizate în exemplul de mai sus. Numele fișierului este în stânga și descrierea acestuia este în dreapta:

Grup de fișiere	Document De Intrare	Tip
Formate de fișiere acceptate	Test File (Doc).doc	Microsoft Word 95/6.0 sau Microsoft Word 97 – 2003 document.
	Test File (Dot).dot	Microsoft Word 95/6.0 sau Microsoft Word 97 – 2003 șablon.
	Test File (Docx).docx	Office Open XML WordprocessingML document fără macrocomenzi.
	Test File (Docm).docm	Office Open XML WordprocessingML document cu macrocomenzi.
	Test File (Dotx).dotx	Birou deschis XML WordprocessingML șablon.
	Test File (Dotm).dotm	Office Open XML WordprocessingML șablon cu macrocomenzi.
	Test File (XML).xml	FlatOPC OOXML Document.
	Test File (RTF).rtf	Document în format text îmbogățit.
	Test File (WordML).xml	Microsoft Word 2003 WordprocessingML document.
	Test File (HTML).html	HTML document.
	Test File (MHTML).mhtml	MHTML (arhivă Web) document.
	Test File (Odt).odt	OpenDocument Text (OpenOffice Scriitor).
	Test File (Ott).ott	OpenDocument Șablon De Document.
	Test File (DocPreWord60).doc	Microsoft Word 2.0 document.
Documente criptate	Test File (Enc).doc	Criptate Microsoft Word 95/6.0 sau Microsoft Word 97 – 2003 document.
	Test File (Enc).docx	Birou criptat deschis XML WordprocessingML document.
Formate de fișiere neacceptate	Test File (JPG).jpg	JPEG fișier imagine.