Como usar arquivos Choosers

Optantes arquivos fornecem uma interface gráfica para navegar no sistema de arquivo, e então escolher um arquivo ou diretório a partir de uma lista ou digitando o nome de um arquivo ou diretório. Para exibir um seletor de arquivos, você costuma usar o JFileChooser API para mostrar um modal de diálogo contendo o seletor de arquivos. Outra forma de apresentar um seletor de arquivos é adicionar uma instância do JFileChooser para um recipiente.

Nota: 

Se você pretende distribuir o seu programa como Java ™ unsigned aplicativo Web Start, então em vez de usar o JFileChooser API você deve usar os serviços de arquivo fornecidos pela API JNLP. Esses serviços - FileOpenService e FileSaveService - não só fornecerá suporte para escolher os arquivos em um ambiente restrito, mas também cuidar de realmente abrir e salvá-los. Um exemplo do uso desses serviços está em JWSFileChooserDemo . Documentação para o uso da API JNLP pode ser encontrado no Java Web Start lição.

Clique no botão Iniciar para executar JWSFileChooserDemo usando Java ™ Web Start ( de download JDK 6 ou posterior ). Como alternativa, para compilar e executar o exemplo de si mesmo, consultar o índice de exemplo .

Ao trabalhar com o JWSFileChooserDemo exemplo, tome cuidado para não perder os arquivos que você precisa. Sempre que você clique no botão Salvar e selecione um arquivo existente, esta demo traz o arquivo existe caixa de diálogo com um pedido para substituir o arquivo. Aceitando o pedido sobrescreve o arquivo.

O resto desta seção discute como usar o JFileChooser API. A JFileChooser objeto só apresenta a interface gráfica para a escolha de arquivos. Seu programa é responsável por fazer algo com o arquivo escolhido, como abrir ou salvá-lo. Consulte / S básicas para obter informações sobre como ler e gravar arquivos.

O JFileChooser API torna fácil para abrir e salvar aberto diálogos. O tipo de olhar e sentir o que determina essas caixas de diálogo padrão parecido e como eles diferem.No olhar Java e sensação, caixa de diálogo Salvar parece o mesmo que o diálogo aberto, exceto o título na janela do diálogo e do texto no

botão que aprovar a operação.Aqui está uma foto de um padrão aberto de diálogo no olhar ea sensação de Java:

Aqui está uma foto de um aplicativo chamado FileChooserDemo que traz um diálogo aberto e uma caixa de diálogo de salvamento.

Tente isto: 

1. Compilar e executar o exemplo, consultar o índice de exemplo .

2. Clique no botão Abrir um arquivo. Navegar em torno do seletor de arquivos, escolha um arquivo e clique no botão Abrir da caixa de diálogo.

3. Use o botão Salvar um arquivo para abrir um diálogo de

salvamento. Tente usar todos os controles sobre a seleção de arquivos.

4. No arquivo fonte FileChooserDemo.java , altere o modo de seleção de arquivos para diretórios modo somente. (Busca por DIRECTORIES_ONLY e descomente a linha que o contém.) Em seguida, compilar e executar o exemplo novamente. Você só será capaz de ver e selecionar diretórios e não as pastas comuns.

Trazer um padrão aberto de diálogo requer apenas duas linhas de código:

/ / Criar um seletor de arquivosúltima JFileChooser fc = new JFileChooser ();.../ / Em resposta a um clique de botão: int = returnVal fc.showOpenDialog ( aComponent );

O argumento para o showOpenDialog método especifica o componente pai para o diálogo. O componente pai afecta a posição da caixa de diálogo e da moldura que o diálogo depende. Por exemplo, o Java olhar e sentir lugares do diálogo diretamente sobre o componente pai. Se o componente principal é em um quadro, em seguida, a caixa de diálogo é dependente que moldura. Esta caixa de diálogo desaparece quando o quadro é minimizada e reaparece quando o quadro é maximizada.

Por padrão, um seletor de arquivos que não tenha sido mostrado antes exibe todos os arquivos no diretório home do usuário. Você pode especificar o diretório inicial do seletor de arquivo usando um JFileChooser 's outros construtores, ou você pode definir o diretório com o SetCurrentDirectory método.

