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

Class com.oroinc.net.WhoisClient

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

public final class WhoisClient
extends FingerClient
The WhoisClient class implements the client side of the Internet Whois Protocol defined in RFC 954. To query a host you create a WhoisClient instance, connect to the host, query the host, and finally disconnect from the host. If the whois service you want to query is on a non-standard port, connect to the host at that port. Here's a sample use:
    WhoisClient whois;
    whois = new WhoisClient();
    try {
      whois.connect(WhoisClient.DEFAULT_HOST);
      System.out.println(whois.query("foobar"));
      whois.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_HOST
The default whois host to query.
 o DEFAULT_PORT
The default whois port.

Constructor Index

 o WhoisClient()
The default whois constructor.

Method Index

 o getInputStream(String)
Queries the connected whois server for information regarding the given handle and returns the InputStream of the network connection.
 o query(String)
Queries the connected whois server for information regarding the given handle.

Variables

 o DEFAULT_HOST
 public static final String DEFAULT_HOST
The default whois host to query. It is set to whois.internic.net.

 o DEFAULT_PORT
 public static final int DEFAULT_PORT
The default whois port. It is set to 43 according to RFC 954.

Constructors

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

Methods

 o query
 public String query(String handle) throws IOException
Queries the connected whois server for information regarding the given handle. It is up to the programmer to be familiar with the handle syntax of the whois server. You must first connect to a whois server before calling this method, and you should disconnect afterward.

Parameters:
handle - The handle to lookup.
Returns:
The result of the whois query.
Throws: IOException
If an I/O error occurs during the operation.
 o getInputStream
 public InputStream getInputStream(String handle) throws IOException
Queries the connected whois server for information regarding the given handle and returns the InputStream of the network connection. It is up to the programmer to be familiar with the handle syntax of the whois server. You must first connect to a finger server before calling this method, and you should disconnect after finishing reading the stream.

Parameters:
handle - The handle to lookup.
Returns:
The InputStream of the network connection of the whois query. Can be read to obtain whois results.
Throws: IOException
If an I/O error occurs during the operation.

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