sqltimecolumnspec.java

把java对象映射成数据库表中的一条记录

/*
 *
 * The contents of this file are subject to the Mozilla Public License
 * Version 1.1 (the "License"); you may not use this file except in
 * compliance with the License. You may obtain a copy of the License at
 *
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
 * License for the specific language governing rights and limitations under
 * the License.
 *
 * The Original Code is jRelationalFramework.
 *
 * The Initial Developer of the Original Code is is.com.
 * Portions created by is.com are Copyright (C) 2000 is.com.
 * All Rights Reserved.
 *
 * Contributor(s): Alix Jermyn (Icon MediaLab Belgium -
 *                              [e-mail])
 *
 * Alternatively, the contents of this file may be used under the terms of
 * the GNU General Public License (the "GPL") or the GNU Lesser General
 * Public license (the "LGPL"), in which case the provisions of the GPL or
 * LGPL are applicable instead of those above.  If you wish to allow use of
 * your version of this file only under the terms of either the GPL or LGPL
 * and not to allow others to use your version of this file under the MPL,
 * indicate your decision by deleting the provisions above and replace them
 * with the notice and other provisions required by either the GPL or LGPL
 * License.  If you do not delete the provisions above, a recipient may use
 * your version of this file under either the MPL or GPL or LGPL License.
 *
 */
package com.is.jrf;


import com.is.jrf.AbstractColumnSpec;
import com.is.jrf.DatabasePolicy;

import com.is.util.sql.JDBCHelper;

import java.sql.SQLException;

import java.sql.Time;


/**
 * This subclass of AbstractColumnSpec does java.sql.Time specific things.
 */
public class SQLTimeColumnSpec
    extends AbstractColumnSpec
  {


  /* ===============  Static Variables  =============== */

  protected static final Class  s_class      = java.sql.Time.class;
  public    static final String SINGLE_QUOTE = "'";


  /* ===============  Constructors  =============== */

  public SQLTimeColumnSpec(
      String  columnName,
      String  getter,
      String  setter,
      Object  defaultValue)
    {
    super(columnName,
          getter,
          setter,
          (java.sql.Time) defaultValue);
    }

  public SQLTimeColumnSpec(
      String  columnName,
      String  getter,
      String  setter,
      Object  defaultValue,
      int     option1)
    {
    super(columnName,
          getter,
          setter,
          (java.sql.Time) defaultValue,
          option1);
    }

  public SQLTimeColumnSpec(
      String  columnName,
      String  getter,
      String  setter,
      Object  defaultValue,
      int     option1,
      int     option2)
    {
    super(columnName,
          getter,
          setter,
          (java.sql.Time) defaultValue,
          option1,
          option2);
    }

  public SQLTimeColumnSpec(
      String  columnName,
      String  getter,
      String  setter,
      Object  defaultValue,
      int     option1,
      int     option2,
      int     option3)
    {
    super(columnName,
          getter,
          setter,
          (java.sql.Time) defaultValue,
          option1,
          option2,
          option3);
    }


  /**
   * This method overrides the superclass implementation.
   *
   * @param obj a value of type 'Object'
   * @param dbPolicy a value of type 'DatabasePolicy'
   * @return a value of type 'String'
   */
  public String formatForSql(Object obj, DatabasePolicy dbPolicy)
    {
    // force a runtime error if not a Time
    java.sql.Time sqlTime = (java.sql.Time) obj;

    // returning the date formatted as hh:mm:ss (with no enclosing single
    // quotes) also works and would be slightly more efficient than below,
    // but below seems safer
    return (sqlTime == null ?
            "null" :
            SINGLE_QUOTE + sqlTime.toString() + SINGLE_QUOTE);
    } // formatForSql(...)


  /**
   * This method goes with encode().  The String parameter must have been
   * created by the encode() method, which uses the toString() method unless
   * overidden.  By Default the toString() and valueOf() methods both use
   * the hh:mm:ss format.
   *
   * @param aString a value of type 'String'
   * @return a value of type 'Object' (This actually will be a
   *                                   java.sql.Time or null)
   */
  public Object decode(String aString)
    {
    if (aString.trim().equals("null"))
        {
        return null;
        }
    return java.sql.Time.valueOf(aString);
    }


  public Class getColumnClass()
    {
    return s_class;
    }


  /**
   * This method overrides the superclass implementation.  This ensures that
   * we get a boolean even if it is an Integer column.
   *
   * @param helper a value of type 'JDBCHelper'
   * @return a value of type 'Object'
   * @exception SQLException if an error occurs
   */
  public Object getColumnValueFrom(JDBCHelper helper)
          throws SQLException
    {
    return helper.getTime(this.getColumnName());
    }


  /**
   * Return the ANSI standard SQL column type.
   *
   * @param dbPolicy a value of type 'DatabasePolicy'
   * @return a value of type 'String'
   */
  public String getSQLColumnType(DatabasePolicy dbPolicy)
    {
    return "TIME";
    }


  public JoinColumn buildJoinColumn()
    {
    return new SQLTimeJoinColumn(this.getColumnName(),
                                 this.getSetter());
    }


  } // SQLTimeColumnSpec