com.vmware.content.library.item.updatesession

Class FileStub

java.lang.Object

com.vmware.vapi.internal.bindings.Stub

com.vmware.content.library.item.updatesession.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 class, subject to change in future versions.

Nested Class Summary

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

FileTypes.AddSpec, FileTypes.Info, FileTypes.SourceType, FileTypes.ValidationError, FileTypes.ValidationResult

Field Summary

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

apiProvider, converter, ifaceId, securityContext

Constructor Summary

Constructors

Constructor and Description
FileStub(ApiProvider apiProvider, StubConfigurationBase config)
FileStub(ApiProvider apiProvider, com.vmware.vapi.internal.bindings.TypeConverter typeConverter, StubConfigurationBase config)

Method Summary

Methods

Modifier and Type	Method and Description
FileTypes.Info	add(java.lang.String updateSessionId, FileTypes.AddSpec fileSpec) Requests file content to be changed (either created, or updated).
void	add(java.lang.String updateSessionId, FileTypes.AddSpec fileSpec, AsyncCallback<FileTypes.Info> asyncCallback) Requests file content to be changed (either created, or updated).
void	add(java.lang.String updateSessionId, FileTypes.AddSpec fileSpec, AsyncCallback<FileTypes.Info> asyncCallback, InvocationConfig invocationConfig) Requests file content to be changed (either created, or updated).
FileTypes.Info	add(java.lang.String updateSessionId, FileTypes.AddSpec fileSpec, InvocationConfig invocationConfig) Requests file content to be changed (either created, or updated).
FileTypes.Info	get(java.lang.String updateSessionId, java.lang.String fileName) Retrieves information about a specific file in the snapshot of the library item at the time when the update session was created.
void	get(java.lang.String updateSessionId, java.lang.String fileName, AsyncCallback<FileTypes.Info> asyncCallback) Retrieves information about a specific file in the snapshot of the library item at the time when the update session was created.
void	get(java.lang.String updateSessionId, java.lang.String fileName, AsyncCallback<FileTypes.Info> asyncCallback, InvocationConfig invocationConfig) Retrieves information about a specific file in the snapshot of the library item at the time when the update session was created.
FileTypes.Info	get(java.lang.String updateSessionId, java.lang.String fileName, InvocationConfig invocationConfig) Retrieves information about a specific file in the snapshot of the library item at the time when the update session was created.
java.util.List<FileTypes.Info>	list(java.lang.String updateSessionId) Lists all files in the library item associated with the update session.
void	list(java.lang.String updateSessionId, AsyncCallback<java.util.List<FileTypes.Info>> asyncCallback) Lists all files in the library item associated with the update session.
void	list(java.lang.String updateSessionId, AsyncCallback<java.util.List<FileTypes.Info>> asyncCallback, InvocationConfig invocationConfig) Lists all files in the library item associated with the update session.
java.util.List<FileTypes.Info>	list(java.lang.String updateSessionId, InvocationConfig invocationConfig) Lists all files in the library item associated with the update session.
void	remove(java.lang.String updateSessionId, java.lang.String fileName) Requests a file to be removed.
void	remove(java.lang.String updateSessionId, java.lang.String fileName, AsyncCallback<java.lang.Void> asyncCallback) Requests a file to be removed.
void	remove(java.lang.String updateSessionId, java.lang.String fileName, AsyncCallback<java.lang.Void> asyncCallback, InvocationConfig invocationConfig) Requests a file to be removed.
void	remove(java.lang.String updateSessionId, java.lang.String fileName, InvocationConfig invocationConfig) Requests a file to be removed.
FileTypes.ValidationResult	validate(java.lang.String updateSessionId) Validates the files in the update session with the referenced identifier and ensures all necessary files are received.
void	validate(java.lang.String updateSessionId, AsyncCallback<FileTypes.ValidationResult> asyncCallback) Validates the files in the update session with the referenced identifier and ensures all necessary files are received.
void	validate(java.lang.String updateSessionId, AsyncCallback<FileTypes.ValidationResult> asyncCallback, InvocationConfig invocationConfig) Validates the files in the update session with the referenced identifier and ensures all necessary files are received.
FileTypes.ValidationResult	validate(java.lang.String updateSessionId, InvocationConfig invocationConfig) Validates the files in the update session with the referenced identifier and ensures all necessary files are received.

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

invokeMethod, invokeMethodAsync, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

FileStub

public FileStub(ApiProvider apiProvider,
        com.vmware.vapi.internal.bindings.TypeConverter typeConverter,
        StubConfigurationBase config)

FileStub

public FileStub(ApiProvider apiProvider,
        StubConfigurationBase config)

Method Detail

validate

public FileTypes.ValidationResult validate(java.lang.String updateSessionId)

