ORO, Inc. Logo  All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class com.oroinc.net.FingerClient

java.lang.Object
   |
   +----com.oroinc.net.SocketClient
           |
           +----com.oroinc.net.FingerClient

public class FingerClient
extends SocketClient
The FingerClient class implements the client side of the Internet Finger Protocol defined in RFC 1288. To finger a host you create a FingerClient instance, connect to the host, query the host, and finally disconnect from the host. If the finger service you want to query is on a non-standard port, connect to the host at that port. Here's a sample use:
    FingerClient finger;
    finger = new FingerClient();
    try {
      finger.connect("foo.bar.com");
      System.out.println(finger.query("foobar", false));
      finger.disconnect();
    } catch(IOException e) {
      System.err.println("Error I/O exception: " + e.getMessage());
      return;
    }
 

Copyright © 1997 Original Reusable Objects, Inc. All rights reserved.


Variable Index

 o DEFAULT_PORT
The default FINGER port.

Constructor Index

 o FingerClient()
The default FingerClient constructor.

Method Index

 o getInputStream(boolean)
Fingers the connected host and returns the input stream from the network connection of the finger query.
 o getInputStream(boolean, String)
Fingers a user and returns the input stream from the network connection of the finger query.
 o query(boolean)
Fingers the connected host and returns the output as a String.
 o query(boolean, String)
Fingers a user at the connected host and returns the output as a String.

Variables

 o DEFAULT_PORT
 public static final int DEFAULT_PORT
The default FINGER port. Set to 79 according to RFC 1288.

Constructors

 o FingerClient
 public FingerClient()
The default FingerClient constructor. Initializes the default port to DEFAULT_PORT .

Methods

 o query
 public String query(boolean longOutput,
                     String username) throws IOException
Fingers a user at the connected host and returns the output as a String. You must first connect to a finger server before calling this method, and you should disconnect afterward.

Parameters:
longOutput - Set to true if long output is requested, false if not.
username - The name of the user to finger.
Returns:
The result of the finger query.
Throws: IOException
If an I/O error occurs while reading the socket.
 o query
 public String query(boolean longOutput) throws IOException
Fingers the connected host and returns the output as a String. You must first connect to a finger server before calling this method, and you should disconnect afterward. This is equivalent to calling query(longOutput, "") .

Parameters:
longOutput - Set to true if long output is requested, false if not.
Returns:
The result of the finger query.
Throws: IOException
If an I/O error occurs while reading the socket.
 o getInputStream
 public InputStream getInputStream(boolean longOutput,
                                   String username) throws IOException
Fingers a user and returns the input stream from the network connection of the finger query. You must first connect to a finger server before calling this method, and you should disconnect after finishing reading the stream.

Parameters:
longOutput - Set to true if long output is requested, false if not.
username - The name of the user to finger.
Returns:
The InputStream of the network connection of the finger query. Can be read to obtain finger results.
Throws: IOException
If an I/O error during the operation.
 o getInputStream
 public InputStream getInputStream(boolean longOutput) throws IOException
Fingers the connected host and returns the input stream from the network connection of the finger query. This is equivalent to calling getInputStream(longOutput, ""). You must first connect to a finger server before calling this method, and you should disconnect after finishing reading the stream.

Parameters:
longOutput - Set to true if long output is requested, false if not.
Returns:
The InputStream of the network connection of the finger query. Can be read to obtain finger results.
Throws: IOException
If an I/O error during the operation.

ORO, Inc. Logo  All Packages  Class Hierarchy  This Package  Previous  Next  Index