Class orion.fileClient.FileClient
The file client provides a convenience API for interacting with a file service
provided by a plugin. This class handles authorization, and authentication-related
error handling.
Defined in: </shared/eclipse/e4/orion/I201107200200/plugins/org.eclipse.orion.client.core/web/orion/fileClient.js>.
Constructor Attributes | Constructor Name and Description |
---|---|
Creates a new file client.
|
Method Attributes | Method Name and Description |
---|---|
copyFile(sourceLocation, targetLocation, name)
Copies a file or directory.
|
|
createFile(parentLocation, fileName)
Create a new file in a specified location.
|
|
createFolder(parentLocation, folderName)
Creates a folder.
|
|
createProject(url, projectName, serverPath, create)
Adds a project to a workspace.
|
|
createWorkspace(name)
Creates a new workspace with the given name.
|
|
deleteFile(location)
Deletes a file, directory, or project.
|
|
fetchChildren(location)
Obtains the children of a remote resource
|
|
loadWorkspace(location, onLoad)
Loads the workspace with the given id and sets it to be the current
workspace for the IDE.
|
|
Loads all the user's workspaces.
|
|
moveFile(sourceLocation, targetLocation, name)
Moves a file or directory.
|
|
read(location, isMetadata)
Returns the contents or metadata of the file at the given location.
|
|
remoteExport(sourceLocation, options)
Exports file and directory contents to another server
|
|
remoteImport(targetLocation, options)
Imports file and directory contents from another server
|
|
setFileService(fileService)
Set the file service
|
|
write(location, contents, args)
Writes the contents or metadata of the file at the given location.
|
Method Detail
copyFile(sourceLocation, targetLocation, name)
Copies a file or directory.
- Parameters:
- {String} sourceLocation
- The location of the file or directory to copy.
- {String} targetLocation
- The location of the target folder.
- {String} name Optional
- The name of the destination file or directory in the case of a rename
{Object}
createFile(parentLocation, fileName)
Create a new file in a specified location. Returns a deferred that will provide
The new file object when ready.
- Parameters:
- {String} parentLocation
- The location of the parent folder
- {String} fileName
- The name of the file to create
- Returns:
- {Object} A deferred that will provide the new file object
{Object}
createFolder(parentLocation, folderName)
Creates a folder.
- Parameters:
- {String} parentLocation
- The location of the parent folder
- {String} folderName
- The name of the folder to create
- Returns:
- {Object} JSON representation of the created folder
createProject(url, projectName, serverPath, create)
Adds a project to a workspace.
- Parameters:
- {String} url
- The workspace location
- {String} projectName
- the human-readable name of the project
- {String} serverPath
- The optional path of the project on the server.
- {Boolean} create
- If true, the project is created on the server file system if it doesn't already exist
createWorkspace(name)
Creates a new workspace with the given name. The resulting workspace is
passed as a parameter to the provided onCreate function.
- Parameters:
- {String} name
- The name of the new workspace
deleteFile(location)
Deletes a file, directory, or project.
- Parameters:
- {String} location
- The location of the file or directory to delete.
fetchChildren(location)
Obtains the children of a remote resource
- Parameters:
- location
- The location of the item to obtain children for
- Returns:
- A deferred that will provide the array of child objects when complete
loadWorkspace(location, onLoad)
Loads the workspace with the given id and sets it to be the current
workspace for the IDE. The workspace is created if none already exists.
- Parameters:
- {String} location
- the location of the workspace to load
- {Function} onLoad
- the function to invoke when the workspace is loaded
loadWorkspaces()
Loads all the user's workspaces. Returns a deferred that will provide the loaded
workspaces when ready.
moveFile(sourceLocation, targetLocation, name)
Moves a file or directory.
- Parameters:
- {String} sourceLocation
- The location of the file or directory to move.
- {String} targetLocation
- The location of the target folder.
- {String} name Optional
- The name of the destination file or directory in the case of a rename
read(location, isMetadata)
Returns the contents or metadata of the file at the given location.
- Parameters:
- {String} location
- The location of the file to get contents for
- {Boolean} isMetadata Optional
- If defined and true, returns the file metadata, otherwise file contents are returned
- Returns:
- A deferred that will be provided with the contents or metadata when available
remoteExport(sourceLocation, options)
Exports file and directory contents to another server
- Parameters:
- {String} sourceLocation
- The location of the folder to export from
- {Object} options
- An object specifying the export parameters
- Returns:
- A deferred for chaining events after the export completes
remoteImport(targetLocation, options)
Imports file and directory contents from another server
- Parameters:
- {String} targetLocation
- The location of the folder to import into
- {Object} options
- An object specifying the import parameters
- Returns:
- A deferred for chaining events after the import completes
setFileService(fileService)
Set the file service
- Parameters:
- fileService
- the file service object
write(location, contents, args)
Writes the contents or metadata of the file at the given location.
- Parameters:
- {String} location
- The location of the file to set contents for
- {String|Object} contents
- The content string, or metadata object to write
- {String|Object} args
- Additional arguments used during write operation (i.e. ETag)
- Returns:
- A deferred for chaining events after the write completes with new metadata object