A chamada para showOpenDialog aparece no actionPerformed método do ouvinte ação Abrir um botão de arquivo:

public void actionPerformed (ActionEvent e) { / / Tratamento de ação do botão aberto. if (e.getSource () == openButton) { int returnVal = fc.showOpenDialog (FileChooserDemo.this);

if (returnVal JFileChooser.APPROVE_OPTION ==) { File file = fc.getSelectedFile (); / / Este é o lugar onde uma aplicação real seria abrir o arquivo. log.append ("Abertura:" "." + file.getName () + + newline); Else {} log.append ("comando Abrir cancelada pelo usuário." + newline); } } ...}

Os mostram Xxx diálogo métodos retornam um inteiro que indica se o usuário selecionou um arquivo. Dependendo de como você usa um seletor de arquivos, muitas vezes é suficiente para verificar se o valor de retorno é APPROVE_OPTION e, em seguida, para não alterar qualquer outro valor. Para obter o arquivo escolhido (ou o diretório, se você configurar o seletor de arquivos para permitir que as seleções de diretório), chame o getSelectedFile método na seleção de arquivos. Este método retorna uma instância do arquivo .

O exemplo obtém o nome do arquivo e usa-lo na mensagem de log. Você pode chamar outros métodos no arquivo objeto, tais como getPath , isDirectory , ou existepara obter informações sobre o arquivo. Você também pode chamar outros métodos, como excluir e renomear para alterar o arquivo de alguma forma. Claro, você também pode querer abrir ou salvar o arquivo usando uma das classes de leitor ou escritor fornecidos pela plataforma Java. Ver Básico I / O para obter informações sobre o uso de leitores e escritores a ler e escrever dados para o sistema de arquivos.

O programa de exemplo usa a mesma instância do JFileChooser classe para exibir um diálogo de salvamento padrão. Desta vez, o programa chama showSaveDialog :

int returnVal = fc.showSaveDialog (FileChooserDemo.this);

Usando o exemplo chooser mesmo arquivo para mostrar o seu abrir e salvar os diálogos, o programa colhe os seguintes benefícios:

O seletor lembra o diretório atual entre os usos, então as versões abertas e salvar automaticamente compartilham o mesmo diretório atual.

Você tem que personalizar apenas um seletor de arquivos, e as

personalizações se aplicam tanto a abrir e salvar versões.

Finalmente, o programa exemplo tem comentada linhas de código que permitem alterar o modo de seleção de arquivos. Por exemplo, a seguinte linha de código faz com que o seletor de arquivos capaz de selecionar apenas diretórios, e não os arquivos:

fc.setFileSelectionMode (JFileChooser.DIRECTORIES_ONLY);

Outro modo de seleção é possível FILES_AND_DIRECTORIES . O padrão é FILES_ONLY . A imagem seguinte mostra um diálogo aberto com o modo de seleção de arquivo definido para DIRECTORIES_ONLY . Note-se que, no olhar e sentir Java pelo menos, os diretórios apenas são visíveis - arquivos não.

Se você deseja criar um seletor de arquivos para uma outra tarefa de abrir ou salvar, ou se você quiser personalizar o seletor de arquivos, continue lendo. Vamos discutir os seguintes tópicos:

Outro exemplo: FileChooserDemo2

Usando um seletor de arquivos para uma tarefa personalizada

Filtrando a lista de arquivos Personalizando a visualização do

arquivo

Proporcionar um componente acessório

O Arquivo Seletor API Exemplos que usam Choosers

Arquivo

Outro exemplo: FileChooserDemo2

Vejamos FileChooserDemo2 exemplo, uma versão modificada do programa demo anterior que usa mais do JFileChooser API. Este exemplo usa um seletor de arquivo que foi personalizada de várias maneiras. Como o exemplo original, o usuário chama um seletor de arquivos com o apertar de um botão. Aqui está uma foto da seleção de arquivos:

