CloudFile Classe
- java.
lang. Object - ListFileItem
- com.
microsoft. azure. storage. file. CloudFile
- com.
public class CloudFile implements ListFileItem
Representa um Arquivo do Microsoft Azure.
Resumo do campo
Modificador e tipo | Campo e descrição |
---|---|
Cloud |
fileServiceClient
Representa o cliente do serviço de arquivo. |
Cloud |
parent
Representa a referência de diretório do arquivo. |
int |
streamMinimumReadSizeInBytes
Mantém o tamanho mínimo de leitura ao usar um FileInputStream. |
int |
streamWriteSizeInBytes
Mantém o número de bytes a serem armazenados em buffer ao gravar em um FileOutputStream. |
Resumo do Construtor
Construtor | Description |
---|---|
CloudFile(final CloudFile otherFile) |
Cria uma instância da classe copiando valores de outro arquivo de nuvem. |
CloudFile(final StorageUri fileAbsoluteUri) |
Cria uma instância da classe usando o StorageUri absoluto especificado. |
CloudFile(final StorageUri fileAbsoluteUri, final StorageCredentials credentials) |
Cria uma instância da classe usando o StorageUri absoluto e as credenciais especificados. |
CloudFile(final StorageUri uri, final String fileName, final CloudFileShare share) |
Cria uma instância da classe usando o endereço, o compartilhamento e o cliente especificados. |
CloudFile(final URI fileAbsoluteUri) |
Cria uma instância da classe usando o URI absoluto especificado. |
CloudFile(final URI fileAbsoluteUri, final StorageCredentials credentials) |
Cria uma instância da classe usando o URI absoluto e as credenciais especificados. |
Resumo do método
Modificador e tipo | Método e descrição |
---|---|
final void |
abortCopy(final String copyId)
Anula uma operação de cópia de Arquivo do Azure em andamento. |
final void |
abortCopy(final String copyId, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Anula uma operação de cópia de Arquivo do Azure em andamento. |
void |
assertValidFilePermissionOrKey()
Verifica se filePermission e properties.filePermissionKey do diretório não estão definidos. |
void |
clearRange(final long offset, final long length)
Limpa um intervalo de um arquivo. A chamada libera o espaço de armazenamento usado pelo intervalo especificado. Os intervalos que foram limpos não são mais rastreados como parte do arquivo. |
void |
clearRange(final long offset, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Limpa um intervalo de um arquivo usando a ID de concessão, as opções de solicitação e o contexto de operação especificados. A chamada libera o espaço de armazenamento usado pelo intervalo especificado. Os intervalos que foram limpos não são mais rastreados como parte do arquivo. |
Result |
closeAllHandlesSegmented()
Feche todos os identificadores SMB neste arquivo. |
Result |
closeAllHandlesSegmented(final ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext)
Feche todos os identificadores SMB neste arquivo. |
Result |
closeHandleSegmented(String handleID)
Feche todos os identificadores SMB neste arquivo. |
Result |
closeHandleSegmented(String handleID, ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext)
Feche todos os identificadores SMB neste arquivo. |
void |
create(final long size)
Cria um arquivo. Se o arquivo já existir, isso o substituirá. |
void |
create(final long size, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Cria um arquivo usando a condição de acesso especificada, as opções de solicitação e o contexto de operação. Se o arquivo já existir, isso o substituirá. |
final void |
delete()
Exclui o arquivo. |
final void |
delete(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Exclui o arquivo usando a condição de acesso, as opções de solicitação e o contexto de operação especificados. |
final boolean |
deleteIfExists()
Exclui o arquivo se ele existir. |
final boolean |
deleteIfExists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Exclui o arquivo se ele existir, usando a condição de acesso, as opções de solicitação e o contexto de operação especificados. |
final void |
download(final OutputStream outStream)
Baixa o conteúdo de um arquivo em um fluxo. |
final void |
download(final OutputStream outStream, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Baixa o conteúdo de um arquivo em um fluxo usando as opções de solicitação e o contexto de operação especificados. |
final void |
downloadAttributes()
Popula as propriedades e os metadados de um arquivo. Esse método preenche as propriedades do sistema do arquivo e os metadados definidos pelo usuário. Antes de ler ou modificar as propriedades ou metadados de um arquivo, chame esse método ou sua sobrecarga para recuperar os valores mais recentes para as propriedades e metadados do arquivo do serviço de armazenamento do Microsoft Azure. |
final void |
downloadAttributes(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Preenche as propriedades e os metadados de um arquivo usando as opções de solicitação e o contexto de operação especificados. Esse método preenche as propriedades do sistema do arquivo e os metadados definidos pelo usuário. Antes de ler ou modificar as propriedades ou metadados de um arquivo, chame esse método ou sua sobrecarga para recuperar os valores mais recentes para as propriedades e metadados do arquivo do serviço de armazenamento do Microsoft Azure. |
ArrayList<File |
downloadFileRanges()
Retorna uma coleção de intervalos de arquivos e seus deslocamentos de bytes inicial e final. Os deslocamentos de bytes inicial e final para cada intervalo de arquivos são inclusivos. |
ArrayList<File |
downloadFileRanges(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Retorna uma coleção de intervalos de arquivos e seus deslocamentos de bytes inicial e final usando as opções de solicitação e o contexto de operação especificados. |
final void |
downloadRange(final long offset, final Long length, final OutputStream outStream)
Baixa o conteúdo de um arquivo em um fluxo. |
final void |
downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Baixa o conteúdo de um arquivo em um fluxo usando as opções de solicitação e o contexto de operação especificados. |
final int |
downloadRangeInternal(final long fileOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Baixa um intervalo de bytes do arquivo para o buffer de bytes fornecido. |
final int |
downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset)
Baixa um intervalo de bytes do arquivo para o buffer de bytes fornecido. |
final int |
downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Baixa um intervalo de bytes do arquivo para o buffer de bytes fornecido, usando as opções de solicitação e o contexto de operação especificados. |
String |
downloadText()
Baixa um arquivo em uma cadeia de caracteres usando a codificação padrão da plataforma. |
String |
downloadText(final String charsetName, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Baixa um arquivo em uma cadeia de caracteres usando a codificação especificada. |
final int |
downloadToByteArray(final byte[] buffer, final int bufferOffset)
Baixa um intervalo de bytes do arquivo para o buffer de bytes fornecido. |
final int |
downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Baixa um intervalo de bytes do arquivo para o buffer de bytes fornecido, usando as opções de solicitação e o contexto de operação especificados. |
void |
downloadToFile(final String path)
Baixa um arquivo. |
void |
downloadToFile(final String path, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Baixa um arquivo. |
final boolean |
exists()
Verifica se o arquivo existe. |
final boolean |
exists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Verifica se o arquivo existe, usando a condição de acesso especificada, as opções de solicitação e o contexto de operação. |
String |
generateSharedAccessSignature(final SharedAccessFilePolicy policy, final SharedAccessFileHeaders headers, final String groupPolicyIdentifier)
Retorna uma assinatura de acesso compartilhado para o arquivo usando o identificador de política de grupo especificado e os cabeçalhos de arquivo de acesso compartilhado. Observe que isso não contém o "?". |
String |
generateSharedAccessSignature(final SharedAccessFilePolicy policy, final SharedAccessFileHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols)
Retorna uma assinatura de acesso compartilhado para o arquivo usando o identificador de política de grupo especificado e os cabeçalhos de arquivo de acesso compartilhado. Observe que isso não contém o "?". |
String |
generateSharedAccessSignature(final SharedAccessFilePolicy policy, final String groupPolicyIdentifier)
Retorna uma assinatura de acesso compartilhado para o arquivo usando o identificador de política de grupo especificado e os cabeçalhos de arquivo de acesso compartilhado. Observe que isso não contém o "?". |
Copy |
getCopyState()
Retorna o estado de cópia do Arquivo do Azure. |
final HashMap<String, String> |
getMetadata()
Retorna os metadados do arquivo. |
final String |
getName()
Retorna o nome do arquivo. |
final Cloud |
getParent()
Retorna o pai do item de arquivo. |
String |
getParentNameFromURI(final StorageUri resourceAddress, final CloudFileShare share)
Recupera o nome pai de um URI de arquivo. |
final File |
getProperties()
Retorna as propriedades do arquivo. |
final Cloud |
getServiceClient()
Retorna o cliente de serviço de arquivo associado ao arquivo. |
final Cloud |
getShare()
Retorna o compartilhamento do arquivo. |
final Storage |
getStorageUri()
Retorna a lista de URIs para todos os locais. |
final int |
getStreamMinimumReadSizeInBytes()
Retorna o tamanho mínimo de leitura ao usar um FileInputStream. |
final int |
getStreamWriteSizeInBytes()
Obtém o número de bytes a serem armazenados em buffer ao gravar em um FileOutputStream. |
final Storage |
getTransformedAddress(final OperationContext opContext)
Retorna o URI transformado para o recurso se as credenciais fornecidas exigirem transformação. |
final URI |
getUri()
Retorna o URI desse arquivo. |
Iterable<File |
listHandles()
Obtém os identificadores SMB abertos neste arquivo. |
Iterable<File |
listHandles(FileRequestOptions options, OperationContext opContext)
Obtém os identificadores SMB abertos neste arquivo. |
Result |
listHandlesSegmented()
Obtém os identificadores SMB abertos neste arquivo. |
Result |
listHandlesSegmented(final Integer maxResults, final ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext)
Obtém os identificadores SMB abertos neste arquivo. |
final File |
openRead()
Abre um fluxo de entrada de arquivo para baixar o arquivo. Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar o tamanho de leitura. |
final File |
openRead(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Abre um fluxo de entrada de arquivo para baixar o arquivo usando as opções de solicitação e o contexto de operação especificados. Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar o tamanho de leitura. |
File |
openWriteExisting()
Abre um objeto de fluxo de saída para gravar dados no arquivo. O arquivo já deve existir e todos os dados existentes podem ser substituídos. |
File |
openWriteExisting(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Abre um objeto de fluxo de saída para gravar dados no arquivo, usando opções de solicitação e contexto de operação especificados. O arquivo já deve existir e todos os dados existentes podem ser substituídos. |
File |
openWriteNew(final long length)
Abre um objeto de fluxo de saída para gravar dados no arquivo. O arquivo ainda não existe e será criado com o comprimento especificado. Se o arquivo já existir no serviço, ele será substituído. Para evitar a substituição e, em vez disso, gerar um erro, use a openWriteNew(final long length, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) sobrecarga com o apropriado AccessCondition. |
File |
openWriteNew(final long length, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Abre um objeto de fluxo de saída para gravar dados no arquivo, usando a ID de concessão especificada, as opções de solicitação e o contexto de operação. O arquivo ainda não precisa existir e será criado com o comprimento especificado. Se o arquivo já existir no serviço, ele será substituído. Para evitar a substituição e, em vez disso, gerar um erro, passe um AccessCondition gerado usando generateIfNotExistsCondition(). |
void |
putRangeFromURL(final long destOffset, final long length, final URI sourceUri, final long sourceOffset)
Carrega um intervalo de um arquivo para outro. |
void |
putRangeFromURL(final long destOffset, final long length, final URI sourceUri, final long sourceOffset, FileRequestOptions options, OperationContext opContext)
Carrega um intervalo de um arquivo para outro usando a ID de concessão, as opções de solicitação e o contexto de operação especificados |
void |
resize(long size)
Redimensiona o arquivo para o tamanho especificado. |
void |
resize(long size, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Redimensiona o arquivo para o tamanho especificado. |
void |
setFilePermission(String filePermission)
Define a permissão de arquivo do arquivo a ser definida |
final void |
setMetadata(final HashMap<String, String> metadata)
Define os metadados do arquivo. |
final void |
setProperties(final FileProperties properties)
Define as propriedades do arquivo. |
final void |
setShare(final CloudFileShare share)
Define o compartilhamento do arquivo. |
void |
setStorageUri(final StorageUri storageUri)
Define a lista de URIs para todos os locais. |
void |
setStreamMinimumReadSizeInBytes(final int minimumReadSize)
Define o tamanho mínimo de leitura ao usar um FileInputStream. |
void |
setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)
Define o número de bytes a serem armazenados em buffer ao gravar em um FileOutputStream. |
final String |
startCopy(final CloudBlob sourceBlob)
Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um blob para um novo arquivo. |
final String |
startCopy(final CloudBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um arquivo para um novo arquivo, usando as condições de acesso, a ID de concessão, as opções de solicitação e o contexto de operação especificados. |
final String |
startCopy(final CloudFile sourceFile)
Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um Arquivo do Azure para um novo Arquivo do Azure. |
final String |
startCopy(final CloudFile sourceFile, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um Arquivo do Azure para um novo Arquivo do Azure, usando as condições de acesso, a ID de concessão, as opções de solicitação e o contexto de operação especificados. |
final String |
startCopy(final URI source)
Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um URI para um novo Arquivo do Azure. |
final String |
startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um URI para um novo Arquivo do Azure, usando as condições de acesso, a ID de concessão, as opções de solicitação e o contexto de operação especificados. |
void | updateEtagAndLastModifiedFromResponse(HttpURLConnection request) |
void | updateLengthFromResponse(HttpURLConnection request) |
void |
upload(final InputStream sourceStream, final long length)
Carrega os dados do fluxo de origem no arquivo. Se o arquivo já existir no serviço, ele será substituído. |
void |
upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carrega os dados de fluxo de origem no arquivo usando a condição de acesso, as opções de solicitação e o contexto de operação especificados. Se o arquivo já existir no serviço, ele será substituído. |
void |
uploadFromByteArray(final byte[] buffer, final int offset, final int length)
Carrega um arquivo de dados em uma matriz de bytes. Se o arquivo já existir no serviço, ele será substituído. |
void |
uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carrega um arquivo de dados em uma matriz de bytes. Se o arquivo já existir no serviço, ele será substituído. |
void |
uploadFromFile(final String path)
Carrega um arquivo local. Se o arquivo já existir no serviço, ele será substituído. |
void |
uploadFromFile(final String path, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carrega um arquivo de um arquivo local. Se o arquivo já existir no serviço, ele será substituído. |
final void |
uploadMetadata()
Carrega os metadados do arquivo para o serviço de armazenamento. Use downloadAttributes() para recuperar os valores mais recentes para as propriedades e metadados do arquivo do serviço de armazenamento do Microsoft Azure. |
final void |
uploadMetadata(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carrega os metadados do arquivo para o serviço de armazenamento usando a condição de acesso, as opções de solicitação e o contexto de operação. Use downloadAttributes() para recuperar os valores mais recentes para as propriedades e metadados do arquivo do serviço de armazenamento do Microsoft Azure. |
final void |
uploadProperties()
Carrega as propriedades do arquivo no serviço de armazenamento. Use downloadAttributes() para recuperar os valores mais recentes para as propriedades e metadados do arquivo do serviço de armazenamento do Microsoft Azure. |
final void |
uploadProperties(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carrega as propriedades do arquivo usando a condição de acesso, as opções de solicitação e o contexto de operação. Use downloadAttributes() para recuperar os valores mais recentes para as propriedades e metadados do arquivo do serviço de armazenamento do Microsoft Azure. |
void |
uploadRange(final InputStream sourceStream, final long offset, final long length)
Carrega um intervalo em um arquivo. |
void |
uploadRange(final InputStream sourceStream, final long offset, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carrega um intervalo em um arquivo usando a ID de concessão especificada, as opções de solicitação e o contexto de operação. |
void |
uploadText(final String content)
Carrega um arquivo de uma cadeia de caracteres usando a codificação padrão da plataforma. Se o arquivo já existir no serviço, ele será substituído. |
void |
uploadText(final String content, final String charsetName, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carrega um arquivo de uma cadeia de caracteres usando a codificação especificada. Se o arquivo já existir no serviço, ele será substituído. |
Detalhes do campo
fileServiceClient
protected CloudFileClient fileServiceClient
Representa o cliente do serviço de arquivo.
parent
protected CloudFileDirectory parent
Representa a referência de diretório do arquivo.
streamMinimumReadSizeInBytes
protected int streamMinimumReadSizeInBytes= Constants.DEFAULT_MINIMUM_READ_SIZE_IN_BYTES
Mantém o tamanho mínimo de leitura ao usar um FileInputStream.
streamWriteSizeInBytes
protected int streamWriteSizeInBytes= Constants.DEFAULT_STREAM_WRITE_IN_BYTES
Mantém o número de bytes a serem armazenados em buffer ao gravar em um FileOutputStream.
Detalhes do construtor
CloudFile
public CloudFile(final CloudFile otherFile)
Cria uma instância da classe copiando valores de outro arquivo de nuvem.
Parameters:
CloudFile
objeto que representa o arquivo a ser copiado.
CloudFile
public CloudFile(final StorageUri fileAbsoluteUri)
Cria uma instância da classe usando o StorageUri absoluto especificado.
Parameters:
Throws:
CloudFile
public CloudFile(final StorageUri fileAbsoluteUri, final StorageCredentials credentials)
Cria uma instância da classe usando o StorageUri absoluto e as credenciais especificados.
Parameters:
Throws:
CloudFile
protected CloudFile(final StorageUri uri, final String fileName, final CloudFileShare share)
Cria uma instância da classe usando o endereço, o compartilhamento e o cliente especificados.
Parameters:
String
que representa o nome do arquivo.
CloudFile
public CloudFile(final URI fileAbsoluteUri)
Cria uma instância da classe usando o URI absoluto especificado.
Parameters:
java.net.URI
objeto que representa o URI absoluto para o arquivo.
Throws:
CloudFile
public CloudFile(final URI fileAbsoluteUri, final StorageCredentials credentials)
Cria uma instância da classe usando o URI absoluto e as credenciais especificados.
Parameters:
java.net.URI
objeto que representa o URI absoluto para o arquivo.
Throws:
Detalhes do método
abortCopy
public final void abortCopy(final String copyId)
Anula uma operação de cópia de Arquivo do Azure em andamento.
Parameters:
String
objeto que identifica a operação de cópia.
Throws:
abortCopy
public final void abortCopy(final String copyId, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Anula uma operação de cópia de Arquivo do Azure em andamento.
Parameters:
String
objeto que identifica a operação de cópia.
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
Throws:
assertValidFilePermissionOrKey
protected void assertValidFilePermissionOrKey()
Verifica se filePermission e properties.filePermissionKey do diretório não estão definidos.
clearRange
public void clearRange(final long offset, final long length)
Limpa um intervalo de um arquivo.
A chamada libera o espaço de armazenamento usado pelo intervalo especificado. Os intervalos que foram limpos não são mais rastreados como parte do arquivo.
Parameters:
Throws:
clearRange
public void clearRange(final long offset, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Limpa um intervalo de um arquivo usando a ID de concessão, as opções de solicitação e o contexto de operação especificados.
A chamada libera o espaço de armazenamento usado pelo intervalo especificado. Os intervalos que foram limpos não são mais rastreados como parte do arquivo.
Parameters:
long
que representa o deslocamento, em bytes, no qual começar a limpar.
long
que representa o comprimento, em bytes, do intervalo de dados a ser limpo.
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
Throws:
closeAllHandlesSegmented
public ResultSegment
Feche todos os identificadores SMB neste arquivo.
Returns:
Throws:
closeAllHandlesSegmented
public ResultSegment
Feche todos os identificadores SMB neste arquivo.
Parameters:
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
Returns:
Throws:
closeHandleSegmented
public ResultSegment
Feche todos os identificadores SMB neste arquivo.
Parameters:
Returns:
Throws:
closeHandleSegmented
public ResultSegment
Feche todos os identificadores SMB neste arquivo.
Parameters:
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
Returns:
Throws:
create
public void create(final long size)
Cria um arquivo. Se o arquivo já existir, isso o substituirá.
Parameters:
long
que representa o tamanho, em bytes, do arquivo.
Throws:
create
public void create(final long size, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Cria um arquivo usando a condição de acesso especificada, as opções de solicitação e o contexto de operação. Se o arquivo já existir, isso o substituirá.
Parameters:
long
que representa o tamanho, em bytes, do arquivo.
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
Throws:
delete
public final void delete()
Exclui o arquivo.
Throws:
delete
public final void delete(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Exclui o arquivo usando a condição de acesso, as opções de solicitação e o contexto de operação especificados.
Parameters:
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
Throws:
deleteIfExists
public final boolean deleteIfExists()
Exclui o arquivo se ele existir.
Returns:
true
se o arquivo foi excluído; caso contrário, false
.
Throws:
deleteIfExists
public final boolean deleteIfExists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Exclui o arquivo se ele existir, usando a condição de acesso, as opções de solicitação e o contexto de operação especificados.
Parameters:
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
Returns:
true
se o arquivo existia e foi excluído; Caso contrário false
Throws:
download
public final void download(final OutputStream outStream)
Baixa o conteúdo de um arquivo em um fluxo.
Parameters:
OutputStream
objeto que representa o fluxo de destino.
Throws:
download
public final void download(final OutputStream outStream, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Baixa o conteúdo de um arquivo em um fluxo usando as opções de solicitação e o contexto de operação especificados.
Parameters:
OutputStream
objeto que representa o fluxo de destino.
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
Throws:
downloadAttributes
public final void downloadAttributes()
Popula as propriedades e os metadados de um arquivo.
Esse método preenche as propriedades do sistema do arquivo e os metadados definidos pelo usuário. Antes de ler ou modificar as propriedades ou metadados de um arquivo, chame esse método ou sua sobrecarga para recuperar os valores mais recentes para as propriedades e metadados do arquivo do serviço de armazenamento do Microsoft Azure.
Throws:
downloadAttributes
public final void downloadAttributes(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Preenche as propriedades e os metadados de um arquivo usando as opções de solicitação e o contexto de operação especificados.
Esse método preenche as propriedades do sistema do arquivo e os metadados definidos pelo usuário. Antes de ler ou modificar as propriedades ou metadados de um arquivo, chame esse método ou sua sobrecarga para recuperar os valores mais recentes para as propriedades e metadados do arquivo do serviço de armazenamento do Microsoft Azure.
Parameters:
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
Throws:
downloadFileRanges
public ArrayList
Retorna uma coleção de intervalos de arquivos e seus deslocamentos de bytes inicial e final.
Os deslocamentos de bytes inicial e final para cada intervalo de arquivos são inclusivos.
Returns:
ArrayList
objeto que representa o conjunto de intervalos de arquivos e seus deslocamentos de bytes inicial e final.Throws:
downloadFileRanges
public ArrayList
Retorna uma coleção de intervalos de arquivos e seus deslocamentos de bytes inicial e final usando as opções de solicitação e o contexto de operação especificados.
Parameters:
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
Returns:
ArrayList
objeto que representa o conjunto de intervalos de arquivos e seus deslocamentos de bytes inicial e final.Throws:
downloadRange
public final void downloadRange(final long offset, final Long length, final OutputStream outStream)
Baixa o conteúdo de um arquivo em um fluxo.
Parameters:
long
que representa o deslocamento a ser usado como ponto de partida para a origem.
Long
que representa o número de bytes a serem lidos ou null
.
OutputStream
objeto que representa o fluxo de destino.
Throws:
downloadRange
public final void downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Baixa o conteúdo de um arquivo em um fluxo usando as opções de solicitação e o contexto de operação especificados.
Parameters:
long
que representa o deslocamento a ser usado como ponto de partida para a origem.
Long
que representa o número de bytes a serem lidos ou null
.
OutputStream
objeto que representa o fluxo de destino.
null
usará as opções de solicitação padrão do cliente de serviço associado ( 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)
Baixa um intervalo de bytes do arquivo para o buffer de bytes fornecido.
Parameters:
long
que representa o deslocamento dentro do arquivo para começar a baixar.
Long
que representa o número de bytes a serem lidos.
byte
matriz que representa o buffer no qual gravar.
int
que representa o deslocamento no buffer de bytes para começar a gravar.
Throws:
downloadRangeToByteArray
public final int downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset)
Baixa um intervalo de bytes do arquivo para o buffer de bytes fornecido.
Parameters:
long
que representa o deslocamento de bytes a ser usado como o ponto de partida para a origem.
Long
que representa o número de bytes a serem lidos ou nulos.
byte
matriz que representa o buffer para o qual os bytes de arquivo são baixados.
int
que representa o deslocamento de bytes a ser usado como o ponto de partida para o 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)
Baixa um intervalo de bytes do arquivo para o buffer de bytes fornecido, usando as opções de solicitação e o contexto de operação especificados.
Parameters:
long
que representa o deslocamento de bytes a ser usado como o ponto de partida para a origem.
Long
que representa o número de bytes a serem lidos ou null
.
byte
matriz que representa o buffer para o qual os bytes de arquivo são baixados.
int
que representa o deslocamento de bytes a ser usado como o ponto de partida para o destino.
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
Throws:
downloadText
public String downloadText()
Baixa um arquivo em uma cadeia de caracteres usando a codificação padrão da plataforma.
Returns:
String
que representa o conteúdo do arquivo.Throws:
downloadText
public String downloadText(final String charsetName, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Baixa um arquivo em uma cadeia de caracteres usando a codificação especificada.
Parameters:
String
que representa o nome do conjunto de caracteres a ser usado para codificar o conteúdo. Se for nulo, a codificação padrão da plataforma será usada.
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
Returns:
String
que representa o conteúdo do arquivo.Throws:
downloadToByteArray
public final int downloadToByteArray(final byte[] buffer, final int bufferOffset)
Baixa um intervalo de bytes do arquivo para o buffer de bytes fornecido.
Parameters:
byte
matriz que representa o buffer para o qual os bytes de arquivo são baixados.
int
que representa o deslocamento de bytes a ser usado como o ponto de partida para o destino.
Throws:
downloadToByteArray
public final int downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Baixa um intervalo de bytes do arquivo para o buffer de bytes fornecido, usando as opções de solicitação e o contexto de operação especificados.
Parameters:
byte
matriz que representa o buffer para o qual os bytes de arquivo são baixados.
long
que representa o deslocamento de bytes a ser usado como o ponto de partida para o destino.
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
Throws:
downloadToFile
public void downloadToFile(final String path)
Baixa um arquivo.
Parameters:
String
que representa o caminho para o arquivo que será criado.
Throws:
downloadToFile
public void downloadToFile(final String path, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Baixa um arquivo.
Parameters:
String
que representa o caminho para o arquivo que será criado.
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
Throws:
exists
public final boolean exists()
Verifica se o arquivo existe.
Returns:
true
se o arquivo existir, caso contrário false
, .
Throws:
exists
public final boolean exists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Verifica se o arquivo existe, usando a condição de acesso especificada, as opções de solicitação e o contexto de operação.
Parameters:
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
Returns:
true
se o arquivo existir, caso contrário false
, .
Throws:
generateSharedAccessSignature
public String generateSharedAccessSignature(final SharedAccessFilePolicy policy, final SharedAccessFileHeaders headers, final String groupPolicyIdentifier)
Retorna uma assinatura de acesso compartilhado para o arquivo usando o identificador de política de grupo especificado e os cabeçalhos de arquivo de acesso compartilhado. Observe que isso não contém o "?".
Parameters:
SharedAccessFilePolicy
objeto que representa a política de acesso para a assinatura de acesso compartilhado.
SharedAccessFileHeaders
objeto que representa os valores de cabeçalho opcionais a serem definidos para um arquivo acessado com essa assinatura de acesso compartilhado.
String
que representa a política de acesso no nível do compartilhamento.
Returns:
String
que representa a assinatura de acesso compartilhado.Throws:
generateSharedAccessSignature
public String generateSharedAccessSignature(final SharedAccessFilePolicy policy, final SharedAccessFileHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols)
Retorna uma assinatura de acesso compartilhado para o arquivo usando o identificador de política de grupo especificado e os cabeçalhos de arquivo de acesso compartilhado. Observe que isso não contém o "?".
Parameters:
SharedAccessFilePolicy
objeto que representa a política de acesso para a assinatura de acesso compartilhado.
SharedAccessFileHeaders
objeto que representa os valores de cabeçalho opcionais a serem definidos para um arquivo acessado com essa assinatura de acesso compartilhado.
String
que representa a política de acesso no nível do compartilhamento.
Returns:
String
que representa a assinatura de acesso compartilhado.Throws:
generateSharedAccessSignature
public String generateSharedAccessSignature(final SharedAccessFilePolicy policy, final String groupPolicyIdentifier)
Retorna uma assinatura de acesso compartilhado para o arquivo usando o identificador de política de grupo especificado e os cabeçalhos de arquivo de acesso compartilhado. Observe que isso não contém o "?".
Parameters:
SharedAccessFilePolicy
objeto que representa a política de acesso para a assinatura de acesso compartilhado.
String
que representa a política de acesso no nível do compartilhamento.
Returns:
String
que representa a assinatura de acesso compartilhado.Throws:
getCopyState
public CopyState getCopyState()
Retorna o estado de cópia do Arquivo do Azure.
Returns:
getMetadata
public final HashMap
Retorna os metadados do arquivo.
Returns:
java.util.HashMap
objeto que representa os metadados do arquivo.getName
public final String getName()
Retorna o nome do arquivo.
Returns:
String
que representa o nome do arquivo.getParent
public final CloudFileDirectory getParent()
Retorna o pai do item de arquivo.
Overrides:
CloudFile.getParent()Returns:
Throws:
getParentNameFromURI
protected static String getParentNameFromURI(final StorageUri resourceAddress, final CloudFileShare share)
Recupera o nome pai de um URI de arquivo.
Parameters:
Returns:
String
que representa o endereço pai de um URI de arquivo.Throws:
getProperties
public final FileProperties getProperties()
Retorna as propriedades do arquivo.
Returns:
getServiceClient
public final CloudFileClient getServiceClient()
Retorna o cliente de serviço de arquivo associado ao arquivo.
Returns:
getShare
public final CloudFileShare getShare()
Retorna o compartilhamento do arquivo.
Overrides:
CloudFile.getShare()Returns:
Throws:
getStorageUri
public final StorageUri getStorageUri()
Retorna a lista de URIs para todos os locais.
Overrides:
CloudFile.getStorageUri()Returns:
getStreamMinimumReadSizeInBytes
public final int getStreamMinimumReadSizeInBytes()
Retorna o tamanho mínimo de leitura ao usar um FileInputStream.
Returns:
int
que representa o tamanho mínimo de leitura, em bytes, ao usar um FileInputStream objeto .getStreamWriteSizeInBytes
public final int getStreamWriteSizeInBytes()
Obtém o número de bytes a serem armazenados em buffer ao gravar em um FileOutputStream.
Returns:
int
que representa o número de bytes a serem armazenados em buffer.getTransformedAddress
protected final StorageUri getTransformedAddress(final OperationContext opContext)
Retorna o URI transformado para o recurso se as credenciais fornecidas exigirem transformação.
Parameters:
Returns:
Throws:
getUri
public final URI getUri()
Retorna o URI desse arquivo.
Overrides:
CloudFile.getUri()Returns:
java.net.URI
objeto que representa o URI do arquivo.listHandles
public Iterable
Obtém os identificadores SMB abertos neste arquivo.
Returns:
Umiterável
</code> of the handles that will lazily request new segments. </p>
listHandles
public Iterable listHandles(FileRequestOptions options, OperationContext opContext)
Obtém os identificadores SMB abertos neste arquivo.
Parameters:
options
- Um FileRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
opContext
- Um OperationContext objeto que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.
Returns:
Umiterável
</code> of the handles that will lazily request new segments. </p>
listHandlesSegmented
public ResultSegment listHandlesSegmented()
Obtém os identificadores SMB abertos neste arquivo.
Returns:
Um ResultSegment<T> objeto que contém um segmento da coleção enumerável de ListFileItem objetos que representam os arquivos e diretórios.
Throws:
StorageException
listHandlesSegmented
public ResultSegment listHandlesSegmented(final Integer maxResults, final ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext)
Obtém os identificadores SMB abertos neste arquivo.
Parameters:
maxResults
- O número máximo de resultados a serem recuperados. Se null
ou maior que 5000, o servidor retornará até 5.000 itens. Deve ser pelo menos 1.
continuationToken
- Um ResultContinuation objeto que representa um token de continuação retornado por uma operação de listagem anterior.
options
- Um FileRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
opContext
- Um OperationContext objeto que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.
Returns:
Um ResultSegment<T> objeto que contém um segmento da coleção enumerável de ListFileItem objetos que representam os arquivos e diretórios.
Throws:
StorageException
openRead
public final FileInputStream openRead()
Abre um fluxo de entrada de arquivo para baixar o arquivo.
Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar o tamanho de leitura.
Returns:
Um InputStream
objeto que representa o fluxo a ser usado para leitura do arquivo.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
openRead
public final FileInputStream openRead(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Abre um fluxo de entrada de arquivo para baixar o arquivo usando as opções de solicitação e o contexto de operação especificados.
Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar o tamanho de leitura.
Parameters:
accessCondition
- Um objeto AccessCondition que representa condições de acesso do arquivo.
options
- Um FileRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
opContext
- Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.
Returns:
Um InputStream
objeto que representa o fluxo a ser usado para leitura do arquivo.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
openWriteExisting
public FileOutputStream openWriteExisting()
Abre um objeto de fluxo de saída para gravar dados no arquivo. O arquivo já deve existir e todos os dados existentes podem ser substituídos.
Returns:
Um FileOutputStream objeto usado para gravar dados no arquivo.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
openWriteExisting
public FileOutputStream openWriteExisting(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Abre um objeto de fluxo de saída para gravar dados no arquivo, usando opções de solicitação e contexto de operação especificados. O arquivo já deve existir e todos os dados existentes podem ser substituídos.
Parameters:
accessCondition
- Um AccessCondition objeto que representa as condições de acesso para o arquivo.
options
- Um FileRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
opContext
- Um OperationContext objeto que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.
Returns:
Um FileOutputStream objeto usado para gravar dados no arquivo.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
openWriteNew
public FileOutputStream openWriteNew(final long length)
Abre um objeto de fluxo de saída para gravar dados no arquivo. O arquivo ainda não existe e será criado com o comprimento especificado. Se o arquivo já existir no serviço, ele será substituído.
Para evitar a substituição e, em vez disso, gerar um erro, use a openWriteNew(final long length, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) sobrecarga com o apropriado AccessCondition.
Parameters:
length
- Um long
que representa o comprimento, em bytes, do fluxo a ser criado.
Returns:
Um FileOutputStream objeto usado para gravar dados no arquivo.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
openWriteNew
public FileOutputStream openWriteNew(final long length, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Abre um objeto de fluxo de saída para gravar dados no arquivo, usando a ID de concessão especificada, as opções de solicitação e o contexto de operação. O arquivo ainda não precisa existir e será criado com o comprimento especificado. Se o arquivo já existir no serviço, ele será substituído.
Para evitar a substituição e, em vez disso, gerar um erro, passe um AccessCondition gerado usando generateIfNotExistsCondition().
Parameters:
length
- Um long
que representa o comprimento, em bytes, do fluxo a ser criado.
accessCondition
- Um AccessCondition objeto que representa as condições de acesso para o arquivo.
options
- Um FileRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
opContext
- Um OperationContext objeto que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.
Returns:
Um FileOutputStream objeto usado para gravar dados no arquivo.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
putRangeFromURL
public void putRangeFromURL(final long destOffset, final long length, final URI sourceUri, final long sourceOffset)
Carrega um intervalo de um arquivo para outro.
Parameters:
destOffset
- Um long
que representa o deslocamento, em número de bytes, no qual começar a gravar os dados.
length
- Um long
que representa o comprimento, em bytes, dos dados a serem gravados e lidos.
sourceUri
- Um java.net.URI
objeto que especifica o URI de origem.
sourceOffset
- Um long
que representa o deslocamento, em número de bytes, no qual começar a ler os dados.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
putRangeFromURL
public void putRangeFromURL(final long destOffset, final long length, final URI sourceUri, final long sourceOffset, FileRequestOptions options, OperationContext opContext)
Carrega um intervalo de um arquivo para outro usando a ID de concessão, as opções de solicitação e o contexto de operação especificados
Parameters:
destOffset
- Um long
que representa o deslocamento, em número de bytes, no qual começar a gravar os dados.
length
- Um long
que representa o comprimento, em bytes, dos dados a serem gravados e lidos.
sourceUri
- Um java.net.URI
objeto que especifica o URI de origem.
sourceOffset
- Um long
que representa o deslocamento, em número de bytes, no qual começar a ler os dados.
options
- Um FileRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
opContext
- Um OperationContext objeto que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
resize
public void resize(long size)
Redimensiona o arquivo para o tamanho especificado.
Parameters:
size
- Um long
que representa o tamanho do arquivo, em bytes.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
resize
public void resize(long size, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Redimensiona o arquivo para o tamanho especificado.
Parameters:
size
- Um long
que representa o tamanho do arquivo, em bytes.
accessCondition
- Um AccessCondition objeto que representa as condições de acesso para o arquivo.
options
- Um FileRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
opContext
- Um OperationContext objeto que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
setFilePermission
public void setFilePermission(String filePermission)
Define a permissão de arquivo do arquivo a ser definida
Parameters:
filePermission
- Um String
que representa a permissão de arquivo do arquivo a ser definida.
setMetadata
public final void setMetadata(final HashMap metadata)
Define os metadados do arquivo.
Parameters:
metadata
- Um java.util.HashMap
objeto que contém os metadados que estão sendo atribuídos ao arquivo.
setProperties
protected final void setProperties(final FileProperties properties)
Define as propriedades do arquivo.
Parameters:
properties
- Um FileProperties objeto que representa as propriedades que estão sendo atribuídas ao arquivo.
setShare
protected final void setShare(final CloudFileShare share)
Define o compartilhamento do arquivo.
Parameters:
share
- Um CloudFileShare objeto que representa o compartilhamento que está sendo atribuído ao arquivo.
setStorageUri
protected void setStorageUri(final StorageUri storageUri)
Define a lista de URIs para todos os locais.
Parameters:
storageUri
- Um StorageUri que representa a lista de URIs para todos os locais.
setStreamMinimumReadSizeInBytes
public void setStreamMinimumReadSizeInBytes(final int minimumReadSize)
Define o tamanho mínimo de leitura ao usar um FileInputStream.
Parameters:
minimumReadSize
- Um int
que representa o número mínimo de bytes a serem armazenados em buffer ao ler de um arquivo ao usar um FileInputStream objeto . Deve ser maior ou igual a 16 KB.
Throws:
IllegalArgumentException
- Se minimumReadSize
for menor que 16 KB.
setStreamWriteSizeInBytes
public void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)
Define o número de bytes a serem armazenados em buffer ao gravar em um FileOutputStream.
Parameters:
streamWriteSizeInBytes
- Um int
que representa o número de bytes a serem armazenados em buffer ao usar um FileOutputStream objeto , variando de 512 bytes a 4 MB, inclusive.
Throws:
IllegalArgumentException
- Se streamWriteSizeInBytes
for menor que 512 bytes ou maior que 4 MB.
startCopy
public final String startCopy(final CloudBlob sourceBlob)
Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um blob para um novo arquivo.
Parameters:
sourceBlob
- Um CloudBlob
objeto que representa o blob de origem a ser copiado.
Returns:
Um String
que representa a ID de cópia associada à operação de cópia.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
startCopy
public final String startCopy(final CloudBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um arquivo para um novo arquivo, usando as condições de acesso, a ID de concessão, as opções de solicitação e o contexto de operação especificados.
Parameters:
sourceBlob
- Um CloudBlob
objeto que representa o blob de origem a ser copiado.
sourceAccessCondition
- Um AccessCondition objeto que representa as condições de acesso para o blob de origem.
destinationAccessCondition
- Um AccessCondition objeto que representa as condições de acesso para o arquivo de destino.
options
- Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null
usará as opções de solicitação padrão do cliente de serviço associado (CloudBlobClient).
opContext
- Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.
Returns:
Um String
que representa a ID de cópia associada à operação de cópia.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
startCopy
public final String startCopy(final CloudFile sourceFile)
Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um Arquivo do Azure para um novo Arquivo do Azure.
Parameters:
sourceFile
- Um CloudFile
objeto que representa o Arquivo do Azure de origem a ser copiado.
Returns:
Um String
que representa a ID de cópia associada à operação de cópia.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
startCopy
public final String startCopy(final CloudFile sourceFile, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um Arquivo do Azure para um novo Arquivo do Azure, usando as condições de acesso, a ID de concessão, as opções de solicitação e o contexto de operação especificados.
Parameters:
sourceFile
- Um CloudFile
objeto que representa o arquivo de origem a ser copiado.
sourceAccessCondition
- Um AccessCondition objeto que representa as condições de acesso para a origem.
destinationAccessCondition
- Um AccessCondition objeto que representa as condições de acesso para o destino.
options
- Um FileRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null
usará as opções de solicitação padrão do cliente de serviço associado (CloudFileClient).
opContext
- Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.
Returns:
Um String
que representa a ID de cópia associada à operação de cópia.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
startCopy
public final String startCopy(final URI source)
Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um URI para um novo Arquivo do Azure.
Parameters:
source
- A origem é java.net.URI
.
Returns:
Um String
que representa a ID de cópia associada à operação de cópia.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
startCopy
public final String startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)
Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um URI para um novo Arquivo do Azure, usando as condições de acesso, a ID de concessão, as opções de solicitação e o contexto de operação especificados.
Parameters:
source
- A origem é java.net.URI
.
sourceAccessCondition
- Um AccessCondition objeto que representa as condições de acesso para a origem.
destinationAccessCondition
- Um AccessCondition objeto que representa as condições de acesso para o destino.
options
- Um FileRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null
usará as opções de solicitação padrão do cliente de serviço associado (CloudFileClient).
opContext
- Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.
Returns:
Um String
que representa a ID de cópia associada à operação de cópia.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
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)
Carrega os dados do fluxo de origem no arquivo. Se o arquivo já existir no serviço, ele será substituído.
Parameters:
sourceStream
- Um InputStream objeto do qual ler.
length
- Um long
que representa o comprimento, em bytes, dos dados de fluxo. Deve ser diferente de zero.
Throws:
IOException
- Se ocorreu uma exceção de E/S.
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
upload
public void upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carrega os dados de fluxo de origem no arquivo usando a condição de acesso, as opções de solicitação e o contexto de operação especificados. Se o arquivo já existir no serviço, ele será substituído.
Parameters:
sourceStream
- Um InputStream objeto do qual ler.
length
- Um long
que representa o comprimento, em bytes, dos dados de fluxo. Isso deve ser maior ou igual a zero.
accessCondition
- Um AccessCondition objeto que representa as condições de acesso para o arquivo.
options
- Um FileRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
opContext
- Um OperationContext objeto que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.
Throws:
IOException
- Se ocorreu uma exceção de E/S.
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
uploadFromByteArray
public void uploadFromByteArray(final byte[] buffer, final int offset, final int length)
Carrega um arquivo de dados em uma matriz de bytes. Se o arquivo já existir no serviço, ele será substituído.
Parameters:
buffer
- Uma byte
matriz que representa os dados a serem gravados no arquivo.
offset
- Um int
que representa o deslocamento da matriz de bytes da qual iniciar o upload de dados.
length
- Um int
que representa o número de bytes a serem carregados do buffer de entrada.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
IOException
URISyntaxException
uploadFromByteArray
public void uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carrega um arquivo de dados em uma matriz de bytes. Se o arquivo já existir no serviço, ele será substituído.
Parameters:
buffer
- Uma byte
matriz que representa os dados a serem gravados no arquivo.
offset
- Um int
que representa o deslocamento da matriz de bytes da qual iniciar o upload de dados.
length
- Um int
que representa o número de bytes a serem carregados do buffer de entrada.
accessCondition
- Um objeto AccessCondition que representa condições de acesso do arquivo.
options
- Um FileRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
opContext
- Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
IOException
URISyntaxException
uploadFromFile
public void uploadFromFile(final String path)
Carrega um arquivo local. Se o arquivo já existir no serviço, ele será substituído.
Parameters:
path
- Um String
que representa o caminho para o arquivo a ser carregado.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
IOException
URISyntaxException
uploadFromFile
public void uploadFromFile(final String path, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carrega um arquivo de um arquivo local. Se o arquivo já existir no serviço, ele será substituído.
Parameters:
path
- Um String
que representa o caminho para o arquivo a ser carregado.
accessCondition
- Um objeto AccessCondition que representa condições de acesso do arquivo.
options
- Um FileRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
opContext
- Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
IOException
URISyntaxException
uploadMetadata
public final void uploadMetadata()
Carrega os metadados do arquivo para o serviço de armazenamento.
Use downloadAttributes() para recuperar os valores mais recentes para as propriedades e metadados do arquivo do serviço de armazenamento do Microsoft Azure.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
uploadMetadata
public final void uploadMetadata(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carrega os metadados do arquivo para o serviço de armazenamento usando a condição de acesso, as opções de solicitação e o contexto de operação.
Use downloadAttributes() para recuperar os valores mais recentes para as propriedades e metadados do arquivo do serviço de armazenamento do Microsoft Azure.
Parameters:
accessCondition
- Um objeto AccessCondition que representa condições de acesso do arquivo.
options
- Um FileRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
opContext
- Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
uploadProperties
public final void uploadProperties()
Carrega as propriedades do arquivo no serviço de armazenamento.
Use downloadAttributes() para recuperar os valores mais recentes para as propriedades e metadados do arquivo do serviço de armazenamento do Microsoft Azure.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
uploadProperties
public final void uploadProperties(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carrega as propriedades do arquivo usando a condição de acesso, as opções de solicitação e o contexto de operação.
Use downloadAttributes() para recuperar os valores mais recentes para as propriedades e metadados do arquivo do serviço de armazenamento do Microsoft Azure.
Parameters:
accessCondition
- Um objeto AccessCondition que representa condições de acesso do arquivo.
options
- Um FileRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
opContext
- Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
uploadRange
public void uploadRange(final InputStream sourceStream, final long offset, final long length)
Carrega um intervalo em um arquivo.
Parameters:
sourceStream
- Um InputStream objeto que representa o fluxo de entrada a ser gravado no arquivo.
offset
- Um long
que representa o deslocamento, em número de bytes, no qual começar a gravar os dados.
length
- Um long
que representa o comprimento, em bytes, dos dados a serem gravados.
Throws:
IOException
- Se ocorreu uma exceção de E/S.
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
uploadRange
public void uploadRange(final InputStream sourceStream, final long offset, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carrega um intervalo em um arquivo usando a ID de concessão especificada, as opções de solicitação e o contexto de operação.
Parameters:
sourceStream
- Um InputStream objeto que representa o fluxo de entrada a ser gravado no arquivo.
offset
- Um long
que representa o deslocamento, em número de bytes, no qual começar a gravar os dados.
length
- Um long
que representa o comprimento, em bytes, dos dados a serem gravados.
accessCondition
- Um AccessCondition objeto que representa as condições de acesso para o arquivo.
options
- Um FileRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
opContext
- Um OperationContext objeto que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.
Throws:
IOException
- Se ocorreu uma exceção de E/S.
StorageException
- Se ocorreu um erro de serviço de armazenamento.
URISyntaxException
uploadText
public void uploadText(final String content)
Carrega um arquivo de uma cadeia de caracteres usando a codificação padrão da plataforma. Se o arquivo já existir no serviço, ele será substituído.
Parameters:
content
- Um String
que representa o conteúdo que será carregado no arquivo.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
IOException
URISyntaxException
uploadText
public void uploadText(final String content, final String charsetName, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)
Carrega um arquivo de uma cadeia de caracteres usando a codificação especificada. Se o arquivo já existir no serviço, ele será substituído.
Parameters:
content
- Um String
que representa o conteúdo que será carregado no arquivo.
charsetName
- Um String
que representa o nome do conjunto de caracteres a ser usado para codificar o conteúdo. Se for nulo, a codificação padrão da plataforma será usada.
accessCondition
- Um objeto AccessCondition que representa condições de acesso do arquivo.
options
- Um FileRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudFileClient).
opContext
- Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.
Throws:
StorageException
- Se ocorreu um erro de serviço de armazenamento.
IOException
URISyntaxException
Aplica-se a
Azure SDK for Java