Componente Transferência de arquivos do JSF 1.1

Consulte também

Você pode arrastar o componente Transferência de arquivos ícone do componente Transferência de arquivos da categoria Básico para o Visual Designer a fim de criar 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.

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

O componente Transferência de arquivos usa um filtro, um objeto com.sun.rave.web.ui.util.UploadFilter que é configurado por você no descritor de deployment da aplicação 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.rave.web.ui.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. 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
Vinculando propriedades do componente
Trabalhando com componentes
Tarefas de componente: referência rápida
Sobre a Paleta do Visual Web

Notificações legais