org.odpi.openmetadata.accessservices.datamanager.server.spring

Class FilesResource

java.lang.Object

org.odpi.openmetadata.accessservices.datamanager.server.spring.FilesResource

@RestController
 @RequestMapping(value="/servers/{serverName}/open-metadata/access-services/data-manager/users/{userId}")
public class FilesResource
extends Object

FilesResource supports the server-side capture of REST calls to add new file-based asset definitions.

Constructor Summary

Constructors

Constructor and Description
FilesResource() Default constructor

Method Summary

Modifier and Type	Method and Description
GUIDListResponse	addDataFileToCatalog(String serverName, String userId, String fileSystemGUID, String fileSystemName, DataFileRequestBody requestBody) Add a simple asset description linked to a connection object for a file and to the folder structure implied in the path name.
GUIDListResponse	addDataFolderAssetToCatalog(String serverName, String userId, String fileSystemGUID, String fileSystemName, DataFolderRequestBody requestBody) Creates a new folder asset that is identified as a data asset.
VoidResponse	attachDataFileAssetToFolder(String serverName, String userId, String folderGUID, String fileGUID, MetadataSourceRequestBody requestBody) Link an existing file asset to a folder.
VoidResponse	attachFolderToFileSystem(String serverName, String userId, String fileSystemGUID, String folderGUID, MetadataSourceRequestBody requestBody) Links a folder to a file system.
GUIDListResponse	createFolderStructureInCatalog(String serverName, String userId, String parentGUID, PathNameRequestBody requestBody) Creates a new folder asset for each element in the pathName that is linked from the anchor entity.
GUIDListResponse	createFolderStructureInCatalog(String serverName, String userId, String fileSystemGUID, String fileSystemName, PathNameRequestBody requestBody) Creates a new folder asset for each element in the pathName.
VoidResponse	detachDataFileAssetFromFolder(String serverName, String userId, String folderGUID, String fileGUID, MetadataSourceRequestBody requestBody) Remove a link between a file asset and a folder.
VoidResponse	detachFolderFromFileSystem(String serverName, String userId, String fileSystemGUID, String folderGUID, MetadataSourceRequestBody requestBody) Removed the link between a folder and a file system.
DataFileResponse	getDataFileByPathName(String serverName, String userId, PathNameRequestBody requestBody) Retrieve a data file by its fully qualified path name.
DataFileResponse	getDataFilesByGUID(String serverName, String userId, String dataFileGUID) Retrieve a data file asset by its unique identifier (GUID).
FileSystemResponse	getFileSystemByGUID(String serverName, String userId, String fileSystemGUID) Retrieve a FileSystemProperties asset by its unique identifier (GUID).
FileSystemResponse	getFileSystemByUniqueName(String serverName, String userId, String uniqueName) Retrieve a FileSystemProperties asset by its unique name.
GUIDListResponse	getFileSystems(String serverName, String userId, int startingFrom, int maxPageSize) Retrieve a list of defined FileSystems assets.
FileFolderResponse	getFolderByGUID(String serverName, String userId, String folderGUID) Retrieve a folder asset by its unique identifier (GUID).
FileFolderResponse	getFolderByPathName(String serverName, String userId, PathNameRequestBody requestBody) Retrieve a folder by its fully qualified path name.
GUIDListResponse	getFolderFiles(String serverName, String userId, String folderGUID, int startingFrom, int maxPageSize) Get the files inside a folder - both those that are nested and those that are linked.
GUIDListResponse	getNestedFolders(String serverName, String userId, String anchorGUID, int startingFrom, int maxPageSize) Return the list of folders nested inside a folder.
VoidResponse	moveDataFileInCatalog(String serverName, String userId, String folderGUID, String fileGUID, MetadataSourceRequestBody requestBody) Move a data file from its current parent folder to a new parent folder - this changes the file's qualified name but not its unique identifier (guid).
VoidResponse	moveDataFolderInCatalog(String serverName, String userId, String folderGUID, String dataFolderGUID, MetadataSourceRequestBody requestBody) Move a data folder from its current parent folder to a new parent folder - this changes the folder's qualified name but not its unique identifier (guid).

