- General project information
- Purpose
This lib is a general purpose Java 2 library. It grows following the needs I
encounter when working on my other projects.
In fact, I put in it all the things I find useful to make reusable.
The goal is to provide developpers relevant and efficient material.
- Content
There's right now the following packages. This description shows some relevant points
of each of them, without beeing exhaustive.
-
org.shlublu.javax.awt :
Some I/O streams to use with awt text components. I needed it for a chat client, and
reused it for an administrator's console in a currently in developpment other project.
-
org.shlublu.javax.data :
Package dedicated to data representation and managing.
You can currentely find in it a
RFC 2045
compliant Base64
implementation, and a
RFC 1321 compliant
MD5 implementation.
Streams are provided with the encoding/decoding classes, for convenience.
-
org.shlublu.javax.io :
Convenience classes to group and cross-connect I and O streams.
-
org.shlublu.javax.lang :
A skeleton to make threads, and a
StringSubstitutor, dedicated to replace occurences of strings in java.lang.Strings.
-
org.shlublu.javax.log :
A convenience class using Apache Log4J.
I needed it for the chat I talked about, and reused it for the admin console too.
-
org.shlublu.javax.math :
Right now, this package contains
Point and
Vector hierarchies,
providing the most common operations.
-
org.shlublu.javax.net :
SocketIOStream,
a
org.shlublu.javax.io.BasicIOStream specialization.
-
org.shlublu.javax.util :
A Version number
managing class, and interface and implementation of a simple
History manager.
I needed this last one for the admin console, in order to just to get my
last commands by typing "arrow up".
- Documentation and directory structure
The doc currently available is this one, and a "protected"
JavaDoc stored in the docs/api directory.
Sources are available in src directory.
Classes are contained in both shlublulib.jar and classes directory.
The directory structure is the following :
Shlublu Java Lib root directory
|
|__COPYING.TXT The GNU Lesser General Public License file
|__releasenotes.html This file
|__shlubulib.jar Image of classes/*, to be used in CLASSPATH
|
|
|__classes The executable classes root directory
| |__org
| |__shlublu
| |__javax
| |__* The packages classes directories
|
|
|__docs The documentation root directory
| |__api Javadoc available following index.html
| |__index.html The entry point of the API documentation
| |__org
| |__shlublu
| |__javax
| |
| |__* The packages docs are available following package-summary.html
|
|
|__src The java sources root directory
| |__org
| |__shlublu
| |__javax
| |__* The packages sources directories
|
|
|__lib The open source software redistribution root directory
|__distribution.txt The access to the full software distributions
|__LICENSE.APL The corresponding license terms : Apache Software License v1.1
|__log4j.jar The Apache Log4J binaries
- Technical points, requirements
All packages were developped using the Sun's
Java 2 SDK Standard Edition v1.3.1.
Javac optimization -o flag was used at classes build time.
Apache Log4j package is
required to use instances of
org.shlublu.javax.log.ApplicationLog, but not to use static methods of this class.
This code was built using Log4j 1.1.2.
- Versionning
Major version number is the architecture version number.
Minor version number means stable/unstable, incrementally.
As an example, a burst of three version in the same architecture, with only the last one
stable will the following version numbers : 0.1, 0.3, 0.4
- Changes log
- v0.7 :
Also changed this release notes format from plain text to html
- v0.5 : 2002/03/23
- v0.3 : 2002/01/02
- v0.1 : 2001/30/12
- This is not really a release, but more a first try to get some feedback.
- Remaining bugs
- none referenced right now
- Fixed bugs
- v0.5 : 2002/03/23
- v0.3 : 2002/01/02
- To-do/requestes
- v0.5 : 2002/03/23
- v0.3 : 2002/01/02
- Conclusion
That's it ! I hope you'll enjoy
Shlublu Java Lib.
Any request, bug submission, comment ?
Juste tell me.
- Acknowledgments