-
ShellFolderManager
/*
* Copyright (c) 2000, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package sun.awt.shell;
import java.io.File;
import java.io.FileNotFoundException;
import java.util.concurrent.Callable;
import java.util.stream.Stream;
Author: Michael Martak Since: 1.4
/**
* @author Michael Martak
* @since 1.4
*/
class ShellFolderManager {
Create a shell folder from a file.
Override to return machine-dependent behavior.
/**
* Create a shell folder from a file.
* Override to return machine-dependent behavior.
*/
public ShellFolder createShellFolder(File file) throws FileNotFoundException {
return new DefaultShellFolder(null, file);
}
Params: - key – a
String "fileChooserDefaultFolder": Returns a File - the default shellfolder for a new filechooser "roots": Returns a File[] - containing the root(s) of the displayable hierarchy "fileChooserComboBoxFolders": Returns a File[] - an array of shellfolders representing the list to show by default in the file chooser's combobox "fileChooserShortcutPanelFolders": Returns a File[] - an array of shellfolders representing well-known folders, such as Desktop, Documents, History, Network, Home, etc. This is used in the shortcut panel of the filechooser on Windows 2000 and Windows Me. "fileChooserIcon ": Returns an Image - icon can be ListView, DetailsView, UpFolder, NewFolder or ViewMenu (Windows only).
Returns: An Object matching the key string.
/**
* @param key a {@code String}
* "fileChooserDefaultFolder":
* Returns a {@code File} - the default shellfolder for a new filechooser
* "roots":
* Returns a {@code File[]} - containing the root(s) of the displayable hierarchy
* "fileChooserComboBoxFolders":
* Returns a {@code File[]} - an array of shellfolders representing the list to
* show by default in the file chooser's combobox
* "fileChooserShortcutPanelFolders":
* Returns a {@code File[]} - an array of shellfolders representing well-known
* folders, such as Desktop, Documents, History, Network, Home, etc.
* This is used in the shortcut panel of the filechooser on Windows 2000
* and Windows Me.
* "fileChooserIcon <icon>":
* Returns an {@code Image} - icon can be ListView, DetailsView, UpFolder, NewFolder or
* ViewMenu (Windows only).
*
* @return An Object matching the key string.
*/
public Object get(String key) {
if (key.equals("fileChooserDefaultFolder")) {
// Return the default shellfolder for a new filechooser
File homeDir = new File(System.getProperty("user.home"));
try {
return checkFile(createShellFolder(homeDir));
} catch (FileNotFoundException e) {
return checkFile(homeDir);
}
} else if (key.equals("roots")) {
// The root(s) of the displayable hierarchy
return checkFiles(File.listRoots());
} else if (key.equals("fileChooserComboBoxFolders")) {
// Return an array of ShellFolders representing the list to
// show by default in the file chooser's combobox
return get("roots");
} else if (key.equals("fileChooserShortcutPanelFolders")) {
// Return an array of ShellFolders representing well-known
// folders, such as Desktop, Documents, History, Network, Home, etc.
// This is used in the shortcut panel of the filechooser on Windows 2000
// and Windows Me
return checkFiles(new File[] { (File)get("fileChooserDefaultFolder") });
}
return null;
}
private static File checkFile(File f) {
SecurityManager sm = System.getSecurityManager();
return (sm == null || f == null) ? f : checkFile(f, sm);
}
private static File checkFile(File f, SecurityManager sm) {
try {
sm.checkRead(f.getPath());
if (f instanceof ShellFolder) {
ShellFolder sf = (ShellFolder)f;
if (sf.isLink()) {
sm.checkRead(sf.getLinkLocation().getPath());
}
}
return f;
} catch (SecurityException | FileNotFoundException e) {
return null;
}
}
private static File[] checkFiles(File[] fs) {
SecurityManager sm = System.getSecurityManager();
return (sm == null || fs == null) ? fs : checkFiles(Stream.of(fs), sm);
}
private static File[] checkFiles(Stream<File> fs, SecurityManager sm) {
return fs.filter(f -> f != null && checkFile(f, sm) != null)
.toArray(File[]::new);
}
Does dir represent a "computer" such as a node on the network, or "My Computer" on the desktop. /**
* Does {@code dir} represent a "computer" such as a node on the network, or
* "My Computer" on the desktop.
*/
public boolean isComputerNode(File dir) {
return false;
}
public boolean isFileSystemRoot(File dir) {
if (dir instanceof ShellFolder && !((ShellFolder) dir).isFileSystem()) {
return false;
}
return (dir.getParentFile() == null);
}
protected ShellFolder.Invoker createInvoker() {
return new DirectInvoker();
}
private static class DirectInvoker implements ShellFolder.Invoker {
public <T> T invoke(Callable<T> task) throws Exception {
return task.call();
}
}
}