Description copied from interface: File

Validates the files in the update session with the referenced identifier and ensures all necessary files are received. In the case where a file is missing, this method will return its name in the FileTypes.ValidationResult.getMissingFiles() set. The user can add the missing files and try re-validating. For other type of errors, FileTypes.ValidationResult.getInvalidFiles() will contain the list of invalid files.

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

Specified by:

validate in interface File

Parameters:

updateSessionId - Identifier of the update session to validate. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

Returns:

A validation result containing missing files or invalid files and the reason why they are invalid.

validate

public FileTypes.ValidationResult validate(java.lang.String updateSessionId,
                                  InvocationConfig invocationConfig)

Description copied from interface: File

Validates the files in the update session with the referenced identifier and ensures all necessary files are received. In the case where a file is missing, this method will return its name in the FileTypes.ValidationResult.getMissingFiles() set. The user can add the missing files and try re-validating. For other type of errors, FileTypes.ValidationResult.getInvalidFiles() will contain the list of invalid files.

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:

validate in interface File

Parameters:

updateSessionId - Identifier of the update session to validate. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

invocationConfig - Configuration for the method invocation.

Returns:

A validation result containing missing files or invalid files and the reason why they are invalid.

validate

public void validate(java.lang.String updateSessionId,
            AsyncCallback<FileTypes.ValidationResult> asyncCallback)

Description copied from interface: File

Validates the files in the update session with the referenced identifier and ensures all necessary files are received. In the case where a file is missing, this method will return its name in the FileTypes.ValidationResult.getMissingFiles() set. The user can add the missing files and try re-validating. For other type of errors, FileTypes.ValidationResult.getInvalidFiles() will contain the list of invalid files.

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

Operation Result:
A validation result containing missing files or invalid files and the reason why they are invalid.

Operation Errors:
NotFound - if no update session with the given identifier exists.
NotAllowedInCurrentState - if the update session is not in the UpdateSessionModel.State.ACTIVE state, or if some of the files that will be uploaded by the client aren't received correctly.

Specified by:

validate in interface File

Parameters:

updateSessionId - Identifier of the update session to validate. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

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

validate

public void validate(java.lang.String updateSessionId,
            AsyncCallback<FileTypes.ValidationResult> asyncCallback,
            InvocationConfig invocationConfig)

Description copied from interface: File

Validates the files in the update session with the referenced identifier and ensures all necessary files are received. In the case where a file is missing, this method will return its name in the FileTypes.ValidationResult.getMissingFiles() set. The user can add the missing files and try re-validating. For other type of errors, FileTypes.ValidationResult.getInvalidFiles() will contain the list of invalid files.

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:
A validation result containing missing files or invalid files and the reason why they are invalid.

Operation Errors:
NotFound - if no update session with the given identifier exists.
NotAllowedInCurrentState - if the update session is not in the UpdateSessionModel.State.ACTIVE state, or if some of the files that will be uploaded by the client aren't received correctly.

Specified by:

validate in interface File

Parameters:

updateSessionId - Identifier of the update session to validate. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

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

invocationConfig - Configuration for the method invocation.

add

public FileTypes.Info add(java.lang.String updateSessionId,
                 FileTypes.AddSpec fileSpec)

Description copied from interface: File

Requests file content to be changed (either created, or updated). Depending on the source type of the file, this method will either return an upload endpoint where the client can push the content, or the server will pull from the provided source endpoint. If a file with the same name already exists in this session, this method will be used to update the content of the existing file.

When importing a file directly from storage, where the source endpoint is a file or datastore URI, you will need to have the ContentLibrary.ReadStorage privilege on the library item. If the file is located in the same directory as the library storage backing folder, the server will move the file instead of copying it, thereby allowing instantaneous import of files for efficient backup and restore scenarios. In all other cases, a copy is performed rather than a move.

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

Specified by:

add in interface File

Parameters:

updateSessionId - Identifier of the update session to be modified. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

fileSpec - Specification for the file that needs to be added or updated. This includes whether the client wants to push the content or have the server pull it.

Returns:

An FileTypes.Info class containing upload links as well as server side state tracking the transfer of the file.

add

public FileTypes.Info add(java.lang.String updateSessionId,
                 FileTypes.AddSpec fileSpec,
                 InvocationConfig invocationConfig)

Description copied from interface: File

Requests file content to be changed (either created, or updated). Depending on the source type of the file, this method will either return an upload endpoint where the client can push the content, or the server will pull from the provided source endpoint. If a file with the same name already exists in this session, this method will be used to update the content of the existing file.

When importing a file directly from storage, where the source endpoint is a file or datastore URI, you will need to have the ContentLibrary.ReadStorage privilege on the library item. If the file is located in the same directory as the library storage backing folder, the server will move the file instead of copying it, thereby allowing instantaneous import of files for efficient backup and restore scenarios. In all other cases, a copy is performed rather than a move.

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:

