CloudFile Clase
- java.
lang. Object - ListFileItem
- com.
microsoft. azure. storage. file. CloudFile
- com.
public class CloudFile implements ListFileItem
Representa un archivo de Microsoft Azure.
Resumen del campo
Modificador y tipo | Campo y descripción |
---|---|
Cloud |
fileServiceClient
Representa el cliente del servicio de archivos. |
Cloud |
parent
Representa la referencia de directorio del archivo. |
int |
streamMinimumReadSizeInBytes
Contiene el tamaño de lectura mínimo cuando se usa .FileInputStream |
int |
streamWriteSizeInBytes
Contiene el número de bytes que se van a almacenar en búfer al escribir en .FileOutputStream |
Resumen del constructor
Constructor | Description |
---|---|
CloudFile(final CloudFile otherFile) |
Crea una instancia de la clase copiando valores de otro archivo en la nube. |
CloudFile(final StorageUri fileAbsoluteUri) |
Crea una instancia de la clase utilizando el storageUri absoluto especificado. |
CloudFile(final StorageUri fileAbsoluteUri, final StorageCredentials credentials) |
Crea una instancia de la clase con el storageUri y las credenciales absolutos especificados. |
CloudFile(final StorageUri uri, final String fileName, final CloudFileShare share) |
Crea una instancia de la clase utilizando la dirección, el recurso compartido y el cliente especificados. |
CloudFile(final URI fileAbsoluteUri) |
Crea una instancia de la clase utilizando el URI absoluto especificado. |
CloudFile(final URI fileAbsoluteUri, final StorageCredentials credentials) |
Crea una instancia de la clase mediante el URI absoluto y las credenciales especificados. |
Resumen del método
Modificador y tipo | Método y descripción |
---|---|
final void |
abortCopy(final String copyId)
Anula una operación de copia de archivos de Azure en curso. |
final void |
abortCopy(final String copyId, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Anula una operación de copia de archivos de Azure en curso. |
void |
assertValidFilePermissionOrKey()
Comprueba que el archivo del directorioPermission y properties.filePermissionKey no están establecidos. |
void |
clearRange(final long offset, final long length)
Borra un intervalo de un archivo. La llamada a libera el espacio de almacenamiento utilizado por el intervalo especificado. Ya no se realiza un seguimiento de los intervalos que se han borrado como parte del archivo. |
void |
clearRange(final long offset, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Borra un intervalo de un archivo mediante el identificador de concesión, las opciones de solicitud y el contexto de operación especificados. La llamada a libera el espacio de almacenamiento utilizado por el intervalo especificado. Ya no se realiza un seguimiento de los intervalos que se han borrado como parte del archivo. |
Result |
closeAllHandlesSegmented()
Cierre todos los identificadores de SMB en este archivo. |
Result |
closeAllHandlesSegmented(final ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext)
Cierre todos los identificadores de SMB en este archivo. |
Result |
closeHandleSegmented(String handleID)
Cierre todos los identificadores de SMB en este archivo. |
Result |
closeHandleSegmented(String handleID, ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext)
Cierre todos los identificadores de SMB en este archivo. |
void |
create(final long size)
Crea un archivo. Si el archivo ya existe, esto lo reemplazará. |
void |
create(final long size, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Crea un archivo mediante la condición de acceso, las opciones de solicitud y el contexto de operación especificados. Si el archivo ya existe, esto lo reemplazará. |
final void |
delete()
Elimina el archivo. |
final void |
delete(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Elimina el archivo mediante la condición de acceso, las opciones de solicitud y el contexto de operación especificados. |
final boolean |
deleteIfExists()
Elimina el archivo si existe. |
final boolean |
deleteIfExists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Elimina el archivo si existe, utilizando la condición de acceso, las opciones de solicitud y el contexto de operación especificados. |
final void |
download(final OutputStream outStream)
Descarga el contenido de un archivo en una secuencia. |
final void |
download(final OutputStream outStream, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Descarga el contenido de un archivo en una secuencia mediante las opciones de solicitud y el contexto de operación especificados. |
final void |
downloadAttributes()
Rellena las propiedades y los metadatos de un archivo. Este método rellena las propiedades del sistema del archivo y los metadatos definidos por el usuario. Antes de leer o modificar las propiedades o metadatos de un archivo, llame a este método o su sobrecarga para recuperar los valores más recientes de las propiedades y metadatos del archivo del servicio de almacenamiento de Microsoft Azure. |
final void |
downloadAttributes(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Rellena las propiedades y los metadatos de un archivo mediante las opciones de solicitud y el contexto de operación especificados. Este método rellena las propiedades del sistema del archivo y los metadatos definidos por el usuario. Antes de leer o modificar las propiedades o metadatos de un archivo, llame a este método o su sobrecarga para recuperar los valores más recientes de las propiedades y metadatos del archivo del servicio de almacenamiento de Microsoft Azure. |
ArrayList<File |
downloadFileRanges()
Devuelve una colección de intervalos de archivos y sus desplazamientos de bytes iniciales y finales. Los desplazamientos de bytes inicial y final para cada intervalo de archivos son inclusivos. |
ArrayList<File |
downloadFileRanges(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Devuelve una colección de intervalos de archivos y sus desplazamientos de bytes iniciales y finales mediante las opciones de solicitud y el contexto de operación especificados. |
final void |
downloadRange(final long offset, final Long length, final OutputStream outStream)
Descarga el contenido de un archivo en una secuencia. |
final void |
downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Descarga el contenido de un archivo en una secuencia mediante las opciones de solicitud y el contexto de operación especificados. |
final int |
downloadRangeInternal(final long fileOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Descarga un intervalo de bytes del archivo al búfer de bytes especificado. |
final int |
downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset)
Descarga un intervalo de bytes del archivo al búfer de bytes especificado. |
final int |
downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Descarga un intervalo de bytes desde el archivo hasta el búfer de bytes determinado mediante las opciones de solicitud y el contexto de operación especificados. |
String |
downloadText()
Descarga un archivo en una cadena mediante la codificación predeterminada de la plataforma. |
String |
downloadText(final String charsetName, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Descarga un archivo en una cadena mediante la codificación especificada. |
final int |
downloadToByteArray(final byte[] buffer, final int bufferOffset)
Descarga un intervalo de bytes del archivo al búfer de bytes especificado. |
final int |
downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Descarga un intervalo de bytes desde el archivo hasta el búfer de bytes determinado mediante las opciones de solicitud y el contexto de operación especificados. |
void |
downloadToFile(final String path)
Descarga un archivo. |
void |
downloadToFile(final String path, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Descarga un archivo. |
final boolean |
exists()
Comprueba si el archivo existe. |
final boolean |
exists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Comprueba si el archivo existe mediante la condición de acceso, las opciones de solicitud y el contexto de operación especificados. |
String |
generateSharedAccessSignature(final SharedAccessFilePolicy policy, final SharedAccessFileHeaders headers, final String groupPolicyIdentifier)
Devuelve una firma de acceso compartido para el archivo mediante el identificador de directiva de grupo y los encabezados de archivo de acceso compartido especificados. Tenga en cuenta que esto no contiene el "?". |
String |
generateSharedAccessSignature(final SharedAccessFilePolicy policy, final SharedAccessFileHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols)
Devuelve una firma de acceso compartido para el archivo mediante el identificador de directiva de grupo y los encabezados de archivo de acceso compartido especificados. Tenga en cuenta que esto no contiene el "?". |
String |
generateSharedAccessSignature(final SharedAccessFilePolicy policy, final String groupPolicyIdentifier)
Devuelve una firma de acceso compartido para el archivo mediante el identificador de directiva de grupo y los encabezados de archivo de acceso compartido especificados. Tenga en cuenta que esto no contiene el "?". |
Copy |
getCopyState()
Devuelve el estado de copia del archivo de Azure. |
final HashMap<String, String> |
getMetadata()
Devuelve los metadatos del archivo. |
final String |
getName()
Devuelve el nombre del archivo. |
final Cloud |
getParent()
Devuelve el elemento primario del elemento de archivo. |
String |
getParentNameFromURI(final StorageUri resourceAddress, final CloudFileShare share)
Recupera el nombre primario de un URI de archivo. |
final File |
getProperties()
Devuelve las propiedades del archivo. |
final Cloud |
getServiceClient()
Devuelve el cliente del servicio de archivos asociado al archivo. |
final Cloud |
getShare()
Devuelve el recurso compartido del archivo. |
final Storage |
getStorageUri()
Devuelve la lista de URI para todas las ubicaciones. |
final int |
getStreamMinimumReadSizeInBytes()
Devuelve el tamaño de lectura mínimo cuando se usa .FileInputStream |
final int |
getStreamWriteSizeInBytes()
Obtiene el número de bytes que se van a almacenar en búfer al escribir en un FileOutputStreamobjeto . |
final Storage |
getTransformedAddress(final OperationContext opContext)
Devuelve el URI transformado para el recurso si las credenciales especificadas requieren transformación. |
final URI |
getUri()
Devuelve el URI de este archivo. |
Iterable<File |
listHandles()
Obtiene los identificadores SMB abiertos en este archivo. |
Iterable<File |
listHandles(FileRequestOptions options, OperationContext opContext)
Obtiene los identificadores SMB abiertos en este archivo. |
Result |
listHandlesSegmented()
Obtiene los identificadores SMB abiertos en este archivo. |
Result |
listHandlesSegmented(final Integer maxResults, final ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext)
Obtiene los identificadores SMB abiertos en este archivo. |
final File |
openRead()
Abre un flujo de entrada de archivo para descargar el archivo. Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar el tamaño de lectura. |
final File |
openRead(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Abre un flujo de entrada de archivo para descargar el archivo mediante las opciones de solicitud y el contexto de operación especificados. Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar el tamaño de lectura. |
File |
openWriteExisting()
Abre un objeto de flujo de salida para escribir datos en el archivo. El archivo ya debe existir y se pueden sobrescribir los datos existentes. |
File |
openWriteExisting(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Abre un objeto de flujo de salida para escribir datos en el archivo, utilizando las opciones de solicitud y el contexto de operación especificados. El archivo ya debe existir y se pueden sobrescribir los datos existentes. |
File |
openWriteNew(final long length)
Abre un objeto de flujo de salida para escribir datos en el archivo. El archivo aún no existe y se creará con la longitud especificada. Si el archivo ya existe en el servicio, se sobrescribirá. Para evitar sobrescribir y, en su lugar, producir un error, use la openWriteNew(final long length, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) sobrecarga con el adecuado AccessCondition. |
File |
openWriteNew(final long length, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Abre un objeto de flujo de salida para escribir datos en el archivo mediante el identificador de concesión, las opciones de solicitud y el contexto de operación especificados. El archivo aún no necesita existir y se creará con la longitud especificada. Si el archivo ya existe en el servicio, se sobrescribirá. Para evitar sobrescribir y, en su lugar, producir un error, pase un AccessCondition generado mediante generateIfNotExistsCondition(). |
void |
putRangeFromURL(final long destOffset, final long length, final URI sourceUri, final long sourceOffset)
Carga un intervalo de un archivo a otro archivo. |
void |
putRangeFromURL(final long destOffset, final long length, final URI sourceUri, final long sourceOffset, FileRequestOptions options, OperationContext opContext)
Carga un intervalo de un archivo a otro mediante el identificador de concesión, las opciones de solicitud y el contexto de operación especificados. |
void |
resize(long size)
Cambia el tamaño del archivo al tamaño especificado. |
void |
resize(long size, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Cambia el tamaño del archivo al tamaño especificado. |
void |
setFilePermission(String filePermission)
Establece el permiso de archivo del archivo que se va a establecer. |
final void |
setMetadata(final HashMap<String, String> metadata)
Establece los metadatos del archivo. |
final void |
setProperties(final FileProperties properties)
Establece las propiedades del archivo. |
final void |
setShare(final CloudFileShare share)
Establece el recurso compartido del archivo. |
void |
setStorageUri(final StorageUri storageUri)
Establece la lista de URI para todas las ubicaciones. |
void |
setStreamMinimumReadSizeInBytes(final int minimumReadSize)
Establece el tamaño de lectura mínimo cuando se usa .FileInputStream |
void |
setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)
Establece el número de bytes que se van a almacenar en búfer al escribir en un FileOutputStream. |
final String |
startCopy(final CloudBlob sourceBlob)
Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un blob en un nuevo archivo. |
final String |
startCopy(final CloudBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un archivo nuevo mediante las condiciones de acceso, el identificador de concesión, las opciones de solicitud y el contexto de operación especificados. |
final String |
startCopy(final CloudFile sourceFile)
Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un archivo de Azure en un nuevo archivo de Azure. |
final String |
startCopy(final CloudFile sourceFile, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un archivo de Azure en un nuevo archivo de Azure, mediante las condiciones de acceso especificadas, el identificador de concesión, las opciones de solicitud y el contexto de la operación. |
final String |
startCopy(final URI source)
Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un URI en un nuevo archivo de Azure. |
final String |
startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un URI en un nuevo archivo de Azure mediante las condiciones de acceso especificadas, el identificador de concesión, las opciones de solicitud y el contexto de operación. |
void | updateEtagAndLastModifiedFromResponse(HttpURLConnection request) |
void | updateLengthFromResponse(HttpURLConnection request) |
void |
upload(final InputStream sourceStream, final long length)
Carga los datos del flujo de origen en el archivo. Si el archivo ya existe en el servicio, se sobrescribirá. |
void |
upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carga los datos del flujo de origen en el archivo mediante la condición de acceso, las opciones de solicitud y el contexto de operación especificados. Si el archivo ya existe en el servicio, se sobrescribirá. |
void |
uploadFromByteArray(final byte[] buffer, final int offset, final int length)
Carga un archivo de datos en una matriz de bytes. Si el archivo ya existe en el servicio, se sobrescribirá. |
void |
uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carga un archivo de datos en una matriz de bytes. Si el archivo ya existe en el servicio, se sobrescribirá. |
void |
uploadFromFile(final String path)
Carga un archivo local. Si el archivo ya existe en el servicio, se sobrescribirá. |
void |
uploadFromFile(final String path, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carga un archivo desde un archivo local. Si el archivo ya existe en el servicio, se sobrescribirá. |
final void |
uploadMetadata()
Carga los metadatos del archivo en el servicio de almacenamiento. Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del archivo del servicio de almacenamiento de Microsoft Azure. |
final void |
uploadMetadata(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carga los metadatos del archivo en el servicio de almacenamiento mediante la condición de acceso, las opciones de solicitud y el contexto de la operación. Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del archivo del servicio de almacenamiento de Microsoft Azure. |
final void |
uploadProperties()
Carga las propiedades del archivo en el servicio de almacenamiento. Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del archivo del servicio de almacenamiento de Microsoft Azure. |
final void |
uploadProperties(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carga las propiedades del archivo mediante la condición de acceso, las opciones de solicitud y el contexto de la operación. Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del archivo del servicio de almacenamiento de Microsoft Azure. |
void |
uploadRange(final InputStream sourceStream, final long offset, final long length)
Carga un intervalo en un archivo. |
void |
uploadRange(final InputStream sourceStream, final long offset, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carga un intervalo en un archivo mediante el identificador de concesión, las opciones de solicitud y el contexto de operación especificados. |
void |
uploadText(final String content)
Carga un archivo desde una cadena mediante la codificación predeterminada de la plataforma. Si el archivo ya existe en el servicio, se sobrescribirá. |
void |
uploadText(final String content, final String charsetName, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carga un archivo desde una cadena mediante la codificación especificada. Si el archivo ya existe en el servicio, se sobrescribirá. |
Detalles del campo
fileServiceClient
protected CloudFileClient fileServiceClient
Representa el cliente del servicio de archivos.
parent
protected CloudFileDirectory parent
Representa la referencia de directorio del archivo.
streamMinimumReadSizeInBytes
protected int streamMinimumReadSizeInBytes= Constants.DEFAULT_MINIMUM_READ_SIZE_IN_BYTES
Contiene el tamaño de lectura mínimo cuando se usa .FileInputStream
streamWriteSizeInBytes
protected int streamWriteSizeInBytes= Constants.DEFAULT_STREAM_WRITE_IN_BYTES
Contiene el número de bytes que se van a almacenar en búfer al escribir en .FileOutputStream
Detalles del constructor
CloudFile
public CloudFile(final CloudFile otherFile)
Crea una instancia de la clase copiando valores de otro archivo en la nube.
Parameters:
CloudFile
que representa el archivo que se va a copiar.
CloudFile
public CloudFile(final StorageUri fileAbsoluteUri)
Crea una instancia de la clase utilizando el storageUri absoluto especificado.
Parameters:
Throws:
CloudFile
public CloudFile(final StorageUri fileAbsoluteUri, final StorageCredentials credentials)
Crea una instancia de la clase con el storageUri y las credenciales absolutos especificados.
Parameters:
Throws:
CloudFile
protected CloudFile(final StorageUri uri, final String fileName, final CloudFileShare share)
Crea una instancia de la clase utilizando la dirección, el recurso compartido y el cliente especificados.
Parameters:
String
representa el nombre del archivo.
CloudFile
public CloudFile(final URI fileAbsoluteUri)
Crea una instancia de la clase utilizando el URI absoluto especificado.
Parameters:
java.net.URI
que representa el URI absoluto del archivo.
Throws:
CloudFile
public CloudFile(final URI fileAbsoluteUri, final StorageCredentials credentials)
Crea una instancia de la clase mediante el URI absoluto y las credenciales especificados.
Parameters:
java.net.URI
que representa el URI absoluto del archivo.
Throws:
Detalles del método
abortCopy
public final void abortCopy(final String copyId)
Anula una operación de copia de archivos de Azure en curso.
Parameters:
String
que identifica la operación de copia.
Throws:
abortCopy
public final void abortCopy(final String copyId, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Anula una operación de copia de archivos de Azure en curso.
Parameters:
String
que identifica la operación de copia.
null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
Throws:
assertValidFilePermissionOrKey
protected void assertValidFilePermissionOrKey()
Comprueba que el archivo del directorioPermission y properties.filePermissionKey no están establecidos.
clearRange
public void clearRange(final long offset, final long length)
Borra un intervalo de un archivo.
La llamada a libera el espacio de almacenamiento utilizado por el intervalo especificado. Ya no se realiza un seguimiento de los intervalos que se han borrado como parte del archivo.
Parameters:
Throws:
clearRange
public void clearRange(final long offset, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Borra un intervalo de un archivo mediante el identificador de concesión, las opciones de solicitud y el contexto de operación especificados.
La llamada a libera el espacio de almacenamiento utilizado por el intervalo especificado. Ya no se realiza un seguimiento de los intervalos que se han borrado como parte del archivo.
Parameters:
long
representa el desplazamiento, en bytes, en el que se va a empezar a borrar.
long
representa la longitud, en bytes, del intervalo de datos que se va a borrar.
null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
Throws:
closeAllHandlesSegmented
public ResultSegment
Cierre todos los identificadores de SMB en este archivo.
Returns:
Throws:
closeAllHandlesSegmented
public ResultSegment
Cierre todos los identificadores de SMB en este archivo.
Parameters:
null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
Returns:
Throws:
closeHandleSegmented
public ResultSegment
Cierre todos los identificadores de SMB en este archivo.
Parameters:
Returns:
Throws:
closeHandleSegmented
public ResultSegment
Cierre todos los identificadores de SMB en este archivo.
Parameters:
null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
Returns:
Throws:
create
public void create(final long size)
Crea un archivo. Si el archivo ya existe, esto lo reemplazará.
Parameters:
long
representa el tamaño, en bytes, del archivo.
Throws:
create
public void create(final long size, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Crea un archivo mediante la condición de acceso, las opciones de solicitud y el contexto de operación especificados. Si el archivo ya existe, esto lo reemplazará.
Parameters:
long
representa el tamaño, en bytes, del archivo.
null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
Throws:
delete
public final void delete()
Elimina el archivo.
Throws:
delete
public final void delete(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Elimina el archivo mediante la condición de acceso, las opciones de solicitud y el contexto de operación especificados.
Parameters:
null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
Throws:
deleteIfExists
public final boolean deleteIfExists()
Elimina el archivo si existe.
Returns:
true
si se eliminó el archivo; de lo contrario, false
.
Throws:
deleteIfExists
public final boolean deleteIfExists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Elimina el archivo si existe, utilizando la condición de acceso, las opciones de solicitud y el contexto de operación especificados.
Parameters:
null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
Returns:
true
si el archivo existía y se eliminó; Lo contrario false
Throws:
download
public final void download(final OutputStream outStream)
Descarga el contenido de un archivo en una secuencia.
Parameters:
OutputStream
que representa la secuencia de destino.
Throws:
download
public final void download(final OutputStream outStream, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Descarga el contenido de un archivo en una secuencia mediante las opciones de solicitud y el contexto de operación especificados.
Parameters:
OutputStream
que representa la secuencia de destino.
null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
Throws:
downloadAttributes
public final void downloadAttributes()
Rellena las propiedades y los metadatos de un archivo.
Este método rellena las propiedades del sistema del archivo y los metadatos definidos por el usuario. Antes de leer o modificar las propiedades o metadatos de un archivo, llame a este método o su sobrecarga para recuperar los valores más recientes de las propiedades y metadatos del archivo del servicio de almacenamiento de Microsoft Azure.
Throws:
downloadAttributes
public final void downloadAttributes(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Rellena las propiedades y los metadatos de un archivo mediante las opciones de solicitud y el contexto de operación especificados.
Este método rellena las propiedades del sistema del archivo y los metadatos definidos por el usuario. Antes de leer o modificar las propiedades o metadatos de un archivo, llame a este método o su sobrecarga para recuperar los valores más recientes de las propiedades y metadatos del archivo del servicio de almacenamiento de Microsoft Azure.
Parameters:
null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
Throws:
downloadFileRanges
public ArrayList
Devuelve una colección de intervalos de archivos y sus desplazamientos de bytes iniciales y finales.
Los desplazamientos de bytes inicial y final para cada intervalo de archivos son inclusivos.
Returns:
ArrayList
que representa el conjunto de intervalos de archivos y sus desplazamientos de bytes iniciales y finales.Throws:
downloadFileRanges
public ArrayList
Devuelve una colección de intervalos de archivos y sus desplazamientos de bytes iniciales y finales mediante las opciones de solicitud y el contexto de operación especificados.
Parameters:
null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
Returns:
ArrayList
que representa el conjunto de intervalos de archivos y sus desplazamientos de bytes iniciales y finales.Throws:
downloadRange
public final void downloadRange(final long offset, final Long length, final OutputStream outStream)
Descarga el contenido de un archivo en una secuencia.
Parameters:
long
representa el desplazamiento que se va a usar como punto de partida para el origen.
Long
representa el número de bytes que se van a leer o null
.
OutputStream
que representa la secuencia de destino.
Throws:
downloadRange
public final void downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Descarga el contenido de un archivo en una secuencia mediante las opciones de solicitud y el contexto de operación especificados.
Parameters:
long
representa el desplazamiento que se va a usar como punto de partida para el origen.
Long
representa el número de bytes que se van a leer o null
.
OutputStream
que representa la secuencia de destino.
null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( 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)
Descarga un intervalo de bytes del archivo al búfer de bytes especificado.
Parameters:
long
representa el desplazamiento dentro del archivo que se va a comenzar a descargar.
Long
representa el número de bytes que se van a leer.
byte
en la que se representa el búfer en el que se va a escribir.
int
representa el desplazamiento en el búfer de bytes para empezar a escribir.
Throws:
downloadRangeToByteArray
public final int downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset)
Descarga un intervalo de bytes del archivo al búfer de bytes especificado.
Parameters:
long
representa el desplazamiento de bytes que se va a usar como punto de partida para el origen.
Long
representa el número de bytes que se van a leer o null.
byte
que representa el búfer al que se descargan los bytes del archivo.
int
representa el desplazamiento de bytes que se va a usar como punto de partida para el destino.
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)
Descarga un intervalo de bytes desde el archivo hasta el búfer de bytes determinado mediante las opciones de solicitud y el contexto de operación especificados.
Parameters:
long
representa el desplazamiento de bytes que se va a usar como punto de partida para el origen.
Long
representa el número de bytes que se van a leer o null
.
byte
que representa el búfer al que se descargan los bytes del archivo.
int
representa el desplazamiento de bytes que se va a usar como punto de partida para el destino.
null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
Throws:
downloadText
public String downloadText()
Descarga un archivo en una cadena mediante la codificación predeterminada de la plataforma.
Returns:
String
representa el contenido del archivo.Throws:
downloadText
public String downloadText(final String charsetName, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Descarga un archivo en una cadena mediante la codificación especificada.
Parameters:
String
representa el nombre del conjunto de caracteres que se va a usar para codificar el contenido. Si es null, se usa la codificación predeterminada de la plataforma.
null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
Returns:
String
representa el contenido del archivo.Throws:
downloadToByteArray
public final int downloadToByteArray(final byte[] buffer, final int bufferOffset)
Descarga un intervalo de bytes del archivo al búfer de bytes especificado.
Parameters:
byte
que representa el búfer al que se descargan los bytes del archivo.
int
representa el desplazamiento de bytes que se va a usar como punto de partida para el destino.
Throws:
downloadToByteArray
public final int downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Descarga un intervalo de bytes desde el archivo hasta el búfer de bytes determinado mediante las opciones de solicitud y el contexto de operación especificados.
Parameters:
byte
que representa el búfer al que se descargan los bytes del archivo.
long
representa el desplazamiento de bytes que se va a usar como punto de partida para el destino.
null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
Throws:
downloadToFile
public void downloadToFile(final String path)
Descarga un archivo.
Parameters:
String
representa la ruta de acceso al archivo que se creará.
Throws:
downloadToFile
public void downloadToFile(final String path, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Descarga un archivo.
Parameters:
String
representa la ruta de acceso al archivo que se creará.
null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
Throws:
exists
public final boolean exists()
Comprueba si el archivo existe.
Returns:
true
es si el archivo existe; de lo contrario false
, es .
Throws:
exists
public final boolean exists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Comprueba si el archivo existe mediante la condición de acceso, las opciones de solicitud y el contexto de operación especificados.
Parameters:
null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
Returns:
true
es si el archivo existe; de lo contrario false
, es .
Throws:
generateSharedAccessSignature
public String generateSharedAccessSignature(final SharedAccessFilePolicy policy, final SharedAccessFileHeaders headers, final String groupPolicyIdentifier)
Devuelve una firma de acceso compartido para el archivo mediante el identificador de directiva de grupo y los encabezados de archivo de acceso compartido especificados. Tenga en cuenta que esto no contiene el "?".
Parameters:
SharedAccessFilePolicy
que representa la directiva de acceso para la firma de acceso compartido.
SharedAccessFileHeaders
que representa los valores de encabezado opcionales que se van a establecer para un archivo al que se accede con esta firma de acceso compartido.
String
representa la directiva de acceso de nivel de recurso compartido.
Returns:
String
representa la firma de acceso compartido.Throws:
generateSharedAccessSignature
public String generateSharedAccessSignature(final SharedAccessFilePolicy policy, final SharedAccessFileHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols)
Devuelve una firma de acceso compartido para el archivo mediante el identificador de directiva de grupo y los encabezados de archivo de acceso compartido especificados. Tenga en cuenta que esto no contiene el "?".
Parameters:
SharedAccessFilePolicy
que representa la directiva de acceso para la firma de acceso compartido.
SharedAccessFileHeaders
que representa los valores de encabezado opcionales que se van a establecer para un archivo al que se accede con esta firma de acceso compartido.
String
representa la directiva de acceso de nivel de recurso compartido.
Returns:
String
representa la firma de acceso compartido.Throws:
generateSharedAccessSignature
public String generateSharedAccessSignature(final SharedAccessFilePolicy policy, final String groupPolicyIdentifier)
Devuelve una firma de acceso compartido para el archivo mediante el identificador de directiva de grupo y los encabezados de archivo de acceso compartido especificados. Tenga en cuenta que esto no contiene el "?".
Parameters:
SharedAccessFilePolicy
que representa la directiva de acceso para la firma de acceso compartido.
String
representa la directiva de acceso de nivel de recurso compartido.
Returns:
String
representa la firma de acceso compartido.Throws:
getCopyState
public CopyState getCopyState()
Devuelve el estado de copia del archivo de Azure.
Returns:
getMetadata
public final HashMap
Devuelve los metadatos del archivo.
Returns:
java.util.HashMap
que representa los metadatos del archivo.getName
public final String getName()
Devuelve el nombre del archivo.
Returns:
String
representa el nombre del archivo.getParent
public final CloudFileDirectory getParent()
Devuelve el elemento primario del elemento de archivo.
Overrides:
CloudFile.getParent()Returns:
Throws:
getParentNameFromURI
protected static String getParentNameFromURI(final StorageUri resourceAddress, final CloudFileShare share)
Recupera el nombre primario de un URI de archivo.
Parameters:
Returns:
String
representa la dirección primaria de un URI de archivo.Throws:
getProperties
public final FileProperties getProperties()
Devuelve las propiedades del archivo.
Returns:
getServiceClient
public final CloudFileClient getServiceClient()
Devuelve el cliente del servicio de archivos asociado al archivo.
Returns:
getShare
public final CloudFileShare getShare()
Devuelve el recurso compartido del archivo.
Overrides:
CloudFile.getShare()Returns:
Throws:
getStorageUri
public final StorageUri getStorageUri()
Devuelve la lista de URI para todas las ubicaciones.
Overrides:
CloudFile.getStorageUri()Returns:
getStreamMinimumReadSizeInBytes
public final int getStreamMinimumReadSizeInBytes()
Devuelve el tamaño de lectura mínimo cuando se usa .FileInputStream
Returns:
int
representa el tamaño de lectura mínimo, en bytes, cuando se usa un FileInputStream objeto .getStreamWriteSizeInBytes
public final int getStreamWriteSizeInBytes()
Obtiene el número de bytes que se van a almacenar en búfer al escribir en un FileOutputStreamobjeto .
Returns:
int
representa el número de bytes que se van a almacenar en búfer.getTransformedAddress
protected final StorageUri getTransformedAddress(final OperationContext opContext)
Devuelve el URI transformado para el recurso si las credenciales especificadas requieren transformación.
Parameters:
Returns:
Throws:
getUri
public final URI getUri()
Devuelve el URI de este archivo.
Overrides:
CloudFile.getUri()Returns:
java.net.URI
que representa el URI del archivo.listHandles
public Iterable
Obtiene los identificadores SMB abiertos en este archivo.
Returns:
Uniterable
</code> of the handles that will lazily request new segments. </p>
listHandles
public Iterable listHandles(FileRequestOptions options, OperationContext opContext)
Obtiene los identificadores SMB abiertos en este archivo.
Parameters:
options
- Objeto FileRequestOptions que especifica las opciones adicionales de la solicitud. Al especificar null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
opContext
- Objeto OperationContext que representa el contexto de la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.
Returns:
Uniterable
</code> of the handles that will lazily request new segments. </p>
listHandlesSegmented
public ResultSegment listHandlesSegmented()
Obtiene los identificadores SMB abiertos en este archivo.
Returns:
Objeto ResultSegment<T> que contiene un segmento de la colección enumerable de ListFileItem objetos que representan los archivos y directorios.
Throws:
StorageException
listHandlesSegmented
public ResultSegment listHandlesSegmented(final Integer maxResults, final ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext)
Obtiene los identificadores SMB abiertos en este archivo.
Parameters:
maxResults
- Número máximo de resultados que se van a recuperar. Si null
o superior a 5000, el servidor devolverá hasta 5000 elementos. Debe ser 1 como mínimo.
continuationToken
- Objeto ResultContinuation que representa un token de continuación devuelto por una operación de lista anterior.
options
- Objeto FileRequestOptions que especifica las opciones adicionales de la solicitud. Al especificar null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
opContext
- Objeto OperationContext que representa el contexto de la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.
Returns:
Objeto ResultSegment<T> que contiene un segmento de la colección enumerable de ListFileItem objetos que representan los archivos y directorios.
Throws:
StorageException
openRead
public final FileInputStream openRead()
Abre un flujo de entrada de archivo para descargar el archivo.
Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar el tamaño de lectura.
Returns:
Objeto InputStream
que representa la secuencia que se va a usar para leer el archivo.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
openRead
public final FileInputStream openRead(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Abre un flujo de entrada de archivo para descargar el archivo mediante las opciones de solicitud y el contexto de operación especificados.
Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar el tamaño de lectura.
Parameters:
accessCondition
- Objeto AccessCondition que representa las condiciones de acceso para el archivo.
options
- Objeto FileRequestOptions que especifica las opciones adicionales para la solicitud. Al especificar null
se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
opContext
- Objeto OperationContext que representa el contexto para la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.
Returns:
Objeto InputStream
que representa la secuencia que se va a usar para leer el archivo.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
openWriteExisting
public FileOutputStream openWriteExisting()
Abre un objeto de flujo de salida para escribir datos en el archivo. El archivo ya debe existir y se pueden sobrescribir los datos existentes.
Returns:
Objeto FileOutputStream utilizado para escribir datos en el archivo.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
openWriteExisting
public FileOutputStream openWriteExisting(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Abre un objeto de flujo de salida para escribir datos en el archivo, utilizando las opciones de solicitud y el contexto de operación especificados. El archivo ya debe existir y se pueden sobrescribir los datos existentes.
Parameters:
accessCondition
- Objeto AccessCondition que representa las condiciones de acceso del archivo.
options
- Objeto FileRequestOptions que especifica las opciones adicionales para la solicitud. Al especificar null
se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
opContext
- Objeto OperationContext que representa el contexto de la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.
Returns:
Objeto FileOutputStream utilizado para escribir datos en el archivo.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
openWriteNew
public FileOutputStream openWriteNew(final long length)
Abre un objeto de flujo de salida para escribir datos en el archivo. El archivo aún no existe y se creará con la longitud especificada. Si el archivo ya existe en el servicio, se sobrescribirá.
Para evitar sobrescribir y, en su lugar, producir un error, use la openWriteNew(final long length, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) sobrecarga con el adecuado AccessCondition.
Parameters:
length
- que long
representa la longitud, en bytes, de la secuencia que se va a crear.
Returns:
Objeto FileOutputStream utilizado para escribir datos en el archivo.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
openWriteNew
public FileOutputStream openWriteNew(final long length, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Abre un objeto de flujo de salida para escribir datos en el archivo mediante el identificador de concesión, las opciones de solicitud y el contexto de operación especificados. El archivo aún no necesita existir y se creará con la longitud especificada. Si el archivo ya existe en el servicio, se sobrescribirá.
Para evitar sobrescribir y, en su lugar, producir un error, pase un AccessCondition generado mediante generateIfNotExistsCondition().
Parameters:
length
- que long
representa la longitud, en bytes, de la secuencia que se va a crear.
accessCondition
- Objeto AccessCondition que representa las condiciones de acceso del archivo.
options
- Objeto FileRequestOptions que especifica las opciones adicionales para la solicitud. Al especificar null
se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
opContext
- Objeto OperationContext que representa el contexto de la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.
Returns:
Objeto FileOutputStream utilizado para escribir datos en el archivo.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
putRangeFromURL
public void putRangeFromURL(final long destOffset, final long length, final URI sourceUri, final long sourceOffset)
Carga un intervalo de un archivo a otro archivo.
Parameters:
destOffset
- que long
representa el desplazamiento, en número de bytes, en el que se comienzan a escribir los datos.
length
- que long
representa la longitud, en bytes, de los datos que se van a escribir y leer.
sourceUri
- Objeto java.net.URI
que especifica el URI de origen.
sourceOffset
- que long
representa el desplazamiento, en número de bytes, en el que se comienzan a leer los datos.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
putRangeFromURL
public void putRangeFromURL(final long destOffset, final long length, final URI sourceUri, final long sourceOffset, FileRequestOptions options, OperationContext opContext)
Carga un intervalo de un archivo a otro mediante el identificador de concesión, las opciones de solicitud y el contexto de operación especificados.
Parameters:
destOffset
- que long
representa el desplazamiento, en número de bytes, en el que se comienzan a escribir los datos.
length
- que long
representa la longitud, en bytes, de los datos que se van a escribir y leer.
sourceUri
- Objeto java.net.URI
que especifica el URI de origen.
sourceOffset
- que long
representa el desplazamiento, en número de bytes, en el que se comienzan a leer los datos.
options
- Objeto FileRequestOptions que especifica las opciones adicionales para la solicitud. Al especificar null
se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
opContext
- Objeto OperationContext que representa el contexto de la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
resize
public void resize(long size)
Cambia el tamaño del archivo al tamaño especificado.
Parameters:
size
- que long
representa el tamaño del archivo, en bytes.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
resize
public void resize(long size, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Cambia el tamaño del archivo al tamaño especificado.
Parameters:
size
- que long
representa el tamaño del archivo, en bytes.
accessCondition
- Objeto AccessCondition que representa las condiciones de acceso del archivo.
options
- Objeto FileRequestOptions que especifica las opciones adicionales para la solicitud. Al especificar null
se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
opContext
- Objeto OperationContext que representa el contexto de la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
setFilePermission
public void setFilePermission(String filePermission)
Establece el permiso de archivo del archivo que se va a establecer.
Parameters:
filePermission
- que String
representa el permiso de archivo del archivo que se va a establecer.
setMetadata
public final void setMetadata(final HashMap metadata)
Establece los metadatos del archivo.
Parameters:
metadata
- Objeto java.util.HashMap
que contiene los metadatos que se asignan al archivo.
setProperties
protected final void setProperties(final FileProperties properties)
Establece las propiedades del archivo.
Parameters:
properties
- Objeto FileProperties que representa las propiedades que se asignan al archivo.
setShare
protected final void setShare(final CloudFileShare share)
Establece el recurso compartido del archivo.
Parameters:
share
- Objeto CloudFileShare que representa el recurso compartido que se asigna al archivo.
setStorageUri
protected void setStorageUri(final StorageUri storageUri)
Establece la lista de URI para todas las ubicaciones.
Parameters:
storageUri
- que StorageUri representa la lista de URI de todas las ubicaciones.
setStreamMinimumReadSizeInBytes
public void setStreamMinimumReadSizeInBytes(final int minimumReadSize)
Establece el tamaño de lectura mínimo cuando se usa .FileInputStream
Parameters:
minimumReadSize
- que int
representa el número mínimo de bytes que se van a almacenar en búfer al leer desde un archivo mientras se usa un FileInputStream objeto . Debe ser mayor o igual que 16 KB.
Throws:
IllegalArgumentException
- Si minimumReadSize
es inferior a 16 KB.
setStreamWriteSizeInBytes
public void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)
Establece el número de bytes que se van a almacenar en búfer al escribir en un FileOutputStream.
Parameters:
streamWriteSizeInBytes
- que int
representa el número de bytes que se van a almacenar en búfer mientras se usa un FileOutputStream objeto , que va de 512 bytes a 4 MB, ambos incluidos.
Throws:
IllegalArgumentException
- Si streamWriteSizeInBytes
es menor que 512 bytes o superior a 4 MB.
startCopy
public final String startCopy(final CloudBlob sourceBlob)
Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un blob en un nuevo archivo.
Parameters:
sourceBlob
- Objeto CloudBlob
que representa el blob de origen que se va a copiar.
Returns:
que String
representa el identificador de copia asociado a la operación de copia.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
startCopy
public final String startCopy(final CloudBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un archivo nuevo mediante las condiciones de acceso, el identificador de concesión, las opciones de solicitud y el contexto de operación especificados.
Parameters:
sourceBlob
- Objeto CloudBlob
que representa el blob de origen que se va a copiar.
sourceAccessCondition
- Objeto AccessCondition que representa las condiciones de acceso del blob de origen.
destinationAccessCondition
- Objeto AccessCondition que representa las condiciones de acceso del archivo de destino.
options
- Objeto BlobRequestOptions que especifica las opciones adicionales para la solicitud. Al especificar null
se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado (CloudBlobClient).
opContext
- Objeto OperationContext que representa el contexto para la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.
Returns:
que String
representa el identificador de copia asociado a la operación de copia.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
startCopy
public final String startCopy(final CloudFile sourceFile)
Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un archivo de Azure en un nuevo archivo de Azure.
Parameters:
sourceFile
- Objeto CloudFile
que representa el archivo de Azure de origen que se va a copiar.
Returns:
que String
representa el identificador de copia asociado a la operación de copia.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
startCopy
public final String startCopy(final CloudFile sourceFile, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un archivo de Azure en un nuevo archivo de Azure, mediante las condiciones de acceso especificadas, el identificador de concesión, las opciones de solicitud y el contexto de la operación.
Parameters:
sourceFile
- Objeto CloudFile
que representa el archivo de origen que se va a copiar.
sourceAccessCondition
- Objeto AccessCondition que representa las condiciones de acceso del origen.
destinationAccessCondition
- Objeto AccessCondition que representa las condiciones de acceso para el destino.
options
- Objeto FileRequestOptions que especifica las opciones adicionales de la solicitud. Al especificar null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado (CloudFileClient).
opContext
- Objeto OperationContext que representa el contexto para la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.
Returns:
que String
representa el identificador de copia asociado a la operación de copia.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
startCopy
public final String startCopy(final URI source)
Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un URI en un nuevo archivo de Azure.
Parameters:
source
- El origen es java.net.URI
.
Returns:
que String
representa el identificador de copia asociado a la operación de copia.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
startCopy
public final String startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Solicita al servicio que empiece a copiar el contenido, las propiedades y los metadatos de un URI en un nuevo archivo de Azure mediante las condiciones de acceso especificadas, el identificador de concesión, las opciones de solicitud y el contexto de operación.
Parameters:
source
- El origen es java.net.URI
.
sourceAccessCondition
- Objeto AccessCondition que representa las condiciones de acceso del origen.
destinationAccessCondition
- Objeto AccessCondition que representa las condiciones de acceso para el destino.
options
- Objeto FileRequestOptions que especifica las opciones adicionales de la solicitud. Al especificar null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado (CloudFileClient).
opContext
- Objeto OperationContext que representa el contexto para la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.
Returns:
que String
representa el identificador de copia asociado a la operación de copia.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
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)
Carga los datos del flujo de origen en el archivo. Si el archivo ya existe en el servicio, se sobrescribirá.
Parameters:
sourceStream
- Objeto InputStream del que se va a leer.
length
- que long
representa la longitud, en bytes, de los datos de flujo. Debe ser distinto de cero.
Throws:
IOException
- Si se ha producido una excepción de E/S.
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
upload
public void upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carga los datos del flujo de origen en el archivo mediante la condición de acceso, las opciones de solicitud y el contexto de operación especificados. Si el archivo ya existe en el servicio, se sobrescribirá.
Parameters:
sourceStream
- Objeto InputStream del que se va a leer.
length
- que long
representa la longitud, en bytes, de los datos de flujo. Debe ser mayor o igual que cero.
accessCondition
- Objeto AccessCondition que representa las condiciones de acceso del archivo.
options
- Objeto FileRequestOptions que especifica las opciones adicionales de la solicitud. Al especificar null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
opContext
- Objeto OperationContext que representa el contexto de la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.
Throws:
IOException
- Si se ha producido una excepción de E/S.
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
uploadFromByteArray
public void uploadFromByteArray(final byte[] buffer, final int offset, final int length)
Carga un archivo de datos en una matriz de bytes. Si el archivo ya existe en el servicio, se sobrescribirá.
Parameters:
buffer
- Matriz byte
que representa los datos que se van a escribir en el archivo.
offset
- que int
representa el desplazamiento de la matriz de bytes desde la que se inicia la carga de datos.
length
- que int
representa el número de bytes que se van a cargar desde el búfer de entrada.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
IOException
URISyntaxException
uploadFromByteArray
public void uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carga un archivo de datos en una matriz de bytes. Si el archivo ya existe en el servicio, se sobrescribirá.
Parameters:
buffer
- Matriz byte
que representa los datos que se van a escribir en el archivo.
offset
- que int
representa el desplazamiento de la matriz de bytes desde la que se inicia la carga de datos.
length
- que int
representa el número de bytes que se van a cargar desde el búfer de entrada.
accessCondition
- Objeto AccessCondition que representa las condiciones de acceso para el archivo.
options
- Objeto FileRequestOptions que especifica las opciones adicionales de la solicitud. Al especificar null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
opContext
- Objeto OperationContext que representa el contexto para la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
IOException
URISyntaxException
uploadFromFile
public void uploadFromFile(final String path)
Carga un archivo local. Si el archivo ya existe en el servicio, se sobrescribirá.
Parameters:
path
- que String
representa la ruta de acceso al archivo que se va a cargar.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
IOException
URISyntaxException
uploadFromFile
public void uploadFromFile(final String path, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carga un archivo desde un archivo local. Si el archivo ya existe en el servicio, se sobrescribirá.
Parameters:
path
- que String
representa la ruta de acceso al archivo que se va a cargar.
accessCondition
- Objeto AccessCondition que representa las condiciones de acceso para el archivo.
options
- Objeto FileRequestOptions que especifica las opciones adicionales de la solicitud. Al especificar null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
opContext
- Objeto OperationContext que representa el contexto para la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
IOException
URISyntaxException
uploadMetadata
public final void uploadMetadata()
Carga los metadatos del archivo en el servicio de almacenamiento.
Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del archivo del servicio de almacenamiento de Microsoft Azure.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
uploadMetadata
public final void uploadMetadata(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carga los metadatos del archivo en el servicio de almacenamiento mediante la condición de acceso, las opciones de solicitud y el contexto de la operación.
Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del archivo del servicio de almacenamiento de Microsoft Azure.
Parameters:
accessCondition
- Objeto AccessCondition que representa las condiciones de acceso para el archivo.
options
- Objeto FileRequestOptions que especifica las opciones adicionales de la solicitud. Al especificar null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
opContext
- Objeto OperationContext que representa el contexto para la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
uploadProperties
public final void uploadProperties()
Carga las propiedades del archivo en el servicio de almacenamiento.
Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del archivo del servicio de almacenamiento de Microsoft Azure.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
uploadProperties
public final void uploadProperties(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carga las propiedades del archivo mediante la condición de acceso, las opciones de solicitud y el contexto de la operación.
Use downloadAttributes() para recuperar los valores más recientes de las propiedades y metadatos del archivo del servicio de almacenamiento de Microsoft Azure.
Parameters:
accessCondition
- Objeto AccessCondition que representa las condiciones de acceso para el archivo.
options
- Objeto FileRequestOptions que especifica las opciones adicionales de la solicitud. Al especificar null
, se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
opContext
- Objeto OperationContext que representa el contexto para la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
uploadRange
public void uploadRange(final InputStream sourceStream, final long offset, final long length)
Carga un intervalo en un archivo.
Parameters:
sourceStream
- Objeto InputStream que representa el flujo de entrada que se va a escribir en el archivo.
offset
- que long
representa el desplazamiento, en número de bytes, en el que se comienzan a escribir los datos.
length
- que long
representa la longitud, en bytes, de los datos que se van a escribir.
Throws:
IOException
- Si se ha producido una excepción de E/S.
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
uploadRange
public void uploadRange(final InputStream sourceStream, final long offset, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carga un intervalo en un archivo mediante el identificador de concesión, las opciones de solicitud y el contexto de operación especificados.
Parameters:
sourceStream
- Objeto InputStream que representa el flujo de entrada que se va a escribir en el archivo.
offset
- que long
representa el desplazamiento, en número de bytes, en el que se comienzan a escribir los datos.
length
- que long
representa la longitud, en bytes, de los datos que se van a escribir.
accessCondition
- Objeto AccessCondition que representa las condiciones de acceso del archivo.
options
- Objeto FileRequestOptions que especifica las opciones adicionales para la solicitud. Al especificar null
se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
opContext
- Objeto OperationContext que representa el contexto de la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.
Throws:
IOException
- Si se ha producido una excepción de E/S.
StorageException
- Si se produjo un error en el servicio de almacenamiento.
URISyntaxException
uploadText
public void uploadText(final String content)
Carga un archivo desde una cadena mediante la codificación predeterminada de la plataforma. Si el archivo ya existe en el servicio, se sobrescribirá.
Parameters:
content
- que String
representa el contenido que se cargará en el archivo.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
IOException
URISyntaxException
uploadText
public void uploadText(final String content, final String charsetName, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carga un archivo desde una cadena mediante la codificación especificada. Si el archivo ya existe en el servicio, se sobrescribirá.
Parameters:
content
- que String
representa el contenido que se cargará en el archivo.
charsetName
- que String
representa el nombre del conjunto de caracteres que se va a usar para codificar el contenido. Si es null, se usa la codificación predeterminada de la plataforma.
accessCondition
- Objeto AccessCondition que representa las condiciones de acceso para el archivo.
options
- Objeto FileRequestOptions que especifica las opciones adicionales para la solicitud. Al especificar null
se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudFileClient).
opContext
- Objeto OperationContext que representa el contexto para la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.
Throws:
StorageException
- Si se produjo un error en el servicio de almacenamiento.
IOException
URISyntaxException
Se aplica a
Azure SDK for Java