FileChannel Classe

Definição

[Android.Runtime.Register("java/nio/channels/FileChannel", DoNotGenerateAcw=true)]
public abstract class FileChannel : Java.Nio.Channels.Spi.AbstractInterruptibleChannel, IDisposable, Java.Interop.IJavaPeerable, Java.Nio.Channels.IGatheringByteChannel, Java.Nio.Channels.IScatteringByteChannel, Java.Nio.Channels.ISeekableByteChannel

[<Android.Runtime.Register("java/nio/channels/FileChannel", DoNotGenerateAcw=true)>]
type FileChannel = class
    inherit AbstractInterruptibleChannel
    interface IByteChannel
    interface IReadableByteChannel
    interface IChannel
    interface ICloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IWritableByteChannel
    interface IGatheringByteChannel
    interface IScatteringByteChannel
    interface ISeekableByteChannel

Herança

Object

Object

AbstractInterruptibleChannel

FileChannel

Atributos

RegisterAttribute

Implementações

IJavaObject IJavaPeerable ICloseable IByteChannel IChannel IGatheringByteChannel IReadableByteChannel IScatteringByteChannel ISeekableByteChannel IWritableByteChannel IDisposable

Comentários

Um canal para ler, gravar, mapear e manipular um arquivo.

Um canal de arquivo é um SeekableByteChannel que está conectado a um arquivo. Ele tem uma posição atual dentro de seu arquivo que pode ser ambos #position() <i>queried</i> e #position(long) <i>modified</i>. O arquivo em si contém uma sequência de bytes de comprimento variável que pode ser lida e gravada e cuja corrente #size <i>size</i> pode ser consultada. O tamanho do arquivo aumenta quando bytes são gravados além do tamanho atual; o tamanho do arquivo diminui quando ele é #truncate <i>truncated</i>. O arquivo também pode ter alguns metadados associados, como permissões de acesso, tipo de conteúdo e hora de última modificação; essa classe não define métodos para acesso a metadados.

Além das operações familiares de leitura, gravação e fechamento de canais de bytes, essa classe define as seguintes operações específicas do arquivo:

<ul>

<li>

Bytes podem estar #read(ByteBuffer, long) read ou #write(ByteBuffer, long) <i>written</i> em uma posição absoluta em um arquivo de uma forma que não afete a posição atual do canal.

</li>

<li>

Uma região de um arquivo pode estar #map <i>mapped</i> diretamente na memória; para arquivos grandes, isso geralmente é muito mais eficiente do que invocar os métodos ou write usuaisread.

</li>

<li>

As atualizações feitas em um arquivo podem ser #force <i>forced out</i> para o dispositivo de armazenamento subjacente, garantindo que os dados não sejam perdidos no caso de uma falha do sistema.

</li>

<li>

Os bytes podem ser transferidos de um arquivo #transferTo <i>to some other channel</i>e #transferFrom <i>vice versa</i>, de uma forma que pode ser otimizada por muitos sistemas operacionais para uma transferência muito rápida diretamente para ou do cache do sistema de arquivos.

</li>

<li>

Uma região de um arquivo pode ser FileLock <i>locked</i> contra o acesso por outros programas.

</li>

</ul>

Os canais de arquivo são seguros para uso por vários threads simultâneos. O Channel#close close método pode ser invocado a qualquer momento, conforme especificado pela Channel interface. Apenas uma operação que envolve a posição do canal ou pode alterar o tamanho do arquivo pode estar em andamento a qualquer momento; tenta iniciar uma segunda operação desse tipo enquanto a primeira ainda está em andamento será bloqueada até que a primeira operação seja concluída. Outras operações, em particular aquelas que tomam uma posição explícita, podem continuar simultaneamente; se, de fato, elas dependem da implementação subjacente e, portanto, não são especificadas.

A exibição de um arquivo fornecido por uma instância dessa classe tem a garantia de ser consistente com outras exibições do mesmo arquivo fornecidas por outras instâncias no mesmo programa. A exibição fornecida por uma instância dessa classe pode ou não ser consistente com as exibições vistas por outros programas em execução simultânea devido ao cache executado pelo sistema operacional subjacente e atrasos induzidos por protocolos de sistema de arquivos de rede. Isso é verdadeiro independentemente da linguagem em que esses outros programas são escritos e se eles estão em execução no mesmo computador ou em algum outro computador. A natureza exata de tais inconsistências são dependentes do sistema e, portanto, não são especificadas.

Um canal de arquivo é criado invocando um dos #open open métodos definidos por essa classe. Um canal de arquivo também pode ser obtido de um objeto ou java.io.RandomAccessFile#getChannel RandomAccessFile um objeto existente java.io.FileInputStream#getChannel FileInputStreamjava.io.FileOutputStream#getChannel FileOutputStreaminvocando o método desse getChannel objeto, que retorna um canal de arquivo que está conectado ao mesmo arquivo subjacente. Quando o canal de arquivo é obtido de um fluxo existente ou de um arquivo de acesso aleatório, o estado do canal de arquivo é intimamente conectado ao do objeto cujo getChannel método retornou o canal. Alterar a posição do canal, seja explicitamente ou lendo ou escrevendo bytes, alterará a posição do arquivo do objeto de origem e vice-versa. Alterar o comprimento do arquivo por meio do canal de arquivo alterará o comprimento visto por meio do objeto de origem e vice-versa. Alterar o conteúdo do arquivo escrevendo bytes alterará o conteúdo visto pelo objeto de origem e vice-versa.

"modo aberto">

Em vários pontos, essa classe especifica que é necessária uma instância "aberta para leitura", "aberta para gravação" ou "aberta para leitura e gravação". Um canal obtido por meio do java.io.FileInputStream#getChannel getChannel método de uma java.io.FileInputStream instância será aberto para leitura. Um canal obtido por meio do java.io.FileOutputStream#getChannel getChannel método de uma java.io.FileOutputStream instância será aberto para gravação. Por fim, um canal obtido por meio do java.io.RandomAccessFile#getChannel getChannel método de uma java.io.RandomAccessFile instância será aberto para leitura se a instância tiver sido criada com o modo "r" e estará aberto para leitura e gravação se a instância tiver sido criada com o modo "rw".

"append-mode">

Um canal de arquivo aberto para gravação pode estar no modo de acréscimo, por exemplo, se ele foi obtido de um fluxo de saída de arquivo que foi criado invocando o java.io.FileOutputStream#FileOutputStream(java.io.File,boolean) FileOutputStream(File,boolean) construtor e passando true para o segundo parâmetro. Nesse modo, cada invocação de uma operação de gravação relativa primeiro avança a posição para o final do arquivo e grava os dados solicitados. Se o avanço da posição e da gravação dos dados são feitos em uma única operação atômica é dependente do sistema e, portanto, não especificado.

Adicionado em 1.4.

Java documentação para java.nio.channels.FileChannel.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.