Represents a single folder of saved spreadsheets, scoped to a path under the tenant's spreadsheets tree. Obtained from TableUploadManager.findDir or as a child of another TableDir, it offers the same find, search and persist operations as TableUploadManager but pre-scoped to this folder, saving the caller from having to build up child paths by hand.
Properties
| Property | Returns | Description |
|---|---|---|
| dirPath | Path | The full path of this folder. |
| name | String | The leaf name of this folder, ie the last segment of its path. |
Methods
auditLogs(String tableName) · getDirPath() · getName() · search(String search) · findDirs() · findDir(String name) · findTables() · findTable(String name) · persistAsTable(String name, InputStream in) · deleteTable(String name) · renameTable(String currentName, String newName)
auditLogs(String tableName)
Returns: List<Map<String,Object>>
Return the audit log entries for a saved spreadsheet within this folder. Each entry is a map with keys: date (ISO8601 string), userId (Long), action (String).
| Parameter | Description |
|---|---|
tableName | the leaf name of the saved spreadsheet within this folder |
getDirPath()
Returns: Path
The full path of this folder.
getName()
Returns: String
The leaf name of this folder, ie the last segment of its path.
search(String search)
Returns: List<UploadedTable>
Search the saved spreadsheets within this folder by name.
| Parameter | Description |
|---|---|
search | optional case-insensitive contains filter; pass null or blank for all |
findDirs()
Returns: List<TableDir>
List the child folders directly under this folder.
findDir(String name)
Returns: TableDir
Look up a child folder of this folder by name.
| Parameter | Description |
|---|---|
name | the child folder's leaf name |
findTables()
Returns: List<UploadedTable>
List every saved spreadsheet's metadata within this folder.
findTable(String name)
Returns: UploadedTable
Look up a saved spreadsheet's metadata by its leaf name within this folder.
| Parameter | Description |
|---|---|
name | the leaf name of the saved spreadsheet within this folder |
persistAsTable(String name, InputStream in)
Returns: UploadedTable
Save the content read from the given stream as a new spreadsheet with the given name within this folder.
| Parameter | Description |
|---|---|
name | the spreadsheet's name |
in | the spreadsheet content to save |
deleteTable(String name)
Returns: void
Delete a saved spreadsheet within this folder.
| Parameter | Description |
|---|---|
name | the leaf name of the saved spreadsheet within this folder |
renameTable(String currentName, String newName)
Returns: void
Rename a saved spreadsheet within this folder, keeping it in the same folder.
| Parameter | Description |
|---|---|
currentName | the leaf name of the saved spreadsheet within this folder |
newName | the new leaf name |