Como mostra a figura, este seletor de arquivos foi personalizada para uma tarefa especial (Prenda), fornece um filtro de arquivos usuário-choosable (apenas imagens), usa uma exibição de arquivo especial para arquivos de imagem, e tem um componente acessório que exibe um esboço de miniaturas do arquivo de imagem selecionado.

O restante desta seção mostra o código que cria e personaliza este seletor de arquivos. Veja o índice de exemplo para todos os links para os arquivos necessários por este exemplo.

Usando um seletor de arquivos para uma tarefa personalizada

Como você viu, o JFileChooser classe fornece o showOpenDialog método para exibir um diálogo aberto e showSaveDialog método para exibir uma caixa de diálogo de salvamento.

A classe tem outro método, showDialog , para exibir um seletor de arquivos para uma tarefa personalizada em uma caixa de diálogo. No olhar Java e sentir, a única diferença entre este diálogo e as caixas de diálogo Seletor outros arquivos é o título na janela de diálogo eo rótulo no botão aprovar. Aqui está o código de FileChooserDemo2 que traz a caixa de diálogo de seleção de arquivos para o Anexar tarefa:

JFileChooser fc = new JFileChooser ();int returnVal = fc.showDialog (FileChooserDemo2.this, "Anexar");

O primeiro argumento para o showDialog método é o componente pai para o diálogo. O segundo argumento é uma string objeto que fornece tanto o título para a janela de diálogo eo rótulo para o botão de aprovar.

Mais uma vez, o seletor de arquivos não faz nada com o arquivo selecionado. O programa é responsável pela execução da tarefa personalizada para que o seletor de arquivo foi criado.

Filtrando a lista de arquivos

Por padrão, um seletor de arquivos exibe todos os arquivos e diretórios que ele detecta, com exceção dos arquivos ocultos. Um programa pode aplicar uma ou mais filtros de arquivo para um seletor de arquivos para que o seletor mostra apenas alguns arquivos. O seletor de arquivo chama o filtro de aceitar método para cada arquivo para determinar se ele deve ser exibido. Um filtro de arquivo aceita ou rejeita um arquivo com base em critérios como tipo de arquivo, tamanho, propriedade, e assim por diante. Os filtros afetam a lista de arquivos exibidos pelo seletor de arquivos. O usuário pode digitar o nome de qualquer arquivo mesmo se ele não for exibido.

JFileChooser suporta três diferentes tipos de filtragem. Os filtros são verificados na ordem listada aqui. Por exemplo, um filtro de aplicativo controlado vê apenas os ficheiros aceites pela built-in de filtragem.

Built-in de filtragemA filtragem é configurado através de chamadas de métodos específicos de um seletor de arquivos. Atualmente é apenas o built-in filtro disponível para arquivos ocultos, tais como aqueles cujos nomes começam com ponto

(.) Em sistemas UNIX. Por padrão, arquivos ocultos não são mostradas. Chame setFileHidingEnabled (false) para mostrar arquivos ocultos.

Controlado por aplicativo de filtragemA aplicação determina quais arquivos são mostrados. Criar uma subclasse personalizada de FileFilter , instanciá-lo, e usar o exemplo como um argumento para asetFileFilter método. O filtro instalado é exibido na lista de usuário choosable filtros. O seletor de arquivo mostra apenas os arquivos que o filtro aceita.

Usuário choosable filtragemO arquivo chooser GUI fornece uma lista de filtros que o usuário pode escolher. Quando o usuário escolhe um filtro, o seletor de arquivo mostra apenas os arquivos aceitos por esse filtro. FileChooserDemo2 adiciona um arquivo de filtro personalizado à lista de usuário choosable filtros:

fc.addChoosableFileFilter (novo ImageFilter ());

Por padrão, a lista de usuário choosable filtros inclui o Accept All filtro, que permite ao usuário ver todos os arquivos não-ocultos. Este exemplo usa o seguinte código para desativar o Accept All filtro:

fc.setAcceptAllFileFilterUsed (false);

Nosso filtro de arquivo personalizado é implementado em ImageFilter.java e é uma subclasse de FileFilter . O ImageFilter classe implementa agetDescription método para retornar "apenas imagens" - uma seqüência de caracteres para

