gnu.inet.finger
Class FingerConnection

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

public class FingerConnection
extends java.lang.Object

A client for the finger protocol described in RFC 1288.

Author:

Chris Burdess

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