Methods inherited from class java.lang.Object

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

Constructor Detail

FilesResource

public FilesResource()

Default constructor

Method Detail

createFolderStructureInCatalog

@PostMapping(path="/filesystems/folders/{parentGUID}")
public GUIDListResponse createFolderStructureInCatalog(@PathVariable
                                                                                                              String serverName,
                                                                                                              @PathVariable
                                                                                                              String userId,
                                                                                                              @PathVariable
                                                                                                              String parentGUID,
                                                                                                              @RequestBody
                                                                                                              PathNameRequestBody requestBody)

Creates a new folder asset for each element in the pathName that is linked from the anchor entity. For example, a pathName of "one/two/three" creates 3 new folder assets, one called "one", the next called "one/two" and the last one called "one/two/three".

Parameters:

serverName - name of calling server

userId - calling user

parentGUID - root object to connect the folder to

requestBody - pathname of the folder (or folders)

Returns:

list of GUIDs from the top level to the leaf of the supplied pathname or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.

createFolderStructureInCatalog

@PostMapping(path="/filesystems/{fileSystemGUID}/{fileSystemName}/folders")
public GUIDListResponse createFolderStructureInCatalog(@PathVariable
                                                                                                                                   String serverName,
                                                                                                                                   @PathVariable
                                                                                                                                   String userId,
                                                                                                                                   @PathVariable
                                                                                                                                   String fileSystemGUID,
                                                                                                                                   @PathVariable
                                                                                                                                   String fileSystemName,
                                                                                                                                   @RequestBody
                                                                                                                                   PathNameRequestBody requestBody)

Creates a new folder asset for each element in the pathName. For example, a pathName of "one/two/three" creates 3 new folder assets, one called "one", the next called "one/two" and the last one called "one/two/three".

Parameters:

serverName - name of calling server

userId - calling user

fileSystemGUID - unique identifier of the software server capability that represents the root of the path name

fileSystemName - unique name of the software server capability that represents the root of the path name

requestBody - pathname of the folder (or folders)

Returns:

list of GUIDs from the top level to the leaf of the supplied pathname or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.

attachFolderToFileSystem

@PostMapping(path="/filesystems/{fileSystemGUID}/folders/{fileSystemGUID}/attach")
public VoidResponse attachFolderToFileSystem(@PathVariable
                                                                                                                                String serverName,
                                                                                                                                @PathVariable
                                                                                                                                String userId,
                                                                                                                                @PathVariable
                                                                                                                                String fileSystemGUID,
                                                                                                                                @PathVariable
                                                                                                                                String folderGUID,
                                                                                                                                @RequestBody(required=false)
                                                                                                                                MetadataSourceRequestBody requestBody)

Links a folder to a file system. The folder is not changed.

Parameters:

serverName - name of calling server

userId - calling user

fileSystemGUID - unique identifier of the file system in the catalog

folderGUID - unique identifier of the folder in the catalog

requestBody - external source identifiers - or null for local

Returns:

void or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.

detachFolderFromFileSystem

@PostMapping(path="/filesystems/{fileSystemGUID}/folders/{fileSystemGUID}/detach")
public VoidResponse detachFolderFromFileSystem(@PathVariable
                                                                                                                                  String serverName,
                                                                                                                                  @PathVariable
                                                                                                                                  String userId,
                                                                                                                                  @PathVariable
                                                                                                                                  String fileSystemGUID,
                                                                                                                                  @PathVariable
                                                                                                                                  String folderGUID,
                                                                                                                                  @RequestBody(required=false)
                                                                                                                                  MetadataSourceRequestBody requestBody)

Removed the link between a folder and a file system.

Parameters:

serverName - name of calling server

userId - calling user

fileSystemGUID - unique identifier of the file system in the catalog