colocar na lista de usuário choosable filtros ImageFilter também implementa a aceitar método para que ele aceite todos os diretórios e qualquer arquivo que tem um png. , jpg. , . jpeg , . gif , . tif , ou . tiff extensão do arquivo.

public boolean accept (File f) { if (f.isDirectory ()) { return true; }

Seqüência de extensão = Utils.getExtension (f); if (extensão = null) { if (extension.equals (Utils.tiff) | | extension.equals (Utils.tif) | | extension.equals (Utils.gif) | | extension.equals (Utils.jpeg) | | extension.equals (Utils.jpg) | | extension.equals (Utils.png)) { return true; Else {} return false; } }

return false;}

Ao aceitar todos os diretórios, este filtro permite ao usuário navegar em torno do sistema de arquivos. Se as linhas a negrito foram omitidos do presente método, o utilizador seria limitado para o directório com o qual o seletor foi inicializada.

O exemplo de código anterior usa o getExtension método e constantes string de vários Utils.java , mostrado aqui:

public class Utils {

public final static String jpeg = "jpeg"; jpg public String static final = "jpg"; final String public static gif = "gif"; public final static String tiff = "tiff"; final String public static tif = "tif"; public final static String png = "png";

/ * * Obter a extensão de um arquivo. * / public static string getExtension (File f) { Cordas ext = null; String s = f.getName (); int i = s.lastIndexOf ('.');

se (i> 0 && i <s.length () - 1) { . ext s.substring = (i +1) toLowerCase (); } voltar ext; }}

Personalizando a visualização do arquivo

No olhar e sentir Java, a lista chooser mostra o nome de cada arquivo e exibe um pequeno ícone que representa se o arquivo é um arquivo de verdade ou um diretório. Você pode personalizar essa exibição de arquivo , criando uma subclasse personalizada de FileView e usando uma instância da classe como um argumento para a setFileViewmétodo. O exemplo usa uma instância de uma classe personalizada, implementado em ImageFileView.java , como vista o seletor de arquivos de arquivo.

fc.setFileView (novo ImageFileView ());

O ImageFileView classe mostra um ícone diferente para cada tipo de imagem aceite pelo filtro de imagem descrito anteriormente.

O ImageFileView classe substitui os cinco métodos abstratos definidos na FileView como se segue.

GetTypeDescription String (File f)

Retorna uma descrição do tipo de arquivo. Aqui está ImageFileView 's implementação deste método:

getTypeDescription public String (File f) { Seqüência de extensão = Utils.getExtension (f); Tipo String = null;

if (extensão = null) { if (extension.equals (Utils.jpeg) | | extension.equals (Utils.jpg)) { type = "Imagem JPEG"; } Else if (extension.equals (Utils.gif)) { type = "imagem GIF"; } Else if (extension.equals (Utils.tiff) | | extension.equals (Utils.tif)) { type = "Imagem TIFF"; } Else if (extension.equals (Utils.png)) { type = "Imagem PNG"; } } tipo de retorno;}

Ícone getIcon (File f)

Retorna um ícone representando o arquivo ou o seu tipo. Aqui está ImageFileView 's implementação deste método:

pública Ícone getIcon (File f) { Seqüência de extensão = Utils.getExtension (f); Ícone = null;

if (extensão = null) { if (extension.equals (Utils.jpeg) | | extension.equals (Utils.jpg)) { icon = jpgIcon; } Else if (extension.equals (Utils.gif)) { icon = gifIcon;

} Else if (extension.equals (Utils.tiff) | | extension.equals (Utils.tif)) { icon = tiffIcon; } Else if (extension.equals (Utils.png)) { icon = pngIcon; } } voltar ícone;}

Cordas getName (File f)

Retorna o nome do arquivo. A maioria das implementações deste método deve retornar nulo para indicar que o olhar ea sensação deve descobrir. Outra aplicação comum retornos f.getName () .

GetDescription String (File f)

Retorna uma descrição do arquivo. A intenção é descrever arquivos individuais, mais especificamente. Uma implementação comum deste método retorna nulo para indicar que o olhar ea sensação deve descobrir.

Boolean isTraversable (File f)