add in interface File

Parameters:

updateSessionId - Identifier of the update session to be modified. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

fileSpec - Specification for the file that needs to be added or updated. This includes whether the client wants to push the content or have the server pull it.

invocationConfig - Configuration for the method invocation.

Returns:

An FileTypes.Info class containing upload links as well as server side state tracking the transfer of the file.

add

public void add(java.lang.String updateSessionId,
       FileTypes.AddSpec fileSpec,
       AsyncCallback<FileTypes.Info> asyncCallback)

Description copied from interface: File

Requests file content to be changed (either created, or updated). Depending on the source type of the file, this method will either return an upload endpoint where the client can push the content, or the server will pull from the provided source endpoint. If a file with the same name already exists in this session, this method will be used to update the content of the existing file.

When importing a file directly from storage, where the source endpoint is a file or datastore URI, you will need to have the ContentLibrary.ReadStorage privilege on the library item. If the file is located in the same directory as the library storage backing folder, the server will move the file instead of copying it, thereby allowing instantaneous import of files for efficient backup and restore scenarios. In all other cases, a copy is performed rather than a move.

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

Operation Result:
An FileTypes.Info class containing upload links as well as server side state tracking the transfer of the file.

Operation Errors:
InvalidArgument - if the fileSpec is invalid.
NotFound - if the update session doesn't exist.
Unauthorized - if the caller doesn't have ContentLibrary.ReadStorage privilege on the library item of the update session and source type FileTypes.SourceType.PULL is requested for a file or datastore source endpoint (that is, not HTTP or HTTPs based endpoint).
NotAllowedInCurrentState - if the content of the library item associated with the update session has been deleted from the storage backings (see LibraryModel#storageBackings) associated with it.
NotAllowedInCurrentState - if metadata files such as manifest and certificate file are added after the OVF descriptor file. This is applicable to update sessions with library item type OVF only. This error was added in vSphere 6.8.0.

Specified by:

add in interface File

Parameters:

updateSessionId - Identifier of the update session to be modified. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

fileSpec - Specification for the file that needs to be added or updated. This includes whether the client wants to push the content or have the server pull it.

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

add

public void add(java.lang.String updateSessionId,
       FileTypes.AddSpec fileSpec,
       AsyncCallback<FileTypes.Info> asyncCallback,
       InvocationConfig invocationConfig)

Description copied from interface: File

Requests file content to be changed (either created, or updated). Depending on the source type of the file, this method will either return an upload endpoint where the client can push the content, or the server will pull from the provided source endpoint. If a file with the same name already exists in this session, this method will be used to update the content of the existing file.

When importing a file directly from storage, where the source endpoint is a file or datastore URI, you will need to have the ContentLibrary.ReadStorage privilege on the library item. If the file is located in the same directory as the library storage backing folder, the server will move the file instead of copying it, thereby allowing instantaneous import of files for efficient backup and restore scenarios. In all other cases, a copy is performed rather than a move.

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:
An FileTypes.Info class containing upload links as well as server side state tracking the transfer of the file.

Operation Errors:
InvalidArgument - if the fileSpec is invalid.
NotFound - if the update session doesn't exist.
Unauthorized - if the caller doesn't have ContentLibrary.ReadStorage privilege on the library item of the update session and source type FileTypes.SourceType.PULL is requested for a file or datastore source endpoint (that is, not HTTP or HTTPs based endpoint).
NotAllowedInCurrentState - if the content of the library item associated with the update session has been deleted from the storage backings (see LibraryModel#storageBackings) associated with it.
NotAllowedInCurrentState - if metadata files such as manifest and certificate file are added after the OVF descriptor file. This is applicable to update sessions with library item type OVF only. This error was added in vSphere 6.8.0.

Specified by:

add in interface File

Parameters:

updateSessionId - Identifier of the update session to be modified. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

fileSpec - Specification for the file that needs to be added or updated. This includes whether the client wants to push the content or have the server pull it.

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

invocationConfig - Configuration for the method invocation.

remove

public void remove(java.lang.String updateSessionId,
          java.lang.String fileName)

Description copied from interface: File

Requests a file to be removed. The file will only be effectively removed when the update session is completed.

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

Specified by:

remove in interface File

Parameters:

updateSessionId - Identifier of the update session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

fileName - Name of the file to be removed.

remove

public void remove(java.lang.String updateSessionId,
          java.lang.String fileName,
          InvocationConfig invocationConfig)

Description copied from interface: File

Requests a file to be removed. The file will only be effectively removed when the update session is completed.

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:

remove in interface File

Parameters:

updateSessionId - Identifier of the update session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

fileName - Name of the file to be removed.

invocationConfig - Configuration for the method invocation.

remove

public void remove(java.lang.String updateSessionId,
          java.lang.String fileName,
          AsyncCallback<java.lang.Void> asyncCallback)

Description copied from interface: File

Requests a file to be removed. The file will only be effectively removed when the update session is completed.

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

Operation Errors:
NotFound - if the update session doesn't exist.
InvalidArgument - if the file doesn't exist in the library item associated with the update session.

Specified by:

remove in interface File

Parameters:

updateSessionId - Identifier of the update session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

fileName - Name of the file to be removed.

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

remove

public void remove(java.lang.String updateSessionId,
          java.lang.String fileName,
          AsyncCallback<java.lang.Void> asyncCallback,
          InvocationConfig invocationConfig)

Description copied from interface: File

Requests a file to be removed. The file will only be effectively removed when the update session is completed.

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

Operation Errors:
NotFound - if the update session doesn't exist.
InvalidArgument - if the file doesn't exist in the library item associated with the update session.

Specified by:

remove in interface File

Parameters:

updateSessionId - Identifier of the update session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

fileName - Name of the file to be removed.

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

invocationConfig - Configuration for the method invocation.

list

public java.util.List<FileTypes.Info> list(java.lang.String updateSessionId)

Description copied from interface: File

Lists all files in the library item associated with the update session.

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

Specified by:

list in interface File

Parameters:

updateSessionId - Identifier of the update session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

Returns:

The List of the files in the library item associated with the update session. This List may be empty if the caller has removed all the files as part of this session (in which case completing the update session will result in an empty library item).

list

public java.util.List<FileTypes.Info> list(java.lang.String updateSessionId,
                                  InvocationConfig invocationConfig)

Description copied from interface: File

Lists all files in the library item associated with the update 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:

updateSessionId - Identifier of the update session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

invocationConfig - Configuration for the method invocation.

Returns:

The List of the files in the library item associated with the update session. This List may be empty if the caller has removed all the files as part of this session (in which case completing the update session will result in an empty library item).

list

public void list(java.lang.String updateSessionId,
        AsyncCallback<java.util.List<FileTypes.Info>> asyncCallback)

Description copied from interface: File

Lists all files in the library item associated with the update session.

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

Operation Result:
The List of the files in the library item associated with the update session. This List may be empty if the caller has removed all the files as part of this session (in which case completing the update session will result in an empty library item).

Operation Errors:
NotFound - if the update session 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:

updateSessionId - Identifier of the update session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

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

list

public void list(java.lang.String updateSessionId,
        AsyncCallback<java.util.List<FileTypes.Info>> asyncCallback,
        InvocationConfig invocationConfig)

Description copied from interface: File

Lists all files in the library item associated with the update 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 the files in the library item associated with the update session. This List may be empty if the caller has removed all the files as part of this session (in which case completing the update session will result in an empty library item).

Operation Errors:
NotFound - if the update session 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:

updateSessionId - Identifier of the update session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

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

invocationConfig - Configuration for the method invocation.

get

public FileTypes.Info get(java.lang.String updateSessionId,
                 java.lang.String fileName)

Description copied from interface: File

Retrieves information about a specific file in the snapshot of the library item at the time when the update session was created.

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

Specified by:

get in interface File

Parameters:

updateSessionId - Identifier of the update session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

fileName - Name of the file.

Returns:

Information about the file.

get

public FileTypes.Info get(java.lang.String updateSessionId,
                 java.lang.String fileName,
                 InvocationConfig invocationConfig)

Description copied from interface: File

Retrieves information about a specific file in the snapshot of the library item at the time when the update session was created.

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:

updateSessionId - Identifier of the update session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

fileName - Name of the file.

invocationConfig - Configuration for the method invocation.

Returns:

Information about the file.

get

public void get(java.lang.String updateSessionId,
       java.lang.String fileName,
       AsyncCallback<FileTypes.Info> asyncCallback)

Description copied from interface: File

Retrieves information about a specific file in the snapshot of the library item at the time when the update session was created.

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

Operation Result:
Information about the file.

Operation Errors:
NotFound - if the update session doesn't exist.
InvalidArgument - if the file doesn't exist in the library item associated with the update session.
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:

updateSessionId - Identifier of the update session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

fileName - Name of the file.

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

get

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

Description copied from interface: File

Retrieves information about a specific file in the snapshot of the library item at the time when the update session was created.

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:
Information about the file.

Operation Errors:
NotFound - if the update session doesn't exist.
InvalidArgument - if the file doesn't exist in the library item associated with the update session.
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:

updateSessionId - Identifier of the update session. The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.

fileName - Name of the file.

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

invocationConfig - Configuration for the method invocation.