Add servername into BaseParser and clarify javadoc

Change-Id: Icc4de20b0617f9962853e8c9fe66737d6a5b9297
Reviewed-on: http://gerrit.dmdirc.com/2003
Automatic-Compile: DMDirc Build Manager
Reviewed-by: Greg Holmes <greg@dmdirc.com>

src/com/dmdirc/parser/common/BaseParser.java

@@ -49,6 +49,9 @@ public abstract class BaseParser implements Parser {
     /** The ping timer fraction for this parser. */
     private int pingTimerFraction;
 
+    /** The cached name of the server this parser is connected to. */
+    private String serverName;
+
     /** The callback manager to use for this parser. */
     private final CallbackManager callbackManager;
 
@@ -155,4 +158,19 @@ public abstract class BaseParser implements Parser {
         joinChannels(new ChannelJoinRequest(channel, key));
     }
 
+    /** {@inheritDoc} */
+    @Override
+    public String getServerName() {
+        return serverName;
+    }
+
+    /**
+     * Sets the name of this parser's server.
+     *
+     * @param serverName The new name for this parser's server
+     */
+    protected void setServerName(final String serverName) {
+        this.serverName = serverName;
+    }
+
 }

src/com/dmdirc/parser/interfaces/Parser.java

@@ -206,7 +206,8 @@ public interface Parser extends Runnable {
     Collection<? extends ChannelJoinRequest> extractChannels(final URI uri);
 
     /**
-     * Retrieves the name of the server that this parser is connected to.
+     * Retrieves the name of the server that this parser is, or has been,
+     * connected to.
      *
      * @return This parser's server's name
      */