folderGUID - unique identifier of the folder in the catalog

requestBody - external source identifiers - or null for local

Returns:

void or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.

addDataFileToCatalog

@PostMapping(path="/filesystems/{fileSystemGUID}/{fileSystemName}/data-files")
public GUIDListResponse addDataFileToCatalog(@PathVariable
                                                                                                                            String serverName,
                                                                                                                            @PathVariable
                                                                                                                            String userId,
                                                                                                                            @PathVariable
                                                                                                                            String fileSystemGUID,
                                                                                                                            @PathVariable
                                                                                                                            String fileSystemName,
                                                                                                                            @RequestBody
                                                                                                                            DataFileRequestBody requestBody)

Add a simple asset description linked to a connection object for a file and to the folder structure implied in the path name. If the folder structure is not catalogued already, this is created automatically using the createFolderStructureInCatalog() method. For example, a pathName of "one/two/three/MyFile.txt" potentially creates 3 new folder assets, one called "one", the next called "one/two" and the last one called "one/two/three" plus a file asset called "one/two/three/MyFile.txt".

Parameters:

serverName - name of calling server

userId - calling user (assumed to be the owner)

fileSystemGUID - unique identifier of the software server capability that represents the root of the path name

fileSystemName - unique name of the software server capability that represents the root of the path name

requestBody - properties for the asset

Returns:

list of GUIDs from the top level to the root of the pathname or InvalidParameterException full path or userId is null PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

addDataFolderAssetToCatalog

@PostMapping(path="/filesystems/{fileSystemGUID}/{fileSystemName}/data-folders")
public GUIDListResponse addDataFolderAssetToCatalog(@PathVariable
                                                                                                                                     String serverName,
                                                                                                                                     @PathVariable
                                                                                                                                     String userId,
                                                                                                                                     @PathVariable
                                                                                                                                     String fileSystemGUID,
                                                                                                                                     @PathVariable
                                                                                                                                     String fileSystemName,
                                                                                                                                     @RequestBody
                                                                                                                                     DataFolderRequestBody requestBody)

Creates a new folder asset that is identified as a data asset. This means the files and sub-folders within it collectively make up the contents of the data asset. As with other types of file-based asset, links are made to the folder structure implied in the path name. If the folder structure is not catalogued already, this is created automatically using the createFolderStructureInCatalog() method. For example, a pathName of "one/two/three/MyDataFolder" potentially creates 3 new folder assets, one called "one", the next called "one/two" and the last one called "one/two/three" plus a DataFolder asset called "one/two/three/MyDataFolder".

Parameters:

serverName - name of calling server

userId - calling user

fileSystemGUID - unique identifier of the software server capability that represents the root of the path name

fileSystemName - unique name of the software server capability that represents the root of the path name

requestBody - pathname of the data folder

Returns:

list of GUIDs from the top level to the root of the pathname or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.

attachDataFileAssetToFolder

@PostMapping(path="/folders/{folderGUID}/assets/data-files/{fileGUID}/attach")
public VoidResponse attachDataFileAssetToFolder(@PathVariable
                                                                                                                               String serverName,
                                                                                                                               @PathVariable
                                                                                                                               String userId,
                                                                                                                               @PathVariable
                                                                                                                               String folderGUID,
                                                                                                                               @PathVariable
                                                                                                                               String fileGUID,
                                                                                                                               @RequestBody(required=false)
                                                                                                                               MetadataSourceRequestBody requestBody)

Link an existing file asset to a folder. The file is not changed as this is used to create a logical link to the folder.

Parameters:

serverName - name of calling server

userId - calling user

folderGUID - unique identifier of the folder

fileGUID - unique identifier of the file

requestBody - external source identifiers - or null for local

Returns:

void or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.

detachDataFileAssetFromFolder

