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.
-
DEFAULT_PORT
- The default FINGER port.
-
FingerClient()
- The default FingerClient constructor.
-
getInputStream(boolean)
- Fingers the connected host and returns the input stream from
the network connection of the finger query.
-
getInputStream(boolean, String)
- Fingers a user and returns the input stream from the network connection
of the finger query.
-
query(boolean)
- Fingers the connected host and returns the output
as a String.
-
query(boolean, String)
- Fingers a user at the connected host and returns the output
as a String.
DEFAULT_PORT
public static final int DEFAULT_PORT
- The default FINGER port. Set to 79 according to RFC 1288.
FingerClient
public FingerClient()
- The default FingerClient constructor. Initializes the
default port to
DEFAULT_PORT
.
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.
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.
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.
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.
All Packages Class Hierarchy This Package Previous Next Index