Retorna se um diretório é transitável. A maioria das implementações deste método deve retornar nulo para indicar que o olhar ea sensação deve descobrir. Alguns aplicativos podem querer impedir que os usuários descendente em um certo tipo de diretório, porque representa um documento composto. O isTraversable método nunca deve retornar verdadeiro para um diretório não.

Proporcionar um componente acessório

O seletor de arquivo personalizado em FileChooserDemo2 tem um componente acessório. Se o item selecionado é uma imagem PNG, JPEG, TIFF, GIF ou, o componente acessório apresenta um esboço da imagem. Caso contrário, o componente acessório está vazio. Além de um visualizador, provavelmente o uso mais comum para o componente acessório é um painel com mais controles sobre ele como caixas de verificação que alternam entre as características.

O exemplo chama o setAccessory método para estabelecer uma instância da ImagePreview classe, implementado em ImagePreview.java , como componente do seletor do acessório:

fc.setAccessory (novo ImagePreview (fc));

Qualquer objeto que herda da JComponent classe pode ser um componente acessório. O componente deve ter um tamanho preferido que fica bem no seletor de arquivos.

O seletor de arquivo dispara um evento de alteração de propriedade quando o usuário seleciona um item na lista. Um programa com um componente acessório deve se cadastrar para receber esses eventos para atualizar o componente acessório sempre que as alterações de seleção. No exemplo, o ImagePreview próprio objecto regista para estes eventos. Isso mantém todo o código relacionado ao componente acessório juntos em uma classe.

Aqui é a implementação do exemplo da propertyChange método, que é o método chamado quando um evento de alteração de propriedade é disparado:

/ / onde as variáveis membros são declaradosFile file = null;...propertyChange public void (PropertyChangeEvent e) { boolean update = false; Cordas prop = e.getPropertyName ();

/ / Se o diretório alterado, não mostre uma imagem. if (JFileChooser.DIRECTORY_CHANGED_PROPERTY.equals (prop)) { file = null; atualizar = true;

/ / Se um arquivo foi selecionado, descobrir qual é. } Else if (JFileChooser.SELECTED_FILE_CHANGED_PROPERTY.equals (prop)) { file = (File) e.getNewValue (); atualizar = true; }

/ / Atualiza a visualização em conformidade. if (atualização) { thumbnail = null; if (isShowing ()) { loadImage ();

repaint (); } }}

Se SELECTED_FILE_CHANGED_PROPERTY é a propriedade que mudou, este método obtém um arquivo objeto da seleção de arquivos. O loadImage e redesenhar os métodos usar o arquivo objeto para carregar a imagem e redesenhar o componente acessório.

O Arquivo Seletor API

A API para usar optantes arquivo cai nas seguintes categorias:

Criar e exibir o Seletor de arquivos Selecionando arquivos e diretórios Navegando Lista de Seletor de

arquivos de Personalizar o Seletor de arquivos

Criar e exibir o Seletor de arquivos

Método ou construtor

Propósito

JFileChooser ()   JFileChooser (File)JFileChooser (String)

Cria uma instância de seleção de arquivos. O arquivo e cordas argumentos, quando presentes, fornecer o diretório inicial.

int showOpenDialog (Componente)   int showSaveDialog (Componente)   int showDialog (String Component)

Mostra uma janela modal contendo o seletor de arquivos. Esses métodos retornam APPROVE_OPTION se o utilizador autorizado a operação eCANCEL_OPTION se o utilizador cancelado. Outro valor de retorno é possível ERROR_OPTION , o que significa um erro inesperado ocorreu.

Selecionando arquivos e diretórios

Método Propósito

vazio setSelectedFile (File)   getSelectedFile File ()

Define ou obtém o arquivo selecionado ou (se a seleção de diretório foi ativado) diretório.

setSelectedFiles vazios (Arquivo [])   de arquivos [] getSelectedFiles ()

Define ou obtém os arquivos atualmente selecionados se o seletor de arquivos está definido para permitir a seleção múltipla.

vazio setFileSelectionMode (int)   getFileSelectionMode void ()   boolean isDirectorySelectionEnabled

