ShareFileCopyOptions Class

Package:

com.azure.storage.file.share.options

Maven Artifact:

com.azure:azure-storage-file-share:12.24.0

• java.lang.Object
• • com.azure.storage.file.share.options.ShareFileCopyOptions

public final class ShareFileCopyOptions

Extended options that may be passed when copying a share.

Constructor Summary

Constructor	Description
ShareFileCopyOptions()	Creates a new instance of ShareFileCopyOptions.

Method Summary

Modifier and Type	Method and Description
ShareRequestConditions	getDestinationRequestConditions() Gets the ShareRequestConditions.
String	getFilePermission() Gets the file permission key.
Map<String,String>	getMetadata() Gets the metadata to associate with the file.
PermissionCopyModeType	getPermissionCopyModeType() Gets the option to copy file security descriptor from source file or to set it using the value which is defined by the header value of FilePermission or FilePermissionKey.
FileSmbProperties	getSmbProperties() Gets the SMB properties to set on the destination file.
CopyableFileSmbPropertiesList	getSmbPropertiesToCopy() Gets the SMB properties to copy from the source file.
Boolean	isArchiveAttributeSet() Gets the optional boolean specifying to set archive attribute on a target file.
Boolean	isIgnoreReadOnly() Gets the optional boolean specifying to overwrite the target file if it already exists and has read-only attribute set.
ShareFileCopyOptions	setArchiveAttribute(Boolean archiveAttribute) Sets the optional boolean specifying to set archive attribute on a target file.
ShareFileCopyOptions	setDestinationRequestConditions(ShareRequestConditions requestConditions) Sets the ShareRequestConditions to add conditions on copying the file.
ShareFileCopyOptions	setFilePermission(String filePermissionKey) Sets the file permission key.
ShareFileCopyOptions	setIgnoreReadOnly(Boolean ignoreReadOnly) Sets the optional boolean specifying to overwrite the target file if it already exists and has read-only attribute set.
ShareFileCopyOptions	setMetadata(Map<String,String> metadata) Sets the metadata to associate with the file.
ShareFileCopyOptions	setPermissionCopyModeType(PermissionCopyModeType copyModeType) Sets the option to copy file security descriptor from source file or to set it using the value which is defined by the header value of FilePermission or FilePermissionKey.
ShareFileCopyOptions	setSmbProperties(FileSmbProperties smbProperties) Sets the SMB properties to set on the destination file.
ShareFileCopyOptions	setSmbPropertiesToCopy(CopyableFileSmbPropertiesList smbProperties) Sets the SMB properties to copy from the source file.

Methods inherited from java.lang.Object

clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Constructor Details

ShareFileCopyOptions

public ShareFileCopyOptions()

Creates a new instance of ShareFileCopyOptions.

Method Details

getDestinationRequestConditions

public ShareRequestConditions getDestinationRequestConditions()

Gets the ShareRequestConditions.

Returns:

ShareRequestConditions

getFilePermission

public String getFilePermission()

Gets the file permission key.

Returns:

The file's permission key.

getMetadata

public Map getMetadata()

Gets the metadata to associate with the file.

Returns:

Metadata to associate with the file.

getPermissionCopyModeType

public PermissionCopyModeType getPermissionCopyModeType()

Gets the option to copy file security descriptor from source file or to set it using the value which is defined by the header value of FilePermission or FilePermissionKey.

Returns:

the option to copy file security descriptor from source file or to set it using the value which is defined by the header value of FilePermission or FilePermissionKey.

getSmbProperties

public FileSmbProperties getSmbProperties()

Gets the SMB properties to set on the destination file.

Returns:

Optional SMB properties to set on the destination file or directory. The only properties that are considered are file attributes, file creation time, file last write time, and file permission key. The rest are ignored.

getSmbPropertiesToCopy

public CopyableFileSmbPropertiesList getSmbPropertiesToCopy()

Gets the SMB properties to copy from the source file.

Returns:

SMB properties to copy from the source file.

isArchiveAttributeSet

public Boolean isArchiveAttributeSet()

Gets the optional boolean specifying to set archive attribute on a target file. True means archive attribute will be set on a target file despite attribute overrides or a source file state.

Returns:

Optional boolean specifying to set archive attribute on a target file. True means archive attribute will be set on a target file despite attribute overrides or a source file state.

isIgnoreReadOnly

public Boolean isIgnoreReadOnly()

Gets the optional boolean specifying to overwrite the target file if it already exists and has read-only attribute set.

Returns:

Optional boolean specifying to overwrite the target file if it already exists and has read-only attribute set.

setArchiveAttribute

public ShareFileCopyOptions setArchiveAttribute(Boolean archiveAttribute)

Sets the optional boolean specifying to set archive attribute on a target file. True means archive attribute will be set on a target file despite attribute overrides or a source file state.

Parameters:

archiveAttribute - Optional boolean Specifying to set archive attribute on a target file. True means archive attribute will be set on a target file despite attribute overrides or a source file state.

Returns:

The updated options.

setDestinationRequestConditions

public ShareFileCopyOptions setDestinationRequestConditions(ShareRequestConditions requestConditions)

Sets the ShareRequestConditions to add conditions on copying the file.

Parameters:

requestConditions - ShareRequestConditions

Returns:

The updated options.

setFilePermission

public ShareFileCopyOptions setFilePermission(String filePermissionKey)

Sets the file permission key.

Parameters:

filePermissionKey - The file permission key.

Returns:

the updated options.

setIgnoreReadOnly

public ShareFileCopyOptions setIgnoreReadOnly(Boolean ignoreReadOnly)

Sets the optional boolean specifying to overwrite the target file if it already exists and has read-only attribute set.

Parameters:

ignoreReadOnly - Optional boolean specifying to overwrite the target file if it already exists and has read-only attribute set.

Returns:

The updated options.

setMetadata

public ShareFileCopyOptions setMetadata(Map metadata)

Sets the metadata to associate with the file.

Parameters:

metadata - Metadata to associate with the file. If there is leading or trailing whitespace in any metadata key or value, it must be removed or encoded.

Returns:

The updated options.

setPermissionCopyModeType

public ShareFileCopyOptions setPermissionCopyModeType(PermissionCopyModeType copyModeType)

Sets the option to copy file security descriptor from source file or to set it using the value which is defined by the header value of FilePermission or FilePermissionKey.

Parameters:

copyModeType - specified option to copy file security descriptor from source file or to set it using the value which is defined by the header value of FilePermission or FilePermissionKey.

Returns:

The updated options.

setSmbProperties

public ShareFileCopyOptions setSmbProperties(FileSmbProperties smbProperties)

Sets the SMB properties to set on the destination file.

Parameters:

smbProperties - Optional SMB properties to set on the destination file or directory. The only properties that are considered are file attributes, file creation time, file last write time, and file permission key. The rest are ignored.

Returns:

The updated options.

setSmbPropertiesToCopy

public ShareFileCopyOptions setSmbPropertiesToCopy(CopyableFileSmbPropertiesList smbProperties)

Sets the SMB properties to copy from the source file.

Parameters:

smbProperties - list of SMB properties to copy from the source file.

Returns:

The updated options.