com.vmware.content.library.item.downloadsession

Class FileStub

java.lang.Object

com.vmware.vapi.internal.bindings.Stub

com.vmware.content.library.item.downloadsession.FileStub

All Implemented Interfaces:

File, FileTypes, Service

public class FileStub
extends com.vmware.vapi.internal.bindings.Stub
implements File

Remote stub implementation of the File API service.

WARNING: Internal API, subject to change in future versions.

Nested Class Summary

Nested classes/interfaces inherited from interface com.vmware.content.library.item.downloadsession.FileTypes

FileTypes.EndpointType, FileTypes.Info, FileTypes.PrepareStatus

Constructor Summary

Constructors

Constructor and Description
FileStub(ApiProvider apiProvider, StubConfigurationBase config)

Method Summary

Methods

Modifier and Type	Method and Description
FileTypes.Info	get(String downloadSessionId, String fileName) Retrieves file download information for a specific file.
void	get(String downloadSessionId, String fileName, AsyncCallback<FileTypes.Info> asyncCallback) Retrieves file download information for a specific file.
void	get(String downloadSessionId, String fileName, AsyncCallback<FileTypes.Info> asyncCallback, InvocationConfig invocationConfig) Retrieves file download information for a specific file.
FileTypes.Info	get(String downloadSessionId, String fileName, InvocationConfig invocationConfig) Retrieves file download information for a specific file.
List<FileTypes.Info>	list(String downloadSessionId) Lists the information of all the files in the library item associated with the download session.
void	list(String downloadSessionId, AsyncCallback<List<FileTypes.Info>> asyncCallback) Lists the information of all the files in the library item associated with the download session.
void	list(String downloadSessionId, AsyncCallback<List<FileTypes.Info>> asyncCallback, InvocationConfig invocationConfig) Lists the information of all the files in the library item associated with the download session.
List<FileTypes.Info>	list(String downloadSessionId, InvocationConfig invocationConfig) Lists the information of all the files in the library item associated with the download session.
FileTypes.Info	prepare(String downloadSessionId, String fileName, FileTypes.EndpointType endpointType) Requests a file to be prepared for download.
void	prepare(String downloadSessionId, String fileName, FileTypes.EndpointType endpointType, AsyncCallback<FileTypes.Info> asyncCallback) Requests a file to be prepared for download.
void	prepare(String downloadSessionId, String fileName, FileTypes.EndpointType endpointType, AsyncCallback<FileTypes.Info> asyncCallback, InvocationConfig invocationConfig) Requests a file to be prepared for download.
FileTypes.Info	prepare(String downloadSessionId, String fileName, FileTypes.EndpointType endpointType, InvocationConfig invocationConfig) Requests a file to be prepared for download.

Methods inherited from class com.vmware.vapi.internal.bindings.Stub

toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

FileStub

public FileStub(ApiProvider apiProvider,
        StubConfigurationBase config)

Method Detail

list

public List<FileTypes.Info> list(String downloadSessionId)

Description copied from interface: File

Lists the information of all the files in the library item associated with the download session.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Specified by:

list in interface File

Parameters:

downloadSessionId - Identifier of the download session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.DownloadSession.

Returns:

The List of FileTypes.Info instances.

list

public List<FileTypes.Info> list(String downloadSessionId,
                        InvocationConfig invocationConfig)

Description copied from interface: File

Lists the information of all the files in the library item associated with the download session.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

list in interface File

Parameters:

downloadSessionId - Identifier of the download session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.DownloadSession.

invocationConfig - Configuration for the method invocation.

Returns:

The List of FileTypes.Info instances.

list

public void list(String downloadSessionId,
        AsyncCallback<List<FileTypes.Info>> asyncCallback)

Description copied from interface: File

Lists the information of all the files in the library item associated with the download session.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Operation Result:
The List of FileTypes.Info instances.

Operation Errors:
NotFound - if the download session associated with downloadSessionId doesn't exist.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource com.vmware.content.library.Item referenced by the parameter libraryItemId requires System.Read.

Specified by:

list in interface File

Parameters:

downloadSessionId - Identifier of the download session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.DownloadSession.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

list

public void list(String downloadSessionId,
        AsyncCallback<List<FileTypes.Info>> asyncCallback,
        InvocationConfig invocationConfig)

Description copied from interface: File

Lists the information of all the files in the library item associated with the download session.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Operation Result:
The List of FileTypes.Info instances.

Operation Errors:
NotFound - if the download session associated with downloadSessionId doesn't exist.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource com.vmware.content.library.Item referenced by the parameter libraryItemId requires System.Read.

Specified by:

list in interface File

Parameters:

downloadSessionId - Identifier of the download session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.DownloadSession.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.

prepare

public FileTypes.Info prepare(String downloadSessionId,
                     String fileName,
                     FileTypes.EndpointType endpointType)

Description copied from interface: File

Requests a file to be prepared for download.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Specified by:

prepare in interface File

Parameters:

downloadSessionId - Identifier of the download session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.DownloadSession.

fileName - Name of the file requested for download.

endpointType - Endpoint type request, one of HTTPS, DIRECT. This will determine the type of the FileTypes.Info.getDownloadEndpoint() that is generated when the file is prepared. The FileTypes.EndpointType.DIRECT is only available to users who have the ContentLibrary.ReadStorage privilege. If not specified the default is FileTypes.EndpointType.HTTPS.

