Package com.ccg.net.tcp

TCP Network Related Classes.

See:
Description

Interface Summary

InetAddressFilter

Definition of a InetAddressFilter, which is used to accept/reject IP addresses.

Class Summary

Cat	Program to "cat" data from a TCP connection (and test the URLConnection class.
Handler	A URLStreamHandler to handle the "tcp:" protocol.
InetAddressFilters	Collection of standard IP address filters.
MaskAndMatch
Server	Fundamental building block for TCP servers.
ServerThread
SimpleExpect	A very simple implementation of a "send/expect" checking object.
SocketOptions	A handy "bean" type wrapper around the standard Socket options.
URLConnection	Implementation of a URLConnection for TCP connections.

Package com.ccg.net.tcp Description

TCP Network Related Classes.

The classes defined in this package provide some TCP specific extensions to the java.net package to help facilitate some common TCP tasks. Here are some of the highlights:

Server

This class serves as a very good start point for those wishing to create a TCP based server.

URLConnection

This class adds support for the tcp://[HOST]:PORT/OPTIONS URL extension and allows one to set all sorts of socket options dynamically at run time in the URL.

Cat

This class allows one to do a Hex or ASCII dump of a TCP connection (a handy little command line utility).

SimpleExpect

This class provides the building blocks to create a simple TCP expect utility. It allows one to check to see whether a TCP server is up and producing expected output.

IP Address Filtering

The InetAddressFilter interface and the many common forms available from the InetAddressFilters class provide a nice way to test IP addresses to determine if they can be accepted. The Filter.java example program demonstrates how simple this can be.

MIME Types

The MimeType and MimeTypes classes provide a means to work with MIME type identifiers. In particular, the ability to map file extensions to MIME types and vice versa is provided (maybe this is built into the JDK somewhere, but I couldn't find it).

Some example(s) of using the objects in this package have been provided in the doc-files directory. The examples include:

TimeServer.java

This example demonstrates how to create a simple TCP server by extending the Server class.

License/Use Information

The license text below the dashed line pertains to the "com/ccg" and
"com/include" libraries, documentation, executable binaries, and the
source code as distributed in this package by Paul Blankenbaker
(paul@mekwin.com).

------------------------------------------------------------------------------
This software is copyrighted by Paul Blankenbaker, Global
Atmospherics, Inc. and Unified Technologies, Inc., and other parties.
The following terms apply to all files associated with the software
unless explicitly disclaimed in individual files.

The authors hereby grant permission to use, copy, modify, distribute,
and license this software and its documentation for any purpose, provided
that existing copyright notices are retained in all copies and that this
notice is included verbatim in any distributions. No written agreement,
license, or royalty fee is required for any of the authorized uses.
Modifications to this software may be copyrighted by their authors
and need not follow the licensing terms described here, provided that
the new terms are clearly indicated on the first page of each file where
they apply.

IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.

THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.  THIS SOFTWARE
IS PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE
NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR
MODIFICATIONS.

RESTRICTED RIGHTS: Use, duplication or disclosure by the government
is subject to the restrictions as set forth in subparagraph (c) (1) (ii)
of the Rights in Technical Data and Computer Software Clause as DFARS
252.227-7013 and FAR 52.227-19.