org/sonews/daemon/command/CapabilitiesCommand.java
author chris <chris@marvin>
Fri Jun 26 16:48:50 2009 +0200 (2009-06-26)
changeset 1 6fceb66e1ad7
child 3 2fdc9cc89502
permissions -rw-r--r--
Hooray... sonews/0.5.0 final

HG: Enter commit message. Lines beginning with 'HG:' are removed.
HG: Remove all lines to abort the collapse operation.
chris@1
     1
/*
chris@1
     2
 *   SONEWS News Server
chris@1
     3
 *   see AUTHORS for the list of contributors
chris@1
     4
 *
chris@1
     5
 *   This program is free software: you can redistribute it and/or modify
chris@1
     6
 *   it under the terms of the GNU General Public License as published by
chris@1
     7
 *   the Free Software Foundation, either version 3 of the License, or
chris@1
     8
 *   (at your option) any later version.
chris@1
     9
 *
chris@1
    10
 *   This program is distributed in the hope that it will be useful,
chris@1
    11
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
chris@1
    12
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
chris@1
    13
 *   GNU General Public License for more details.
chris@1
    14
 *
chris@1
    15
 *   You should have received a copy of the GNU General Public License
chris@1
    16
 *   along with this program.  If not, see <http://www.gnu.org/licenses/>.
chris@1
    17
 */
chris@1
    18
chris@1
    19
package org.sonews.daemon.command;
chris@1
    20
chris@1
    21
import java.io.IOException;
chris@1
    22
import org.sonews.daemon.NNTPConnection;
chris@1
    23
chris@1
    24
/**
chris@1
    25
 * <pre>
chris@1
    26
 * The CAPABILITIES command allows a client to determine the
chris@1
    27
 * capabilities of the server at any given time.
chris@1
    28
 *
chris@1
    29
 * This command MAY be issued at any time; the server MUST NOT require
chris@1
    30
 * it to be issued in order to make use of any capability. The response
chris@1
    31
 * generated by this command MAY change during a session because of
chris@1
    32
 * other state information (which, in turn, may be changed by the
chris@1
    33
 * effects of other commands or by external events).  An NNTP client is
chris@1
    34
 * only able to get the current and correct information concerning
chris@1
    35
 * available capabilities at any point during a session by issuing a
chris@1
    36
 * CAPABILITIES command at that point of that session and processing the
chris@1
    37
 * response.
chris@1
    38
 * </pre>
chris@1
    39
 * @author Christian Lins
chris@1
    40
 * @since sonews/0.5.0
chris@1
    41
 */
chris@1
    42
public class CapabilitiesCommand extends AbstractCommand
chris@1
    43
{
chris@1
    44
chris@1
    45
  protected static final String[] CAPABILITIES = new String[]
chris@1
    46
    {
chris@1
    47
      "VERSION 2", // MUST be the first one; VERSION 2 refers to RFC3977
chris@1
    48
      "READER",    // Server implements commands for reading
chris@1
    49
      "POST",      // Server implements POST command
chris@1
    50
      "OVER"       // Server implements OVER command
chris@1
    51
    };
chris@1
    52
  
chris@1
    53
  public CapabilitiesCommand(final NNTPConnection conn)
chris@1
    54
  {
chris@1
    55
    super(conn);
chris@1
    56
  }
chris@1
    57
chris@1
    58
  /**
chris@1
    59
   * First called after one call to processLine().
chris@1
    60
   * @return
chris@1
    61
   */
chris@1
    62
  @Override
chris@1
    63
  public boolean hasFinished()
chris@1
    64
  {
chris@1
    65
    return true;
chris@1
    66
  }
chris@1
    67
chris@1
    68
  @Override
chris@1
    69
  public void processLine(final String line)
chris@1
    70
    throws IOException
chris@1
    71
  {
chris@1
    72
    printStatus(101, "Capabilities list:");
chris@1
    73
    for(String cap : CAPABILITIES)
chris@1
    74
    {
chris@1
    75
      println(cap);
chris@1
    76
    }
chris@1
    77
    println(".");
chris@1
    78
  }
chris@1
    79
chris@1
    80
}