/*

 *   SONEWS News Server

 *   see AUTHORS for the list of contributors

 *

 *   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 3 of the License, or

 *   (at your option) 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, see <http://www.gnu.org/licenses/>.

 */

package org.sonews.daemon.command;

import java.io.IOException;

import org.sonews.daemon.NNTPConnection;

/**

 * <pre>

 *  The CAPABILITIES command allows a client to determine the

 *  capabilities of the server at any given time.

 *

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

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

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

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

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

 *  only able to get the current and correct information concerning

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

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

 *  response.

 * </pre>

 * @author Christian Lins

 * @since sonews/0.5.0

 */

public class CapabilitiesCommand implements Command

{

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

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

		"READER", // Server implements commands for reading

		"POST", // Server implements POST command

		"OVER" // Server implements OVER command

	};

	@Override

	public String[] getSupportedCommandStrings()

	{

		return new String[] {"CAPABILITIES"};

	}

	/**

	 * First called after one call to processLine().

	 * @return

	 */

	@Override

	public boolean hasFinished()

	{

		return true;

	}

	@Override

	public String impliedCapability()

	{

		return null;

	}

	@Override

	public boolean isStateful()

	{

		return false;

	}

	@Override

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

		throws IOException

	{

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

		for (String cap : CAPABILITIES) {

			conn.println(cap);

		}

		conn.println(".");

	}

}