Purple Code

by Purple Technology and Alex Chaffee

I've created lots of useful (and useless) bits of Java code to help me with various software projects. In the spirit of Open Source, I'm making my com.purpletech libraries available for public use. I expect that these packages will be useful mostly as sample code, but if anyone finds them valuable enough to include whole-hog in a project, that would be cool too.

The Terms: Do whatever you like with this code, free of charge, just give credit where credit is due. If you improve it, please send your improvements to code@purpletech.com. Check http://www.purpletech.com/code/ for the latest version and news. A full, legal version of the license is available elsewhere on this page, and should also be in the top of each source file. Note that even if a particular source file happens to be missing the text of the license, the license still applies.

Technical Details: The code is available for download in three parts:

• A binary jar file, containing all .class files and resources
• A source jar file, containing all .java files and other sources
• A documentation jar file, containing a javadoc API build for all packages

Individual jar files for individual packages will probably not be made available; however, you are welcome to divide it up yourself if you need to. If you're not writing an applet, though, you should probably just keep the jar files as downloaded, since that will allow you to just plug in updated versions.

You can also browse the files on-line:

• The source tree, containing both .class and .java
• The documentation, in javadoc API format

Highlights:

• com.purpletech.awt
  ImageBuilder builds an image by layering a series of transparent GIFs.
  ImageComponent is an AWT component that displays an AWT Image.
  PureImage / PureGraphics enables some image-manipulation operations without using native AWT peers (e.g. for servers running without a graphics card, or with a low-res one)
  ImageUtils contains routines for writing an Image to disk and so forth
  
  
• com.purpletech.graph
  A framework for building graphs (with axes and labels and legends and stuff)
  
  
• com.purpletech.io
  FileCache Fetches URLs and stores them locally on disk, with a timeout algorithm
  NonBlockingInputStream Clever filter stream that throws an exception instead of blocking if there's no data available
  
  
• com.purpletech.lang
  Primitive classfile parser
  
  
• com.purpletech.math
  Some useful (?) mathematical utility classes
  
  
• com.purpletech.message
  The Purple Server package
  
  
• com.purpletech.net
  EchoCGI example for running Java applications as CGI scripts
  Qsmtp Java SMTP client
  
  
• com.purpletech.servlets
  CookieDetector detects whether the user's browser accepts cookies, redirecting to one URL if they do and a different one if they don't
  ImageServlet constructs an Image, renders it as a GIF, and outputs it to the response stream. Can be subclassed.
  GraphServlet demonstrates ImageServlet by building a com.purpletech.graph Graph.
  
  
• com.purpletech.util
  Lots of useful objects, including Thread Pools, a Blocking Queue, an in-memory cache, a universal Date parser, a List/Map hybrid, and oddles of static functions, including an html-escaper
  

Third Party Libraries: Other noble hackers have made lots of good code. Some of these libraries are required by mine. Others are just cool.

• Jef Poskanser's Acme Laboratories - great utility libraries, especially his GIF Encoder
• Wes Biggs' gnu.regexp - Perl-style regular expressions with a clean, sensible API
• Aaron Renn's gnu getopt - for application command-line options
• Giant Java Tree - lots of Open Source Java code
• Classpath Project - a cleanroom implementation of the Java API libraries
• Java-Software.Com - some code, some beans, mostly products
• Java Exchange - Java Servlet Technologies, including DbConnectionBroker

License

/*
 * ====================================================================
 * Copyright (c) 1995-2000 Purple Technology, Inc. All rights
 * reserved.
 * 
 * PLAIN LANGUAGE LICENSE: Do whatever you like with this code, free
 * of charge, just give credit where credit is due. If you improve it,
 * please send your improvements to code@purpletech.com. Check
 * http://www.purpletech.com/code/ for the latest version and news.
 *
 * LEGAL LANGUAGE LICENSE: Redistribution and use in source and binary
 * forms, with or without modification, are permitted provided that
 * the following conditions are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 * notice, this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above
 * copyright notice, this list of conditions and the following
 * disclaimer in the documentation and/or other materials provided
 * with the distribution.
 *
 * 3. The names of the authors and the names "Purple Technology,"
 * "Purple Server" and "Purple Chat" must not be used to endorse or
 * promote products derived from this software without prior written
 * permission. For written permission, please contact
 * server@purpletech.com.
 * 
 * THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND PURPLE TECHNOLOGY ``AS
 * IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
 * AUTHORS OR PURPLE TECHNOLOGY BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 * OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * ====================================================================
 *
 **/