The "fastfileslist" web service provides directory listing capabilities, typically listing all files in a specified directory without providing any meta-data . This service should be used instead of advancedfileslist when directories contain a large number of files (ex: more than 10000) and require server-based filtering.
For fastest performance, this web service requires the installation of OS-specific C libraries that are not provided with a basic installation of INTGeoServer. Contact support@int.com for details on how to obtain and configure this library. Internally, this library relies on the fstatat C-function: by default, no automount is performed and symbolic links are included.
A typical URL for fastfileslist is: http://myserver.mycompany.com:8080/INTGeoServer/json/fastfileslist?dir=/mydirectory/mysubdirectory&fileFilter=*
The following parameters are available:
dir: the relative path of the directory to list. This is a required parameter
fileFilter: a regex filter for file names. See the java.lang.String.matches method for details on regex filters. This match is performed by the server, not the OS: even if the server is hosted on Windows, the filter is case-sensitive. This is an optional parameter. When no filter is specified, all files are included
Here is an example of response. This response has been formatted to improve readability
{
"files":[
{
"name":"myFile.segy",
"isDirectory":false
},
{
"name":"MyOtherFile.segd",
"isDirectory":false
}
]
}
The name entry is the name of the file found, as reported by the operating system. It includes the extension, if any.
The isDirectory entry indicates whether the file found is a directory or a file.
To get extra information about each individual file, use the filemetadata web service.
If the fastfileslist web service is not configured correctly, no JSON response will be provided. The HTTP response will only show an "Internal error" (error 500) in its headers.