Quellcode-Bibliothek

^© Kompilation durch diese Firma

[Weder Korrektheit noch Funktionsfähigkeit der Software werden zugesichert.]

Datei: jEdit.java Sprache: JAVA

Original von: Isabelle^©

/*
* jEdit.java - Main class of the jEdit editor
* :tabSize=4:indentSize=4:noTabs=false:
* :folding=explicit:collapseFolds=1:
*
* Copyright (C) 1998, 2005 Slava Pestov
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation; either version 2
* of the License, or any later version.
* This program 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 for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
*/

package org.gjt.sp.jedit;

//{{{ Imports
import java.io.Closeable;
import java.io.IOException;

import org.gjt.sp.jedit.datatransfer.JEditTransferableService;
import org.gjt.sp.jedit.gui.tray.JTrayIconManager;
import org.gjt.sp.jedit.manager.*;
import org.gjt.sp.util.*;
import org.jedit.core.MigrationService;
import org.jedit.migration.OneTimeMigrationService;
import org.jedit.keymap.KeymapManager;
import org.jedit.keymap.KeymapManagerImpl;
import org.gjt.sp.jedit.visitors.JEditVisitor;

import java.awt.*;

import org.gjt.sp.jedit.View.ViewConfig;
import org.gjt.sp.jedit.bsh.UtilEvalError;

import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import javax.swing.*;
import java.awt.event.*;
import java.io.*;
import java.net.*;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.text.MessageFormat;
import java.util.*;
import java.util.List;
import java.lang.reflect.InvocationTargetException;
import java.util.function.Consumer;
import java.util.stream.Stream;

import org.xml.sax.SAXParseException;

import org.gjt.sp.jedit.bufferio.BufferIORequest;
import org.gjt.sp.jedit.buffer.KillRing;
import org.gjt.sp.jedit.buffer.JEditBuffer;
import org.gjt.sp.jedit.buffer.FoldHandler;
import org.gjt.sp.jedit.msg.*;
import org.gjt.sp.jedit.gui.*;
import org.gjt.sp.jedit.help.HelpViewer;
import org.gjt.sp.jedit.io.*;
import org.gjt.sp.jedit.pluginmgr.PluginManager;
import org.gjt.sp.jedit.search.SearchAndReplace;
import org.gjt.sp.jedit.syntax.Chunk;
import org.gjt.sp.jedit.syntax.ModeProvider;
import org.gjt.sp.jedit.syntax.TokenMarker;
import org.gjt.sp.jedit.syntax.XModeHandler;
import org.gjt.sp.jedit.textarea.*;
import org.gjt.sp.jedit.visitors.SaveCaretInfoVisitor;
import org.gjt.sp.jedit.bufferset.BufferSetManager;
import org.gjt.sp.jedit.bufferset.BufferSet;

import static java.lang.Integer.parseInt;
//}}}

