com.hfg.sql.table.field.DatabaseStringField Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of com_hfg Show documentation
com.hfg xml, html, svg, and bioinformatics utility library
There is a newer version: 20240423
package com.hfg.sql.table.field;

import com.hfg.sql.SQLUtil;
import com.hfg.sql.jdbc.JDBCException;
import com.hfg.sql.table.DatabaseCol;
import com.hfg.sql.table.DatabaseTable;
import com.hfg.xml.XMLTag;

import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.Types;

//------------------------------------------------------------------------------
/**
 Database field that manages a string value.
 
 @author J. Alex Taylor, hairyfatguy.com
 
 */
//------------------------------------------------------------------------------
// com.hfg XML/HTML Coding Library
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
//
// This library 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
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//
// J. Alex Taylor, President, Founder, CEO, COO, CFO, OOPS hairyfatguy.com
// [email protected]
//------------------------------------------------------------------------------

public class DatabaseStringField extends DatabaseField
{
   //###########################################################################
   // CONSTRUCTORS
   //###########################################################################

   //---------------------------------------------------------------------------
   public DatabaseStringField(DatabaseCol inCol)
   {
      this(inCol, (Object) null);
   }

   //---------------------------------------------------------------------------
   public DatabaseStringField(DatabaseCol inCol, String inValue)
   {
      super(inCol, inValue);
   }

   //---------------------------------------------------------------------------
   public DatabaseStringField(DatabaseCol inCol, Object inValue)
   {
      super(inCol, convertToString(inValue));
   }

   //---------------------------------------------------------------------------
   public DatabaseStringField(DatabaseCol inCol, ResultSet inResultSet)
   {
      super(inCol, inResultSet);
   }

   //---------------------------------------------------------------------------
   public DatabaseStringField(XMLTag inXMLTag, DatabaseTable inTable)
   {
      super(inXMLTag, inTable);
   }

   //###########################################################################
   // PUBLIC METHODS
   //###########################################################################

   //---------------------------------------------------------------------------
   protected void setValueFromResultSet(ResultSet inResultSet)
   {
      // Retrieve the index for the ResultSet column with the matching name.
      // If no column with the proper name is present in the ResultSet, don't do anything.
      Integer index = getColIndex(inResultSet);
      if (index != null)
      {
         try
         {
            setInitialValue(inResultSet.getString(index));
         }
         catch (SQLException e)
         {
            try
            {
               throw new JDBCException("Problem mapping " + getCol().name() + " value: " + inResultSet.getString(getCol().name()) + "!", e);
            }
            catch (SQLException e2)
            {
               throw new JDBCException("Problem mapping " + getCol().name() + " value!", e);
            }
         }
      }
   }

   //---------------------------------------------------------------------------
   public void setValueInPreparedStatement(PreparedStatement inPreparedStatement, int inIndex)
   {
      try
      {
         if (isNull())
         {
            inPreparedStatement.setNull(inIndex, Types.VARCHAR);
         }
         else
         {
            inPreparedStatement.setString(inIndex, getValue());
         }
      }
      catch (SQLException e)
      {
         throw new JDBCException("Problem setting column " + getCol().name() + " value into PreparedStatement!", e);
      }
   }

   //---------------------------------------------------------------------------
   public void setValueFromString(String inValue)
   {
      setValue(inValue);
   }

   //---------------------------------------------------------------------------
   @Override
   public String getSQLValue()
   {
      return SQLUtil.sqlString(getValue());
   }

   //###########################################################################
   // PRIVATE METHODS
   //###########################################################################

   //---------------------------------------------------------------------------
   private static String convertToString(Object inValue)
   {
      String stringValue = null;
      if (inValue != null)
      {
         if (inValue instanceof String)
         {
            stringValue = (String) inValue;
         }
         else
         {
            stringValue = inValue.toString();
         }
      }

      return stringValue;
   }
}