Componente Transferência de arquivos do JSF 1.2

Consulte também

O componente Transferência de arquivos ícone do componente Transferência de arquivos fornece um campo de entrada e um botão de exploração que abre um diálogo de seletor de arquivos no sistema local, permitindo que o usuário selecione um arquivo ou digite o nome do arquivo no campo de entrada. Quando a página é enviada, uma cópia do conteúdo do arquivo é enviada ao aplicativo da Web. Este componente é útil para reunir arquivos de texto, arquivos de imagem e outros dados. O conteúdo do arquivo transferido é armazenado juntamente com algumas informações sobre tal arquivo, incluindo o nome, o tamanho e o tipo MIME (como texto/simples ou imagem/jpeg).

O componente é semelhante ao elemento HTML <input type="file">.

O componente Transferência de arquivos usa um filtro, um objeto com.sun.webui.jsf.util.UploadFilter que é configurado por você no descritor de implantação do aplicativo da Web. O UploadFilter usa o pacote fileupload comum do Apache. Talvez você precise alterar estas configurações nos seguintes casos:

O conteúdo do arquivo transferido, juntamente com algumas informações sobre ele, é armazenado em uma instância de com.sun.webui.jsf.model.UploadedFile. Com o uso deste objeto, você pode obter o conteúdo do arquivo como String ou gravar o conteúdo no disco, bem como obter propriedades como o nome e o tamanho do arquivo. Com o intuito de economizar memória, o conteúdo e os dados do arquivo estão disponíveis somente durante a solicitação HTTP na qual o arquivo foi transferido. Para acessar o conteúdo do arquivo transferido, vincule a propriedade uploadedFile a uma propriedade de bean do tipo com.sun.webui.jsf.model.UploadedFile. Processe o arquivo com um método setter ou método de ação.

A interface de UploadedFile possui métodos para obter o nome e o tamanho do arquivo, determinar seu tipo MIME (como text/plain ou image/jpeg), obter seu conteúdo como bytes ou como uma String e gravar o conteúdo no disco. Além disso, se tiver definido a preservePath do componente Transferência de arquivos, você pode obter tal preserved path da propriedade de bean UploadedFile chamando o método getClientFilePath(). Para saber mais, no editor Java, clique com o botão direito do mouse em UploadedFile em uma instrução de declaração e escolha Mostrar Javadoc no menu pop-up.

Consulte também
Janela Propriedades de Transferência de arquivos
Vinculando propriedades do componente
Trabalhando com componentes
Tarefas de componente: referência rápida
Sobre a Paleta do Visual Web

Notificações legais