// // $Id$ // // FLXPostgresError.m // PostgresKit // // Created by Stuart Connolly (stuconnolly.com) on September 3, 2012. // Copyright (c) 2012 Stuart Connolly. All rights reserved. // // Permission is hereby granted, free of charge, to any person // obtaining a copy of this software and associated documentation // files (the "Software"), to deal in the Software without // restriction, including without limitation the rights to use, // copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the // Software is furnished to do so, subject to the following // conditions: // // The above copyright notice and this permission notice shall be // included in all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES // OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, // WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR // OTHER DEALINGS IN THE SOFTWARE. #import "FLXPostgresError.h" #import "FLXPostgresException.h" @interface FLXPostgresError () - (void)_extractErrorDetailsFromResult:(PGresult *)result; - (NSString *)_extractErrorField:(int)field fromResult:(PGresult *)result; @end @implementation FLXPostgresError @synthesize errorSeverity = _errorSeverity; @synthesize errorStateCode = _errorStateCode; @synthesize errorPrimaryMessage = _errorPrimaryMessage; @synthesize errorDetailMessage = _errorDetailMessage; @synthesize errorMessageHint = _errorMessageHint; @synthesize errorStatementPosition = _errorStatementPosition; #pragma mark - - (id)init { [FLXPostgresException raise:NSInternalInconsistencyException reason:@"%@ shouldn't be init'd directly; use initWithResult: instead.", [self className]]; return nil; } - (id)initWithResult:(PGresult *)result { if ((self = [super init])) { _errorSeverity = nil; _errorStateCode = nil; _errorPrimaryMessage = nil; _errorDetailMessage = nil; _errorMessageHint = nil; _errorStatementPosition = -1; if (result) [self _extractErrorDetailsFromResult:result]; } return self; } - (NSString *)description { return [NSString stringWithFormat:@"<%@: Sev %@ (%@): %@>", [self className], _errorSeverity, _errorStateCode, _errorPrimaryMessage]; } #pragma mark - #pragma mark Private API /** * Extracts all the error information from the supplied result. * * @param result The Postgres result to extract the information from. */ - (void)_extractErrorDetailsFromResult:(PGresult *)result { // Note that we don't expose all the fields that are available. // The ones we don't mostly include information internal to Postgres // that generally isn't useful to end users. _errorSeverity = [self _extractErrorField:PG_DIAG_SEVERITY fromResult:result]; _errorStateCode = [self _extractErrorField:PG_DIAG_SQLSTATE fromResult:result]; _errorPrimaryMessage = [self _extractErrorField:PG_DIAG_MESSAGE_PRIMARY fromResult:result]; _errorDetailMessage = [self _extractErrorField:PG_DIAG_MESSAGE_DETAIL fromResult:result]; _errorMessageHint = [self _extractErrorField:PG_DIAG_MESSAGE_HINT fromResult:result]; NSString *statementPosition = [self _extractErrorField:PG_DIAG_STATEMENT_POSITION fromResult:result]; _errorStatementPosition = [statementPosition integerValue]; [statementPosition release]; } /** * Extracts the supplied error field from the supplied Postgres result. * * @param field The error field to extract. * @param result The Postgres result to extract the field from. * * @return A string representing the error value. The caller is responsible for freeing the associated memory. */ - (NSString *)_extractErrorField:(int)field fromResult:(PGresult *)result { const char *errorData = PQresultErrorField(result, field); return [[NSString alloc] initWithBytes:errorData length:strlen(errorData) encoding:NSUTF8StringEncoding]; } #pragma mark - - (void)dealloc { if (_errorSeverity) [_errorSeverity release], _errorSeverity = nil; if (_errorStateCode) [_errorStateCode release], _errorStateCode = nil; if (_errorPrimaryMessage) [_errorPrimaryMessage release], _errorPrimaryMessage = nil; if (_errorDetailMessage) [_errorDetailMessage release], _errorDetailMessage = nil; if (_errorMessageHint) [_errorMessageHint release], _errorMessageHint = nil; [super dealloc]; } @end