gnu.inet.finger
Class FingerConnection

java.lang.Object
  extended by gnu.inet.finger.FingerConnection

public class FingerConnection
extends java.lang.Object

A client for the finger protocol described in RFC 1288.


Field Summary
static int DEFAULT_PORT
          The default finger port.
protected  java.net.Socket socket
          The underlying socket used for communications.
protected  boolean verbose
          If we want a verbose response.
 
Constructor Summary
FingerConnection(java.lang.String host)
          Creates a new finger connection.
FingerConnection(java.lang.String host, int port)
          Creates a new finger connection.
 
Method Summary
 java.lang.String finger(java.lang.String username)
          Fingers the specified user.
 java.lang.String finger(java.lang.String username, java.lang.String hostname)
          Fingers the specified user at the specified host.
 boolean isVerbose()
          Retrieves the verbose flag.
 java.lang.String list()
          Lists the available users.
 void setVerbose(boolean verbose)
          Sets the verbose flag.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

DEFAULT_PORT

public static final int DEFAULT_PORT
The default finger port.

See Also:
Constant Field Values

socket

protected java.net.Socket socket
The underlying socket used for communications.


verbose

protected boolean verbose
If we want a verbose response.

Constructor Detail

FingerConnection

public FingerConnection(java.lang.String host)
                 throws java.io.IOException
Creates a new finger connection.

Parameters:
host - the name of the internet host to connect to
Throws:
java.io.IOException

FingerConnection

public FingerConnection(java.lang.String host,
                        int port)
                 throws java.io.IOException
Creates a new finger connection.

Parameters:
host - the name of the internet host to connect to
port - the port to connect to
Throws:
java.io.IOException
Method Detail

isVerbose

public boolean isVerbose()
Retrieves the verbose flag. If true, the server should provide more output.


setVerbose

public void setVerbose(boolean verbose)
Sets the verbose flag. If true, the server should provide more output.

Parameters:
verbose - true for more verbose, false otherwise

list

public java.lang.String list()
                      throws java.io.IOException
Lists the available users.

Throws:
java.io.IOException

finger

public java.lang.String finger(java.lang.String username)
                        throws java.io.IOException
Fingers the specified user.

Parameters:
username - the user to finger
Returns:
information about all matching users
Throws:
java.io.IOException

finger

public java.lang.String finger(java.lang.String username,
                               java.lang.String hostname)
                        throws java.io.IOException
Fingers the specified user at the specified host.

Parameters:
username - the user to finger (null for any user)
hostname - the domain of the user (null for any domain)
Returns:
information about all matching users
Throws:
java.io.IOException