Source Code Reference Guide
This file still needs to be updated to the new server.
Current as of December 2002.
The biocore
directory looks like:
-rw-r--r-- 1 buser bgroup 186 Nov 21 14:46 README -rw-r--r-- 1 buser bgroup 27167 Nov 22 11:02 build.xml drwxr-xr-x 7 buser bgroup 516 Dec 4 17:56 applets/ drwxr-xr-x 2 buser bgroup 459 Dec 4 17:56 distFiles/ drwxr-xr-x 5 buser bgroup 508 Dec 4 17:56 externalAPI/ drwxr-xr-x 6 buser bgroup 2712 Dec 4 17:56 src/ drwxr-xr-x 11 buser bgroup 883 Dec 4 17:56 web/
- README - Simple text readme file.
- build.xml - The ant configuration file. Explains all of the various options that you can give ant; explains how to compile with what dependencies, etc.
- applets/ - Source code for applets.
- distFiles/ - Files that get copied into distributions that
are generated when doing an
ant dist
. Very very few people will need to modify anything in this directory. - externalAPI/ - Code for the various flavors of the external APIs are in the directory.
- src/ - Servlet source code.
- web/ - Files that are served by tomcat that are not servlet related. This includes various html, image, and jar files. BioCoRE specific tomcat configuration files are also found in this path.
applets/
The applets/
directory looks like:
-rw-r--r-- 1 buser bgroup 398 Dec 5 2001 signjar drwxr-xr-x 3 buser bgroup 183 Dec 4 17:56 VMD/ drwxr-xr-x 2 buser bgroup 700 Dec 4 17:56 ApplicationRunner/ drwxr-xr-x 3 buser bgroup 1980 Dec 4 17:56 NAMD_CFG/ drwxr-xr-x 7 buser bgroup 878 Dec 4 17:56 ControlPanel/ drwxr-xr-x 3 buser bgroup 383 Dec 4 17:56 swing_test/
- signjar - Sample file that we use here for signing applets using netscape signing tools. You are free to modify for your own purposes.
- VMD/ - Source code for the VMD launcher applet. This applet looks in a few common spots for a VMD executable on the user's computer and launches VMD with a special command line that instructs it to communication with BioCoRE.
- ApplicationRunner/ - Old source code for an applet that can launch applications for the user. Not currently in use.
- NAMD_CFG/ - Source code for the NAMD Configuration File Generator. This applet can be used to create or edit config files for NAMD.
- ControlPanel/ - Source code for the Control Panel applet. This applet is handy communication tool that is in constant contact with the BioCoRE server.
- swing_test/ - Source code for the swing_test applet. The Control Panel is written using java Swing. Since browsers often don't have Swing, this applet is executed before the Control Panel applet. If the user has Swing, then the Control Panel is called. Otherwise, the user is given the opportunity to either install Swing (preferred) or use a temporary copy of swing, incurring a two megabyte download penalty.
externalAPI/
Additional information the external API is available at:http://www.ks.uiuc.edu/Research/biocore/dev/
src/
Thesrc
directory contains:
- The Java code files for a number of servlets. We have tried to
keep the servlet code itself minimal with attending code in the
TB/collab
directory. - A
util/
directory that contains utility classes used by all servlets.
- The
TB/collab
directory which contains subdirectories pertinent to certain servlets.- The
shared
directory contains code that is shared between the servlets and applets. This lets java objects be easily transferred from server to client. Thebuild.xml
ant configuration file takes care of copying shared files around as needed. - The
web/
Theweb
directory contains:
- applets/ - Jar files.
- icons/ - Generic miniature icons used by the BioFS to denote file types.
- updates/ - HTML files for update information for the BioCoRE code.
- docs/ - BioCoRE documentation. (Not complete)
- images/ - Various pictures used by the collaboratory.
- VMD/ - A tcl script that is read by user's VMD sessions to connect back to BioCoRE.
- html/ - Various html files that BioCoRE shows the user.
- sounds/ - Various sounds that the Control Panel can use for notification.
- WEB-INF/ - Tomcat specific directory. This directory isn't
visible to users and contains
web.xml
which is used to define how the BioCoRE server interacts with Tomcat. In addition, certain external JAR packages are stored in thelib
directory.
Feedback
The BioCoRE team welcomes any comments, questions, or suggestions that you might have concerning our software! Please email us or fill out our feedback form.