Merge from helma_1_2_4

build/build.xml

@@ -8,7 +8,7 @@
     <target name="init">
         <property name="Name" value="helma"/>
         <property name="year" value="1998-${year}"/>
-        <property name="version" value="1.2.3"/>
+        <property name="version" value="1.3cvs"/>
         <property name="project" value="helma"/>
         <property name="build.compiler" value="classic"/>
 
@@ -28,8 +28,8 @@
 
         <property name="jar.name" value="${project}"/>
         <property name="package.name" value="${project}-${version}"/>
-        <property name="antclick.name" value="antclick-1.0pre5"/>
-        <property name="antville.name" value="antville-1.0pre1"/>
+        <property name="antclick.name" value="antclick-1.0cvs"/>
+        <property name="antville.name" value="antville-1.0cvs"/>
 
         <property name="debug" value="on"/>
         <property name="optimize" value="on"/>

src/helma/doc/DocApplication.java

@@ -1,76 +1,181 @@
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.doc;
 
 import helma.framework.IPathElement;
 import helma.main.Server;
+import helma.util.SystemProperties;
 import java.io.*;
 import java.util.*;
 
+/**
+ * 
+ */
 public class DocApplication extends DocDirElement {
+    HashSet excluded;
 
-   public static void main (String args[]) {
-//		DocApplication app;
-//		app = new DocApplication (args[0], args[1]);
-//		app.readApplication ();
-
-//		DocPrototype el = DocPrototype.newInstance (new File(args[0]));
-//		el.readFiles ();
-
-//		DocFunction func = DocFunction.newTemplate (new File(args[0]));
-//		DocFunction func = DocFunction.newAction (new File(args[0]));
-
-		DocFunction[] func = DocFunction.newFunctions (new File (args[0]));
-
-//		DocSkin skin = DocSkin.newInstance (new File (args[0]));
-//		System.out.println (func.getContent ());
-//		System.out.println ("\n\n\ncomment = " + func.getComment ());
+    /**
+     * Creates a new DocApplication object.
+     *
+     * @param name ...
+     * @param location ...
+     *
+     * @throws DocException ...
+     */
+    public DocApplication(String name, File location) throws DocException {
+        super(name, location, APPLICATION);
+        readProps();
     }
 
-
-	public DocApplication (String name, File location) throws DocException	{
-		super (name, location, APPLICATION);
+    /**
+     * Creates a new DocApplication object.
+     *
+     * @param name ...
+     * @param appDir ...
+     *
+     * @throws DocException ...
+     */
+    public DocApplication(String name, String appDir) throws DocException {
+        super(name, new File(appDir), APPLICATION);
+        readProps();
     }
 
-	public DocApplication (String name, String appDir) throws DocException	{
-		super (name, new File (appDir), APPLICATION);
+    /**
+     *
+     *
+     * @param args ...
+     */
+    public static void main(String[] args) {
+        //		DocApplication app;
+        //		app = new DocApplication (args[0], args[1]);
+        //		app.readApplication ();
+        //		DocPrototype el = DocPrototype.newInstance (new File(args[0]));
+        //		el.readFiles ();
+        //		DocFunction func = DocFunction.newTemplate (new File(args[0]));
+        //		DocFunction func = DocFunction.newAction (new File(args[0]));
+        DocFunction[] func = DocFunction.newFunctions(new File(args[0]));
+
+        //		DocSkin skin = DocSkin.newInstance (new File (args[0]));
+        //		System.out.println (func.getContent ());
+        //		System.out.println ("\n\n\ncomment = " + func.getComment ());
     }
 
+    /**
+     * reads the app.properties file and parses for helma.excludeDocs
+     */
+    private void readProps() {
+        File propsFile = new File(location, "app.properties");
+        SystemProperties serverProps = Server.getServer().getProperties();
+        SystemProperties appProps = new SystemProperties(propsFile.getAbsolutePath(),
+                                                         serverProps);
+
+        excluded = new HashSet();
+        addExclude("cvs");
+        addExclude(".docs");
+
+        String excludeProps = appProps.getProperty("helma.excludeDocs");
+
+        if (excludeProps != null) {
+            StringTokenizer tok = new StringTokenizer(excludeProps, ",");
+
+            while (tok.hasMoreTokens()) {
+                String str = tok.nextToken().trim();
+
+                addExclude(str);
+            }
+        }
+    }
+
+    /**
+     *
+     *
+     * @param str ...
+     */
+    public void addExclude(String str) {
+        excluded.add(str.toLowerCase());
+    }
+
+    /**
+     *
+     *
+     * @param str ...
+     *
+     * @return ...
+     */
+    public boolean isExcluded(String str) {
+        return (excluded.contains(str.toLowerCase()));
+    }
 
     /**
      * reads all prototypes and files of the application
      */
-	public void readApplication () {
-		String arr[] = location.list ();
-		children.clear ();
-		for (int i=0; i<arr.length; i++) {
-			if (Util.isExcluded (arr[i]))
+    public void readApplication() {
+        readProps();
+
+        String[] arr = location.list();
+
+        children.clear();
+
+        for (int i = 0; i < arr.length; i++) {
+            if (isExcluded(arr[i])) {
                 continue;
-			File f = new File (location.getAbsolutePath (), arr[i]);
-			if (!f.isDirectory ())
+            }
+
+            File f = new File(location.getAbsolutePath(), arr[i]);
+
+            if (!f.isDirectory()) {
                 continue;
+            }
+
             try {
-				DocPrototype pt = DocPrototype.newInstance (f, this);
-				addChild (pt);
-				pt.readFiles ();
+                DocPrototype pt = DocPrototype.newInstance(f, this);
+
+                addChild(pt);
+                pt.readFiles();
             } catch (DocException e) {
-				debug ("Couldn't read prototype " + arr[i] + ": " + e.getMessage ());
+                debug("Couldn't read prototype " + arr[i] + ": " + e.getMessage());
             }
-			System.out.println (f);
+
+            System.out.println(f);
         }
-		for (Iterator i=children.values ().iterator (); i.hasNext ();) {
-			((DocPrototype) i.next ()).checkInheritance ();
+
+        for (Iterator i = children.values().iterator(); i.hasNext();) {
+            ((DocPrototype) i.next()).checkInheritance();
         }
     }
 
-	public DocElement[] listFunctions ()	{
-		Vector allFunctions = new Vector ();
-		for (Iterator i = children.values ().iterator (); i.hasNext ();) {
-			DocElement proto = (DocElement) i.next ();
-			allFunctions.addAll (proto.children.values ());
-		}
-		Collections.sort (allFunctions, new DocComparator (DocComparator.BY_NAME, this));
-		return (DocElement[]) allFunctions.toArray (new DocElement[allFunctions.size ()]);
+    /**
+     *
+     *
+     * @return ...
+     */
+    public DocElement[] listFunctions() {
+        Vector allFunctions = new Vector();
+
+        for (Iterator i = children.values().iterator(); i.hasNext();) {
+            DocElement proto = (DocElement) i.next();
+
+            allFunctions.addAll(proto.children.values());
         }
 
+        Collections.sort(allFunctions, new DocComparator(DocComparator.BY_NAME, this));
+
+        return (DocElement[]) allFunctions.toArray(new DocElement[allFunctions.size()]);
+    }
 
     /**
      * from helma.framework.IPathElement, overridden with "api"
@@ -80,19 +185,13 @@ public class DocApplication extends DocDirElement	{
         return "api";
     }
 
-
     /**
      * from helma.framework.IPathElement, overridden with
      * Server.getServer() to work in manage-application
      */
     public IPathElement getParentElement() {
         Server s = helma.main.Server.getServer();
+
         return s.getChildElement(this.name);
     }
-
-
 }
-
-
-
-

src/helma/doc/DocComparator.java

@@ -1,44 +1,88 @@
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.doc;
 
 import java.util.Comparator;
 
+/**
+ * 
+ */
 public class DocComparator implements Comparator {
-
     public static final int BY_TYPE = 0;
     public static final int BY_NAME = 1;
-
     int mode;
     DocElement docEl;
 
+    /**
+     * Creates a new DocComparator object.
+     *
+     * @param mode ...
+     * @param docEl ...
+     */
     public DocComparator(int mode, DocElement docEl) {
         this.mode = mode;
         this.docEl = docEl;
     }
 
+    /**
+     * Creates a new DocComparator object.
+     *
+     * @param docEl ...
+     */
     public DocComparator(DocElement docEl) {
         this.mode = 0;
         this.docEl = docEl;
     }
 
+    /**
+     *
+     *
+     * @param obj1 ...
+     * @param obj2 ...
+     *
+     * @return ...
+     */
     public int compare(Object obj1, Object obj2) {
-		DocElement e1 = (DocElement)obj1;
-		DocElement e2 = (DocElement)obj2;
-		if (mode==BY_TYPE && e1.getType()>e2.getType())
+        DocElement e1 = (DocElement) obj1;
+        DocElement e2 = (DocElement) obj2;
+
+        if ((mode == BY_TYPE) && (e1.getType() > e2.getType())) {
             return 1;
-		else if (mode==BY_TYPE && e1.getType()<e2.getType())
+        } else if ((mode == BY_TYPE) && (e1.getType() < e2.getType())) {
             return -1;
-		else {
+        } else {
             return e1.name.compareTo(e2.name);
         }
     }
 
+    /**
+     *
+     *
+     * @param obj ...
+     *
+     * @return ...
+     */
     public boolean equals(Object obj) {
         DocElement el = (DocElement) obj;
-		if (el.name.equals(docEl.name) && el.getType()==docEl.getType()) {
+
+        if (el.name.equals(docEl.name) && (el.getType() == docEl.getType())) {
             return true;
         } else {
             return false;
         }
     }
-
 }

src/helma/doc/DocDirElement.java

@@ -1,36 +1,53 @@
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.doc;
 
+import FESI.Parser.*;
 import java.io.*;
 import java.util.*;
 
-import FESI.Parser.*;
-
+/**
+ * 
+ */
 public abstract class DocDirElement extends DocElement {
-
     // a default file that is read as comment for applications 
     // and prototypes if found in their directories
     public static final String[] DOCFILES = {
-		"doc.html", "doc.htm",
-		"app.html", "app.htm",
-		"prototype.html", "prototype.htm",
-		"index.html", "index.htm"
+                                                "doc.html", "doc.htm", "app.html",
+                                                "app.htm", "prototype.html",
+                                                "prototype.htm", "index.html", "index.htm"
                                             };
 
-	protected DocDirElement (String name, File location, int type) {
-		super (name, location, type);
-		checkCommentFiles ();
+    protected DocDirElement(String name, File location, int type) {
+        super(name, location, type);
+        checkCommentFiles();
     }
 
-	private void checkCommentFiles () throws DocException {
-		for (int i=0; i<DOCFILES.length; i++) {
-			File f = new File (location, DOCFILES[i]);
-			if (f.exists ()) {
-				String rawComment = readFile (f);
-				parseComment (rawComment);
+    private void checkCommentFiles() throws DocException {
+        for (int i = 0; i < DOCFILES.length; i++) {
+            File f = new File(location, DOCFILES[i]);
+
+            if (f.exists()) {
+                String rawComment = readFile(f);
+
+                parseComment(rawComment);
+
                 return;
             }
         }
     }
-
 }
-

src/helma/doc/DocElement.java

@@ -1,25 +1,29 @@
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.doc;
 
+import helma.framework.IPathElement;
 import java.io.*;
 import java.util.*;
 
-import helma.framework.IPathElement;
-
+/**
+ * 
+ */
 public abstract class DocElement implements IPathElement {
-
-	// identifiers of this element
-	String		name;
-	int			type;
-	File			location;
-	DocElement	parent = null;
-	Map			children = new HashMap ();
-
-	// content
-	String	content = "";
-	String	comment  = "";
-	List		tags       = new Vector ();
-	List		parameters = new Vector ();
-
     public static final int APPLICATION = 0;
     public static final int PROTOTYPE = 1;
     public static final int ACTION = 2;
@@ -31,23 +35,35 @@ public abstract class DocElement implements IPathElement	{
 
     // above constants are used as array indices
     public static final String[] typeNames = {
-		"Application",
-		"Prototype",
-		"Action",
-		"Template",
-		"Function",
-		"Macro",
-		"Skin",
+                                                 "Application", "Prototype", "Action",
+                                                 "Template", "Function", "Macro", "Skin",
                                                  "Properties"
                                              };
 
-	protected DocElement (String name, String location, int type) throws DocException	{
-		this (name, new File (location), type);
+    // identifiers of this element
+    String name;
+    int type;
+    File location;
+    DocElement parent = null;
+    Map children = new HashMap();
+
+    // content
+    String content = "";
+    String comment = "";
+    List tags = new Vector();
+    List parameters = new Vector();
+
+    protected DocElement(String name, String location, int type)
+                  throws DocException {
+        this(name, new File(location), type);
+    }
+
+    protected DocElement(String name, File location, int type)
+                  throws DocException {
+        if (location.exists() == false) {
+            throw new DocException(name + " not found in " + location.toString());
         }
 
-	protected DocElement (String name, File location, int type) throws DocException	{
-		if (location.exists()==false)
-			throw new DocException( name + " not found in " + location.toString ());
         this.name = name;
         this.location = location;
         this.type = type;
@@ -69,187 +85,265 @@ public abstract class DocElement implements IPathElement	{
         return location;
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public int getType() {
         return type;
     }
 
-	public String getTypeName ()	{
-		return typeNames [type];
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getTypeName() {
+        return typeNames[type];
     }
 
-
     /**
      * returns the comment string, empty string if no comment is set.
      */
-	public String getComment ()	{
+    public String getComment() {
         return comment;
     }
 
-
     /**
      * the actual content of the doc element (the function body, the properties
      * list, the file list etc.
      */
-	public String getContent ()	{
+    public String getContent() {
         return content;
     }
 
-
-	public void addTag (String rawContent) {
-		if (tags==null) {
-			tags = new Vector ();
+    /**
+     *
+     *
+     * @param rawContent ...
+     */
+    public void addTag(String rawContent) {
+        if (tags == null) {
+            tags = new Vector();
         }
+
         try {
-			DocTag tag = DocTag.parse (rawContent);
-			tags.add (tag);
-		} catch (DocException doc) {
-			debug (doc.toString ());
-		}
-	}
+            DocTag tag = DocTag.parse(rawContent);
 
+            tags.add(tag);
+        } catch (DocException doc) {
+            debug(doc.toString());
+        }
+    }
 
     /**
      * list all tags
      */
-	public DocTag[] listTags ()	{
-		return (DocTag[]) tags.toArray (new DocTag[0]);
+    public DocTag[] listTags() {
+        return (DocTag[]) tags.toArray(new DocTag[0]);
     }
 
-
     /**
      * filter the tags according to DocTag.TYPE
      */
-	public DocTag[] listTags (int type) {
-		Vector retval = new Vector ();
-		for (int i=0; i<tags.size (); i++) {
-			if ( ((DocTag) tags.get (i)).getType() == type)
-				retval.add (tags.get (i));
+    public DocTag[] listTags(int type) {
+        Vector retval = new Vector();
+
+        for (int i = 0; i < tags.size(); i++) {
+            if (((DocTag) tags.get(i)).getType() == type) {
+                retval.add(tags.get(i));
             }
-		return (DocTag[]) retval.toArray ();
         }
 
+        return (DocTag[]) retval.toArray();
+    }
 
-	public boolean hasParameter (String param) {
-		return parameters.contains (param);
+    /**
+     *
+     *
+     * @param param ...
+     *
+     * @return ...
+     */
+    public boolean hasParameter(String param) {
+        return parameters.contains(param);
     }
 
     /**
      * the list of parameters
      */
-	public String[] listParameters () {
-		return (String[]) parameters.toArray (new String[0]);
+    public String[] listParameters() {
+        return (String[]) parameters.toArray(new String[0]);
     }
 
-
     /**
      * add a string to the parameters-list
      */
-	protected void addParameter (String param) {
-		parameters.add (param);
+    protected void addParameter(String param) {
+        parameters.add(param);
     }
 
-
     /**
      * parse rawComment, render DocTags
      */
-	void parseComment (String rawComment)	{
+    void parseComment(String rawComment) {
         try {
-		StringTokenizer tok = new StringTokenizer (rawComment, "\n", true);
+            StringTokenizer tok = new StringTokenizer(rawComment, "\n", true);
             int BLANK = 0;
             int TEXT = 1;
             int TAGS = 2;
             boolean lastEmpty = false;
             int mode = BLANK;
-		StringBuffer buf = new StringBuffer ();
-		while (tok.hasMoreTokens ()) {
-			String line = Util.chopDelimiters (tok.nextToken ().trim ());
+            StringBuffer buf = new StringBuffer();
+
+            while (tok.hasMoreTokens()) {
+                String line = Util.chopDelimiters(tok.nextToken().trim());
+
                 if ("".equals(line)) {
                     // if we've already had text, store that this line was empty
-				lastEmpty = (mode!=BLANK) ? true : false;
+                    lastEmpty = (mode != BLANK) ? true : false;
+
                     continue;
                 }
+
                 // if we come here the first time, start with TEXT mode
-			mode = (mode==BLANK) ? TEXT : mode;
+                mode = (mode == BLANK) ? TEXT : mode;
+
                 // check if we have a new tag
-			if (DocTag.isTagStart (line)) {
+                if (DocTag.isTagStart(line)) {
                     // if we appended to comment text until now, store that ...
-				if (mode==TEXT)
-					comment = buf.toString ();
+                    if (mode == TEXT) {
+                        comment = buf.toString();
+                    }
+
                     // if we appended to a tag, store that ...
-				if (mode==TAGS)
-					addTag (buf.toString ());
+                    if (mode == TAGS) {
+                        addTag(buf.toString());
+                    }
+
                     // reset buffer
-				buf = new StringBuffer ();
+                    buf = new StringBuffer();
                     mode = TAGS;
                 }
+
                 // append to current buffer
-			if (lastEmpty==true)
-				buf.append ("\n");
-			buf.append (line);
-			buf.append (" ");
+                if (lastEmpty == true) {
+                    buf.append("\n");
+                }
+
+                buf.append(line);
+                buf.append(" ");
                 lastEmpty = false;
             }
+
             // store the last element, if there was at least one element ...
-		if (mode==TEXT)
-			comment = buf.toString ();
-		else if (mode==TAGS)
-			addTag (buf.toString ());
+            if (mode == TEXT) {
+                comment = buf.toString();
+            } else if (mode == TAGS) {
+                addTag(buf.toString());
+            }
         } catch (RuntimeException rt) {
-	   debug ("parse error in " + location + ": " + rt.getMessage());
+            debug("parse error in " + location + ": " + rt.getMessage());
         }
     }
 
     /**
      * utility: read a complete file into a string
      */
-	protected static String readFile (File file)	{
+    protected static String readFile(File file) {
         try {
-			StringBuffer buf = new StringBuffer ();
-			BufferedReader in = new BufferedReader (new FileReader (file));
- 			String line = in.readLine ();
- 			while(line!=null)	{
-	 			buf.append (line+"\n");
-	 			line = in.readLine ();
+            StringBuffer buf = new StringBuffer();
+            BufferedReader in = new BufferedReader(new FileReader(file));
+            String line = in.readLine();
+
+            while (line != null) {
+                buf.append(line + "\n");
+                line = in.readLine();
             }
- 			in.close ();
+
+            in.close();
+
             return buf.toString();
         } catch (IOException e) {
             return ("");
         }
     }
 
-
-	public void setParent (DocElement parent) {
+    /**
+     *
+     *
+     * @param parent ...
+     */
+    public void setParent(DocElement parent) {
         this.parent = parent;
     }
 
-	public void addChild (DocElement child) {
-		if (child==null)
+    /**
+     *
+     *
+     * @param child ...
+     */
+    public void addChild(DocElement child) {
+        if (child == null) {
             return;
-		children.put (child.getElementName (), child);
         }
 
-	public int countChildren () {
-		return children.size ();
+        children.put(child.getElementName(), child);
     }
 
-	public Map getChildren () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public int countChildren() {
+        return children.size();
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Map getChildren() {
         return children;
     }
 
     /**
      * returns an array of doc elements, sorted by their name
      */
-	public DocElement[] listChildren () {
-		String[] keys = (String[]) children.keySet ().toArray (new String[0]);
-		Arrays.sort (keys);
-		DocElement[] arr = new DocElement [keys.length];
-		for (int i=0; i<keys.length; i++) {
-			arr [i] = (DocElement) children.get (keys[i]);
+    public DocElement[] listChildren() {
+        String[] keys = (String[]) children.keySet().toArray(new String[0]);
+
+        Arrays.sort(keys);
+
+        DocElement[] arr = new DocElement[keys.length];
+
+        for (int i = 0; i < keys.length; i++) {
+            arr[i] = (DocElement) children.get(keys[i]);
         }
+
         return arr;
     }
 
+    /**
+     * walks up the tree and tries to find a DocApplication object
+     */
+    public DocApplication getDocApplication() {
+        DocElement el = this;
+
+        while (el != null) {
+            if (el instanceof DocApplication) {
+                return (DocApplication) el;
+            }
+
+            el = (DocElement) el.getParentElement();
+        }
+
+        return null;
+    }
+
     /**
      * from helma.framework.IPathElement. Elements are named
      * like this: typename_name
@@ -258,47 +352,52 @@ public abstract class DocElement implements IPathElement	{
         return typeNames[type].toLowerCase() + "_" + name;
     }
 
-
     /**
      * from helma.framework.IPathElement. Retrieves a child from the
      * children map.
      */
-	public IPathElement getChildElement (String name) {
+    public IPathElement getChildElement(String name) {
         try {
-			return (IPathElement) children.get (name);
+            return (IPathElement) children.get(name);
         } catch (ClassCastException cce) {
-			debug (cce.toString ());
-			cce.printStackTrace ();
+            debug(cce.toString());
+            cce.printStackTrace();
+
             return null;
         }
     }
 
-
     /**
      * from helma.framework.IPathElement. Returns the parent object
      * of this instance if assigned.
      */
-	public IPathElement getParentElement ()	{
+    public IPathElement getParentElement() {
         return parent;
     }
 
-
     /**
      * from helma.framework.IPathElement. Prototypes are assigned like
      * this: "doc" + typename (e.g. docapplication, docprototype etc)
      */
-	public java.lang.String getPrototype ()	{
-		return "doc" + typeNames[type].toLowerCase ();
+    public java.lang.String getPrototype() {
+        return "doc" + typeNames[type].toLowerCase();
     }
 
-
-	public String toString () {
-		return "[" + typeNames [type] + " " + name + "]";
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String toString() {
+        return "[" + typeNames[type] + " " + name + "]";
     }
 
-	public static void debug (String msg) {
+    /**
+     *
+     *
+     * @param msg ...
+     */
+    public static void debug(String msg) {
         System.out.println(msg);
     }
-
 }
-

src/helma/doc/DocException.java

@@ -1,16 +1,43 @@
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.doc;
 
+/**
+ * 
+ */
 public class DocException extends RuntimeException {
-
     String str;
 
-    public DocException (String str) {
-		super (str);
+    /**
+     * Creates a new DocException object.
+     *
+     * @param str ...
+     */
+    public DocException(String str) {
+        super(str);
         this.str = str;
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public String getMessage() {
         return str;
     }
-    
 }

src/helma/doc/DocFileElement.java

@@ -1,84 +1,112 @@
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.doc;
 
+import FESI.Parser.*;
 import java.io.*;
 import java.util.*;
 
-import FESI.Parser.*;
-
+/**
+ * 
+ */
 public abstract class DocFileElement extends DocElement {
+    protected DocFileElement(String name, File location, int type) {
+        super(name, location, type);
+    }
 
     /**
      * extracts the function name from a file. basically chops the given suffix
      * and throws an error if the file name doesn't fit.
      */
-	static protected String nameFromFile (File f, String suffix) throws DocException {
-		String filename = f.getName ();
-		if (!filename.endsWith (suffix))
-			throw new DocException ("file doesn't have suffix " + suffix + ": " + f.toString());
-		return filename.substring (0, filename.lastIndexOf(suffix));
+    static protected String nameFromFile(File f, String suffix)
+                                  throws DocException {
+        String filename = f.getName();
+
+        if (!filename.endsWith(suffix)) {
+            throw new DocException("file doesn't have suffix " + suffix + ": " +
+                                   f.toString());
         }
 
+        return filename.substring(0, filename.lastIndexOf(suffix));
+    }
 
     /**
      * creates fesi token manager for a given file.
      */
-	static protected EcmaScriptTokenManager createTokenManager (File f)	{
+    static protected EcmaScriptTokenManager createTokenManager(File f) {
         try {
             ASCII_CharStream is = new ASCII_CharStream(new FileReader(f), 1, 1);
-			EcmaScriptTokenManager mgr = new EcmaScriptTokenManager(is,0);
+            EcmaScriptTokenManager mgr = new EcmaScriptTokenManager(is, 0);
+
             return mgr;
         } catch (FileNotFoundException fnfe) {
-			fnfe.printStackTrace ();
-			throw new DocException (fnfe.toString ());
+            fnfe.printStackTrace();
+            throw new DocException(fnfe.toString());
         }
     }
 
-
-	protected DocFileElement (String name, File location, int type) {
-		super (name, location, type);
-	}
-
-
     /**
      * extracts a part of the source code, used to get the code for a
      * single function from a function file. sets the field "content".
      */
-	protected void parseSource (File sourceFile, int beginLine, int beginColumn, int endLine, int endColumn)	{
-		StringBuffer buf = new StringBuffer ();
-		int ct=0;
+    protected void parseSource(File sourceFile, int beginLine, int beginColumn,
+                               int endLine, int endColumn) {
+        StringBuffer buf = new StringBuffer();
+        int ct = 0;
+
         try {
-			BufferedReader in = new BufferedReader (new FileReader (sourceFile));
-			String line="";
- 			while (line!=null)	{
+            BufferedReader in = new BufferedReader(new FileReader(sourceFile));
+            String line = "";
+
+            while (line != null) {
                 line = in.readLine();
- 				if (line==null)	break;
- 				ct++;
- 				if (ct==beginLine)
- 					buf.append (line.substring(beginColumn-1, line.length())+"\n");
- 				else if ( ct>beginLine && ct<endLine )
- 					buf.append (line+"\n");
- 				else if (ct==endLine)
- 					buf.append (line.substring(0,endColumn));
- 			}
- 		}	catch (Exception e)	{
-			debug (e.getMessage ());
-	 	}
- 		content = buf.toString ();
+
+                if (line == null) {
+                    break;
                 }
 
+                ct++;
+
+                if (ct == beginLine) {
+                    buf.append(line.substring(beginColumn - 1, line.length()) + "\n");
+                } else if ((ct > beginLine) && (ct < endLine)) {
+                    buf.append(line + "\n");
+                } else if (ct == endLine) {
+                    buf.append(line.substring(0, endColumn));
+                }
+            }
+        } catch (Exception e) {
+            debug(e.getMessage());
+        }
+
+        content = buf.toString();
+    }
 
     /**
      * connects all available specialTokens starting at the given token.
      */
-	protected void parseCommentFromToken (Token tok)	{
+    protected void parseCommentFromToken(Token tok) {
         StringBuffer buf = new StringBuffer();
-		while (tok.specialToken!=null) {
-			buf.append (tok.specialToken.toString() );
+
+        while (tok.specialToken != null) {
+            buf.append(tok.specialToken.toString());
             tok = tok.specialToken;
         }
-		parseComment (buf.toString().trim());
+
+        parseComment(buf.toString().trim());
     }
-
-
 }
-

src/helma/doc/DocFunction.java

@@ -1,154 +1,185 @@
-package helma.doc;
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
-import java.io.*;
-import java.util.*;
+package helma.doc;
 
 import FESI.Parser.*;
 import helma.framework.IPathElement;
+import java.io.*;
+import java.util.*;
 
+/**
+ * 
+ */
 public class DocFunction extends DocFileElement {
+    protected DocFunction(String name, File location, DocElement parent, int type) {
+        super(name, location, type);
+        this.parent = parent;
+    }
 
     /**
      * creates a new independent DocFunction object of type ACTION
      */
-	public static DocFunction newAction (File location) {
-		return newAction (location, null);
+    public static DocFunction newAction(File location) {
+        return newAction(location, null);
     }
 
-
     /**
      * creates a new DocFunction object of type ACTION connected to another DocElement
      */
-	public static DocFunction newAction (File location, DocElement parent) {
-		String name = nameFromFile (location, ".hac");
-		DocFunction func = new DocFunction (name, location, parent, ACTION);
-		func.parseActionFile ();
+    public static DocFunction newAction(File location, DocElement parent) {
+        String name = nameFromFile(location, ".hac");
+        DocFunction func = new DocFunction(name, location, parent, ACTION);
+
+        func.parseActionFile();
+
         return func;
     }
 
     /**
      * creates a new independent DocFunction object of type TEMPLATE
      */
-	public static DocFunction newTemplate (File location) {
-		return newTemplate (location, null);
+    public static DocFunction newTemplate(File location) {
+        return newTemplate(location, null);
     }
 
-
     /**
      * creates a new DocFunction object of type TEMPLATE connected to another DocElement
      */
-	public static DocFunction newTemplate (File location, DocElement parent) {
-		String name = nameFromFile (location, ".hsp");
-		DocFunction func = new DocFunction (name, location, parent, TEMPLATE);
-		func.parseTemplateFile ();
+    public static DocFunction newTemplate(File location, DocElement parent) {
+        String name = nameFromFile(location, ".hsp");
+        DocFunction func = new DocFunction(name, location, parent, TEMPLATE);
+
+        func.parseTemplateFile();
+
         return func;
     }
 
-
     /**
      * reads a function file and creates independent DocFunction objects of type FUNCTION
      */
-	public static DocFunction[] newFunctions (File location) {
-		return newFunctions (location, null);
+    public static DocFunction[] newFunctions(File location) {
+        return newFunctions(location, null);
     }
 
-
     /**
      * reads a function file and creates DocFunction objects of type FUNCTION
      * connected to another DocElement.
      */
-	public static DocFunction[] newFunctions (File location, DocElement parent) {
-		Vector vec = new Vector ();
+    public static DocFunction[] newFunctions(File location, DocElement parent) {
+        Vector vec = new Vector();
         EcmaScriptTokenManager mgr = createTokenManager(location);
         Token tok = mgr.getNextToken();
-		while (tok.kind!=0) {
+
+        while (tok.kind != 0) {
             if (tok.kind == EcmaScriptConstants.FUNCTION) {
                 // store the start position of the function:
                 int beginLine = tok.beginLine;
                 int beginColumn = tok.beginColumn;
+
                 // the name is stored in the next token:
                 String funcName = mgr.getNextToken().toString();
+
                 // create the function object
                 DocFunction func;
-				if (funcName.endsWith("_action"))
-					func = new DocFunction (funcName, location, parent, ACTION);
-				else if (funcName.endsWith("_macro"))
-					func = new DocFunction (funcName, location, parent, MACRO);
-				else
-					func = new DocFunction (funcName, location, parent, FUNCTION);
+
+                if (funcName.endsWith("_action")) {
+                    func = new DocFunction(funcName, location, parent, ACTION);
+                } else if (funcName.endsWith("_macro")) {
+                    func = new DocFunction(funcName, location, parent, MACRO);
+                } else {
+                    func = new DocFunction(funcName, location, parent, FUNCTION);
+                }
+
                 // parse the comment from the special token(s) before this token:
-				func.parseCommentFromToken (tok);
+                func.parseCommentFromToken(tok);
+
                 // find the parameters of this function, but only if it's
                 // neither macro nor action:
-				if (func.type==FUNCTION) {
-					while (tok.kind!=0 && tok.kind!=EcmaScriptConstants.RPAREN) {
-						if (tok.kind==EcmaScriptConstants.IDENTIFIER) {
-							func.addParameter (tok.image);
+                if (func.type == FUNCTION) {
+                    while ((tok.kind != 0) && (tok.kind != EcmaScriptConstants.RPAREN)) {
+                        if (tok.kind == EcmaScriptConstants.IDENTIFIER) {
+                            func.addParameter(tok.image);
                         }
-						tok = mgr.getNextToken ();
+
+                        tok = mgr.getNextToken();
                     }
                 } else {
-					tok = mgr.getNextToken ();
+                    tok = mgr.getNextToken();
                 }
+
                 // now find the end of the function:
-				int endLine=0, endColumn=0;
-				while (tok.kind!=0 && tok.kind!=EcmaScriptConstants.FUNCTION)	{
+                int endLine = 0;
+
+                // now find the end of the function:
+                int endColumn = 0;
+
+                while ((tok.kind != 0) && (tok.kind != EcmaScriptConstants.FUNCTION)) {
                     endLine = tok.endLine;
                     endColumn = tok.endColumn;
-					tok = mgr.getNextToken ();
+                    tok = mgr.getNextToken();
                 }
+
                 // now we know the exact position of the function in the file,
                 // re-read it and extract the source code:
-				func.parseSource (location, beginLine, beginColumn, endLine, endColumn);
-				vec.add (func);
+                func.parseSource(location, beginLine, beginColumn, endLine, endColumn);
+                vec.add(func);
             }
+
             if (tok.kind != EcmaScriptConstants.FUNCTION) {
                 tok = mgr.getNextToken();
             }
         }
-		return (DocFunction[]) vec.toArray (new DocFunction[0]);
-	}
 
-	protected DocFunction (String name, File location, DocElement parent, int type) {
-		super (name, location, type);
-		this.parent = parent;
+        return (DocFunction[]) vec.toArray(new DocFunction[0]);
     }
 
-
     /**
      * reads the content of a .hac file and parses the comment before the first
      * javascript element
      */
-	private void parseActionFile () {
+    private void parseActionFile() {
         EcmaScriptTokenManager mgr = createTokenManager(location);
         Token tok = mgr.getNextToken();
-		parseCommentFromToken (tok);
-		content = readFile (location);
-	}
 
+        parseCommentFromToken(tok);
+        content = readFile(location);
+    }
 
     /**
      * reads the content of a .hsp file and parses the comment before the first
      * javascript element (only if file starts with >%-tag!).
      */
-	private void parseTemplateFile () {
-		content = readFile (location);
-		StringReader str = new StringReader (content.substring (content.indexOf("<%") + 2, content.indexOf ("%>")));
-		ASCII_CharStream ascii = new ASCII_CharStream (str,1,1);
-		EcmaScriptTokenManager mgr = new EcmaScriptTokenManager (ascii);
-		Token tok = mgr.getNextToken();
-		parseCommentFromToken (tok);
-	}
+    private void parseTemplateFile() {
+        content = readFile(location);
 
+        StringReader str = new StringReader(content.substring(content.indexOf("<%") + 2,
+                                                              content.indexOf("%>")));
+        ASCII_CharStream ascii = new ASCII_CharStream(str, 1, 1);
+        EcmaScriptTokenManager mgr = new EcmaScriptTokenManager(ascii);
+        Token tok = mgr.getNextToken();
+
+        parseCommentFromToken(tok);
+    }
 
     /**
      * from helma.framework.IPathElement. All macros, templates, actions etc
      * have the same prototype.
      */
-	public java.lang.String getPrototype ()	{
+    public java.lang.String getPrototype() {
         return "docfunction";
     }
-
-
 }
-

src/helma/doc/DocProperties.java

@@ -1,3 +1,19 @@
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.doc;
 
 import helma.framework.IPathElement;
@@ -5,59 +21,76 @@ import helma.util.SystemProperties;
 import java.io.*;
 import java.util.*;
 
+/**
+ * 
+ */
 public class DocProperties extends DocFileElement {
-
     Properties props = null;
 
+    protected DocProperties(File location, DocElement parent)
+                     throws DocException {
+        super(location.getName(), location, PROPERTIES);
+        this.parent = parent;
+        content = readFile(location);
+        props = new SystemProperties();
+
+        try {
+            props.load(new FileInputStream(location));
+        } catch (IOException e) {
+            debug("couldn't read file: " + e.toString());
+        } catch (Exception e) {
+            throw new DocException(e.toString());
+        }
+    }
+
     /**
      * creates a new independent DocProperties object
      */
-	public static DocProperties newInstance (File location) {
-		return newInstance (location, null);
+    public static DocProperties newInstance(File location) {
+        return newInstance(location, null);
     }
 
     /**
      * creates a new DocProperties object connected to another DocElement
      */
-	public static DocProperties newInstance (File location, DocElement parent) {
+    public static DocProperties newInstance(File location, DocElement parent) {
         try {
-			return new DocProperties (location, parent);
+            return new DocProperties(location, parent);
         } catch (DocException doc) {
             return null;
         }
     }
 
-	protected DocProperties (File location, DocElement parent) throws DocException {
-		super (location.getName (), location, PROPERTIES);
-		this.parent = parent;
-		content = readFile (location);
-		props = new SystemProperties ();
-		try {
-			props.load (new FileInputStream (location));
-		} catch (IOException e) {
-			debug ("couldn't read file: " + e.toString ());
-		} catch (Exception e) {
-			throw new DocException (e.toString ());
-		}
-	}
-
-	public Properties getProperties () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Properties getProperties() {
         return props;
     }
 
-	public Properties getMappings () {
-		Properties childProps = new Properties ();
-		for (Enumeration e = props.keys (); e.hasMoreElements (); ) {
-			String key = (String) e.nextElement ();
-			String value = props.getProperty (key);
-			if (value.startsWith ("collection") || value.startsWith ("object") || value.startsWith ("mountpoint")) {
-				String prototype = value.substring (value.indexOf("(")+1, value.indexOf(")")).trim ();
-				childProps.setProperty (key, prototype);
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Properties getMappings() {
+        Properties childProps = new Properties();
+
+        for (Enumeration e = props.keys(); e.hasMoreElements();) {
+            String key = (String) e.nextElement();
+            String value = props.getProperty(key);
+
+            if (value.startsWith("collection") || value.startsWith("object") ||
+                    value.startsWith("mountpoint")) {
+                String prototype = value.substring(value.indexOf("(") + 1,
+                                                   value.indexOf(")")).trim();
+
+                childProps.setProperty(key, prototype);
+            }
         }
 
-		}
         return childProps;
     }
-
 }
-

src/helma/doc/DocPrototype.java

@@ -1,23 +1,46 @@
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.doc;
 
+import FESI.Parser.*;
 import helma.framework.IPathElement;
 import java.io.*;
 import java.util.*;
-import FESI.Parser.*;
-
 
+/**
+ * 
+ */
 public class DocPrototype extends DocDirElement {
-
     private DocProperties typeProperties = null;
     private DocPrototype parentPrototype = null;
 
+    private DocPrototype(String name, File location, DocElement parent) {
+        super(name, location, PROTOTYPE);
+        this.parent = parent;
+        typeProperties = DocProperties.newInstance(new File(location, "type.properties"));
+    }
+
     /**
      * creates a prototype that is independent of an
      * application object
      * @param homedirectory
      */
-	public static DocPrototype newInstance (File location) {
-		return newInstance (location, null);
+    public static DocPrototype newInstance(File location) {
+        return newInstance(location, null);
     }
 
     /**
@@ -26,85 +49,102 @@ public class DocPrototype extends DocDirElement	{
      * @param application
      * @param name
      */
-	public static DocPrototype newInstance (File location, DocElement parent) {
-		DocPrototype pt = new DocPrototype (location.getName (), location, parent);
+    public static DocPrototype newInstance(File location, DocElement parent) {
+        DocPrototype pt = new DocPrototype(location.getName(), location, parent);
+
         return pt;
     }
 
-	private DocPrototype (String name, File location, DocElement parent) {
-		super (name, location, PROTOTYPE);
-		this.parent = parent;
-		typeProperties = DocProperties.newInstance (new File (location, "type.properties"));
-	}
-
-
     /**
      * checks the type.properites for _extend values and connected a possible
      * parent prototype with this prototype. this can't be successfull at construction
      * time but only -after- all prototypes are parsed and attached to a parent
      * DocApplication object.
      */
-	public void checkInheritance () {
+    public void checkInheritance() {
         // hopobject is the top prototype:
-		if (name.equals("hopobject"))
+        if (name.equals("hopobject")) {
             return;
-		if (typeProperties!=null) {
+        }
+
+        if (typeProperties != null) {
             // check for "_extends" in the the type.properties
-			String ext = typeProperties.getProperties ().getProperty ("_extends");
-			if (ext!=null && parent!=null) {
+            String ext = typeProperties.getProperties().getProperty("_extends");
+
+            if ((ext != null) && (parent != null)) {
                 // try to get the prototype if available
-				parentPrototype = (DocPrototype) parent.getChildElement ("prototype_" + ext);
-			}
-		}
-		if (parentPrototype==null && parent!=null && !name.equals("global")) {
-			// if no _extend was set, get the hopobject prototype
-			parentPrototype = (DocPrototype) parent.getChildElement ("prototype_hopobject");
+                parentPrototype = (DocPrototype) parent.getChildElement("prototype_" +
+                                                                        ext);
             }
         }
 
-	public DocPrototype getParentPrototype () {
+        if ((parentPrototype == null) && (parent != null) && !name.equals("global")) {
+            // if no _extend was set, get the hopobject prototype
+            parentPrototype = (DocPrototype) parent.getChildElement("prototype_hopobject");
+        }
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public DocPrototype getParentPrototype() {
         return parentPrototype;
     }
 
-
-	public DocProperties getTypeProperties () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public DocProperties getTypeProperties() {
         return typeProperties;
     }
 
-
     /**
      * runs through the prototype directory and parses all helma files
      */
-	public void readFiles () {
-		children.clear ();
-		String arr[] = location.list ();
-		for (int i=0; i<arr.length; i++) {
-			if (Util.isExcluded (arr[i]))
+    public void readFiles() {
+        children.clear();
+
+        String[] arr = location.list();
+
+        for (int i = 0; i < arr.length; i++) {
+            if (getDocApplication().isExcluded(arr[i])) {
                 continue;
-			File f = new File (location.getAbsolutePath (), arr[i]);
-			if (f.isDirectory ())
+            }
+
+            File f = new File(location.getAbsolutePath(), arr[i]);
+
+            if (f.isDirectory()) {
                 continue;
+            }
+
             try {
-			   if (arr[i].endsWith (".skin")) {
-				   addChild (DocSkin.newInstance (f, this));
-			   } else if (arr[i].endsWith (".properties")) {
+                if (arr[i].endsWith(".skin")) {
+                    addChild(DocSkin.newInstance(f, this));
+                } else if (arr[i].endsWith(".properties")) {
                     continue;
-   			} else if (arr[i].endsWith (".hac")) {
-				   addChild (DocFunction.newAction (f, this));
-			   } else if (arr[i].endsWith (".hsp")) {
-   				addChild (DocFunction.newTemplate (f, this));
-	   		} else if (arr[i].endsWith (".js")) {
-		   		DocElement[] elements = DocFunction.newFunctions (f, this);
-			   	for (int j=0; j<elements.length; j++) {
-				   	addChild (elements[j]);
+                } else if (arr[i].endsWith(".hac")) {
+                    addChild(DocFunction.newAction(f, this));
+                } else if (arr[i].endsWith(".hsp")) {
+                    addChild(DocFunction.newTemplate(f, this));
+                } else if (arr[i].endsWith(".js")) {
+                    DocElement[] elements = DocFunction.newFunctions(f, this);
+
+                    for (int j = 0; j < elements.length; j++) {
+                        addChild(elements[j]);
                     }
                 }
             } catch (Exception ex) {
-            System.out.println ("couldn't parse file " + f.getAbsolutePath () + ": " + ex.toString ());
-            ex.printStackTrace ();
+                System.out.println("couldn't parse file " + f.getAbsolutePath() + ": " +
+                                   ex.toString());
+                ex.printStackTrace();
+            } catch (FESI.Parser.TokenMgrError err) {
+                System.out.println("couldn't parse file " + f.getAbsolutePath() + ": " +
+                                   err.toString());
             }
         }
     }
-
 }
-

src/helma/doc/DocSkin.java

@@ -1,87 +1,118 @@
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.doc;
 
 import helma.framework.IPathElement;
 import java.io.*;
 import java.util.*;
 
+/**
+ * 
+ */
 public class DocSkin extends DocFileElement {
+    protected DocSkin(String name, File location, DocElement parent) {
+        super(name, location, SKIN);
+        this.parent = parent;
+        content = readFile(location);
+        parseHandlers();
+    }
 
     /**
      * creates a new independent DocSkin object
      */
-	public static DocSkin newInstance (File location) {
-		return newInstance (location, null);
+    public static DocSkin newInstance(File location) {
+        return newInstance(location, null);
     }
 
     /**
      * creates a new DocSkin object connected to another DocElement
      */
-	public static DocSkin newInstance (File location, DocElement parent) {
-		String skinname = nameFromFile (location, ".skin");
-		DocSkin skin = new DocSkin (skinname, location, parent);
+    public static DocSkin newInstance(File location, DocElement parent) {
+        String skinname = nameFromFile(location, ".skin");
+        DocSkin skin = new DocSkin(skinname, location, parent);
+
         return skin;
     }
 
-	protected DocSkin (String name, File location, DocElement parent) {
-		super (name, location, SKIN);
-		this.parent = parent;
-		content = readFile (location);
-		parseHandlers ();
-	}
-
-
     /**
      * parses the source code of the skin and
      * extracts all included macros. code taken
      * from helma.framework.core.Skin
      * @see helma.framework.core.Skin
      */
-	private void parseHandlers () {
-		ArrayList partBuffer = new ArrayList ();
-		char[] source = content.toCharArray ();
+    private void parseHandlers() {
+        ArrayList partBuffer = new ArrayList();
+        char[] source = content.toCharArray();
         int sourceLength = source.length;
         int start = 0;
-		for (int i = 0; i < sourceLength-1; i++) {
-			if (source[i] == '<' && source[i+1] == '%') {
+
+        for (int i = 0; i < (sourceLength - 1); i++) {
+            if ((source[i] == '<') && (source[i + 1] == '%')) {
                 // found macro start tag
-				int j = i+2;
+                int j = i + 2;
+
                 // search macro end tag
-				while (j < sourceLength-1 && (source[j] != '%' || source[j+1] != '>')) {
+                while ((j < (sourceLength - 1)) &&
+                           ((source[j] != '%') || (source[j + 1] != '>'))) {
                     j++;
                 }
-				if (j > i+2) {
-					String str = (new String (source, i+2, j-i)).trim ();
-					if (str.endsWith("%>"))
-						str = str.substring (0, str.length()-2);
-					if (str.indexOf (" ")>-1)
-						str = str.substring (0, str.indexOf(" "));
-					if (str.indexOf(".")>-1 && 
-						(str.startsWith ("param.")
-						 || str.startsWith ("response.")
-						 || str.startsWith("request.")
-						 || str.startsWith ("session.")
-						) && !partBuffer.contains(str)) {
-						partBuffer.add (str);
+
+                if (j > (i + 2)) {
+                    String str = (new String(source, i + 2, j - i)).trim();
+
+                    if (str.endsWith("%>")) {
+                        str = str.substring(0, str.length() - 2);
                     }
-					start = j+2;
+
+                    if (str.startsWith("//")) {
+                        parseComment(str);
+                    } else {
+                        if (str.indexOf(" ") > -1) {
+                            str = str.substring(0, str.indexOf(" "));
                         }
-				i = j+1;
+
+                        if ((str.indexOf(".") > -1) &&
+                                (str.startsWith("param.") || str.startsWith("response.") ||
+                                str.startsWith("request.") || str.startsWith("session.")) &&
+                                !partBuffer.contains(str)) {
+                            partBuffer.add(str);
                         }
                     }
-		String[] strArr = (String[]) partBuffer.toArray (new String [0]);
-		Arrays.sort (strArr);
-		for (int i=0; i<strArr.length; i++) {
-			addParameter (strArr[i]);
+
+                    start = j + 2;
+                }
+
+                i = j + 1;
+            }
+        }
+
+        String[] strArr = (String[]) partBuffer.toArray(new String[0]);
+
+        Arrays.sort(strArr);
+
+        for (int i = 0; i < strArr.length; i++) {
+            addParameter(strArr[i]);
         }
     }
 
     /**
      * from helma.framework.IPathElement. Use the same prototype as functions etc.
      */
-	public java.lang.String getPrototype ()	{
+    public java.lang.String getPrototype() {
         return "docfunction";
     }
-
-
 }
-

src/helma/doc/DocTag.java

@@ -1,9 +1,27 @@
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.doc;
 
 import java.util.*;
 
+/**
+ * 
+ */
 public final class DocTag {
-
     // for public use we have less types than
     // internally. eg, we're combining "return" and "returns"
     // or "arg" and "param".
@@ -16,93 +34,143 @@ public final class DocTag	{
     public static final int SEE = 6;
     public static final int DEPRECATED = 7;
     public static final int OVERRIDES = 8;
-
     public static final String[][] tags = {
-		{"@arg","Argument"},
-		{"@param","Parameter"},
-		{"@return","Returns"},
-		{"@returns","Returns"},
-		{"@author","Author"},
-		{"@version","Version"},
-		{"@see","See also"},
-		{"@deprecated", "Deprecated"},
-		{"@overrides", "Overrides"}
+                                              { "@arg", "Argument" },
+                                              { "@param", "Parameter" },
+                                              { "@return", "Returns" },
+                                              { "@returns", "Returns" },
+                                              { "@author", "Author" },
+                                              { "@version", "Version" },
+                                              { "@see", "See also" },
+                                              { "@deprecated", "Deprecated" },
+                                              { "@overrides", "Overrides" }
                                           };
-
     private String name;
+
     // "kind" is for internal use, "type" is external
     private int kind;
     private String text;
 
-	public static boolean isTagStart (String rawTag) {
-		if (getTagNumber(rawTag) > -1)
+    private DocTag(int kind, String name, String text) {
+        this.kind = kind;
+        this.name = (name != null) ? name : "";
+        this.text = (text != null) ? text : "";
+    }
+
+    /**
+     *
+     *
+     * @param rawTag ...
+     *
+     * @return ...
+     */
+    public static boolean isTagStart(String rawTag) {
+        if (getTagNumber(rawTag) > -1) {
             return true;
-		else
+        } else {
             return false;
         }
+    }
 
-	public static DocTag parse (String rawTag) throws DocException {
-		int kind = getTagNumber (rawTag);
-		if (kind == -1)
-			throw new DocException ("unsupported tag type: " + rawTag);
-		String content = rawTag.substring (tags[kind][0].length ()+1).trim ();
-		if (kind == 0 || kind==1) {
-			StringTokenizer tok = new StringTokenizer (content);
+    /**
+     *
+     *
+     * @param rawTag ...
+     *
+     * @return ...
+     *
+     * @throws DocException ...
+     */
+    public static DocTag parse(String rawTag) throws DocException {
+        int kind = getTagNumber(rawTag);
+
+        if (kind == -1) {
+            throw new DocException("unsupported tag type: " + rawTag);
+        }
+
+        String content = rawTag.substring(tags[kind][0].length() + 1).trim();
+
+        if ((kind == 0) || (kind == 1)) {
+            StringTokenizer tok = new StringTokenizer(content);
             String name = "";
-			if (tok.hasMoreTokens ())
-				name = tok.nextToken ();
+
+            if (tok.hasMoreTokens()) {
+                name = tok.nextToken();
+            }
+
             String comment = "";
+
             try {
-				comment = content.substring (name.length ()+1).trim ();
-			} catch (StringIndexOutOfBoundsException e) { }
-			return new DocTag (kind, name, comment);
+                comment = content.substring(name.length() + 1).trim();
+            } catch (StringIndexOutOfBoundsException e) {
+            }
+
+            return new DocTag(kind, name, comment);
         } else {
-			return new DocTag (kind, "", content);
+            return new DocTag(kind, "", content);
         }
     }
 
-	private static int getTagNumber (String rawTag) {
-		rawTag = rawTag.trim ().toLowerCase ();
-		for (int i=0; i<tags.length; i++) {
-			if (rawTag.startsWith (tags[i][0])) {
+    private static int getTagNumber(String rawTag) {
+        rawTag = rawTag.trim().toLowerCase();
+
+        for (int i = 0; i < tags.length; i++) {
+            if (rawTag.startsWith(tags[i][0])) {
                 return i;
             }
         }
+
         return -1;
     }
 
-
-	private DocTag (int kind, String name, String text) {
-		this.kind = kind;
-		this.name = (name!=null) ? name : "";
-		this.text = (text!=null) ? text : "";
-	}
-
-	public String getName ()	{
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getName() {
         return name;
     }
 
-	public int getType ()	{
-		if (kind==0 || kind==1)
+    /**
+     *
+     *
+     * @return ...
+     */
+    public int getType() {
+        if ((kind == 0) || (kind == 1)) {
             return PARAMETER;
-		else if (kind==2 || kind==3)
+        } else if ((kind == 2) || (kind == 3)) {
             return RETURN;
-		else
+        } else {
             return kind;
         }
+    }
 
-
-	public String getTag () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getTag() {
         return tags[kind][0];
     }
 
-	public String getText ()	{
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getText() {
         return text;
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public String toString() {
-		return tags [kind][1] + ": " + name + " " + text;
+        return tags[kind][1] + ": " + name + " " + text;
     }
-
 }
-

src/helma/doc/Util.java

@@ -1,40 +1,50 @@
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.doc;
 
 import java.io.*;
 import java.util.*;
 
+/**
+ * 
+ */
 public final class Util {
-	
-	static Vector excluded = new Vector ();
-	
-	public static void addExlude (String str) {
-		excluded.add (str.toLowerCase ());
-	}
-
-	public static boolean isExcluded (String str) {
-		if (excluded.size ()==0) {
-			excluded.add ("cvs");
-			excluded.add (".docs");
-		}
-		return (excluded.contains (str.toLowerCase ()));
-	}
-
-	public static String chopDelimiters (String line) {
-		if (line==null)
+    /**
+     *
+     *
+     * @param line ...
+     *
+     * @return ...
+     */
+    public static String chopDelimiters(String line) {
+        if (line == null) {
             return null;
-		else if (line.startsWith("/**"))
-			return line.substring (3).trim ();
-		else if (line.startsWith("/*"))
-			return line.substring (2).trim ();
-		else if (line.endsWith ("*/"))
-			return line.substring (0, line.length ()-2);
-		else if (line.startsWith("*"))
-			return line.substring (1).trim ();
-		else if (line.startsWith("//"))
-			return line.substring (2).trim ();
-		else
+        } else if (line.startsWith("/**")) {
+            return line.substring(3).trim();
+        } else if (line.startsWith("/*")) {
+            return line.substring(2).trim();
+        } else if (line.endsWith("*/")) {
+            return line.substring(0, line.length() - 2);
+        } else if (line.startsWith("*")) {
+            return line.substring(1).trim();
+        } else if (line.startsWith("//")) {
+            return line.substring(2).trim();
+        } else {
             return line;
         }
-
-
+    }
 }

src/helma/extensions/ConfigurationException.java

@@ -1,9 +1,31 @@
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.extensions;
 
+/**
+ * 
+ */
 public class ConfigurationException extends RuntimeException {
-
-    public ConfigurationException (String msg) {
-	super (msg);
+    /**
+     * Creates a new ConfigurationException object.
+     *
+     * @param msg ...
+     */
+    public ConfigurationException(String msg) {
+        super(msg);
     }
-
 }

src/helma/extensions/HelmaExtension.java

@@ -1,42 +1,56 @@
-package helma.extensions;
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
-import java.util.HashMap;
+package helma.extensions;
 
 import helma.framework.core.Application;
 import helma.main.Server;
 import helma.scripting.ScriptingEngine;
+import java.util.HashMap;
 
 /**
  * Helma extensions have to subclass this. The extensions to be loaded are
  * defined in <code>server.properties</code> by setting <code>extensions =
  * packagename.classname, packagename.classname</code>.
  */
-
 public abstract class HelmaExtension {
-
     /**
      * called by the Server at startup time. should check wheter the needed classes
      * are present and throw a ConfigurationException if not.
      */
-	public abstract void init (Server server) throws ConfigurationException;
+    public abstract void init(Server server) throws ConfigurationException;
 
     /**
      * called when an Application is started. This should be <b>synchronized</b> when
      * any self-initialization is performed.
      */
-	public abstract void applicationStarted (Application app) throws ConfigurationException;
+    public abstract void applicationStarted(Application app)
+                                     throws ConfigurationException;
 
     /**
      * called when an Application is stopped.
      * This should be <b>synchronized</b> when any self-destruction is performed.
      */
-	public abstract void applicationStopped (Application app);
+    public abstract void applicationStopped(Application app);
 
     /**
      * called when an Application's properties are have been updated.
      * note that this will be called at startup once *before* applicationStarted().
      */
-	public abstract void applicationUpdated (Application app);
+    public abstract void applicationUpdated(Application app);
 
     /**
      * called by the ScriptingEngine when it is initizalized. Throws a ConfigurationException
@@ -45,9 +59,13 @@ public abstract class HelmaExtension {
      * with pairs of varname and ESObjects. This method should be <b>synchronized</b>, if it
      * performs any other self-initialization outside the scripting environment.
      */
-	public abstract HashMap initScripting (Application app, ScriptingEngine engine) throws ConfigurationException;
-
-	public abstract String getName ();
+    public abstract HashMap initScripting(Application app, ScriptingEngine engine)
+                                   throws ConfigurationException;
 
+    /**
+     *
+     *
+     * @return ...
+     */
+    public abstract String getName();
 }
-

src/helma/extensions/demo/DemoExtension.java

@@ -1,12 +1,21 @@
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.extensions.demo;
 
-import java.util.HashMap;
-
-import helma.extensions.HelmaExtension;
-import helma.extensions.ConfigurationException;
-import helma.framework.core.Application;
-import helma.main.Server;
-import helma.scripting.ScriptingEngine;
 
 // fesi-related stuff:
 import FESI.Data.ESObject;
@@ -14,8 +23,13 @@ import FESI.Data.ESWrapper;
 import FESI.Data.GlobalObject;
 import FESI.Exceptions.EcmaScriptException;
 import FESI.Interpreter.Evaluator;
+import helma.extensions.ConfigurationException;
+import helma.extensions.HelmaExtension;
+import helma.framework.core.Application;
+import helma.main.Server;
+import helma.scripting.ScriptingEngine;
 import helma.scripting.fesi.FesiEngine;
-
+import java.util.HashMap;
 
 /**
  * a demo extension implementation, to activate this add <code>extensions =
@@ -23,10 +37,15 @@ import helma.scripting.fesi.FesiEngine;
  * a new global object <code>demo</code> that wraps helma.main.Server
  * will be added to the scripting environment.
  */
-
 public class DemoExtension extends HelmaExtension {
-
-	public void init (Server server) throws ConfigurationException {
+    /**
+     *
+     *
+     * @param server ...
+     *
+     * @throws ConfigurationException ...
+     */
+    public void init(Server server) throws ConfigurationException {
         try {
             // just a demo with the server class itself (which is always there, obviously)
             Class check = Class.forName("helma.main.Server");
@@ -35,34 +54,73 @@ public class DemoExtension extends HelmaExtension {
         }
     }
 
-	public void applicationStarted (Application app) throws ConfigurationException {
-	app.logEvent ("DemoExtension init with app " + app.getName () );
+    /**
+     *
+     *
+     * @param app ...
+     *
+     * @throws ConfigurationException ...
+     */
+    public void applicationStarted(Application app) throws ConfigurationException {
+        app.logEvent("DemoExtension init with app " + app.getName());
     }
 
-	public void applicationStopped (Application app) {
-	app.logEvent ("DemoExtension stopped on app " + app.getName () );
+    /**
+     *
+     *
+     * @param app ...
+     */
+    public void applicationStopped(Application app) {
+        app.logEvent("DemoExtension stopped on app " + app.getName());
     }
 
-	public void applicationUpdated (Application app) {
-	app.logEvent ("DemoExtension updated on app " + app.getName () );
+    /**
+     *
+     *
+     * @param app ...
+     */
+    public void applicationUpdated(Application app) {
+        app.logEvent("DemoExtension updated on app " + app.getName());
     }
 
-	public HashMap initScripting (Application app, ScriptingEngine engine) throws ConfigurationException {
-	if (!(engine instanceof FesiEngine))
-	    throw new ConfigurationException ("scripting engine " + engine.toString () + " not supported in DemoExtension");
-	app.logEvent("initScripting DemoExtension with " + app.getName () + " and " + engine.toString() );
+    /**
+     *
+     *
+     * @param app ...
+     * @param engine ...
+     *
+     * @return ...
+     *
+     * @throws ConfigurationException ...
+     */
+    public HashMap initScripting(Application app, ScriptingEngine engine)
+                          throws ConfigurationException {
+        if (!(engine instanceof FesiEngine)) {
+            throw new ConfigurationException("scripting engine " + engine.toString() +
+                                             " not supported in DemoExtension");
+        }
+
+        app.logEvent("initScripting DemoExtension with " + app.getName() + " and " +
+                     engine.toString());
+
         // fesi-specific code:
-	Evaluator evaluator = ((FesiEngine)engine).getEvaluator ();
+        Evaluator evaluator = ((FesiEngine) engine).getEvaluator();
+
         // initialize prototypes and global vars here, but don't add them to fesi's global object
-	ESWrapper demo = new ESWrapper(Server.getServer (), evaluator);
-	HashMap globals = new HashMap ();
-	globals.put ("demo",demo);
+        ESWrapper demo = new ESWrapper(Server.getServer(), evaluator);
+        HashMap globals = new HashMap();
+
+        globals.put("demo", demo);
+
         return globals;
     }
 
-	public String getName () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getName() {
         return "DemoExtension";
     }
-
 }
-

src/helma/framework/ApplicationStoppedException.java

@@ -1,19 +1,31 @@
-// ApplicationStoppedException.java
-// Copyright (c) Hannes Wallnöfer 1998-2000
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework;
 
+
 /**
  * This is thrown when a request is made to a stopped
  * application
  */
- 
 public class ApplicationStoppedException extends RuntimeException {
-
-
-    public ApplicationStoppedException () {
-	super ("The application has been stopped");
+    /**
+     * Creates a new ApplicationStoppedException object.
+     */
+    public ApplicationStoppedException() {
+        super("The application has been stopped");
     }
-
-
 }

src/helma/framework/CookieTrans.java

@@ -1,4 +1,18 @@
-// CookieTrans.java
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework;
 
@@ -11,64 +25,106 @@ import javax.servlet.http.Cookie;
  *  of an HTTP cookie.
  */
 public final class CookieTrans implements Serializable {
-
-    String name, value, path, domain;
+    String name;
+    String value;
+    String path;
+    String domain;
     int days;
 
-    CookieTrans (String name, String value) {
+    CookieTrans(String name, String value) {
         this.name = name;
         this.value = value;
     }
 
-    void setValue (String value) {
+    void setValue(String value) {
         this.value = value;
     }
 
-    void setDays (int days) {
+    void setDays(int days) {
         this.days = days;
     }
 
-    void setPath (String path) {
+    void setPath(String path) {
         this.path = path;
     }
 
-    void setDomain (String domain) {
+    void setDomain(String domain) {
         this.domain = domain;
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public String getName() {
         return name;
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public String getValue() {
         return value;
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public int getDays() {
         return days;
     }
 
-    public String getPath () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getPath() {
         return path;
     }
 
-    public String getDomain () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getDomain() {
         return domain;
     }
 
-    public Cookie getCookie (String defaultPath, String defaultDomain) {
-	Cookie c = new Cookie (name, value);
-	if (days > 0)
+    /**
+     *
+     *
+     * @param defaultPath ...
+     * @param defaultDomain ...
+     *
+     * @return ...
+     */
+    public Cookie getCookie(String defaultPath, String defaultDomain) {
+        Cookie c = new Cookie(name, value);
+
+        if (days > 0) {
             // Cookie time to live, days -> seconds
-	    c.setMaxAge (days*60*60*24);
-	if (path != null)
-	    c.setPath (path);
-	else if (defaultPath != null)
-	    c.setPath (defaultPath);
-	if (domain != null)
-	    c.setDomain (domain);
-	else if (defaultDomain != null)
-	    c.setDomain (defaultDomain);
+            c.setMaxAge(days * 60 * 60 * 24);
+        }
+
+        if (path != null) {
+            c.setPath(path);
+        } else if (defaultPath != null) {
+            c.setPath(defaultPath);
+        }
+
+        if (domain != null) {
+            c.setDomain(domain);
+        } else if (defaultDomain != null) {
+            c.setDomain(defaultDomain);
+        }
+
         return c;
     }
 }

src/helma/framework/FrameworkException.java

@@ -1,17 +1,33 @@
-// FrameworkException.java
-// Copyright (c) Hannes Wallnöfer 1998-2000
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework;
 
+
 /**
  * The basic exception class used to tell when certain things go
  * wrong in evaluation of requests.
  */
- 
 public class FrameworkException extends RuntimeException {
-
-    public FrameworkException (String msg) {
-	super (msg);
+    /**
+     * Creates a new FrameworkException object.
+     *
+     * @param msg ...
+     */
+    public FrameworkException(String msg) {
+        super(msg);
     }
-
 }

src/helma/framework/IPathElement.java

@@ -1,5 +1,18 @@
-// IPathElement.java
-// Copyright (c) Hannes Wallnöfer 2001
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework;
 
@@ -14,34 +27,26 @@ package helma.framework;
  * parent element. <p>
  *
  */
- 
 public interface IPathElement {
-
     /**
      *  Return the name to be used to get this element from its parent
      */
-    public String getElementName ();
+    public String getElementName();
 
     /**
      * Retrieve a child element of this object by name.
      */
-    public IPathElement getChildElement (String name);
+    public IPathElement getChildElement(String name);
 
     /**
      * Return the parent element of this object.
      */
-    public IPathElement getParentElement ();
-
+    public IPathElement getParentElement();
 
     /**
      * Get the name of the prototype to be used for this object. This will
      * determine which scripts, actions and skins can be called on it
      * within the Helma scripting and rendering framework.
      */
-    public String getPrototype ();
-
+    public String getPrototype();
 }
-
-
-
-

src/helma/framework/IRemoteApp.java

@@ -1,5 +1,18 @@
-// IRemoteApp.java
-// Copyright (c) Hannes Wallnöfer 1998-2000
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework;
 
@@ -9,11 +22,22 @@ import java.util.Vector;
 /**
  * RMI interface for an application. Currently only execute is used and supported.
  */
-
 public interface IRemoteApp extends Remote {
+    /**
+     *
+     *
+     * @param param ...
+     *
+     * @return ...
+     *
+     * @throws RemoteException ...
+     */
+    public ResponseTrans execute(RequestTrans param) throws RemoteException;
 
-    public ResponseTrans execute (RequestTrans param) throws RemoteException;
-
-    public void ping () throws RemoteException;
- 
-  }
+    /**
+     *
+     *
+     * @throws RemoteException ...
+     */
+    public void ping() throws RemoteException;
+}

src/helma/framework/RedirectException.java

@@ -1,5 +1,18 @@
-// RedirectException.java
-// Copyright (c) Hannes Wallnöfer 1998-2000
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework;
 
@@ -8,26 +21,43 @@ package helma.framework;
  * RedirectException is thrown internally when a response is redirected to a
  * new URL.
  */
-
 public class RedirectException extends RuntimeException {
-
     String url;
 
-    public RedirectException (String url) {
-	super ("Redirection Request to "+url);
+    /**
+     * Creates a new RedirectException object.
+     *
+     * @param url ...
+     */
+    public RedirectException(String url) {
+        super("Redirection Request to " + url);
         this.url = url;
     }
 
-    public String getMessage () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getMessage() {
         return url;
     }
 
+    /**
+     *
+     *
+     * @param s ...
+     */
     public void printStackTrace(java.io.PrintStream s) {
         // do nothing
     }
 
+    /**
+     *
+     *
+     * @param w ...
+     */
     public void printStackTrace(java.io.PrintWriter w) {
         // do nothing
     }
-
 }

src/helma/framework/RequestBean.java

@@ -1,59 +1,127 @@
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.framework;
 
+import helma.framework.core.Application;
 import java.io.Serializable;
+import java.util.Date;
 import java.util.Map;
 
-import helma.framework.core.Application;
-import java.util.Date;
-
+/**
+ * 
+ */
 public class RequestBean implements Serializable {
-
     RequestTrans req;
 
+    /**
+     * Creates a new RequestBean object.
+     *
+     * @param req ...
+     */
     public RequestBean(RequestTrans req) {
         this.req = req;
     }
 
-	public Object get (String name) {
-	return req.get (name);
+    /**
+     *
+     *
+     * @param name ...
+     *
+     * @return ...
+     */
+    public Object get(String name) {
+        return req.get(name);
     }
 
-	public boolean isGet () {
-	return req.isGet ();
+    /**
+     *
+     *
+     * @return ...
+     */
+    public boolean isGet() {
+        return req.isGet();
     }
 
-	public boolean isPost () {
-	return req.isPost ();
+    /**
+     *
+     *
+     * @return ...
+     */
+    public boolean isPost() {
+        return req.isPost();
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public String toString() {
         return "[Request]";
     }
 
     // property related methods:
-
-	public String getaction () {
+    public String getaction() {
         return req.action;
     }
 
-	public Map getdata () {
-	return req.getRequestData ();
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Map getdata() {
+        return req.getRequestData();
     }
 
-	public long getruntime () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public long getruntime() {
         return (System.currentTimeMillis() - req.startTime);
     }
 
-	public String getpassword () {
-	return req.getPassword ();
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getpassword() {
+        return req.getPassword();
     }
 
-	public String getpath () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getpath() {
         return req.path;
     }
 
-	public String getusername () {
-	return req.getUsername ();
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getusername() {
+        return req.getUsername();
     }
 
     /* public Date getLastModified () {
@@ -63,12 +131,8 @@ public class RequestBean implements Serializable {
        else
            return new Date (since);
        }
-
        public void setLastModified () {
        throw new RuntimeException ("The lastModified property of the Request object is read-only. "+
                "Set lastModified on the Response object if you want to mark the last modification date of a resource.");
        } */
 }
-
-
-

src/helma/framework/RequestTrans.java

@@ -1,31 +1,48 @@
-// RequestTrans.java
-// Copyright (c) Hannes Wallnöfer 1998-2000
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework;
 
-import java.io.*;
-import java.util.*;
 import helma.objectmodel.*;
 import helma.util.Base64;
+import java.io.*;
+import java.util.*;
 
 /**
  * A Transmitter for a request from the servlet client. Objects of this
  * class are directly exposed to JavaScript as global property req.
  */
- 
 public class RequestTrans implements Externalizable {
+    static final long serialVersionUID = 5398880083482000580L;
 
     // the uri path of the request
     public String path;
+
     // the request's session id
     public String session;
+
     // the map of form and cookie data
     private Map values;
+
     // the request method - 0 for GET, 1 for POST
     private byte httpMethod = 0;
 
     // timestamp of client-cached version, if present in request
     private long ifModifiedSince = -1;
+
     // set of ETags the client sent with If-None-Match header
     private Set etags;
 
@@ -34,42 +51,38 @@ public class RequestTrans implements Externalizable {
 
     // the name of the action being invoked
     public transient String action;
-
     private transient String httpUsername;
     private transient String httpPassword;
 
-    static final long serialVersionUID = 5398880083482000580L;
-
     /**
      *  Create a new Request transmitter with an empty data map.
      */
-    public RequestTrans () {
+    public RequestTrans() {
         httpMethod = 0;
-	values = new HashMap ();
+        values = new HashMap();
     }
 
     /**
      *  Create a new request transmitter with the given data map.
      */
-    public RequestTrans (byte method) {
+    public RequestTrans(byte method) {
         httpMethod = method;
-	values = new HashMap ();
+        values = new HashMap();
     }
 
     /**
      *  Set a parameter value in this request transmitter.
      */
-    public void set (String name, Object value) {
-	values.put (name, value);
+    public void set(String name, Object value) {
+        values.put(name, value);
     }
 
-
     /**
      *  Get a value from the requests map by key.
      */
-    public Object get (String name) {
+    public Object get(String name) {
         try {
-	    return values.get (name);
+            return values.get(name);
         } catch (Exception x) {
             return null;
         }
@@ -78,7 +91,7 @@ public class RequestTrans implements Externalizable {
     /**
      *  Get the data map for this request transmitter.
      */
-    public Map getRequestData () {
+    public Map getRequestData() {
         return values;
     }
 
@@ -86,21 +99,20 @@ public class RequestTrans implements Externalizable {
      *  The hash code is computed from the session id if available. This is used to
      *  detect multiple identic requests.
      */
-    public int hashCode () {
-	return session == null ? super.hashCode () : session.hashCode ();
+    public int hashCode() {
+        return (session == null) ? super.hashCode() : session.hashCode();
     }
 
-
     /**
      * A request is considered equal to another one if it has the same user, path,
      * and request data. This is used to evaluate multiple simultanous requests only once
      */
-    public boolean equals (Object what) {
+    public boolean equals(Object what) {
         try {
             RequestTrans other = (RequestTrans) what;
-	    return (session.equals (other.session) &&
-		path.equalsIgnoreCase (other.path) &&
-		values.equals (other.getRequestData ()));
+
+            return (session.equals(other.session) && path.equalsIgnoreCase(other.path) &&
+                   values.equals(other.getRequestData()));
         } catch (Exception x) {
             return false;
         }
@@ -109,110 +121,167 @@ public class RequestTrans implements Externalizable {
     /**
      *  Return true if this object represents a HTTP GET Request.
      */
-    public boolean isGet () {
+    public boolean isGet() {
         return httpMethod == 0;
     }
 
     /**
      *  Return true if this object represents a HTTP GET Request.
      */
-    public boolean isPost () {
+    public boolean isPost() {
         return httpMethod == 1;
     }
 
     /**
      * Custom externalization code for quicker serialization.
      */
-    public void readExternal (ObjectInput s) throws ClassNotFoundException, IOException {
-	path = s.readUTF ();
-	session = s.readUTF ();
-	values = (Map) s.readObject ();
-	httpMethod = s.readByte ();
-	ifModifiedSince = s.readLong ();
-	etags = (Set) s.readObject ();
+    public void readExternal(ObjectInput s) throws ClassNotFoundException, IOException {
+        path = s.readUTF();
+        session = s.readUTF();
+        values = (Map) s.readObject();
+        httpMethod = s.readByte();
+        ifModifiedSince = s.readLong();
+        etags = (Set) s.readObject();
     }
 
     /**
      * Custom externalization code for quicker serialization.
      */
-    public void writeExternal (ObjectOutput s) throws IOException {
-	s.writeUTF (path);
-	s.writeUTF (session);
-	s.writeObject (values);
-	s.writeByte (httpMethod);
-	s.writeLong (ifModifiedSince);
-	s.writeObject (etags);
+    public void writeExternal(ObjectOutput s) throws IOException {
+        s.writeUTF(path);
+        s.writeUTF(session);
+        s.writeObject(values);
+        s.writeByte(httpMethod);
+        s.writeLong(ifModifiedSince);
+        s.writeObject(etags);
     }
 
-    public void setIfModifiedSince (long since) {
+    /**
+     *
+     *
+     * @param since ...
+     */
+    public void setIfModifiedSince(long since) {
         ifModifiedSince = since;
     }
 
-    public long getIfModifiedSince () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public long getIfModifiedSince() {
         return ifModifiedSince;
     }
 
-    public void setETags (String etagHeader) {
+    /**
+     *
+     *
+     * @param etagHeader ...
+     */
+    public void setETags(String etagHeader) {
         etags = new HashSet();
-	if (etagHeader.indexOf (",") > -1) {
-	StringTokenizer st = new StringTokenizer (etagHeader, ", \r\n");
+
+        if (etagHeader.indexOf(",") > -1) {
+            StringTokenizer st = new StringTokenizer(etagHeader, ", \r\n");
+
             while (st.hasMoreTokens())
-	    etags.add (st.nextToken ());
+                etags.add(st.nextToken());
         } else {
-	    etags.add (etagHeader);
+            etags.add(etagHeader);
         }
     }
 
-    public Set getETags () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Set getETags() {
         return etags;
     }
 
-    public boolean hasETag (String etag) {
-	if (etags == null || etag == null)
+    /**
+     *
+     *
+     * @param etag ...
+     *
+     * @return ...
+     */
+    public boolean hasETag(String etag) {
+        if ((etags == null) || (etag == null)) {
             return false;
-	return etags.contains (etag);
         }
 
+        return etags.contains(etag);
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
     public String getUsername() {
-	if ( httpUsername!=null )
-	    return httpUsername;
-	String auth = (String)get("authorization");
-	if ( auth==null || "".equals(auth) ) {
-	    return null;
-	}
-	decodeHttpAuth(auth);
+        if (httpUsername != null) {
             return httpUsername;
         }
 
-    public String getPassword()	{
-	if ( httpPassword!=null )
-	    return httpPassword;
-	String auth = (String)get("authorization");
-	if ( auth==null || "".equals(auth) ) {
+        String auth = (String) get("authorization");
+
+        if ((auth == null) || "".equals(auth)) {
             return null;
         }
+
         decodeHttpAuth(auth);
+
+        return httpUsername;
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getPassword() {
+        if (httpPassword != null) {
+            return httpPassword;
+        }
+
+        String auth = (String) get("authorization");
+
+        if ((auth == null) || "".equals(auth)) {
+            return null;
+        }
+
+        decodeHttpAuth(auth);
+
         return httpPassword;
     }
 
     private void decodeHttpAuth(String auth) {
-	if ( auth==null )
+        if (auth == null) {
             return;
+        }
+
         StringTokenizer tok;
-	if( auth.startsWith("Basic ") )
-	    tok = new StringTokenizer ( new String( Base64.decode((auth.substring(6)).toCharArray()) ), ":" );
-	else
-	    tok = new StringTokenizer ( new String( Base64.decode(auth.toCharArray()) ), ":" );
+
+        if (auth.startsWith("Basic ")) {
+            tok = new StringTokenizer(new String(Base64.decode((auth.substring(6)).toCharArray())),
+                                      ":");
+        } else {
+            tok = new StringTokenizer(new String(Base64.decode(auth.toCharArray())), ":");
+        }
+
         try {
             httpUsername = tok.nextToken();
-	} catch ( NoSuchElementException e ) {
+        } catch (NoSuchElementException e) {
             httpUsername = null;
         }
+
         try {
             httpPassword = tok.nextToken();
-	} catch ( NoSuchElementException e ) {
+        } catch (NoSuchElementException e) {
             httpPassword = null;
         }
     }
-
 }

src/helma/framework/ResponseBean.java

@@ -1,175 +1,386 @@
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.framework;
 
+import helma.framework.core.Application;
 import java.io.Serializable;
+import java.util.Date;
 import java.util.Map;
 
-import helma.framework.core.Application;
-import java.util.Date;
-
+/**
+ * 
+ */
 public class ResponseBean implements Serializable {
-
     ResponseTrans res;
 
+    /**
+     * Creates a new ResponseBean object.
+     *
+     * @param res ...
+     */
     public ResponseBean(ResponseTrans res) {
         this.res = res;
     }
 
-    public void encode (Object what) {
-	res.encode (what);
+    /**
+     *
+     *
+     * @param what ...
+     */
+    public void encode(Object what) {
+        res.encode(what);
     }
 
-    public void encodeXml (Object what) {
-	res.encodeXml (what);
+    /**
+     *
+     *
+     * @param what ...
+     */
+    public void encodeXml(Object what) {
+        res.encodeXml(what);
     }
 
-    public void format (Object what) {
-	res.format (what);
+    /**
+     *
+     *
+     * @param what ...
+     */
+    public void format(Object what) {
+        res.format(what);
     }
 
-    public void redirect (String url) throws RedirectException {
-	res.redirect (url);
+    /**
+     *
+     *
+     * @param url ...
+     *
+     * @throws RedirectException ...
+     */
+    public void redirect(String url) throws RedirectException {
+        res.redirect(url);
     }
 
-    public void reset () {
-	res.reset ();
+    /**
+     *
+     */
+    public void reset() {
+        res.reset();
     }
 
-    public void setCookie (String key, String value) {
-	res.setCookie (key, value, -1, null, null);
+    /**
+     *
+     *
+     * @param key ...
+     * @param value ...
+     */
+    public void setCookie(String key, String value) {
+        res.setCookie(key, value, -1, null, null);
     }
 
-    public void setCookie (String key, String value, int days) {
-	res.setCookie (key, value, days, null, null);
+    /**
+     *
+     *
+     * @param key ...
+     * @param value ...
+     * @param days ...
+     */
+    public void setCookie(String key, String value, int days) {
+        res.setCookie(key, value, days, null, null);
     }
 
-    public void setCookie (String key, String value, int days, String path) {
-	res.setCookie (key, value, days, path, null);
+    /**
+     *
+     *
+     * @param key ...
+     * @param value ...
+     * @param days ...
+     * @param path ...
+     */
+    public void setCookie(String key, String value, int days, String path) {
+        res.setCookie(key, value, days, path, null);
     }
 
-    public void setCookie (String key, String value, int days, String path, String domain) {
-	res.setCookie (key, value, days, path, domain);
+    /**
+     *
+     *
+     * @param key ...
+     * @param value ...
+     * @param days ...
+     * @param path ...
+     * @param domain ...
+     */
+    public void setCookie(String key, String value, int days, String path, String domain) {
+        res.setCookie(key, value, days, path, domain);
     }
 
-    public void write (Object what) {
-	res.write (what);
+    /**
+     *
+     *
+     * @param what ...
+     */
+    public void write(Object what) {
+        res.write(what);
     }
 
-    public void writeln (Object what) {
-	res.writeln (what);
+    /**
+     *
+     *
+     * @param what ...
+     */
+    public void writeln(Object what) {
+        res.writeln(what);
     }
 
-    public void writeBinary (byte[] what) {
-	res.writeBinary (what);
+    /**
+     *
+     *
+     * @param what ...
+     */
+    public void writeBinary(byte[] what) {
+        res.writeBinary(what);
     }
 
-    public void debug (Object message) {
-	res.debug (message);
+    /**
+     *
+     *
+     * @param message ...
+     */
+    public void debug(Object message) {
+        res.debug(message);
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public String toString() {
         return "[Response]";
     }
 
-
     // property-related methods:
-
-    public boolean getcache () {
+    public boolean getcache() {
         return res.cache;
     }
 
-    public void setcache (boolean cache) {
+    /**
+     *
+     *
+     * @param cache ...
+     */
+    public void setcache(boolean cache) {
         res.cache = cache;
     }
 
-    public String getcharset () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getcharset() {
         return res.charset;
     }
 
-    public void setcharset (String charset) {
+    /**
+     *
+     *
+     * @param charset ...
+     */
+    public void setcharset(String charset) {
         res.charset = charset;
     }
 
-    public String getcontentType () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getcontentType() {
         return res.contentType;
     }
 
-    public void setcontentType (String contentType) {
+    /**
+     *
+     *
+     * @param contentType ...
+     */
+    public void setcontentType(String contentType) {
         res.contentType = contentType;
     }
 
-    public Map getdata () {
-	return res.getResponseData ();
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Map getdata() {
+        return res.getResponseData();
     }
 
-    public Map gethandlers () {
-	return res.getMacroHandlers ();
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Map gethandlers() {
+        return res.getMacroHandlers();
     }
 
-    public String geterror () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String geterror() {
         return res.error;
     }
 
-    public String getmessage () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getmessage() {
         return res.message;
     }
 
-    public void setmessage (String message) {
+    /**
+     *
+     *
+     * @param message ...
+     */
+    public void setmessage(String message) {
         res.message = message;
     }
 
-    public String getrealm () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getrealm() {
         return res.realm;
     }
 
-    public void setrealm (String realm) {
+    /**
+     *
+     *
+     * @param realm ...
+     */
+    public void setrealm(String realm) {
         res.realm = realm;
     }
 
-    public void setskinpath (Object[] arr) {
-	res.setSkinpath (arr);
+    /**
+     *
+     *
+     * @param arr ...
+     */
+    public void setskinpath(Object[] arr) {
+        res.setSkinpath(arr);
     }
 
-    public Object[] getskinpath () {
-	return res.getSkinpath ();
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Object[] getskinpath() {
+        return res.getSkinpath();
     }
 
-    public int getstatus () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public int getstatus() {
         return res.status;
     }
 
-    public void setstatus (int status) {
+    /**
+     *
+     *
+     * @param status ...
+     */
+    public void setstatus(int status) {
         res.status = status;
     }
 
-    public Date getLastModified () {
-	long modified = res.getLastModified ();
-	if (modified > -1)
-	    return new Date (modified);
-	else
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Date getLastModified() {
+        long modified = res.getLastModified();
+
+        if (modified > -1) {
+            return new Date(modified);
+        } else {
             return null;
         }
-
-    public void setLastModified (Date date) {
-	if (date == null)
-	    res.setLastModified (-1);
-	else
-	    res.setLastModified (date.getTime());
     }
 
-    public String getETag () {
-	return res.getETag ();
+    /**
+     *
+     *
+     * @param date ...
+     */
+    public void setLastModified(Date date) {
+        if (date == null) {
+            res.setLastModified(-1);
+        } else {
+            res.setLastModified(date.getTime());
+        }
     }
 
-    public void setETag (String etag) {
-	res.setETag (etag);
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getETag() {
+        return res.getETag();
     }
 
-    public void dependsOn (Object what) {
-	res.dependsOn (what);
+    /**
+     *
+     *
+     * @param etag ...
+     */
+    public void setETag(String etag) {
+        res.setETag(etag);
     }
 
-    public void digest () {
-	res.digestDependencies ();
+    /**
+     *
+     *
+     * @param what ...
+     */
+    public void dependsOn(Object what) {
+        res.dependsOn(what);
+    }
+
+    /**
+     *
+     */
+    public void digest() {
+        res.digestDependencies();
     }
 
     /////////////////////////////////////
@@ -177,14 +388,16 @@ public class ResponseBean implements Serializable {
     // Helma templates (*.hsp files) and shouldn't 
     // be used otherwise.
     ////////////////////////////////////
-
-    public void pushStringBuffer  () {
-	res.pushStringBuffer ();
+    public void pushStringBuffer() {
+        res.pushStringBuffer();
     }
 
-    public String popStringBuffer () {
-	return res.popStringBuffer ();
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String popStringBuffer() {
+        return res.popStringBuffer();
     }
-
 }
-

src/helma/framework/ResponseTrans.java

@@ -1,21 +1,35 @@
-// ResponseTrans.java
-// Copyright (c) Hannes Wallnöfer 1998-2000
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework;
 
-import java.io.*;
-import java.util.*;
 import helma.framework.core.Skin;
 import helma.objectmodel.*;
 import helma.util.*;
+import java.io.*;
 import java.security.*;
+import java.util.*;
 
 /**
  * A Transmitter for a response to the servlet client. Objects of this
  * class are directly exposed to JavaScript as global property res.
  */
- 
 public final class ResponseTrans implements Externalizable {
+    static final long serialVersionUID = -8627370766119740844L;
+    static final int INITIAL_BUFFER_SIZE = 2048;
 
     /**
      * Set the MIME content type of the response.
@@ -53,8 +67,10 @@ public final class ResponseTrans implements Externalizable {
 
     // the last-modified date, if it should be set in the response
     private long lastModified = -1;
+
     // flag to signal that resource has not been modified
     private boolean notModified = false;
+
     // Entity Tag for this response, used for conditional GETs
     private String etag = null;
 
@@ -63,19 +79,19 @@ public final class ResponseTrans implements Externalizable {
 
     // the buffer used to build the response
     private transient StringBuffer buffer = null;
+
     // these are used to implement the _as_string variants for Hop templates.
     private transient Stack buffers;
 
     // the path used to tell where to look for skins
     private transient Object[] skinpath = null;
+
     // hashmap for skin caching
     private transient HashMap skincache;
 
     // buffer for debug messages - will be automatically appended to response
     private transient StringBuffer debugBuffer;
 
-    static final long serialVersionUID = -8627370766119740844L;
-
     /**
      * string fields that hold a user message
      */
@@ -86,8 +102,6 @@ public final class ResponseTrans implements Externalizable {
      */
     public transient String error;
 
-    static final int INITIAL_BUFFER_SIZE = 2048;
-
     // the map of form and cookie data
     private transient Map values;
 
@@ -103,26 +117,32 @@ public final class ResponseTrans implements Externalizable {
     // the appliciation checksum to make ETag headers sensitive to app changes
     long applicationChecksum;
 
-
-    public ResponseTrans () {
-	super ();
+    /**
+     * Creates a new ResponseTrans object.
+     */
+    public ResponseTrans() {
+        super();
         message = error = null;
-	values = new HashMap ();
-	handlers = new HashMap ();
+        values = new HashMap();
+        handlers = new HashMap();
     }
 
-    public ResponseTrans (RequestTrans req) {
+    /**
+     * Creates a new ResponseTrans object.
+     *
+     * @param req ...
+     */
+    public ResponseTrans(RequestTrans req) {
         this();
         reqtrans = req;
     }
 
-
     /**
      *  Get a value from the responses map by key.
      */
-    public Object get (String name) {
+    public Object get(String name) {
         try {
-	    return values.get (name);
+            return values.get(name);
         } catch (Exception x) {
             return null;
         }
@@ -131,101 +151,119 @@ public final class ResponseTrans implements Externalizable {
     /**
      *  Get the data map for this response transmitter.
      */
-    public Map getResponseData () {
+    public Map getResponseData() {
         return values;
     }
 
     /**
      *  Get the macro handlers map for this response transmitter.
      */
-    public Map getMacroHandlers () {
+    public Map getMacroHandlers() {
         return handlers;
     }
 
-
     /**
      * Reset the response object to its initial empty state.
      */
-    public void reset () {
-	if (buffer != null)
-	    buffer.setLength (0);
+    public void reset() {
+        if (buffer != null) {
+            buffer.setLength(0);
+        }
+
         buffers = null;
         response = null;
         redir = null;
         skin = null;
         message = error = null;
-	values.clear ();
+        values.clear();
         lastModified = -1;
         notModified = false;
         etag = null;
-	if (digest != null)
+
+        if (digest != null) {
             digest.reset();
         }
-
+    }
 
     /**
      * This is called before a skin is rendered as string (renderSkinAsString) to redirect the output
      * to a new string buffer.
      */
-    public void pushStringBuffer () {
-	if (buffers == null)
+    public void pushStringBuffer() {
+        if (buffers == null) {
             buffers = new Stack();
-	if (buffer != null)
-	    buffers.push (buffer);
-	buffer = new StringBuffer (64);
+        }
+
+        if (buffer != null) {
+            buffers.push(buffer);
+        }
+
+        buffer = new StringBuffer(64);
     }
 
     /**
      * Returns the content of the current string buffer and switches back to the previos one.
      */
-    public String popStringBuffer () {
+    public String popStringBuffer() {
         StringBuffer b = buffer;
-	buffer = buffers.empty() ? null : (StringBuffer) buffers.pop ();
-	return b.toString ();
+
+        buffer = buffers.empty() ? null : (StringBuffer) buffers.pop();
+
+        return b.toString();
     }
 
     /**
      *  Get the response buffer, creating it if it doesn't exist
      */
-    public StringBuffer getBuffer () {
-	if (buffer == null)
-	    buffer = new StringBuffer (INITIAL_BUFFER_SIZE);
-	return buffer;
+    public StringBuffer getBuffer() {
+        if (buffer == null) {
+            buffer = new StringBuffer(INITIAL_BUFFER_SIZE);
         }
 
+        return buffer;
+    }
 
     /**
      * Append a string to the response unchanged. This is often called
      * at the end of a request to write out the whole page, so if buffer
      * is uninitialized we just set it to the string argument.
      */
-    public void write (Object what) {
+    public void write(Object what) {
         if (what != null) {
-	    String str = what.toString ();
-	    if (buffer == null)
-	        buffer = new StringBuffer (Math.max (str.length()+100, INITIAL_BUFFER_SIZE));
-	    buffer.append (what.toString ());
+            String str = what.toString();
+
+            if (buffer == null) {
+                buffer = new StringBuffer(Math.max(str.length() + 100, INITIAL_BUFFER_SIZE));
+            }
+
+            buffer.append(what.toString());
         }
     }
 
     /**
      * Utility function that appends a <br> to whatever is written.
      */
-    public void writeln (Object what) {
-	if (buffer == null)
-	    buffer = new StringBuffer (INITIAL_BUFFER_SIZE);
-	if (what != null)
-	    buffer.append (what.toString ());
-	buffer.append ("<br />\r\n");
+    public void writeln(Object what) {
+        if (buffer == null) {
+            buffer = new StringBuffer(INITIAL_BUFFER_SIZE);
+        }
+
+        if (what != null) {
+            buffer.append(what.toString());
+        }
+
+        buffer.append("<br />\r\n");
     }
 
     /**
      *  Append a part from a char array to the response buffer.
      */
-    public void writeCharArray (char[] c, int start, int length) {
-	if (buffer == null)
-	    buffer = new StringBuffer (Math.max (length, INITIAL_BUFFER_SIZE));
-	buffer.append (c, start, length);
+    public void writeCharArray(char[] c, int start, int length) {
+        if (buffer == null) {
+            buffer = new StringBuffer(Math.max(length, INITIAL_BUFFER_SIZE));
+        }
+
+        buffer.append(c, start, length);
     }
 
     /**
@@ -233,82 +271,113 @@ public final class ResponseTrans implements Externalizable {
      *  that buffer exists and its length is larger than offset. str may be null, in which
      *  case nothing happens.
      */
-    public void debug (Object message) {
-	if (debugBuffer == null)
-	    debugBuffer = new StringBuffer ();
-	String str = message == null ? "null" : message.toString ();
-	debugBuffer.append ("<p><span style=\"background: yellow; color: black\">");
-	debugBuffer.append (str);
-	debugBuffer.append ("</span></p>");
+    public void debug(Object message) {
+        if (debugBuffer == null) {
+            debugBuffer = new StringBuffer();
+        }
+
+        String str = (message == null) ? "null" : message.toString();
+
+        debugBuffer.append("<p><span style=\"background: yellow; color: black\">");
+        debugBuffer.append(str);
+        debugBuffer.append("</span></p>");
     }
 
     /**
      * Replace special characters with entities, including <, > and ", thus allowing
      * no HTML tags.
      */
-    public void encode (Object what) {
+    public void encode(Object what) {
         if (what != null) {
-	    String str = what.toString ();
-	    if (buffer == null)
-	        buffer = new StringBuffer (Math.max (str.length()+100, INITIAL_BUFFER_SIZE));
-	    HtmlEncoder.encodeAll (str, buffer);
+            String str = what.toString();
+
+            if (buffer == null) {
+                buffer = new StringBuffer(Math.max(str.length() + 100, INITIAL_BUFFER_SIZE));
+            }
+
+            HtmlEncoder.encodeAll(str, buffer);
         }
     }
 
     /**
      * Replace special characters with entities but pass through HTML tags
      */
-    public void format (Object what) {
+    public void format(Object what) {
         if (what != null) {
-	    String str = what.toString ();
-	    if (buffer == null)
-	        buffer = new StringBuffer (Math.max (str.length()+100, INITIAL_BUFFER_SIZE));
-	    HtmlEncoder.encode (str, buffer);
-	}
+            String str = what.toString();
+
+            if (buffer == null) {
+                buffer = new StringBuffer(Math.max(str.length() + 100, INITIAL_BUFFER_SIZE));
             }
 
+            HtmlEncoder.encode(str, buffer);
+        }
+    }
 
     /**
      * Replace special characters with entities, including <, > and ", thus allowing
      * no HTML tags.
      */
-    public void encodeXml (Object what) {
+    public void encodeXml(Object what) {
         if (what != null) {
-	    String str = what.toString ();
-	    if (buffer == null)
-	        buffer = new StringBuffer (Math.max (str.length()+100, INITIAL_BUFFER_SIZE));
-	    HtmlEncoder.encodeXml (str, buffer);
-	}
+            String str = what.toString();
+
+            if (buffer == null) {
+                buffer = new StringBuffer(Math.max(str.length() + 100, INITIAL_BUFFER_SIZE));
             }
 
+            HtmlEncoder.encodeXml(str, buffer);
+        }
+    }
 
     /**
      * Encode HTML entities, but leave newlines alone. This is for the content of textarea forms.
      */
-    public void encodeForm (Object what) {
+    public void encodeForm(Object what) {
         if (what != null) {
-	    String str = what.toString ();
-	    if (buffer == null)
-	        buffer = new StringBuffer (Math.max (str.length()+100, INITIAL_BUFFER_SIZE));
-	    HtmlEncoder.encodeAll (str, buffer, false);
+            String str = what.toString();
+
+            if (buffer == null) {
+                buffer = new StringBuffer(Math.max(str.length() + 100, INITIAL_BUFFER_SIZE));
+            }
+
+            HtmlEncoder.encodeAll(str, buffer, false);
         }
     }
 
-
-    public void append (String str) {
+    /**
+     *
+     *
+     * @param str ...
+     */
+    public void append(String str) {
         if (str != null) {
-	    if (buffer == null)
-	        buffer = new StringBuffer (Math.max (str.length(), INITIAL_BUFFER_SIZE));
-	    buffer.append (str);
+            if (buffer == null) {
+                buffer = new StringBuffer(Math.max(str.length(), INITIAL_BUFFER_SIZE));
+            }
+
+            buffer.append(str);
         }
     }
 
-    public void redirect (String url) throws RedirectException {
+    /**
+     *
+     *
+     * @param url ...
+     *
+     * @throws RedirectException ...
+     */
+    public void redirect(String url) throws RedirectException {
         redir = url;
-	throw new RedirectException (url);
+        throw new RedirectException(url);
     }
 
-    public String getRedirect () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getRedirect() {
         return redir;
     }
 
@@ -317,148 +386,227 @@ public final class ResponseTrans implements Externalizable {
      *  overwrite the previous output. We take a generic object as parameter to be able to
      * generate a better error message, but it must be byte[].
      */
-    public void writeBinary (byte[] what) {
+    public void writeBinary(byte[] what) {
         response = what;
     }
 
-
     /**
      * This has to be called after writing to this response has finished and before it is shipped back to the
      * web server. Transforms the string buffer into a char array to minimize size.
      */
-    public synchronized void close (String cset) throws UnsupportedEncodingException {
+    public synchronized void close(String cset) throws UnsupportedEncodingException {
         // only use default charset if not explicitly set for this response.
-	if (charset == null)
+        if (charset == null) {
             charset = cset;
+        }
+
         // if charset is not set, use western encoding
-	if (charset == null)
+        if (charset == null) {
             charset = "ISO-8859-1";
+        }
+
         boolean encodingError = false;
+
         // only close if the response hasn't been closed yet
         if (response == null) {
             // if debug buffer exists, append it to main buffer
             if (debugBuffer != null) {
-	        if (buffer == null)
+                if (buffer == null) {
                     buffer = debugBuffer;
-	        else
-	            buffer.append (debugBuffer);
+                } else {
+                    buffer.append(debugBuffer);
                 }
+            }
+
             // get the buffer's bytes in the specified encoding
             if (buffer != null) {
                 try {
-	            response = buffer.toString ().getBytes (charset);
+                    response = buffer.toString().getBytes(charset);
                 } catch (UnsupportedEncodingException uee) {
                     encodingError = true;
-	            response = buffer.toString ().getBytes ();
+                    response = buffer.toString().getBytes();
                 }
+
                 // make sure this is done only once, even with more requsts attached
                 buffer = null;
             } else {
                 response = new byte[0];
             }
         }
+
         // if etag is not set, calc MD5 digest and check it
-	if (etag == null && lastModified == -1 && redir == null) try {
+        if ((etag == null) && (lastModified == -1) && (redir == null)) {
+            try {
                 digest = MessageDigest.getInstance("MD5");
+
                 // if (contentType != null)
                 //     digest.update (contentType.getBytes());
                 byte[] b = digest.digest(response);
-	    etag = "\""+new String (Base64.encode(b))+"\"";
-	    if (reqtrans != null && reqtrans.hasETag (etag)) {
+
+                etag = "\"" + new String(Base64.encode(b)) + "\"";
+
+                if ((reqtrans != null) && reqtrans.hasETag(etag)) {
                     response = new byte[0];
                     notModified = true;
                 }
             } catch (Exception ignore) {
                 // Etag creation failed for some reason. Ignore.
             }
-	notifyAll ();
+        }
+
+        notifyAll();
+
         // if there was a problem with the encoding, let the app know
-	if (encodingError)
-	    throw new UnsupportedEncodingException (charset);
+        if (encodingError) {
+            throw new UnsupportedEncodingException(charset);
+        }
     }
 
     /**
      * If we just attached to evaluation we call this instead of close because only the primary thread
      * is responsible for closing the result
      */
-    public synchronized void waitForClose () {
+    public synchronized void waitForClose() {
         try {
-	    if (response == null)
-	        wait (10000l);
-	} catch (InterruptedException ix) {}
+            if (response == null) {
+                wait(10000L);
+            }
+        } catch (InterruptedException ix) {
+        }
     }
 
-    public byte[] getContent () {
-	return response == null ? new byte[0] : response;
+    /**
+     *
+     *
+     * @return ...
+     */
+    public byte[] getContent() {
+        return (response == null) ? new byte[0] : response;
     }
 
-    public int getContentLength () {
-	if (response != null)
+    /**
+     *
+     *
+     * @return ...
+     */
+    public int getContentLength() {
+        if (response != null) {
             return response.length;
+        }
+
         return 0;
     }
 
-    public String getContentType () {
-	if (charset != null)
-	    return contentType+"; charset="+charset;
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getContentType() {
+        if (charset != null) {
+            return contentType + "; charset=" + charset;
+        }
+
         return contentType;
     }
 
-    public void setLastModified (long modified) {
-	if (modified > -1 && reqtrans != null &&
-	    reqtrans.getIfModifiedSince() >= modified)
-	{
+    /**
+     *
+     *
+     * @param modified ...
+     */
+    public void setLastModified(long modified) {
+        if ((modified > -1) && (reqtrans != null) &&
+                (reqtrans.getIfModifiedSince() >= modified)) {
             notModified = true;
-	    throw new RedirectException (null);
+            throw new RedirectException(null);
         }
+
         lastModified = modified;
     }
 
-    public long getLastModified () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public long getLastModified() {
         return lastModified;
     }
 
-    public void setETag (String value) {
-	etag = value == null ? null : "\""+value+"\"";
-	if (etag != null && reqtrans != null && reqtrans.hasETag (etag)) {
+    /**
+     *
+     *
+     * @param value ...
+     */
+    public void setETag(String value) {
+        etag = (value == null) ? null : ("\"" + value + "\"");
+
+        if ((etag != null) && (reqtrans != null) && reqtrans.hasETag(etag)) {
             notModified = true;
-	    throw new RedirectException (null);
+            throw new RedirectException(null);
         }
     }
 
-    public String getETag () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getETag() {
         return etag;
     }
 
-    public boolean getNotModified () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public boolean getNotModified() {
         return notModified;
     }
 
-    public void dependsOn (Object what) {
-	if (digest == null) try {
-	    digest = MessageDigest.getInstance ("MD5");
+    /**
+     *
+     *
+     * @param what ...
+     */
+    public void dependsOn(Object what) {
+        if (digest == null) {
+            try {
+                digest = MessageDigest.getInstance("MD5");
             } catch (NoSuchAlgorithmException nsa) {
                 // MD5 should always be available
             }
+        }
+
         if (what == null) {
-	    digest.update (new byte[0]);
+            digest.update(new byte[0]);
         } else if (what instanceof Date) {
-	    digest.update (MD5Encoder.toBytes(((Date) what).getTime()));
+            digest.update(MD5Encoder.toBytes(((Date) what).getTime()));
         } else if (what instanceof byte[]) {
-	    digest.update ((byte[]) what);
+            digest.update((byte[]) what);
         } else {
             String str = what.toString();
-	    if (str != null)
-	        digest.update (str.getBytes ());
-	    else
-	        digest.update (new byte[0]);
+
+            if (str != null) {
+                digest.update(str.getBytes());
+            } else {
+                digest.update(new byte[0]);
+            }
         }
     }
 
-    public void digestDependencies () {
-	if (digest == null)
+    /**
+     *
+     */
+    public void digestDependencies() {
+        if (digest == null) {
             return;
-	byte[] b = digest.digest(MD5Encoder.toBytes (applicationChecksum));
+        }
+
+        byte[] b = digest.digest(MD5Encoder.toBytes(applicationChecksum));
+
         /* StringBuffer buf = new StringBuffer(b.length*2);
            for ( int i=0; i<b.length; i++ ) {
                int j = (b[i]<0) ? 256+b[i] : b[i];
@@ -466,102 +614,179 @@ public final class ResponseTrans implements Externalizable {
                buf.append(Integer.toHexString(j));
            }
            setETag (buf.toString ()); */
-	setETag (new String (Base64.encode(b)));
+        setETag(new String(Base64.encode(b)));
     }
 
-    public void setApplicationChecksum (long n) {
+    /**
+     *
+     *
+     * @param n ...
+     */
+    public void setApplicationChecksum(long n) {
         applicationChecksum = n;
     }
 
-    public void setSkinpath (Object[] arr) {
+    /**
+     *
+     *
+     * @param arr ...
+     */
+    public void setSkinpath(Object[] arr) {
         this.skinpath = arr;
         skincache = null;
     }
 
-    public Object[] getSkinpath () {
-	if (skinpath == null)
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Object[] getSkinpath() {
+        if (skinpath == null) {
             skinpath = new Object[0];
+        }
+
         return skinpath;
     }
 
-    public Skin getCachedSkin (String id) {
-	if (skincache == null)
+    /**
+     *
+     *
+     * @param id ...
+     *
+     * @return ...
+     */
+    public Skin getCachedSkin(String id) {
+        if (skincache == null) {
             return null;
-	return (Skin) skincache.get (id);
         }
 
-    public void cacheSkin (String id, Skin skin) {
-	if (skincache == null)
-	    skincache = new HashMap ();
-	skincache.put (id, skin);
+        return (Skin) skincache.get(id);
     }
 
-    public void setCookie (String key, String value, int days, String path, String domain) {
+    /**
+     *
+     *
+     * @param id ...
+     * @param skin ...
+     */
+    public void cacheSkin(String id, Skin skin) {
+        if (skincache == null) {
+            skincache = new HashMap();
+        }
+
+        skincache.put(id, skin);
+    }
+
+    /**
+     *
+     *
+     * @param key ...
+     * @param value ...
+     * @param days ...
+     * @param path ...
+     * @param domain ...
+     */
+    public void setCookie(String key, String value, int days, String path, String domain) {
         CookieTrans c = null;
+
         if (cookies == null) {
-	    cookies = new HashMap ();
+            cookies = new HashMap();
         } else {
-	    c = (CookieTrans) cookies.get (key);
+            c = (CookieTrans) cookies.get(key);
         }
+
         if (c == null) {
-	    c = new CookieTrans (key, value);
-	    cookies.put (key, c);
+            c = new CookieTrans(key, value);
+            cookies.put(key, c);
         } else {
-	    c.setValue (value);
-	}
-	c.setDays (days);
-	c.setPath (path);
-	c.setDomain (domain);
+            c.setValue(value);
         }
 
-    public void resetCookies () {
-	if (cookies != null)
-	    cookies.clear ();
+        c.setDays(days);
+        c.setPath(path);
+        c.setDomain(domain);
     }
 
-    public int countCookies () {
-	if (cookies != null)
+    /**
+     *
+     */
+    public void resetCookies() {
+        if (cookies != null) {
+            cookies.clear();
+        }
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public int countCookies() {
+        if (cookies != null) {
             return cookies.size();
+        }
+
         return 0;
     }
 
-    public CookieTrans[] getCookies () {
-	if (cookies == null)
+    /**
+     *
+     *
+     * @return ...
+     */
+    public CookieTrans[] getCookies() {
+        if (cookies == null) {
             return new CookieTrans[0];
+        }
+
         CookieTrans[] c = new CookieTrans[cookies.size()];
-	cookies.values().toArray (c);
+
+        cookies.values().toArray(c);
+
         return c;
     }
 
-
-    public void readExternal (ObjectInput s) throws ClassNotFoundException, IOException {
-	contentType = (String) s.readObject ();
-	response = (byte[]) s.readObject ();
-	redir = (String) s.readObject ();
-	cookies = (Map) s.readObject ();
-	cache = s.readBoolean ();
-	status = s.readInt ();
-	realm = (String) s.readObject ();
-	lastModified = s.readLong ();
-	notModified = s.readBoolean ();
-	charset = (String) s.readObject ();
-	etag = (String) s.readObject ();
+    /**
+     *
+     *
+     * @param s ...
+     *
+     * @throws ClassNotFoundException ...
+     * @throws IOException ...
+     */
+    public void readExternal(ObjectInput s) throws ClassNotFoundException, IOException {
+        contentType = (String) s.readObject();
+        response = (byte[]) s.readObject();
+        redir = (String) s.readObject();
+        cookies = (Map) s.readObject();
+        cache = s.readBoolean();
+        status = s.readInt();
+        realm = (String) s.readObject();
+        lastModified = s.readLong();
+        notModified = s.readBoolean();
+        charset = (String) s.readObject();
+        etag = (String) s.readObject();
     }
 
-    public void writeExternal (ObjectOutput s) throws IOException {
-	s.writeObject (contentType);
-	s.writeObject (response);
-	s.writeObject (redir);
-	s.writeObject (cookies);
-	s.writeBoolean (cache);
-	s.writeInt (status);
-	s.writeObject (realm);
-	s.writeLong (lastModified);
-	s.writeBoolean (notModified);
-	s.writeObject (charset);
-	s.writeObject (etag);
+    /**
+     *
+     *
+     * @param s ...
+     *
+     * @throws IOException ...
+     */
+    public void writeExternal(ObjectOutput s) throws IOException {
+        s.writeObject(contentType);
+        s.writeObject(response);
+        s.writeObject(redir);
+        s.writeObject(cookies);
+        s.writeBoolean(cache);
+        s.writeInt(status);
+        s.writeObject(realm);
+        s.writeLong(lastModified);
+        s.writeBoolean(notModified);
+        s.writeObject(charset);
+        s.writeObject(etag);
     }
-
 }
-
-

src/helma/framework/TimeoutException.java

@@ -1,18 +1,31 @@
-// TimeoutException.java
-// Copyright (c) Hannes Wallnöfer 1998-2000
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework;
 
+
 /**
  * TimeoutException is thrown by the request evaluator when a request could
  * not be serviced within the timeout period specified for an application.
  */
- 
 public class TimeoutException extends RuntimeException {
-    public TimeoutException () {
-	super ("Request timed out");
+    /**
+     * Creates a new TimeoutException object.
+     */
+    public TimeoutException() {
+        super("Request timed out");
     }
 }
-
-
-

src/helma/framework/core/AppClassLoader.java

@@ -1,37 +1,53 @@
-// ApplicationClassLoader.java
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework.core;
 
 import java.net.URL;
 import java.net.URLClassLoader;
-import java.util.Enumeration;
 import java.security.CodeSource;
 import java.security.Permission;
 import java.security.PermissionCollection;
 import java.security.Permissions;
-
+import java.util.Enumeration;
 
 /**
  * ClassLoader subclass with package accessible addURL method.
  */
 public class AppClassLoader extends URLClassLoader {
-
     private final String appname;
 
     /**
      *  Create a HelmaClassLoader with the given application name and the given URLs
      */
     public AppClassLoader(String appname, URL[] urls) {
-	super ( urls, AppClassLoader.class.getClassLoader());
+        super(urls, AppClassLoader.class.getClassLoader());
         this.appname = appname;
     }
 
-    protected void addURL (URL url) {
-	super.addURL (url);
+    protected void addURL(URL url) {
+        super.addURL(url);
     }
 
-    public String getAppName () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getAppName() {
         return appname;
     }
-
 }

src/helma/framework/core/ApplicationBean.java

@@ -1,215 +1,497 @@
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.framework.core;
 
-import java.io.Serializable;
+import helma.objectmodel.INode;
+import helma.util.CronJob;
 import java.io.File;
+import java.io.Serializable;
 import java.util.ArrayList;
 import java.util.Date;
 import java.util.Enumeration;
 import java.util.HashMap;
 import java.util.Iterator;
-import java.util.Map;
 import java.util.List;
+import java.util.Map;
 
-import helma.objectmodel.INode;
-
+/**
+ * 
+ */
 public class ApplicationBean implements Serializable {
-
     Application app;
 
+    /**
+     * Creates a new ApplicationBean object.
+     *
+     * @param app ...
+     */
     public ApplicationBean(Application app) {
         this.app = app;
     }
 
-    public void clearCache () {
-	app.clearCache ();
+    /**
+     *
+     */
+    public void clearCache() {
+        app.clearCache();
     }
 
-    public void log (Object msg) {
-	String str = msg == null ? "null" : msg.toString();
-	app.logEvent (str);
+    /**
+     *
+     *
+     * @param msg ...
+     */
+    public void log(Object msg) {
+        String str = (msg == null) ? "null" : msg.toString();
+
+        app.logEvent(str);
     }
 
-    public void log (String logname, Object msg) {
-	String str = msg == null ? "null" : msg.toString();
-	app.getLogger (logname).log (str);
+    /**
+     *
+     *
+     * @param logname ...
+     * @param msg ...
+     */
+    public void log(String logname, Object msg) {
+        String str = (msg == null) ? "null" : msg.toString();
+
+        app.getLogger(logname).log(str);
     }
 
-    public void debug (Object msg) {
+    /**
+     *
+     *
+     * @param msg ...
+     */
+    public void debug(Object msg) {
         if (app.debug()) {
-	    String str = msg == null ? "null" : msg.toString();
-	    app.logEvent (str);
+            String str = (msg == null) ? "null" : msg.toString();
+
+            app.logEvent(str);
         }
     }
 
-    public void debug (String logname, Object msg) {
+    /**
+     *
+     *
+     * @param logname ...
+     * @param msg ...
+     */
+    public void debug(String logname, Object msg) {
         if (app.debug()) {
-	    String str = msg == null ? "null" : msg.toString();
-	    app.getLogger (logname).log (str);
+            String str = (msg == null) ? "null" : msg.toString();
+
+            app.getLogger(logname).log(str);
         }
     }
 
-    public int countSessions () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public int countSessions() {
         return app.sessions.size();
     }
 
-    public SessionBean getSession (String sessionID) {
-	if (sessionID==null)
+    /**
+     *
+     *
+     * @param sessionID ...
+     *
+     * @return ...
+     */
+    public SessionBean getSession(String sessionID) {
+        if (sessionID == null) {
             return null;
-	Session session = app.getSession (sessionID.trim ());
-	if (session == null)
-	    return null;
-	return new SessionBean (session);
         }
 
-    public SessionBean createSession (String sessionID) {
-	if (sessionID==null)
+        Session session = app.getSession(sessionID.trim());
+
+        if (session == null) {
             return null;
-	Session session = session = app.checkSession (sessionID.trim ());
-	if (session == null)
-	    return null;
-	return new SessionBean (session);
         }
 
-    public SessionBean[] getSessions () {
+        return new SessionBean(session);
+    }
+
+    /**
+     *
+     *
+     * @param sessionID ...
+     *
+     * @return ...
+     */
+    public SessionBean createSession(String sessionID) {
+        if (sessionID == null) {
+            return null;
+        }
+
+        Session session = session = app.checkSession(sessionID.trim());
+
+        if (session == null) {
+            return null;
+        }
+
+        return new SessionBean(session);
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public SessionBean[] getSessions() {
         SessionBean[] theArray = new SessionBean[app.sessions.size()];
-	int i=0;
-	for (Enumeration e=app.sessions.elements(); e.hasMoreElements(); ) {
-	    SessionBean sb = new SessionBean ((Session) e.nextElement ());
+        int i = 0;
+
+        for (Enumeration e = app.sessions.elements(); e.hasMoreElements();) {
+            SessionBean sb = new SessionBean((Session) e.nextElement());
+
             theArray[i++] = sb;
         }
+
         return theArray;
     }
 
-    public INode registerUser (String username, String password) {
-	if (username==null || password==null || "".equals (username.trim ()) || "".equals (password.trim ()) )
+    /**
+     *
+     *
+     * @param username ...
+     * @param password ...
+     *
+     * @return ...
+     */
+    public INode registerUser(String username, String password) {
+        if ((username == null) || (password == null) || "".equals(username.trim()) ||
+                "".equals(password.trim())) {
             return null;
-	else
-	    return app.registerUser (username, password);
+        } else {
+            return app.registerUser(username, password);
+        }
     }
 
-    public INode getUser (String username) {
-	if (username==null || "".equals (username.trim()) )
+    /**
+     *
+     *
+     * @param username ...
+     *
+     * @return ...
+     */
+    public INode getUser(String username) {
+        if ((username == null) || "".equals(username.trim())) {
             return null;
-	return app.getUserNode (username);
         }
 
-    public INode[] getActiveUsers () {
-	List activeUsers = app.getActiveUsers ();
-	return (INode[]) activeUsers.toArray (new INode[0]);
+        return app.getUserNode(username);
     }
 
-	public INode[] getRegisteredUsers () {
-	List registeredUsers = app.getRegisteredUsers ();
-	return (INode[]) registeredUsers.toArray (new INode[0]);
+    /**
+     *
+     *
+     * @return ...
+     */
+    public INode[] getActiveUsers() {
+        List activeUsers = app.getActiveUsers();
+
+        return (INode[]) activeUsers.toArray(new INode[0]);
     }
 
-    public SessionBean[] getSessionsForUser (INode usernode)	{
-	if (usernode==null)
+    /**
+     *
+     *
+     * @return ...
+     */
+    public INode[] getRegisteredUsers() {
+        List registeredUsers = app.getRegisteredUsers();
+
+        return (INode[]) registeredUsers.toArray(new INode[0]);
+    }
+
+    /**
+     *
+     *
+     * @param usernode ...
+     *
+     * @return ...
+     */
+    public SessionBean[] getSessionsForUser(INode usernode) {
+        if (usernode == null) {
             return new SessionBean[0];
-	else
+        } else {
             return getSessionsForUser(usernode.getName());
         }
+    }
 
-    public SessionBean[] getSessionsForUser (String username) {
-	if (username==null || "".equals (username.trim ()) )
+    /**
+     *
+     *
+     * @param username ...
+     *
+     * @return ...
+     */
+    public SessionBean[] getSessionsForUser(String username) {
+        if ((username == null) || "".equals(username.trim())) {
             return new SessionBean[0];
-	List userSessions = app.getSessionsForUsername (username);
-	return (SessionBean[]) userSessions.toArray (new SessionBean[0]);
+        }
+
+        List userSessions = app.getSessionsForUsername(username);
+
+        return (SessionBean[]) userSessions.toArray(new SessionBean[0]);
+    }
+
+    /**
+     *
+     *
+     * @param functionName ...
+     */
+    public void addCronJob(String functionName) {
+        CronJob job = new CronJob(functionName);
+
+        job.setFunction(functionName);
+        app.customCronJobs.put(functionName, job);
+    }
+
+    /**
+     *
+     *
+     * @param functionName ...
+     * @param year ...
+     * @param month ...
+     * @param day ...
+     * @param weekday ...
+     * @param hour ...
+     * @param minute ...
+     */
+    public void addCronJob(String functionName, String year, String month, String day,
+                           String weekday, String hour, String minute) {
+        CronJob job = CronJob.newJob(functionName, year, month, day, weekday, hour, minute);
+
+        app.customCronJobs.put(functionName, job);
+    }
+
+    /**
+     *
+     *
+     * @param functionName ...
+     */
+    public void removeCronJob(String functionName) {
+        app.customCronJobs.remove(functionName);
     }
 
     // getter methods for readonly properties of this application
-
-    public int getcacheusage () {
-	return app.getCacheUsage ();
+    public int getcacheusage() {
+        return app.getCacheUsage();
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public INode getdata() {
-	return app.getCacheNode ();
+        return app.getCacheNode();
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public Map getmodules() {
         return app.modules;
     }
 
-    public String getdir () {
-	return app.getAppDir ().getAbsolutePath ();
-    }
-
-    public Date getupSince () {
-	return new Date (app.starttime);
-    }
-
-    public long getrequestCount ()	{
-	return app.getRequestCount ();
-    }
-
-    public long getxmlrpcCount ()	{
-	return app.getXmlrpcCount ();
-    }
-
-    public long geterrorCount () {
-	return app.getErrorCount ();
-    }
-
-    public Application get__app__ () {
-	return app;
-    }
-
-    public Map getproperties () {
-	return app.getProperties ();
-    }
-
-    public int getfreeThreads () {
-	return app.countFreeEvaluators ();
-    }
-
-    public int getactiveThreads () {
-	return app.countActiveEvaluators ();
-    }
-
-    public int getmaxThreads () {
-	return app.countEvaluators ();
-    }
-
-    public void setmaxThreads (int n) {
-	// add one to the number to compensate for the internal scheduler.
-	app.setNumberOfEvaluators (n+1);
-    }
-
-    public Map getSkinfiles () {
-	Map skinz = new HashMap ();
-	for (Iterator it = app.getPrototypes().iterator(); it.hasNext(); ) {
-	    Prototype p = (Prototype) it.next ();
-	    skinz.put (p.getName(), p.getSkinMap());
-	}
-	return skinz;
-    }
-
-    public Map getSkinfiles (Object[] skinpath) {
-	Map skinz = new HashMap ();
-	for (Iterator it = app.getPrototypes().iterator(); it.hasNext(); ) {
-	    Prototype p = (Prototype) it.next ();
-	    skinz.put (p.getName(), p.getSkinMap(skinpath));
-	}
-	return skinz;
-    }
-
-    public String getAppDir () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getdir() {
         return app.getAppDir().getAbsolutePath();
     }
 
-    public String getServerDir () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getname() {
+        return app.getName();
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Date getupSince() {
+        return new Date(app.starttime);
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public long getrequestCount() {
+        return app.getRequestCount();
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public long getxmlrpcCount() {
+        return app.getXmlrpcCount();
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public long geterrorCount() {
+        return app.getErrorCount();
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Application get__app__() {
+        return app;
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Map getproperties() {
+        return app.getProperties();
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public int getfreeThreads() {
+        return app.countFreeEvaluators();
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public int getactiveThreads() {
+        return app.countActiveEvaluators();
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public int getmaxThreads() {
+        return app.countEvaluators();
+    }
+
+    /**
+     *
+     *
+     * @param n ...
+     */
+    public void setmaxThreads(int n) {
+        // add one to the number to compensate for the internal scheduler.
+        app.setNumberOfEvaluators(n + 1);
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Map getSkinfiles() {
+        Map skinz = new HashMap();
+
+        for (Iterator it = app.getPrototypes().iterator(); it.hasNext();) {
+            Prototype p = (Prototype) it.next();
+
+            skinz.put(p.getName(), p.getSkinMap());
+        }
+
+        return skinz;
+    }
+
+    /**
+     *
+     *
+     * @param skinpath ...
+     *
+     * @return ...
+     */
+    public Map getSkinfiles(Object[] skinpath) {
+        Map skinz = new HashMap();
+
+        for (Iterator it = app.getPrototypes().iterator(); it.hasNext();) {
+            Prototype p = (Prototype) it.next();
+
+            skinz.put(p.getName(), p.getSkinMap(skinpath));
+        }
+
+        return skinz;
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getAppDir() {
+        return app.getAppDir().getAbsolutePath();
+    }
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getServerDir() {
         File f = app.getServerDir();
-	if (f == null)
+
+        if (f == null) {
             f = app.getAppDir();
+        }
+
         return f.getAbsolutePath();
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public String toString() {
         return "[Application " + app.getName() + "]";
     }
-
 }
-
-
-

src/helma/framework/core/Prototype.java

@@ -1,16 +1,28 @@
-// Prototype.java
-// Copyright (c) Hannes Wallnöfer 1998-2000
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework.core;
 
-import java.util.*;
-import java.io.*;
 import helma.framework.*;
-import helma.scripting.*;
 import helma.objectmodel.*;
 import helma.objectmodel.db.DbMapping;
+import helma.scripting.*;
 import helma.util.Updatable;
-
+import java.io.*;
+import java.util.*;
 
 /**
  * The Prototype class represents Script prototypes/type defined in a Helma
@@ -18,100 +30,114 @@ import helma.util.Updatable;
  * as well as optional information about the mapping of this type to a
  * relational database table.
  */
-
-
 public final class Prototype {
-
     String name;
     Application app;
     File directory;
-
-    File [] files;
+    File[] files;
     long lastDirectoryListing;
     long checksum;
-
-    HashMap code, zippedCode;
-    HashMap skins, zippedSkins;
+    HashMap code;
+    HashMap zippedCode;
+    HashMap skins;
+    HashMap zippedSkins;
     HashMap updatables;
 
     // a map of this prototype's skins as raw strings
     // used for exposing skins to application (script) code (via app.skinfiles).
     SkinMap skinMap;
-
     DbMapping dbmap;
 
     // lastCheck is the time the prototype's files were last checked
     private long lastChecksum;
+
     // lastUpdate is the time at which any of the prototype's files were
     // found updated the last time
     private long lastUpdate;
-
     private Prototype parent;
 
     // Tells us whether this prototype is used to script a generic Java object,
     // as opposed to a Helma objectmodel node object.
     boolean isJavaPrototype;
 
-    public Prototype (String name, File dir, Application app) {
+    /**
+     * Creates a new Prototype object.
+     *
+     * @param name ...
+     * @param dir ...
+     * @param app ...
+     */
+    public Prototype(String name, File dir, Application app) {
         // app.logEvent ("Constructing Prototype "+app.getName()+"/"+name);
         this.app = app;
         this.name = name;
         this.directory = dir;
 
-	code = new HashMap ();
-	zippedCode = new HashMap ();
-	skins = new HashMap ();
-	zippedSkins = new HashMap ();
-	updatables = new HashMap ();
+        code = new HashMap();
+        zippedCode = new HashMap();
+        skins = new HashMap();
+        zippedSkins = new HashMap();
+        updatables = new HashMap();
 
-	skinMap = new SkinMap ();
+        skinMap = new SkinMap();
 
-	isJavaPrototype = app.isJavaPrototype (name);
+        isJavaPrototype = app.isJavaPrototype(name);
         lastUpdate = lastChecksum = 0;
     }
 
     /**
      *  Return the application this prototype is a part of
      */
-    public Application getApplication () {
+    public Application getApplication() {
         return app;
     }
 
     /**
      *  Return this prototype's directory.
      */
-    public File getDirectory () {
+    public File getDirectory() {
         return directory;
     }
 
     /**
      *  Get the list of files in this prototype's directory
      */
-    public File[] getFiles () {
-	if (files == null || directory.lastModified() != lastDirectoryListing) {
-	    lastDirectoryListing = directory.lastModified ();
+    public File[] getFiles() {
+        if ((files == null) || (directory.lastModified() != lastDirectoryListing)) {
+            lastDirectoryListing = directory.lastModified();
             files = directory.listFiles();
-	    if (files == null)
+
+            if (files == null) {
                 files = new File[0];
             }
+        }
+
         return files;
     }
 
     /**
      *  Get a checksum over the files in this prototype's directory
      */
-    public long getChecksum () {
+    public long getChecksum() {
         // long start = System.currentTimeMillis();
-	File[] f = getFiles ();
+        File[] f = getFiles();
         long c = 0;
-	for (int i=0; i<f.length; i++)
+
+        for (int i = 0; i < f.length; i++)
             c += f[i].lastModified();
+
         checksum = c;
+
         // System.err.println ("CHECKSUM "+name+": "+(System.currentTimeMillis()-start));
         return checksum;
     }
 
-    public boolean isUpToDate () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public boolean isUpToDate() {
         return checksum == lastChecksum;
     }
 
@@ -119,10 +145,12 @@ public final class Prototype {
      *  Set the parent prototype of this prototype, i.e. the prototype this
      *  prototype inherits from.
      */
-    public void setParentPrototype (Prototype parent) {
+    public void setParentPrototype(Prototype parent) {
         // this is not allowed for the hopobject and global prototypes
-	if ("hopobject".equalsIgnoreCase (name) || "global".equalsIgnoreCase (name))
+        if ("hopobject".equalsIgnoreCase(name) || "global".equalsIgnoreCase(name)) {
             return;
+        }
+
         this.parent = parent;
     }
 
@@ -130,48 +158,66 @@ public final class Prototype {
      *  Get the parent prototype from which we inherit, or null
      *  if we are top of the line.
      */
-    public Prototype getParentPrototype () {
+    public Prototype getParentPrototype() {
         return parent;
     }
 
     /**
      * Check if the given prototype is within this prototype's parent chain.
      */
-    public final boolean isInstanceOf (String pname) {
-	if (name.equals (pname))
+    public final boolean isInstanceOf(String pname) {
+        if (name.equals(pname)) {
             return true;
-	if (parent != null && !"hopobject".equalsIgnoreCase (parent.getName()))
-	   return parent.isInstanceOf (pname);
+        }
+
+        if ((parent != null) && !"hopobject".equalsIgnoreCase(parent.getName())) {
+            return parent.isInstanceOf(pname);
+        }
+
         return false;
     }
 
     /**
      * Register an object as handler for this prototype and all our parent prototypes.
      */
-    public final void addToHandlerMap (Map handlers, Object obj) {
-	if (parent != null && !"hopobject".equalsIgnoreCase (parent.getName()))
-	   parent.addToHandlerMap (handlers, obj);
-	handlers.put (name, obj);
+    public final void addToHandlerMap(Map handlers, Object obj) {
+        if ((parent != null) && !"hopobject".equalsIgnoreCase(parent.getName())) {
+            parent.addToHandlerMap(handlers, obj);
         }
 
-    public void setDbMapping (DbMapping dbmap) {
+        handlers.put(name, obj);
+    }
+
+    /**
+     *
+     *
+     * @param dbmap ...
+     */
+    public void setDbMapping(DbMapping dbmap) {
         this.dbmap = dbmap;
     }
 
-    public DbMapping getDbMapping () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public DbMapping getDbMapping() {
         return dbmap;
     }
 
-
     /**
      *  Get a Skinfile for this prototype. This only works for skins
      *  residing in the prototype directory, not for skin files in
      *  other locations or database stored skins.
      */
-    public SkinFile getSkinFile (String sfname) {
-	SkinFile sf = (SkinFile) skins.get (sfname);
-	if (sf == null)
-	    sf = (SkinFile) zippedSkins.get (sfname);
+    public SkinFile getSkinFile(String sfname) {
+        SkinFile sf = (SkinFile) skins.get(sfname);
+
+        if (sf == null) {
+            sf = (SkinFile) zippedSkins.get(sfname);
+        }
+
         return sf;
     }
 
@@ -180,24 +226,29 @@ public final class Prototype {
      *  residing in the prototype directory, not for skins files in
      *  other locations or database stored skins.
      */
-    public Skin getSkin (String sfname) {
-	SkinFile sf = getSkinFile (sfname);
-	if (sf != null)
-	    return sf.getSkin ();
-	else
+    public Skin getSkin(String sfname) {
+        SkinFile sf = getSkinFile(sfname);
+
+        if (sf != null) {
+            return sf.getSkin();
+        } else {
             return null;
         }
-
-
-    public String getName () {
-	return name;
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getName() {
+        return name;
+    }
 
     /**
      *  Get the last time any script has been re-read for this prototype.
      */
-    public long getLastUpdate () {
+    public long getLastUpdate() {
         return lastUpdate;
     }
 
@@ -206,14 +257,15 @@ public final class Prototype {
      *  re-read from disk and needs to be re-compiled by
      *  the evaluators.
      */
-    public void markUpdated () {
-	lastUpdate = System.currentTimeMillis ();
+    public void markUpdated() {
+        lastUpdate = System.currentTimeMillis();
     }
 
     /**
      *  Get the time at which this prototype's scripts were checked
      *  for changes for the last time.
      */
+
     /* public long getLastCheck () {
        return lastCheck;
        } */
@@ -222,18 +274,17 @@ public final class Prototype {
      *  Signal that the prototype's scripts have been checked for
      *  changes.
      */
-    public void markChecked () {
+    public void markChecked() {
         // lastCheck = System.currentTimeMillis ();
         lastChecksum = checksum;
     }
 
-
     /**
      *  Return a clone of this prototype's actions container. Synchronized
      *  to not return a map in a transient state where it is just being
      *  updated by the type manager.
      */
-    public synchronized Map getCode () {
+    public synchronized Map getCode() {
         return (Map) code.clone();
     }
 
@@ -242,232 +293,304 @@ public final class Prototype {
      *  to not return a map in a transient state where it is just being
      *  updated by the type manager.
      */
-    public synchronized Map getZippedCode () {
+    public synchronized Map getZippedCode() {
         return (Map) zippedCode.clone();
     }
 
+    /**
+     *
+     *
+     * @param action ...
+     */
+    public synchronized void addActionFile(ActionFile action) {
+        File f = action.getFile();
 
-    public synchronized void addActionFile (ActionFile action) {
-	File f = action.getFile ();
         if (f != null) {
-	    code.put (action.getSourceName(), action);
-	    updatables.put (f.getName(), action);
+            code.put(action.getSourceName(), action);
+            updatables.put(f.getName(), action);
         } else {
-	    zippedCode.put (action.getSourceName(), action);
+            zippedCode.put(action.getSourceName(), action);
         }
     }
 
-    public synchronized void addTemplate (Template template) {
-	File f = template.getFile ();
+    /**
+     *
+     *
+     * @param template ...
+     */
+    public synchronized void addTemplate(Template template) {
+        File f = template.getFile();
+
         if (f != null) {
-	    code.put (template.getSourceName(), template);
-	    updatables.put (f.getName(), template);
+            code.put(template.getSourceName(), template);
+            updatables.put(f.getName(), template);
         } else {
-	    zippedCode.put (template.getSourceName(), template);
+            zippedCode.put(template.getSourceName(), template);
         }
     }
 
-    public synchronized void addFunctionFile (FunctionFile funcfile) {
-	File f = funcfile.getFile ();
+    /**
+     *
+     *
+     * @param funcfile ...
+     */
+    public synchronized void addFunctionFile(FunctionFile funcfile) {
+        File f = funcfile.getFile();
+
         if (f != null) {
-	    code.put (funcfile.getSourceName(), funcfile);
-	    updatables.put (f.getName(), funcfile);
+            code.put(funcfile.getSourceName(), funcfile);
+            updatables.put(f.getName(), funcfile);
         } else {
-	    zippedCode.put (funcfile.getSourceName(), funcfile);
+            zippedCode.put(funcfile.getSourceName(), funcfile);
         }
     }
 
-    public synchronized void addSkinFile (SkinFile skinfile) {
-	File f = skinfile.getFile ();
+    /**
+     *
+     *
+     * @param skinfile ...
+     */
+    public synchronized void addSkinFile(SkinFile skinfile) {
+        File f = skinfile.getFile();
+
         if (f != null) {
-	    skins.put (skinfile.getName(), skinfile);
-	    updatables.put (f.getName(), skinfile);
+            skins.put(skinfile.getName(), skinfile);
+            updatables.put(f.getName(), skinfile);
         } else {
-	    zippedSkins.put (skinfile.getName(), skinfile);
+            zippedSkins.put(skinfile.getName(), skinfile);
         }
     }
 
+    /**
+     *
+     *
+     * @param action ...
+     */
+    public synchronized void removeActionFile(ActionFile action) {
+        File f = action.getFile();
 
-    public synchronized void removeActionFile (ActionFile action) {
-	File f = action.getFile ();
         if (f != null) {
-	    code.remove (action.getSourceName());
-	    updatables.remove (f.getName());
+            code.remove(action.getSourceName());
+            updatables.remove(f.getName());
         } else {
-	    zippedCode.remove (action.getSourceName());
+            zippedCode.remove(action.getSourceName());
         }
     }
 
-    public synchronized void removeFunctionFile (FunctionFile funcfile) {
-	File f = funcfile.getFile ();
+    /**
+     *
+     *
+     * @param funcfile ...
+     */
+    public synchronized void removeFunctionFile(FunctionFile funcfile) {
+        File f = funcfile.getFile();
+
         if (f != null) {
-	    code.remove (funcfile.getSourceName());
-	    updatables.remove (f.getName());
+            code.remove(funcfile.getSourceName());
+            updatables.remove(f.getName());
         } else {
-	    zippedCode.remove (funcfile.getSourceName());
+            zippedCode.remove(funcfile.getSourceName());
         }
     }
 
-    public synchronized void removeTemplate (Template template) {
-	File f = template.getFile ();
+    /**
+     *
+     *
+     * @param template ...
+     */
+    public synchronized void removeTemplate(Template template) {
+        File f = template.getFile();
+
         if (f != null) {
-	    code.remove (template.getSourceName());
-	    updatables.remove (f.getName());
+            code.remove(template.getSourceName());
+            updatables.remove(f.getName());
         } else {
-	    zippedCode.remove (template.getSourceName());
+            zippedCode.remove(template.getSourceName());
         }
     }
 
-    public synchronized void removeSkinFile (SkinFile skinfile) {
-	File f = skinfile.getFile ();
+    /**
+     *
+     *
+     * @param skinfile ...
+     */
+    public synchronized void removeSkinFile(SkinFile skinfile) {
+        File f = skinfile.getFile();
+
         if (f != null) {
-	    skins.remove (skinfile.getName());
-	    updatables.remove (f.getName());
+            skins.remove(skinfile.getName());
+            updatables.remove(f.getName());
         } else {
-	    zippedSkins.remove (skinfile.getName());
+            zippedSkins.remove(skinfile.getName());
         }
     }
 
-
     /**
      *  Return a string representing this prototype.
      */
-    public String toString () {
-	return "[Prototype "+ app.getName()+"/"+name+"]";
+    public String toString() {
+        return "[Prototype " + app.getName() + "/" + name + "]";
     }
 
-
-    public SkinMap getSkinMap () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public SkinMap getSkinMap() {
         return skinMap;
     }
 
     // not yet implemented
-    public SkinMap getSkinMap (Object[] skinpath) {
-	return new SkinMap (skinpath);
+    public SkinMap getSkinMap(Object[] skinpath) {
+        return new SkinMap(skinpath);
     }
 
     // a map that dynamically expands to all skins in this prototype
     final class SkinMap extends HashMap {
-
         long lastSkinmapLoad = 0;
-
         Object[] skinpath;
 
-	SkinMap () {
-	    super ();
+        SkinMap() {
+            super();
             skinpath = null;
         }
 
-	SkinMap (Object[] path) {
-	    super ();
+        SkinMap(Object[] path) {
+            super();
             skinpath = path;
         }
 
-	public boolean containsKey (Object key) {
-	    checkForUpdates ();
-	    return super.containsKey (key);
+        public boolean containsKey(Object key) {
+            checkForUpdates();
+
+            return super.containsKey(key);
         }
 
-	public boolean containsValue (Object value) {
-	    checkForUpdates ();
-	    return super.containsValue (value);
+        public boolean containsValue(Object value) {
+            checkForUpdates();
+
+            return super.containsValue(value);
         }
 
-	public Set entrySet () {
-	    checkForUpdates ();
-	    return super.entrySet ();
+        public Set entrySet() {
+            checkForUpdates();
+
+            return super.entrySet();
         }
 
-	public boolean equals (Object obj) {
-	    checkForUpdates ();
-	    return super.equals (obj);
+        public boolean equals(Object obj) {
+            checkForUpdates();
+
+            return super.equals(obj);
         }
 
-	public Object get (Object key) {
-	    if (key == null)
+        public Object get(Object key) {
+            if (key == null) {
                 return null;
-	    checkForUpdates ();
-	    SkinFile sf = (SkinFile) super.get (key);
-	    if (sf == null)
+            }
+
+            checkForUpdates();
+
+            SkinFile sf = (SkinFile) super.get(key);
+
+            if (sf == null) {
                 return null;
-	    return sf.getSkin().getSource ();
             }
 
-	public int hashCode () {
-	    checkForUpdates ();
-	    return super.hashCode ();
+            return sf.getSkin().getSource();
         }
 
-	public boolean isEmpty () {
-	    checkForUpdates ();
-	    return super.isEmpty ();
+        public int hashCode() {
+            checkForUpdates();
+
+            return super.hashCode();
         }
 
-	public Set keySet () {
-	    checkForUpdates ();
-	    return super.keySet ();
+        public boolean isEmpty() {
+            checkForUpdates();
+
+            return super.isEmpty();
         }
 
-	public Object put (Object key, Object value) {
+        public Set keySet() {
+            checkForUpdates();
+
+            return super.keySet();
+        }
+
+        public Object put(Object key, Object value) {
             // checkForUpdates ();
-	    return super.put (key, value);
+            return super.put(key, value);
         }
 
-	public void putAll (Map t) {
+        public void putAll(Map t) {
             // checkForUpdates ();
-	    super.putAll (t);
+            super.putAll(t);
         }
 
-	public Object remove (Object key) {
-	    checkForUpdates ();
-	    return super.remove (key);
+        public Object remove(Object key) {
+            checkForUpdates();
+
+            return super.remove(key);
         }
 
-	public int size () {
-	    checkForUpdates ();
-	    return super.size ();
+        public int size() {
+            checkForUpdates();
+
+            return super.size();
         }
 
-	public Collection values () {
-	    checkForUpdates ();
-	    return super.values ();
+        public Collection values() {
+            checkForUpdates();
+
+            return super.values();
         }
 
-
-	private void checkForUpdates () {
-	    if (/* lastCheck < System.currentTimeMillis()- 2000l*/ !isUpToDate())
-	        app.typemgr.updatePrototype (Prototype.this);
-	    if (lastUpdate > lastSkinmapLoad)
-	        load ();
+        private void checkForUpdates() {
+            if ( /* lastCheck < System.currentTimeMillis()- 2000l*/
+                !isUpToDate()) {
+                app.typemgr.updatePrototype(Prototype.this);
             }
 
-	private synchronized void load () {
-	    if (lastUpdate == lastSkinmapLoad)
+            if (lastUpdate > lastSkinmapLoad) {
+                load();
+            }
+        }
+
+        private synchronized void load() {
+            if (lastUpdate == lastSkinmapLoad) {
                 return;
-	    super.clear ();
-	    // System.err.println ("LOADING SKIN VALUES: "+Prototype.this);
-	    for (Iterator i = skins.entrySet().iterator(); i.hasNext(); ) {
-	        Map.Entry e = (Map.Entry) i.next ();
-	        super.put (e.getKey(), e.getValue());
             }
+
+            super.clear();
+
+            // System.err.println ("LOADING SKIN VALUES: "+Prototype.this);
+            for (Iterator i = skins.entrySet().iterator(); i.hasNext();) {
+                Map.Entry e = (Map.Entry) i.next();
+
+                super.put(e.getKey(), e.getValue());
+            }
+
             // if skinpath is not null, overload/add skins from there
             if (skinpath != null) {
-	        for (int i=skinpath.length-1; i>=0; i--) {
-	            if (skinpath[i] != null && skinpath[i] instanceof String) {
-	                Map m = app.skinmgr.getSkinFiles ((String) skinpath[i], Prototype.this);
-	                if (m != null)
-	                    super.putAll (m);
+                for (int i = skinpath.length - 1; i >= 0; i--) {
+                    if ((skinpath[i] != null) && skinpath[i] instanceof String) {
+                        Map m = app.skinmgr.getSkinFiles((String) skinpath[i],
+                                                         Prototype.this);
+
+                        if (m != null) {
+                            super.putAll(m);
                         }
                     }
                 }
+            }
+
             lastSkinmapLoad = lastUpdate;
         }
 
-	public String toString () {
-	    return "[SkinMap "+name+"]";
+        public String toString() {
+            return "[SkinMap " + name + "]";
         }
-
     }
-
 }
-

src/helma/framework/core/RemoteApplication.java

@@ -1,5 +1,18 @@
-// RemoteApplication.java
-// Copyright (c) Hannes Wallnöfer 2002
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework.core;
 
@@ -12,43 +25,45 @@ import java.util.Vector;
 /**
  * Proxy class for Aplication that listens to requests via RMI.
  */
-
-public class RemoteApplication
-		extends UnicastRemoteObject
-		implements IRemoteApp, IReplicationListener {
-
+public class RemoteApplication extends UnicastRemoteObject implements IRemoteApp,
+                                                                      IReplicationListener {
     Application app;
 
-
-    public RemoteApplication (Application app) throws RemoteException {
+    /**
+     * Creates a new RemoteApplication object.
+     *
+     * @param app ...
+     *
+     * @throws RemoteException ...
+     */
+    public RemoteApplication(Application app) throws RemoteException {
         this.app = app;
     }
 
-
     /**
      *  ping method to let clients know if the server is reachable
      */
-    public void ping () {
+    public void ping() {
         // do nothing
     }
 
     /**
      *  Execute a request coming in from a web client.
      */
-    public ResponseTrans execute (RequestTrans req) {
-	return app.execute (req);
+    public ResponseTrans execute(RequestTrans req) {
+        return app.execute(req);
     }
 
-
     /**
      * Update HopObjects in this application's cache. This is used to replicate
      * application caches in a distributed app environment
      */
-    public void replicateCache (Vector add, Vector delete) {
-	if (!"true".equalsIgnoreCase (app.getProperty ("allowReplication"))) {
-	    app.logEvent ("Rejecting cache replication event: allowReplication property is not set to true");
-	    throw new RuntimeException ("Replication event rejected: setup does not allow replication.");
+    public void replicateCache(Vector add, Vector delete) {
+        if (!"true".equalsIgnoreCase(app.getProperty("allowReplication"))) {
+            app.logEvent("Rejecting cache replication event: allowReplication property is not set to true");
+            throw new RuntimeException("Replication event rejected: setup does not allow replication.");
         }
-	app.nmgr.replicateCache (add, delete);
+
+        app.nmgr.replicateCache(add, delete);
     }
 }

src/helma/framework/core/Session.java

@@ -1,12 +1,26 @@
-// Session.java
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework.core;
 
-import java.io.*;
-import java.util.*;
-import java.net.URLEncoder;
 import helma.objectmodel.*;
 import helma.objectmodel.db.*;
+import java.io.*;
+import java.net.URLEncoder;
+import java.util.*;
 
 /**
  * This represents a session currently using the Hop application.
@@ -14,9 +28,7 @@ import helma.objectmodel.db.*;
  * Depending on whether the user is logged in or not, the user object holds a
  * persistent user node.
  */
- 
 public class Session implements Serializable {
-
     transient Application app;
     String sessionID;
 
@@ -29,35 +41,43 @@ public class Session implements Serializable {
     // the transient cache node that is exposed to javascript
     // this stays the same across logins and logouts.
     public TransientNode cacheNode;
-
-    long onSince, lastTouched, lastModified;
+    long onSince;
+    long lastTouched;
+    long lastModified;
 
     // used to remember messages to the user between requests -
     // used for redirects.
     String message;
 
-    public Session (String sessionID, Application app) {
+    /**
+     * Creates a new Session object.
+     *
+     * @param sessionID ...
+     * @param app ...
+     */
+    public Session(String sessionID, Application app) {
         this.sessionID = sessionID;
         this.app = app;
         this.uid = null;
         this.userHandle = null;
-	cacheNode = new TransientNode ("session");
-	onSince = System.currentTimeMillis ();
+        cacheNode = new TransientNode("session");
+        onSince = System.currentTimeMillis();
         lastTouched = lastModified = onSince;
     }
 
     /**
      * attach the given user node to this session.
      */
-    public void login (INode usernode) {
-	if (usernode==null) {
+    public void login(INode usernode) {
+        if (usernode == null) {
             userHandle = null;
             uid = null;
         } else {
-	    userHandle = ((Node)usernode).getHandle();
+            userHandle = ((Node) usernode).getHandle();
             uid = usernode.getElementName();
         }
-	lastModified = System.currentTimeMillis ();
+
+        lastModified = System.currentTimeMillis();
     }
 
     /**
@@ -66,11 +86,16 @@ public class Session implements Serializable {
     public void logout() {
         userHandle = null;
         uid = null;
-	lastModified = System.currentTimeMillis ();
+        lastModified = System.currentTimeMillis();
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public boolean isLoggedIn() {
-	if (userHandle!=null && uid!=null) {
+        if ((userHandle != null) && (uid != null)) {
             return true;
         } else {
             return false;
@@ -81,66 +106,110 @@ public class Session implements Serializable {
      * Gets the user Node from this Application's NodeManager.
      */
     public INode getUserNode() {
-	if (userHandle!=null)
-	    return userHandle.getNode (app.getWrappedNodeManager());
-	else
+        if (userHandle != null) {
+            return userHandle.getNode(app.getWrappedNodeManager());
+        } else {
             return null;
         }
+    }
 
     /**
      * Gets the transient cache node.
      */
-    public INode getCacheNode () {
+    public INode getCacheNode() {
         return cacheNode;
     }
 
-    public Application getApp () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Application getApp() {
         return app;
     }
 
-    public void setApp (Application app) {
+    /**
+     *
+     *
+     * @param app ...
+     */
+    public void setApp(Application app) {
         this.app = app;
     }
 
-    public String getSessionID () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getSessionID() {
         return sessionID;
     }
 
-    public void touch () {
-	lastTouched = System.currentTimeMillis ();
+    /**
+     *
+     */
+    public void touch() {
+        lastTouched = System.currentTimeMillis();
     }
 
-    public long lastTouched () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public long lastTouched() {
         return lastTouched;
     }
 
-    public long lastModified () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public long lastModified() {
         return lastModified;
     }
 
-    public void setLastModified (Date date) {
-	if (date != null)
-	    lastModified = date.getTime ();
+    /**
+     *
+     *
+     * @param date ...
+     */
+    public void setLastModified(Date date) {
+        if (date != null) {
+            lastModified = date.getTime();
+        }
     }
 
-    public long onSince () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public long onSince() {
         return onSince;
     }
 
-    public String toString () {
-	if ( uid!=null )
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String toString() {
+        if (uid != null) {
             return "[Session for user " + uid + "]";
-	else
+        } else {
             return "[Anonymous Session]";
         }
+    }
 
     /**
      * Get the persistent user id of a registered user. This is usually the user name, or
      * null if the user is not logged in.
      */
-    public String getUID () {
+    public String getUID() {
         return uid;
     }
-
 }
-

src/helma/framework/core/SessionBean.java

@@ -1,79 +1,163 @@
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.framework.core;
 
+import helma.objectmodel.INode;
+import helma.scripting.fesi.*;
 import java.io.Serializable;
 import java.util.Date;
 import java.util.HashMap;
 
-import helma.objectmodel.INode;
-import helma.scripting.fesi.*;
-
+/**
+ * 
+ */
 public class SessionBean implements Serializable {
-
     // the wrapped session object
     Session session;
 
+    /**
+     * Creates a new SessionBean object.
+     *
+     * @param session ...
+     */
     public SessionBean(Session session) {
         this.session = session;
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public String toString() {
-	return session.toString ();
+        return session.toString();
     }
 
-    public boolean login (String username, String password) {
-	boolean success = session.getApp().loginSession (username, password, session);
+    /**
+     *
+     *
+     * @param username ...
+     * @param password ...
+     *
+     * @return ...
+     */
+    public boolean login(String username, String password) {
+        boolean success = session.getApp().loginSession(username, password, session);
+
         return success;
     }
 
-    public void logout ()	{
-	session.getApp().logoutSession (session);
+    /**
+     *
+     */
+    public void logout() {
+        session.getApp().logoutSession(session);
     }
 
-    public void touch () {
-	session.touch ();
+    /**
+     *
+     */
+    public void touch() {
+        session.touch();
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public Date lastActive() {
-	return new Date (session.lastTouched ());
+        return new Date(session.lastTouched());
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public Date onSince() {
-	return new Date (session.onSince ());
+        return new Date(session.onSince());
     }
 
     // property-related methods:
-
     public INode getdata() {
-	return session.getCacheNode ();
+        return session.getCacheNode();
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public INode getuser() {
         return session.getUserNode();
     }
 
-    public String get_id () {
-	return session.getSessionID ();
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String get_id() {
+        return session.getSessionID();
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public String getcookie() {
-	return session.getSessionID ();
+        return session.getSessionID();
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public Date getlastActive() {
-	return new Date (session.lastTouched ());
+        return new Date(session.lastTouched());
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public Date getonSince() {
-	return new Date (session.onSince ());
+        return new Date(session.onSince());
     }
 
-    public Date getLastModified () {
-	return new Date (session.lastModified ());
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Date getLastModified() {
+        return new Date(session.lastModified());
     }
 
-    public void setLastModified (Date date) {
-	session.setLastModified (date);
+    /**
+     *
+     *
+     * @param date ...
+     */
+    public void setLastModified(Date date) {
+        session.setLastModified(date);
     }
-
 }
-

src/helma/framework/core/Skin.java

@@ -1,15 +1,28 @@
-// Skin.java
-// Copyright (c) Hannes Wallnöfer 2001
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework.core;
 
 import helma.framework.*;
-import helma.scripting.*;
-import helma.objectmodel.INode;
 import helma.objectmodel.ConcurrencyException;
+import helma.objectmodel.INode;
+import helma.scripting.*;
 import helma.util.HtmlEncoder;
-import java.net.URLEncoder;
 import java.io.*;
+import java.net.URLEncoder;
 import java.util.*;
 
 /**
@@ -17,113 +30,132 @@ import java.util.*;
  * that will be dynamically evaluated.. It uses the request path array
  * from the RequestEvaluator object to resolve Macro handlers by type name.
  */
-
 public final class Skin {
-
+    static final int HANDLER = 0;
+    static final int MACRO = 1;
+    static final int PARAMNAME = 2;
+    static final int PARAMVALUE = 3;
+    static final int ENCODE_NONE = 0;
+    static final int ENCODE_HTML = 1;
+    static final int ENCODE_XML = 2;
+    static final int ENCODE_FORM = 3;
+    static final int ENCODE_URL = 4;
+    static final int ENCODE_ALL = 5;
     private Macro[] macros;
     private Application app;
     private char[] source;
     private int sourceLength;
     private HashSet sandbox;
 
-
     /**
      * Create a skin without any restrictions on which macros are allowed to be called from it
      */
-    public Skin (String content, Application app) {
+    public Skin(String content, Application app) {
         this.app = app;
         sandbox = null;
-	source = content.toCharArray ();
+        source = content.toCharArray();
         sourceLength = source.length;
-	parse ();
+        parse();
     }
 
     /**
      * Create a skin with a sandbox which contains the names of macros allowed to be called
      */
-    public Skin (String content, Application app, HashSet sandbox) {
+    public Skin(String content, Application app, HashSet sandbox) {
         this.app = app;
         this.sandbox = sandbox;
-	source = content.toCharArray ();
+        source = content.toCharArray();
         sourceLength = source.length;
-	parse ();
+        parse();
     }
 
     /**
      *  Create a skin without any restrictions on the macros from a char array.
      */
-    public Skin (char[] content, int length, Application app) {
+    public Skin(char[] content, int length, Application app) {
         this.app = app;
         this.sandbox = null;
         source = content;
         sourceLength = length;
-	parse ();
+        parse();
     }
 
     /**
      * Parse a skin object from source text
      */
-    private void parse () {
-
-	ArrayList partBuffer = new ArrayList ();
+    private void parse() {
+        ArrayList partBuffer = new ArrayList();
 
         int start = 0;
-	for (int i = 0; i < sourceLength-1; i++) {
-	    if (source[i] == '<' && source[i+1] == '%') {
+
+        for (int i = 0; i < (sourceLength - 1); i++) {
+            if ((source[i] == '<') && (source[i + 1] == '%')) {
                 // found macro start tag
-	        int j = i+2;
+                int j = i + 2;
+
                 // search macr end tag
-	        while (j < sourceLength-1 && (source[j] != '%' || source[j+1] != '>')) {
+                while ((j < (sourceLength - 1)) &&
+                           ((source[j] != '%') || (source[j + 1] != '>'))) {
                     j++;
                 }
-	        if (j > i+2) {
-	            partBuffer.add (new Macro (i, j+2));
-	            start = j+2;
+
+                if (j > (i + 2)) {
+                    partBuffer.add(new Macro(i, j + 2));
+                    start = j + 2;
                 }
-	        i = j+1;
+
+                i = j + 1;
             }
         }
 
         macros = new Macro[partBuffer.size()];
-	partBuffer.toArray (macros);
+        partBuffer.toArray(macros);
     }
 
     /**
      * Get the raw source text this skin was parsed from
      */
-    public String getSource () {
-	return new String (source, 0, sourceLength);
+    public String getSource() {
+        return new String(source, 0, sourceLength);
     }
 
     /**
      * Render this skin
      */
-    public void render (RequestEvaluator reval, Object thisObject, Map paramObject) throws RedirectException {
-
+    public void render(RequestEvaluator reval, Object thisObject, Map paramObject)
+                throws RedirectException {
         // check for endless skin recursion
-	if (++reval.skinDepth > 50)
-	    throw new RuntimeException ("Recursive skin invocation suspected");
+        if (++reval.skinDepth > 50) {
+            throw new RuntimeException("Recursive skin invocation suspected");
+        }
 
         if (macros == null) {
-	    reval.res.writeCharArray (source, 0, sourceLength);
+            reval.res.writeCharArray(source, 0, sourceLength);
             reval.skinDepth--;
+
             return;
         }
 
         try {
             int written = 0;
             Map handlerCache = null;
+
             if (macros.length > 3) {
                 handlerCache = new HashMap();
             }
-	    for (int i=0; i<macros.length; i++) {
-	        if (macros[i].start > written)
-	            reval.res.writeCharArray (source, written, macros[i].start-written);
-	        macros[i].render (reval, thisObject, paramObject, handlerCache);
+
+            for (int i = 0; i < macros.length; i++) {
+                if (macros[i].start > written) {
+                    reval.res.writeCharArray(source, written, macros[i].start - written);
+                }
+
+                macros[i].render(reval, thisObject, paramObject, handlerCache);
                 written = macros[i].end;
             }
-	    if (written < sourceLength)
-	        reval.res.writeCharArray (source, written, sourceLength-written);
+
+            if (written < sourceLength) {
+                reval.res.writeCharArray(source, written, sourceLength - written);
+            }
         } finally {
             reval.skinDepth--;
         }
@@ -132,42 +164,34 @@ public final class Skin {
     /**
      * Check if a certain macro is present in this skin. The macro name is in handler.name notation
      */
-    public boolean containsMacro (String macroname) {
-	for (int i=0; i<macros.length; i++) {
+    public boolean containsMacro(String macroname) {
+        for (int i = 0; i < macros.length; i++) {
             if (macros[i] instanceof Macro) {
                 Macro m = (Macro) macros[i];
-	        if (macroname.equals (m.fullName))
+
+                if (macroname.equals(m.fullName)) {
                     return true;
                 }
             }
+        }
+
         return false;
     }
 
     /**
      *  Adds a macro to the list of allowed macros. The macro is in handler.name notation.
      */
-    public void allowMacro (String macroname) {
+    public void allowMacro(String macroname) {
         if (sandbox == null) {
-	    sandbox = new HashSet ();
-	}
-	sandbox.add (macroname);
+            sandbox = new HashSet();
         }
 
-    static final int HANDLER = 0;
-    static final int MACRO = 1;
-    static final int PARAMNAME = 2;
-    static final int PARAMVALUE = 3;
-
-    static final int ENCODE_NONE = 0;
-    static final int ENCODE_HTML = 1;
-    static final int ENCODE_XML = 2;
-    static final int ENCODE_FORM = 3;
-    static final int ENCODE_URL = 4;
-    static final int ENCODE_ALL = 5;
+        sandbox.add(macroname);
+    }
 
     class Macro {
-
-	final int start, end;
+        final int start;
+        final int end;
         String handler;
         String name;
         String fullName;
@@ -177,158 +201,204 @@ public final class Skin {
         int encoding = ENCODE_NONE;
         Map parameters = null;
 
-	public Macro (int start, int end) {
-
+        public Macro(int start, int end) {
             this.start = start;
             this.end = end;
+
             int state = HANDLER;
             boolean escape = false;
             char quotechar = '\u0000';
             String lastParamName = null;
             StringBuffer b = new StringBuffer();
 
-	    for (int i=start+2; i<end-2; i++) {
+            for (int i = start + 2; i < (end - 2); i++) {
                 switch (source[i]) {
                     case '.':
+
                         if (state == HANDLER) {
-	                    handler = b.toString ().trim();
-	                    b.setLength (0);
+                            handler = b.toString().trim();
+                            b.setLength(0);
                             state = MACRO;
-	                } else
-	                    b.append (source[i]);
+                        } else {
+                            b.append(source[i]);
+                        }
+
                         break;
+
                     case '\\':
-	                if (escape)
-	                    b.append (source[i]);
+
+                        if (escape) {
+                            b.append(source[i]);
+                        }
+
                         escape = !escape;
+
                         break;
+
                     case '"':
                     case '\'':
-	                if (!escape && state == PARAMVALUE) {
+
+                        if (!escape && (state == PARAMVALUE)) {
                             if (quotechar == source[i]) {
                                 String paramValue = b.toString();
-	                        if (!setSpecialParameter (lastParamName, paramValue))
-	                            addGenericParameter (lastParamName, paramValue);
+
+                                if (!setSpecialParameter(lastParamName, paramValue)) {
+                                    addGenericParameter(lastParamName, paramValue);
+                                }
+
                                 lastParamName = null;
-	                        b.setLength (0);
+                                b.setLength(0);
                                 state = PARAMNAME;
                                 quotechar = '\u0000';
                             } else if (quotechar == '\u0000') {
                                 quotechar = source[i];
-	                        b.setLength (0);
-	                    } else
-	                        b.append (source[i]);
-	                } else
-	                    b.append (source[i]);
+                                b.setLength(0);
+                            } else {
+                                b.append(source[i]);
+                            }
+                        } else {
+                            b.append(source[i]);
+                        }
+
                         escape = false;
+
                         break;
+
                     case ' ':
                     case '\t':
                     case '\n':
                     case '\r':
                     case '\f':
-	                if (state == MACRO || (state == HANDLER && b.length() > 0)) {
+
+                        if ((state == MACRO) || ((state == HANDLER) && (b.length() > 0))) {
                             name = b.toString().trim();
-	                    b.setLength (0);
+                            b.setLength(0);
                             state = PARAMNAME;
-	                } else if (state == PARAMVALUE && quotechar == '\u0000') {
+                        } else if ((state == PARAMVALUE) && (quotechar == '\u0000')) {
                             String paramValue = b.toString();
-	                    if (!setSpecialParameter (lastParamName, paramValue))
-	                        addGenericParameter (lastParamName, paramValue);
+
+                            if (!setSpecialParameter(lastParamName, paramValue)) {
+                                addGenericParameter(lastParamName, paramValue);
+                            }
+
                             lastParamName = null;
-	                    b.setLength (0);
+                            b.setLength(0);
                             state = PARAMNAME;
-	                } else if (state == PARAMVALUE)
-	                    b.append (source[i]);
-	                else
-	                    b.setLength (0);
+                        } else if (state == PARAMVALUE) {
+                            b.append(source[i]);
+                        } else {
+                            b.setLength(0);
+                        }
+
                         break;
+
                     case '=':
+
                         if (state == PARAMNAME) {
                             lastParamName = b.toString().trim();
-	                    b.setLength (0);
+                            b.setLength(0);
                             state = PARAMVALUE;
-	                } else
-	                    b.append (source[i]);
+                        } else {
+                            b.append(source[i]);
+                        }
+
                         break;
+
                     default:
-	                b.append (source[i]);
+                        b.append(source[i]);
                         escape = false;
                 }
             }
+
             if (b.length() > 0) {
-	        if (lastParamName != null && b.length() > 0) {
+                if ((lastParamName != null) && (b.length() > 0)) {
                     String paramValue = b.toString();
-	            if (!setSpecialParameter (lastParamName, paramValue))
-	                addGenericParameter (lastParamName, paramValue);
-	        } else if (state <= MACRO)
+
+                    if (!setSpecialParameter(lastParamName, paramValue)) {
+                        addGenericParameter(lastParamName, paramValue);
+                    }
+                } else if (state <= MACRO) {
                     name = b.toString().trim();
                 }
-	    if (handler == null)
+            }
+
+            if (handler == null) {
                 fullName = name;
-	    else
-	        fullName = handler+"."+name;
-
+            } else {
+                fullName = handler + "." + name;
+            }
         }
 
-
-	private boolean setSpecialParameter (String name, String value) {
-	    if ("prefix".equals (name)) {
+        private boolean setSpecialParameter(String name, String value) {
+            if ("prefix".equals(name)) {
                 prefix = value;
+
                 return true;
-	    } else if ("suffix".equals (name)) {
+            } else if ("suffix".equals(name)) {
                 suffix = value;
+
                 return true;
-	    } else if ("encoding".equals (name)) {
-	        if ("html".equalsIgnoreCase (value))
+            } else if ("encoding".equals(name)) {
+                if ("html".equalsIgnoreCase(value)) {
                     encoding = ENCODE_HTML;
-	        else if ("xml".equalsIgnoreCase (value))
+                } else if ("xml".equalsIgnoreCase(value)) {
                     encoding = ENCODE_XML;
-	        else if ("form".equalsIgnoreCase (value))
+                } else if ("form".equalsIgnoreCase(value)) {
                     encoding = ENCODE_FORM;
-	        else if ("url".equalsIgnoreCase (value))
+                } else if ("url".equalsIgnoreCase(value)) {
                     encoding = ENCODE_URL;
-	        else if ("all".equalsIgnoreCase (value))
+                } else if ("all".equalsIgnoreCase(value)) {
                     encoding = ENCODE_ALL;
+                }
+
                 return true;
-	    } else if ("default".equals (name)) {
+            } else if ("default".equals(name)) {
                 defaultValue = value;
+
                 return true;
             }
+
             return false;
         }
 
-	private void addGenericParameter (String name, String value) {
-	    if (parameters == null)
-	        parameters = new HashMap ();
-	    parameters.put (name, value);
+        private void addGenericParameter(String name, String value) {
+            if (parameters == null) {
+                parameters = new HashMap();
+            }
+
+            parameters.put(name, value);
         }
 
         /**
          *  Render the macro given a handler object
          */
-	public void render (RequestEvaluator reval, Object thisObject, Map paramObject, Map handlerCache) throws RedirectException {
+        public void render(RequestEvaluator reval, Object thisObject, Map paramObject,
+                           Map handlerCache) throws RedirectException {
+            if ((sandbox != null) && !sandbox.contains(fullName)) {
+                String h = (handler == null) ? "global" : handler;
+
+                reval.res.write("[Macro " + fullName + " not allowed in sandbox]");
 
-	    if (sandbox != null && !sandbox.contains (fullName)) {
-	        String h = handler == null ? "global" : handler;
-	        reval.res.write ("[Macro "+fullName+" not allowed in sandbox]");
                 return;
-	    } else if ("response".equalsIgnoreCase (handler)) {
-	        renderFromResponse (reval);
+            } else if ("response".equalsIgnoreCase(handler)) {
+                renderFromResponse(reval);
+
                 return;
-	    } else if ("request".equalsIgnoreCase (handler)) {
-	        renderFromRequest (reval);
+            } else if ("request".equalsIgnoreCase(handler)) {
+                renderFromRequest(reval);
+
                 return;
-	    } else if ("param".equalsIgnoreCase (handler)) {
-	        renderFromParam (reval, paramObject);
+            } else if ("param".equalsIgnoreCase(handler)) {
+                renderFromParam(reval, paramObject);
+
                 return;
-	    } else if ("session".equalsIgnoreCase (handler)) {
-	        renderFromSession (reval);
+            } else if ("session".equalsIgnoreCase(handler)) {
+                renderFromSession(reval);
+
                 return;
             }
 
             try {
-
                 Object handlerObject = null;
 
                 // flag to tell whether we found our invocation target object
@@ -336,26 +406,31 @@ public final class Skin {
 
                 if (handler != null) {
                     // try to get handler from handlerCache first
-	            if (handlerCache != null)
-	                handlerObject = handlerCache.get (handler);
+                    if (handlerCache != null) {
+                        handlerObject = handlerCache.get(handler);
+                    }
 
                     if (handlerObject == null) {
-
                         // if handler object wasn't found in cache retrieve it
-	                if (handlerObject == null && thisObject != null) {
+                        if ((handlerObject == null) && (thisObject != null)) {
                             // not a global macro - need to find handler object
                             // was called with this object - check it or its parents for matching prototype
-	                    if (!handler.equals ("this") && !handler.equals (app.getPrototypeName (thisObject))) {
+                            if (!handler.equals("this") &&
+                                    !handler.equals(app.getPrototypeName(thisObject))) {
                                 // the handler object is not what we want
                                 Object n = thisObject;
+
                                 // walk down parent chain to find handler object
                                 while (n != null) {
-	                            Prototype proto = app.getPrototype (n);
-	                            if (proto != null && proto.isInstanceOf (handler)) {
+                                    Prototype proto = app.getPrototype(n);
+
+                                    if ((proto != null) && proto.isInstanceOf(handler)) {
                                         handlerObject = n;
+
                                         break;
                                     }
-	                            n = app.getParentElement (n);
+
+                                    n = app.getParentElement(n);
                                 }
                             } else {
                                 // we already have the right handler object
@@ -367,17 +442,18 @@ public final class Skin {
                             // eiter because thisObject == null or the right object wasn't found 
                             // in the object's parent path. Check if a matching macro handler
                             // is registered with the response object (res.handlers).
-	                    handlerObject = reval.res.getMacroHandlers().get (handler);
+                            handlerObject = reval.res.getMacroHandlers().get(handler);
                         }
 
                         // the macro handler object couldn't be found
-	                if (handlerObject == null)
+                        if (handlerObject == null) {
                             objectFound = false;
-	                // else put the found handler object into the cache so we don't have to look again
-	                else if (handlerCache != null)
-	                    handlerCache.put (handler, handlerObject);
                         }
-
+                        // else put the found handler object into the cache so we don't have to look again
+                        else if (handlerCache != null) {
+                            handlerCache.put(handler, handlerObject);
+                        }
+                    }
                 } else {
                     // this is a global macro with no handler specified
                     handlerObject = null;
@@ -387,17 +463,19 @@ public final class Skin {
                     // check if a function called name_macro is defined.
                     // if so, the macro evaluates to the function. Otherwise,
                     // a property/field with the name is used, if defined.
+                    String funcName = name + "_macro";
 
-	            String funcName = name+"_macro";
-	            if (reval.scriptingEngine.hasFunction (handlerObject, funcName)) {
-	                
+                    if (reval.scriptingEngine.hasFunction(handlerObject, funcName)) {
                         StringBuffer buffer = reval.res.getBuffer();
+
                         // remember length of response buffer before calling macro
                         int bufLength = buffer.length();
+
                         // remember length of buffer with prefix written out
                         int preLength = 0;
+
                         if (prefix != null) {
-	                    buffer.append (prefix);
+                            buffer.append(prefix);
                             preLength = prefix.length();
                         }
 
@@ -406,43 +484,52 @@ public final class Skin {
                         // Map param = ;
                         // if (parameters == null)
                         //     parameters = new HashMap ();
-	                Object[] arguments = { parameters == null ?
-	                    new HashMap () :
-	                    new HashMap (parameters)
+                        Object[] arguments = {
+                                                 (parameters == null) ? new HashMap()
+                                                                      : new HashMap(parameters)
                                              };
 
-	                Object value = reval.scriptingEngine.invoke (handlerObject, funcName, arguments, false);
+                        Object value = reval.scriptingEngine.invoke(handlerObject,
+                                                                    funcName, arguments,
+                                                                    false);
 
                         // check if macro wrote out to response buffer
-	                if (buffer.length () == bufLength + preLength) {
+                        if (buffer.length() == (bufLength + preLength)) {
                             // function didn't write out anything itself. 
                             // erase previously written prefix
-	                    if (preLength > 0)
-	                        buffer.setLength (bufLength);
+                            if (preLength > 0) {
+                                buffer.setLength(bufLength);
+                            }
+
                             // write out macro's return value
-	                    writeResponse (value, buffer, true);
+                            writeResponse(value, buffer, true);
                         } else {
                             if (encoding != ENCODE_NONE) {
                                 // if an encoding is specified, re-encode the macro's output
-	                        String output = buffer.substring (bufLength + preLength);
-	                        buffer.setLength (bufLength);
-	                        writeResponse (output, buffer, false);
+                                String output = buffer.substring(bufLength + preLength);
+
+                                buffer.setLength(bufLength);
+                                writeResponse(output, buffer, false);
                             } else {
                                 // no re-encoding needed, just append suffix
-	                        if (suffix != null)
-	                            buffer.append (suffix);
+                                if (suffix != null) {
+                                    buffer.append(suffix);
                                 }
-	                    writeResponse (value, buffer, false);
+                            }
+
+                            writeResponse(value, buffer, false);
                         }
                     } else {
                         // System.err.println ("Getting macro from property");
-	                Object value = reval.scriptingEngine.get (handlerObject, name);
-	                writeResponse (value, reval.res.getBuffer(), true);
+                        Object value = reval.scriptingEngine.get(handlerObject, name);
+
+                        writeResponse(value, reval.res.getBuffer(), true);
                     }
                 } else {
-	            String msg = "[HopMacro unhandled: "+fullName+"]";
-	            reval.res.write (" "+msg+" ");
-	            app.logEvent (msg);
+                    String msg = "[HopMacro unhandled: " + fullName + "]";
+
+                    reval.res.write(" " + msg + " ");
+                    app.logEvent(msg);
                 }
             } catch (RedirectException redir) {
                 throw redir;
@@ -453,104 +540,131 @@ public final class Skin {
             } catch (Exception x) {
                 // x.printStackTrace();
                 String msg = x.getMessage();
-	        if (msg == null || msg.length() < 10)
+
+                if ((msg == null) || (msg.length() < 10)) {
                     msg = x.toString();
-	        msg = "[HopMacro error in "+fullName+": "+msg+"]";
-	        reval.res.write (" "+msg+" ");
-	        app.logEvent (msg);
+                }
+
+                msg = "[HopMacro error in " + fullName + ": " + msg + "]";
+                reval.res.write(" " + msg + " ");
+                app.logEvent(msg);
             }
         }
 
-	private void renderFromResponse (RequestEvaluator reval) {
+        private void renderFromResponse(RequestEvaluator reval) {
             Object value = null;
-	    if ("message".equals (name))  
+
+            if ("message".equals(name)) {
                 value = reval.res.message;
-	    else if ("error".equals (name))  
+            } else if ("error".equals(name)) {
                 value = reval.res.error;
-	    if (value == null)  
-	        value = reval.res.get (name);
-	    writeResponse (value, reval.res.getBuffer(), true);
             }
 
-	private void renderFromRequest (RequestEvaluator reval) {
-	    if (reval.req == null)
+            if (value == null) {
+                value = reval.res.get(name);
+            }
+
+            writeResponse(value, reval.res.getBuffer(), true);
+        }
+
+        private void renderFromRequest(RequestEvaluator reval) {
+            if (reval.req == null) {
                 return;
-	    Object value = reval.req.get (name);
-	    writeResponse (value, reval.res.getBuffer(), true);
             }
 
-	private void renderFromSession (RequestEvaluator reval) {
-	    if (reval.session == null)
+            Object value = reval.req.get(name);
+
+            writeResponse(value, reval.res.getBuffer(), true);
+        }
+
+        private void renderFromSession(RequestEvaluator reval) {
+            if (reval.session == null) {
                 return;
-	    Object value = reval.session.getCacheNode().getString (name);
-	    writeResponse (value, reval.res.getBuffer(), true);
             }
 
-	private void renderFromParam (RequestEvaluator reval, Map paramObject) {
-	    if (paramObject == null)
-	        reval.res.write ("[HopMacro error: Skin requires a parameter object]");
-	    else {
-	        Object value = paramObject.get (name);
-	        writeResponse (value, reval.res.getBuffer(), true);
+            Object value = reval.session.getCacheNode().getString(name);
+
+            writeResponse(value, reval.res.getBuffer(), true);
+        }
+
+        private void renderFromParam(RequestEvaluator reval, Map paramObject) {
+            if (paramObject == null) {
+                reval.res.write("[HopMacro error: Skin requires a parameter object]");
+            } else {
+                Object value = paramObject.get(name);
+
+                writeResponse(value, reval.res.getBuffer(), true);
             }
         }
 
         /**
          * Utility method for writing text out to the response object.
          */
-	void writeResponse (Object value, StringBuffer buffer, boolean useDefault) {
+        void writeResponse(Object value, StringBuffer buffer, boolean useDefault) {
             String text;
+
             if (value == null) {
-	        if (useDefault)
+                if (useDefault) {
                     text = defaultValue;
-	        else
-	            return;
                 } else {
-	        text = value.toString ();
+                    return;
                 }
-	    if (text != null && text.length() > 0) {
-	        if (prefix != null)
-	            buffer.append (prefix);
+            } else {
+                text = value.toString();
+            }
+
+            if ((text != null) && (text.length() > 0)) {
+                if (prefix != null) {
+                    buffer.append(prefix);
+                }
+
                 switch (encoding) {
                     case ENCODE_NONE:
-	                buffer.append (text);
+                        buffer.append(text);
+
                         break;
+
                     case ENCODE_HTML:
-	                HtmlEncoder.encode (text, buffer);
+                        HtmlEncoder.encode(text, buffer);
+
                         break;
+
                     case ENCODE_XML:
-	                HtmlEncoder.encodeXml (text, buffer);
+                        HtmlEncoder.encodeXml(text, buffer);
+
                         break;
+
                     case ENCODE_FORM:
-	                HtmlEncoder.encodeFormValue (text, buffer);
+                        HtmlEncoder.encodeFormValue(text, buffer);
+
                         break;
+
                     case ENCODE_URL:
-	                buffer.append (URLEncoder.encode (text));
+                        buffer.append(URLEncoder.encode(text));
+
                         break;
+
                     case ENCODE_ALL:
-	                HtmlEncoder.encodeAll (text, buffer);
+                        HtmlEncoder.encodeAll(text, buffer);
+
                         break;
                 }
-	        if (suffix != null)
-	            buffer.append (suffix);
+
+                if (suffix != null) {
+                    buffer.append(suffix);
+                }
             }
         }
 
-
-	public String toString () {
-	    return "[HopMacro: "+fullName+"]";
+        public String toString() {
+            return "[HopMacro: " + fullName + "]";
         }
 
-
         /**
          * Return the full name of the macro in handler.name notation
          */
-	public String getFullName () {
+        public String getFullName() {
             return fullName;
         }
-
     }
-
 }
-
-

src/helma/framework/core/SkinFile.java

@@ -1,20 +1,29 @@
-// SkinFile.java
-// Copyright (c) Hannes Wallnöfer 2001
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework.core;
 
-import java.util.*;
-import java.io.*;
 import helma.util.Updatable;
-
+import java.io.*;
+import java.util.*;
 
 /**
  * This represents a File containing a Hop skin
  */
-
-
 public final class SkinFile implements Updatable {
-
     String name;
     Prototype prototype;
     Application app;
@@ -22,7 +31,14 @@ public final class SkinFile implements Updatable {
     Skin skin;
     long lastmod = 0;
 
-    public SkinFile (File file, String name, Prototype proto) {
+    /**
+     * Creates a new SkinFile object.
+     *
+     * @param file ...
+     * @param name ...
+     * @param proto ...
+     */
+    public SkinFile(File file, String name, Prototype proto) {
         this.prototype = proto;
         this.file = file;
         this.name = name;
@@ -35,19 +51,19 @@ public final class SkinFile implements Updatable {
      * Skins contained in zipped applications. The whole update mechanism is bypassed
      *  by immediately setting the skin member.
      */
-    public SkinFile (String body, String name, Prototype proto) {
+    public SkinFile(String body, String name, Prototype proto) {
         this.prototype = proto;
         this.app = proto.app;
         this.name = name;
         this.file = null;
-	skin = new Skin (body, app);
+        skin = new Skin(body, app);
     }
 
     /**
      * Create a skinfile that doesn't belong to a prototype, or at
      * least it doesn't know about its prototype and isn't managed by the prototype.
      */
-    public SkinFile (File file, String name, Application app) {
+    public SkinFile(File file, String name, Application app) {
         this.app = app;
         this.file = file;
         this.name = name;
@@ -55,68 +71,93 @@ public final class SkinFile implements Updatable {
         skin = null;
     }
 
-
     /**
      * Tell the type manager whether we need an update. this is the case when
      * the file has been modified or deleted.
      */
-    public boolean needsUpdate () {
+    public boolean needsUpdate() {
         // if skin object is null we only need to call update if the file doesn't 
         // exist anymore, while if the skin is initialized, we'll catch both 
         // cases (file deleted and file changed) by just calling lastModified().
-	return skin != null ? lastmod != file.lastModified () : !file.exists ();
+        return (skin != null) ? (lastmod != file.lastModified()) : (!file.exists());
     }
 
-
-    public void update () {
-	if (!file.exists ()) {
+    /**
+     *
+     */
+    public void update() {
+        if (!file.exists()) {
             // remove skin from  prototype
-	    remove ();
+            remove();
         } else {
             // we only need to update if the skin has already been initialized
-	    if (skin != null)
-	        read ();
+            if (skin != null) {
+                read();
+            }
         }
     }
 
-    private void read () {
+    private void read() {
         try {
-	    FileReader reader = new FileReader (file);
-	    char c[] = new char[(int) file.length()];
-	    int length = reader.read (c);
+            FileReader reader = new FileReader(file);
+            char[] c = new char[(int) file.length()];
+            int length = reader.read(c);
+
             reader.close();
-	    skin = new Skin (c, length, app);
+            skin = new Skin(c, length, app);
         } catch (IOException x) {
-	    app.logEvent ("Error reading Skin "+file+": "+x);
-	}
-	lastmod = file.lastModified ();
+            app.logEvent("Error reading Skin " + file + ": " + x);
         }
 
-    public void remove () {
+        lastmod = file.lastModified();
+    }
+
+    /**
+     *
+     */
+    public void remove() {
         if (prototype != null) {
-	    prototype.removeSkinFile (this);
+            prototype.removeSkinFile(this);
         }
     }
 
-
-    public File getFile () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public File getFile() {
         return file;
     }
 
-    public Skin getSkin () {
-	if (skin == null)
-	    read ();
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Skin getSkin() {
+        if (skin == null) {
+            read();
+        }
+
         return skin;
     }
 
-    public String getName () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getName() {
         return name;
     }
 
-    public String toString () {
-	return prototype.getName()+"/"+file.getName();
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String toString() {
+        return prototype.getName() + "/" + file.getName();
     }
-
 }
-
-

src/helma/framework/core/SkinManager.java

@@ -1,107 +1,140 @@
-// SkinManager.java
-// Copyright (c) Hannes Wallnöfer 2002
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework.core;
 
-import java.util.*;
 import helma.objectmodel.INode;
 import java.io.*;
-
+import java.util.*;
 
 /**
  * Manages skins for a Helma application
  */
-
-
 public final class SkinManager implements FilenameFilter {
-
     Application app;
 
-    public SkinManager (Application app) {
+    /**
+     * Creates a new SkinManager object.
+     *
+     * @param app ...
+     */
+    public SkinManager(Application app) {
         this.app = app;
     }
 
-
-    protected Skin getSkin (Prototype proto, String skinname, Object[] skinpath) {
-	if (proto == null)
+    protected Skin getSkin(Prototype proto, String skinname, Object[] skinpath) {
+        if (proto == null) {
             return null;
+        }
+
         Skin skin = null;
+
         // First check if the skin has been already used within the execution of this request
         // check for skinsets set via res.skinpath property
         do {
             if (skinpath != null) {
-	        for (int i=0; i<skinpath.length; i++) {
-	            skin = getSkinInternal (skinpath[i], proto.getName (), skinname);
+                for (int i = 0; i < skinpath.length; i++) {
+                    skin = getSkinInternal(skinpath[i], proto.getName(), skinname);
+
                     if (skin != null) {
                         return skin;
                     }
                 }
             }
+
             // skin for this prototype wasn't found in the skinsets.
             // the next step is to look if it is defined as skin file in the application directory
-	    skin = proto.getSkin (skinname);
+            skin = proto.getSkin(skinname);
+
             if (skin != null) {
                 return skin;
             }
+
             // still not found. See if there is a parent prototype which might define the skin.
-	    proto = proto.getParentPrototype ();
+            proto = proto.getParentPrototype();
         } while (proto != null);
+
         // looked every where, nothing to be found
         return null;
     }
 
-
-    protected Skin getSkinInternal (Object skinset, String prototype, String skinname) {
-	if (prototype == null || skinset == null)
+    protected Skin getSkinInternal(Object skinset, String prototype, String skinname) {
+        if ((prototype == null) || (skinset == null)) {
             return null;
+        }
+
         // check if the skinset object is a HopObject (db based skin)
         // or a String (file based skin)
         if (skinset instanceof INode) {
-	    INode n = ((INode) skinset).getNode (prototype);
+            INode n = ((INode) skinset).getNode(prototype);
+
             if (n != null) {
-	        n = n.getNode (skinname);
+                n = n.getNode(skinname);
+
                 if (n != null) {
-	            String skin = n.getString ("skin");
+                    String skin = n.getString("skin");
+
                     if (skin != null) {
-	                return new Skin (skin, app);
+                        return new Skin(skin, app);
                     }
                 }
             }
         } else {
             // Skinset is interpreted as directory name from which to
             // retrieve the skin
-	    File f = new File (skinset.toString (), prototype);
-	    f = new File (f, skinname+".skin");
+            File f = new File(skinset.toString(), prototype);
+
+            f = new File(f, skinname + ".skin");
+
             if (f.exists() && f.canRead()) {
-	        SkinFile sf = new SkinFile (f, skinname, app);
-	        return sf.getSkin ();
+                SkinFile sf = new SkinFile(f, skinname, app);
+
+                return sf.getSkin();
             }
         }
+
         // Inheritance is taken care of in the above getSkin method.
         // the sequence is prototype.skin-from-db, prototype.skin-from-file, parent.from-db, parent.from-file etc.
         return null;
     }
 
+    protected Map getSkinFiles(String skinDir, Prototype proto) {
+        File dir = new File(skinDir.toString(), proto.getName());
+        String[] skinNames = dir.list(this);
 
-    protected Map getSkinFiles (String skinDir, Prototype proto) {
-	File dir = new File (skinDir.toString (), proto.getName ());
-	String[] skinNames = dir.list (this);
-	if (skinNames == null || skinNames.length == 0)
+        if ((skinNames == null) || (skinNames.length == 0)) {
             return null;
-	HashMap map = new HashMap ();
-	for (int i=0; i<skinNames.length; i++) {
-	    String name = skinNames[i].substring (0, skinNames[i].length()-5);
-	    File file = new File (dir, skinNames[i]);
-	    map.put (name, new SkinFile(file, name, proto));
         }
+
+        HashMap map = new HashMap();
+
+        for (int i = 0; i < skinNames.length; i++) {
+            String name = skinNames[i].substring(0, skinNames[i].length() - 5);
+            File file = new File(dir, skinNames[i]);
+
+            map.put(name, new SkinFile(file, name, proto));
+        }
+
         return map;
     }
 
     /**
      * Implements java.io.FilenameFilter.accept()
      */
-    public boolean accept (File d, String n) {
-	return n.endsWith (".skin");
+    public boolean accept(File d, String n) {
+        return n.endsWith(".skin");
     }
-
 }

src/helma/framework/core/TypeManager.java

@@ -1,5 +1,18 @@
-// TypeManager.java
-// Copyright (c) Hannes Wallnöfer 1998-2000
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework.core;
 
@@ -7,19 +20,22 @@ import helma.objectmodel.*;
 import helma.objectmodel.db.DbMapping;
 import helma.scripting.*;
 import helma.util.*;
-import java.util.*;
 import java.io.*;
+import java.net.MalformedURLException;
 import java.net.URL;
 import java.net.URLClassLoader;
-import java.net.MalformedURLException;
+import java.util.*;
 
 /**
  * The type manager periodically checks the prototype definitions for its
  * applications and updates the evaluators if anything has changed.
  */
-
 public final class TypeManager {
-
+    final static String[] standardTypes = { "user", "global", "root", "hopobject" };
+    final static String templateExtension = ".hsp";
+    final static String scriptExtension = ".js";
+    final static String actionExtension = ".hac";
+    final static String skinExtension = ".skin";
     Application app;
     File appDir;
     HashMap prototypes; // map of prototypes
@@ -27,128 +43,166 @@ public final class TypeManager {
     HashSet jarfiles; // set of Java archives
     long lastCheck = 0;
     long appDirMod = 0;
+
     // a checksum that changes whenever something in the application files changes.
     long checksum;
 
     // the hopobject prototype
     Prototype hopobjectProto;
+
     // the global prototype
     Prototype globalProto;
 
     // app specific class loader, includes jar files in the app directory
     AppClassLoader loader;
 
-    final static String[] standardTypes = {"user", "global", "root", "hopobject"};
-
-    final static String templateExtension = ".hsp";
-    final static String scriptExtension = ".js";
-    final static String actionExtension = ".hac";
-    final static String skinExtension = ".skin";
-
-    public TypeManager (Application app) throws MalformedURLException {
+    /**
+     * Creates a new TypeManager object.
+     *
+     * @param app ...
+     *
+     * @throws MalformedURLException ...
+     * @throws RuntimeException ...
+     */
+    public TypeManager(Application app) throws MalformedURLException {
         this.app = app;
         appDir = app.appDir;
+
         // make sure the directories for the standard prototypes exist, and lament otherwise
         if (appDir.list().length == 0) {
-            for (int i=0; i<standardTypes.length; i++) {
-                File f = new File (appDir, standardTypes[i]);
-                if (!f.exists() && !f.mkdir ())
-                    app.logEvent ("Warning: directory "+f.getAbsolutePath ()+" could not be created.");
-                else if (!f.isDirectory ())
-                    app.logEvent ("Warning: "+f.getAbsolutePath ()+" is not a directory.");
+            for (int i = 0; i < standardTypes.length; i++) {
+                File f = new File(appDir, standardTypes[i]);
+
+                if (!f.exists() && !f.mkdir()) {
+                    app.logEvent("Warning: directory " + f.getAbsolutePath() +
+                                 " could not be created.");
+                } else if (!f.isDirectory()) {
+                    app.logEvent("Warning: " + f.getAbsolutePath() +
+                                 " is not a directory.");
                 }
             }
-        prototypes = new HashMap ();
-        zipfiles = new HashMap ();
-        jarfiles = new HashSet ();
+        }
+
+        prototypes = new HashMap();
+        zipfiles = new HashMap();
+        jarfiles = new HashSet();
+
         URL[] urls = ((URLClassLoader) TypeManager.class.getClassLoader()).getURLs();
         URL helmajar = null;
-        for (int i=0; i<urls.length; i++) {
+
+        for (int i = 0; i < urls.length; i++) {
             String url = urls[i].toString().toLowerCase();
-            if (url.endsWith ("helma.jar")) {
+
+            if (url.endsWith("helma.jar")) {
                 helmajar = urls[i];
+
                 break;
             }
         }
-        if (helmajar == null) 
-            throw new RuntimeException ("helma.jar not found in embedding classpath");
-        loader = new AppClassLoader(app.getName(), new URL[] { helmajar });
+
+        if (helmajar == null) {
+            throw new RuntimeException("helma.jar not found in embedding classpath");
         }
 
+        loader = new AppClassLoader(app.getName(), new URL[] { helmajar });
+    }
 
     /**
      * Run through application's prototype directories and create prototypes, but don't
      * compile or evaluate any scripts.
      */
-    public void createPrototypes () {
+    public void createPrototypes() {
         // create standard prototypes.
-        createPrototype ("root");
-        createPrototype ("user");
+        createPrototype("root");
+        createPrototype("user");
+
         // get references to hopobject and global protos,
         // since we need it regularly when setting parent prototypes.
-        hopobjectProto = createPrototype ("hopobject");
-        globalProto = createPrototype ("global");
-        // loop through directories and create prototypes
-        checkFiles ();
-    }
+        hopobjectProto = createPrototype("hopobject");
+        globalProto = createPrototype("global");
 
+        // loop through directories and create prototypes
+        checkFiles();
+    }
 
     /**
      * Run through application's prototype directories and check if anything has been updated.
      * If so, update prototypes and scripts.
      */
-    public synchronized void checkPrototypes () {
-	if (System.currentTimeMillis () - lastCheck  < 1000l)
+    public synchronized void checkPrototypes() {
+        if ((System.currentTimeMillis() - lastCheck) < 1000L) {
             return;
+        }
+
         try {
-	    checkFiles ();
-	} catch (Exception ignore) {}
-	lastCheck = System.currentTimeMillis ();
+            checkFiles();
+        } catch (Exception ignore) {
+        }
+
+        lastCheck = System.currentTimeMillis();
     }
 
     /**
      * Run through application's prototype directories and check if
      * there are any prototypes to be created.
      */
-    public void checkFiles () {
+    public void checkFiles() {
         // check if any files have been created/removed since last time we
         // checked...
         if (appDir.lastModified() > appDirMod) {
-	    appDirMod = appDir.lastModified ();
-	    String[] list = appDir.list ();
-	    if (list == null)
-	        throw new RuntimeException ("Can't read app directory "+appDir+" - check permissions");
-	    for (int i=0; i<list.length; i++) {
-	        if (list[i].endsWith (".zip")) {
-	            ZippedAppFile zipped = (ZippedAppFile) zipfiles.get (list[i]);
+            appDirMod = appDir.lastModified();
+
+            String[] list = appDir.list();
+
+            if (list == null) {
+                throw new RuntimeException("Can't read app directory " + appDir +
+                                           " - check permissions");
+            }
+
+            for (int i = 0; i < list.length; i++) {
+                if (list[i].endsWith(".zip")) {
+                    ZippedAppFile zipped = (ZippedAppFile) zipfiles.get(list[i]);
+
                     if (zipped == null) {
-	                File f = new File (appDir, list[i]);
-	                if (!f.isDirectory ()) {
-	                    zipped = new ZippedAppFile (f, app);
-	                    zipfiles.put (list[i], zipped);
+                        File f = new File(appDir, list[i]);
+
+                        if (!f.isDirectory()) {
+                            zipped = new ZippedAppFile(f, app);
+                            zipfiles.put(list[i], zipped);
                         }
                     }
+
                     continue;
                 }
-	        if (list[i].endsWith (".jar")) {
-	            if (!jarfiles.contains (list[i])) {
-	                jarfiles.add (list[i]);
-	                File f = new File (appDir, list[i]);
+
+                if (list[i].endsWith(".jar")) {
+                    if (!jarfiles.contains(list[i])) {
+                        jarfiles.add(list[i]);
+
+                        File f = new File(appDir, list[i]);
+
                         try {
-	                    loader.addURL (new URL ("file:"+f.getAbsolutePath()));
-	                } catch (MalformedURLException ignore) {}
+                            loader.addURL(new URL("file:" + f.getAbsolutePath()));
+                        } catch (MalformedURLException ignore) {
                         }
+                    }
+
                     continue;
                 }
-	        if (list[i].indexOf ('.') > -1)
+
+                if (list[i].indexOf('.') > -1) {
                     continue;
-	        Prototype proto = getPrototype (list[i]);
+                }
+
+                Prototype proto = getPrototype(list[i]);
+
                 // if prototype doesn't exist, create it
-	        if (proto == null  && isValidTypeName (list[i])) {
-	            File f = new File (appDir, list[i]);
-	            if (f.isDirectory ()) {
+                if ((proto == null) && isValidTypeName(list[i])) {
+                    File f = new File(appDir, list[i]);
+
+                    if (f.isDirectory()) {
                         // create new prototype
-	                createPrototype (list[i], f);
+                        createPrototype(list[i], f);
                     }
                 }
             }
@@ -158,57 +212,73 @@ public final class TypeManager {
         long newChecksum = 0;
 
         // loop through zip files to check for updates
-	for (Iterator it=zipfiles.values ().iterator (); it.hasNext (); ) {
-	    ZippedAppFile zipped = (ZippedAppFile) it.next ();
-	    if (zipped.needsUpdate ()) {
-	        zipped.update ();
+        for (Iterator it = zipfiles.values().iterator(); it.hasNext();) {
+            ZippedAppFile zipped = (ZippedAppFile) it.next();
+
+            if (zipped.needsUpdate()) {
+                zipped.update();
             }
+
             newChecksum += zipped.lastmod;
         }
 
         // loop through prototypes and check if type.properties needs updates
         // it's important that we do this _after_ potentially new prototypes
         // have been created in the previous loop.
-	for (Iterator i=prototypes.values().iterator(); i.hasNext(); ) {
-	    Prototype proto = (Prototype) i.next ();
+        for (Iterator i = prototypes.values().iterator(); i.hasNext();) {
+            Prototype proto = (Prototype) i.next();
+
             // calculate this app's type checksum
             newChecksum += proto.getChecksum();
+
             // update prototype's type mapping
-	    DbMapping dbmap = proto.getDbMapping ();
-	    if (dbmap != null && dbmap.needsUpdate ()) {
-	        dbmap.update ();
-	        if (proto != hopobjectProto && proto != globalProto) {
+            DbMapping dbmap = proto.getDbMapping();
+
+            if ((dbmap != null) && dbmap.needsUpdate()) {
+                dbmap.update();
+
+                if ((proto != hopobjectProto) && (proto != globalProto)) {
                     // set parent prototype, in case it has changed.
-	            String parentName = dbmap.getExtends ();
-	            if (parentName != null)
-	                proto.setParentPrototype (getPrototype (parentName));
-	            else if (!app.isJavaPrototype (proto.getName()))
-	                proto.setParentPrototype (hopobjectProto);
+                    String parentName = dbmap.getExtends();
+
+                    if (parentName != null) {
+                        proto.setParentPrototype(getPrototype(parentName));
+                    } else if (!app.isJavaPrototype(proto.getName())) {
+                        proto.setParentPrototype(hopobjectProto);
                     }
                 }
             }
+        }
+
         checksum = newChecksum;
     }
 
-    protected void removeZipFile (String zipname) {
-	zipfiles.remove (zipname);
-	for (Iterator i=prototypes.values().iterator(); i.hasNext(); ) {
-	    Prototype proto = (Prototype) i.next ();
+    protected void removeZipFile(String zipname) {
+        zipfiles.remove(zipname);
+
+        for (Iterator i = prototypes.values().iterator(); i.hasNext();) {
+            Prototype proto = (Prototype) i.next();
+
             // update prototype's type mapping
-	    DbMapping dbmap = proto.getDbMapping ();
+            DbMapping dbmap = proto.getDbMapping();
             SystemProperties props = dbmap.getProperties();
-	    props.removeProps (zipname);
+
+            props.removeProps(zipname);
         }
     }
 
+    private boolean isValidTypeName(String str) {
+        if (str == null) {
+            return false;
+        }
 
-    private boolean isValidTypeName (String str) {
-	if (str == null)
-	    return false;
-	char[] c = str.toCharArray ();
-	for (int i=0; i<c.length; i++)
-	    if (!Character.isJavaIdentifierPart (c[i]))
+        char[] c = str.toCharArray();
+
+        for (int i = 0; i < c.length; i++)
+            if (!Character.isJavaIdentifierPart(c[i])) {
                 return false;
+            }
+
         return true;
     }
 
@@ -216,15 +286,15 @@ public final class TypeManager {
      *  Return a checksum over all files in all prototypes in this application.
      *  The checksum can be used to find out quickly if any file has changed.
      */
-    public long getChecksum () {
+    public long getChecksum() {
         return checksum;
     }
 
     /**
      *   Get a prototype defined for this application
      */
-    public Prototype getPrototype (String typename) {
-	return (Prototype) prototypes.get (typename);
+    public Prototype getPrototype(String typename) {
+        return (Prototype) prototypes.get(typename);
     }
 
     /**
@@ -232,152 +302,167 @@ public final class TypeManager {
      * that it doesn't create a DbMapping - this is left to the
      * caller (e.g. ZippedAppFile).
      */
-    public Prototype createPrototype (String typename) {
-	return createPrototype (typename, new File (appDir, typename));
+    public Prototype createPrototype(String typename) {
+        return createPrototype(typename, new File(appDir, typename));
     }
 
-
     /**
      *  Create a prototype from a directory containing scripts and other stuff
      */
-    public Prototype createPrototype (String typename, File dir) {
-	Prototype proto = new Prototype (typename, dir, app);
+    public Prototype createPrototype(String typename, File dir) {
+        Prototype proto = new Prototype(typename, dir, app);
+
         // Create and register type properties file
-	File propfile = new File (dir, "type.properties");
-	SystemProperties props = new SystemProperties (propfile.getAbsolutePath ());
-	DbMapping dbmap = new DbMapping (app, typename, props);
+        File propfile = new File(dir, "type.properties");
+        SystemProperties props = new SystemProperties(propfile.getAbsolutePath());
+        DbMapping dbmap = new DbMapping(app, typename, props);
+
         // we don't need to put the DbMapping into proto.updatables, because
         // dbmappings are checked separately in checkFiles for each request
         // proto.updatables.put ("type.properties", dbmap);
-	proto.setDbMapping (dbmap);
+        proto.setDbMapping(dbmap);
+
         // put the prototype into our map
-	prototypes.put (typename, proto);
+        prototypes.put(typename, proto);
+
         return proto;
     }
 
-
     /**
      * Update a prototype to the files in the prototype directory.
      */
-    public void updatePrototype (String name) {
+    public void updatePrototype(String name) {
         // System.err.println ("UPDATE PROTO: "+app.getName()+"/"+name);
-        Prototype proto = getPrototype (name);
-        updatePrototype (proto);
+        Prototype proto = getPrototype(name);
+
+        updatePrototype(proto);
     }
 
     /**
      * Update a prototype to the files in the prototype directory.
      */
-    public void updatePrototype (Prototype proto) {
-        if (proto == null || proto.isUpToDate())
+    public void updatePrototype(Prototype proto) {
+        if ((proto == null) || proto.isUpToDate()) {
             return;
+        }
 
         synchronized (proto) {
             // check again because another thread may have checked the
             // prototype while we were waiting for access to the synchronized section
+
             /* if (System.currentTimeMillis() - proto.getLastCheck() < 1000)
                return; */
-
-            File dir = proto.getDirectory ();
+            File dir = proto.getDirectory();
             HashSet updateSet = null;
             HashSet createSet = null;
 
             // our plan is to do as little as possible, so first check if
             // anything the prototype knows about has changed on disk
-            for (Iterator i = proto.updatables.values().iterator(); i.hasNext(); ) {
+            for (Iterator i = proto.updatables.values().iterator(); i.hasNext();) {
                 Updatable upd = (Updatable) i.next();
-                if (upd.needsUpdate ()) {
-                    if (updateSet == null)
-                        updateSet = new HashSet ();
-                    updateSet.add (upd);
+
+                if (upd.needsUpdate()) {
+                    if (updateSet == null) {
+                        updateSet = new HashSet();
+                    }
+
+                    updateSet.add(upd);
                 }
             }
 
             // next we check if files have been created or removed since last update
             // if (proto.getLastCheck() < dir.lastModified ()) {
             File[] list = proto.getFiles();
-                for (int i=0; i<list.length; i++) {
-                    String fn = list[i].getName();
-                    if (!proto.updatables.containsKey (fn)) {
-                        if (fn.endsWith (templateExtension) ||
-                            fn.endsWith (scriptExtension) ||
-                            fn.endsWith (actionExtension) ||
-                            fn.endsWith (skinExtension) ||
-                            "type.properties".equalsIgnoreCase (fn))
-                        {
-                            if (createSet == null)
-                                createSet = new HashSet ();
-                            createSet.add (list[i]);
-                        }
-                    }
-                }
-            // }
 
+            for (int i = 0; i < list.length; i++) {
+                String fn = list[i].getName();
+
+                if (!proto.updatables.containsKey(fn)) {
+                    if (fn.endsWith(templateExtension) || fn.endsWith(scriptExtension) ||
+                            fn.endsWith(actionExtension) || fn.endsWith(skinExtension) ||
+                            "type.properties".equalsIgnoreCase(fn)) {
+                        if (createSet == null) {
+                            createSet = new HashSet();
+                        }
+
+                        createSet.add(list[i]);
+                    }
+                }
+            }
+
+            // }
             // if nothing needs to be updated, mark prototype as checked and return
-            if (updateSet == null && createSet == null) {
-                proto.markChecked ();
+            if ((updateSet == null) && (createSet == null)) {
+                proto.markChecked();
+
                 return;
             }
 
             // first go through new files and create new items
             if (createSet != null) {
-                Object[] newFiles = createSet.toArray ();
-                for (int i=0; i<newFiles.length; i++) {
+                Object[] newFiles = createSet.toArray();
+
+                for (int i = 0; i < newFiles.length; i++) {
                     File file = (File) newFiles[i];
-                    String filename = file.getName ();
-                    int dot = filename.lastIndexOf (".");
+                    String filename = file.getName();
+                    int dot = filename.lastIndexOf(".");
                     String tmpname = filename.substring(0, dot);
 
-                    if (filename.endsWith (templateExtension)) {
+                    if (filename.endsWith(templateExtension)) {
                         try {
-                            Template t = new Template (file, tmpname, proto);
-                            proto.addTemplate (t);
+                            Template t = new Template(file, tmpname, proto);
+
+                            proto.addTemplate(t);
                         } catch (Throwable x) {
-                            app.logEvent ("Error updating prototype: "+x);
+                            app.logEvent("Error updating prototype: " + x);
                         }
-                    } else if (filename.endsWith (scriptExtension)) {
+                    } else if (filename.endsWith(scriptExtension)) {
                         try {
-                            FunctionFile ff = new FunctionFile (file, proto);
-                            proto.addFunctionFile (ff);
+                            FunctionFile ff = new FunctionFile(file, proto);
+
+                            proto.addFunctionFile(ff);
                         } catch (Throwable x) {
-                            app.logEvent ("Error updating prototype: "+x);
+                            app.logEvent("Error updating prototype: " + x);
                         }
-                    }  else if (filename.endsWith (actionExtension)) {
+                    } else if (filename.endsWith(actionExtension)) {
                         try {
-                            ActionFile af = new ActionFile (file, tmpname, proto);
-                            proto.addActionFile (af);
+                            ActionFile af = new ActionFile(file, tmpname, proto);
+
+                            proto.addActionFile(af);
                         } catch (Throwable x) {
-                            app.logEvent ("Error updating prototype: "+x);
+                            app.logEvent("Error updating prototype: " + x);
                         }
-                    }  else if (filename.endsWith (skinExtension)) {
-                        SkinFile sf = new SkinFile (file, tmpname, proto);
-                        proto.addSkinFile (sf);
+                    } else if (filename.endsWith(skinExtension)) {
+                        SkinFile sf = new SkinFile(file, tmpname, proto);
+
+                        proto.addSkinFile(sf);
                     }
                 }
             }
 
             // next go through existing updatables
             if (updateSet != null) {
-                for (Iterator i = updateSet.iterator(); i.hasNext(); ) {
+                for (Iterator i = updateSet.iterator(); i.hasNext();) {
                     Updatable upd = (Updatable) i.next();
+
                     try {
-                        upd.update ();
+                        upd.update();
                     } catch (Exception x) {
-                         if (upd instanceof DbMapping)
-                            app.logEvent ("Error updating db mapping for type "+proto.getName()+": "+x);
-                         else
-                            app.logEvent ("Error updating "+upd+" of prototye type "+proto.getName()+": "+x);
+                        if (upd instanceof DbMapping) {
+                            app.logEvent("Error updating db mapping for type " +
+                                         proto.getName() + ": " + x);
+                        } else {
+                            app.logEvent("Error updating " + upd + " of prototye type " +
+                                         proto.getName() + ": " + x);
+                        }
                     }
                 }
             }
 
             // mark prototype as checked and updated.
-            proto.markChecked ();
+            proto.markChecked();
             proto.markUpdated();
-
-        } // end of synchronized (proto)
-
         }
-
+         // end of synchronized (proto)
+    }
 }
-

src/helma/framework/core/ZippedAppFile.java

@@ -1,160 +1,208 @@
-// ZippedFile.java
-// Copyright (c) Hannes Wallnöfer 2001
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.framework.core;
 
+import helma.framework.*;
+import helma.objectmodel.db.DbMapping;
+import helma.scripting.*;
+import helma.util.SystemProperties;
+import helma.util.Updatable;
+import java.io.*;
 import java.util.*;
 import java.util.zip.*;
-import java.io.*;
-import helma.framework.*;
-import helma.scripting.*;
-import helma.util.Updatable;
-import helma.util.SystemProperties;
-import helma.objectmodel.db.DbMapping;
 
 /**
  * This represents a Zip-File which may contain other Updatables for one or more prototypes.
  */
-
-
 public class ZippedAppFile implements Updatable {
-
     Application app;
     File file;
     long lastmod;
     Set updatables;
 
-
-    public ZippedAppFile (File file, Application app) {
+    /**
+     * Creates a new ZippedAppFile object.
+     *
+     * @param file ...
+     * @param app ...
+     */
+    public ZippedAppFile(File file, Application app) {
         this.app = app;
         this.file = file;
+
         // System.err.println ("CREATING ZIP FILE "+this);
     }
 
-
     /**
      * Tell the type manager whether we need an update. this is the case when
      * the file has been modified or deleted.
      */
-    public boolean needsUpdate () {
-	return !file.exists () || lastmod != file.lastModified ();
+    public boolean needsUpdate() {
+        return !file.exists() || (lastmod != file.lastModified());
     }
 
-
-    public void update () {
-
-	if (!file.exists ()) {
-	    remove ();
-
+    /**
+     *
+     */
+    public void update() {
+        if (!file.exists()) {
+            remove();
         } else {
-
             ZipFile zip = null;
+
             // collect created protos - we need this to check DbMappings for each created
             // prototype afterwards
-	    HashSet newPrototypes = new HashSet ();
+            HashSet newPrototypes = new HashSet();
+
             try {
-	        lastmod = file.lastModified ();
+                lastmod = file.lastModified();
+
                 // System.err.println ("UPDATING ZIP FILE "+this);
-	        zip = new ZipFile (file);
-	        updatables = new HashSet ();
-	        for (Enumeration en = zip.entries (); en.hasMoreElements (); ) {
-	            ZipEntry entry = (ZipEntry) en.nextElement ();
-	            String ename = entry.getName ();
-	            StringTokenizer st = new StringTokenizer (ename, "/");
-	            if (st.countTokens () == 2) {
-	                String dir = st.nextToken ();
-	                String fname = st.nextToken ();
+                zip = new ZipFile(file);
+                updatables = new HashSet();
+
+                for (Enumeration en = zip.entries(); en.hasMoreElements();) {
+                    ZipEntry entry = (ZipEntry) en.nextElement();
+                    String ename = entry.getName();
+                    StringTokenizer st = new StringTokenizer(ename, "/");
+
+                    if (st.countTokens() == 2) {
+                        String dir = st.nextToken();
+                        String fname = st.nextToken();
+
                         // System.err.println ("ZIPENTRY: "+ dir +" ~ "+fname);
-	                Prototype proto = app.typemgr.getPrototype (dir);
+                        Prototype proto = app.typemgr.getPrototype(dir);
+
                         if (proto == null) {
-	                    proto = app.typemgr.createPrototype (dir);
-	                    newPrototypes.add (proto);
+                            proto = app.typemgr.createPrototype(dir);
+                            newPrototypes.add(proto);
                         }
-	                if (fname.endsWith (".hac")) {
-	                    String name = fname.substring (0, fname.lastIndexOf ("."));
-	                    String sourceName = file.getName()+"/"+ename;
-	                    String content = getZipEntryContent (zip, entry);
+
+                        if (fname.endsWith(".hac")) {
+                            String name = fname.substring(0, fname.lastIndexOf("."));
+                            String sourceName = file.getName() + "/" + ename;
+                            String content = getZipEntryContent(zip, entry);
+
                             // System.err.println ("["+content+"]");
-	                    ActionFile act = new ActionFile (content, name, sourceName, proto);
-	                    proto.addActionFile (act);
-	                    updatables.add (act);
+                            ActionFile act = new ActionFile(content, name, sourceName,
+                                                            proto);
+
+                            proto.addActionFile(act);
+                            updatables.add(act);
+
                             // mark prototype as updated
-	                    proto.markUpdated ();
-	                }
-	                else if (fname.endsWith (".hsp")) {
-	                    String name = fname.substring (0, fname.lastIndexOf ("."));
-	                    String sourceName = file.getName()+"/"+ename;
-	                    String content = getZipEntryContent (zip, entry);
+                            proto.markUpdated();
+                        } else if (fname.endsWith(".hsp")) {
+                            String name = fname.substring(0, fname.lastIndexOf("."));
+                            String sourceName = file.getName() + "/" + ename;
+                            String content = getZipEntryContent(zip, entry);
+
                             // System.err.println ("["+content+"]");
-	                    Template tmp = new Template (content, name, sourceName, proto);
-	                    proto.addTemplate (tmp);
-	                    updatables.add (tmp);
+                            Template tmp = new Template(content, name, sourceName, proto);
+
+                            proto.addTemplate(tmp);
+                            updatables.add(tmp);
+
                             // mark prototype as updated
-	                    proto.markUpdated ();
-	                }
-	                else if (fname.endsWith (".skin")) {
-	                    String name = fname.substring (0, fname.lastIndexOf ("."));
-	                    String content = getZipEntryContent (zip, entry);
+                            proto.markUpdated();
+                        } else if (fname.endsWith(".skin")) {
+                            String name = fname.substring(0, fname.lastIndexOf("."));
+                            String content = getZipEntryContent(zip, entry);
+
                             // System.err.println ("["+content+"]");
-	                    SkinFile skin = new SkinFile (content, name, proto);
-	                    proto.addSkinFile (skin);
-	                    updatables.add (skin);
-	                }
-	                else if (fname.endsWith (".js")) {
-	                    String sourceName = file.getName()+"/"+ename;
-	                    String content = getZipEntryContent (zip, entry);
+                            SkinFile skin = new SkinFile(content, name, proto);
+
+                            proto.addSkinFile(skin);
+                            updatables.add(skin);
+                        } else if (fname.endsWith(".js")) {
+                            String sourceName = file.getName() + "/" + ename;
+                            String content = getZipEntryContent(zip, entry);
+
                             // System.err.println ("["+content+"]");
-	                    FunctionFile ff = new FunctionFile (content, sourceName, proto);
-	                    proto.addFunctionFile (ff);
-	                    updatables.add (ff);
+                            FunctionFile ff = new FunctionFile(content, sourceName, proto);
+
+                            proto.addFunctionFile(ff);
+                            updatables.add(ff);
+
                             // mark prototype as updated
-	                    proto.markUpdated ();
-	                }
-	                else if ("type.properties".equalsIgnoreCase (fname)) {
-	                    DbMapping dbmap = proto.getDbMapping ();
-	                    SystemProperties props = dbmap.getProperties ();
-	                    props.addProps (file.getName(), zip.getInputStream (entry));
+                            proto.markUpdated();
+                        } else if ("type.properties".equalsIgnoreCase(fname)) {
+                            DbMapping dbmap = proto.getDbMapping();
+                            SystemProperties props = dbmap.getProperties();
+
+                            props.addProps(file.getName(), zip.getInputStream(entry));
+
                             // mark prototype as updated
-	                    proto.markUpdated ();
+                            proto.markUpdated();
                         }
                     }
                 }
             } catch (Throwable x) {
-	        System.err.println ("Error updating ZipFile: "+x);
+                System.err.println("Error updating ZipFile: " + x);
             } finally {
                 try {
-	           zip.close ();
-	        } catch (Exception ignore) {}
+                    zip.close();
+                } catch (Exception ignore) {
+                }
+            }
         }
     }
 
-    }
-
-    public void remove () {
+    /**
+     *
+     */
+    public void remove() {
         if (updatables != null) {
-	    for (Iterator it = updatables.iterator(); it.hasNext(); ) 
-	        ((Updatable) it.next()).remove ();
+            for (Iterator it = updatables.iterator(); it.hasNext();)
+                ((Updatable) it.next()).remove();
         }
-	app.typemgr.removeZipFile (file.getName());
+
+        app.typemgr.removeZipFile(file.getName());
+
         // System.err.println ("REMOVING ZIP FILE "+this);
     }
 
-
-    public String getZipEntryContent (ZipFile zip, ZipEntry entry) throws IOException {
-	int size = (int) entry.getSize ();
+    /**
+     *
+     *
+     * @param zip ...
+     * @param entry ...
+     *
+     * @return ...
+     *
+     * @throws IOException ...
+     */
+    public String getZipEntryContent(ZipFile zip, ZipEntry entry)
+                              throws IOException {
+        int size = (int) entry.getSize();
         char[] c = new char[size];
-	InputStreamReader reader = new InputStreamReader (zip.getInputStream (entry));
-	reader.read (c);
-	return new String (c);
+        InputStreamReader reader = new InputStreamReader(zip.getInputStream(entry));
+
+        reader.read(c);
+
+        return new String(c);
     }
 
-
-    public String toString () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String toString() {
         return file.getName();
     }
-
-
 }
-
-
-

src/helma/image/ImageGenerator.java

@@ -1,198 +1,295 @@
-// ImageGenerator.java
-// Copyright (c) Hannes Wallnöfer 1999-2000
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.image;
 
 import java.awt.*;
 import java.awt.image.*;
-import java.net.URL;
 import java.net.MalformedURLException;
+import java.net.URL;
 
 /**
  * Factory class for generating Image objects from various sources.
  *
  */
-
 public class ImageGenerator {
-
-    public ImageGenerator () {
+    /**
+     * Creates a new ImageGenerator object.
+     */
+    public ImageGenerator() {
         // nothing to do
     }
 
-    public ImageWrapper createPaintableImage (int w, int h) {
-	BufferedImage img = new BufferedImage (w, h, BufferedImage.TYPE_INT_RGB);
-	Graphics g = img.getGraphics ();
-	ImageWrapper rimg = new SunImageWrapper (img, g, w, h, this);
+    /**
+     *
+     *
+     * @param w ...
+     * @param h ...
+     *
+     * @return ...
+     */
+    public ImageWrapper createPaintableImage(int w, int h) {
+        BufferedImage img = new BufferedImage(w, h, BufferedImage.TYPE_INT_RGB);
+        Graphics g = img.getGraphics();
+        ImageWrapper rimg = new SunImageWrapper(img, g, w, h, this);
+
         return rimg;
     }
 
-    public ImageWrapper createPaintableImage (byte src[]) {
+    /**
+     *
+     *
+     * @param src ...
+     *
+     * @return ...
+     */
+    public ImageWrapper createPaintableImage(byte[] src) {
         ImageWrapper rimg = null;
-	Image img1 = Toolkit.getDefaultToolkit ().createImage (src);
-	ImageLoader loader = new ImageLoader (img1);
+        Image img1 = Toolkit.getDefaultToolkit().createImage(src);
+        ImageLoader loader = new ImageLoader(img1);
+
         try {
-	    loader.getDimensions ();
-	    int w = loader.getWidth ();
-	    int h = loader.getHeight ();
-	    Image img = new BufferedImage (w, h, BufferedImage.TYPE_INT_RGB);
-	    Graphics g = img.getGraphics ();
-	    g.drawImage (img1, 0, 0, null);
-	    rimg = new SunImageWrapper (img, g, w, h, this);
+            loader.getDimensions();
+
+            int w = loader.getWidth();
+            int h = loader.getHeight();
+            Image img = new BufferedImage(w, h, BufferedImage.TYPE_INT_RGB);
+            Graphics g = img.getGraphics();
+
+            g.drawImage(img1, 0, 0, null);
+            rimg = new SunImageWrapper(img, g, w, h, this);
         } finally {
             loader.done();
         }
+
         return rimg;
     }
 
-    public ImageWrapper createImage (byte src[]) {
+    /**
+     *
+     *
+     * @param src ...
+     *
+     * @return ...
+     */
+    public ImageWrapper createImage(byte[] src) {
         ImageWrapper rimg = null;
-	Image img = Toolkit.getDefaultToolkit ().createImage (src);
-	ImageLoader loader = new ImageLoader (img);
+        Image img = Toolkit.getDefaultToolkit().createImage(src);
+        ImageLoader loader = new ImageLoader(img);
+
         try {
-	    loader.getDimensions ();
-	    int w = loader.getWidth ();
-	    int h = loader.getHeight ();
-	    rimg = new SunImageWrapper (img, null, w, h, this);
+            loader.getDimensions();
+
+            int w = loader.getWidth();
+            int h = loader.getHeight();
+
+            rimg = new SunImageWrapper(img, null, w, h, this);
         } finally {
             loader.done();
         }
+
         return rimg;
     }
 
-
-    public ImageWrapper createPaintableImage (String urlstring) throws MalformedURLException {
+    /**
+     *
+     *
+     * @param urlstring ...
+     *
+     * @return ...
+     *
+     * @throws MalformedURLException ...
+     */
+    public ImageWrapper createPaintableImage(String urlstring)
+                                      throws MalformedURLException {
         ImageWrapper rimg = null;
-	URL url = new URL (urlstring);
-	Image img1 = Toolkit.getDefaultToolkit ().createImage (url);
-	ImageLoader loader = new ImageLoader (img1);
+        URL url = new URL(urlstring);
+        Image img1 = Toolkit.getDefaultToolkit().createImage(url);
+        ImageLoader loader = new ImageLoader(img1);
+
         try {
-	    loader.getDimensions ();
-	    int w = loader.getWidth ();
-	    int h = loader.getHeight ();
-	    Image img = new BufferedImage (w, h, BufferedImage.TYPE_INT_RGB);
-	    Graphics g = img.getGraphics ();
-	    g.drawImage (img1, 0, 0, null);
-	    rimg = new SunImageWrapper (img, g, w, h, this);
+            loader.getDimensions();
+
+            int w = loader.getWidth();
+            int h = loader.getHeight();
+            Image img = new BufferedImage(w, h, BufferedImage.TYPE_INT_RGB);
+            Graphics g = img.getGraphics();
+
+            g.drawImage(img1, 0, 0, null);
+            rimg = new SunImageWrapper(img, g, w, h, this);
         } finally {
             loader.done();
         }
+
         return rimg;
     }
 
-    public ImageWrapper createPaintableImage (ImageWrapper iw, ImageFilter filter) {
+    /**
+     *
+     *
+     * @param iw ...
+     * @param filter ...
+     *
+     * @return ...
+     */
+    public ImageWrapper createPaintableImage(ImageWrapper iw, ImageFilter filter) {
         ImageWrapper rimg = null;
-	FilteredImageSource fis = new FilteredImageSource (iw.getSource(), filter);
-	Image img1 = Toolkit.getDefaultToolkit().createImage (fis);
-	ImageLoader loader = new ImageLoader (img1);
+        FilteredImageSource fis = new FilteredImageSource(iw.getSource(), filter);
+        Image img1 = Toolkit.getDefaultToolkit().createImage(fis);
+        ImageLoader loader = new ImageLoader(img1);
+
         try {
-	    loader.getDimensions ();
-	    int w = loader.getWidth ();
-	    int h = loader.getHeight ();
-	    Image img = new BufferedImage (w, h, BufferedImage.TYPE_INT_RGB);
-	    Graphics g = img.getGraphics ();
-	    g.drawImage (img1, 0, 0, null);
-	    rimg = new SunImageWrapper (img, g, w, h, this);
+            loader.getDimensions();
+
+            int w = loader.getWidth();
+            int h = loader.getHeight();
+            Image img = new BufferedImage(w, h, BufferedImage.TYPE_INT_RGB);
+            Graphics g = img.getGraphics();
+
+            g.drawImage(img1, 0, 0, null);
+            rimg = new SunImageWrapper(img, g, w, h, this);
         } finally {
             loader.done();
         }
+
         return rimg;
     }
 
-
-     public Image createImage (String filename) {
+    /**
+     *
+     *
+     * @param filename ...
+     *
+     * @return ...
+     */
+    public Image createImage(String filename) {
         Image img = null;
-	img = Toolkit.getDefaultToolkit ().createImage (filename);
-	ImageLoader loader = new ImageLoader (img);
-	loader.getDimensions ();
+
+        img = Toolkit.getDefaultToolkit().createImage(filename);
+
+        ImageLoader loader = new ImageLoader(img);
+
+        loader.getDimensions();
         loader.done();
+
         return img;
     }
 
-    public Image createImage (ImageProducer producer) {
+    /**
+     *
+     *
+     * @param producer ...
+     *
+     * @return ...
+     */
+    public Image createImage(ImageProducer producer) {
         Image img = null;
-	img = Toolkit.getDefaultToolkit ().createImage (producer);
-	ImageLoader loader = new ImageLoader (img);
-	loader.getDimensions ();
+
+        img = Toolkit.getDefaultToolkit().createImage(producer);
+
+        ImageLoader loader = new ImageLoader(img);
+
+        loader.getDimensions();
         loader.done();
+
         return img;
     }
 
     class ImageLoader implements ImageObserver {
-
         Image img;
-	int w, h;
+        int w;
+        int h;
         boolean waiting;
         boolean firstFrameLoaded;
 
-	ImageLoader (Image img) {
+        ImageLoader(Image img) {
             this.img = img;
             waiting = true;
             firstFrameLoaded = false;
         }
 
-	synchronized void getDimensions () {
+        synchronized void getDimensions() {
             w = img.getWidth(this);
-	    h = img.getHeight (this);
-	    if (w == -1 || h == -1) {
+            h = img.getHeight(this);
+
+            if ((w == -1) || (h == -1)) {
                 try {
-	            wait (45000);
+                    wait(45000);
                 } catch (InterruptedException x) {
                     waiting = false;
+
                     return;
                 } finally {
                     waiting = false;
                 }
             }
+
             // if width and height haven't been set, throw tantrum
-	    if (w == -1 || h == -1) {
-	        throw new RuntimeException ("Error loading image");
+            if ((w == -1) || (h == -1)) {
+                throw new RuntimeException("Error loading image");
             }
         }
 
-	synchronized void done () {
+        synchronized void done() {
             waiting = false;
-	    notifyAll ();
+            notifyAll();
         }
 
-	int getWidth () {
+        int getWidth() {
             return w;
         }
 
-	int getHeight () {
+        int getHeight() {
             return h;
         }
 
-	public synchronized boolean imageUpdate(Image img,
-                           int infoflags,
-                           int x,
-                           int y,
-                           int width,
-                           int height) {
+        public synchronized boolean imageUpdate(Image img, int infoflags, int x, int y,
+                                                int width, int height) {
             // check if there was an error
-	    if (!waiting || (infoflags & ERROR) > 0 || (infoflags & ABORT) > 0) {
+            if (!waiting || ((infoflags & ERROR) > 0) || ((infoflags & ABORT) > 0)) {
                 // we either timed out or there was an error.
-	        notifyAll ();
+                notifyAll();
+
                 return false;
             }
-	    if ((infoflags & WIDTH) > 0 || (infoflags & HEIGHT) > 0) {
-	        if ((infoflags & WIDTH) > 0)
+
+            if (((infoflags & WIDTH) > 0) || ((infoflags & HEIGHT) > 0)) {
+                if ((infoflags & WIDTH) > 0) {
                     w = width;
-	        if ((infoflags & HEIGHT) > 0)
+                }
+
+                if ((infoflags & HEIGHT) > 0) {
                     h = height;
-	        if (w > -1 && h > -1 && firstFrameLoaded) {
-	            notifyAll ();
+                }
+
+                if ((w > -1) && (h > -1) && firstFrameLoaded) {
+                    notifyAll();
+
                     return false;
                 }
             }
-	    if ((infoflags & ALLBITS) > 0 || (infoflags & FRAMEBITS) > 0) {
+
+            if (((infoflags & ALLBITS) > 0) || ((infoflags & FRAMEBITS) > 0)) {
                 firstFrameLoaded = true;
-	        notifyAll ();
+                notifyAll();
+
                 return false;
             }
+
             return true;
         }
-
-
     }
-
 }

src/helma/image/ImageWrapper.java

@@ -1,223 +1,381 @@
-// ImageWrapper.java
-// Copyright (c) Hannes Wallnöfer 1999-2000
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.image;
 
 import java.awt.*;
 import java.awt.image.*;
-import java.util.*;
+import java.io.*;
 import java.rmi.*;
 import java.rmi.server.*;
-import java.io.*;
+import java.util.*;
 
 /**
  * Abstract base class for Image Wrappers.
  */
- 
 public abstract class ImageWrapper {
-
     Image img;
     Graphics g;
-    int width, height;
-    int fontstyle, fontsize;
+    int width;
+    int height;
+    int fontstyle;
+    int fontsize;
     String fontname;
     ImageGenerator imggen;
 
-    public ImageWrapper (Image img, Graphics g, int width, int height, ImageGenerator imggen) {
+    /**
+     * Creates a new ImageWrapper object.
+     *
+     * @param img ...
+     * @param g ...
+     * @param width ...
+     * @param height ...
+     * @param imggen ...
+     */
+    public ImageWrapper(Image img, Graphics g, int width, int height,
+                        ImageGenerator imggen) {
         this.img = img;
         this.g = g;
         this.width = width;
         this.height = height;
         this.imggen = imggen;
+
         if (g != null) {
-	    Font f = g.getFont ();
-	    fontname = f.getName ();
-	    fontstyle = f.getStyle ();
-	    fontsize = f.getSize ();
+            Font f = g.getFont();
+
+            fontname = f.getName();
+            fontstyle = f.getStyle();
+            fontsize = f.getSize();
         }
     }
 
     /**
      *  image manipulation methods
      */
-
-    public void setFont (String name, int style, int size) {
+    public void setFont(String name, int style, int size) {
         this.fontname = name;
         this.fontstyle = style;
         this.fontsize = size;
-	g.setFont (new Font (name, style, size));
+        g.setFont(new Font(name, style, size));
     }
 
-    public void setColor (int red, int green, int blue) {
-	g.setColor (new Color (red, green, blue));
+    /**
+     *
+     *
+     * @param red ...
+     * @param green ...
+     * @param blue ...
+     */
+    public void setColor(int red, int green, int blue) {
+        g.setColor(new Color(red, green, blue));
     }
 
-    public void setColor (int color) {
-	g.setColor (new Color (color));
+    /**
+     *
+     *
+     * @param color ...
+     */
+    public void setColor(int color) {
+        g.setColor(new Color(color));
     }
 
-    public void drawString (String str, int x, int y) {
-	g.drawString (str, x, y);
+    /**
+     *
+     *
+     * @param str ...
+     * @param x ...
+     * @param y ...
+     */
+    public void drawString(String str, int x, int y) {
+        g.drawString(str, x, y);
     }
 
-    public void drawLine (int x1, int y1, int x2, int y2) {
-	g.drawLine (x1, y1, x2, y2);
+    /**
+     *
+     *
+     * @param x1 ...
+     * @param y1 ...
+     * @param x2 ...
+     * @param y2 ...
+     */
+    public void drawLine(int x1, int y1, int x2, int y2) {
+        g.drawLine(x1, y1, x2, y2);
     }
 
-    public void drawRect (int x, int y, int w, int h) {
-	g.drawRect (x, y, w, h);
+    /**
+     *
+     *
+     * @param x ...
+     * @param y ...
+     * @param w ...
+     * @param h ...
+     */
+    public void drawRect(int x, int y, int w, int h) {
+        g.drawRect(x, y, w, h);
     }
 
-    public void drawImage (String filename, int x, int y) {
+    /**
+     *
+     *
+     * @param filename ...
+     * @param x ...
+     * @param y ...
+     */
+    public void drawImage(String filename, int x, int y) {
         try {
-	    Image i = imggen.createImage (filename);
-	    g.drawImage (i, x, y, null);
-	} catch (Exception ignore) {}
+            Image i = imggen.createImage(filename);
+
+            g.drawImage(i, x, y, null);
+        } catch (Exception ignore) {
+        }
     }
 
-    public void fillRect (int x, int y, int w, int h) {
-	g.fillRect (x, y, w, h);
+    /**
+     *
+     *
+     * @param x ...
+     * @param y ...
+     * @param w ...
+     * @param h ...
+     */
+    public void fillRect(int x, int y, int w, int h) {
+        g.fillRect(x, y, w, h);
     }
 
-    public int getWidth () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public int getWidth() {
         return width;
     }
 
-    public int getHeight () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public int getHeight() {
         return height;
     }
 
-    public void crop (int x, int y, int w, int h) {
-	ImageFilter filter = new CropImageFilter (x, y, w, h);
-	img = Toolkit.getDefaultToolkit ().createImage(new FilteredImageSource(img.getSource(), filter));
+    /**
+     *
+     *
+     * @param x ...
+     * @param y ...
+     * @param w ...
+     * @param h ...
+     */
+    public void crop(int x, int y, int w, int h) {
+        ImageFilter filter = new CropImageFilter(x, y, w, h);
 
+        img = Toolkit.getDefaultToolkit().createImage(new FilteredImageSource(img.getSource(),
+                                                                              filter));
     }
 
-    public void resize (int w, int h) {
-	img = img.getScaledInstance (w, h, Image.SCALE_SMOOTH);
+    /**
+     *
+     *
+     * @param w ...
+     * @param h ...
+     */
+    public void resize(int w, int h) {
+        img = img.getScaledInstance(w, h, Image.SCALE_SMOOTH);
         width = w;
         height = h;
     }
 
-    public void resizeFast (int w, int h) {
-	img = img.getScaledInstance (w, h, Image.SCALE_FAST);
+    /**
+     *
+     *
+     * @param w ...
+     * @param h ...
+     */
+    public void resizeFast(int w, int h) {
+        img = img.getScaledInstance(w, h, Image.SCALE_FAST);
         width = w;
         height = h;
     }
 
-    public abstract void reduceColors (int colors);
+    /**
+     *
+     *
+     * @param colors ...
+     */
+    public abstract void reduceColors(int colors);
 
-    public abstract void saveAs (String filename);
+    /**
+     *
+     *
+     * @param filename ...
+     */
+    public abstract void saveAs(String filename);
 
     /**
      * Get ImageProducer of the wrapped image
      */
-    public ImageProducer getSource () {
-	return img.getSource ();
+    public ImageProducer getSource() {
+        return img.getSource();
     }
 
-    public void fillString (String str) {
-	Filler filler = new Filler (0, 0, width, height);
-	filler.layout (str);
+    /**
+     *
+     *
+     * @param str ...
+     */
+    public void fillString(String str) {
+        Filler filler = new Filler(0, 0, width, height);
+
+        filler.layout(str);
     }
 
-    public void fillString (String str, int x, int y, int w, int h) {
-	Filler filler = new Filler (x, y, w, h);
-	filler.layout (str);
+    /**
+     *
+     *
+     * @param str ...
+     * @param x ...
+     * @param y ...
+     * @param w ...
+     * @param h ...
+     */
+    public void fillString(String str, int x, int y, int w, int h) {
+        Filler filler = new Filler(x, y, w, h);
+
+        filler.layout(str);
     }
 
     class Filler {
-
-    int x, y, w, h;
+        int x;
+        int y;
+        int w;
+        int h;
         int addedSpace = 0;
-    int xLeft, yLeft;
+        int xLeft;
+        int yLeft;
         int realHeight;
         transient Vector lines;
 
-    public Filler (int x, int y, int w, int h) {
+        public Filler(int x, int y, int w, int h) {
             this.x = x;
             this.y = y;
             this.w = w;
             this.h = h;
         }
 
-    public void layout (String str) {
+        public void layout(String str) {
             int size = fontsize;
-	lines = new Vector ();
-	while (!splitMessage (str, size) && size > 10) {
-	    lines.setSize (0);
-	    size = Math.max (2, size-1);
+
+            lines = new Vector();
+
+            while (!splitMessage(str, size) && (size > 10)) {
+                lines.setSize(0);
+                size = Math.max(2, size - 1);
             }
-	Font oldfont = g.getFont ();
-	g.setFont (new Font (fontname, fontstyle, size));
+
+            Font oldfont = g.getFont();
+
+            g.setFont(new Font(fontname, fontstyle, size));
+
             int l = lines.size();
+
             for (int i = 0; i < l; i++) {
-	    ((Line) lines.elementAt (i)).paint (g, xLeft/2, yLeft/2 + y);
-	}
-	g.setFont (oldfont);
+                ((Line) lines.elementAt(i)).paint(g, xLeft / 2, (yLeft / 2) + y);
             }
 
-    private boolean splitMessage (String string, int size) {
+            g.setFont(oldfont);
+        }
 
-	Font font = new Font (fontname, fontstyle, size);
-	FontMetrics metrics = Toolkit.getDefaultToolkit ().getFontMetrics (font);
+        private boolean splitMessage(String string, int size) {
+            Font font = new Font(fontname, fontstyle, size);
+            FontMetrics metrics = Toolkit.getDefaultToolkit().getFontMetrics(font);
             int longestLine = 0;
             int heightSoFar = 0;
-	int heightIncrement = (int) (0.84f * metrics.getHeight ());
-	StringTokenizer tk = new StringTokenizer (string);
+            int heightIncrement = (int) (0.84f * metrics.getHeight());
+            StringTokenizer tk = new StringTokenizer(string);
             StringBuffer buffer = new StringBuffer();
             int spaceWidth = metrics.stringWidth(" ");
             int currentLine = 0;
             int currentWidth = 0;
-	int maxWidth = w - 2, maxHeight = h + addedSpace - 2;
+            int maxWidth = w - 2;
+            int maxHeight = (h + addedSpace) - 2;
+
             while (tk.hasMoreTokens()) {
                 String nextToken = tk.nextToken();
                 int nextWidth = metrics.stringWidth(nextToken);
-	    if ((currentWidth + nextWidth >= maxWidth && currentWidth != 0)) {
-	        Line line = new Line (buffer.toString(), x, heightSoFar, metrics);
-	        lines.addElement (line); 
-	        if (line.textwidth > longestLine)
+
+                if ((((currentWidth + nextWidth) >= maxWidth) && (currentWidth != 0))) {
+                    Line line = new Line(buffer.toString(), x, heightSoFar, metrics);
+
+                    lines.addElement(line);
+
+                    if (line.textwidth > longestLine) {
                         longestLine = line.textwidth;
+                    }
+
                     buffer = new StringBuffer();
 
                     currentWidth = 0;
                     heightSoFar += heightIncrement;
                 }
-	    buffer.append (nextToken); 
-	    buffer.append (" ");
+
+                buffer.append(nextToken);
+                buffer.append(" ");
                 currentWidth += (nextWidth + spaceWidth);
-	    if (1.18*heightSoFar > maxHeight && fontsize > 10)
+
+                if (((1.18 * heightSoFar) > maxHeight) && (fontsize > 10)) {
                     return false;
                 }
-	if (! "".equals (buffer.toString().trim())) {
-	    Line line = new Line (buffer.toString(), x, heightSoFar, metrics);
-	    lines.addElement (line); 
+            }
 
-	    if (line.textwidth > longestLine)
+            if (!"".equals(buffer.toString().trim())) {
+                Line line = new Line(buffer.toString(), x, heightSoFar, metrics);
+
+                lines.addElement(line);
+
+                if (line.textwidth > longestLine) {
                     longestLine = line.textwidth;
-	    if (longestLine > maxWidth && fontsize > 10)
+                }
+
+                if ((longestLine > maxWidth) && (fontsize > 10)) {
                     return false;
+                }
+
                 heightSoFar += heightIncrement;
             }
+
             xLeft = w - longestLine;
-	yLeft = addedSpace + h - heightSoFar;
+            yLeft = (addedSpace + h) - heightSoFar;
             realHeight = heightSoFar;
-	return (1.18*heightSoFar <= maxHeight);
-    }
 
+            return ((1.18 * heightSoFar) <= maxHeight);
+        }
     }
-
 
     class Line implements Serializable {
-
         String text;
-    int xoff, yoff;
+        int xoff;
+        int yoff;
         FontMetrics fm;
-    public int textwidth, len;
+        public int textwidth;
+        public int len;
         int ascent;
 
-
-    public Line (String text, int xoff, int yoff, FontMetrics fm) {
+        public Line(String text, int xoff, int yoff, FontMetrics fm) {
             this.text = text.trim();
             len = text.length();
             this.xoff = xoff;
@@ -227,21 +385,12 @@ public abstract class ImageWrapper {
             ascent = (int) (0.9f * fm.getAscent());
         }
 
-    public void paint (Graphics g, int xadd, int yadd) {
-	g.drawString (text, xoff+xadd, yoff+ascent+yadd);
+        public void paint(Graphics g, int xadd, int yadd) {
+            g.drawString(text, xoff + xadd, yoff + ascent + yadd);
         }
 
-
-    public boolean contains (int y) {
-	return (y < yoff+fm.getHeight()) ? true : false;
+        public boolean contains(int y) {
+            return (y < (yoff + fm.getHeight())) ? true : false;
         }
-
-
     }
-
 }
-
-
-
-
-

src/helma/image/SunImageWrapper.java

@@ -1,43 +1,69 @@
-// ActivatedImageWrapper.java
-// Copyright (c) Hannes Wallnöfer 1999-2000
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.image;
 
-import java.awt.*;
-import java.awt.image.*;
+import Acme.JPM.Encoders.GifEncoder;
 import com.sun.jimi.core.*;
 import com.sun.jimi.core.util.*;
-import Acme.JPM.Encoders.GifEncoder;
-import java.io.IOException;
+import java.awt.*;
+import java.awt.image.*;
 import java.io.FileOutputStream;
+import java.io.IOException;
 
 /**
  * A wrapper for an image that uses the Sun version of JIMI available at
  * http://java.sun.com/products/jimi.
  */
-
 public class SunImageWrapper extends ImageWrapper {
-
-    public SunImageWrapper (Image img, Graphics g, int width, int height,
+    /**
+     * Creates a new SunImageWrapper object.
+     *
+     * @param img ...
+     * @param g ...
+     * @param width ...
+     * @param height ...
+     * @param imggen ...
+     */
+    public SunImageWrapper(Image img, Graphics g, int width, int height,
                            ImageGenerator imggen) {
-	super (img, g, width, height, imggen);
+        super(img, g, width, height, imggen);
     }
 
-
-    public void reduceColors (int colors) {
+    /**
+     *
+     *
+     * @param colors ...
+     */
+    public void reduceColors(int colors) {
         try {
-	    int pixels[][] = getPixels();
-	    int palette[] = Quantize.quantizeImage(pixels, colors);
+            int[][] pixels = getPixels();
+            int[] palette = Quantize.quantizeImage(pixels, colors);
             int w = pixels.length;
             int h = pixels[0].length;
-	    int pix[] = new int[w * h];
+            int[] pix = new int[w * h];
+
             // convert to RGB
-	    for (int x = w; x-- > 0; ) {
-	        for (int y = h; y-- > 0; ) {
-	            pix[y * w + x] = palette[pixels[x][y]];
+            for (int x = w; x-- > 0;) {
+                for (int y = h; y-- > 0;) {
+                    pix[(y * w) + x] = palette[pixels[x][y]];
                 }
             }
-	    img = imggen.createImage (new MemoryImageSource(w, h, pix, 0, w));
+
+            img = imggen.createImage(new MemoryImageSource(w, h, pix, 0, w));
         } catch (Exception x) {
             // throw new RuntimeException (x.getMessage ());
         }
@@ -46,9 +72,10 @@ public class SunImageWrapper extends ImageWrapper {
     /**
      * Snag the pixels from an image.
      */
-    int[][] getPixels () throws IOException {
-	int pix[] = new int[width * height];
+    int[][] getPixels() throws IOException {
+        int[] pix = new int[width * height];
         PixelGrabber grabber = new PixelGrabber(img, 0, 0, width, height, pix, 0, width);
+
         try {
             if (grabber.grabPixels() != true) {
                 throw new IOException("Grabber returned false: " + grabber.status());
@@ -56,32 +83,39 @@ public class SunImageWrapper extends ImageWrapper {
         } catch (InterruptedException e) {
             e.printStackTrace();
         }
-	int pixels[][] = new int[width][height];
-	for (int x = width; x-- > 0; ) {
-	    for (int y = height; y-- > 0; ) {
-	        pixels[x][y] = pix[y * width + x];
+
+        int[][] pixels = new int[width][height];
+
+        for (int x = width; x-- > 0;) {
+            for (int y = height; y-- > 0;) {
+                pixels[x][y] = pix[(y * width) + x];
             }
         }
+
         return pixels;
     }
 
-
-    public void saveAs (String filename) {
+    /**
+     *
+     *
+     * @param filename ...
+     */
+    public void saveAs(String filename) {
         try {
-	    if (filename.toLowerCase().endsWith (".gif")) {
+            if (filename.toLowerCase().endsWith(".gif")) {
                 // sun's jimi package doesn't encode gifs, use Acme encoder
-	        FileOutputStream fout = new FileOutputStream (filename);
+                FileOutputStream fout = new FileOutputStream(filename);
+
                 // Acme gif encoder
-	        GifEncoder enc = new GifEncoder (img, fout);
-	        enc.encode ();
-	        fout.close ();
+                GifEncoder enc = new GifEncoder(img, fout);
+
+                enc.encode();
+                fout.close();
             } else {
-	        Jimi.putImage (img, filename);
+                Jimi.putImage(img, filename);
             }
         } catch (Exception x) {
-	    throw new RuntimeException (x.getMessage ());
+            throw new RuntimeException(x.getMessage());
         }
     }
-
-
 }

src/helma/main/ApplicationManager.java

@@ -1,33 +1,43 @@
-// ApplicationManager.java
-// Copyright (c) Hannes Wallnöfer 1998-2000
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.main;
 
-import java.util.*;
-import java.io.*;
-import java.lang.reflect.*;
-import java.rmi.*;
-import java.rmi.server.*;
-import java.net.URLEncoder;
 import helma.framework.*;
 import helma.framework.core.*;
 import helma.objectmodel.*;
 import helma.servlet.*;
 import helma.util.SystemProperties;
+import org.apache.xmlrpc.XmlRpcHandler;
 import org.mortbay.http.*;
 import org.mortbay.http.handler.*;
 import org.mortbay.jetty.servlet.*;
 import org.mortbay.util.*;
+import java.io.*;
+import java.lang.reflect.*;
+import java.net.URLEncoder;
+import java.rmi.*;
+import java.rmi.server.*;
+import java.util.*;
 import javax.servlet.Servlet;
-import org.apache.xmlrpc.XmlRpcHandler;
-
 
 /**
  * This class is responsible for starting and stopping Helma applications.
  */
-
 public class ApplicationManager implements XmlRpcHandler {
-
     private Hashtable applications;
     private Hashtable xmlrpcHandlers;
     private Properties mountpoints;
@@ -37,258 +47,368 @@ public class ApplicationManager implements XmlRpcHandler {
     private Server server;
     private long lastModified;
 
-    public ApplicationManager (int port, File hopHome, SystemProperties props, Server server) {
+    /**
+     * Creates a new ApplicationManager object.
+     *
+     * @param port ...
+     * @param hopHome ...
+     * @param props ...
+     * @param server ...
+     */
+    public ApplicationManager(int port, File hopHome, SystemProperties props,
+                              Server server) {
         this.port = port;
         this.hopHome = hopHome;
         this.props = props;
         this.server = server;
-	applications = new Hashtable ();
-	xmlrpcHandlers = new Hashtable ();
-	mountpoints = new Properties ();
+        applications = new Hashtable();
+        xmlrpcHandlers = new Hashtable();
+        mountpoints = new Properties();
         lastModified = 0;
     }
 
-
     // regularely check applications property file to create and start new applications
-    protected void checkForChanges () {
-	if (props.lastModified () > lastModified) {
+    protected void checkForChanges() {
+        if (props.lastModified() > lastModified) {
             try {
-	        for (Enumeration e = props.keys(); e.hasMoreElements (); ) {
-	            String appName = (String) e.nextElement ();
-	            if (appName.indexOf (".") == -1 && applications.get (appName) == null) {
-	                start (appName);
-	                register (appName);
+                for (Enumeration e = props.keys(); e.hasMoreElements();) {
+                    String appName = (String) e.nextElement();
+
+                    if ((appName.indexOf(".") == -1) &&
+                            (applications.get(appName) == null)) {
+                        start(appName);
+                        register(appName);
                     }
                 }
+
                 // then stop deleted ones
-	        for (Enumeration e = applications.keys(); e.hasMoreElements (); ) {
-	            String appName = (String) e.nextElement ();
+                for (Enumeration e = applications.keys(); e.hasMoreElements();) {
+                    String appName = (String) e.nextElement();
+
                     // check if application has been removed and should be stopped
-	            if (!props.containsKey (appName)) {
-	                stop (appName);
+                    if (!props.containsKey(appName)) {
+                        stop(appName);
                     } else if (server.http != null) {
                         // check if application should be remounted at a
                         // different location on embedded web server
-	                String oldMountpoint = mountpoints.getProperty (appName);
-	                String mountpoint = getMountpoint (appName);
-	                String pattern = getPathPattern (mountpoint);
-	                if (!pattern.equals (oldMountpoint)) {
-	                    Server.getLogger().log("Moving application "+appName+" from "+oldMountpoint+" to "+pattern);
-	                    HttpContext oldContext = server.http.getContext (null, oldMountpoint);
+                        String oldMountpoint = mountpoints.getProperty(appName);
+                        String mountpoint = getMountpoint(appName);
+                        String pattern = getPathPattern(mountpoint);
+
+                        if (!pattern.equals(oldMountpoint)) {
+                            Server.getLogger().log("Moving application " + appName +
+                                                   " from " + oldMountpoint + " to " +
+                                                   pattern);
+
+                            HttpContext oldContext = server.http.getContext(null,
+                                                                            oldMountpoint);
+
                             if (oldContext != null) {
                                 // oldContext.setContextPath(pattern);
-	                        oldContext.stop ();
-	                        oldContext.destroy ();
+                                oldContext.stop();
+                                oldContext.destroy();
                             }
-	                    Application app = (Application) applications.get (appName);
-	                    if (!app.hasExplicitBaseURI())
-	                        app.setBaseURI (mountpoint);
-	                    ServletHttpContext context = new ServletHttpContext ();
+
+                            Application app = (Application) applications.get(appName);
+
+                            if (!app.hasExplicitBaseURI()) {
+                                app.setBaseURI(mountpoint);
+                            }
+
+                            ServletHttpContext context = new ServletHttpContext();
+
                             context.setContextPath(pattern);
-	                    server.http.addContext (context);
-	                    ServletHolder holder = context.addServlet (appName, "/*", "helma.servlet.EmbeddedServletClient");
-	                    holder.setInitParameter ("application", appName);
-	                    holder.setInitParameter ("mountpoint", mountpoint);
-	                    if ("true".equalsIgnoreCase (props.getProperty (appName+".responseEncoding")))
+                            server.http.addContext(context);
+
+                            ServletHolder holder = context.addServlet(appName, "/*",
+                                                                      "helma.servlet.EmbeddedServletClient");
+
+                            holder.setInitParameter("application", appName);
+                            holder.setInitParameter("mountpoint", mountpoint);
+
+                            if ("true".equalsIgnoreCase(props.getProperty(appName +
+                                                                              ".responseEncoding"))) {
                                 context.addHandler(new ContentEncodingHandler());
-	                    String cookieDomain = props.getProperty (appName+".cookieDomain");
-	                    if (cookieDomain != null)
-	                        holder.setInitParameter ("cookieDomain", cookieDomain);
-	                    String uploadLimit = props.getProperty (appName+".uploadLimit");
-	                    if (uploadLimit != null)
-	                        holder.setInitParameter ("uploadLimit", uploadLimit);
+                            }
+
+                            String cookieDomain = props.getProperty(appName +
+                                                                    ".cookieDomain");
+
+                            if (cookieDomain != null) {
+                                holder.setInitParameter("cookieDomain", cookieDomain);
+                            }
+
+                            String uploadLimit = props.getProperty(appName +
+                                                                   ".uploadLimit");
+
+                            if (uploadLimit != null) {
+                                holder.setInitParameter("uploadLimit", uploadLimit);
+                            }
+
                             // holder.start ();
-	                    context.start ();
-	                    mountpoints.setProperty (appName, pattern);
+                            context.start();
+                            mountpoints.setProperty(appName, pattern);
                         }
                     }
                 }
             } catch (Exception mx) {
-	        Server.getLogger().log ("Error checking applications: "+mx);
+                Server.getLogger().log("Error checking applications: " + mx);
             }
 
-	    lastModified = System.currentTimeMillis ();
+            lastModified = System.currentTimeMillis();
         }
     }
 
-    void start (String appName) {
-	Server.getLogger().log ("Building application "+appName);
+    void start(String appName) {
+        Server.getLogger().log("Building application " + appName);
+
         try {
             // check if application and db dirs are set, otherwise go with
             // the defaults, passing null dirs to the constructor.
-	    String appDirName = props.getProperty (appName+".appdir");
-	    File appDir = appDirName == null ? null : new File (appDirName);
-	    String dbDirName = props.getProperty (appName+".dbdir");
-	    File dbDir = dbDirName == null ? null : new File (dbDirName);
+            String appDirName = props.getProperty(appName + ".appdir");
+            File appDir = (appDirName == null) ? null : new File(appDirName);
+            String dbDirName = props.getProperty(appName + ".dbdir");
+            File dbDir = (dbDirName == null) ? null : new File(dbDirName);
+
             // create the application instance
-	    Application app = new Application (appName, server, appDir, dbDir);
-	    applications.put (appName, app);
+            Application app = new Application(appName, server, appDir, dbDir);
+
+            applications.put(appName, app);
+
             // the application is started later in the register method, when it's bound
-	    app.init ();
+            app.init();
         } catch (Exception x) {
-	    Server.getLogger().log ("Error creating application "+appName+": "+x);
-	    x.printStackTrace ();
+            Server.getLogger().log("Error creating application " + appName + ": " + x);
+            x.printStackTrace();
         }
     }
 
-    void stop (String appName) {
-	Server.getLogger().log ("Stopping application "+appName);
+    void stop(String appName) {
+        Server.getLogger().log("Stopping application " + appName);
+
         try {
-	    Application app = (Application) applications.get (appName);
+            Application app = (Application) applications.get(appName);
+
             // unbind from RMI server
             if (port > 0) {
-	        Naming.unbind ("//:"+port+"/"+appName);
+                Naming.unbind("//:" + port + "/" + appName);
             }
+
             // unbind from Jetty HTTP server
             if (server.http != null) {
-	        String mountpoint = mountpoints.getProperty (appName);
-	        HttpContext context = server.http.getContext (null, mountpoint);
+                String mountpoint = mountpoints.getProperty(appName);
+                HttpContext context = server.http.getContext(null, mountpoint);
+
                 if (context != null) {
-	            context.stop ();
-	            context.destroy ();
+                    context.stop();
+                    context.destroy();
                 }
             }
-	    // unregister as XML-RPC handler
-	    xmlrpcHandlers.remove (app.getXmlRpcHandlerName());
-	    app.stop ();
-	    Server.getLogger().log ("Unregistered application "+appName);
-	} catch (Exception x) {
-	    Server.getLogger().log ("Couldn't unregister app: "+x);
-	}
-	applications.remove (appName);
-    }
 
-    void register (String appName) {
+            // unregister as XML-RPC handler
+            xmlrpcHandlers.remove(app.getXmlRpcHandlerName());
+            app.stop();
+            Server.getLogger().log("Unregistered application " + appName);
+        } catch (Exception x) {
+            Server.getLogger().log("Couldn't unregister app: " + x);
+        }
+
+        applications.remove(appName);
+    }
+
+    void register(String appName) {
         try {
-	    Server.getLogger().log ("Binding application "+appName);
-	    Application app = (Application) applications.get (appName);
+            Server.getLogger().log("Binding application " + appName);
+
+            Application app = (Application) applications.get(appName);
+
             // bind to RMI server
             if (port > 0) {
-	        Naming.rebind ("//:"+port+"/"+appName, new RemoteApplication (app));
+                Naming.rebind("//:" + port + "/" + appName, new RemoteApplication(app));
             }
+
             // bind to Jetty HTTP server
             if (server.http != null) {
-	        String mountpoint = getMountpoint (appName);
+                String mountpoint = getMountpoint(appName);
+
                 // if using embedded webserver (not AJP) set application URL prefix
-	        if (!app.hasExplicitBaseURI ())
-	            app.setBaseURI (mountpoint);
-	        String pattern = getPathPattern (mountpoint);
-	        ServletHttpContext context = new ServletHttpContext ();
-	        context.setContextPath(pattern);
-	        server.http.addContext (context);
-	        ServletHolder holder = context.addServlet (appName, "/*", "helma.servlet.EmbeddedServletClient");
-	        holder.setInitParameter ("application", appName);
-	        holder.setInitParameter ("mountpoint", mountpoint);
-	        if ("true".equalsIgnoreCase (props.getProperty (appName+".responseEncoding")))
-	            context.addHandler(new ContentEncodingHandler());
-	        String cookieDomain = props.getProperty (appName+".cookieDomain");
-	        if (cookieDomain != null)
-	            holder.setInitParameter ("cookieDomain", cookieDomain);
-	        String uploadLimit = props.getProperty (appName+".uploadLimit");
-	        if (uploadLimit != null)
-	            holder.setInitParameter ("uploadLimit", uploadLimit);
-	        String debug = props.getProperty (appName+".debug");
-	        if (debug != null)
-	            holder.setInitParameter ("debug", debug);
-	        // holder.start ();
-	        context.start ();
-	        mountpoints.setProperty (appName, pattern);
+                if (!app.hasExplicitBaseURI()) {
+                    app.setBaseURI(mountpoint);
                 }
+
+                String pattern = getPathPattern(mountpoint);
+                ServletHttpContext context = new ServletHttpContext();
+
+                context.setContextPath(pattern);
+                server.http.addContext(context);
+
+                ServletHolder holder = context.addServlet(appName, "/*",
+                                                          "helma.servlet.EmbeddedServletClient");
+
+                holder.setInitParameter("application", appName);
+                holder.setInitParameter("mountpoint", mountpoint);
+
+                if ("true".equalsIgnoreCase(props.getProperty(appName +
+                                                                  ".responseEncoding"))) {
+                    context.addHandler(new ContentEncodingHandler());
+                }
+
+                String cookieDomain = props.getProperty(appName + ".cookieDomain");
+
+                if (cookieDomain != null) {
+                    holder.setInitParameter("cookieDomain", cookieDomain);
+                }
+
+                String uploadLimit = props.getProperty(appName + ".uploadLimit");
+
+                if (uploadLimit != null) {
+                    holder.setInitParameter("uploadLimit", uploadLimit);
+                }
+
+                String debug = props.getProperty(appName + ".debug");
+
+                if (debug != null) {
+                    holder.setInitParameter("debug", debug);
+                }
+
+                // holder.start ();
+                context.start();
+                mountpoints.setProperty(appName, pattern);
+            }
+
             // register as XML-RPC handler
-	    xmlrpcHandlers.put (app.getXmlRpcHandlerName(), app);
-	    app.start ();
+            xmlrpcHandlers.put(app.getXmlRpcHandlerName(), app);
+            app.start();
         } catch (Exception x) {
-	    Server.getLogger().log ("Couldn't register and start app: "+x);
-	    x.printStackTrace ();
+            Server.getLogger().log("Couldn't register and start app: " + x);
+            x.printStackTrace();
         }
     }
 
-    public void startAll () {
+    /**
+     *
+     */
+    public void startAll() {
         try {
-	    for (Enumeration e = props.keys(); e.hasMoreElements (); ) {
-	        String appName = (String) e.nextElement ();
-	        if (appName.indexOf (".") == -1)
-	            start (appName);
+            for (Enumeration e = props.keys(); e.hasMoreElements();) {
+                String appName = (String) e.nextElement();
+
+                if (appName.indexOf(".") == -1) {
+                    start(appName);
                 }
-	    for (Enumeration e = props.keys(); e.hasMoreElements (); ) {
-	        String appName = (String) e.nextElement ();
-	        if (appName.indexOf (".") == -1)
-	            register (appName);
             }
+
+            for (Enumeration e = props.keys(); e.hasMoreElements();) {
+                String appName = (String) e.nextElement();
+
+                if (appName.indexOf(".") == -1) {
+                    register(appName);
+                }
+            }
+
             if (server.http != null) {
                 // add handler for static files.
-	        File staticContent = new File (server.getHopHome(), "static");
-	        Server.getLogger().log("Serving static content from "+staticContent.getAbsolutePath());
-	        HttpContext context = server.http.addContext ("/static/*");
-	        context.setResourceBase (staticContent.getAbsolutePath());
+                File staticContent = new File(server.getHopHome(), "static");
+
+                Server.getLogger().log("Serving static content from " +
+                                       staticContent.getAbsolutePath());
+
+                HttpContext context = server.http.addContext("/static/*");
+
+                context.setResourceBase(staticContent.getAbsolutePath());
+
                 ResourceHandler handler = new ResourceHandler();
+
                 context.addHandler(handler);
-	        context.start ();
+                context.start();
             }
-	    lastModified = System.currentTimeMillis ();
+
+            lastModified = System.currentTimeMillis();
         } catch (Exception mx) {
-	    Server.getLogger().log ("Error starting applications: "+mx);
-	    mx.printStackTrace ();
+            Server.getLogger().log("Error starting applications: " + mx);
+            mx.printStackTrace();
         }
     }
 
-    public void stopAll () {
-	for (Enumeration en=applications.keys(); en.hasMoreElements(); ) {
+    /**
+     *
+     */
+    public void stopAll() {
+        for (Enumeration en = applications.keys(); en.hasMoreElements();) {
             String appName = (String) en.nextElement();
-	    stop (appName);
+
+            stop(appName);
         }
     }
 
     /**
      *  Get an array containing all currently running applications.
      */
-    public Object[] getApplications () {
-	return applications.values ().toArray ();
+    public Object[] getApplications() {
+        return applications.values().toArray();
     }
 
     /**
      *  Get an application by name.
      */
     public Application getApplication(String name) {
-	return (Application)applications.get(name);
+        return (Application) applications.get(name);
     }
 
     /**
      * Implements org.apache.xmlrpc.XmlRpcHandler.execute()
      */
-    public Object execute (String method, Vector params) throws Exception {
-	int dot = method.indexOf (".");
-	if (dot == -1)
-	    throw new Exception ("Method name \""+method+"\" does not specify a handler application");
-	if (dot == 0 || dot == method.length()-1)
-	    throw new Exception ("\""+method+"\" is not a valid XML-RPC method name");
-	String handler = method.substring (0, dot);
-	String method2 = method.substring (dot+1);
-	Application app = (Application) xmlrpcHandlers.get (handler);
-	if (app == null)
-	    throw new Exception ("Handler \""+handler+"\" not found for "+method);
-	return app.executeXmlRpc (method2, params);
+    public Object execute(String method, Vector params)
+                   throws Exception {
+        int dot = method.indexOf(".");
+
+        if (dot == -1) {
+            throw new Exception("Method name \"" + method +
+                                "\" does not specify a handler application");
         }
 
+        if ((dot == 0) || (dot == (method.length() - 1))) {
+            throw new Exception("\"" + method + "\" is not a valid XML-RPC method name");
+        }
 
-    private String getMountpoint (String appName) {
-	String mountpoint = props.getProperty (appName+".mountpoint");
-	if (mountpoint == null)
-	    return "/"+URLEncoder.encode(appName);
-	mountpoint = mountpoint.trim ();
-	if ("".equals (mountpoint))
+        String handler = method.substring(0, dot);
+        String method2 = method.substring(dot + 1);
+        Application app = (Application) xmlrpcHandlers.get(handler);
+
+        if (app == null) {
+            throw new Exception("Handler \"" + handler + "\" not found for " + method);
+        }
+
+        return app.executeXmlRpc(method2, params);
+    }
+
+    private String getMountpoint(String appName) {
+        String mountpoint = props.getProperty(appName + ".mountpoint");
+
+        if (mountpoint == null) {
+            return "/" + URLEncoder.encode(appName);
+        }
+
+        mountpoint = mountpoint.trim();
+
+        if ("".equals(mountpoint)) {
             return "/";
-	else if (!mountpoint.startsWith ("/"))
-	    return "/"+mountpoint;
+        } else if (!mountpoint.startsWith("/")) {
+            return "/" + mountpoint;
+        }
+
         return mountpoint;
     }
 
-    private String getPathPattern (String mountpoint) {
-	if ("/".equals (mountpoint))
+    private String getPathPattern(String mountpoint) {
+        if ("/".equals(mountpoint)) {
             return "/";
-	if (!mountpoint.endsWith ("/"))
-	    return mountpoint+"/*";
-	return mountpoint+"*";
         }
 
+        if (!mountpoint.endsWith("/")) {
+            return mountpoint + "/*";
+        }
+
+        return mountpoint + "*";
+    }
 }

src/helma/main/HelmaSecurityManager.java

@@ -1,12 +1,26 @@
-// HelmaSecurityManager.java
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.main;
 
-import java.security.Permission;
+import helma.framework.core.AppClassLoader;
 import java.io.FileDescriptor;
 import java.net.InetAddress;
+import java.security.Permission;
 import java.util.HashSet;
-import helma.framework.core.AppClassLoader;
 
 /**
  *  Liberal security manager for Helma system that makes sure application code
@@ -17,78 +31,297 @@ import helma.framework.core.AppClassLoader;
  *  the name of the application trying to execute the action in question, if any.
  */
 public class HelmaSecurityManager extends SecurityManager {
-
     // The set of actions forbidden to application code.
     // We are pretty permissive, forbidding only System.exit() 
     // and setting the security manager.
-    private final static HashSet forbidden = new HashSet ();
+    private final static HashSet forbidden = new HashSet();
+
     static {
-	forbidden.add ("exitVM");
-	forbidden.add ("setSecurityManager");
+        forbidden.add("exitVM");
+        forbidden.add("setSecurityManager");
     }
 
+    /**
+     *
+     *
+     * @param p ...
+     */
     public void checkPermission(Permission p) {
         if (p instanceof RuntimePermission) {
-	    if (forbidden.contains (p.getName())) {
+            if (forbidden.contains(p.getName())) {
                 Class[] classes = getClassContext();
-	        for (int i=0; i<classes.length; i++) {
-	            if (classes[i].getClassLoader() instanceof AppClassLoader)
-	                throw new SecurityException (p.getName()+" not allowed for application code");
+
+                for (int i = 0; i < classes.length; i++) {
+                    if (classes[i].getClassLoader() instanceof AppClassLoader) {
+                        throw new SecurityException(p.getName() +
+                                                    " not allowed for application code");
                     }
                 }
             }
         }
+    }
+
+    /**
+     *
+     *
+     * @param p ...
+     * @param context ...
+     */
     public void checkPermission(Permission p, Object context) {
     }
-    public void checkCreateClassLoader() {}
-    public void checkAccess(Thread thread) {}
-    public void checkAccess(ThreadGroup group) {}
+
+    /**
+     *
+     */
+    public void checkCreateClassLoader() {
+    }
+
+    /**
+     *
+     *
+     * @param thread ...
+     */
+    public void checkAccess(Thread thread) {
+    }
+
+    /**
+     *
+     *
+     * @param group ...
+     */
+    public void checkAccess(ThreadGroup group) {
+    }
+
+    /**
+     *
+     *
+     * @param status ...
+     */
     public void checkExit(int status) {
         Class[] classes = getClassContext();
-	for (int i=0; i<classes.length; i++) {
-	    if (classes[i].getClassLoader() instanceof AppClassLoader)
-	        throw new SecurityException ("operation not allowed for application code");
+
+        for (int i = 0; i < classes.length; i++) {
+            if (classes[i].getClassLoader() instanceof AppClassLoader) {
+                throw new SecurityException("operation not allowed for application code");
             }
         }
-    public void checkExec(String cmd) {}
-    public void checkLink(String lib) {}
-    public void checkRead(FileDescriptor fdesc) {}
-    public void checkRead(String file) {}
-    public void checkRead(String file, Object context) {}
-    public void checkWrite(FileDescriptor fdesc) {}
-    public void checkWrite(String file) {}
-    public void checkDelete(String file) {}
-    public void checkConnect(String host, int port) {}
-    public void checkConnect(String host, int port, Object context) {}
-    public void checkListen(int port) {}
-    public void checkAccept(String host, int port) {}
-    public void checkMulticast(InetAddress addr) {}
-    public void checkMulticast(InetAddress addr, byte ttl) {}
-    public void checkPropertiesAccess() {}
-    public void checkPropertyAccess(String key) {}
-    public boolean checkTopLevelWindow(Object window) { return true; }
-    public void checkPrintJobAccess() {}
-    public void checkSystemClipboardAccess() {}
-    public void checkAwtEventQueueAccess() {}
-    public void checkPackageAccess(String pkg) {}
-    public void checkPackageDefinition(String pkg) {}
-    public void checkSetFactory() {}
-    public void checkMemberAccess(Class clazz, int which) {}
-    public void checkSecurityAccess(String target) {}
+    }
+
+    /**
+     *
+     *
+     * @param cmd ...
+     */
+    public void checkExec(String cmd) {
+    }
+
+    /**
+     *
+     *
+     * @param lib ...
+     */
+    public void checkLink(String lib) {
+    }
+
+    /**
+     *
+     *
+     * @param fdesc ...
+     */
+    public void checkRead(FileDescriptor fdesc) {
+    }
+
+    /**
+     *
+     *
+     * @param file ...
+     */
+    public void checkRead(String file) {
+    }
+
+    /**
+     *
+     *
+     * @param file ...
+     * @param context ...
+     */
+    public void checkRead(String file, Object context) {
+    }
+
+    /**
+     *
+     *
+     * @param fdesc ...
+     */
+    public void checkWrite(FileDescriptor fdesc) {
+    }
+
+    /**
+     *
+     *
+     * @param file ...
+     */
+    public void checkWrite(String file) {
+    }
+
+    /**
+     *
+     *
+     * @param file ...
+     */
+    public void checkDelete(String file) {
+    }
+
+    /**
+     *
+     *
+     * @param host ...
+     * @param port ...
+     */
+    public void checkConnect(String host, int port) {
+    }
+
+    /**
+     *
+     *
+     * @param host ...
+     * @param port ...
+     * @param context ...
+     */
+    public void checkConnect(String host, int port, Object context) {
+    }
+
+    /**
+     *
+     *
+     * @param port ...
+     */
+    public void checkListen(int port) {
+    }
+
+    /**
+     *
+     *
+     * @param host ...
+     * @param port ...
+     */
+    public void checkAccept(String host, int port) {
+    }
+
+    /**
+     *
+     *
+     * @param addr ...
+     */
+    public void checkMulticast(InetAddress addr) {
+    }
+
+    /**
+     *
+     *
+     * @param addr ...
+     * @param ttl ...
+     */
+    public void checkMulticast(InetAddress addr, byte ttl) {
+    }
+
+    /**
+     *
+     */
+    public void checkPropertiesAccess() {
+    }
+
+    /**
+     *
+     *
+     * @param key ...
+     */
+    public void checkPropertyAccess(String key) {
+    }
+
+    /**
+     *
+     *
+     * @param window ...
+     *
+     * @return ...
+     */
+    public boolean checkTopLevelWindow(Object window) {
+        return true;
+    }
+
+    /**
+     *
+     */
+    public void checkPrintJobAccess() {
+    }
+
+    /**
+     *
+     */
+    public void checkSystemClipboardAccess() {
+    }
+
+    /**
+     *
+     */
+    public void checkAwtEventQueueAccess() {
+    }
+
+    /**
+     *
+     *
+     * @param pkg ...
+     */
+    public void checkPackageAccess(String pkg) {
+    }
+
+    /**
+     *
+     *
+     * @param pkg ...
+     */
+    public void checkPackageDefinition(String pkg) {
+    }
+
+    /**
+     *
+     */
+    public void checkSetFactory() {
+    }
+
+    /**
+     *
+     *
+     * @param clazz ...
+     * @param which ...
+     */
+    public void checkMemberAccess(Class clazz, int which) {
+    }
+
+    /**
+     *
+     *
+     * @param target ...
+     */
+    public void checkSecurityAccess(String target) {
+    }
 
     /**
      *  Utility method that returns the name of the application trying
      *  to execute the code in question. Returns null if the current code
      *  does not belong to any application.
      */
-    protected String getApplication () {
+    protected String getApplication() {
         Class[] classes = getClassContext();
-	for (int i=0; i<classes.length; i++) {
-	    if (classes[i].getClassLoader() instanceof AppClassLoader)
-	        return ((AppClassLoader) classes[i].getClassLoader()).getAppName ();
+
+        for (int i = 0; i < classes.length; i++) {
+            if (classes[i].getClassLoader() instanceof AppClassLoader) {
+                return ((AppClassLoader) classes[i].getClassLoader()).getAppName();
             }
+        }
+
         // no application class loader found in stack - return null
         return null;
     }
-
 }

src/helma/main/HelmaShutdownHook.java

@@ -1,4 +1,19 @@
-// HelmaShutdownHook.java
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
+
 package helma.main;
 
 import helma.util.Logger;
@@ -8,23 +23,35 @@ import java.util.List;
  * ShutdownHook that shuts down all running Helma applications on exit.
  */
 public class HelmaShutdownHook extends Thread {
-
     ApplicationManager appmgr;
 
-    public HelmaShutdownHook (ApplicationManager appmgr) {
+    /**
+     * Creates a new HelmaShutdownHook object.
+     *
+     * @param appmgr ...
+     */
+    public HelmaShutdownHook(ApplicationManager appmgr) {
         this.appmgr = appmgr;
     }
 
-    public void run () {
+    /**
+     *
+     */
+    public void run() {
         Logger logger = Server.getLogger();
-	if (logger != null)
-	    logger.log ("Shutting down Helma");
-	appmgr.stopAll ();
-	List loggers = Logger.getLoggers();
-	int l = loggers.size();
-	for (int i=0; i<l; i++)
-	    ((Logger) loggers.get(i)).close();
-	Logger.wakeup();
+
+        if (logger != null) {
+            logger.log("Shutting down Helma");
         }
 
+        appmgr.stopAll();
+
+        List loggers = Logger.getLoggers();
+        int l = loggers.size();
+
+        for (int i = 0; i < l; i++)
+            ((Logger) loggers.get(i)).close();
+
+        Logger.wakeup();
+    }
 }

src/helma/main/HelmaSocketFactory.java

@@ -1,42 +1,79 @@
-// HopSocketFactory.java
-// Copyright (c) Hannes Wallnöfer 1999-2000
-
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.main;
 
 import helma.util.*;
+import java.io.IOException;
 import java.net.*;
 import java.rmi.server.*;
-import java.io.IOException;
 
 /**
  * An RMI socket factory that has a "paranoid" option to filter clients.
  * We only do direct connections, no HTTP proxy stuff, since this is
  * server-to-server.
  */
-
 public class HelmaSocketFactory extends RMISocketFactory {
-
     private InetAddressFilter filter;
 
-    public HelmaSocketFactory () {
-	filter = new InetAddressFilter ();
+    /**
+     * Creates a new HelmaSocketFactory object.
+     */
+    public HelmaSocketFactory() {
+        filter = new InetAddressFilter();
     }
 
-    public void addAddress (String address) {
+    /**
+     *
+     *
+     * @param address ...
+     */
+    public void addAddress(String address) {
         try {
-	    filter.addAddress (address);
+            filter.addAddress(address);
         } catch (IOException x) {
-	    Server.getLogger().log ("Could not add "+address+" to Socket Filter: invalid address.");
+            Server.getLogger().log("Could not add " + address +
+                                   " to Socket Filter: invalid address.");
         }
     }
 
+    /**
+     *
+     *
+     * @param host ...
+     * @param port ...
+     *
+     * @return ...
+     *
+     * @throws IOException ...
+     */
     public Socket createSocket(String host, int port) throws IOException {
-	return new Socket (host, port);
+        return new Socket(host, port);
     }
 
+    /**
+     *
+     *
+     * @param port ...
+     *
+     * @return ...
+     *
+     * @throws IOException ...
+     */
     public ServerSocket createServerSocket(int port) throws IOException {
-	return new ParanoidServerSocket (port, filter);
+        return new ParanoidServerSocket(port, filter);
     }
-
 }

src/helma/main/Server.java

@@ -1,48 +1,63 @@
-// Server.java
-// Copyright (c) Hannes Wallnöfer 1998-2000
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.main;
 
-import java.io.*;
-import java.rmi.*;
-import java.rmi.server.*;
-import java.rmi.registry.*;
-import java.net.*;
-import java.util.*;
 import helma.extensions.HelmaExtension;
-import helma.objectmodel.db.DbSource;
 import helma.framework.*;
 import helma.framework.core.*;
+import helma.objectmodel.db.DbSource;
 import helma.util.*;
-import org.mortbay.http.*;
-import org.mortbay.util.*;
-import org.mortbay.http.ajp.*;
 import org.apache.xmlrpc.*;
+import org.mortbay.http.*;
+import org.mortbay.http.ajp.*;
+import org.mortbay.util.*;
+import java.io.*;
+import java.net.*;
+import java.rmi.*;
+import java.rmi.registry.*;
+import java.rmi.server.*;
+import java.util.*;
 
 /**
  * Helma server main class.
  */
-
- public class Server implements IPathElement, Runnable {
-
-    public static final String version = "1.2.3 RC1 (2003/03/05)";
-    public final long starttime;
-
-    // if true we only accept RMI and XML-RPC connections from 
-    // explicitly listed hosts.
-    public boolean paranoid;
-
-    private ApplicationManager appManager;
-
-    private Vector extensions;
-
-    private Thread mainThread;
+public class Server implements IPathElement, Runnable {
+    public static final String version = "1.2.4 (2003/04/16)";
 
     // server-wide properties
     static SystemProperties appsProps;
     static SystemProperties dbProps;
     static SystemProperties sysProps;
 
+    // static server instance
+    private static Server server;
+    protected static File hopHome = null;
+
+    // our logger
+    private static Logger logger;
+    public final long starttime;
+
+    // if true we only accept RMI and XML-RPC connections from 
+    // explicitly listed hosts.
+    public boolean paranoid;
+    private ApplicationManager appManager;
+    private Vector extensions;
+    private Thread mainThread;
+
     // server ports
     int rmiPort = 0;
     int xmlrpcPort = 0;
@@ -52,14 +67,6 @@ import org.apache.xmlrpc.*;
     // map of server-wide database sources
     Hashtable dbSources;
 
-    // static server instance
-    private static Server server;
-
-    protected static File hopHome = null;
-
-    // our logger
-    private static Logger logger;
-
     // the embedded web server
     // protected Serve websrv;
     protected HttpServer http;
@@ -70,37 +77,12 @@ import org.apache.xmlrpc.*;
     // the XML-RPC server
     protected WebServer xmlrpc;
 
-
-
-    /**
-     *  static main entry point.
-     */
-    public static void main (String args[]) throws IOException {
-
-	// check if we are running on a Java 2 VM - otherwise exit with an error message
-	String javaVersion = System.getProperty ("java.version");
-	if (javaVersion == null || javaVersion.startsWith ("1.1") || javaVersion.startsWith ("1.0")) {
-	    System.err.println ("This version of Helma requires Java 1.2 or greater.");
-	    if (javaVersion == null) // don't think this will ever happen, but you never know
-	        System.err.println ("Your Java Runtime did not provide a version number. Please update to a more recent version.");
-	    else
-	        System.err.println ("Your Java Runtime is version "+javaVersion+". Please update to a more recent version.");
-	    System.exit (1);
-	}
-
-	// create new server instance
-	server = new Server (args);
-
-	// start the server main thread
-	server.start ();
-    }
-
     /**
      * Constructs a new Server instance with an array of command line options.
      */
-    public Server (String[] args) {
-
+    public Server(String[] args) {
         starttime = System.currentTimeMillis();
+
         String homeDir = null;
 
         boolean usageError = false;
@@ -111,40 +93,40 @@ import org.apache.xmlrpc.*;
         String appsPropfile = null;
 
         // parse arguments
-	for (int i=0; i<args.length; i++) {
-	    if (args[i].equals ("-h") && i+1<args.length)
+        for (int i = 0; i < args.length; i++) {
+            if (args[i].equals("-h") && ((i + 1) < args.length)) {
                 homeDir = args[++i];
-	    else if (args[i].equals ("-f") && i+1<args.length)
+            } else if (args[i].equals("-f") && ((i + 1) < args.length)) {
                 propfile = args[++i];
-	    else if (args[i].equals ("-p") && i+1<args.length) {
+            } else if (args[i].equals("-p") && ((i + 1) < args.length)) {
                 try {
-	            rmiPort = Integer.parseInt (args[++i]);
+                    rmiPort = Integer.parseInt(args[++i]);
                 } catch (Exception portx) {
                     usageError = true;
                 }
-	    } else if (args[i].equals ("-x") && i+1<args.length) {
+            } else if (args[i].equals("-x") && ((i + 1) < args.length)) {
                 try {
-	            xmlrpcPort = Integer.parseInt (args[++i]);
+                    xmlrpcPort = Integer.parseInt(args[++i]);
                 } catch (Exception portx) {
                     usageError = true;
                 }
-	    } else if (args[i].equals ("-w") && i+1<args.length) {
+            } else if (args[i].equals("-w") && ((i + 1) < args.length)) {
                 try {
-	            websrvPort = Integer.parseInt (args[++i]);
+                    websrvPort = Integer.parseInt(args[++i]);
                 } catch (Exception portx) {
                     usageError = true;
                 }
-	    } else if (args[i].equals ("-jk") && i+1<args.length) {
+            } else if (args[i].equals("-jk") && ((i + 1) < args.length)) {
                 try {
-	            ajp13Port = Integer.parseInt (args[++i]);
+                    ajp13Port = Integer.parseInt(args[++i]);
                 } catch (Exception portx) {
                     usageError = true;
                 }
-	    } else if (args[i].equals ("-i") && i+1<args.length) {
+            } else if (args[i].equals("-i") && ((i + 1) < args.length)) {
                 // eat away the -i parameter which is meant for helma.main.launcher.Main
                 i++;
             } else {
-	        System.err.println ("Unknown command line token: "+args[i]);
+                System.err.println("Unknown command line token: " + args[i]);
                 usageError = true;
             }
         }
@@ -152,83 +134,107 @@ import org.apache.xmlrpc.*;
         // get main property file from home dir or vice versa, depending on what we have.
         // get property file from hopHome
         if (propfile == null) {
-	    if (homeDir != null)
-	        propfile = new File (homeDir, "server.properties").getAbsolutePath ();
-	    else
-	        propfile = new File ("server.properties").getAbsolutePath ();
+            if (homeDir != null) {
+                propfile = new File(homeDir, "server.properties").getAbsolutePath();
+            } else {
+                propfile = new File("server.properties").getAbsolutePath();
             }
+        }
+
         // create system properties
-	sysProps = new SystemProperties (propfile);
+        sysProps = new SystemProperties(propfile);
 
         // check if there's a property setting for those ports not specified via command line
-	if (websrvPort == 0 && sysProps.getProperty ("webPort") != null) try {
-	    websrvPort = Integer.parseInt (sysProps.getProperty ("webPort"));
+        if ((websrvPort == 0) && (sysProps.getProperty("webPort") != null)) {
+            try {
+                websrvPort = Integer.parseInt(sysProps.getProperty("webPort"));
             } catch (NumberFormatException fmt) {
-	    System.err.println ("Error parsing web server port property: "+fmt);
+                System.err.println("Error parsing web server port property: " + fmt);
             }
-	if (ajp13Port == 0 && sysProps.getProperty ("ajp13Port") != null) try {
-	    ajp13Port = Integer.parseInt (sysProps.getProperty ("ajp13Port"));
-	} catch (NumberFormatException fmt) {
-	    System.err.println ("Error parsing AJP1.3 server port property: "+fmt);
         }
-	if (rmiPort == 0 && sysProps.getProperty ("rmiPort") != null) try {
-	    rmiPort = Integer.parseInt (sysProps.getProperty ("rmiPort"));
+
+        if ((ajp13Port == 0) && (sysProps.getProperty("ajp13Port") != null)) {
+            try {
+                ajp13Port = Integer.parseInt(sysProps.getProperty("ajp13Port"));
             } catch (NumberFormatException fmt) {
-	    System.err.println ("Error parsing RMI server port property: "+fmt);
+                System.err.println("Error parsing AJP1.3 server port property: " + fmt);
             }
-	if (xmlrpcPort == 0 && sysProps.getProperty ("xmlrpcPort") != null) try {
-	    xmlrpcPort = Integer.parseInt (sysProps.getProperty ("xmlrpcPort"));
+        }
+
+        if ((rmiPort == 0) && (sysProps.getProperty("rmiPort") != null)) {
+            try {
+                rmiPort = Integer.parseInt(sysProps.getProperty("rmiPort"));
             } catch (NumberFormatException fmt) {
-	    System.err.println ("Error parsing XML-RPC server port property: "+fmt);
+                System.err.println("Error parsing RMI server port property: " + fmt);
+            }
+        }
+
+        if ((xmlrpcPort == 0) && (sysProps.getProperty("xmlrpcPort") != null)) {
+            try {
+                xmlrpcPort = Integer.parseInt(sysProps.getProperty("xmlrpcPort"));
+            } catch (NumberFormatException fmt) {
+                System.err.println("Error parsing XML-RPC server port property: " + fmt);
+            }
         }
 
         // check server ports. If no port is set, issue a warning and exit.
-	if (!usageError && (websrvPort | ajp13Port | rmiPort | xmlrpcPort) == 0) {
-	    System.out.println ("  Error: No server port specified.");
+        if (!usageError && ((websrvPort | ajp13Port | rmiPort | xmlrpcPort) == 0)) {
+            System.out.println("  Error: No server port specified.");
             usageError = true;
         }
 
         // if there's a usage error, output message and exit
-	if (usageError ) {
-	    System.out.println ("usage: java helma.main.Server [-h dir] [-f file] [-p port] [-w port] [-x port]");
-	    System.out.println ("  -h dir     Specify hop home directory");
-	    System.out.println ("  -f file    Specify server.properties file");
-	    System.out.println ("  -p port    Specify RMI port number");
-	    System.out.println ("  -w port    Specify port number for embedded Web server");
-	    System.out.println ("  -x port    Specify XML-RPC port number");
-	    System.out.println ("  -jk port   Specify AJP13 port number");
-	    System.err.println ("Usage Error - exiting");
-	    System.exit (0);
+        if (usageError) {
+            System.out.println("usage: java helma.main.Server [-h dir] [-f file] [-p port] [-w port] [-x port]");
+            System.out.println("  -h dir     Specify hop home directory");
+            System.out.println("  -f file    Specify server.properties file");
+            System.out.println("  -p port    Specify RMI port number");
+            System.out.println("  -w port    Specify port number for embedded Web server");
+            System.out.println("  -x port    Specify XML-RPC port number");
+            System.out.println("  -jk port   Specify AJP13 port number");
+            System.err.println("Usage Error - exiting");
+            System.exit(0);
         }
 
         // check if any of the specified server ports is in use already
         try {
-	    if (websrvPort > 0)
-	        checkRunning (websrvPort);
-	    if (rmiPort > 0)
-	        checkRunning (rmiPort);
-	    if (xmlrpcPort > 0)
-	        checkRunning (xmlrpcPort);
-	    if (ajp13Port > 0)
-	        checkRunning (ajp13Port);
+            if (websrvPort > 0) {
+                checkRunning(websrvPort);
+            }
+
+            if (rmiPort > 0) {
+                checkRunning(rmiPort);
+            }
+
+            if (xmlrpcPort > 0) {
+                checkRunning(xmlrpcPort);
+            }
+
+            if (ajp13Port > 0) {
+                checkRunning(ajp13Port);
+            }
         } catch (Exception running) {
-	    System.out.println (running.getMessage ());
-	    System.exit (1);
+            System.out.println(running.getMessage());
+            System.exit(1);
         }
 
         // get hopHome from property file
-	if (homeDir == null)
-	    homeDir = sysProps.getProperty ("hophome");
-	if (homeDir == null)
-	    homeDir =  new File (propfile).getParent ();
+        if (homeDir == null) {
+            homeDir = sysProps.getProperty("hophome");
+        }
+
+        if (homeDir == null) {
+            homeDir = new File(propfile).getParent();
+        }
 
         // create hopHome File object
-	hopHome = new File (homeDir);
+        hopHome = new File(homeDir);
+
         // try to transform hopHome directory to its cononical representation
         try {
-	    hopHome = hopHome.getCanonicalFile ();
+            hopHome = hopHome.getCanonicalFile();
         } catch (IOException iox) {
-	    System.err.println ("Error calling getCanonicalFile() on hopHome: "+iox);
+            System.err.println("Error calling getCanonicalFile() on hopHome: " + iox);
         }
 
         // set the current working directory to the helma home dir.
@@ -236,79 +242,120 @@ import org.apache.xmlrpc.*;
         // by java. It makes sure relative to absolute path name
         // conversion is done right, so for Helma code, this should
         // work.
-	System.setProperty ("user.dir", hopHome.getPath());
+        System.setProperty("user.dir", hopHome.getPath());
 
         // from now on it's safe to call getLogger() because hopHome is set up
+        String startMessage = "Starting Helma " + version + " on Java " +
+                              System.getProperty("java.version");
+
+        getLogger().log(startMessage);
 
-	String startMessage = "Starting Helma "+version+
-		" on Java "+System.getProperty ("java.version");
-	getLogger().log (startMessage);
         // also print a msg to System.out
-	System.out.println (startMessage);
+        System.out.println(startMessage);
 
-	getLogger().log ("propfile = "+propfile);
-	getLogger().log ("hopHome = "+hopHome);
+        getLogger().log("propfile = " + propfile);
+        getLogger().log("hopHome = " + hopHome);
 
+        File helper = new File(hopHome, "db.properties");
 
-	File helper = new File (hopHome, "db.properties");
-	dbPropfile = helper.getAbsolutePath ();
-	dbProps = new SystemProperties (dbPropfile);
-	DbSource.setDefaultProps (dbProps);
-	getLogger().log ("dbPropfile = "+dbPropfile);
+        dbPropfile = helper.getAbsolutePath();
+        dbProps = new SystemProperties(dbPropfile);
+        DbSource.setDefaultProps(dbProps);
+        getLogger().log("dbPropfile = " + dbPropfile);
 
-	appsPropfile = sysProps.getProperty ("appsPropFile");
-	if (appsPropfile != null && !"".equals (appsPropfile.trim()))
-	    helper = new File (appsPropfile);
-	else
-	    helper = new File (hopHome, "apps.properties");
-	appsPropfile = helper.getAbsolutePath ();
-	appsProps = new SystemProperties (appsPropfile);
-	getLogger().log ("appsPropfile = "+appsPropfile);
+        appsPropfile = sysProps.getProperty("appsPropFile");
 
-	paranoid = "true".equalsIgnoreCase (sysProps.getProperty ("paranoid"));
+        if ((appsPropfile != null) && !"".equals(appsPropfile.trim())) {
+            helper = new File(appsPropfile);
+        } else {
+            helper = new File(hopHome, "apps.properties");
+        }
 
-	String language = sysProps.getProperty ("language");
-	String country = sysProps.getProperty ("country");
-	String timezone = sysProps.getProperty ("timezone");
+        appsPropfile = helper.getAbsolutePath();
+        appsProps = new SystemProperties(appsPropfile);
+        getLogger().log("appsPropfile = " + appsPropfile);
 
-	if (language != null && country != null)
-	    Locale.setDefault (new Locale (language, country));
-	if (timezone != null)
-	    TimeZone.setDefault (TimeZone.getTimeZone (timezone));
+        paranoid = "true".equalsIgnoreCase(sysProps.getProperty("paranoid"));
 
-	getLogger().log ("Locale = "+Locale.getDefault());
-	getLogger().log ("TimeZone = "+TimeZone.getDefault().getDisplayName (Locale.getDefault ()));
+        String language = sysProps.getProperty("language");
+        String country = sysProps.getProperty("country");
+        String timezone = sysProps.getProperty("timezone");
 
-	dbSources = new Hashtable ();
+        if ((language != null) && (country != null)) {
+            Locale.setDefault(new Locale(language, country));
+        }
+
+        if (timezone != null) {
+            TimeZone.setDefault(TimeZone.getTimeZone(timezone));
+        }
+
+        getLogger().log("Locale = " + Locale.getDefault());
+        getLogger().log("TimeZone = " +
+                        TimeZone.getDefault().getDisplayName(Locale.getDefault()));
+
+        dbSources = new Hashtable();
 
         // try to load the extensions
-	extensions = new Vector ();
-	if (sysProps.getProperty ("extensions")!=null) {
-	    StringTokenizer tok=new StringTokenizer (sysProps.getProperty ("extensions"),",");
-	    while(tok.hasMoreTokens ()) {
-	        String extClassName = tok.nextToken ().trim ();
+        extensions = new Vector();
+
+        if (sysProps.getProperty("extensions") != null) {
+            StringTokenizer tok = new StringTokenizer(sysProps.getProperty("extensions"),
+                                                      ",");
+
+            while (tok.hasMoreTokens()) {
+                String extClassName = tok.nextToken().trim();
+
                 try {
-	            Class extClass = Class.forName (extClassName);
-	            HelmaExtension ext = (HelmaExtension) extClass.newInstance ();
-	            ext.init (this);
-	            extensions.add (ext);
-	            getLogger ().log ("loaded: " + extClassName);
+                    Class extClass = Class.forName(extClassName);
+                    HelmaExtension ext = (HelmaExtension) extClass.newInstance();
+
+                    ext.init(this);
+                    extensions.add(ext);
+                    getLogger().log("loaded: " + extClassName);
                 } catch (Exception e) {
-	            getLogger ().log ("error:  " + extClassName + " (" + e.toString () + ")");
+                    getLogger().log("error:  " + extClassName + " (" + e.toString() +
+                                    ")");
+                }
             }
         }
     }
 
+    /**
+     *  static main entry point.
+     */
+    public static void main(String[] args) throws IOException {
+        // check if we are running on a Java 2 VM - otherwise exit with an error message
+        String javaVersion = System.getProperty("java.version");
+
+        if ((javaVersion == null) || javaVersion.startsWith("1.1") ||
+                javaVersion.startsWith("1.0")) {
+            System.err.println("This version of Helma requires Java 1.2 or greater.");
+
+            if (javaVersion == null) { // don't think this will ever happen, but you never know
+                System.err.println("Your Java Runtime did not provide a version number. Please update to a more recent version.");
+            } else {
+                System.err.println("Your Java Runtime is version " + javaVersion +
+                                   ". Please update to a more recent version.");
             }
 
-    protected void start () {
+            System.exit(1);
+        }
+
+        // create new server instance
+        server = new Server(args);
+
+        // start the server main thread
+        server.start();
+    }
+
+    protected void start() {
         // Start running, finishing setup and then entering a loop to check changes
         // in the apps.properties file.
-	mainThread = new Thread (this);
-	mainThread.start ();
+        mainThread = new Thread(this);
+        mainThread.start();
     }
 
-    protected void stop () {
+    protected void stop() {
         mainThread = null;
     }
 
@@ -317,139 +364,179 @@ import org.apache.xmlrpc.*;
      *  periodically check for changes in the apps.properties file, shutting down
      *  apps or starting new ones.
      */
-    public void run () {
-
+    public void run() {
         try {
+            if ((websrvPort > 0) || (ajp13Port > 0)) {
+                http = new HttpServer();
 
-	    if (websrvPort > 0 || ajp13Port > 0) {
-	        http = new HttpServer ();
                 // disable Jetty logging  FIXME: seems to be a jetty bug; as soon
                 // as the logging is disabled, the more is logged
-	        Log.instance().disableLog ();
-	        Log.instance().add (new LogSink ()
-	            {
-	                public String getOptions () { return null; }
-	                public void log (String formattedLog) {}
-	                public void log (String tag, Object msg, Frame frame, long time) {}
-	                public void setOptions (String options) {}
-	                public boolean isStarted () { return true; }
-	                public void start () {}
-	                public void stop () {}
+                Log.instance().disableLog();
+                Log.instance().add(new LogSink() {
+                        public String getOptions() {
+                            return null;
                         }
-	        );
+
+                        public void log(String formattedLog) {
+                        }
+
+                        public void log(String tag, Object msg, Frame frame, long time) {
+                        }
+
+                        public void setOptions(String options) {
+                        }
+
+                        public boolean isStarted() {
+                            return true;
+                        }
+
+                        public void start() {
+                        }
+
+                        public void stop() {
+                        }
+                    });
             }
 
             // start embedded web server if port is specified
             if (websrvPort > 0) {
-	        http.addListener (new InetAddrPort (websrvPort));
+                http.addListener(new InetAddrPort(websrvPort));
             }
 
             // activate the ajp13-listener
             if (ajp13Port > 0) {
                 // create AJP13Listener
-	        ajp13 = new AJP13Listener(new InetAddrPort (ajp13Port));
+                ajp13 = new AJP13Listener(new InetAddrPort(ajp13Port));
                 ajp13.setHttpServer(http);
-	        String jkallow = sysProps.getProperty ("allowAJP13");
+
+                String jkallow = sysProps.getProperty("allowAJP13");
+
                 // by default the AJP13-connection just accepts requests from 127.0.0.1
-	        if (jkallow == null)
+                if (jkallow == null) {
                     jkallow = "127.0.0.1";
-	        StringTokenizer st = new StringTokenizer (jkallow, " ,;");
-	        String[] jkallowarr  = new String [st.countTokens()];
+                }
+
+                StringTokenizer st = new StringTokenizer(jkallow, " ,;");
+                String[] jkallowarr = new String[st.countTokens()];
                 int cnt = 0;
-	        while (st.hasMoreTokens ()) {
+
+                while (st.hasMoreTokens()) {
                     jkallowarr[cnt] = st.nextToken();
                     cnt++;
                 }
+
                 ajp13.setRemoteServers(jkallowarr);
-	        getLogger().log ("Starting AJP13-Listener on port "+(ajp13Port));
+                getLogger().log("Starting AJP13-Listener on port " + (ajp13Port));
             }
 
             if (xmlrpcPort > 0) {
-	        String xmlparser = sysProps.getProperty ("xmlparser");
-	        if (xmlparser != null)
-	            XmlRpc.setDriver (xmlparser);
+                String xmlparser = sysProps.getProperty("xmlparser");
+
+                if (xmlparser != null) {
+                    XmlRpc.setDriver(xmlparser);
+                }
+
+                xmlrpc = new WebServer(xmlrpcPort);
 
-	        xmlrpc = new WebServer (xmlrpcPort);
                 if (paranoid) {
-	            xmlrpc.setParanoid (true);
-	            String xallow = sysProps.getProperty ("allowXmlRpc");
+                    xmlrpc.setParanoid(true);
+
+                    String xallow = sysProps.getProperty("allowXmlRpc");
+
                     if (xallow != null) {
-	                StringTokenizer st = new StringTokenizer (xallow, " ,;");
-	                while (st.hasMoreTokens ())
-	                    xmlrpc.acceptClient (st.nextToken ());
+                        StringTokenizer st = new StringTokenizer(xallow, " ,;");
+
+                        while (st.hasMoreTokens())
+                            xmlrpc.acceptClient(st.nextToken());
                     }
                 }
-	        getLogger().log ("Starting XML-RPC server on port "+(xmlrpcPort));
-	    }
 
+                getLogger().log("Starting XML-RPC server on port " + (xmlrpcPort));
+            }
 
             if (rmiPort > 0) {
                 if (paranoid) {
-	            HelmaSocketFactory factory = new HelmaSocketFactory ();
-	            String rallow = sysProps.getProperty ("allowWeb");
+                    HelmaSocketFactory factory = new HelmaSocketFactory();
+                    String rallow = sysProps.getProperty("allowWeb");
+
                     if (rallow != null) {
-	                StringTokenizer st = new StringTokenizer (rallow, " ,;");
-	                while (st.hasMoreTokens ())
-	                    factory.addAddress (st.nextToken ());
+                        StringTokenizer st = new StringTokenizer(rallow, " ,;");
+
+                        while (st.hasMoreTokens())
+                            factory.addAddress(st.nextToken());
                     }
-	            RMISocketFactory.setSocketFactory (factory);
+
+                    RMISocketFactory.setSocketFactory(factory);
                 }
-	        getLogger().log ("Starting RMI server on port "+rmiPort);
-	        LocateRegistry.createRegistry (rmiPort);
+
+                getLogger().log("Starting RMI server on port " + rmiPort);
+                LocateRegistry.createRegistry(rmiPort);
             }
 
             // create application manager
-	    appManager = new ApplicationManager (rmiPort, hopHome, appsProps, this);
-	    if (xmlrpc != null)
-	        xmlrpc.addHandler ("$default", appManager);
+            appManager = new ApplicationManager(rmiPort, hopHome, appsProps, this);
+
+            if (xmlrpc != null) {
+                xmlrpc.addHandler("$default", appManager);
+            }
 
             // add shutdown hook to close running apps and servers on exit
-	    Runtime.getRuntime().addShutdownHook (new HelmaShutdownHook(appManager));
-
+            Runtime.getRuntime().addShutdownHook(new HelmaShutdownHook(appManager));
         } catch (Exception gx) {
-	    getLogger().log ("Error initializing embedded database: "+gx);
-	    gx.printStackTrace ();
+            getLogger().log("Error initializing embedded database: " + gx);
+            gx.printStackTrace();
+
             return;
         }
 
         // set the security manager. 
         // the default implementation is helma.main.HelmaSecurityManager.
         try {
-	    String secManClass = sysProps.getProperty ("securityManager");
+            String secManClass = sysProps.getProperty("securityManager");
+
             if (secManClass != null) {
-	        SecurityManager secMan = (SecurityManager) Class.forName(secManClass).newInstance ();
-	        System.setSecurityManager (secMan);
-	        getLogger().log ("Setting security manager to "+secManClass);
+                SecurityManager secMan = (SecurityManager) Class.forName(secManClass)
+                                                                .newInstance();
+
+                System.setSecurityManager(secMan);
+                getLogger().log("Setting security manager to " + secManClass);
             }
         } catch (Exception x) {
-	    getLogger().log ("Error setting security manager: "+x);
+            getLogger().log("Error setting security manager: " + x);
         }
 
         // start applications
-	appManager.startAll ();
+        appManager.startAll();
 
         // start embedded web server
-	if (http != null) try {
-	    http.start ();
+        if (http != null) {
+            try {
+                http.start();
             } catch (MultiException m) {
-	    getLogger().log ("Error starting embedded web server: "+m);
+                getLogger().log("Error starting embedded web server: " + m);
+            }
         }
 
-	if (ajp13 != null) try {
-	    ajp13.start ();
+        if (ajp13 != null) {
+            try {
+                ajp13.start();
             } catch (Exception m) {
-	    getLogger().log ("Error starting AJP13 listener: "+m);
+                getLogger().log("Error starting AJP13 listener: " + m);
+            }
         }
 
         int count = 0;
-	while (Thread.currentThread () == mainThread) {
+
+        while (Thread.currentThread() == mainThread) {
             try {
-	        mainThread.sleep (3000l);
-	    } catch (InterruptedException ie) {}
+                mainThread.sleep(3000L);
+            } catch (InterruptedException ie) {
+            }
+
             try {
-	        appManager.checkForChanges ();
+                appManager.checkForChanges();
             } catch (Exception x) {
-	        getLogger().log ("Caught in app manager loop: "+x);
+                getLogger().log("Caught in app manager loop: " + x);
             }
         }
     }
@@ -457,8 +544,8 @@ import org.apache.xmlrpc.*;
     /**
      *  Get an Iterator over the applications currently running on this Server.
      */
-    public Object[] getApplications () {
-	return appManager.getApplications ();
+    public Object[] getApplications() {
+        return appManager.getApplications();
     }
 
     /**
@@ -471,26 +558,31 @@ import org.apache.xmlrpc.*;
     /**
      *  Get a logger to use for output in this server.
      */
-    public static Logger getLogger () {
+    public static Logger getLogger() {
         if (logger == null) {
-	    String logDir = sysProps.getProperty ("logdir", "log");
-	    if ("console".equalsIgnoreCase (logDir)) {
-	        logger = new Logger (System.out);
+            String logDir = sysProps.getProperty("logdir", "log");
+
+            if ("console".equalsIgnoreCase(logDir)) {
+                logger = new Logger(System.out);
             } else {
-	        File helper = new File (logDir);
-	        if (hopHome != null && !helper.isAbsolute ())
-	            helper = new File (hopHome, logDir);
-	        logDir = helper.getAbsolutePath ();
-	        logger = Logger.getLogger (logDir, "hop");
+                File helper = new File(logDir);
+
+                if ((hopHome != null) && !helper.isAbsolute()) {
+                    helper = new File(hopHome, logDir);
+                }
+
+                logDir = helper.getAbsolutePath();
+                logger = Logger.getLogger(logDir, "hop");
             }
         }
+
         return logger;
     }
 
     /**
      *  Get the Home directory of this server.
      */
-    public File getHopHome () {
+    public File getHopHome() {
         return hopHome;
     }
 
@@ -511,47 +603,87 @@ import org.apache.xmlrpc.*;
     /**
      *  A primitive method to check whether a server is already running on our port.
      */
-    private void checkRunning (int portNumber) throws Exception {
+    private void checkRunning(int portNumber) throws Exception {
         try {
-	    java.net.Socket socket = new java.net.Socket ("localhost", portNumber);
+            java.net.Socket socket = new java.net.Socket("localhost", portNumber);
         } catch (Exception x) {
             return;
         }
+
         // if we got so far, another server is already running on this port and db
-	throw new Exception ("Error: Server already running on this port: " + portNumber);
+        throw new Exception("Error: Server already running on this port: " + portNumber);
     }
 
-	public String getProperty( String key )	{
-		return (String)sysProps.get(key);
+    /**
+     *
+     *
+     * @param key ...
+     *
+     * @return ...
+     */
+    public String getProperty(String key) {
+        return (String) sysProps.get(key);
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public SystemProperties getProperties() {
         return sysProps;
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public SystemProperties getDbProperties() {
         return dbProps;
     }
 
+    /**
+     *
+     *
+     * @return ...
+     */
     public File getAppsHome() {
-		String appHome = sysProps.getProperty ("appHome");
-		if (appHome != null && !"".equals (appHome.trim()))
-		    return new File (appHome);
-		else
-	    	return new File (hopHome, "apps");
+        String appHome = sysProps.getProperty("appHome");
+
+        if ((appHome != null) && !"".equals(appHome.trim())) {
+            return new File(appHome);
+        } else {
+            return new File(hopHome, "apps");
+        }
     }
 
-	public Vector getExtensions () {
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Vector getExtensions() {
         return extensions;
     }
 
+    /**
+     *
+     *
+     * @param name ...
+     */
     public void startApplication(String name) {
-		appManager.start (name);
-		appManager.register (name);
+        appManager.start(name);
+        appManager.register(name);
     }
 
+    /**
+     *
+     *
+     * @param name ...
+     */
     public void stopApplication(String name) {
-		appManager.stop (name);
+        appManager.stop(name);
     }
 
     /**
@@ -582,6 +714,4 @@ import org.apache.xmlrpc.*;
     public String getPrototype() {
         return "root";
     }
-	
 }
-

src/helma/main/launcher/FilteredClassLoader.java

@@ -1,20 +1,33 @@
-// FilteredClassLoader.java
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.main.launcher;
 
 import java.net.URL;
 import java.net.URLClassLoader;
-import java.util.Hashtable;
+import java.security.CodeSource;
 import java.security.PermissionCollection;
 import java.security.Permissions;
 import java.security.Policy;
-import java.security.CodeSource;
+import java.util.Hashtable;
 
 /**
  * ClassLoader that is able to exclude certain packages from loading.
  */
 public class FilteredClassLoader extends URLClassLoader {
-
     /**
      *  Create a server wide class loader that doesn't see the scripting engine(s)
      *  embedded in helma.jar. These files should be loaded by the per-application
@@ -22,15 +35,17 @@ public class FilteredClassLoader extends URLClassLoader {
      *  so that they can load classes from jar files in the app directories.
      */
     public FilteredClassLoader(URL[] urls) {
-	super (urls);
+        super(urls);
     }
 
     /**
      *  Mask classes that implement the scripting engine(s) contained in helma.jar
      */
-    protected Class findClass (String name) throws ClassNotFoundException {
-	if (name != null && "helma.scripting.fesi.PhantomEngine".equals (name))
-	    throw new ClassNotFoundException (name);
-	return super.findClass (name);
+    protected Class findClass(String name) throws ClassNotFoundException {
+        if ((name != null) && "helma.scripting.fesi.PhantomEngine".equals(name)) {
+            throw new ClassNotFoundException(name);
+        }
+
+        return super.findClass(name);
     }
 }

src/helma/main/launcher/Main.java

@@ -1,114 +1,145 @@
-// helma.main.Main
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.main.launcher;
 
-import java.net.URLClassLoader;
-import java.net.URL;
-import java.net.URLDecoder;
 import java.io.File;
 import java.io.FilenameFilter;
 import java.lang.reflect.Method;
-import java.util.ArrayList;
+import java.net.URL;
+import java.net.URLClassLoader;
+import java.net.URLDecoder;
 import java.security.Policy;
+import java.util.ArrayList;
 
 /**
  *  Helma bootstrap class. Figures out Helma home directory, sets up class path and
  *  lauchnes main class.
  */
 public class Main {
-
     public static final String[] jars = {
-        "helma.jar",
-        "jetty.jar",
-        "crimson.jar",
-        "xmlrpc.jar",
-        "servlet.jar",
-        "regexp.jar",
-        "mail.jar",
-        "activation.jar",
-        "netcomponents.jar",
-        "jimi.jar",
-        "apache-dom.jar",
-        "jdom.jar"
+                                            "helma.jar", "jetty.jar", "crimson.jar",
+                                            "xmlrpc.jar", "servlet.jar", "regexp.jar",
+                                            "mail.jar", "activation.jar",
+                                            "netcomponents.jar", "jimi.jar",
+                                            "apache-dom.jar", "jdom.jar"
                                         };
 
-
-    public static void main (String[] args) throws Exception {
-
+    /**
+     *
+     *
+     * @param args ...
+     *
+     * @throws Exception ...
+     */
+    public static void main(String[] args) throws Exception {
         // check if home directory is set via command line arg. If not,
         // we'll get it from the location of the jar file this class
         // has been loaded from.
         String installDir = null;
+
         // first, try to get helma home dir from command line options
-	for (int i=0; i<args.length; i++) {
-	    if (args[i].equals ("-i") && i+1<args.length) {
-	        installDir = args[i+1];
+        for (int i = 0; i < args.length; i++) {
+            if (args[i].equals("-i") && ((i + 1) < args.length)) {
+                installDir = args[i + 1];
             }
         }
+
         URLClassLoader apploader = (URLClassLoader) ClassLoader.getSystemClassLoader();
+
         // try to get Helma installation directory
         if (installDir == null) {
             try {
                 URL launcherUrl = apploader.findResource("helma/main/launcher/Main.class");
+
                 // this is a  JAR URL of the form
                 //    jar:<url>!/{entry}
                 // we strip away the jar: prefix and the !/{entry} suffix
                 // to get the original jar file URL
                 installDir = launcherUrl.toString().substring(4);
-	        int excl = installDir.indexOf ("!");
+
+                int excl = installDir.indexOf("!");
+
                 if (excl > -1) {
                     installDir = installDir.substring(0, excl);
-	            launcherUrl = new URL (installDir);
-	            File f = new File (launcherUrl.getPath());
+                    launcherUrl = new URL(installDir);
+
+                    File f = new File(launcherUrl.getPath());
+
                     installDir = f.getParentFile().getCanonicalPath();
                 }
             } catch (Exception x) {
                 // unable to get Helma installation dir from launcher jar
-	        System.err.println ("Unable to get Helma installation directory: "+x);
-	        System.exit (2);
+                System.err.println("Unable to get Helma installation directory: " + x);
+                System.exit(2);
             }
         }
 
         // decode installDir in case it is URL-encoded
-	installDir = URLDecoder.decode (installDir);
+        installDir = URLDecoder.decode(installDir);
 
         // set up the class path
-	File libdir = new File (installDir, "lib");
-	ArrayList jarlist = new ArrayList ();
-	for (int i=0;i<jars.length;i++) {
-	    File jar = new File (libdir, jars[i]);
-	    jarlist.add (new URL ("file:" + jar.getAbsolutePath()));
+        File libdir = new File(installDir, "lib");
+        ArrayList jarlist = new ArrayList();
+
+        for (int i = 0; i < jars.length; i++) {
+            File jar = new File(libdir, jars[i]);
+
+            jarlist.add(new URL("file:" + jar.getAbsolutePath()));
         }
+
         // add all jar files from the lib/ext directory
-	File extdir =new File (libdir, "ext");
-	File[] files = extdir.listFiles (new FilenameFilter() {
-	    public boolean accept (File dir, String name) {
+        File extdir = new File(libdir, "ext");
+        File[] files = extdir.listFiles(new FilenameFilter() {
+                public boolean accept(File dir, String name) {
                     String n = name.toLowerCase();
-	        return n.endsWith (".jar") || n.endsWith (".zip");
+
+                    return n.endsWith(".jar") || n.endsWith(".zip");
                 }
             });
-	if (files != null)
-	    for (int i=0;i<files.length; i++) {
+
+        if (files != null) {
+            for (int i = 0; i < files.length; i++) {
                 // WORKAROUND: add the files in lib/ext before
                 // lib/apache-dom.jar, since otherwise putting a full version
                 // of Xerces in lib/ext would cause a version conflict with the
                 // xerces classes in lib/apache-dom.jar. Generally, having some pieces
                 // of Xerces in lib/apache-dom.jar is kind of problematic.
-	        jarlist.add (jars.length-3, new URL ("file:" + files[i].getAbsolutePath()));
-	        System.err.println ("Adding to classpath: "+files[i].getAbsolutePath());
+                jarlist.add(jars.length - 3, new URL("file:" +
+                                                     files[i].getAbsolutePath()));
+                System.err.println("Adding to classpath: " + files[i].getAbsolutePath());
             }
-	URL[] urls = new URL[jarlist.size()];
-	jarlist.toArray (urls);
-	FilteredClassLoader loader = new FilteredClassLoader (urls);
-	// set the new class loader as context class loader
-	Thread.currentThread().setContextClassLoader (loader);
-	// get the main server class
-	Class clazz = loader.loadClass ("helma.main.Server");
-	Class[] cargs = new Class[] { args.getClass() };
-	Method main = clazz.getMethod ("main", cargs);
-	Object[] nargs = new Object[] { args };
-	// run
-	main.invoke (null, nargs);
         }
 
+        URL[] urls = new URL[jarlist.size()];
+
+        jarlist.toArray(urls);
+
+        FilteredClassLoader loader = new FilteredClassLoader(urls);
+
+        // set the new class loader as context class loader
+        Thread.currentThread().setContextClassLoader(loader);
+
+        // get the main server class
+        Class clazz = loader.loadClass("helma.main.Server");
+        Class[] cargs = new Class[] { args.getClass() };
+        Method main = clazz.getMethod("main", cargs);
+        Object[] nargs = new Object[] { args };
+
+        // run
+        main.invoke(null, nargs);
+    }
 }

src/helma/objectmodel/ConcurrencyException.java

@@ -1,5 +1,18 @@
-// ConcurrencyException.java
-// Copyright (c) Hannes Wallnöfer 1998-2000
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.objectmodel;
 
@@ -8,44 +21,13 @@ package helma.objectmodel;
  * Thrown when more than one thrad tries to modify a Node. The evaluator
  * will normally catch this and try again after a period of time.
  */
- 
 public class ConcurrencyException extends RuntimeException {
-
-    public ConcurrencyException (String msg) {
-	super (msg);
+    /**
+     * Creates a new ConcurrencyException object.
+     *
+     * @param msg ...
+     */
+    public ConcurrencyException(String msg) {
+        super(msg);
     }
-
 }
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

src/helma/objectmodel/DatabaseException.java

@@ -1,4 +1,18 @@
-// DatabaseException.java
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.objectmodel;
 
@@ -6,44 +20,13 @@ package helma.objectmodel;
 /**
  * Thrown on any kind of Database-Error
  */
- 
 public class DatabaseException extends RuntimeException {
-
-    public DatabaseException (String msg) {
-	super (msg);
+    /**
+     * Creates a new DatabaseException object.
+     *
+     * @param msg ...
+     */
+    public DatabaseException(String msg) {
+        super(msg);
     }
-
 }
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

src/helma/objectmodel/IDatabase.java

@@ -1,35 +1,108 @@
-// IDatabase.java
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.objectmodel;
 
-import helma.objectmodel.db.IDGenerator;
 import helma.objectmodel.INode;
+import helma.objectmodel.db.IDGenerator;
+import java.io.IOException;
+import org.xml.sax.SAXException;
+import javax.xml.parsers.ParserConfigurationException;
 
 /**
  * Interface that is implemented by Database wrappers
  */
- 
 public interface IDatabase {
-
     // db-related
-    public void shutdown ();
+    public void shutdown();
 
     // id-related
     public String nextID() throws ObjectNotFoundException;
-    public IDGenerator getIDGenerator  (ITransaction transaction) throws Exception;
-	public void        saveIDGenerator (ITransaction transaction, IDGenerator idgen) throws Exception;
+
+    /**
+     *
+     *
+     * @param transaction ...
+     *
+     * @return ...
+     *
+     * @throws IOException ...
+     */
+    public IDGenerator getIDGenerator(ITransaction transaction)
+                throws IOException, ObjectNotFoundException;
+
+    /**
+     *
+     *
+     * @param transaction ...
+     * @param idgen ...
+     *
+     * @throws IOException ...
+     */
+    public void saveIDGenerator(ITransaction transaction, IDGenerator idgen)
+                 throws IOException;
 
     // node-related
-    public INode getNode    (ITransaction transaction, String key) throws Exception;
-    public void  saveNode   (ITransaction transaction, String key, INode node) throws Exception;
-    public void  deleteNode (ITransaction transaction, String key) throws Exception;
+    public INode getNode(ITransaction transaction, String key)
+                  throws IOException, ObjectNotFoundException,
+                         SAXException, ParserConfigurationException;
+
+    /**
+     *
+     *
+     * @param transaction ...
+     * @param key ...
+     * @param node ...
+     *
+     * @throws IOException ...
+     */
+    public void saveNode(ITransaction transaction, String key, INode node)
+                  throws IOException;
+
+    /**
+     *
+     *
+     * @param transaction ...
+     * @param key ...
+     *
+     * @throws IOException ...
+     */
+    public void deleteNode(ITransaction transaction, String key)
+                    throws IOException;
 
     // transaction-related
-    public ITransaction beginTransaction  ();
-    public void         commitTransaction (ITransaction transaction) throws DatabaseException;
-    public void         abortTransaction  (ITransaction transaction) throws DatabaseException;
+    public ITransaction beginTransaction();
 
+    /**
+     *
+     *
+     * @param transaction ...
+     *
+     * @throws DatabaseException ...
+     */
+    public void commitTransaction(ITransaction transaction)
+                           throws DatabaseException;
+
+    /**
+     *
+     *
+     * @param transaction ...
+     *
+     * @throws DatabaseException ...
+     */
+    public void abortTransaction(ITransaction transaction)
+                          throws DatabaseException;
 }
-
-
-

src/helma/objectmodel/INode.java

@@ -1,88 +1,391 @@
-// INode.java
-// Copyright (c) Hannes Wallnöfer 1998-2000
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.objectmodel;
 
-import java.util.*;
-import java.io.*;
 import helma.framework.IPathElement;
 import helma.objectmodel.db.DbMapping;
+import java.io.*;
+import java.util.*;
 
 /**
  * Interface that all Nodes implement. Currently, there are two implementations:
  * Transient nodes which only exist in memory, and persistent Nodes, which are
  * stored in a database (either the internal Object DB or an external relational DB).
  */
- 
 public interface INode extends INodeState, IPathElement {
-
-
     /**
      *  id-related methods
      */
+    public String getID();
 
-    public String getID ();
-    public String getName ();
-    public void setDbMapping (DbMapping dbmap);
-    public DbMapping getDbMapping ();
-    public int getState ();
-    public void setState (int s);
-    public void setName (String name);
-    public long lastModified ();
-    public long created ();
-    public boolean isAnonymous (); // is this a named node, or an anonymous node in a collection?
-    public String getPrototype ();
-    public void setPrototype (String prototype);
-    public INode getCacheNode ();
-    public void clearCacheNode ();
-    public String getFullName ();
-    public String getFullName (INode root);
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getName();
+
+    /**
+     *
+     *
+     * @param dbmap ...
+     */
+    public void setDbMapping(DbMapping dbmap);
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public DbMapping getDbMapping();
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public int getState();
+
+    /**
+     *
+     *
+     * @param s ...
+     */
+    public void setState(int s);
+
+    /**
+     *
+     *
+     * @param name ...
+     */
+    public void setName(String name);
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public long lastModified();
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public long created();
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public boolean isAnonymous(); // is this a named node, or an anonymous node in a collection?
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getPrototype();
+
+    /**
+     *
+     *
+     * @param prototype ...
+     */
+    public void setPrototype(String prototype);
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public INode getCacheNode();
+
+    /**
+     *
+     */
+    public void clearCacheNode();
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getFullName();
+
+    /**
+     *
+     *
+     * @param root ...
+     *
+     * @return ...
+     */
+    public String getFullName(INode root);
 
     /**
      *  node-related methods
      */
+    public INode getParent();
 
-    public INode getParent ();
-    public void setSubnodeRelation (String rel);
-    public String getSubnodeRelation ();
-    public int numberOfNodes ();
-    public INode addNode (INode node);
-    public INode addNode (INode node, int where);
-    public INode createNode (String name);
-    public INode createNode (String name, int where);
-    public Enumeration getSubnodes ();
-    public INode getSubnode (String name);
-    public INode getSubnodeAt (int index);
-    public int contains (INode node);
-    public boolean remove ();
-    public void removeNode (INode node);
+    /**
+     *
+     *
+     * @param rel ...
+     */
+    public void setSubnodeRelation(String rel);
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public String getSubnodeRelation();
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public int numberOfNodes();
+
+    /**
+     *
+     *
+     * @param node ...
+     *
+     * @return ...
+     */
+    public INode addNode(INode node);
+
+    /**
+     *
+     *
+     * @param node ...
+     * @param where ...
+     *
+     * @return ...
+     */
+    public INode addNode(INode node, int where);
+
+    /**
+     *
+     *
+     * @param name ...
+     *
+     * @return ...
+     */
+    public INode createNode(String name);
+
+    /**
+     *
+     *
+     * @param name ...
+     * @param where ...
+     *
+     * @return ...
+     */
+    public INode createNode(String name, int where);
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public Enumeration getSubnodes();
+
+    /**
+     *
+     *
+     * @param name ...
+     *
+     * @return ...
+     */
+    public INode getSubnode(String name);
+
+    /**
+     *
+     *
+     * @param index ...
+     *
+     * @return ...
+     */
+    public INode getSubnodeAt(int index);
+
+    /**
+     *
+     *
+     * @param node ...
+     *
+     * @return ...
+     */
+    public int contains(INode node);
+
+    /**
+     *
+     *
+     * @return ...
+     */
+    public boolean remove();
+
+    /**
+     *
+     *
+     * @param node ...
+     */
+    public void removeNode(INode node);
 
     /**
      *  property-related methods
      */
+    public Enumeration properties();
 
-    public Enumeration properties ();
-    public IProperty get (String name);
-    public String getString (String name);
-    public boolean getBoolean (String name);
-    public Date getDate (String name);
-    public long getInteger (String name);
-    public double getFloat (String name);
-    public INode getNode (String name);
-    public Object getJavaObject (String name);
+    /**
+     *
+     *
+     * @param name ...
+     *
+     * @return ...
+     */
+    public IProperty get(String name);
 
-    public void setString (String name, String value);
-    public void setBoolean (String name, boolean value);
-    public void setDate (String name, Date value);
-    public void setInteger (String name, long value);
-    public void setFloat (String name, double value);
-    public void setNode (String name, INode value);
-    public void setJavaObject (String name, Object value);
+    /**
+     *
+     *
+     * @param name ...
+     *
+     * @return ...
+     */
+    public String getString(String name);
 
-    public void unset (String name);
+    /**
+     *
+     *
+     * @param name ...
+     *
+     * @return ...
+     */
+    public boolean getBoolean(String name);
 
+    /**
+     *
+     *
+     * @param name ...
+     *
+     * @return ...
+     */
+    public Date getDate(String name);
+
+    /**
+     *
+     *
+     * @param name ...
+     *
+     * @return ...
+     */
+    public long getInteger(String name);
+
+    /**
+     *
+     *
+     * @param name ...
+     *
+     * @return ...
+     */
+    public double getFloat(String name);
+
+    /**
+     *
+     *
+     * @param name ...
+     *
+     * @return ...
+     */
+    public INode getNode(String name);
+
+    /**
+     *
+     *
+     * @param name ...
+     *
+     * @return ...
+     */
+    public Object getJavaObject(String name);
+
+    /**
+     *
+     *
+     * @param name ...
+     * @param value ...
+     */
+    public void setString(String name, String value);
+
+    /**
+     *
+     *
+     * @param name ...
+     * @param value ...
+     */
+    public void setBoolean(String name, boolean value);
+
+    /**
+     *
+     *
+     * @param name ...
+     * @param value ...
+     */
+    public void setDate(String name, Date value);
+
+    /**
+     *
+     *
+     * @param name ...
+     * @param value ...
+     */
+    public void setInteger(String name, long value);
+
+    /**
+     *
+     *
+     * @param name ...
+     * @param value ...
+     */
+    public void setFloat(String name, double value);
+
+    /**
+     *
+     *
+     * @param name ...
+     * @param value ...
+     */
+    public void setNode(String name, INode value);
+
+    /**
+     *
+     *
+     * @param name ...
+     * @param value ...
+     */
+    public void setJavaObject(String name, Object value);
+
+    /**
+     *
+     *
+     * @param name ...
+     */
+    public void unset(String name);
 }
-
-
-
-

src/helma/objectmodel/INodeState.java

@@ -1,17 +1,28 @@
-// INodeState.java
-// Copyright (c) Hannes Wallnöfer 2001
+/*
+ * Helma License Notice
+ *
+ * The contents of this file are subject to the Helma License
+ * Version 2.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://adele.helma.org/download/helma/license.txt
+ *
+ * Copyright 1998-2003 Helma Software. All Rights Reserved.
+ *
+ * $RCSfile$
+ * $Author$
+ * $Revision$
+ * $Date$
+ */
 
 package helma.objectmodel;
 
-import java.util.*;
 import java.io.*;
+import java.util.*;
 
 /**
  * Interface that defines states of nodes
  */
- 
 public interface INodeState {
-
     public final static int TRANSIENT = -3;
     public final static int VIRTUAL = -2;
     public final static int INVALID = -1;
@@ -19,9 +30,4 @@ public interface INodeState {
     public final static int NEW = 1;
     public final static int MODIFIED = 2;
     public final static int DELETED = 3;
-
 }
-
-
-
-