org.jodconverter.local.office

Class LocalOfficeUtils

java.lang.Object

org.jodconverter.local.office.LocalOfficeUtils

public final class LocalOfficeUtils
extends Object

Provides helper functions for local office.

Method Summary

Modifier and Type	Method and Description
static @NonNull List<org.jodconverter.local.office.OfficeUrl>	buildOfficeUrls(@Nullable List<Integer> portNumbers, @Nullable List<String> pipeNames) Builds an array of OfficeUrl from an array of port numbers and an array of pipe names.
static @NonNull ProcessManager	findBestProcessManager() Find the best process manager that will be used to retrieve a process PID and to kill a process by PID.
static @NonNull File	getDefaultOfficeHome() Gets the default office home directory, which is auto-detected.
static @NonNull org.jodconverter.core.document.DocumentFamily	getDocumentFamily(@NonNull com.sun.star.lang.XComponent document) Gets the DocumentFamily of the specified document.
static @NonNull File	getOfficeExecutable(@NonNull File officeHome) Gets the office executable within an office installation.
static @NonNull com.sun.star.beans.PropertyValue	property(@NonNull String name, @NonNull Object value) Creates a PropertyValue with the specified name and value.
static @NonNull com.sun.star.beans.PropertyValue[]	toUnoProperties(@NonNull Map<String,Object> properties) Converts a regular java map to an array of PropertyValue, usable as arguments with UNO interface types.
static @NonNull String	toUrl(@NonNull File file) Constructs an URL from the specified file as expected by office.
static void	validateOfficeHome(@NonNull File officeHome) Validates that the specified File instance is a valid office home directory.
static void	validateOfficeTemplateProfileDirectory(@Nullable File templateProfileDir) Validates that the specified File instance is a valid office template profile directory.
static void	validateOfficeWorkingDirectory(@NonNull File workingDir) Validates that the specified File instance is a valid office working directory.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

findBestProcessManager

public static @NonNull ProcessManager findBestProcessManager()

Find the best process manager that will be used to retrieve a process PID and to kill a process by PID.

Returns:

The best process manager according to the current OS.

buildOfficeUrls

public static @NonNull List<org.jodconverter.local.office.OfficeUrl> buildOfficeUrls(@Nullable List<Integer> portNumbers,
                                                                                     @Nullable List<String> pipeNames)

Builds an array of OfficeUrl from an array of port numbers and an array of pipe names.

Parameters:

portNumbers - The port numbers from which office URLs will be created, may be null.

pipeNames - The pipe names from which office URLs will be created, may be null.

Returns:

an array of office URL. If both arguments are null, then an array is returned with a single office URL, using the default port number 2002.

getDefaultOfficeHome

public static @NonNull File getDefaultOfficeHome()

Gets the default office home directory, which is auto-detected.

Returns:

A File instance that is the directory where lives the first detected office installation.

getDocumentFamily

public static @NonNull org.jodconverter.core.document.DocumentFamily getDocumentFamily(@NonNull com.sun.star.lang.XComponent document)
                                                                                throws org.jodconverter.core.office.OfficeException

Gets the DocumentFamily of the specified document.

Parameters:

document - The document whose family will be returned.

Returns:

The DocumentFamily for the specified document.

Throws:

org.jodconverter.core.office.OfficeException - If the document family cannot be retrieved.

getOfficeExecutable

public static @NonNull File getOfficeExecutable(@NonNull File officeHome)

Gets the office executable within an office installation.

Parameters:

officeHome - The root (home) directory of the office installation.

Returns:

A instance of the executable file.

property

public static @NonNull com.sun.star.beans.PropertyValue property(@NonNull String name,
                                                                 @NonNull Object value)

Creates a PropertyValue with the specified name and value.

Parameters:

name - The property name.

value - The property value.

Returns:

The created PropertyValue.

toUnoProperties

public static @NonNull com.sun.star.beans.PropertyValue[] toUnoProperties(@NonNull Map<String,Object> properties)

Converts a regular java map to an array of PropertyValue, usable as arguments with UNO interface types.

Parameters:

properties - The map to convert.

Returns:

An array of PropertyValue.

toUrl

public static @NonNull String toUrl(@NonNull File file)

Constructs an URL from the specified file as expected by office.

Parameters:

file - The file for which an URL will be constructed.

Returns:

A valid office URL.

validateOfficeHome

public static void validateOfficeHome(@NonNull File officeHome)

Validates that the specified File instance is a valid office home directory.

Parameters:

officeHome - The home to validate.

Throws:

IllegalStateException - If the specified directory if not a valid office home directory.

validateOfficeTemplateProfileDirectory

public static void validateOfficeTemplateProfileDirectory(@Nullable File templateProfileDir)

Validates that the specified File instance is a valid office template profile directory.

Parameters:

templateProfileDir - The directory to validate.

Throws:

IllegalStateException - If the specified directory if not a valid office template profile directory.

validateOfficeWorkingDirectory

public static void validateOfficeWorkingDirectory(@NonNull File workingDir)

Validates that the specified File instance is a valid office working directory.

Parameters:

workingDir - The directory to validate.

Throws:

IllegalStateException - If the specified directory if not a valid office working directory.