Returns:

File information containing the status of the request and the download link to the file.

prepare

public FileTypes.Info prepare(String downloadSessionId,
                     String fileName,
                     FileTypes.EndpointType endpointType,
                     InvocationConfig invocationConfig)

Description copied from interface: File

Requests a file to be prepared for download.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

prepare in interface File

Parameters:

downloadSessionId - Identifier of the download session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.DownloadSession.

fileName - Name of the file requested for download.

endpointType - Endpoint type request, one of HTTPS, DIRECT. This will determine the type of the FileTypes.Info.getDownloadEndpoint() that is generated when the file is prepared. The FileTypes.EndpointType.DIRECT is only available to users who have the ContentLibrary.ReadStorage privilege. If not specified the default is FileTypes.EndpointType.HTTPS.

invocationConfig - Configuration for the method invocation.

Returns:

File information containing the status of the request and the download link to the file.

prepare

public void prepare(String downloadSessionId,
           String fileName,
           FileTypes.EndpointType endpointType,
           AsyncCallback<FileTypes.Info> asyncCallback)

Description copied from interface: File

Requests a file to be prepared for download.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Operation Result:
File information containing the status of the request and the download link to the file.

Operation Errors:
NotFound - if the download session does not exist.
InvalidArgument - if there is no file with the specified fileName.
Unauthorized - if the the download session wasn't created with the ContentLibrary.ReadStorage privilege and the caller requested a FileTypes.EndpointType.DIRECT endpoint type.

Specified by:

prepare in interface File

Parameters:

downloadSessionId - Identifier of the download session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.DownloadSession.

fileName - Name of the file requested for download.

endpointType - Endpoint type request, one of HTTPS, DIRECT. This will determine the type of the FileTypes.Info.getDownloadEndpoint() that is generated when the file is prepared. The FileTypes.EndpointType.DIRECT is only available to users who have the ContentLibrary.ReadStorage privilege. If not specified the default is FileTypes.EndpointType.HTTPS.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

prepare

public void prepare(String downloadSessionId,
           String fileName,
           FileTypes.EndpointType endpointType,
           AsyncCallback<FileTypes.Info> asyncCallback,
           InvocationConfig invocationConfig)

Description copied from interface: File

Requests a file to be prepared for download.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Operation Result:
File information containing the status of the request and the download link to the file.

Operation Errors:
NotFound - if the download session does not exist.
InvalidArgument - if there is no file with the specified fileName.
Unauthorized - if the the download session wasn't created with the ContentLibrary.ReadStorage privilege and the caller requested a FileTypes.EndpointType.DIRECT endpoint type.

Specified by:

prepare in interface File

Parameters:

downloadSessionId - Identifier of the download session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.DownloadSession.

fileName - Name of the file requested for download.

endpointType - Endpoint type request, one of HTTPS, DIRECT. This will determine the type of the FileTypes.Info.getDownloadEndpoint() that is generated when the file is prepared. The FileTypes.EndpointType.DIRECT is only available to users who have the ContentLibrary.ReadStorage privilege. If not specified the default is FileTypes.EndpointType.HTTPS.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.

get

public FileTypes.Info get(String downloadSessionId,
                 String fileName)

Description copied from interface: File

Retrieves file download information for a specific file.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Specified by:

get in interface File

Parameters:

downloadSessionId - Identifier of the download session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.DownloadSession.

fileName - Name of the file requested.

Returns:

The FileTypes.Info instance containing the status of the file and its download link if available.

get

public FileTypes.Info get(String downloadSessionId,
                 String fileName,
                 InvocationConfig invocationConfig)

Description copied from interface: File

Retrieves file download information for a specific file.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

get in interface File

Parameters:

downloadSessionId - Identifier of the download session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.DownloadSession.

fileName - Name of the file requested.

invocationConfig - Configuration for the method invocation.

Returns:

The FileTypes.Info instance containing the status of the file and its download link if available.

get

public void get(String downloadSessionId,
       String fileName,
       AsyncCallback<FileTypes.Info> asyncCallback)

Description copied from interface: File

Retrieves file download information for a specific file.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Operation Result:
The FileTypes.Info instance containing the status of the file and its download link if available.

Operation Errors:
NotFound - if the download session associated with downloadSessionId does not exist.
InvalidArgument - if there is no file with the specified fileName.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource com.vmware.content.library.Item referenced by the parameter libraryItemId requires System.Read.

Specified by:

get in interface File

Parameters:

downloadSessionId - Identifier of the download session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.DownloadSession.

fileName - Name of the file requested.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

get

public void get(String downloadSessionId,
       String fileName,
       AsyncCallback<FileTypes.Info> asyncCallback,
       InvocationConfig invocationConfig)

Description copied from interface: File

Retrieves file download information for a specific file.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Operation Result:
The FileTypes.Info instance containing the status of the file and its download link if available.

Operation Errors:
NotFound - if the download session associated with downloadSessionId does not exist.
InvalidArgument - if there is no file with the specified fileName.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource com.vmware.content.library.Item referenced by the parameter libraryItemId requires System.Read.

Specified by:

get in interface File

Parameters:

downloadSessionId - Identifier of the download session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.DownloadSession.

fileName - Name of the file requested.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.