sonews-drupal: src/org/sonews/daemon/command/CapabilitiesCommand.java@7e24949b87b0

     1 /*

     2  *   SONEWS News Server

     3  *   see AUTHORS for the list of contributors

     4  *

     5  *   This program is free software: you can redistribute it and/or modify

     6  *   it under the terms of the GNU General Public License as published by

     7  *   the Free Software Foundation, either version 3 of the License, or

     8  *   (at your option) any later version.

     9  *

    10  *   This program is distributed in the hope that it will be useful,

    11  *   but WITHOUT ANY WARRANTY; without even the implied warranty of

    12  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    13  *   GNU General Public License for more details.

    14  *

    15  *   You should have received a copy of the GNU General Public License

    16  *   along with this program.  If not, see <http://www.gnu.org/licenses/>.

    17  */

    19 package org.sonews.daemon.command;

    21 import java.io.IOException;

    22 import org.sonews.daemon.NNTPConnection;

    24 /**

    25  * <pre>

    26  *  The CAPABILITIES command allows a client to determine the

    27  *  capabilities of the server at any given time.

    28  *

    29  *  This command MAY be issued at any time; the server MUST NOT require

    30  *  it to be issued in order to make use of any capability. The response

    31  *  generated by this command MAY change during a session because of

    32  *  other state information (which, in turn, may be changed by the

    33  *  effects of other commands or by external events).  An NNTP client is

    34  *  only able to get the current and correct information concerning

    35  *  available capabilities at any point during a session by issuing a

    36  *  CAPABILITIES command at that point of that session and processing the

    37  *  response.

    38  * </pre>

    39  * @author Christian Lins

    40  * @since sonews/0.5.0

    41  */

    42 public class CapabilitiesCommand implements Command

    43 {

    45 	static final String[] CAPABILITIES = new String[] {

    46 		"VERSION 2", // MUST be the first one; VERSION 2 refers to RFC3977

    47 		"READER", // Server implements commands for reading

    48 		"POST", // Server implements POST command

    49 		"OVER" // Server implements OVER command

    50 	};

    52 	@Override

    53 	public String[] getSupportedCommandStrings()

    54 	{

    55 		return new String[] {"CAPABILITIES"};

    56 	}

    58 	/**

    59 	 * First called after one call to processLine().

    60 	 * @return

    61 	 */

    62 	@Override

    63 	public boolean hasFinished()

    64 	{

    65 		return true;

    66 	}

    68 	@Override

    69 	public String impliedCapability()

    70 	{

    71 		return null;

    72 	}

    74 	@Override

    75 	public boolean isStateful()

    76 	{

    77 		return false;

    78 	}

    80 	@Override

    81 	public void processLine(NNTPConnection conn, final String line, byte[] raw)

    82 		throws IOException

    83 	{

    84 		conn.println("101 Capabilities list:");

    85 		for (String cap : CAPABILITIES) {

    86 			conn.println(cap);

    87 		}

    88 		conn.println(".");

    89 	}

    90 }

author	cli
	Sat, 10 Sep 2011 18:18:05 +0200
changeset 45	7e24949b87b0
parent 37	74139325d305
permissions	-rwxr-xr-x