NST WUI

From NST Wiki
Revision as of 12:57, 20 March 2007 by Rwh (talk | contribs) (Implementing AJAX Style Features)
Jump to navigationJump to search

Overview

Directory Layout

The following lists the major directories a developer should be aware of when working with the NST WUI source code:

config/ 
Common configuration directory (several @macros() are defined here).
wui/ 
Root directory of the NST WUI (where you run: make).
wui/cgi-bin 
Root directory of CGI source files (bash scripts) making up the NST WUI.
wui/php 
Root directory of PHP source files making up the NST WUI.
include/skins/default/images 
Common (shared) image files.
wui/images 
Image files unique to the NST WUI.
include/skins/default/css 
Common (shared) CSS files.
wui/css 
CSS files unique to the NST WUI.
include/javascript 
Repository of JavaScript files.
include/atmacros 
Formal definition of @macros().
html/include/at 
HTML @macros() (loaded and then "tweaked" by NST WUI specific adjustments ).
wui/include/at 
NST WUI specific adjustments to @macros().
src/include/functions 
Collection of bash functions which will be installed to: "/nstwui/cgi-bin/include" when building the NST WUI.

Coding Tips

Referencing CSS and Image Files

Use the @imageDirUrl() and @cssDirUrl() when referencing image and CSS files. For example:

@p("See the image: @link("@imageDirUrl()/new_users.gif") or
the CSS file: @link("@cssDirUrl()/site.css").")

Implementing AJAX Style Features

As we venture into AJAX (shorthand for Asynchronous JavaScript and XML, is a web development technique for creating interactive web applications.), we will be creating server side scripts which generate small XML output which client side JavaScript can easily request, parse and process. Currently, we are leaning to the simple Java properties model. In this model, there are many property values each associated with a unique key. Using this model has the following advantages:

  • There is already a well defined DTD for these types of XML documents.
  • It is simple to implement.
  • It is fairly simple to write the client side (mapping keys to HTML page id attributes).

Example Server Side XML Output

Since we are following the DTD specified by the java.util.Properties class, the XML files generated on the server side will have the following form:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<!-- Might add a default style sheet for formatted viewing of CGI output -->

<properties>

  <comment<System Information</comment>

  <entry key="arch">i386</entry>
  <entry key="kernel">2.6.18-2857.fc5</entry>

</properties>

Example Server Side Source

In order to generate the properly formatted output, we will define a set of @macros. This should allow us to write CGI scripts in the following form:

@xmlPropertiesBegin("System Information","bash","true")

  @xmlProperty("arch","uname -m")
  @xmlProperty("system","uname -r")

@xmlPropertiesEnd()

The three macros shown above are fairly self explanatory. The second parameter to the @xmlPropertiesBegin() macro is used to indicate what scripting language will be used on the server. The third parameter to the @xmlPropertiesBegin() macro is used to indicate whether you want the standard set of properties included (system load, system time, etc - we haven't decided what these are yet).