/*

 *   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(".");

  }

}