Class Index | File Index

Classes


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>.

Class Summary
Constructor Attributes Constructor Name and Description
 
Creates a new file client.
Method Summary
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.
 
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.
Class Detail
orion.fileClient.FileClient()
Creates a new file client.
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

Documentation generated by JsDoc Toolkit 2.4.0 on Wed Jul 20 2011 02:04:43 GMT-0400 (EDT)