@PostMapping(path="/folders/{folderGUID}/assets/data-files/{fileGUID}/detach")
public VoidResponse detachDataFileAssetFromFolder(@PathVariable
                                                                                                                                 String serverName,
                                                                                                                                 @PathVariable
                                                                                                                                 String userId,
                                                                                                                                 @PathVariable
                                                                                                                                 String folderGUID,
                                                                                                                                 @PathVariable
                                                                                                                                 String fileGUID,
                                                                                                                                 @RequestBody(required=false)
                                                                                                                                 MetadataSourceRequestBody requestBody)

Remove a link between a file asset and a folder. The file is not changed. Use moveDataFileInCatalog to record the fact that the physical file has moved. Use attachDataFileAssetToFolder to create logical link to a new folder.

Parameters:

serverName - name of calling server

userId - calling user

folderGUID - unique identifier of the folder

fileGUID - unique identifier of the file

requestBody - external source identifiers - or null for local

Returns:

void or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.

moveDataFileInCatalog

@PostMapping(path="/folders/{folderGUID}/assets/data-files/{fileGUID}/move-to")
public VoidResponse moveDataFileInCatalog(@PathVariable
                                                                                                                          String serverName,
                                                                                                                          @PathVariable
                                                                                                                          String userId,
                                                                                                                          @PathVariable
                                                                                                                          String folderGUID,
                                                                                                                          @PathVariable
                                                                                                                          String fileGUID,
                                                                                                                          @RequestBody(required=false)
                                                                                                                          MetadataSourceRequestBody requestBody)

Move a data file from its current parent folder to a new parent folder - this changes the file's qualified name but not its unique identifier (guid). Also the the endpoint in the connection object.

Parameters:

serverName - name of calling server

userId - calling user

folderGUID - new parent folder

fileGUID - unique identifier of the file to move

requestBody - null request body to satisfy REST protocol

Returns:

void or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.

moveDataFolderInCatalog

@PostMapping(path="/folders/{folderGUID}/assets/data-folders/{dataFolderGUID}/move-to")
public VoidResponse moveDataFolderInCatalog(@PathVariable
                                                                                                                                    String serverName,
                                                                                                                                    @PathVariable
                                                                                                                                    String userId,
                                                                                                                                    @PathVariable
                                                                                                                                    String folderGUID,
                                                                                                                                    @PathVariable
                                                                                                                                    String dataFolderGUID,
                                                                                                                                    @RequestBody(required=false)
                                                                                                                                    MetadataSourceRequestBody requestBody)

Move a data folder from its current parent folder to a new parent folder - this changes the folder's qualified name but not its unique identifier (guid). Also the the endpoint in the connection object.

Parameters:

serverName - name of calling server

userId - calling user

folderGUID - new parent folder

dataFolderGUID - unique identifier of the data folder to move

requestBody - null request body to satisfy REST protocol

Returns:

void or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.

getFileSystemByGUID

@GetMapping(path="/filesystems/{fileSystemGUID}")
public FileSystemResponse getFileSystemByGUID(@PathVariable
                                                                                                String serverName,
                                                                                                @PathVariable
                                                                                                String userId,
                                                                                                @PathVariable
                                                                                                String fileSystemGUID)

Retrieve a FileSystemProperties asset by its unique identifier (GUID).

Parameters:

serverName - name of calling server

userId - calling user

fileSystemGUID - unique identifier used to locate the file system

Returns:

FileSystemProperties properties or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.

getFileSystemByUniqueName

@GetMapping(path="/filesystems/by-name/{uniqueName}")
public FileSystemResponse getFileSystemByUniqueName(@PathVariable
                                                                                                          String serverName,
                                                                                                          @PathVariable
                                                                                                          String userId,
                                                                                                          @PathVariable
                                                                                                          String uniqueName)

Retrieve a FileSystemProperties asset by its unique name.

Parameters:

serverName - name of calling server

userId - calling user

uniqueName - unique name for the filesystem

Returns:

Filesystem properties or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.

getFileSystems

