FrameContainers now manage ConfigManagers instead of requiring their descendents to implement a getConfigManager method

git-svn-id: http://svn.dmdirc.com/trunk@3739 00569f92-eb28-0410-84fd-f71c24880f

src/com/dmdirc/Channel.java

@@ -76,9 +76,6 @@ public final class Channel extends MessageTarget
     /** The tabcompleter used for this channel. */
     private final TabCompleter tabCompleter;
 
-    /** The config manager for this channel. */
-    private final ConfigManager configManager;
-
     /** A list of previous topics we've seen. */
     private final RollingList<Topic> topics;
 
@@ -105,23 +102,21 @@ public final class Channel extends MessageTarget
      * this channel
      */
     public Channel(final Server newServer, final ChannelInfo newChannelInfo) {
-        super("channel");
+        super("channel", new ConfigManager(newServer.getIrcd(), newServer.getNetwork(),
+                newServer.getName(), newChannelInfo.getName()));
 
         channelInfo = newChannelInfo;
         server = newServer;
 
-        configManager = new ConfigManager(server.getIrcd(), server.getNetwork(),
-                server.getName(), channelInfo.getName());
-
-        configManager.addChangeListener("channel", this);
-        configManager.addChangeListener("ui", "shownickcoloursintext", this);
+        getConfigManager().addChangeListener("channel", this);
+        getConfigManager().addChangeListener("ui", "shownickcoloursintext", this);
 
-        topics = new RollingList<Topic>(configManager.getOptionInt("channel",
+        topics = new RollingList<Topic>(getConfigManager().getOptionInt("channel",
                 "topichistorysize", 10));
 
-        sendWho = configManager.getOptionBool("channel", "sendwho", false);
-        showModePrefix = configManager.getOptionBool("channel", "showmodeprefix", false);
-        showColours = configManager.getOptionBool("ui", "shownickcoloursintext", false);
+        sendWho = getConfigManager().getOptionBool("channel", "sendwho", false);
+        showModePrefix = getConfigManager().getOptionBool("channel", "showmodeprefix", false);
+        showColours = getConfigManager().getOptionBool("ui", "shownickcoloursintext", false);
 
         tabCompleter = new TabCompleter(server.getTabCompleter());
         tabCompleter.addEntries(TabCompletionType.COMMAND,
@@ -148,7 +143,7 @@ public final class Channel extends MessageTarget
      */
     private void registerCallbacks() {
         eventHandler.registerCallbacks();
-        configManager.migrate(server.getIrcd(), server.getNetwork(),
+        getConfigManager().migrate(server.getIrcd(), server.getNetwork(),
                 server.getName(), channelInfo.getName());
     }
 
@@ -159,12 +154,6 @@ public final class Channel extends MessageTarget
         window.open();
     }
 
-    /** {@inheritDoc} */
-    @Override
-    public ConfigManager getConfigManager() {
-        return configManager;
-    }
-
     /** {@inheritDoc} */
     @Override
     public void sendLine(final String line) {
@@ -362,7 +351,7 @@ public final class Channel extends MessageTarget
         }
 
         // 3: Trigger any actions neccessary
-        part(configManager.getOption("general", "partmessage"));
+        part(getConfigManager().getOption("general", "partmessage"));
 
         // 4: Trigger action for the window closing
         ActionManager.processEvent(CoreActionType.CHANNEL_CLOSED, null, this);
@@ -498,11 +487,11 @@ public final class Channel extends MessageTarget
     @Override
     public void configChanged(final String domain, final String key) {
         if ("sendwho".equals(key)) {
-            sendWho = configManager.getOptionBool("channel", "sendwho", false);
+            sendWho = getConfigManager().getOptionBool("channel", "sendwho", false);
         } else if ("showmodeprefix".equals(key)) {
-            showModePrefix = configManager.getOptionBool("channel", "showmodeprefix", false);
+            showModePrefix = getConfigManager().getOptionBool("channel", "showmodeprefix", false);
         } else if ("shownickcoloursintext".equals(key)) {
-            showColours = configManager.getOptionBool("ui", "shownickcoloursintext", false);
+            showColours = getConfigManager().getOptionBool("ui", "shownickcoloursintext", false);
         }
     }
 

src/com/dmdirc/CustomWindow.java

@@ -22,7 +22,6 @@
 
 package com.dmdirc;
 
-import com.dmdirc.config.ConfigManager;
 import com.dmdirc.config.IdentityManager;
 import com.dmdirc.ui.WindowManager;
 import com.dmdirc.ui.interfaces.Window;
@@ -55,7 +54,7 @@ public class CustomWindow extends FrameContainer {
      */
     public CustomWindow(final String name, final String title,
             final Window parent) {
-        super("custom");
+        super("custom", parent.getConfigManager());
 
         this.name = name;
         this.title = title;
@@ -76,7 +75,7 @@ public class CustomWindow extends FrameContainer {
      * @param title The parent of this custom window
      */
     public CustomWindow(final String name, final String title) {
-        super("custom");
+        super("custom", IdentityManager.getGlobalConfig());
 
         this.name = name;
         this.title = title;
@@ -144,11 +143,4 @@ public class CustomWindow extends FrameContainer {
         return title;
     }
 
-    /** {@inheritDoc} */
-    @Override
-    public ConfigManager getConfigManager() {
-        return parent == null ? IdentityManager.getGlobalConfig() : parent
-                .getConfigManager();
-    }
-
 }

src/com/dmdirc/FrameContainer.java

@@ -53,14 +53,20 @@ public abstract class FrameContainer {
 
     /** The name of the icon being used for this container's frame. */
     private String icon;
+    
+    /** The config manager for this container. */
+    private final ConfigManager config;
 
     /**
      * Instantiate new frame container.
      * 
      * @param icon The icon to use for this container
+     * @param config The config manager for this container
      */
-    public FrameContainer(final String icon) {
+    public FrameContainer(final String icon, final ConfigManager config) {
         setIcon(icon);
+        
+        this.config = config;
     }
 
     /**
@@ -132,7 +138,9 @@ public abstract class FrameContainer {
      *
      * @return the associated config manager
      */
-    public abstract ConfigManager getConfigManager();
+    public final ConfigManager getConfigManager() {
+        return config;
+    }
 
     /**
      * Requests that this object's frame be activated.

src/com/dmdirc/GlobalWindow.java

@@ -25,7 +25,6 @@ package com.dmdirc;
 import com.dmdirc.commandparser.CommandManager;
 import com.dmdirc.commandparser.CommandType;
 import com.dmdirc.commandparser.parsers.GlobalCommandParser;
-import com.dmdirc.config.ConfigManager;
 import com.dmdirc.config.IdentityManager;
 import com.dmdirc.ui.WindowManager;
 import com.dmdirc.ui.input.TabCompleter;
@@ -44,7 +43,7 @@ public class GlobalWindow extends WritableFrameContainer {
 
     /** Creates a new instance of GlobalWindow. */
     public GlobalWindow() {
-        super("icon");
+        super("icon", IdentityManager.getGlobalConfig());
 
         final TabCompleter tabCompleter = new TabCompleter();
         tabCompleter.addEntries(TabCompletionType.COMMAND,
@@ -108,10 +107,4 @@ public class GlobalWindow extends WritableFrameContainer {
         return 0;
     }
 
-    /** {@inheritDoc} */
-    @Override
-    public ConfigManager getConfigManager() {
-        return IdentityManager.getGlobalConfig();
-    }
-
 }

src/com/dmdirc/MessageTarget.java

@@ -22,6 +22,8 @@
 
 package com.dmdirc;
 
+import com.dmdirc.config.ConfigManager;
+
 /**
  * Defines common methods for objects that you can send messages to (such as
  * channels and queries).
@@ -34,9 +36,10 @@ public abstract class MessageTarget extends WritableFrameContainer {
      * Creates a new MessageTarget.
      * 
      * @param icon The icon to use for this target
+     * @param config The config manager to use for this target
      */
-    public MessageTarget(final String icon) {
-        super(icon);
+    public MessageTarget(final String icon, final ConfigManager config) {
+        super(icon, config);
     }
 
     /**

src/com/dmdirc/Query.java

@@ -26,8 +26,6 @@ import com.dmdirc.actions.ActionManager;
 import com.dmdirc.actions.CoreActionType;
 import com.dmdirc.commandparser.CommandManager;
 import com.dmdirc.commandparser.CommandType;
-import com.dmdirc.config.ConfigManager;
-import com.dmdirc.config.IdentityManager;
 import com.dmdirc.logger.ErrorLevel;
 import com.dmdirc.logger.Logger;
 import com.dmdirc.parser.ClientInfo;
@@ -82,7 +80,7 @@ public final class Query extends MessageTarget implements
      * @param newServer The server object that this Query belongs to
      */
     public Query(final Server newServer, final String newHost) {
-        super("query");
+        super("query", newServer.getConfigManager());
 
         this.server = newServer;
         this.host = newHost;
@@ -386,17 +384,4 @@ public final class Query extends MessageTarget implements
         Main.getUI().getMainWindow().setActiveFrame(window);
     }
 
-    /** {@inheritDoc} */
-    @Override
-    public ConfigManager getConfigManager() {
-        if (server == null) {
-            Logger.appError(ErrorLevel.LOW, "Tried to retrieve config manager"
-                    + " from a query with no server",
-                    new IllegalStateException("My host: " + host));
-            return IdentityManager.getGlobalConfig();
-        }
-
-        return server.getConfigManager();
-    }
-
 }

src/com/dmdirc/Raw.java

@@ -22,7 +22,6 @@
 
 package com.dmdirc;
 
-import com.dmdirc.config.ConfigManager;
 import com.dmdirc.logger.ErrorLevel;
 import com.dmdirc.logger.Logger;
 import com.dmdirc.parser.IRCParser;
@@ -61,7 +60,7 @@ public final class Raw extends WritableFrameContainer implements IDataIn,
      * @param newServer the server to monitor
      */
     public Raw(final Server newServer) {
-        super("raw");
+        super("raw", newServer.getConfigManager());
 
         this.server = newServer;
 
@@ -153,10 +152,4 @@ public final class Raw extends WritableFrameContainer implements IDataIn,
         return server.getMaxLineLength();
     }
 
-    /** {@inheritDoc} */
-    @Override
-    public ConfigManager getConfigManager() {
-        return server.getConfigManager();
-    }
-
 }

src/com/dmdirc/Server.java

@@ -109,8 +109,6 @@ public final class Server extends WritableFrameContainer implements Serializable
     private final TabCompleter tabCompleter = new TabCompleter();
     /** The last activated internal frame for this server. */
     private FrameContainer activeFrame = this;
-    /** The config manager for this server. */
-    private ConfigManager configManager;
 
     /** Our reason for being away, if any. */
     private String awayMessage;
@@ -153,13 +151,11 @@ public final class Server extends WritableFrameContainer implements Serializable
      */
     public Server(final String server, final int port, final String password,
             final boolean ssl, final Identity profile, final List<String> autochannels) {
-        super("server-disconnected");
+        super("server-disconnected", new ConfigManager("", "", server));
 
         serverInfo = new ServerInfo(server, port, password);
         serverInfo.setSSL(ssl);
 
-        configManager = new ConfigManager("", "", server);
-
         window = Main.getUI().getServer(this);
 
         ServerManager.getServerManager().registerServer(this);
@@ -189,9 +185,9 @@ public final class Server extends WritableFrameContainer implements Serializable
                     channel.checkWho();
                 }
             }
-        }, 0, configManager.getOptionInt(DOMAIN_GENERAL, "whotime", 60000));
+        }, 0, getConfigManager().getOptionInt(DOMAIN_GENERAL, "whotime", 60000));
 
-        if (configManager.getOptionBool(DOMAIN_GENERAL, "showrawwindow", false)) {
+        if (getConfigManager().getOptionBool(DOMAIN_GENERAL, "showrawwindow", false)) {
             addRaw();
         }
 
@@ -227,7 +223,7 @@ public final class Server extends WritableFrameContainer implements Serializable
                 return;
             case CONNECTED:
             case CONNECTING:
-                disconnect(configManager.getOption(DOMAIN_GENERAL, "quitmessage"));
+                disconnect(getConfigManager().getOption(DOMAIN_GENERAL, "quitmessage"));
                 break;
             case DISCONNECTING:
                 onSocketClosed();
@@ -249,7 +245,7 @@ public final class Server extends WritableFrameContainer implements Serializable
 
         this.profile = profile;
 
-        configManager = new ConfigManager("", "", server);
+        getConfigManager().migrate("", "", server);
 
         updateIcon();
 
@@ -262,8 +258,8 @@ public final class Server extends WritableFrameContainer implements Serializable
         parser.setCreateFake(true);
         parser.setIgnoreList(ignoreList);
 
-        if (configManager.hasOption(DOMAIN_GENERAL, "bindip")) {
-            parser.setBindIP(configManager.getOption(DOMAIN_GENERAL, "bindip"));
+        if (getConfigManager().hasOption(DOMAIN_GENERAL, "bindip")) {
+            parser.setBindIP(getConfigManager().getOption(DOMAIN_GENERAL, "bindip"));
         }
 
         doCallbacks();
@@ -300,14 +296,14 @@ public final class Server extends WritableFrameContainer implements Serializable
      * Reconnects to the IRC server.
      */
     public void reconnect() {
-        reconnect(configManager.getOption(DOMAIN_GENERAL, "reconnectmessage"));
+        reconnect(getConfigManager().getOption(DOMAIN_GENERAL, "reconnectmessage"));
     }
 
     /**
      * Disconnects from the server with the default quit message.
      */
     public void disconnect() {
-        disconnect(configManager.getOption(DOMAIN_GENERAL, "quitmessage"));
+        disconnect(getConfigManager().getOption(DOMAIN_GENERAL, "quitmessage"));
     }
 
     /**
@@ -339,13 +335,13 @@ public final class Server extends WritableFrameContainer implements Serializable
             parser.disconnect(reason);
         }
 
-        if (configManager.getOptionBool(DOMAIN_GENERAL, "closechannelsonquit", false)) {
+        if (getConfigManager().getOptionBool(DOMAIN_GENERAL, "closechannelsonquit", false)) {
             closeChannels();
         } else {
             clearChannels();
         }
 
-        if (configManager.getOptionBool(DOMAIN_GENERAL, "closequeriesonquit", false)) {
+        if (getConfigManager().getOptionBool(DOMAIN_GENERAL, "closequeriesonquit", false)) {
             closeQueries();
         }
     }
@@ -355,7 +351,7 @@ public final class Server extends WritableFrameContainer implements Serializable
      */
     private void doDelayedReconnect() {
         final int delay = Math.max(1,
-                configManager.getOptionInt(DOMAIN_GENERAL, "reconnectdelay", 5000));
+                getConfigManager().getOptionInt(DOMAIN_GENERAL, "reconnectdelay", 5000));
 
         handleNotification("connectRetry", getName(), delay / 1000);
 
@@ -801,12 +797,6 @@ public final class Server extends WritableFrameContainer implements Serializable
         return window;
     }
 
-    /** {@inheritDoc} */
-    @Override
-    public ConfigManager getConfigManager() {
-        return configManager;
-    }
-
     /**
      * Retrieves the current state for this server.
      *
@@ -1046,11 +1036,11 @@ public final class Server extends WritableFrameContainer implements Serializable
         final String sansIrcd = "numeric_" + snumeric;
         String target = null;
 
-        if (configManager.hasOption("formatter", withIrcd)) {
+        if (getConfigManager().hasOption("formatter", withIrcd)) {
             target = withIrcd;
-        } else if (configManager.hasOption("formatter", sansIrcd)) {
+        } else if (getConfigManager().hasOption("formatter", sansIrcd)) {
             target = sansIrcd;
-        } else if (configManager.hasOption("formatter", "numeric_unknown")) {
+        } else if (getConfigManager().hasOption("formatter", "numeric_unknown")) {
             target = "numeric_unknown";
         }
 
@@ -1087,19 +1077,21 @@ public final class Server extends WritableFrameContainer implements Serializable
 
         updateIcon();
 
-        if (configManager.getOptionBool(DOMAIN_GENERAL, "closechannelsondisconnect", false)) {
+        if (getConfigManager().getOptionBool(DOMAIN_GENERAL,
+                "closechannelsondisconnect", false)) {
             closeChannels();
         } else {
             clearChannels();
         }
 
-        if (configManager.getOptionBool(DOMAIN_GENERAL, "closequeriesondisconnect", false)) {
+        if (getConfigManager().getOptionBool(DOMAIN_GENERAL,
+                "closequeriesondisconnect", false)) {
             closeQueries();
         }
 
         removeInvites();
 
-        if (configManager.getOptionBool(DOMAIN_GENERAL, "reconnectondisconnect", false)
+        if (getConfigManager().getOptionBool(DOMAIN_GENERAL, "reconnectondisconnect", false)
                 && myState == ServerState.TRANSIENTLY_DISCONNECTED) {
             doDelayedReconnect();
         }
@@ -1147,7 +1139,8 @@ public final class Server extends WritableFrameContainer implements Serializable
 
         handleNotification("connectError", getName(), description);
 
-        if (configManager.getOptionBool(DOMAIN_GENERAL, "reconnectonconnectfailure", false)) {
+        if (getConfigManager().getOptionBool(DOMAIN_GENERAL,
+                "reconnectonconnectfailure", false)) {
             doDelayedReconnect();
         }
     }
@@ -1165,7 +1158,7 @@ public final class Server extends WritableFrameContainer implements Serializable
                 Long.valueOf(parser.getPingTime(false)));
 
         if (parser.getPingTime(false)
-                 >= configManager.getOptionInt(DOMAIN_SERVER, "pingtimeout", 60000)) {
+                 >= getConfigManager().getOptionInt(DOMAIN_SERVER, "pingtimeout", 60000)) {
             handleNotification("stonedServer", getName());
             reconnect();
         }
@@ -1180,14 +1173,14 @@ public final class Server extends WritableFrameContainer implements Serializable
         }
         updateIcon();
 
-        configManager = new ConfigManager(parser.getIRCD(true), getNetwork(), getName());
+        getConfigManager().migrate(parser.getIRCD(true), getNetwork(), getName());
         updateIgnoreList();
 
         converter = parser.getIRCStringConverter();
 
         ActionManager.processEvent(CoreActionType.SERVER_CONNECTED, null, this);
 
-        if (configManager.hasOption(DOMAIN_GENERAL, "rejoinchannels")) {
+        if (getConfigManager().hasOption(DOMAIN_GENERAL, "rejoinchannels")) {
             for (Channel chan : channels.values()) {
                 chan.join();
             }
@@ -1213,13 +1206,13 @@ public final class Server extends WritableFrameContainer implements Serializable
         final StringBuffer missingUmodes = new StringBuffer();
 
         for (char mode : modes.toCharArray()) {
-            if (!configManager.hasOption(DOMAIN_SERVER, "mode" + mode)) {
+            if (!getConfigManager().hasOption(DOMAIN_SERVER, "mode" + mode)) {
                 missingModes.append(mode);
             }
         }
 
         for (char mode : umodes.toCharArray()) {
-            if (!configManager.hasOption(DOMAIN_SERVER, "umode" + mode)) {
+            if (!getConfigManager().hasOption(DOMAIN_SERVER, "umode" + mode)) {
                 missingUmodes.append(mode);
             }
         }
@@ -1248,7 +1241,7 @@ public final class Server extends WritableFrameContainer implements Serializable
                     + "IRCd: " + parser.getIRCD(false)
                     + " (" + parser.getIRCD(true) + ")\n"
                     + "Mode alias version: "
-                    + configManager.getOption("identity", "modealiasversion", "none")
+                    + getConfigManager().getOption("identity", "modealiasversion", "none")
                     + "\n\n"));
         }
     }
@@ -1270,7 +1263,7 @@ public final class Server extends WritableFrameContainer implements Serializable
      */
     public void updateIgnoreList() {
         ignoreList.clear();
-        ignoreList.addAll(configManager.getOptionList("network", "ignorelist"));
+        ignoreList.addAll(getConfigManager().getOptionList("network", "ignorelist"));
     }
 
     /**

src/com/dmdirc/WritableFrameContainer.java

@@ -24,6 +24,7 @@ package com.dmdirc;
 
 import com.dmdirc.actions.ActionManager;
 import com.dmdirc.actions.interfaces.ActionType;
+import com.dmdirc.config.ConfigManager;
 import com.dmdirc.logger.ErrorLevel;
 import com.dmdirc.logger.Logger;
 import com.dmdirc.ui.WindowManager;
@@ -52,9 +53,10 @@ public abstract class WritableFrameContainer extends FrameContainer {
      * Creates a new WritableFrameContainer.
      * 
      * @param icon The icon to use for this container
+     * @param config The config manager for this container
      */
-    public WritableFrameContainer(final String icon) {
-        super(icon);
+    public WritableFrameContainer(final String icon, final ConfigManager config) {
+        super(icon, config);
     }
     
     /**

src/com/dmdirc/addons/dcc/DCCFrame.java

@@ -30,7 +30,6 @@ import com.dmdirc.commandparser.commands.Command;
 import com.dmdirc.commandparser.commands.GlobalCommand;
 import com.dmdirc.commandparser.parsers.CommandParser;
 import com.dmdirc.commandparser.parsers.GlobalCommandParser;
-import com.dmdirc.config.ConfigManager;
 import com.dmdirc.config.IdentityManager;
 import com.dmdirc.ui.WindowManager;
 import com.dmdirc.ui.interfaces.InputWindow;
@@ -170,7 +169,7 @@ public abstract class DCCFrame extends WritableFrameContainer {
 	 * @param defaultWindow Create default (empty) window.
 	 */
 	public DCCFrame(final DCCPlugin plugin, final String title, final boolean defaultWindow) {
-		super("raw");
+		super("raw", IdentityManager.getGlobalConfig());
 		this.title = title;
 		this.plugin = plugin;
 
@@ -234,16 +233,6 @@ public abstract class DCCFrame extends WritableFrameContainer {
 		return title;
 	}
 	
-	/**
-	 * Retrieves the config manager for this command window.
-	 *
-	 * @return This window's config manager
-	 */
-	@Override
-	public ConfigManager getConfigManager() {
-		return IdentityManager.getGlobalConfig();
-	}
-	
 	/**
 	 * Returns the server instance associated with this container.
 	 *

src/com/dmdirc/addons/logging/HistoryWindow.java

@@ -25,7 +25,6 @@ package com.dmdirc.addons.logging;
 import com.dmdirc.FrameContainer;
 import com.dmdirc.Main;
 import com.dmdirc.Server;
-import com.dmdirc.config.ConfigManager;
 import com.dmdirc.config.IdentityManager;
 import com.dmdirc.ui.WindowManager;
 import com.dmdirc.ui.interfaces.Window;
@@ -56,7 +55,7 @@ public class HistoryWindow extends FrameContainer {
      * @param parent The window this history window was opened from
      */
     public HistoryWindow(final String title, final ReverseFileReader reader, final Window parent) {
-        super("raw");
+        super("raw", parent.getConfigManager());
         
         this.title = title;
         this.parent = parent;
@@ -112,10 +111,5 @@ public class HistoryWindow extends FrameContainer {
     public Server getServer() {
         return parent.getContainer().getServer();
     }
-    
-    /** {@inheritDoc} */
-    @Override
-    public ConfigManager getConfigManager() {
-        return parent.getConfigManager();
-    }    
+
 }

src/com/dmdirc/config/ConfigManager.java

@@ -253,6 +253,19 @@ public class ConfigManager extends ConfigSource implements Serializable,
         return new ArrayList<Identity>(sources);
     }
     
+    /**
+     * Migrates this ConfigManager from its current configuration to the
+     * appropriate one for the specified new parameters, firing listeners where
+     * settings have changed.
+     * 
+     * @param ircd The new name of the ircd for this manager
+     * @param network The new name of the network for this manager
+     * @param server The new name of the server for this manager
+     */
+    public void migrate(final String ircd, final String network, final String server) {
+        migrate(ircd, network, server, "<Unknown>");
+    }   
+    
     /**
      * Migrates this ConfigManager from its current configuration to the
      * appropriate one for the specified new parameters, firing listeners where

test/com/dmdirc/WritableFrameContainerTest.java

@@ -23,6 +23,7 @@
 package com.dmdirc;
 
 import com.dmdirc.config.ConfigManager;
+import com.dmdirc.config.IdentityManager;
 import com.dmdirc.ui.interfaces.InputWindow;
 
 import org.junit.Test;
@@ -57,6 +58,8 @@ class BasicWritableFrameContainer extends WritableFrameContainer {
     private final int lineLength;
     
     public BasicWritableFrameContainer(final int lineLength) {
+        super("raw", IdentityManager.getGlobalConfig());
+        
         this.lineLength = lineLength;
     }
     
@@ -83,8 +86,4 @@ class BasicWritableFrameContainer extends WritableFrameContainer {
     public Server getServer() {
         return null;
     }
-
-    public ConfigManager getConfigManager() {
-        return null;
-    }
 }