Drizzled Public API Documentation

exception.h
00001 /* - mode: c; c-basic-offset: 2; indent-tabs-mode: nil; -*-
00002  *  vim:expandtab:shiftwidth=2:tabstop=2:smarttab:
00003  *
00004  * Copyright (C) 2011, Brian Aker
00005  * All rights reserved.
00006  *
00007  * Redistribution and use in source and binary forms, with or without
00008  * modification, are permitted provided that the following conditions are met:
00009  *
00010  *   * Redistributions of source code must retain the above copyright notice,
00011  *     this list of conditions and the following disclaimer.
00012  *   * Redistributions in binary form must reproduce the above copyright notice,
00013  *     this list of conditions and the following disclaimer in the documentation
00014  *     and/or other materials provided with the distribution.
00015  *   * Neither the name of Patrick Galbraith nor the names of its contributors
00016  *     may be used to endorse or promote products derived from this software
00017  *     without specific prior written permission.
00018  *
00019  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
00020  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00021  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
00022  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
00023  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
00024  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
00025  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
00026  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
00027  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
00028  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
00029  * THE POSSIBILITY OF SUCH DAMAGE.
00030  */
00031 
00032 #pragma once
00033 
00034 #include <drizzled/error_t.h>
00035 
00036 #include <queue>
00037 #include <stdexcept>
00038 
00039 namespace drizzled {
00040 namespace sql {
00041 
00042 class Exception :  public std::runtime_error
00043 {
00044 public:
00045   Exception(std::string reason, std::string sql_state, drizzled::error_t error_arg) :
00046     std::runtime_error(reason),
00047     _error_code(error_arg),
00048     _sql_state(sql_state),
00049     _reason(reason)
00050   {
00051     if (_sql_state.length() != 5)
00052       _sql_state= "HY000";
00053   }
00054 
00055   Exception() :
00056     std::runtime_error("no error"),
00057     _error_code(drizzled::EE_OK),
00058     _sql_state("00000")
00059   {
00060   }
00061 
00062   Exception(std::string reason, drizzled::error_t error_arg) :
00063     std::runtime_error(reason),
00064     _error_code(error_arg),
00065     _reason(reason)
00066   {
00067     _sql_state= "00000";
00068   }
00069 
00070   ~Exception () throw ()
00071   { }
00072 
00073   drizzled::error_t getErrorCode() const
00074   {
00075     return _error_code;
00076   }
00077 
00078   const std::string &getErrorMessage() const
00079   {
00080     return _reason;
00081   }
00082 
00083   Exception getNextException() const
00084   {
00085     if (_next_exception.empty())
00086     {
00087       return Exception();
00088     }
00089 
00090     Exception tmp= _next_exception.front();
00091     _next_exception.pop();
00092 
00093     return Exception();
00094   }
00095 
00096   const std::string &getSQLState() const
00097   {
00098     return _sql_state;
00099   }
00100 
00101 protected:
00102   friend class ResultSet;
00103   void setNextException(Exception arg) 
00104   {
00105     (void)arg;
00106     return;
00107   }
00108 
00109 private:
00110   drizzled::error_t _error_code; // Vendor, ie our, code
00111   std::string _sql_state;
00112   std::string _reason;
00113   mutable std::queue <Exception> _next_exception;
00114 };
00115 
00116 std::ostream& operator<<(std::ostream& output, const Exception &arg);
00117 
00118 } // namespace sql 
00119 } // namespace drizzled
00120