/**
* The main class of the jEdit text editor.
* @author Slava Pestov
* @version $Id: jEdit.java 25355 2020-09-03 02:48:21Z vampire0 $
*/
public class jEdit
{
//{{{ getVersion() method
/**
* Returns the jEdit version as a human-readable string.
*/
public static String getVersion()
{
 return MiscUtilities.buildToVersion(getBuild());
} //}}}

//{{{ getBuild() method
/**
* Returns the internal version. MiscUtilities.compareStrings() can be used
* to compare different internal versions.
*/
public static String getBuild()
{
 // (major).(minor).(<99 = preX, 99 = "final").(bug fix)
 return "05.06.99.00";
} //}}}

//{{{ main() method
/**
* The main method of the jEdit application.
* This should never be invoked directly.
* @param args The command line arguments
*/
public static void main(String[] args)
{
 // doing a copy to log it later as original args array is modified
 String[] _args = args.clone();
 //{{{ Check for Java 11 or later
 String javaVersion = System.getProperty("java.version");
 String majorVersion = javaVersion.split("\\.", 2)[0];
 if (majorVersion.endsWith("-ea"))
 {
 majorVersion = majorVersion.substring(0, majorVersion.length() - 3);
 }
 int javaMajorVersion = parseInt(majorVersion);
 if(javaMajorVersion < 11)
 {
 System.err.println("You are running Java version "
 + javaVersion + '.');
 System.err.println("jEdit requires Java 11 or later.");
 System.exit(1);
 } //}}}

 startupDone.add(false);

 // later on we need to know if certain code is called from
 // the main thread
 mainThread = Thread.currentThread();

 settingsDirectory = MiscUtilities.constructPath(
 System.getProperty("user.home"), ".jedit");
 // On mac, different rules (should) apply
 if(OperatingSystem.isMacOS())
 settingsDirectory = MiscUtilities.constructPath(
 System.getProperty("user.home"), "Library/jEdit" );
 else if (OperatingSystem.isWindows())
 {
 String appData = System.getenv("APPDATA");
 if (appData != null)
 settingsDirectory = MiscUtilities.constructPath(
 appData, "jEdit");
 }
 // MacOS users expect the app to keep running after all windows
 // are closed
 background = OperatingSystem.isMacOS();

 //{{{ Parse command line
 boolean endOpts = false;
 int level = Log.WARNING;
 String portFile = "server";
 boolean restore = true;
 boolean newView = true;
 boolean newPlainView = false;
 boolean gui = true; // open initial view?
 boolean loadPlugins = true;
 boolean runStartupScripts = true;
 boolean quit = false;
 boolean wait = false;
 boolean shouldRelocateSettings = true;
 String userDir = System.getProperty("user.dir");
 boolean splash = true;

 // script to run
 String scriptFile = null;

 for(int i = 0; i < args.length; i++)
 {
 String arg = args[i];
 if(arg == null)
 {
 }
 else if(arg.isEmpty())
 args[i] = null;
 else if(arg.startsWith("-") && !endOpts)
 {
 if(arg.equals("--"))
 endOpts = true;
 else if(arg.equals("-usage"))
 {
 version();
 System.err.println();
 usage();
 System.exit(1);
 }
 else if(arg.equals("-version"))
 {
 version();
 System.exit(1);
 }
 else if(arg.startsWith("-log="))
 {
 try
 {
 level = parseInt(arg.substring("-log=".length()));
 }
 catch(NumberFormatException nf)
 {
 System.err.println("Malformed option: " + arg);
 }
 }
 else if(arg.equals("-nosettings"))
 settingsDirectory = null;
 else if(arg.startsWith("-settings="))
 {
 settingsDirectory = arg.substring(10);
 shouldRelocateSettings = false;
 }
 else if(arg.startsWith("-noserver"))
 portFile = null;
 else if(arg.equals("-server"))
 portFile = "server";
 else if(arg.startsWith("-server="))
 portFile = arg.substring(8);
 else if(arg.startsWith("-background"))
 background = true;
 else if(arg.startsWith("-nobackground"))
 background = false;
 else if(arg.equals("-gui"))
 gui = true;
 else if(arg.equals("-nogui"))
 gui = false;
 else if(arg.equals("-newview"))
 newView = true;
 else if(arg.equals("-newplainview"))
 newPlainView = true;
 else if(arg.equals("-reuseview"))
 newPlainView = newView = false;
 else if(arg.equals("-restore"))
 restore = true;
 else if(arg.equals("-norestore"))
 restore = false;
 else if(arg.equals("-plugins"))
 loadPlugins = true;
 else if(arg.equals("-noplugins"))
 loadPlugins = false;
 else if(arg.equals("-startupscripts"))
 runStartupScripts = true;
 else if(arg.equals("-nostartupscripts"))
 runStartupScripts = false;
 else if(arg.startsWith("-run="))
 scriptFile = arg.substring(5);
 else if(arg.equals("-wait"))
 wait = true;
 else if(arg.equals("-quit"))
 quit = true;
 else if(arg.equals("-nosplash"))
 splash = false;
 else
 {
 System.err.println("Unknown option: "
 + arg);
 usage();
 System.exit(1);
 }
 args[i] = null;
 }
 } //}}}

 JTrayIconManager.setTrayIconArgs(restore, userDir, args);

 //{{{ We need these initializations very early on
 if(settingsDirectory != null)
 {
 settingsDirectory = MiscUtilities.resolveSymlinks(
 settingsDirectory);
 }

 if(settingsDirectory != null && portFile != null)
 portFile = MiscUtilities.constructPath(settingsDirectory,portFile);
 else
 portFile = null;

 Log.init(true,level);

 Log.log(Log.MESSAGE,jEdit.class, "starting with command line arguments: " + String.join(" ", _args));
 //}}}

 //{{{ Try connecting to another running jEdit instance
 if(portFile != null && new File(portFile).exists())
 {
 BufferedReader in = null;
 DataOutputStream out = null;
 try
 {
 in = new BufferedReader(new FileReader(portFile));
 String check = in.readLine();
 if(!"b".equals(check))
 throw new IllegalArgumentException("Wrong port file format");

 int port = parseInt(in.readLine());
 int key = parseInt(in.readLine());

 // socket is closed via BeanShell script below
 @SuppressWarnings("resource")
 Socket socket = new Socket(InetAddress.getByName(null),port);
 out = new DataOutputStream(socket.getOutputStream());
 out.writeInt(key);

 String script;
 if(quit)
 {
 script = "socket.close();\n"
 + "jEdit.exit(null,true);\n";
 }
 else
 {
 script = makeServerScript(wait,restore,
 newView,newPlainView,args,
 scriptFile);
 }

 out.writeUTF(script);

 Log.log(Log.DEBUG,jEdit.class,"Waiting for server");

 // block until its closed
 socket.getInputStream().read();

 System.exit(0);
 }
 catch(Exception e)
 {
 // ok, this one seems to confuse newbies
 // endlessly, so log it as NOTICE, not
 // ERROR
 Log.log(Log.NOTICE,jEdit.class,"An error occurred"
 + " while connecting to the jEdit server instance.");
 Log.log(Log.NOTICE,jEdit.class,"This probably means that"
 + " jEdit crashed and/or exited abnormally");
 Log.log(Log.NOTICE,jEdit.class,"the last time it was run.");
 Log.log(Log.NOTICE,jEdit.class,"If you don't"
 + " know what this means, don't worry.");
 Log.log(Log.NOTICE,jEdit.class,e);
 }
 finally
 {
 IOUtilities.closeQuietly(in);
 IOUtilities.closeQuietly(out);
 }
 }

 if(quit)
 {
 // if no server running and user runs jedit -quit,
 // just exit
 System.exit(0);
 } //}}}

 // don't show splash screen if there is a file named
 // 'nosplash' in the settings directory
 logTime("before splash screen activation");
 if(splash && (!new File(settingsDirectory,"nosplash").exists()))
 GUIUtilities.showSplashScreen();
 logTime("after splash screen activation");
 //{{{ Settings migration code.
 // Windows check introduced in 5.0pre1.
 // MacOS check introduced in 4.3.
 if((OperatingSystem.isMacOS() || OperatingSystem.isWindows())
 && shouldRelocateSettings && settingsDirectory != null)
 {
 relocateSettings();
 }
 // }}}

 //{{{ Initialize settings directory
 Writer stream;
 if(settingsDirectory != null)
 {
 File _settingsDirectory = new File(settingsDirectory);
 if(!_settingsDirectory.exists())
 _settingsDirectory.mkdirs();
 File _macrosDirectory = new File(settingsDirectory,"macros");
 if(!_macrosDirectory.exists())
 _macrosDirectory.mkdir();

 String logPath = MiscUtilities.constructPath(
 settingsDirectory,"activity.log");

 backupSettingsFile(new File(logPath));

 try
 {
 stream = new BufferedWriter(new FileWriter(logPath));

 // Write a warning message:
 String lineSep = System.getProperty("line.separator");
 stream.write("Log file created on " + new Date());
 stream.write(lineSep);
 stream.write("IMPORTANT:");
 stream.write(lineSep);
 stream.write("Because updating this file after "
 + "every log message would kill");
 stream.write(lineSep);
 stream.write("performance, it will be *incomplete* "
 + "unless you invoke the");
 stream.write(lineSep);
 stream.write("Utilities->Troubleshooting->Update "
 + "Activity Log on Disk command!");
 stream.write(lineSep);
 }
 catch(Exception e)
 {
 e.printStackTrace();
 stream = null;
 }
 }
 else
 {
 stream = null;
 } //}}}
 Log.setLogWriter(stream);

 Log.log(Log.NOTICE,jEdit.class,"jEdit version " + getVersion());
 Log.log(Log.MESSAGE,jEdit.class,"Settings directory is "
 + settingsDirectory);

 //{{{ Get things rolling
 GUIUtilities.advanceSplashProgress("init");
 initMisc();
 GUIUtilities.advanceSplashProgress("init system properties");
 initSystemProperties();

 GUIUtilities.advanceSplashProgress("init beanshell");
 BeanShell.init();

 GUIUtilities.advanceSplashProgress("loading site properties");
 if(jEditHome != null)
 initSiteProperties();

 GUIUtilities.advanceSplashProgress("loading user properties");
 initUserProperties();
 initLocalizationProperties(false);

 GUIUtilities.advanceSplashProgress("init GUI");
 GUIUtilities.init();

 bufferSetManager = new BufferSetManager();
 //}}}

 //{{{ Initialize server
 if(portFile != null)
 {
 GUIUtilities.advanceSplashProgress("init server");
 server = new EditServer(portFile);
 if(!server.isOK())
 server = null;
 }
 else
 {
 GUIUtilities.advanceSplashProgress();
 if(background)
 {
 background = false;
 Log.log(Log.WARNING,jEdit.class,"You cannot specify both the"
 + " -background and -noserver switches");
 }
 } //}}}

 //{{{ Do more stuff
 GUIUtilities.advanceSplashProgress("init look and feel");
 initPLAF();
 GUIUtilities.advanceSplashProgress("init VFS Manager");
 VFSManager.init();
 GUIUtilities.advanceSplashProgress("init resources");
 initResources();

 if (settingsDirectory != null)
 {
 GUIUtilities.advanceSplashProgress("Migrate keymaps");
 MigrationService keymapMigration = ServiceManager.getService(MigrationService.class, "keymap");
 keymapMigration.migrate();
 }
 else
 GUIUtilities.advanceSplashProgress();

 SearchAndReplace.load();

 if(loadPlugins)
 {
 GUIUtilities.advanceSplashProgress("init plugins");
 initPlugins();
 }
 else
 GUIUtilities.advanceSplashProgress();

 Registers.setSaver(new JEditRegisterSaver());
 Registers.setListener(new JEditRegistersListener());
 GUIUtilities.advanceSplashProgress("init history model");
 HistoryModel.setSaver(new JEditHistoryModelSaver());
 HistoryModel.loadHistory();
 GUIUtilities.advanceSplashProgress("init buffer history");
 BufferHistory.load();
 GUIUtilities.advanceSplashProgress("init killring");
 KillRing.setInstance(new JEditKillRing());
 KillRing.getInstance().load();
 GUIUtilities.advanceSplashProgress("init various properties");

 // other one-time migration services.
 OneTimeMigrationService.execute();

 propertiesChanged();

 GUIUtilities.advanceSplashProgress("init modes");

 // Buffer sort
 bufferManager.setSortBuffers(getBooleanProperty("sortBuffers"));
 bufferManager.setSortByName(getBooleanProperty("sortByName"));

 reloadModes();

 GUIUtilities.advanceSplashProgress("activate plugins");
 //}}}

 //{{{ Activate plugins that must be activated at startup
 for(int i = 0; i < jars.size(); i++)
 {
 jars.elementAt(i).activatePluginIfNecessary();
 } //}}}

 String[] serviceNames = ServiceManager.getServiceNames(JEditTransferableService.class);
 for (String serviceName : serviceNames)
 {
 JEditTransferableService service = ServiceManager.getService(JEditTransferableService.class, serviceName);
 org.gjt.sp.jedit.datatransfer.TransferHandler.getInstance().registerTransferableService(service);
 }

 //{{{ Load macros and run startup scripts, after plugins and settings are loaded
 GUIUtilities.advanceSplashProgress("init macros");
 Macros.loadMacros();
 Macros.getMacroActionSet().initKeyBindings();

 if(runStartupScripts && jEditHome != null)
 {
 String path = MiscUtilities.constructPath(jEditHome,"startup");
 File file = new File(path);
 if(file.exists())
 {
 GUIUtilities.advanceSplashProgress("run startup scripts");
 runStartupScripts(file);
 }
 else
 GUIUtilities.advanceSplashProgress();
 }
 else
 GUIUtilities.advanceSplashProgress();

 if(runStartupScripts && settingsDirectory != null)
 {
 String path = MiscUtilities.constructPath(settingsDirectory,"startup");
 File file = new File(path);
 if (file.exists())
 {
 GUIUtilities.advanceSplashProgress("run startup scripts");
 runStartupScripts(file);
 }
 else
 {
 GUIUtilities.advanceSplashProgress();
 file.mkdirs();
 }
 }
 else
 {
 GUIUtilities.advanceSplashProgress();
 } //}}}

 //{{{ Run script specified with -run= parameter
 if(scriptFile != null)
 {
 GUIUtilities.advanceSplashProgress("run script file");
 scriptFile = MiscUtilities.constructPath(userDir,scriptFile);
 try
 {
 BeanShell.getNameSpace().setVariable("args",args);
 }
 catch(UtilEvalError e)
 {
 Log.log(Log.ERROR,jEdit.class,e);
 }
 BeanShell.runScript(null,scriptFile,null,false);
 }
 else
 {
 GUIUtilities.advanceSplashProgress();
 }
 //}}}

 GUIUtilities.advanceSplashProgress();

 // Create dynamic actions for switching to saved layouts.
 // The list of saved layouts is retrieved from the docking framework,
 // which can be provided by a plugin, so this must be called only after
 // the plugins are loaded.
 DockingLayoutManager.init();

 // Open files, create the view and hide the splash screen.
 SyntaxUtilities.propertyManager = jEdit.propertyManager;
 finishStartup(gui,restore,newPlainView,userDir,args);
 logTime("main done");
} //}}}

//{{{ Property methods

//{{{ getCurrentLanguage() method
/**
* Returns the current language used by jEdit.
*
* @return the current language, never null
* @since jEdit 5.0pre1
*/
public static String getCurrentLanguage()
{
 String language;
 if (getBooleanProperty("lang.usedefaultlocale"))
 {
 language = Locale.getDefault().getLanguage();
 }
 else
 {
 language = getProperty("lang.current", "en");
 }
 return language;
} //}}}

//{{{ getProperties() method
/**
* Returns the properties object which contains all known
* jEdit properties. Note that as of jEdit 4.2pre10, this returns a
* new collection, not the existing properties instance.
* @since jEdit 3.1pre4
*/
public static Properties getProperties()
{
 return propMgr.getProperties();
} //}}}

//{{{ getProperty() method
/**
* Fetches a property, returning null if it's not defined.
* @param name The property
*/
public static String getProperty(String name)
{
 return propMgr.getProperty(name);
} //}}}

//{{{ getProperty() method
/**
* Fetches a property, returning the default value if it's not
* defined.
* @param name The property
* @param def The default value
*/
public static String getProperty(String name, String def)
{
 String value = propMgr.getProperty(name);
 if(value == null)
 return def;
 else
 return value;
} //}}}

//{{{ getProperty() method
/**
* Returns the property with the specified name.
*
* The elements of the <code>args</code> array are substituted
* into the value of the property in place of strings of the
* form <code>{n}</code>, where <code>n</code> is an index
* in the array.
*
* You can find out more about this feature by reading the
* documentation for the <code>format</code> method of the
* <code>java.text.MessageFormat</code> class.
*
* @param name The property
* @param args The positional parameters
*/
public static String getProperty(String name, Object[] args)
{
 if(name == null)
 return null;
 if(args == null)
 return getProperty(name);
 else
 {
 String value = getProperty(name);
 if(value == null)
 return null;
 else
 return MessageFormat.format(value,args);
 }
} //}}}

//{{{ getBooleanProperty() method
/**
* Returns the value of a boolean property.
* @param name The property
*/
public static boolean getBooleanProperty(String name)
{
 return getBooleanProperty(name,false);
} //}}}

//{{{ getBooleanProperty() method
/**
* Returns the value of a boolean property.
* @param name The property
* @param def The default value
*/
public static boolean getBooleanProperty(String name, boolean def)
{
 String value = getProperty(name);
 return StandardUtilities.getBoolean(value, def);
} //}}}

//{{{ getIntegerProperty() method
/**
* Returns the value of an integer property.
* @param name The property
*/
public static int getIntegerProperty(String name)
{
 return getIntegerProperty(name,0);
} //}}}

//{{{ getIntegerProperty() method
/**
* Returns the value of an integer property.
* @param name The property
* @param def The default value
* @since jEdit 4.0pre1
*/
public static int getIntegerProperty(String name, int def)
{
 String value = getProperty(name);
 if(value == null)
 return def;
 else
 {
 try
 {
 return parseInt(value.trim());
 }
 catch(NumberFormatException nf)
 {
 return def;
 }
 }
} //}}}

//{{{ getDoubleProperty() method
public static double getDoubleProperty(String name, double def)
{
 String value = getProperty(name);
 if(value == null)
 return def;
 else
 {
 try
 {
 return Double.parseDouble(value.trim());
 }
 catch(NumberFormatException nf)
 {
 return def;
 }
 }
}
//}}}

//{{{ getFontProperty() method
/**
* Returns the value of a font property. The family is stored
* in the <code>name</code> property, the font size is stored
* in the <code>namesize</code> property, and the font style is
* stored in <code>namestyle</code>. For example, if
* <code>name</code> is <code>view.gutter.font</code>, the
* properties will be named <code>view.gutter.font</code>,
* <code>view.gutter.fontsize</code>, and
* <code>view.gutter.fontstyle</code>.
*
* @param name The property
* @since jEdit 4.0pre1
*/
public static Font getFontProperty(String name)
{
 return getFontProperty(name,null);
} //}}}

//{{{ getFontProperty() method
/**
* Returns the value of a font property. The family is stored
* in the <code>name</code> property, the font size is stored
* in the <code>namesize</code> property, and the font style is
* stored in <code>namestyle</code>. For example, if
* <code>name</code> is <code>view.gutter.font</code>, the
* properties will be named <code>view.gutter.font</code>,
* <code>view.gutter.fontsize</code>, and
* <code>view.gutter.fontstyle</code>.
*
* @param name The property
* @param def The default value
* @since jEdit 4.0pre1
*/
public static Font getFontProperty(String name, Font def)
{
 String family = getProperty(name);
 String sizeString = getProperty(name + "size");
 String styleString = getProperty(name + "style");

 if(family == null || sizeString == null || styleString == null)
 return def;
 else
 {
 int size, style;

 try
 {
 size = parseInt(sizeString);
 }
 catch(NumberFormatException nf)
 {
 return def;
 }

 try
 {
 style = parseInt(styleString);
 }
 catch(NumberFormatException nf)
 {
 return def;
 }

 return new Font(family,style,size);
 }
} //}}}

//{{{ getColorProperty() method
/**
* Returns the value of a color property.
* @param name The property name
* @since jEdit 4.0pre1
*/
public static Color getColorProperty(String name)
{
 return getColorProperty(name,Color.black);
}

/**
* Returns the value of a color property.
* @param name The property name
* @param def The default value
* @since jEdit 4.0pre1
*/
public static Color getColorProperty(String name, Color def)
{
 String value = getProperty(name);
 if(value == null)
 return def;
 else
 return SyntaxUtilities.parseColor(value, def);
} //}}}

//{{{ setColorProperty() method
/**
* Sets the value of a color property.
* @param name The property name
* @param value The value
* @since jEdit 4.0pre1
*/
public static void setColorProperty(String name, Color value)
{
 setProperty(name, SyntaxUtilities.getColorHexString(value));
} //}}}

//{{{ getColorMatrixProperty() method
/**
* Returns the value of a color matrix property.
* @param name The property name
* @since jEdit 5.6
*/
public static Color[][] getColorMatrixProperty(String name)
{
 return getColorMatrixProperty(name, null);
}

/**
* Returns the value of a color matrix property.
* @param name The property name
* @param def The default value
* @since jEdit 5.6
*/
public static Color[][] getColorMatrixProperty(String name, Color[][] def)
{
 String value = getProperty(name);
 if(value == null)
 return def;
 else
 return SyntaxUtilities.parseColorMatrix(value, def);
} //}}}

//{{{ setColorMatrixProperty() method
/**
* Sets the value of a color matrix property.
* @param name The property name
* @param value The value
* @since jEdit 5.6
*/
public static void setColorMatrixProperty(String name, Color[][] value)
{
 setProperty(name, SyntaxUtilities.getColorMatrixString(value));
} //}}}

//{{{ setProperty() method
/**
* Sets a property to a new value.
* @param name The property
* @param value The new value
*/
public static void setProperty(String name, String value)
{
 propMgr.setProperty(name,value);
} //}}}

//{{{ setTemporaryProperty() method
/**
* Sets a property to a new value. Properties set using this
* method are not saved to the user properties list.
* @param name The property
* @param value The new value
* @since jEdit 2.3final
*/
public static void setTemporaryProperty(String name, String value)
{
 propMgr.setTemporaryProperty(name,value);
} //}}}

//{{{ setBooleanProperty() method
/**
* Sets a boolean property.
* @param name The property
* @param value The value
*/
public static void setBooleanProperty(String name, boolean value)
{
 setProperty(name,value ? "true" : "false");
} //}}}

//{{{ setIntegerProperty() method
/**
* Sets the value of an integer property.
* @param name The property
* @param value The value
* @since jEdit 4.0pre1
*/
public static void setIntegerProperty(String name, int value)
{
 setProperty(name,String.valueOf(value));
} //}}}

//{{{ setDoubleProperty() method
public static void setDoubleProperty(String name, double value)
{
 setProperty(name,String.valueOf(value));
}
//}}}

//{{{ setFontProperty() method
/**
* Sets the value of a font property. The family is stored
* in the <code>name</code> property, the font size is stored
* in the <code>namesize</code> property, and the font style is
* stored in <code>namestyle</code>. For example, if
* <code>name</code> is <code>view.gutter.font</code>, the
* properties will be named <code>view.gutter.font</code>,
* <code>view.gutter.fontsize</code>, and
* <code>view.gutter.fontstyle</code>.
*
* @param name The property
* @param value The value
* @since jEdit 4.0pre1
*/
public static void setFontProperty(String name, Font value)
{
 setProperty(name,value.getFamily());
 setIntegerProperty(name + "size",value.getSize());
 setIntegerProperty(name + "style",value.getStyle());
} //}}}

//{{{ unsetProperty() method
/**
* Unsets (clears) a property.
* @param name The property
*/
public static void unsetProperty(String name)
{
 propMgr.unsetProperty(name);
} //}}}

//{{{ resetProperty() method
/**
* Resets a property to its default value.
* @param name The property
*
* @since jEdit 2.5pre3
*/
public static void resetProperty(String name)
{
 propMgr.resetProperty(name);
} //}}}

//{{{ propertiesChanged() method
/**
* Reloads various settings from the properties.
*/
public static void propertiesChanged()
{
 initLocalizationProperties(true);
 initPLAF();

 keymapManager.reload();
 initKeyBindings();

 Autosave.setInterval(getIntegerProperty("autosave",30));

 saveCaret = getBooleanProperty("saveCaret");

 UIDefaults defaults = UIManager.getDefaults();
 defaults.put("SplitPane.continuousLayout", true);

 // give all text areas the same font
 Font font = getFontProperty("view.font");

 //defaults.put("TextField.font",font);
 defaults.put("TextArea.font",font);
 defaults.put("TextPane.font",font);

 // Enable/Disable tooltips
 ToolTipManager.sharedInstance().setEnabled(
 jEdit.getBooleanProperty("showTooltips"));

 initProxy();

 // we do this here instead of adding buffers to the bus.
 bufferManager.forEach(buffer ->
 {
 buffer.resetCachedProperties();
 buffer.propertiesChanged();
 });

 HistoryModel.setDefaultMax(getIntegerProperty("history",25));
 HistoryModel.setDefaultMaxSize(getIntegerProperty("historyMaxSize", 5000000));
 KillRing.getInstance().propertiesChanged(getIntegerProperty("history",25));
 Chunk.propertiesChanged(propertyManager);
 Log.setBeepOnOutput(jEdit.getBooleanProperty("debug.beepOnOutput"));

 if (getBooleanProperty("systrayicon"))
 {
 EventQueue.invokeLater(JTrayIconManager::addTrayIcon);
 }
 else
 {
 JTrayIconManager.removeTrayIcon();
 }
 EditBus.send(new PropertiesChanged(null));
} //}}}

//}}} Property methods fold end

//{{{ Plugin management methods

//{{{ getNotLoadedPluginJARs() method
/**
* Returns a list of plugin JARs pathnames that are not currently loaded
* by examining the user and system plugin directories.
* @since jEdit 3.2pre1
*/
public static String[] getNotLoadedPluginJARs()
{
 Collection<String> returnValue = new ArrayList<>();

 if(jEditHome != null)
 {
 String systemPluginDir = MiscUtilities
 .constructPath(jEditHome,"jars");

 String[] list = new File(systemPluginDir).list();
 if(list != null)
 getNotLoadedPluginJARs(returnValue,systemPluginDir,list);
 }

 if(settingsDirectory != null)
 {
 String userPluginDir = MiscUtilities
 .constructPath(settingsDirectory,"jars");
 String[] list = new File(userPluginDir).list();
 if(list != null)
 {
 getNotLoadedPluginJARs(returnValue,
 userPluginDir,list);
 }
 }

 String[] _returnValue = returnValue.toArray(StandardUtilities.EMPTY_STRING_ARRAY);
 return _returnValue;
} //}}}

//{{{ getPlugin() method
/**
* Returns the plugin with the specified class name.
* Only works for plugins that were loaded.
*/
public static EditPlugin getPlugin(String name)
{
 return getPlugin(name, false);
} //}}}

//{{{ getPlugin(String, boolean) method
/**
* Returns the plugin with the specified class name.
* If * <code>loadIfNecessary</code> is true, the plugin will be searched for,
* loaded, and activated in case it has not yet been loaded.
*
* @param name the classname of the main Plugin class.
* @param loadIfNecessary - loads plugin + dependencies if it is not loaded yet.
* @since jEdit 4.2pre4
*/
public static EditPlugin getPlugin(String name, boolean loadIfNecessary)
{
 if (name == null)
 {
 return null;
 }

 EditPlugin[] plugins = getPlugins();
 EditPlugin plugin = null;
 for (EditPlugin ep : plugins)
 {
 if (ep.getClassName().equals(name))
 {
 plugin = ep;
 break;
 }
 }
 if (!loadIfNecessary)
 {
 return plugin;
 }
 if (plugin instanceof EditPlugin.Deferred)
 {
 plugin.getPluginJAR().activatePlugin();
 plugin = plugin.getPluginJAR().getPlugin();
 }
 String jarPath = PluginJAR.findPlugin(name);
 PluginJAR pjar = PluginJAR.load(jarPath, true);
 return pjar.getPlugin();
} //}}}

//{{{ getPlugins() method
/**
* Returns an array of installed plugins.
*/
public static EditPlugin[] getPlugins()
{
 Collection<EditPlugin> pluginList = new ArrayList<EditPlugin>();
 for(int i = 0; i < jars.size(); i++)
 {
 EditPlugin plugin = jars.elementAt(i).getPlugin();
 if(plugin != null)
 pluginList.add(plugin);
 }

 EditPlugin[] array = new EditPlugin[pluginList.size()];
 pluginList.toArray(array);
 return array;
} //}}}

//{{{ getPluginJARs() method
/**
* Returns an array of installed plugins.
* @since jEdit 4.2pre1
*/
public static PluginJAR[] getPluginJARs()
{
 PluginJAR[] array = new PluginJAR[jars.size()];
 jars.copyInto(array);
 return array;
} //}}}

//{{{ getPluginJAR() method
/**
* Returns the JAR with the specified path name.
* @param path The path name
* @since jEdit 4.2pre1
*/
public static PluginJAR getPluginJAR(String path)
{
 for(int i = 0; i < jars.size(); i++)
 {
 PluginJAR jar = jars.elementAt(i);
 if(jar.getPath().equals(path))
 return jar;
 }

 return null;
} //}}}

//{{{ addPluginJAR() method
/**
* Loads the plugin JAR with the specified path. Some notes about this
* method:
*
* <ul>
* <li>Calling this at a time other than jEdit startup can have
* unpredictable results if the plugin has not been updated for the
* jEdit 4.2 plugin API.
* <li>You must make sure yourself the plugin is not already loaded.
* <li>After loading, you just make sure all the plugin's dependencies
* are satisified before activating the plugin, using the
* {@link PluginJAR#checkDependencies()} method.
* </ul>
*
* @param path The JAR file path
* @since jEdit 4.2pre1
*/
public static void addPluginJAR(String path)
{
 PluginJAR jar = new PluginJAR(new File(path));
 jars.addElement(jar);
 if (jar.init())
 {
 String jarName = MiscUtilities.getFileName(path);
 jEdit.unsetProperty("plugin-blacklist."+jarName);
 jEdit.unsetProperty("plugin." + jarName + ".disabled");
 EditBus.send(new PluginUpdate(jar,PluginUpdate.LOADED,false));
 if(!isMainThread())
 {
 EditBus.send(new DynamicMenuChanged("plugins"));
 initKeyBindings();
 }
 }
 else
 {
 jars.removeElement(jar);
 jar.uninit(false);
 }
} //}}}

//{{{ addPluginJARsFromDirectory() method
/**
* Loads all plugins in a directory.
* @param directory The directory
* @since jEdit 4.2pre1
*/
private static void addPluginJARsFromDirectory(String directory)
{
 Log.log(Log.NOTICE,jEdit.class,"Loading plugins from "
 + directory);

 File file = new File(directory);
 if(!(file.exists() && file.isDirectory()))
 return;
 String[] plugins = file.list();
 if(plugins == null)
 return;

 for (String plugin : plugins)
 {
 if (!plugin.toLowerCase().endsWith(".jar"))
 continue;

 String path = MiscUtilities.constructPath(directory, plugin);
 if (jEdit.getBooleanProperty("plugin-blacklist." + plugin))
 continue;

 addPluginJAR(path);
 }
} //}}}

//{{{ removePluginJAR() method
/**
* Unloads the given plugin JAR with the specified path. Note that
* calling this at a time other than jEdit shutdown can have
* unpredictable results if the plugin has not been updated for the
* jEdit 4.2 plugin API.
*
* @param jar The <code>PluginJAR</code> instance
* @param exit Set to true if jEdit is exiting; enables some
* shortcuts so the editor can close faster.
* @since jEdit 4.2pre1
*/
public static void removePluginJAR(PluginJAR jar, boolean exit)
{
 if(exit)
 {
 jar.uninit(true);
 }
 else
 {
 jar.uninit(false);
 jars.removeElement(jar);
 if (!isMainThread())
 initKeyBindings();
 }

 EditBus.send(new PluginUpdate(jar,PluginUpdate.UNLOADED,exit));
 if(!isMainThread() && !exit)
 EditBus.send(new DynamicMenuChanged("plugins"));
} //}}}

//}}}

//{{{ Action methods

//{{{ getActionContext() method
/**
* Returns the action context used to store editor actions.
* @since jEdit 4.2pre1
*/
public static ActionContext getActionContext()
{
 return actionContext;
} //}}}

//{{{ addActionSet() method
/**
* Adds a new action set to jEdit's list of ActionSets (viewable from the shortcuts
* option pane). By default, each plugin has one ActionSet,
* but some plugins may create dynamic action sets, such as ProjectViewer and Console.
* These plugins must call removeActionSet() when the plugin is unloaded.
*
* @since jEdit 4.0pre1
* @see #removeActionSet(ActionSet)
*/
public static void addActionSet(ActionSet actionSet)
{
 actionContext.addActionSet(actionSet);
} //}}}

//{{{ removeActionSet() method
/**
* Removes an action set from jEdit's list.
* Plugins that add a dynamic action set must call this method at plugin
* unload time.
* @since jEdit 4.2pre1
*/
public static void removeActionSet(ActionSet actionSet)
{
 actionContext.removeActionSet(actionSet);
} //}}}

//{{{ getBuiltInActionSet() method
/**
* Returns the set of commands built into jEdit.
* @since jEdit 4.2pre1
*/
public static ActionSet getBuiltInActionSet()
{
 return builtInActionSet;
} //}}}

// {{{ getActionSets() method
/**
* Returns all registered action sets.
*
* @return the ActionSet(s)
* @since jEdit 4.0pre1
*/
public static ActionSet[] getActionSets()
{
 return actionContext.getActionSets();
} // }}}

//{{{ getAction() method
/**
* Returns the specified action.
* @param name The action name
*/
public static EditAction getAction(String name)
{
 return actionContext.getAction(name);
} //}}}

//{{{ getActionSetForAction() method
/**
* Returns the action set that contains the specified action.
*
* @param action The action
* @since jEdit 4.2pre1
*/
public static ActionSet getActionSetForAction(String action)
{
 return actionContext.getActionSetForAction(action);
} //}}}

//{{{ getActionNames() method
/**
* Returns all registered action names.
*/
public static String[] getActionNames()
{
 return actionContext.getActionNames();
} //}}}

//}}}

//{{{ Edit mode methods

//{{{ reloadModes() method
/**
* Reloads all edit modes. User defined edit modes are loaded after
* global modes so that user modes supercede global modes.
* @since jEdit 3.2pre2
*/
public static void reloadModes()
{
 ModeProvider.instance.removeAll();

 //{{{ Load the global catalog first
 if(jEditHome == null)
 loadModeCatalog("/modes/catalog", true, false);
 else
 {
 loadModeCatalog(MiscUtilities.constructPath(jEditHome,
 "modes","catalog"), false, false);
 } //}}}

 //Load user catalog second so user modes override global modes.
 loadUserModeCatalog();

 // This reloads the token marker and sends a message
 // which causes edit panes to repaint their text areas
 bufferManager.getBuffers().forEach(Buffer::setMode);
} //}}}

//{{{ loadUserModeCatalog() method
private static void loadUserModeCatalog()
{
 if (settingsDirectory == null)
 return;

 Log.log(Log.DEBUG, jEdit.class, "Loading user mode catalog");
 Path userModeDir = Path.of(MiscUtilities.constructPath(settingsDirectory,"modes"));
 if(Files.notExists(userModeDir))
 {
 Log.log(Log.DEBUG, jEdit.class, "The user mode path doesn't exist, creating it");
 try
 {
 Files.createDirectories(userModeDir);
 }
 catch (IOException e)
 {
 Log.log(Log.DEBUG, jEdit.class, e, e);
 return;
 }
 }

 Path userCatalog = Path.of(MiscUtilities.constructPath(settingsDirectory,"modes","catalog"));
 if (Files.notExists(userCatalog))
 {
 try
 {
 // create dummy catalog
 Files.writeString(userCatalog, jEdit.getProperty("defaultCatalog"));
 }
 catch (IOException io)
 {
 Log.log(Log.ERROR,jEdit.class,io);
 }
 }
 else
 loadModeCatalog(userCatalog.toString(), false, true);
} //}}}

//{{{ getMode() method
/**
* Returns the edit mode with the specified name.
* @param name The edit mode
*/
public static Mode getMode(String name)
{
 return ModeProvider.instance.getMode(name);
} //}}}

//{{{ getModes() method
/**
* @return an array of installed edit modes that have been selected in the
* global options. The modes in this array will be sorted by mode name.
*/
public static Mode[] getModes()
{
 Mode[] modes = ModeProvider.instance.getModes();
 Set<Mode> selected = new HashSet<>();
 for (Mode mode : modes)
 {
 if (!jEdit.getBooleanProperty("mode.opt-out." + mode.getName(), false))
 {
 selected.add(mode);
 }
 }
 modes = selected.toArray(new Mode[0]);
 Arrays.sort(modes, new StandardUtilities.StringCompare<>(true));
 return modes;
} //}}}

//{{{ getAllModes() method
/**
* Returns an array of all installed edit modes. The modes in this array
* will be sorted by mode name.
*/
public static Mode[] getAllModes()
{
 Mode[] modes = ModeProvider.instance.getModes();
 Arrays.sort(modes, new StandardUtilities.StringCompare<>(true));
 return modes;
} //}}}

//}}}

//{{{ Buffer creation methods

//{{{ openFiles() method
/**
* Opens the file names specified in the argument array. This
* handles +line and +marker arguments just like the command
* line parser.
* @param parent The parent directory
* @param args The file names to open
* @since jEdit 3.2pre4
*/
public static Buffer openFiles(View view, String parent, String[] args)
{
 Buffer retVal = null;
 Buffer lastBuffer = null;

 for (String arg : args)
 {
 if (arg == null)
 continue;
 else if (arg.startsWith("+line:") || arg.startsWith("+marker:"))
 {
 if (lastBuffer != null)
 gotoMarker(view, lastBuffer, arg);
 continue;
 }

 lastBuffer = openFile((View) null, parent, arg, false, null);

 if (retVal == null && lastBuffer != null)
 retVal = lastBuffer;
 }

 if(view != null && retVal != null)
 {
 if(view.getBuffer() != retVal)
 {
 view.setBuffer(retVal);
 // Although gotoMarker code is set to execute its code in a runAfterIoTasks runnable,
 // the view.setBuffer command might end up being executed after the gotoMarker code,
 // if so the caret might not be visible when the buffer is changed, so we scroll to
 // caret overhere.
 if(!view.getTextArea().isCaretVisible())
 view.getTextArea().scrollToCaret(false);
 }
 }

 return retVal;
} //}}}

//{{{ openFile() methods
/**
* Opens a file, either immediately if the application is finished starting up,
* or after the first view has been created if not.
* @param path The file path
*
* @return the buffer if succesfully loaded immediately, or null otherwise
*
* @since jEdit 4.5pre1
*/
public static Buffer openFileAfterStartup(String path)
{
 if (isStartupDone())
 {
 return openFile(getActiveView(), path);
 }
 else
 {
 // These additional file names will be treated just as if they had
 // been passed on the command line
 additionalFiles.add(path);
 return null;
 }
}

/**
* Opens a file. Note that as of jEdit 2.5pre1, this may return
* null if the buffer could not be opened.
* @param view The view to open the file in
* @param path The file path
*
* @return the buffer, or null if jEdit was unable to load it
*
* @since jEdit 2.4pre1
*/
public static Buffer openFile(View view, String path)
{
 return openFile(view,null,path,false,new Hashtable<String,Object>());
}

/**
* Opens a file. This may return null if the buffer could not be
* opened for some reason.
* @param view The view to open the file in. If it is null, the file
* will be opened and added to the bufferSet of the current edit pane,
* but not selected
* @param parent The parent directory of the file
* @param path The path name of the file
* @param newFile True if the file should not be loaded from disk
* be prompted if it should be reloaded
* @param props Buffer-local properties to set in the buffer
*
* @return the buffer, or null if jEdit was unable to load it
*
* @since jEdit 3.2pre10
*/
public static Buffer openFile(View view, String parent,
 String path, boolean newFile, Hashtable<String,Object> props)
{
 return openFile(view == null ? null : view.getEditPane(), parent, path, newFile, props);
}

/**
* Opens a file. Note that as of jEdit 2.5pre1, this may return
* null if the buffer could not be opened.
* @param editPane the EditPane to open the file in.
* @param path The file path
*
* @return the buffer, or null if jEdit was unable to load it
*
* @since jEdit 4.3pre17
*/
public static Buffer openFile(EditPane editPane, String path)
{
 return openFile(editPane,null,path,false,new Hashtable<String,Object>());
}

/**
* Opens a file. This may return null if the buffer could not be
* opened for some reason.
* @param editPane the EditPane to open the file in.
* @param parent The parent directory of the file
* @param path The path name of the file
* @param newFile True if the file should not be loaded from disk
* be prompted if it should be reloaded
* @param props Buffer-local properties to set in the buffer
*
* @return the buffer, or null if jEdit was unable to load it
*
* @since jEdit 4.3pre17
*/
public static Buffer openFile(EditPane editPane, String parent,
 String path, boolean newFile, Hashtable<String,Object> props)
{
 PerspectiveManager.setPerspectiveDirty(true);

 if(editPane != null && parent == null && editPane.getBuffer() != null)
 parent = editPane.getBuffer().getDirectory();

 try
 {
 URL u = new URL(path);
 if ("file".equals(u.getProtocol()))
 path = URLDecoder.decode(u.getPath(), StandardCharsets.UTF_8);
 }
 catch (MalformedURLException e)
 {
 path = MiscUtilities.constructPath(parent,path);
 }

 if(props == null)
 props = new Hashtable<>();
 composeBufferPropsFromHistory(props, path);

 Buffer newBuffer;

 synchronized (editBusOrderingLock)
 {
 View view = editPane == null ? null : editPane.getView();
 synchronized(bufferManager.getBufferListLock())
 {
 Optional<Buffer> optionalBuffer = bufferManager.getBuffer(path);
 if (optionalBuffer.isPresent())
 {
 Buffer buffer = optionalBuffer.get();
 if(editPane != null)
 editPane.setBuffer(buffer,true);

 return buffer;
 }

 // if it is new, then it is untitled
 newBuffer = new Buffer(path,newFile,false,props,newFile);

 if (newBuffer.isBackup()) {
 Object[] args = {newBuffer.getName()};
 int result = GUIUtilities.option(view, "file-is-backup",
 args, JOptionPane.WARNING_MESSAGE,
 new String[]{
 jEdit.getProperty("file-is-backup.open"),
 jEdit.getProperty("file-is-backup.open-locked"),
 jEdit.getProperty("common.cancel")
 }, jEdit.getProperty("common.cancel"));
 if (result == 2)
 return null;
 if (result == 1)
 newBuffer.setLocked(true);
 }

 if(!newBuffer.load(view,false))
 return null;
 bufferManager.addBufferToList(newBuffer);
 if (editPane != null)
 bufferSetManager.addBuffer(editPane, newBuffer);
 else
 bufferSetManager.addBuffer(jEdit.getActiveView(), newBuffer);
 }

 EditBus.send(new BufferUpdate(newBuffer,view,BufferUpdate.CREATED));
 }

 if(editPane != null)
 editPane.setBuffer(newBuffer,true);

 return newBuffer;
} //}}}

//{{{ openTemporary() methods
/**
* Opens a temporary buffer. A temporary buffer is like a normal
* buffer, except that an event is not fired and the buffer is
* not added to the buffers list.
* If a buffer for the given <code>path</code> was
* already opened in jEdit, then this instance is returned.
* Otherwise jEdit will not store a reference
* to the returned Buffer object.
* This method is thread-safe.
*
* @param view The view to open the file in
* @param parent The parent directory of the file
* @param path The path name of the file
* @param newFile True if the file should not be loaded from disk
*
* @return the buffer, or null if jEdit was unable to load it
*
* @since jEdit 3.2pre10
*/
public static Buffer openTemporary(View view, String parent,
 String path, boolean newFile)
{
 return openTemporary(view, parent, path, newFile, null);
}

//{{{ openTemporary() methods
/**
* Opens a temporary buffer. A temporary buffer is like a normal
* buffer, except that an event is not fired and the buffer is
* not added to the buffers list.
* If a buffer for the given <code>path</code> was
* already opened in jEdit, then this instance is returned.
* Otherwise jEdit will not store a reference
* to the returned Buffer object.
* This method is thread-safe.
*
* @param view The view to open the file in
* @param parent The parent directory of the file
* @param path The path name of the file
* @param newFile True if the file should not be loaded from disk
 * @param untitled is the buffer untitled
*
* @return the buffer, or null if jEdit was unable to load it
*
* @since jEdit 5.5pre1
*/
public static Buffer openTemporary(View view, String parent,
 String path, boolean newFile, boolean untitled)
{
 return openTemporary(view, parent, path, newFile, null, untitled);
}

