| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 29. libpq - C 라이브러리 | Fast Forward | Next |
서버로 인해 생성되는 주의/경고 메세지는 쿼리 실행 함수에서 반환되지 않습니다. 이것들이 쿼리의 실패를 의미하는 것은 아니기 때문입니다. 그 대신에, 이들은 경고 처리 함수에게 건네지고, 핸들러가 돌아온 후, 일반적인 실행이 계속됩니다. 디폴트인 경고 처리 함수는 메세지를stderr에 출력합니다. 그러나 어플리케이션은 이 동작을 겹쳐 써서, 독자적인 처리 함수를 제공할 수 있습니다.
역사적인 이유에 의해, 경고 처리에는 경고 리시버와 경고 프로세서로 불리는 2 레벨이 있습니다. 디폴트 동작에서는 경고 리시버는 경고 서식을 정돈하고, 경고 프로세서에 문자열을 건네줍니다. 그러나 보통, 독자적인 경고 리시버를 제공하는 어플리케이션에서는 경고 프로세서 레이어를 무시하고, 모든 처리를 경고 리시버만으로 실행합니다.
PQsetNoticeReceiver함수는 접속 오브젝트를 위해 현재의 경고 리시버의 설정이나 확인을 설정합니다.
같이PQsetNoticeProcessor
는 현재의 경고 프로세서의 설정이나 확인을 실시합니다.
typedef void (*PQnoticeReceiver) (void *arg, const PGresult *res);
PQnoticeReceiver
PQsetNoticeReceiver(PGconn *conn,
PQnoticeReceiver proc,
void *arg);
typedef void (*PQnoticeProcessor) (void *arg, const char *message);
PQnoticeProcessor
PQsetNoticeProcessor(PGconn *conn,
PQnoticeProcessor proc,
void *arg);
각 함수는 이전의 경고 리시버나 프로세서 함수 포인터를 돌려주어, 새로운 값을 설정합니다. 함수 포인터에 null을 건네주었을 경우, 아무것도 변경되지 않고 현재의 포인터가 반환됩니다.
서버로부터 주의/경고 메세지를 받아들이거나 libpq내부에서 주의/경고 메세지가 생성되면, 경고 리시버 함수가 호출됩니다.
PGRES_NONFATAL_ERROR PGresult 형태로 메세지가 건네집니다.
(이것에 의해, 리시버는 PQresultErrorField를 사용해 개개의 필드를 꺼내는 것이나, PQresultErrorMessage를 사용해 사전에 정형된 완료 메세지를 꺼낼 수 있습니다. )
PQsetNoticeReceiver에게 건네진 void 포인터와 같은 것도 건네받습니다.
(이 포인터를 사용하고, 필요에 따라서 어플리케이션 특정한 상태에 액세스 할 수 있습니다. )
디폴트의 경고 리시버는 단지(PQresultErrorMessage를 사용해) 메세지를 꺼내고, 그것을 경고 프로세서에 건네줄 뿐입니다.
경고 프로세서는 텍스트 형식에서 주어진 주의/경고 메세지 다루는 것에 관해 책임을 가집니다.
메세지는(마지막 새로운 행을 포함) 문자열 텍스트로 건네받고, 더해서 PQsetNoticeProcessor에 건네준 것과 같은 void 포인터도 건네받습니다.
(이 포인터를 사용하여 필요하다면 어플리케이션 특정한 상태에 액세스 할 수 있습니다. )
디폴트의 경고 프로세서는 이하와 같이 단순한 것입니다.
static void
defaultNoticeProcessor(void *arg, const char *message)
{
fprintf(stderr, "%s", message);
}
일단 경고 리시버나 경고 프로세서를 설정하면, PGconn오브젝트나 생성된PGresult오브젝트가 존재하는 동안은 함수가 호출될 가능성이 있다고 생각해 두어야 합니다.
PGresult의 생성시에는 PGconn의 현재 경고 처리 포인터가, PQgetvalue와 같이 함수로 사용되도록, PGresult에 복사됩니다.