com.mkaz.htmllib v 0.74

Contents

• Introduction
  
• Download
  
• System Requirements
  
• Installation
  
• Usage and Docs
  
• License
  

INTRODUCTION

htmllib is a Java package which eases the development of HTML documents and HTML code. The library is extremely useful in servlet development and other java programs that generate HTML code.

The goal of this package was to make writing servlets (that spit out HTML) easier. This library simplifies the hand-coding HTML for tables, form elements and most HTML elements. (Note: ver 0.73 library is not a full HTML set) The API syntax is intuitive and similar to the Perl CGI.pm module.

DOWNLOAD

The complete library package with source code, and examples can be downloaded from http://blazonry.com/mkjava/htmllib-0.74.tar.gz

SYSTEM REQUIREMENTS

A properly installed Java Virtual Machine is all that is needed. This library should work with JDK 1.0 and up. Mac, Linux, Windows, whatever, it should work fine.

INSTALLATION

You have a few choices on installing. Basically the Java Virtual Machine needs to know where this package is. This is set using the CLASSPATH envirionment variable, or by your specific Virtual Machine settings. (Different Servlet Engines use different methods on installing packages)

Here are the two most common ways of installing:

1. Copy the complete com directory which is under the lib directory to a spot in your CLASSPATH. For example if your CLASSPATH includes /usr/local/java/lib copy the com directory here.
   
   
2. Add the mkaz.jar file which is under the lib directory to your CLASSPATH. For example if you copied the mkaz.jar file to /usr/local/java/lib then add to your CLASSPATH environment variable CLASSPATH=$CLASSPATH:/usr/local/java/lib/mkaz.jar
   
   

USAGE

If you have installed the package properly and it can be seen by your JVM the following simple program should display an HTML link.

Example:

import com.mkaz.htmllib;

public class testapp {

    public static void main(String[] args) {
        htmllib html = new htmllib();

        System.out.println(html.link("blazonry.com","http://blazonry.com/"));
    }
}

Servlet Example
For a more complete example, see the MKTest Servlet included with the distribution. Copy the class file MKTest.class to your servlet directory, run it in your browser as you would other servlets.

Documentation
JavaDoc generated documentation can be found on-line here.

Complete documenation can also be found in the docs/ directory in the distribution.

LICENSE (BSD-compatible)

/*  ====================================================================
 *  Copyright (c) 1998-1999 Astonish Inc.
 *  All rights reserved.
 *
 *  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 name of the author may not be used to endorse or promote products
 *     derived from this software without specific prior written permission.
 *
 *  THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS 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 AUTHOR 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.
 *  ====================================================================
 */