 /**
* Opens a temporary buffer.
* Details: {@link #openTemporary(View, String, String, boolean)}
*
* @param view The view to open the file in
* @param parent The parent directory of the file
* @param path The path name of the file
* @param newFile True if the file should not be loaded from disk
* @param props Buffer-local properties to set in the buffer
*
* @return the buffer, or null if jEdit was unable to load it
*
* @since jEdit 4.3pre10
*/
public static Buffer openTemporary(View view, String parent,
 String path, boolean newFile, Hashtable<String, Object> props)
{
 return openTemporary(view, parent, path, newFile, null, false);
 }

/**
* Opens a temporary buffer.
* Details: {@link #openTemporary(View, String, String, boolean)}
*
* @param view The view to open the file in
* @param parent The parent directory of the file
* @param path The path name of the file
* @param newFile True if the file should not be loaded from disk
* @param props Buffer-local properties to set in the buffer
 * @param untitled is the buffer untitled
*
* @return the buffer, or null if jEdit was unable to load it
*
* @since jEdit 4.3pre10
*/
public static Buffer openTemporary(View view, String parent,
 String path, boolean newFile, Hashtable<String, Object> props, boolean untitled)
{
 if(view != null && parent == null)
 parent = view.getBuffer().getDirectory();

 if(MiscUtilities.isURL(path))
 {
 if("file".equals(MiscUtilities.getProtocolOfURL(path)))
 path = path.substring(5);
 }

 path = MiscUtilities.constructPath(parent,path);

 if(props == null)
 props = new Hashtable<>();
 composeBufferPropsFromHistory(props, path);

 synchronized(bufferManager.getBufferListLock())
 {
 Optional<Buffer> bufferOptional = bufferManager.getBuffer(path);

 if(bufferOptional.isPresent())
 return bufferOptional.get();

 Buffer buffer = new Buffer(path,newFile,true,props,untitled);
 buffer.setBooleanProperty(Buffer.ENCODING_AUTODETECT, true);
 if(!buffer.load(view,false))
 return null;
 else
 return buffer;
 }
} //}}}

//{{{ commitTemporary() method
/**
* Adds a temporary buffer to the buffer list. This must be done
* before allowing the user to interact with the buffer in any
* way.
* @param buffer The buffer
*/
public static void commitTemporary(Buffer buffer)
{
 if(!buffer.isTemporary())
 return;

 PerspectiveManager.setPerspectiveDirty(true);

 bufferManager.addBufferToList(buffer);
 buffer.commitTemporary();

 // send full range of events to avoid breaking plugins
 EditBus.send(new BufferUpdate(buffer,null,BufferUpdate.CREATED));
 EditBus.send(new BufferUpdate(buffer,null,BufferUpdate.LOAD_STARTED));
 EditBus.send(new BufferUpdate(buffer,null,BufferUpdate.LOADED));
} //}}}

//{{{ newFile() methods
/**
* Creates a new `untitled' file.
*
* @param view The view to create the file in
*
* @return the new buffer
*/
public static Buffer newFile(View view)
{
 return newFile(view == null ? null : view.getEditPane());
}

/**
* Creates a new `untitled' file.
* @param view The view to create the file in
* @param dir The directory to create the file in
*
* @return the new buffer
*
* @since jEdit 3.1pre2
*/
public static Buffer newFile(View view, String dir)
{
 EditPane editPane = null;
 if (view != null)
 {
 editPane = view.getEditPane();
 }
 else
 {
 View v = getActiveView();
 if (v != null)
 {
 editPane = v.getEditPane();
 }
 }
 return newFile(editPane, dir);
}

/**
* Creates a new `untitled' file.
*
* @param editPane The editPane to create the file in
*
* @return the new buffer
* @since jEdit 4.3pre17
*/
public static Buffer newFile(EditPane editPane)
{
 String path;

 if(editPane != null && editPane.getBuffer() != null)
 {
 path = editPane.getBuffer().getDirectory();
 } else {
 File backupDir = MiscUtilities.prepareBackupDirectory(System.getProperty("user.home"));
 path = backupDir.getPath();
 }
 VFS vfs = VFSManager.getVFSForPath(path);
 // don't want 'New File' to create a read only buffer
 // if current file is on SQL VFS or something
 if((vfs.getCapabilities() & VFS.WRITE_CAP) == 0)
 path = System.getProperty("user.home");

 return newFile(editPane,path);
}

/**
* Creates a new `untitled' file.
*
* @param editPane The editPane to create the file in
* @param dir The directory to create the file in
*
* @return the new buffer
*
* @since jEdit 4.3pre17
*/
public static Buffer newFile(EditPane editPane, String dir)
{
 if (editPane != null)
 {
 BufferSet bufferSet = editPane.getBufferSet();
 Buffer[] buffers = bufferSet.getAllBuffers();
 for (Buffer buf:buffers)
 {
 if (buf.isUntitled() && !buf.isDirty())
 {
 if (!MiscUtilities.getParentOfPath(buf.getPath()).equals(dir))
 {
 // Find the highest Untitled-n file
 int untitledCount = getNextUntitledBufferId();

 Buffer newBuffer = openFile(editPane,dir,"Untitled-" + untitledCount,true,null);
 jEdit.closeBuffer(editPane, buf);
 return newBuffer;
 }
 /* if "never mark untitled buffers dirty"
* is selected, we might have contents in non-dirty
* untitled buffers. We must clear those contents
* if user requested new file.
*/
 int l = buf.getLength();
 if (l > 0)
 buf.remove(0, l);
 editPane.setBuffer(buf);
 return buf;
 }
 }
 }

 // Find the highest Untitled-n file
 int untitledCount = getNextUntitledBufferId();

 return openFile(editPane,dir,"Untitled-" + untitledCount,true,null);
} //}}}

//}}}

//{{{ Buffer management methods

//{{{ closeBuffer() method
/**
* Closes a buffer. If there are unsaved changes, the user is
* prompted if they should be saved first.
* @param view The view
* @param buffer The buffer
* @return True if the buffer was really closed, false otherwise
*/
public static boolean closeBuffer(View view, Buffer buffer)
{
 // Wait for pending I/O requests
 if(buffer.isPerformingIO())
 {
 TaskManager.instance.waitForIoTasks();
 if(VFSManager.errorOccurred())
 return false;
 }

 boolean doNotSave = false;
 if(buffer.isDirty())
 {
 if (buffer.isUntitled() && jEdit.getBooleanProperty("suppressNotSavedConfirmUntitled"))
 {
 _closeBuffer(view, buffer, true);
 return true;
 }
 Object[] args = { buffer.getName() };
 int result = GUIUtilities.confirm(view,"notsaved",args,
 JOptionPane.YES_NO_CANCEL_OPTION,
 JOptionPane.WARNING_MESSAGE);
 if(result == JOptionPane.YES_OPTION)
 {
 if(!buffer.save(view,null,true))
 return false;

 TaskManager.instance.waitForIoTasks();
 if(buffer.getBooleanProperty(BufferIORequest
 .ERROR_OCCURRED))
 {
 return false;
 }
 }
 else if(result != JOptionPane.NO_OPTION) {
 // cancel
 return false;
 }
 else if(result == JOptionPane.NO_OPTION) {
 // when we close an untitled buffer, cos we do not want to save it by answering No,
 // mark to delete the autosave file
 doNotSave = true;
 }

 }

 _closeBuffer(view,buffer, doNotSave);

 return true;
} //}}}

//{{{ closeBuffer() method
/**
* Close a buffer.
* The buffer is first removed from the EditPane's bufferSet.
* If the buffer is not in any bufferSet after that, it is closed
* @param editPane the edit pane (it cannot be null)
* @param buffer the buffer (it cannot be null)
* @since jEdit 4.3pre15
*/
public static void closeBuffer(EditPane editPane, Buffer buffer)
{
 switch (bufferSetManager.getScope())
 {
 case global:
 closeBuffer(editPane.getView(), buffer);
 break;
 case view:
 List<View> views = viewManager.getViews();
 int viewOwner = 0;
 for (View view : views)
 {
 BufferSet bufferSet = view.getEditPane().getBufferSet();
 // no need to check every bufferSet since it's view scope
 if (bufferSet.indexOf(buffer) != -1)
 {
 viewOwner++;
 if (viewOwner > 1)
 break;
 }
 }
 if (viewOwner > 1)
 {
 // the buffer is in several view, we can remove it from bufferSet
 bufferSetManager.removeBuffer(editPane, buffer);
 }
 else
 {
 closeBuffer(editPane.getView(), buffer);
 }
 break;
 case editpane:
 int bufferSetsCount = bufferSetManager.countBufferSets(buffer);
 if (bufferSetsCount < 2)
 {
 closeBuffer(editPane.getView(), buffer);
 }
 else
 {
 bufferSetManager.removeBuffer(editPane, buffer);
 }
 break;
 }
} //}}}

//{{{ _closeBuffer() method
/**
* Closes the buffer, even if it has unsaved changes.
* @param view The view, may be null
* @param buffer The buffer
*
* @exception NullPointerException if the buffer is null
*
* @since jEdit 2.2pre1
*/
public static void _closeBuffer(View view, Buffer buffer)
{
 _closeBuffer(view, buffer, true);
}

//{{{ _closeBuffer() method
/**
* Closes the buffer, even if it has unsaved changes.
* @param view The view, may be null
* @param buffer The buffer
* @param doNotSave we do not want to keep the autosave file
*
* @exception NullPointerException if the buffer is null
*
* @since jEdit 2.2pre1
*/
public static void _closeBuffer(View view, Buffer buffer, boolean doNotSave)
{
 if(buffer.isClosed())
 {
 // can happen if the user presses C+w twice real
 // quick and the buffer has unsaved changes
 return;
 }

 // in case of a temporary buffer, just close it
 if(buffer.isTemporary())
 {
 buffer.close();
 return;
 }

 PerspectiveManager.setPerspectiveDirty(true);

 if(!buffer.isNewFile())
 {
 if(view != null)
 view.getEditPane().saveCaretInfo();
 Integer _caret = (Integer)buffer.getProperty(Buffer.CARET);
 int caret = _caret == null ? 0 : _caret;

 BufferHistory.setEntry(buffer.getPath(),caret,
 (Selection[])buffer.getProperty(Buffer.SELECTION),
 buffer.getStringProperty(JEditBuffer.ENCODING),
 buffer.getMode().getName());
 }

 EditBus.send(new BufferUpdate(buffer,view,BufferUpdate.CLOSING));

 bufferManager.removeBuffer(buffer);

 buffer.close(doNotSave);
 DisplayManager.bufferClosed(buffer);
 bufferSetManager.removeBuffer(buffer);
 EditBus.send(new BufferUpdate(buffer,view,BufferUpdate.CLOSED));
 if(jEdit.getBooleanProperty("persistentMarkers"))
 buffer.updateMarkersFile(view);
} //}}}

//{{{ closeAllBuffers() methods
/**
* Closes all open buffers.
* @param view The view
*
* @return true if all buffers were closed, false otherwise
*/
public static boolean closeAllBuffers(View view)
{
 return closeAllBuffers(view,false);
}
/**
* Closes all open buffers.
* @param view The view
* @param isExiting This must be false unless this method is
* being called by the exit() method
*
* @return true if all buffers were closed, false otherwise
*/
public static boolean closeAllBuffers(View view, boolean isExiting)
{
 if(view != null)
 view.getEditPane().saveCaretInfo();

 boolean saveRecent = !(isExiting && jEdit.getBooleanProperty("restore"));

 boolean autosaveUntitled = jEdit.getBooleanProperty("autosaveUntitled");

 boolean suppressNotSavedConfirmUntitled = jEdit.getBooleanProperty("suppressNotSavedConfirmUntitled") || autosaveUntitled;

 Optional<Buffer> firstDirty = bufferManager
 .getBuffers(Buffer::isDirty)
 .stream()
 .filter(buffer -> !(buffer.isUntitled() && suppressNotSavedConfirmUntitled))
 .findFirst();

 if (firstDirty.isPresent())
 {
 boolean ok = new CloseDialog(view).isOK();
 if(!ok)
 return false;
 }

 // Wait for pending I/O requests
 TaskManager.instance.waitForIoTasks();
 if(VFSManager.errorOccurred())
 return false;

 bufferManager.closeAllBuffers(view,
 isExiting,
 autosaveUntitled,
 saveRecent,
 jEdit.getBooleanProperty("persistentMarkers"));

 PerspectiveManager.setPerspectiveDirty(true);

 return true;
} //}}}

//{{{ saveAllBuffers() method
/**
* Saves all open buffers.
* @param view The view
* @since jEdit 4.2pre1
*/
public static void saveAllBuffers(View view)
{
 saveAllBuffers(view,jEdit.getBooleanProperty("confirmSaveAll"));
} //}}}

//{{{ saveAllBuffers() method
/**
* Saves all open buffers.
* @param view The view
* @param confirm If true, a confirmation dialog will be shown first
* @since jEdit 2.7pre2
*/
public static void saveAllBuffers(View view, boolean confirm)
{
 Collection<Buffer> dirtyBuffers = bufferManager.getBuffers(Buffer::isDirty);

 Buffer current = view.getBuffer();

 Stream<Buffer> toSaveBufferStream;
 if (confirm && !dirtyBuffers.isEmpty())
 {
 DefaultListModel<String> listModel = new DefaultListModel<>();
 dirtyBuffers
 .stream()
 .map(Buffer::getPath)
 .forEach(listModel::addElement);

 JList<String> bufferList = new JList<>(listModel);
 bufferList.setVisibleRowCount(Math.min(listModel.getSize(), 10));
 bufferList.setSelectionInterval(0, listModel.getSize() - 1);

 int result = JOptionPane.showConfirmDialog(view,
 new Object[]{ new JLabel(jEdit.getProperty("saveall.message")), new JScrollPane(bufferList) },
 jEdit.getProperty("saveall.title"),
 JOptionPane.YES_NO_OPTION,
 JOptionPane.QUESTION_MESSAGE);
 if(result != JOptionPane.YES_OPTION)
 return;

 List<String> dirtySelectedBuffers = bufferList.getSelectedValuesList();
 toSaveBufferStream = dirtyBuffers
 .stream()
 .filter(buffer -> dirtySelectedBuffers.contains(buffer.getPath()));
 }
 else
 {
 toSaveBufferStream = dirtyBuffers.stream();
 }
 toSaveBufferStream.forEach(buffer ->
 {
 if (buffer.isNewFile()) view.setBuffer(buffer);
 buffer.save(view, null, true, true);
 });

 view.setBuffer(current);
} //}}}

//{{{ reloadAllBuffers() method
/**
* Reloads all open buffers.
* @param view The view
* @param confirm If true, a confirmation dialog will be shown first
* if any buffers are dirty
* @since jEdit 2.7pre2
*/
public static void reloadAllBuffers(View view, boolean confirm)
{
 List<Buffer> titledBuffers = jEdit.getBufferManager().getTitledBuffers();

 if (confirm)
 {
 // Find a dirty buffer that is not untitled
 Optional<Buffer> dirtyBuffer = titledBuffers
 .stream()
 .filter(JEditBuffer::isDirty)
 .findFirst();
 if (dirtyBuffer.isPresent())
 {
 int result = GUIUtilities.confirm(view,"reload-all",null,
 JOptionPane.YES_NO_OPTION,
 JOptionPane.QUESTION_MESSAGE);
 if(result != JOptionPane.YES_OPTION)
 return;
 }
 }

 // save caret info. Buffer.load() will load it.
 visit(new SaveCaretInfoVisitor());

 titledBuffers.forEach(buffer -> buffer.load(view, true));
} //}}}

//{{{ _getBuffer() method
/**
* Returns the buffer with the specified path name. The path name
* must be an absolute, canonical, path.
*
* @param path The path name
*
* @return the searched buffer, or null if it is not already open
*
* @see MiscUtilities#constructPath(String,String)
* @see MiscUtilities#resolveSymlinks(String)
* @see BufferManager#getBuffer(String)
*
* @since jEdit 4.2pre7
*/
@Deprecated(since = "5.6pre1")
public static Buffer _getBuffer(String path)
{
 return bufferManager._getBuffer(path).orElse(null);
} //}}}

//{{{ getBuffer() method
/**
* Returns the buffer with the specified path name. The path name
* must be an absolute path. This method automatically resolves
* symbolic links. If performance is critical, cache the canonical
* path and call {@link BufferManager#getBuffer(String)} instead.
*
* @param path The path name
*
* @return the searched buffer, or null if it is not already open
*
* @see MiscUtilities#constructPath(String,String)
* @see MiscUtilities#resolveSymlinks(String)
*/
@Deprecated(since = "5.6pre1")
public static Buffer getBuffer(String path)
{
 return bufferManager.getBuffer(path).orElse(null);
} //}}}

//{{{ getBuffers() method
/**
* Returns an array of all open buffers from any View.
* @return an array of all open buffers
* @see View#getBuffers()
*/
@Deprecated(since = "5.6pre1")
public static Buffer[] getBuffers()
{
 return bufferManager.getBuffers().toArray(BufferManagerImpl.EMPTY_BUFFER_ARRAY);
} //}}}

//{{{ getBufferCount() method
/**
* Returns the number of open buffers.
*/
public static int getBufferCount()
{
 return bufferManager.size();
} //}}}

//{{{ getFirstBuffer() method
/**
* Returns the first buffer.
*/
public static Buffer getFirstBuffer()
{
 return bufferManager.getFirst();
} //}}}

//{{{ getLastBuffer() method
/**
* Returns the last buffer.
* @return the last buffer
*/
public static Buffer getLastBuffer()
{
 return bufferManager.getLast();
} //}}}

//{{{ moveBuffer() method
/**
* Moves a buffer from a old position to a new position in the
* BufferSet used in an EditPane.
* @param editPane The EditPane in which a buffer is moved
* @param oldPosition The position before the move
* @param newPosition The position after the move
*/
public static void moveBuffer(EditPane editPane,
 int oldPosition, int newPosition)
{
--> --------------------

--> maximum size reached

--> --------------------

¤ Dauer der Verarbeitung: 0.94 Sekunden (vorverarbeitet) ¤

Download des Quellennavigators
Download des sprechenden Kalenders
in der Quellcodebibliothek suchen

Haftungshinweis

Die Informationen auf dieser Webseite wurden nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit, noch Qualität der bereit gestellten Informationen zugesichert.

Bemerkung:

Die farbliche Syntaxdarstellung ist noch experimentell.