Return to JSArray.java CVS log

Up to [Repository] / edoc-applet / com / exploringxml / xml

First checkin.

/* Copyright (c) 2000 Michael Claßen <mclassen@internet.com>
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 *
 * $Id: JSArray.java,v 1.1.1.1 2003/06/17 10:38:55 rogo Exp $
 */

package com.exploringxml.xml;

import java.util.Hashtable;
import java.util.Vector;

/**
 * Mimics a Javascript array;
 * not completely generic because only specific properties are allowed
 * <p>would need Reflection to make it completely generic
 *
 * @author    Michael Claßen
 * @version   $Revision: 1.1.1.1 $
 */
public class JSArray {

  // underlying element holder
  public Vector v = new Vector();

  // constants for the currently supported object properties
  static final String Name = "name";
  static final String Attributes = "attributes";
  static final String Contents = "contents";
  static final String Value = "value";

  /**
   * gets the object with a certain index
   *
   * @param     idx the object's index in the array
   * @return    Object at the respective index
   */
  Object elementAt(int idx) {
    return v.elementAt(idx);
  }

  /**
   * sets the object with a certain index
   *
   * @param     val the object to be set in the array
   * @param     idx the object's index in the array
   */
  void setElementAt(Object val, int idx) {
    v.insertElementAt(val, idx);
  }

  /**
   * sets the object with a certain index
   *
   * @param     val the object' property to be set
   * @param     idx the object's index in the array
   * @param     prop the name of the object's property to be set;
   *            currently can only be: name, attributes, contents, value
   */
  void setElementAt(Object val, int idx, String prop) {
    Node n = (Node) v.elementAt(idx);
    if (prop == Name) {
      n.name = (String) val;
    }
    else if (prop == Attributes) {
      n.attributes = (Hashtable) val;
    }
    else if (prop == Contents) {
      n.contents = (JSArray) val;
    }
    else if (prop == Value) {
      n.value = (String) val;
    }
  }

  /**
   * returns the length / size of the array
   *
   * @return    the array length
   */
public  int length() {
    return v.size();
  }

  /**
   * splits a string into an array of strings, broken at a distinct separator
   *
   * @param     str the String to be split
   * @param     sep the seperator at which to split
   */
  void split(String str, String sep) {
    v.removeAllElements();
    int oldidx = 0, newidx, skip = sep.length();
    while((newidx = str.indexOf(sep, oldidx)) != -1) {
      v.addElement(str.substring(oldidx, newidx));
      oldidx = newidx + skip;
    }
    v.addElement(str.substring(oldidx));
  }

  /**
   * join this array into one string delimited by a separator
   *
   * @param     sep the seperator to put in between the array elements
   * @return    the joined String
   */
  String join(String sep) {
    int no = 0;
    StringBuffer sb = new StringBuffer();
    while (no < v.size()) {
      sb.append(v.elementAt(no));
      if (++no < v.size()) sb.append(sep);
    }
    return sb.toString();
  }

}