Metacat

/**

 *  '$RCSfile$'

 *    Purpose: A Class that represents a docid

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

 *             National Center for Ecological Analysis and Synthesis

 *    Authors: Chad Berkley

 *    Release: @release@

 *

 *   '$Author: berkley $'

 *     '$Date: 2001-01-18 15:15:21 -0800 (Thu, 18 Jan 2001) $'

 * '$Revision: 675 $'

 *

 * 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.io.*;

import java.util.*;

import java.lang.*;

import java.sql.*;

/**

 * A class to parse document ids

 * The docid is of the form siteCode.uniqueId.rev 

 */

public class DocumentIdentifier

{

  private String docid = null;

  private String rev = null;

  private String uniqueId = null;

  private String siteCode = null;

  private String separator = null;

  private MetaCatUtil util = new MetaCatUtil();

  /** 

   * Constructor to build a docid object and parse an incoming string.

   */

  public DocumentIdentifier(String docid) throws AccessionNumberException

  {

    this.docid = docid;

    //int numSeps = countSeparator();

    //if(numSeps > 2 || numSeps < 1)

    //{

    //  throw new AccessionNumberException("Accession number can contain " +

    //            "no more than 2 and no fewer than 1 separators.");

    //}

    if(docid.endsWith("."))

    {

      throw new AccessionNumberException("Accession number cannot end with " + 

                "a seperator.");

    }

    if(docid.startsWith("."))

    {

      throw new AccessionNumberException("Accession number cannot begin with " + 

                "a seperator.");

    }

    parseDocid();

  }

  /**

   * parses the docid into its parts

   */

  private void parseDocid()

  {

    separator = util.getOption("accNumSeparator");

    int firstIndex = docid.indexOf(separator);

    int lastIndex = docid.lastIndexOf(separator);

    if(firstIndex != lastIndex)

    { //this docid contains a revision number

      rev = docid.substring(lastIndex + 1);

      uniqueId = docid.substring(firstIndex + 1, lastIndex);

      siteCode = docid.substring(0, firstIndex);

    }

    else

    {

      uniqueId = docid.substring(firstIndex + 1);

      siteCode = docid.substring(0, firstIndex);

      rev = getNewestRev();

    }

    if(rev.equals("newest"))

    {

      rev = getNewestRev();

    }

  }

  /**

   * returns the newest revision number for a document

   */

  private String getNewestRev()

  {

    PreparedStatement pstmt;

    Connection conn = null;

    try

    {

      conn = util.openDBConnection();

      pstmt = conn.prepareStatement("select rev from xml_documents where " +

                                    "docid like '" + docid + "'");

      pstmt.execute();

      ResultSet rs = pstmt.getResultSet();

      boolean tablehasrows = rs.next();

      if(tablehasrows)

      {

        String retStr = rs.getString(1);

        pstmt.close();

        conn.close();

        return retStr;

      }

    }

    catch(Exception e)

    {

      try

      {

        conn.close();

      }

      catch(Exception e2)

      {}

      System.out.println("error closing db connection in " + 

                         "DocumentIdentifier.getNewestRev " + 

                          e.getMessage());

    }

    return "1";

  }

  private int countSeparator()

  {

    int count = 0;

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

    {

      if(docid.charAt(i) == '.')

      {  

        count++;

      }

    }

    return count;

  }

  /**

   * returns the revision number encoded in this docid

   */

  public String getRev()

  {

    return rev;

  }

  /**

   * returns the uniqueId encoded in this docid

   */

  public String getUniqueId()

  {

    return uniqueId;

  }

  /**

   * returns the siteCode encoded in this docid

   */

  public String getSiteCode()

  {

    return siteCode;

  }

  /**

   * returns the separator used in the accession number

   */

  public String getSeparator()

  {

    return separator;

  }

  /**

   * returns <siteCode><sepatator><uniqueId>

   */

  public String getIdentifier()

  {

    return siteCode + separator + uniqueId;

  }

  /**

   * returns the whole docid as a string

   */

  public String toString()

  {

    return docid;

  }

  /**

   * Test driver.  The first command line argument is the docid you want to 

   * create an object for.  For instance ">java DocumentIdentifer nceas.1.2"

   * will return "rev: 2 \n uniqueId: 1 \n siteCode: nceas \n"

   */

  public static void main(String args[]) 

  {

    try

    {

      DocumentIdentifier d = new DocumentIdentifier(args[0]);

      System.out.println("rev: " + d.getRev());

      System.out.println("uniqueId: " + d.getUniqueId());

      System.out.println("siteCode: " + d.getSiteCode());

    }

    catch(Exception e)

    {

      System.out.println("error: " + e.getMessage());

    }

  }

}