Metacat

/**

 *    Purpose: A Class that implements utility methods for a metadata catalog

 *  Copyright: 2000 Regents of the University of California and the

 *             National Center for Ecological Analysis and Synthesis

 *     '$Date$'

 * '$Revision$'

 * 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

package edu.ucsb.nceas.metacat;

import java.net.URL;

import java.net.MalformedURLException;

import java.sql.DriverManager;

import java.sql.SQLException;

import java.util.Enumeration;

 * A suite of utility classes for the metadata catalog server

 */

public class MetaCatUtil {

  private static String propertiesFile = "edu.ucsb.nceas.metacat.metacat";

   */

  static {

    try {

      System.err.println("Error in MetaCatUtil static block:" + e.getMessage());

    }

  }

   *

   * @param className the fully qualified name of the class to instantiate

    try {

      Class classDefinition = Class.forName(className);

      object = classDefinition.newInstance();

    } catch (InstantiationException e) {

      throw e;

    } catch (IllegalAccessException e) {

      throw e;

    } catch (ClassNotFoundException e) {

      throw e;

    }

    return object;

  }

   *

   * @param optionName the name of the option requested

   */

  public static String getOption(String optionName) {

      // Get the configuration file information

      if (options == null) {

        options = (PropertyResourceBundle)

      String value = (String)options.handleGetObject(optionName);

      return value;

   *

   * @param optionName the name of the option requested

   * @param propFile the name of the file where to get the properties from

    // Get the configuration file information

    PropertyResourceBundle options = (PropertyResourceBundle)

                                     PropertyResourceBundle.getBundle(propFile);

    String value = (String)options.handleGetObject(optionName);

    return value;

  public static URL fileToURL(File file)

  {

     String path = file.getAbsolutePath();

     String fSep = System.getProperty("file.separator");

     if (fSep != null && fSep.length() == 1)

       path = path.replace(fSep.charAt(0), '/');

     if (path.length() > 0 && path.charAt(0) != '/')

       path = '/' + path;

     try {

       return new URL("file", null, path);

     }

     catch (java.net.MalformedURLException e) {

       /* According to the spec this could only happen if the file

          protocol were not recognized. */

       throw new Error("unexpected MalformedURLException");

     }

  }

   * the name from the value (e.g., name=tom&zip=99801 ). Returns a

   * has of the name value pairs, hashed on name.

   */

  public static Hashtable parseQuery(String query) throws MalformedURLException

  {

    String[][] params = new String[200][2];

    Hashtable parameters = new Hashtable();

    String temp = "";

    boolean ampflag = true;

    boolean poundflag = false;

    int arrcount = 0;

          if (!poundflag && ampflag) {

            params[arrcount][0] = temp.trim();

            temp = "";

            throw new MalformedURLException("metacatURL: Two parameter names "+

                                            "not allowed in sequence");

          }

          poundflag = true;

          ampflag = false;

            }

            params[arrcount][1] = temp.trim();

            parameters.put(params[arrcount][0], params[arrcount][1]);

            temp = "";

            arrcount++; //increment the array to the next row.

            throw new MalformedURLException("metacatURL: Two parameter values "+

                                            "not allowed in sequence");

          }

          poundflag = false;

          ampflag = true;

          temp += query.charAt(i);

      }

    }

    return parameters;

  }

   * for this message. The number is fewer, the message is more important

   * @param msg, the content of the message

   * @param debugLevel, an integer indicating the message debug leve

   */

        limit=Integer.parseInt(getOption("debuglevel"));

      catch (Exception e)

      {

        System.out.println(e.getMessage());

      }

      //don't allow the user set debugLevel less than or equals 0

      if (debugLevel<=0)

      {

        debugLevel=1;

      }

      if (debugLevel < limit)

  }

  {

    Vector options = new Vector();

    if(optiontext.indexOf(",") == -1)

    {

      options.addElement(optiontext);

      return options;

    }

    {

      String s = optiontext.substring(0, optiontext.indexOf(","));

      options.addElement(s.trim());

      if(optiontext.indexOf(",") == -1)

      { //catch the last list entry

        options.addElement(optiontext.trim());

      }

    }

    return options;

  }

  public static String normalize(String s)

  {

    StringBuffer str = new StringBuffer();

    int len = (s != null) ? s.length() : 0;

    for (int i = 0; i < len; i++)

    {

      char ch = s.charAt(i);

      switch (ch)

      {

      case '<':

      {

        str.append("<");

        break;

      }

        case '>':

      {

        str.append(">");

        break;

      }

      case '&':

      {

        str.append("&");

        break;

      }

      case '"':

      {

        str.append(""");

        break;

      }

      case '\r':

      case '\n':

      {

        // else, default append char

      }

      default:

      {

        str.append(ch);

      }

      }

    }

    return (str.toString());

  /**

   * Get docid from online/url string

   */

  public static String getDocIdWithRevFromOnlineURL(String url)

  {

    String docid = null;

    String DOCID = "docid";

    boolean find = false;

    char limited = '&';

    int  count = 0; //keep track how many & was found

    Vector list = new Vector();// keep index number for &

    if (url == null)

    {

      MetaCatUtil.debugMessage("url is null and null will be returned", 30);

      return docid;

    }

    // the first element in list is 0

    list.add(new Integer(0));

    for (int i=0; i< url.length(); i++)

    {

      if (url.charAt(i) == limited)

      {

        // count plus 1

        count++;

        list.add(new Integer(i));

        // get substring beween two &

        String str = url.substring(((Integer)list.elementAt(count-1)).intValue(), i);

        MetaCatUtil.debugMessage("substring between two & is: " + str, 30);

        //if the subString contains docid, we got it

        if (str.indexOf(DOCID) != -1)

        {

          //get index of '="

          int start = getIndexForGivenChar(str, '=')+1;

          int end   = str.length();

          docid = str.substring(start, end);

          find = true;

        }//if

      }//if

    }//for

    //if not find, we need check the subtring between the index of last & and

    // the end of string

    if (!find)

    {

      MetaCatUtil.debugMessage("Checking the last substring", 35);

      String str = url.substring(((Integer)list.elementAt(count)).intValue() +1,

                                 url.length());

      MetaCatUtil.debugMessage("Last substring is: " + str, 30);

      if (str.indexOf(DOCID) != -1)

      {

          //get index of '="

          int start = getIndexForGivenChar(str, '=')+1;

          int end   = str.length();

          docid = str.substring(start, end);

          find = true;

      }//if

    }//if

    MetaCatUtil.debugMessage("The docid from online url is:"+ docid, 30);

    return docid.trim();

  }

  private static int getIndexForGivenChar(String str, char character)

  {

    int index = -1;

    // make sure str is not null

    if(str == null)

    {

      MetaCatUtil.debugMessage("The given str is null and -1 will be returned",

                                30);

      return index;

    }

    // got though the string

    for (int i=0; i<str.length(); i++)

    {

      // find the first one then break the loop

      if (str.charAt(i) == character)

      {

        index = i;

        break;

      }//if

    }//for

    MetaCatUtil.debugMessage("the index for char "+ character +

                             " is: "+index, 30);

    return index;

  }

   * @param string, the given string should be these two format:

   *              1) str1.str2  in this case docid= str1.str2

   *              2) str1.str2.str3, in this case docid =str1.str2

   * @param the sperator char

   */

  public static String getDocIdFromString(String str)

  {

    String docId = null;

    {

      MetaCatUtil.debugMessage("The given str is null and null will be returned"

                                +" in getDocIdfromString", 30);

      return docId;

    } //make sure docid is not null

    int indexOfLastDot = 0;

    char seperator=getOption("accNumSeparator").charAt(0);

    {

      if ( str.charAt(i)==seperator)

      {

        dotNumber++;//count how many dots

        indexOfLastDot=i;//keep the last dot postion

      }

    }//for

    //one seperator

    if ( dotNumber>2 || dotNumber < 1)

    {

      docId=null;

    }

    else if (dotNumber == 2) //the case for str1.str2.str3

    {

       docId=str.substring(0, indexOfLastDot);

    }

    else if (dotNumber == 1) //the case for str1.str2

    {

      docId=str;

    }

    return docId;

   * @param string, the given string should be these two format:

   *              1) str1.str2(no version)  version =-1;

   *              2) str1.str2.str3, in this case version = str3;

   *              3) other, vresion =-2

   */

  public static int getVersionFromString(String str)

                                throws NumberFormatException

  {

    int version=-1;

    String versionString=null;

    int dotNumber = 0;//count how many dots in given string

    int indexOfLastDot = 0;

    char seperator=getOption("accNumSeparator").charAt(0);

    {

      if ( str.charAt(i)==seperator)

      {

        dotNumber++;//count how many dots

        indexOfLastDot=i;//keep the last dot postion

      }

    }//for

    //one seperator

    if ( dotNumber>2 || dotNumber < 1)

    {

      version=-2;

    }

       versionString=str.substring((indexOfLastDot+1), str.length());

       version=Integer.parseInt(versionString);

    }

    else if (dotNumber == 1) //the case for str1.str2

    {

      version=-1;

    }

    return version;

  /**

   * @param string, the given string should be these two format:

   *              1) str1.str2(no version)  version=null;

   *              2) str1.str2.str3, in this case version = str3;

   *              3) other, vresion =null;

   */

  public static String getRevisionStringFromString(String str)

                                throws NumberFormatException

  {

    // String to store the version

    String versionString=null;

    int dotNumber = 0;//count how many dots in given string

    int indexOfLastDot = 0;

    char seperator=getOption("accNumSeparator").charAt(0);

    {

      if ( str.charAt(i)==seperator)

      {

        dotNumber++;//count how many dots

        indexOfLastDot=i;//keep the last dot postion

      }

    }//for

    //one seperator

    if ( dotNumber>2 || dotNumber < 1)

    {

      versionString = null;

    }

      //the case for str1.str2.str3

      // indexOfLastDot != (str.length() -1) means get rid of str1.str2.

      versionString=str.substring((indexOfLastDot+1), str.length());

    }

    else if (dotNumber == 1) //the case for str1.str2 or str1.str2.

    {

      versionString=null;

    }

    return versionString;

   */

     String replicationServerName=null;

     String serverHost=null;

     serverHost=getOption("server");

     // append "context/servelet/replication" to the host name

     replicationServerName=serverHost+getOption("replicationpath");

     return replicationServerName;

    * Method to get docidwithrev from eml2 inline data id

    * The eml inline data id would look like eml.200.2.3

    */

     if ( inlineDataID == null)

     {

       return docidWithoutRev;

     }

     int targetNumberOfSeperator = 2;// we  want to know his index

     int numberOfSeperator = 0;

     for (int i = 0; i< inlineDataID.length(); i++)

     {

       // meet seperator, increase number of seperator

       if (inlineDataID.charAt(i) == charSeperator)

       {

         numberOfSeperator++;

       }

       // if number of seperator reach the target one, record the index(i)

       // and get substring and terminate the loop

       if ( numberOfSeperator == targetNumberOfSeperator)

       {

         docidWithoutRev = inlineDataID.substring(0, i);

         break;

       }

     }

     MetaCatUtil.debugMessage("Docid without rev from inlinedata id: " +

     return docidWithoutRev;

   /**

    * Revise stack change a stack to opposite order

    */

   public static Stack reviseStack(Stack stack)

   {

     Stack result = new Stack();

     // make sure the parameter is correct

     if (stack == null || stack.isEmpty())

     {

       result = stack;

       return result;

     }

     while (!stack.isEmpty())

     {

       Object obj = stack.pop();

       result.push(obj);

     }

     return result;

   }

  /** A method to replace whitespace in url*/

  public static String replaceWhiteSpaceForURL(String urlHasWhiteSpace)

  {

    StringBuffer newUrl = new StringBuffer();

    String whiteSpaceReplace ="%20";

    if (urlHasWhiteSpace == null || urlHasWhiteSpace.trim().equals(""))

    {

      return null;

    }

    {

       char ch = urlHasWhiteSpace.charAt(i);

       if ( !Character.isWhitespace(ch))

       {

          newUrl.append(ch);

       }

       else

       {

         //it is white sapce, replace it by %20

         newUrl = newUrl.append(whiteSpaceReplace);

       }

   }//for

   MetaCatUtil.debugMessage("The new string without space is:"+

                             newUrl.toString(), 35);

   return newUrl.toString();

  }// replaceWhiteSpaceForUR