Define ou obtém o modo de seleção de arquivos. Os valores aceitáveis são FILES_ONLY (o padrão), DIRECTORIES_ONLY eFILES_AND_DIRECTORIES . Interpreta se diretórios ou arquivos são selecionáveis de acordo com o modo de seleção atual.

()   boolean isFileSelectionEnabled ()

vazio setMultiSelectionEnabled (boolean)   boolean isMultiSelectionEnabled ()

Define ou se interpreta vários arquivos podem ser selecionados de uma só vez. Por padrão, um usuário pode escolher apenas um arquivo.

vazio setAcceptAllFileFilterUsed (boolean)   boolean isAcceptAllFileFilterUsed ()

Define ou obtém se o AcceptAll filtro de arquivo é usado como uma escolha permitida na lista choosable filtro, o valor padrão éverdadeiro .

Diálogo CreateDialog (Componente)

Dado um componente pai, cria e retorna uma nova caixa de diálogo que contém esse seletor de arquivos, é dependente quadro do pai, e está centrado sobre o pai.

Navegando Lista de Seletor de arquivos de

Método Propósito

ensureFileIsVisible void (Arquivo)

Corre a lista, que o arquivo indicado é visível o seletor de arquivo.

vazio SetCurrentDirectory (File)   GetCurrentDirectory File ()

Define ou obtém o diretório cujos arquivos são exibidos na lista o seletor de arquivo.

changeToParentDirectory void ()

Altera a lista para exibir o pai do diretório atual.

rescanCurrentDirectory void ()

Verifica o sistema de arquivos e atualizações da lista o seletor de.

vazio setDragEnabled (boolean)   boolean getDragEnabled ()

Define ou obtém a propriedade que determina se a manipulação de arrastar automático está ativado. Veja arrastar e soltar e Transferência de Dados para obter mais detalhes.

Personalizar o Seletor de arquivos

Método Propósito

vazio setAccessory (javax.swing.JComponent)   JComponent getAccessory ()

Define ou obtém o componente de seleção de arquivos do acessório.

vazio setFileFilter (FileFilter)   FileFilter getFileFilter ()

Define ou obtém o filtro de seleção de arquivos do arquivo primário.

vazio setFileView (FileView)   FileView getFileView ()

Define ou obtém vista o seletor de arquivos.

FileFilter [] getChoosableFileFilters ()   vazio addChoosableFileFilter (FileFilter)   boolean removeChoosableFileFilter

Sets, obtém, ou modifica a lista de filtros usuário choosable arquivo.

(FileFilter)   vazio resetChoosableFileFilters ()   FileFilter getAcceptAllFileFilter ()

vazio setFileHidingEnabled (boolean)   boolean isFileHidingEnabled ()

Define ou obtém se os arquivos ocultos são exibidos.

vazio setControlButtonsAreShown (boolean)   getControlButtonsAreShown boolean ()

Define ou obtém a propriedade que indica se os botões Aprovar e Cancel são mostrados na seleção de arquivos. Esta propriedade é true por padrão.

Exemplos que usam Choosers Arquivo

Esta tabela mostra os exemplos que usam optantes arquivo e aponta para onde os exemplos são descritos.

ExemploOnde Descrito

Notas

FileChooserDemo Esta secção

Exibe um diálogo aberto e uma caixa de diálogo de salvamento.

FileChooserDemo2 Esta secção

Usa um seletor de arquivos com o costume de filtragem, uma visão de arquivo personalizado, e um componente acessório.

JWSFileChooserDemo Esta secção

Utiliza a API JNLP para abrir e salvar arquivos.

«Anterior • Trail • Próximo »

Problemas com os exemplos? Tente compilar e executar o Exemplos: Perguntas Frequentes . Reclamações? Elogios? Sugestões? Dê-nos a sua opinião .

O uso deste página e todo o material em páginas sob o título "Java Tutoriais O" banner está sujeito a estes avisos legais .

Sobre a Oracle | Oracle Technology Network | Termos de serviço

Copyright © 1995, 2012 Oracle

Corporation e / ou suas afiliadas.Todos

os direitos reservados.