It collects some static helper functons to handle URLs.
Sometimes it's neccessary to convert URL from/to system pathes.
Or from string to strutural notations (e.g. com.sun.star.util.URL).
And sometimes java had another notation then the office it has.
public static StringgetFileURLFromSystemPath(File aSystemPath)
Because the office need URLs for loading/saving documents
we must convert used system pathes.
And java use another notation for file URLs ... correct it.
Parameters:
aSystemPath - represent the file in system notation
Returns:
[String]
a file url which represent the given system path
getFileURLFromSystemPath
public static StringgetFileURLFromSystemPath(String sSystemPath)
The same as getFileURLFromSystemPath() before but uses string parameter instead
of a File type. It exist to supress converting of neccessary parameters in the
outside code. But of course getFileURLFromSystemPath(File) will be a little bit faster
then this method ...
Parameters:
sSystemPath - represent the file in system notation
Returns:
[String]
a file url which represent the given system path
getURLWithProtocolFromSystemPath
public static StringgetURLWithProtocolFromSystemPath(File aSystemPath,
File aBasePath,
String sServerURL)
Does the same as getFileURLFromSystemPath() before ... but uses
the given protocol string (e.g."http://") insted of "file:///".
Parameters:
aSystemPath - represent the file in system notation
aBasePath - define the base path of the aSystemPath value,
which must be replaced with the value of "sServerPath".
sServerURL - Will be used to replace sBasePath.
Returns:
[String]
an url which represent the given system path
and uses the given protocol
getURLWithProtocolFromSystemPath
public static StringgetURLWithProtocolFromSystemPath(String sSystemPath,
String sBasePath,
String sServerPath)
The same as getURLWithProtocolFromSystemPath() before but uses string parameter instead
of a File types. It exist to supress converting of neccessary parameters in the
outside code. But of course getURLWithProtocolFromSystemPath(File,File,String) will be
a little bit faster then this method ...
Parameters:
sSystemPath - represent the file in system notation
sBasePath - define the base path of the aSystemPath value,
which must be replaced with the value of "sServerPath".
sServerPath - Will be used to replace sBasePath.
Returns:
[String]
an url which represent the given system path
and uses the given protocol
This convert an URL (formated as a string) to a struct com.sun.star.util.URL.
It use a special service to do that: the URLTransformer.
Because some API calls need it and it's not allowed to set "Complete"
part of the util struct only. The URL must be parsed.
Parameters:
sURL - URL for parsing in string notation
Returns:
[com.sun.star.util.URL]
URL in UNO struct notation
getSystemFilesFromDir
public static VectorgetSystemFilesFromDir(String sStartDir)
Return a name list of all available files of a directory.
We filter pure sub directories names. All other files
are returned as full qualified URL strings. So they can be
used for further purposes. One parameter define the start directory,
another one describe the url protocol, which the return URL names should have.
Parameters:
sDir - the start directory, which should include all test files
Returns:
[Vector]
a filtered list of java File objects of all available files of the start dir
and all accessable sub directories.
