chris@1: /*
chris@1:  *   SONEWS News Server
chris@1:  *   see AUTHORS for the list of contributors
chris@1:  *
chris@1:  *   This program is free software: you can redistribute it and/or modify
chris@1:  *   it under the terms of the GNU General Public License as published by
chris@1:  *   the Free Software Foundation, either version 3 of the License, or
chris@1:  *   (at your option) any later version.
chris@1:  *
chris@1:  *   This program is distributed in the hope that it will be useful,
chris@1:  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
chris@1:  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
chris@1:  *   GNU General Public License for more details.
chris@1:  *
chris@1:  *   You should have received a copy of the GNU General Public License
chris@1:  *   along with this program.  If not, see <http://www.gnu.org/licenses/>.
chris@1:  */
chris@1: 
chris@1: package org.sonews.daemon.command;
chris@1: 
chris@1: import java.io.IOException;
chris@1: import org.sonews.daemon.NNTPConnection;
chris@1: 
chris@1: /**
chris@1:  * <pre>
cli@20:  *  The CAPABILITIES command allows a client to determine the
cli@20:  *  capabilities of the server at any given time.
chris@1:  *
cli@20:  *  This command MAY be issued at any time; the server MUST NOT require
cli@20:  *  it to be issued in order to make use of any capability. The response
cli@20:  *  generated by this command MAY change during a session because of
cli@20:  *  other state information (which, in turn, may be changed by the
cli@20:  *  effects of other commands or by external events).  An NNTP client is
cli@20:  *  only able to get the current and correct information concerning
cli@20:  *  available capabilities at any point during a session by issuing a
cli@20:  *  CAPABILITIES command at that point of that session and processing the
cli@20:  *  response.
chris@1:  * </pre>
chris@1:  * @author Christian Lins
chris@1:  * @since sonews/0.5.0
chris@1:  */
chris@3: public class CapabilitiesCommand implements Command
chris@1: {
chris@1: 
cli@37: 	static final String[] CAPABILITIES = new String[] {
cli@37: 		"VERSION 2", // MUST be the first one; VERSION 2 refers to RFC3977
cli@37: 		"READER", // Server implements commands for reading
cli@37: 		"POST", // Server implements POST command
cli@37: 		"OVER" // Server implements OVER command
cli@37: 	};
chris@3: 
cli@37: 	@Override
cli@37: 	public String[] getSupportedCommandStrings()
cli@37: 	{
cli@37: 		return new String[] {"CAPABILITIES"};
cli@37: 	}
chris@1: 
cli@37: 	/**
cli@37: 	 * First called after one call to processLine().
cli@37: 	 * @return
cli@37: 	 */
cli@37: 	@Override
cli@37: 	public boolean hasFinished()
cli@37: 	{
cli@37: 		return true;
cli@37: 	}
chris@1: 
cli@37: 	@Override
cli@37: 	public String impliedCapability()
cli@37: 	{
cli@37: 		return null;
cli@37: 	}
chris@3: 
cli@37: 	@Override
cli@37: 	public boolean isStateful()
cli@37: 	{
cli@37: 		return false;
cli@37: 	}
chris@1: 
cli@37: 	@Override
cli@37: 	public void processLine(NNTPConnection conn, final String line, byte[] raw)
cli@37: 		throws IOException
cli@37: 	{
cli@37: 		conn.println("101 Capabilities list:");
cli@37: 		for (String cap : CAPABILITIES) {
cli@37: 			conn.println(cap);
cli@37: 		}
cli@37: 		conn.println(".");
cli@37: 	}
chris@1: }