CloudFile Classe
- java.
lang. Object - ListFileItem
- com.
microsoft. azure. storage. file. CloudFile
- com.
public class CloudFile implements ListFileItem
Représente un fichier Microsoft Azure.
Récapitulatif du champ
Modificateur et type | Champ et description |
---|---|
Cloud |
fileServiceClient
Représente le client du service de fichiers. |
Cloud |
parent
Représente la référence de répertoire du fichier. |
int |
streamMinimumReadSizeInBytes
Contient la taille de lecture minimale lors de l’utilisation d’un FileInputStream. |
int |
streamWriteSizeInBytes
Contient le nombre d’octets à mettre en mémoire tampon lors de l’écriture dans un FileOutputStream. |
Récapitulatif du constructeur
Constructeur | Description |
---|---|
CloudFile(final CloudFile otherFile) |
Crée une instance de la classe en copiant les valeurs d’un autre fichier cloud. |
CloudFile(final StorageUri fileAbsoluteUri) |
Crée un instance de la classe à l’aide de l’absolu StorageUri spécifié. |
CloudFile(final StorageUri fileAbsoluteUri, final StorageCredentials credentials) |
Crée une instance de la classe à l’aide des informations d’identification Et StorageUri absolues spécifiées. |
CloudFile(final StorageUri uri, final String fileName, final CloudFileShare share) |
Crée une instance de la classe à l’aide de l’adresse, du partage et du client spécifiés. |
CloudFile(final URI fileAbsoluteUri) |
Crée un instance de la classe à l’aide de l’URI absolu spécifié. |
CloudFile(final URI fileAbsoluteUri, final StorageCredentials credentials) |
Crée un instance de la classe à l’aide de l’URI absolu et des informations d’identification spécifiés. |
Résumé de la méthode
Modificateur et type | Méthode et description |
---|---|
final void |
abortCopy(final String copyId)
Abandonne une opération de copie de fichiers Azure en cours. |
final void |
abortCopy(final String copyId, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Abandonne une opération de copie de fichiers Azure en cours. |
void |
assertValidFilePermissionOrKey()
Vérifie que les propriétés filePermission et properties.filePermissionKey du répertoire ne sont pas définies. |
void |
clearRange(final long offset, final long length)
Efface une plage d’un fichier. L’appel libère l’espace de stockage utilisé par la plage spécifiée. Les plages qui ont été effacées ne sont plus suivies dans le fichier. |
void |
clearRange(final long offset, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Efface une plage d’un fichier à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés. L’appel libère l’espace de stockage utilisé par la plage spécifiée. Les plages qui ont été effacées ne sont plus suivies dans le fichier. |
Result |
closeAllHandlesSegmented()
Fermez tous les handles SMB sur ce fichier. |
Result |
closeAllHandlesSegmented(final ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext)
Fermez tous les handles SMB sur ce fichier. |
Result |
closeHandleSegmented(String handleID)
Fermez tous les handles SMB sur ce fichier. |
Result |
closeHandleSegmented(String handleID, ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext)
Fermez tous les handles SMB sur ce fichier. |
void |
create(final long size)
Crée un fichier. Si le fichier existe déjà, cela le remplacera. |
void |
create(final long size, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Crée un fichier à l’aide de la condition d’accès, des options de demande et du contexte d’opération spécifiés. Si le fichier existe déjà, cela le remplacera. |
final void |
delete()
Supprime le fichier. |
final void |
delete(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Supprime le fichier à l’aide de la condition d’accès, des options de demande et du contexte d’opération spécifiés. |
final boolean |
deleteIfExists()
Supprime le fichier s’il existe. |
final boolean |
deleteIfExists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Supprime le fichier s’il existe, en utilisant la condition d’accès, les options de demande et le contexte d’opération spécifiés. |
final void |
download(final OutputStream outStream)
Télécharge le contenu d’un fichier dans un flux. |
final void |
download(final OutputStream outStream, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Télécharge le contenu d’un fichier dans un flux à l’aide des options de requête et du contexte d’opération spécifiés. |
final void |
downloadAttributes()
Remplit les propriétés et les métadonnées d'un fichier. Cette méthode remplit les propriétés système du fichier et les métadonnées définies par l’utilisateur. Avant de lire ou de modifier les propriétés ou métadonnées d’un fichier, appelez cette méthode ou sa surcharge pour récupérer les dernières valeurs des propriétés et métadonnées du fichier à partir du service de stockage Microsoft Azure. |
final void |
downloadAttributes(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Remplit les propriétés et métadonnées d’un fichier à l’aide des options de requête et du contexte d’opération spécifiés. Cette méthode remplit les propriétés système du fichier et les métadonnées définies par l’utilisateur. Avant de lire ou de modifier les propriétés ou métadonnées d’un fichier, appelez cette méthode ou sa surcharge pour récupérer les dernières valeurs des propriétés et métadonnées du fichier à partir du service de stockage Microsoft Azure. |
ArrayList<File |
downloadFileRanges()
Retourne une collection de plages de fichiers et leurs décalages d’octets de début et de fin. Les décalages d’octets de début et de fin pour chaque plage de fichiers sont inclusifs. |
ArrayList<File |
downloadFileRanges(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Retourne une collection de plages de fichiers et leurs décalages d’octets de début et de fin à l’aide des options de requête et du contexte d’opération spécifiés. |
final void |
downloadRange(final long offset, final Long length, final OutputStream outStream)
Télécharge le contenu d’un fichier dans un flux. |
final void |
downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Télécharge le contenu d’un fichier dans un flux à l’aide des options de requête et du contexte d’opération spécifiés. |
final int |
downloadRangeInternal(final long fileOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Télécharge une plage d’octets du fichier vers la mémoire tampon d’octets donnée. |
final int |
downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset)
Télécharge une plage d’octets du fichier vers la mémoire tampon d’octets donnée. |
final int |
downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Télécharge une plage d’octets du fichier vers la mémoire tampon d’octets donnée, à l’aide des options de requête et du contexte d’opération spécifiés. |
String |
downloadText()
Télécharge un fichier dans une chaîne à l’aide de l’encodage par défaut de la plateforme. |
String |
downloadText(final String charsetName, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Télécharge un fichier dans une chaîne à l’aide de l’encodage spécifié. |
final int |
downloadToByteArray(final byte[] buffer, final int bufferOffset)
Télécharge une plage d’octets du fichier vers la mémoire tampon d’octets donnée. |
final int |
downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Télécharge une plage d’octets du fichier vers la mémoire tampon d’octets donnée, à l’aide des options de requête et du contexte d’opération spécifiés. |
void |
downloadToFile(final String path)
Télécharge un fichier. |
void |
downloadToFile(final String path, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Télécharge un fichier. |
final boolean |
exists()
Vérifie si le fichier existe. |
final boolean |
exists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Vérifie si le fichier existe à l’aide de la condition d’accès, des options de demande et du contexte d’opération spécifiés. |
String |
generateSharedAccessSignature(final SharedAccessFilePolicy policy, final SharedAccessFileHeaders headers, final String groupPolicyIdentifier)
Retourne une signature d’accès partagé pour le fichier à l’aide de l’identificateur de stratégie de groupe et des en-têtes de fichier d’accès partagé spécifiés. Notez qu’il ne contient pas le début « ? ». |
String |
generateSharedAccessSignature(final SharedAccessFilePolicy policy, final SharedAccessFileHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols)
Retourne une signature d’accès partagé pour le fichier à l’aide de l’identificateur de stratégie de groupe et des en-têtes de fichier d’accès partagé spécifiés. Notez qu’il ne contient pas le début « ? ». |
String |
generateSharedAccessSignature(final SharedAccessFilePolicy policy, final String groupPolicyIdentifier)
Retourne une signature d’accès partagé pour le fichier à l’aide de l’identificateur de stratégie de groupe et des en-têtes de fichier d’accès partagé spécifiés. Notez qu’il ne contient pas le début « ? ». |
Copy |
getCopyState()
Retourne l’état de copie du fichier Azure. |
final HashMap<String, String> |
getMetadata()
Retourne les métadonnées du fichier. |
final String |
getName()
Retourne le nom du fichier. |
final Cloud |
getParent()
Retourne le parent de l’élément de fichier. |
String |
getParentNameFromURI(final StorageUri resourceAddress, final CloudFileShare share)
Récupère le nom parent d’un URI de fichier. |
final File |
getProperties()
Retourne les propriétés du fichier. |
final Cloud |
getServiceClient()
Retourne le client de service de fichiers associé au fichier. |
final Cloud |
getShare()
Retourne le partage du fichier. |
final Storage |
getStorageUri()
Retourne la liste des URI pour tous les emplacements. |
final int |
getStreamMinimumReadSizeInBytes()
Retourne la taille de lecture minimale lors de l’utilisation d’un FileInputStream. |
final int |
getStreamWriteSizeInBytes()
Obtient le nombre d’octets à mettre en mémoire tampon lors de l’écriture dans un FileOutputStream. |
final Storage |
getTransformedAddress(final OperationContext opContext)
Retourne l’URI transformé pour la ressource si les informations d’identification données nécessitent une transformation. |
final URI |
getUri()
Retourne l’URI de ce fichier. |
Iterable<File |
listHandles()
Obtient les handles SMB ouverts sur ce fichier. |
Iterable<File |
listHandles(FileRequestOptions options, OperationContext opContext)
Obtient les handles SMB ouverts sur ce fichier. |
Result |
listHandlesSegmented()
Obtient les handles SMB ouverts sur ce fichier. |
Result |
listHandlesSegmented(final Integer maxResults, final ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext)
Obtient les handles SMB ouverts sur ce fichier. |
final File |
openRead()
Ouvre un flux d’entrée de fichier pour télécharger le fichier. Utilisez setStreamMinimumReadSizeInBytes(final int minimumReadSize) pour configurer la taille de lecture. |
final File |
openRead(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Ouvre un flux d’entrée de fichier pour télécharger le fichier à l’aide des options de requête et du contexte d’opération spécifiés. Utilisez setStreamMinimumReadSizeInBytes(final int minimumReadSize) pour configurer la taille de lecture. |
File |
openWriteExisting()
Ouvre un objet de flux de sortie pour écrire des données dans le fichier. Le fichier doit déjà exister et toutes les données existantes peuvent être remplacées. |
File |
openWriteExisting(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Ouvre un objet de flux de sortie pour écrire des données dans le fichier, à l’aide des options de requête et du contexte d’opération spécifiés. Le fichier doit déjà exister et toutes les données existantes peuvent être remplacées. |
File |
openWriteNew(final long length)
Ouvre un objet de flux de sortie pour écrire des données dans le fichier. Le fichier n’existe pas encore et sera créé avec la longueur spécifiée. Si le fichier existe déjà sur le service, il sera remplacé. Pour éviter le remplacement et lever une erreur à la place, utilisez la openWriteNew(final long length, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) surcharge avec le approprié AccessCondition. |
File |
openWriteNew(final long length, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Ouvre un objet de flux de sortie pour écrire des données dans le fichier, à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés. Le fichier n’a pas besoin d’exister et sera créé avec la longueur spécifiée. Si le fichier existe déjà sur le service, il sera remplacé. Pour éviter le remplacement et lever une erreur à la place, transmettez un AccessCondition généré à l’aide generateIfNotExistsCondition()de . |
void |
putRangeFromURL(final long destOffset, final long length, final URI sourceUri, final long sourceOffset)
Charge une plage d’un fichier vers un autre fichier. |
void |
putRangeFromURL(final long destOffset, final long length, final URI sourceUri, final long sourceOffset, FileRequestOptions options, OperationContext opContext)
Charge une plage d’un fichier à un autre à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés |
void |
resize(long size)
Redimensionne le fichier à la taille spécifiée. |
void |
resize(long size, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Redimensionne le fichier à la taille spécifiée. |
void |
setFilePermission(String filePermission)
Définit l’autorisation de fichier du fichier à définir |
final void |
setMetadata(final HashMap<String, String> metadata)
Définit les métadonnées du fichier. |
final void |
setProperties(final FileProperties properties)
Définit les propriétés du fichier. |
final void |
setShare(final CloudFileShare share)
Définit le partage pour le fichier. |
void |
setStorageUri(final StorageUri storageUri)
Définit la liste des URI pour tous les emplacements. |
void |
setStreamMinimumReadSizeInBytes(final int minimumReadSize)
Définit la taille de lecture minimale lors de l’utilisation d’un FileInputStream. |
void |
setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)
Définit le nombre d’octets à mettre en mémoire tampon lors de l’écriture dans un FileOutputStream. |
final String |
startCopy(final CloudBlob sourceBlob)
Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un objet blob dans un nouveau fichier. |
final String |
startCopy(final CloudBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un fichier dans un nouveau fichier, en utilisant les conditions d’accès, l’ID de bail, les options de demande et le contexte d’opération spécifiés. |
final String |
startCopy(final CloudFile sourceFile)
Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un fichier Azure dans un nouveau fichier Azure. |
final String |
startCopy(final CloudFile sourceFile, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un fichier Azure dans un nouveau fichier Azure, en utilisant les conditions d’accès, l’ID de bail, les options de demande et le contexte d’opération spécifiés. |
final String |
startCopy(final URI source)
Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un URI dans un nouveau fichier Azure. |
final String |
startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un URI dans un nouveau fichier Azure, en utilisant les conditions d’accès, l’ID de bail, les options de demande et le contexte d’opération spécifiés. |
void | updateEtagAndLastModifiedFromResponse(HttpURLConnection request) |
void | updateLengthFromResponse(HttpURLConnection request) |
void |
upload(final InputStream sourceStream, final long length)
Charge les données du flux source dans le fichier. Si le fichier existe déjà sur le service, il sera remplacé. |
void |
upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Charge les données du flux source dans le fichier à l’aide de la condition d’accès, des options de demande et du contexte d’opération spécifiés. Si le fichier existe déjà sur le service, il sera remplacé. |
void |
uploadFromByteArray(final byte[] buffer, final int offset, final int length)
Charge un fichier à partir de données dans un tableau d’octets. Si le fichier existe déjà sur le service, il sera remplacé. |
void |
uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Charge un fichier à partir de données dans un tableau d’octets. Si le fichier existe déjà sur le service, il sera remplacé. |
void |
uploadFromFile(final String path)
Charge un fichier local. Si le fichier existe déjà sur le service, il sera remplacé. |
void |
uploadFromFile(final String path, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Charge un fichier à partir d’un fichier local. Si le fichier existe déjà sur le service, il sera remplacé. |
final void |
uploadMetadata()
Charge les métadonnées du fichier dans le service de stockage. Permet downloadAttributes() de récupérer les dernières valeurs des propriétés et métadonnées du fichier à partir du service de stockage Microsoft Azure. |
final void |
uploadMetadata(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Charge les métadonnées du fichier sur le service de stockage à l’aide de la condition d’accès, des options de demande et du contexte d’opération. Permet downloadAttributes() de récupérer les dernières valeurs des propriétés et métadonnées du fichier à partir du service de stockage Microsoft Azure. |
final void |
uploadProperties()
Charge les propriétés du fichier dans le service de stockage. Permet downloadAttributes() de récupérer les dernières valeurs des propriétés et métadonnées du fichier à partir du service de stockage Microsoft Azure. |
final void |
uploadProperties(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Charge les propriétés du fichier à l’aide de la condition d’accès, des options de demande et du contexte d’opération. Permet downloadAttributes() de récupérer les dernières valeurs des propriétés et métadonnées du fichier à partir du service de stockage Microsoft Azure. |
void |
uploadRange(final InputStream sourceStream, final long offset, final long length)
Charge une plage dans un fichier. |
void |
uploadRange(final InputStream sourceStream, final long offset, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Charge une plage dans un fichier à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés. |
void |
uploadText(final String content)
Charge un fichier à partir d’une chaîne à l’aide de l’encodage par défaut de la plateforme. Si le fichier existe déjà sur le service, il est remplacé. |
void |
uploadText(final String content, final String charsetName, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Charge un fichier à partir d’une chaîne à l’aide de l’encodage spécifié. Si le fichier existe déjà sur le service, il est remplacé. |
Détails du champ
fileServiceClient
protected CloudFileClient fileServiceClient
Représente le client du service de fichiers.
parent
protected CloudFileDirectory parent
Représente la référence de répertoire du fichier.
streamMinimumReadSizeInBytes
protected int streamMinimumReadSizeInBytes= Constants.DEFAULT_MINIMUM_READ_SIZE_IN_BYTES
Contient la taille de lecture minimale lors de l’utilisation d’un FileInputStream.
streamWriteSizeInBytes
protected int streamWriteSizeInBytes= Constants.DEFAULT_STREAM_WRITE_IN_BYTES
Contient le nombre d’octets à mettre en mémoire tampon lors de l’écriture dans un FileOutputStream.
Détails du constructeur
CloudFile
public CloudFile(final CloudFile otherFile)
Crée une instance de la classe en copiant les valeurs d’un autre fichier cloud.
Parameters:
CloudFile
qui représente le fichier à copier.
CloudFile
public CloudFile(final StorageUri fileAbsoluteUri)
Crée un instance de la classe à l’aide de l’absolu StorageUri spécifié.
Parameters:
Throws:
CloudFile
public CloudFile(final StorageUri fileAbsoluteUri, final StorageCredentials credentials)
Crée une instance de la classe à l’aide des informations d’identification Et StorageUri absolues spécifiées.
Parameters:
Throws:
CloudFile
protected CloudFile(final StorageUri uri, final String fileName, final CloudFileShare share)
Crée une instance de la classe à l’aide de l’adresse, du partage et du client spécifiés.
Parameters:
String
qui représente le nom du fichier.
CloudFile
public CloudFile(final URI fileAbsoluteUri)
Crée un instance de la classe à l’aide de l’URI absolu spécifié.
Parameters:
java.net.URI
qui représente l’URI absolu du fichier.
Throws:
CloudFile
public CloudFile(final URI fileAbsoluteUri, final StorageCredentials credentials)
Crée un instance de la classe à l’aide de l’URI absolu et des informations d’identification spécifiés.
Parameters:
java.net.URI
qui représente l’URI absolu du fichier.
Throws:
Détails de la méthode
abortCopy
public final void abortCopy(final String copyId)
Abandonne une opération de copie de fichiers Azure en cours.
Parameters:
String
qui identifie l’opération de copie.
Throws:
abortCopy
public final void abortCopy(final String copyId, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Abandonne une opération de copie de fichiers Azure en cours.
Parameters:
String
qui identifie l’opération de copie.
null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
Throws:
assertValidFilePermissionOrKey
protected void assertValidFilePermissionOrKey()
Vérifie que les propriétés filePermission et properties.filePermissionKey du répertoire ne sont pas définies.
clearRange
public void clearRange(final long offset, final long length)
Efface une plage d’un fichier.
L’appel libère l’espace de stockage utilisé par la plage spécifiée. Les plages qui ont été effacées ne sont plus suivies dans le fichier.
Parameters:
Throws:
clearRange
public void clearRange(final long offset, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Efface une plage d’un fichier à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés.
L’appel libère l’espace de stockage utilisé par la plage spécifiée. Les plages qui ont été effacées ne sont plus suivies dans le fichier.
Parameters:
long
qui représente le décalage, en octets, auquel commencer l’effacement.
long
qui représente la longueur, en octets, de la plage de données à effacer.
null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
Throws:
closeAllHandlesSegmented
public ResultSegment
Fermez tous les handles SMB sur ce fichier.
Returns:
Throws:
closeAllHandlesSegmented
public ResultSegment
Fermez tous les handles SMB sur ce fichier.
Parameters:
null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
Returns:
Throws:
closeHandleSegmented
public ResultSegment
Fermez tous les handles SMB sur ce fichier.
Parameters:
Returns:
Throws:
closeHandleSegmented
public ResultSegment
Fermez tous les handles SMB sur ce fichier.
Parameters:
null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
Returns:
Throws:
create
public void create(final long size)
Crée un fichier. Si le fichier existe déjà, cela le remplacera.
Parameters:
long
qui représente la taille, en octets, du fichier.
Throws:
create
public void create(final long size, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Crée un fichier à l’aide de la condition d’accès, des options de demande et du contexte d’opération spécifiés. Si le fichier existe déjà, cela le remplacera.
Parameters:
long
qui représente la taille, en octets, du fichier.
null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
Throws:
delete
public final void delete()
Supprime le fichier.
Throws:
delete
public final void delete(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Supprime le fichier à l’aide de la condition d’accès, des options de demande et du contexte d’opération spécifiés.
Parameters:
null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
Throws:
deleteIfExists
public final boolean deleteIfExists()
Supprime le fichier s’il existe.
Returns:
true
si le fichier a été supprimé ; sinon, false
.
Throws:
deleteIfExists
public final boolean deleteIfExists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Supprime le fichier s’il existe, en utilisant la condition d’accès, les options de demande et le contexte d’opération spécifiés.
Parameters:
null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
Returns:
true
si le fichier existait et a été supprimé ; Sinon false
Throws:
download
public final void download(final OutputStream outStream)
Télécharge le contenu d’un fichier dans un flux.
Parameters:
OutputStream
qui représente le flux cible.
Throws:
download
public final void download(final OutputStream outStream, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Télécharge le contenu d’un fichier dans un flux à l’aide des options de requête et du contexte d’opération spécifiés.
Parameters:
OutputStream
qui représente le flux cible.
null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
Throws:
downloadAttributes
public final void downloadAttributes()
Remplit les propriétés et les métadonnées d'un fichier.
Cette méthode remplit les propriétés système du fichier et les métadonnées définies par l’utilisateur. Avant de lire ou de modifier les propriétés ou métadonnées d’un fichier, appelez cette méthode ou sa surcharge pour récupérer les dernières valeurs des propriétés et métadonnées du fichier à partir du service de stockage Microsoft Azure.
Throws:
downloadAttributes
public final void downloadAttributes(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Remplit les propriétés et métadonnées d’un fichier à l’aide des options de requête et du contexte d’opération spécifiés.
Cette méthode remplit les propriétés système du fichier et les métadonnées définies par l’utilisateur. Avant de lire ou de modifier les propriétés ou métadonnées d’un fichier, appelez cette méthode ou sa surcharge pour récupérer les dernières valeurs des propriétés et métadonnées du fichier à partir du service de stockage Microsoft Azure.
Parameters:
null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
Throws:
downloadFileRanges
public ArrayList
Retourne une collection de plages de fichiers et leurs décalages d’octets de début et de fin.
Les décalages d’octets de début et de fin pour chaque plage de fichiers sont inclusifs.
Returns:
ArrayList
qui représente l’ensemble des plages de fichiers et leurs décalages d’octets de début et de fin.Throws:
downloadFileRanges
public ArrayList
Retourne une collection de plages de fichiers et leurs décalages d’octets de début et de fin à l’aide des options de requête et du contexte d’opération spécifiés.
Parameters:
null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
Returns:
ArrayList
qui représente l’ensemble des plages de fichiers et leurs décalages d’octets de début et de fin.Throws:
downloadRange
public final void downloadRange(final long offset, final Long length, final OutputStream outStream)
Télécharge le contenu d’un fichier dans un flux.
Parameters:
long
qui représente le décalage à utiliser comme point de départ pour la source.
Long
qui représente le nombre d’octets à lire ou null
.
OutputStream
qui représente le flux cible.
Throws:
downloadRange
public final void downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Télécharge le contenu d’un fichier dans un flux à l’aide des options de requête et du contexte d’opération spécifiés.
Parameters:
long
qui représente le décalage à utiliser comme point de départ pour la source.
Long
qui représente le nombre d’octets à lire ou null
.
OutputStream
qui représente le flux cible.
null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
Throws:
downloadRangeInternal
protected final int downloadRangeInternal(final long fileOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Télécharge une plage d’octets du fichier vers la mémoire tampon d’octets donnée.
Parameters:
long
qui représente le décalage dans le fichier pour commencer le téléchargement.
Long
qui représente le nombre d’octets à lire.
byte
qui représente la mémoire tampon dans laquelle écrire.
int
qui représente le décalage dans la mémoire tampon d’octets à commencer à écrire.
Throws:
downloadRangeToByteArray
public final int downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset)
Télécharge une plage d’octets du fichier vers la mémoire tampon d’octets donnée.
Parameters:
long
qui représente le décalage d’octets à utiliser comme point de départ pour la source.
Long
qui représente le nombre d’octets à lire ou null.
byte
qui représente la mémoire tampon dans laquelle les octets de fichier sont téléchargés.
int
qui représente le décalage d’octets à utiliser comme point de départ pour la cible.
Throws:
downloadRangeToByteArray
public final int downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Télécharge une plage d’octets du fichier vers la mémoire tampon d’octets donnée, à l’aide des options de requête et du contexte d’opération spécifiés.
Parameters:
long
qui représente le décalage d’octets à utiliser comme point de départ pour la source.
Long
qui représente le nombre d’octets à lire ou null
.
byte
qui représente la mémoire tampon dans laquelle les octets de fichier sont téléchargés.
int
qui représente le décalage d’octets à utiliser comme point de départ pour la cible.
null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
Throws:
downloadText
public String downloadText()
Télécharge un fichier dans une chaîne à l’aide de l’encodage par défaut de la plateforme.
Returns:
String
qui représente le contenu du fichier.Throws:
downloadText
public String downloadText(final String charsetName, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Télécharge un fichier dans une chaîne à l’aide de l’encodage spécifié.
Parameters:
String
qui représente le nom de l’ensemble de caractères à utiliser pour encoder le contenu. Si la valeur est null, l’encodage par défaut de la plateforme est utilisé.
null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
Returns:
String
qui représente le contenu du fichier.Throws:
downloadToByteArray
public final int downloadToByteArray(final byte[] buffer, final int bufferOffset)
Télécharge une plage d’octets du fichier vers la mémoire tampon d’octets donnée.
Parameters:
byte
qui représente la mémoire tampon dans laquelle les octets de fichier sont téléchargés.
int
qui représente le décalage d’octets à utiliser comme point de départ pour la cible.
Throws:
downloadToByteArray
public final int downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Télécharge une plage d’octets du fichier vers la mémoire tampon d’octets donnée, à l’aide des options de requête et du contexte d’opération spécifiés.
Parameters:
byte
qui représente la mémoire tampon dans laquelle les octets de fichier sont téléchargés.
long
qui représente le décalage d’octets à utiliser comme point de départ pour la cible.
null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
Throws:
downloadToFile
public void downloadToFile(final String path)
Télécharge un fichier.
Parameters:
String
qui représente le chemin d’accès au fichier qui sera créé.
Throws:
downloadToFile
public void downloadToFile(final String path, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Télécharge un fichier.
Parameters:
String
qui représente le chemin d’accès au fichier qui sera créé.
null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
Throws:
exists
public final boolean exists()
Vérifie si le fichier existe.
Returns:
true
si le fichier existe , sinon false
.
Throws:
exists
public final boolean exists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Vérifie si le fichier existe à l’aide de la condition d’accès, des options de demande et du contexte d’opération spécifiés.
Parameters:
null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
Returns:
true
si le fichier existe , sinon false
.
Throws:
generateSharedAccessSignature
public String generateSharedAccessSignature(final SharedAccessFilePolicy policy, final SharedAccessFileHeaders headers, final String groupPolicyIdentifier)
Retourne une signature d’accès partagé pour le fichier à l’aide de l’identificateur de stratégie de groupe et des en-têtes de fichier d’accès partagé spécifiés. Notez qu’il ne contient pas le début « ? ».
Parameters:
SharedAccessFilePolicy
qui représente la stratégie d’accès pour la signature d’accès partagé.
SharedAccessFileHeaders
qui représente les valeurs d’en-tête facultatives à définir pour un fichier accessible avec cette signature d’accès partagé.
String
qui représente la stratégie d’accès au niveau du partage.
Returns:
String
qui représente la signature d’accès partagé.Throws:
generateSharedAccessSignature
public String generateSharedAccessSignature(final SharedAccessFilePolicy policy, final SharedAccessFileHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols)
Retourne une signature d’accès partagé pour le fichier à l’aide de l’identificateur de stratégie de groupe et des en-têtes de fichier d’accès partagé spécifiés. Notez qu’il ne contient pas le début « ? ».
Parameters:
SharedAccessFilePolicy
qui représente la stratégie d’accès pour la signature d’accès partagé.
SharedAccessFileHeaders
qui représente les valeurs d’en-tête facultatives à définir pour un fichier accessible avec cette signature d’accès partagé.
String
qui représente la stratégie d’accès au niveau du partage.
Returns:
String
qui représente la signature d’accès partagé.Throws:
generateSharedAccessSignature
public String generateSharedAccessSignature(final SharedAccessFilePolicy policy, final String groupPolicyIdentifier)
Retourne une signature d’accès partagé pour le fichier à l’aide de l’identificateur de stratégie de groupe et des en-têtes de fichier d’accès partagé spécifiés. Notez qu’il ne contient pas le début « ? ».
Parameters:
SharedAccessFilePolicy
qui représente la stratégie d’accès pour la signature d’accès partagé.
String
qui représente la stratégie d’accès au niveau du partage.
Returns:
String
qui représente la signature d’accès partagé.Throws:
getCopyState
public CopyState getCopyState()
Retourne l’état de copie du fichier Azure.
Returns:
getMetadata
public final HashMap
Retourne les métadonnées du fichier.
Returns:
java.util.HashMap
qui représente les métadonnées du fichier.getName
public final String getName()
Retourne le nom du fichier.
Returns:
String
qui représente le nom du fichier.getParent
public final CloudFileDirectory getParent()
Retourne le parent de l’élément de fichier.
Overrides:
CloudFile.getParent()Returns:
Throws:
getParentNameFromURI
protected static String getParentNameFromURI(final StorageUri resourceAddress, final CloudFileShare share)
Récupère le nom parent d’un URI de fichier.
Parameters:
Returns:
String
qui représente l’adresse parente d’un URI de fichier.Throws:
getProperties
public final FileProperties getProperties()
Retourne les propriétés du fichier.
Returns:
getServiceClient
public final CloudFileClient getServiceClient()
Retourne le client de service de fichiers associé au fichier.
Returns:
getShare
public final CloudFileShare getShare()
Retourne le partage du fichier.
Overrides:
CloudFile.getShare()Returns:
Throws:
getStorageUri
public final StorageUri getStorageUri()
Retourne la liste des URI pour tous les emplacements.
Overrides:
CloudFile.getStorageUri()Returns:
getStreamMinimumReadSizeInBytes
public final int getStreamMinimumReadSizeInBytes()
Retourne la taille de lecture minimale lors de l’utilisation d’un FileInputStream.
Returns:
int
qui représente la taille de lecture minimale, en octets, lors de l’utilisation d’un FileInputStream objet .getStreamWriteSizeInBytes
public final int getStreamWriteSizeInBytes()
Obtient le nombre d’octets à mettre en mémoire tampon lors de l’écriture dans un FileOutputStream.
Returns:
int
qui représente le nombre d’octets à mettre en mémoire tampon.getTransformedAddress
protected final StorageUri getTransformedAddress(final OperationContext opContext)
Retourne l’URI transformé pour la ressource si les informations d’identification données nécessitent une transformation.
Parameters:
Returns:
Throws:
getUri
public final URI getUri()
Retourne l’URI de ce fichier.
Overrides:
CloudFile.getUri()Returns:
java.net.URI
qui représente l’URI du fichier.listHandles
public Iterable
Obtient les handles SMB ouverts sur ce fichier.
Returns:
Itérable
</code> of the handles that will lazily request new segments. </p>
listHandles
public Iterable listHandles(FileRequestOptions options, OperationContext opContext)
Obtient les handles SMB ouverts sur ce fichier.
Parameters:
options
- Objet FileRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
opContext
- Objet OperationContext qui représente le contexte de l’opération en cours. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.
Returns:
Itérable
</code> of the handles that will lazily request new segments. </p>
listHandlesSegmented
public ResultSegment listHandlesSegmented()
Obtient les handles SMB ouverts sur ce fichier.
Returns:
Objet ResultSegment<T> qui contient un segment de la collection énumérable d’objets ListFileItem qui représentent les fichiers et les répertoires.
Throws:
StorageException
listHandlesSegmented
public ResultSegment listHandlesSegmented(final Integer maxResults, final ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext)
Obtient les handles SMB ouverts sur ce fichier.
Parameters:
maxResults
- Nombre maximal de résultats à récupérer. Si null
ou supérieur à 5 000, le serveur retourne jusqu’à 5 000 éléments. Doit être au moins égal à 1.
continuationToken
- Objet ResultContinuation qui représente un jeton de continuation retourné par une opération de référencement précédente.
options
- Objet FileRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
opContext
- Objet OperationContext qui représente le contexte de l’opération en cours. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.
Returns:
Objet ResultSegment<T> qui contient un segment de la collection énumérable d’objets ListFileItem qui représentent les fichiers et les répertoires.
Throws:
StorageException
openRead
public final FileInputStream openRead()
Ouvre un flux d’entrée de fichier pour télécharger le fichier.
Utilisez setStreamMinimumReadSizeInBytes(final int minimumReadSize) pour configurer la taille de lecture.
Returns:
Objet InputStream
qui représente le flux à utiliser pour la lecture à partir du fichier.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
openRead
public final FileInputStream openRead(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Ouvre un flux d’entrée de fichier pour télécharger le fichier à l’aide des options de requête et du contexte d’opération spécifiés.
Utilisez setStreamMinimumReadSizeInBytes(final int minimumReadSize) pour configurer la taille de lecture.
Parameters:
accessCondition
- Objet AccessCondition qui représente les conditions d'accès pour le fichier.
options
- Objet FileRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
opContext
- Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.
Returns:
Objet InputStream
qui représente le flux à utiliser pour la lecture à partir du fichier.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
openWriteExisting
public FileOutputStream openWriteExisting()
Ouvre un objet de flux de sortie pour écrire des données dans le fichier. Le fichier doit déjà exister et toutes les données existantes peuvent être remplacées.
Returns:
Objet FileOutputStream utilisé pour écrire des données dans le fichier.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
openWriteExisting
public FileOutputStream openWriteExisting(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Ouvre un objet de flux de sortie pour écrire des données dans le fichier, à l’aide des options de requête et du contexte d’opération spécifiés. Le fichier doit déjà exister et toutes les données existantes peuvent être remplacées.
Parameters:
accessCondition
- Objet AccessCondition qui représente les conditions d’accès du fichier.
options
- Objet FileRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
opContext
- Objet OperationContext qui représente le contexte de l’opération en cours. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.
Returns:
Objet FileOutputStream utilisé pour écrire des données dans le fichier.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
openWriteNew
public FileOutputStream openWriteNew(final long length)
Ouvre un objet de flux de sortie pour écrire des données dans le fichier. Le fichier n’existe pas encore et sera créé avec la longueur spécifiée. Si le fichier existe déjà sur le service, il sera remplacé.
Pour éviter le remplacement et lever une erreur à la place, utilisez la openWriteNew(final long length, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) surcharge avec le approprié AccessCondition.
Parameters:
length
- long
qui représente la longueur, en octets, du flux à créer.
Returns:
Objet FileOutputStream utilisé pour écrire des données dans le fichier.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
openWriteNew
public FileOutputStream openWriteNew(final long length, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Ouvre un objet de flux de sortie pour écrire des données dans le fichier, à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés. Le fichier n’a pas besoin d’exister et sera créé avec la longueur spécifiée. Si le fichier existe déjà sur le service, il sera remplacé.
Pour éviter le remplacement et lever une erreur à la place, transmettez un AccessCondition généré à l’aide generateIfNotExistsCondition()de .
Parameters:
length
- long
qui représente la longueur, en octets, du flux à créer.
accessCondition
- Objet AccessCondition qui représente les conditions d’accès du fichier.
options
- Objet FileRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
opContext
- Objet OperationContext qui représente le contexte de l’opération en cours. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.
Returns:
Objet FileOutputStream utilisé pour écrire des données dans le fichier.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
putRangeFromURL
public void putRangeFromURL(final long destOffset, final long length, final URI sourceUri, final long sourceOffset)
Charge une plage d’un fichier vers un autre fichier.
Parameters:
destOffset
- long
qui représente le décalage, en nombre d’octets, auquel commencer l’écriture des données.
length
- long
qui représente la longueur, en octets, des données à écrire et à lire.
sourceUri
- Objet java.net.URI
qui spécifie l’URI source.
sourceOffset
- long
qui représente le décalage, en nombre d’octets, auquel commencer la lecture des données.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
putRangeFromURL
public void putRangeFromURL(final long destOffset, final long length, final URI sourceUri, final long sourceOffset, FileRequestOptions options, OperationContext opContext)
Charge une plage d’un fichier à un autre à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés
Parameters:
destOffset
- long
qui représente le décalage, en nombre d’octets, auquel commencer l’écriture des données.
length
- long
qui représente la longueur, en octets, des données à écrire et à lire.
sourceUri
- Objet java.net.URI
qui spécifie l’URI source.
sourceOffset
- long
qui représente le décalage, en nombre d’octets, auquel commencer la lecture des données.
options
- Objet FileRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
opContext
- Objet OperationContext qui représente le contexte de l’opération en cours. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
resize
public void resize(long size)
Redimensionne le fichier à la taille spécifiée.
Parameters:
size
- long
qui représente la taille du fichier, en octets.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
resize
public void resize(long size, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Redimensionne le fichier à la taille spécifiée.
Parameters:
size
- long
qui représente la taille du fichier, en octets.
accessCondition
- Objet AccessCondition qui représente les conditions d’accès du fichier.
options
- Objet FileRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
opContext
- Objet OperationContext qui représente le contexte de l’opération en cours. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
setFilePermission
public void setFilePermission(String filePermission)
Définit l’autorisation de fichier du fichier à définir
Parameters:
filePermission
- String
qui représente l’autorisation de fichier du fichier à définir.
setMetadata
public final void setMetadata(final HashMap metadata)
Définit les métadonnées du fichier.
Parameters:
metadata
- Objet java.util.HashMap
qui contient les métadonnées affectées au fichier.
setProperties
protected final void setProperties(final FileProperties properties)
Définit les propriétés du fichier.
Parameters:
properties
- Objet FileProperties qui représente les propriétés affectées au fichier.
setShare
protected final void setShare(final CloudFileShare share)
Définit le partage pour le fichier.
Parameters:
share
- Objet CloudFileShare qui représente le partage affecté au fichier.
setStorageUri
protected void setStorageUri(final StorageUri storageUri)
Définit la liste des URI pour tous les emplacements.
Parameters:
storageUri
- StorageUri qui représente la liste des URI pour tous les emplacements.
setStreamMinimumReadSizeInBytes
public void setStreamMinimumReadSizeInBytes(final int minimumReadSize)
Définit la taille de lecture minimale lors de l’utilisation d’un FileInputStream.
Parameters:
minimumReadSize
- int
qui représente le nombre minimal d’octets à mettre en mémoire tampon lors de la lecture à partir d’un fichier lors de l’utilisation d’un FileInputStream objet. Doit être supérieur ou égal à 16 Ko.
Throws:
IllegalArgumentException
- Si minimumReadSize
est inférieur à 16 Ko.
setStreamWriteSizeInBytes
public void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)
Définit le nombre d’octets à mettre en mémoire tampon lors de l’écriture dans un FileOutputStream.
Parameters:
streamWriteSizeInBytes
- int
qui représente le nombre d’octets à mettre en mémoire tampon lors de l’utilisation d’un FileOutputStream objet, allant de 512 octets à 4 Mo, inclus.
Throws:
IllegalArgumentException
- Si streamWriteSizeInBytes
est inférieur à 512 octets ou supérieur à 4 Mo.
startCopy
public final String startCopy(final CloudBlob sourceBlob)
Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un objet blob dans un nouveau fichier.
Parameters:
sourceBlob
- Objet CloudBlob
qui représente l’objet blob source à copier.
Returns:
String
qui représente l’ID de copie associé à l’opération de copie.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
startCopy
public final String startCopy(final CloudBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un fichier dans un nouveau fichier, en utilisant les conditions d’accès, l’ID de bail, les options de demande et le contexte d’opération spécifiés.
Parameters:
sourceBlob
- Objet CloudBlob
qui représente l’objet blob source à copier.
sourceAccessCondition
- Objet AccessCondition qui représente les conditions d’accès pour l’objet blob source.
destinationAccessCondition
- Objet AccessCondition qui représente les conditions d’accès du fichier de destination.
options
- Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null
utilise les options de requête par défaut du client de service associé (CloudBlobClient).
opContext
- Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.
Returns:
String
qui représente l’ID de copie associé à l’opération de copie.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
startCopy
public final String startCopy(final CloudFile sourceFile)
Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un fichier Azure dans un nouveau fichier Azure.
Parameters:
sourceFile
- Objet CloudFile
qui représente le fichier Azure source à copier.
Returns:
String
qui représente l’ID de copie associé à l’opération de copie.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
startCopy
public final String startCopy(final CloudFile sourceFile, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un fichier Azure dans un nouveau fichier Azure, en utilisant les conditions d’accès, l’ID de bail, les options de demande et le contexte d’opération spécifiés.
Parameters:
sourceFile
- Objet CloudFile
qui représente le fichier source à copier.
sourceAccessCondition
- Objet AccessCondition qui représente les conditions d’accès de la source.
destinationAccessCondition
- Objet AccessCondition qui représente les conditions d’accès pour la destination.
options
- Objet FileRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null
utilise les options de requête par défaut du client de service associé (CloudFileClient).
opContext
- Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.
Returns:
String
qui représente l’ID de copie associé à l’opération de copie.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
startCopy
public final String startCopy(final URI source)
Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un URI dans un nouveau fichier Azure.
Parameters:
source
- La source est java.net.URI
.
Returns:
String
qui représente l’ID de copie associé à l’opération de copie.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
startCopy
public final String startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un URI dans un nouveau fichier Azure, en utilisant les conditions d’accès, l’ID de bail, les options de demande et le contexte d’opération spécifiés.
Parameters:
source
- La source est java.net.URI
.
sourceAccessCondition
- Objet AccessCondition qui représente les conditions d’accès de la source.
destinationAccessCondition
- Objet AccessCondition qui représente les conditions d’accès pour la destination.
options
- Objet FileRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null
utilise les options de requête par défaut du client de service associé (CloudFileClient).
opContext
- Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.
Returns:
String
qui représente l’ID de copie associé à l’opération de copie.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
updateEtagAndLastModifiedFromResponse
protected void updateEtagAndLastModifiedFromResponse(HttpURLConnection request)
Parameters:
request
updateLengthFromResponse
protected void updateLengthFromResponse(HttpURLConnection request)
Parameters:
request
upload
public void upload(final InputStream sourceStream, final long length)
Charge les données du flux source dans le fichier. Si le fichier existe déjà sur le service, il sera remplacé.
Parameters:
sourceStream
- Objet InputStream à partir duquel lire.
length
- long
qui représente la longueur, en octets, des données de flux. Doit être autre que zéro.
Throws:
IOException
- Si une exception d’E/S s’est produite.
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
upload
public void upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Charge les données du flux source dans le fichier à l’aide de la condition d’accès, des options de demande et du contexte d’opération spécifiés. Si le fichier existe déjà sur le service, il sera remplacé.
Parameters:
sourceStream
- Objet InputStream à partir duquel lire.
length
- long
qui représente la longueur, en octets, des données de flux. Cette valeur doit être supérieure ou égale à zéro.
accessCondition
- Objet AccessCondition qui représente les conditions d’accès du fichier.
options
- Objet FileRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
opContext
- Objet OperationContext qui représente le contexte de l’opération en cours. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.
Throws:
IOException
- Si une exception d’E/S s’est produite.
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
uploadFromByteArray
public void uploadFromByteArray(final byte[] buffer, final int offset, final int length)
Charge un fichier à partir de données dans un tableau d’octets. Si le fichier existe déjà sur le service, il sera remplacé.
Parameters:
buffer
- Tableau byte
qui représente les données à écrire dans le fichier.
offset
- int
qui représente le décalage du tableau d’octets à partir duquel démarrer le chargement des données.
length
- int
qui représente le nombre d’octets à charger à partir de la mémoire tampon d’entrée.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
IOException
URISyntaxException
uploadFromByteArray
public void uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Charge un fichier à partir de données dans un tableau d’octets. Si le fichier existe déjà sur le service, il sera remplacé.
Parameters:
buffer
- Tableau byte
qui représente les données à écrire dans le fichier.
offset
- int
qui représente le décalage du tableau d’octets à partir duquel démarrer le chargement des données.
length
- int
qui représente le nombre d’octets à charger à partir de la mémoire tampon d’entrée.
accessCondition
- Objet AccessCondition qui représente les conditions d'accès pour le fichier.
options
- Objet FileRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
opContext
- Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
IOException
URISyntaxException
uploadFromFile
public void uploadFromFile(final String path)
Charge un fichier local. Si le fichier existe déjà sur le service, il sera remplacé.
Parameters:
path
- String
qui représente le chemin d’accès au fichier à charger.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
IOException
URISyntaxException
uploadFromFile
public void uploadFromFile(final String path, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Charge un fichier à partir d’un fichier local. Si le fichier existe déjà sur le service, il sera remplacé.
Parameters:
path
- String
qui représente le chemin d’accès au fichier à charger.
accessCondition
- Objet AccessCondition qui représente les conditions d'accès pour le fichier.
options
- Objet FileRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
opContext
- Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
IOException
URISyntaxException
uploadMetadata
public final void uploadMetadata()
Charge les métadonnées du fichier dans le service de stockage.
Permet downloadAttributes() de récupérer les dernières valeurs des propriétés et métadonnées du fichier à partir du service de stockage Microsoft Azure.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
uploadMetadata
public final void uploadMetadata(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Charge les métadonnées du fichier sur le service de stockage à l’aide de la condition d’accès, des options de demande et du contexte d’opération.
Permet downloadAttributes() de récupérer les dernières valeurs des propriétés et métadonnées du fichier à partir du service de stockage Microsoft Azure.
Parameters:
accessCondition
- Objet AccessCondition qui représente les conditions d'accès pour le fichier.
options
- Objet FileRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
opContext
- Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
uploadProperties
public final void uploadProperties()
Charge les propriétés du fichier dans le service de stockage.
Permet downloadAttributes() de récupérer les dernières valeurs des propriétés et métadonnées du fichier à partir du service de stockage Microsoft Azure.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
uploadProperties
public final void uploadProperties(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Charge les propriétés du fichier à l’aide de la condition d’accès, des options de demande et du contexte d’opération.
Permet downloadAttributes() de récupérer les dernières valeurs des propriétés et métadonnées du fichier à partir du service de stockage Microsoft Azure.
Parameters:
accessCondition
- Objet AccessCondition qui représente les conditions d'accès pour le fichier.
options
- Objet FileRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
opContext
- Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
uploadRange
public void uploadRange(final InputStream sourceStream, final long offset, final long length)
Charge une plage dans un fichier.
Parameters:
sourceStream
- Objet InputStream qui représente le flux d’entrée à écrire dans le fichier.
offset
- long
qui représente le décalage, en nombre d’octets, auquel commencer l’écriture des données.
length
- long
qui représente la longueur, en octets, des données à écrire.
Throws:
IOException
- Si une exception d’E/S s’est produite.
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
uploadRange
public void uploadRange(final InputStream sourceStream, final long offset, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Charge une plage dans un fichier à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés.
Parameters:
sourceStream
- Objet InputStream qui représente le flux d’entrée à écrire dans le fichier.
offset
- long
qui représente le décalage, en nombre d’octets, auquel commencer l’écriture des données.
length
- long
qui représente la longueur, en octets, des données à écrire.
accessCondition
- Objet AccessCondition qui représente les conditions d’accès pour le fichier.
options
- Objet FileRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
opContext
- Objet OperationContext qui représente le contexte de l’opération en cours. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.
Throws:
IOException
- Si une exception d’E/S s’est produite.
StorageException
- Si une erreur de service de stockage s’est produite.
URISyntaxException
uploadText
public void uploadText(final String content)
Charge un fichier à partir d’une chaîne à l’aide de l’encodage par défaut de la plateforme. Si le fichier existe déjà sur le service, il est remplacé.
Parameters:
content
- String
qui représente le contenu qui sera chargé dans le fichier.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
IOException
URISyntaxException
uploadText
public void uploadText(final String content, final String charsetName, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Charge un fichier à partir d’une chaîne à l’aide de l’encodage spécifié. Si le fichier existe déjà sur le service, il est remplacé.
Parameters:
content
- String
qui représente le contenu qui sera chargé dans le fichier.
charsetName
- String
qui représente le nom de l’ensemble de caractères à utiliser pour encoder le contenu. Si la valeur est null, l’encodage par défaut de la plateforme est utilisé.
accessCondition
- Objet AccessCondition qui représente les conditions d'accès pour le fichier.
options
- Objet FileRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null
utilise les options de requête par défaut du client de service associé ( CloudFileClient).
opContext
- Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.
Throws:
StorageException
- Si une erreur de service de stockage s’est produite.
IOException
URISyntaxException
S’applique à
Azure SDK for Java