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 ResultSet;
00043 
00044 class Exception :  public std::runtime_error
00045 {
00046 public:
00047   Exception(std::string reason, std::string sql_state, drizzled::error_t error_arg) :
00048     std::runtime_error(reason),
00049     _error_code(error_arg),
00050     _sql_state(sql_state),
00051     _reason(reason)
00052   {
00053     if (_sql_state.length() != 5)
00054       _sql_state= "HY000";
00055   }
00056 
00057   Exception() :
00058     std::runtime_error("no error"),
00059     _error_code(drizzled::EE_OK),
00060     _sql_state("00000")
00061   {
00062   }
00063 
00064   Exception(std::string reason, drizzled::error_t error_arg) :
00065     std::runtime_error(reason),
00066     _error_code(error_arg),
00067     _reason(reason)
00068   {
00069     _sql_state= "00000";
00070   }
00071 
00072   ~Exception () throw ()
00073   { }
00074 
00075   drizzled::error_t getErrorCode() const
00076   {
00077     return _error_code;
00078   }
00079 
00080   const std::string &getErrorMessage() const
00081   {
00082     return _reason;
00083   }
00084 
00085   Exception getNextException() const
00086   {
00087     if (_next_exception.empty())
00088     {
00089       return Exception();
00090     }
00091 
00092     Exception tmp= _next_exception.front();
00093     _next_exception.pop();
00094 
00095     return Exception();
00096   }
00097 
00098   const std::string &getSQLState() const
00099   {
00100     return _sql_state;
00101   }
00102 
00103 protected:
00104   friend class ResultSet;
00105   void setNextException(Exception arg) 
00106   {
00107     (void)arg;
00108     return;
00109   }
00110 
00111 private:
00112   drizzled::error_t _error_code; // Vendor, ie our, code
00113   std::string _sql_state;
00114   std::string _reason;
00115   mutable std::queue <Exception> _next_exception;
00116 };
00117 
00118 std::ostream& operator<<(std::ostream& output, const Exception &arg);
00119 
00120 } // namespace sql 
00121 } // namespace drizzled
00122