@GetMapping(path="/filesystems")
public GUIDListResponse getFileSystems(@PathVariable
                                                                        String serverName,
                                                                        @PathVariable
                                                                        String userId,
                                                                        @RequestParam
                                                                        int startingFrom,
                                                                        @RequestParam
                                                                        int maxPageSize)

Retrieve a list of defined FileSystems assets.

Parameters:

serverName - name of calling server

userId - calling user

startingFrom - starting point in the list

maxPageSize - maximum number of results

Returns:

List of Filesystem unique identifiers or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.

getFolderByGUID

@GetMapping(path="/folders/{folderGUID}")
public FileFolderResponse getFolderByGUID(@PathVariable
                                                                                    String serverName,
                                                                                    @PathVariable
                                                                                    String userId,
                                                                                    @PathVariable
                                                                                    String folderGUID)

Retrieve a folder asset by its unique identifier (GUID).

Parameters:

serverName - name of calling server

userId - calling user

folderGUID - unique identifier used to locate the folder

Returns:

folder properties or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.

getFolderByPathName

@GetMapping(path="/folders/by-path-name")
public FileFolderResponse getFolderByPathName(@PathVariable
                                                                                        String serverName,
                                                                                        @PathVariable
                                                                                        String userId,
                                                                                        @RequestBody
                                                                                        PathNameRequestBody requestBody)

Retrieve a folder by its fully qualified path name.

Parameters:

serverName - name of calling server

userId - calling user

requestBody - path name

Returns:

folder properties or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.

getNestedFolders

@GetMapping(path="/{anchorGUID}/folders")
public GUIDListResponse getNestedFolders(@PathVariable
                                                                                   String serverName,
                                                                                   @PathVariable
                                                                                   String userId,
                                                                                   @PathVariable
                                                                                   String anchorGUID,
                                                                                   @RequestParam
                                                                                   int startingFrom,
                                                                                   @RequestParam
                                                                                   int maxPageSize)

Return the list of folders nested inside a folder.

Parameters:

serverName - name of calling server

userId - calling user

anchorGUID - unique identifier of the anchor folder or Filesystem

startingFrom - starting point in the list

maxPageSize - maximum number of results

Returns:

list of folder unique identifiers (null means no nested folders) or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.

getFolderFiles

@GetMapping(path="/folders/{folderGUID}/files")
public GUIDListResponse getFolderFiles(@PathVariable
                                                                                       String serverName,
                                                                                       @PathVariable
                                                                                       String userId,
                                                                                       @PathVariable
                                                                                       String folderGUID,
                                                                                       @RequestParam
                                                                                       int startingFrom,
                                                                                       @RequestParam
                                                                                       int maxPageSize)

Get the files inside a folder - both those that are nested and those that are linked.

Parameters:

serverName - name of calling server

userId - calling user

folderGUID - unique identifier of the anchor folder

startingFrom - starting point in the list

maxPageSize - maximum number of results

Returns:

list of file asset unique identifiers or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.

getDataFilesByGUID

@GetMapping(path="/files/{dataFileGUID}")
public DataFileResponse getDataFilesByGUID(@PathVariable
                                                                                     String serverName,
                                                                                     @PathVariable
                                                                                     String userId,
                                                                                     @PathVariable
                                                                                     String dataFileGUID)

Retrieve a data file asset by its unique identifier (GUID).

Parameters:

serverName - name of calling server

userId - calling user

dataFileGUID - unique identifier used to locate the folder

Returns:

data file properties or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.

getDataFileByPathName

@GetMapping(path="/files/by-path-name")
public DataFileResponse getDataFileByPathName(@PathVariable
                                                                                      String serverName,
                                                                                      @PathVariable
                                                                                      String userId,
                                                                                      @RequestBody
                                                                                      PathNameRequestBody requestBody)

Retrieve a data file by its fully qualified path name.

Parameters:

serverName - name of calling server

userId - calling user

requestBody - path name

Returns:

data file properties or InvalidParameterException one of the parameters is null or invalid or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem.