31.13. Hệ thống sự soi kèo bóng đá truoctran

Sự soi kèo bóng đá truoctran đăng ký xảy ra khipqregistereventProcđược gọi. Đó là thời điểm lý tưởng để khởi tạo bất kỳ11819_11833Một thủ tục sự soi kèo bóng đá truoctran có thể cần. Chỉ có một sự soi kèo bóng đá truoctran đăng ký sẽ được sa thải trên mỗi người xử lý sự soi kèo bóng đá truoctran cho mỗi kết nối. Nếu thủ tục sự soi kèo bóng đá truoctran không thành công, việc đăng ký bị hủy bỏ.

Cấu trúc typedef

    Pgconn *Conn;
 PgEventRegister;

Khi APGEVT_REGISTERSự soi kèo bóng đá truoctran được nhận,evtinfoCon trỏ nên được đúc đến APGEVENTREGISTER *. Cấu trúc này chứaPGConnnên có trongConnection_oktrạng thái; Đảm bảo nếu một người gọipqregistereventProcNgay sau khi có được một điều tốtPGConn. Khi trả lại mã thất bại, tất cả các công việc dọn dẹp phải được thực hiện dưới dạng soi kèo bóng đá truoctranPGEVT_ConnDestroySự soi kèo bóng đá truoctran sẽ được gửi.

Sự soi kèo bóng đá truoctran đặt lại kết nối được bắn khi hoàn thànhpqresethoặcpqresetpoll. Trong cả hai trường hợp, sự soi kèo bóng đá truoctran chỉ được bắn nếu thiết lập lại thành công. Nếu thủ tục sự soi kèo bóng đá truoctran không thành công, toàn bộ thiết lập lại kết nối sẽ không thành công; ThePGConnđược đặt vàoConnection_Badstatus vàpqresetpollsẽ trả vềPGRES_POLLING_FAILED.

Cấu trúc typedef

    Pgconn *Conn;
 PgEventConnReset;

Khi APGEVT_CONNRESETSự soi kèo bóng đá truoctran được nhận,evtinfoCon trỏ nên được đúc đến APGEVENTCONNRESET *. Mặc dù được chứaPGConnchỉ được đặt lại, tất cả dữ liệu sự soi kèo bóng đá truoctran vẫn không thay đổi. Sự soi kèo bóng đá truoctran này nên được sử dụng để đặt lại/tải lại/yêu cầu bất kỳ liên quan nàoInstancedata. Lưu ý rằng ngay cả khi quy trình sự soi kèo bóng đá truoctran không xử lýPGEVT_CONNRESET, nó vẫn sẽ nhận đượcPGEVT_ConnDestroySự soi kèo bóng đá truoctran khi kết nối được đóng.

Sự soi kèo bóng đá truoctran phá hủy kết nối được bắn để đáp ứng vớipqfinish. Trách nhiệm của thủ tục sự soi kèo bóng đá truoctran là làm sạch dữ liệu sự soi kèo bóng đá truoctran của mình vì LibPQ không có khả năng quản lý bộ nhớ này. Không làm sạch sẽ dẫn đến rò rỉ bộ nhớ.

Cấu trúc typedef

    Pgconn *Conn;
 PgEventConnDestroy;

Khi APGEVT_ConnDestroySự soi kèo bóng đá truoctran được nhận,evtinfoCon trỏ nên được đúc đến ApgEventConnDestroy *. Sự soi kèo bóng đá truoctran này được bắn trướcpqfinishThực hiện bất kỳ việc dọn dẹp nào khác. Giá trị trả về của thủ tục sự soi kèo bóng đá truoctran bị bỏ qua vì không có cách nào chỉ ra sự thất bại từpqfinish. Ngoài ra, một lỗi thủ tục sự soi kèo bóng đá truoctran không nên hủy bỏ quá trình làm sạch bộ nhớ không mong muốn.

Sự soi kèo bóng đá truoctran tạo kết quả được bắn để đáp ứng với bất kỳ chức năng thực thi truy vấn nào tạo ra kết quả, bao gồmPQGetResult. Sự soi kèo bóng đá truoctran này sẽ chỉ được bắn sau khi kết quả đã được tạo thành công.

Cấu trúc typedef

    Pgconn *Conn;
    Pgresult *kết quả;
 PgEventResultcreate;

Khi APGEVT_RESULTCREATESự soi kèo bóng đá truoctran được nhận,evtinfoCon trỏ nên được đúc đến APGEVENTRESULTCREATE *. TheConnlà kết nối được sử dụng để tạo kết quả. Đây là nơi lý tưởng để khởi tạo bất kỳInstancedatacần được liên kết với kết quả. Nếu thủ tục sự soi kèo bóng đá truoctran không thành công, kết quả sẽ được xóa và sự thất bại sẽ được lan truyền. Quy trình sự soi kèo bóng đá truoctran không được cố gắngPQClearĐối tượng kết quả cho chính nó. Khi trả lại mã thất bại, tất cả các công việc dọn dẹp phải được thực hiện dưới dạng soi kèo bóng đá truoctranPGEVT_RESULTDESTROYSự soi kèo bóng đá truoctran sẽ được gửi.

Sự soi kèo bóng đá truoctran bản sao kết quả được bắn để phản hồiPQCopyresult. Sự soi kèo bóng đá truoctran này sẽ chỉ được bắn sau khi bản sao hoàn tất. Chỉ các quy trình sự soi kèo bóng đá truoctran đã xử lý thành côngPGEVT_RESULTCREATEhoặcPGEVT_RESULTCOPYSự soi kèo bóng đá truoctran cho kết quả nguồn sẽ nhận đượcPGEVT_RESULTCOPYSự soi kèo bóng đá truoctran.

Cấu trúc typedef

    const pgresult *src;
    Pgresult *Dest;
 PgEventResultcopy;

Khi APGEVT_RESULTCOPYSự soi kèo bóng đá truoctran được nhận,evtinfoCon trỏ nên được đúc đến APGEVENTRESULTCOPY *. TheSRCKết quả là những gì đã được sao chép trong khiDestKết quả là điểm đến sao chép. Sự soi kèo bóng đá truoctran này có thể được sử dụng để cung cấp một bản sao sâu củaInstancedata, kể từPQCopyresultKhông thể làm điều đó. Nếu thủ tục sự soi kèo bóng đá truoctran không thành công, toàn bộ hoạt động sao chép sẽ thất bại vàDestKết quả sẽ được xóa. Khi trả lại mã thất bại, tất cả các công việc dọn dẹp phải được thực hiện dưới dạng soi kèo bóng đá truoctranPGEVT_RESULTDESTROYSự soi kèo bóng đá truoctran sẽ được gửi cho kết quả đích.

Sự soi kèo bóng đá truoctran phá hủy kết quả được bắn để đáp ứng vớiPQClear. Trách nhiệm của thủ tục sự soi kèo bóng đá truoctran là làm sạch dữ liệu sự soi kèo bóng đá truoctran của mình vì LibPQ không có khả năng quản lý bộ nhớ này. Không làm sạch sẽ dẫn đến rò rỉ bộ nhớ.

Cấu trúc typedef

    Pgresult *kết quả;
 PgEventResultdestroy;

Khi APGEVT_RESULTDESTROYSự soi kèo bóng đá truoctran được nhận,evtinfoCon trỏ nên được đúc đến APGEVENTRESULTDESTROY *. Sự soi kèo bóng đá truoctran này được bắn trướcPQClearThực hiện bất kỳ việc dọn dẹp nào khác. Giá trị trả về của thủ tục sự soi kèo bóng đá truoctran bị bỏ qua vì không có cách nào chỉ ra sự thất bại từPQClear. Ngoài ra, một lỗi thủ tục sự soi kèo bóng đá truoctran không nên hủy bỏ quá trình làm sạch bộ nhớ không mong muốn.

PGEVENTPROClà một typedef cho một con trỏ đến quy trình sự soi kèo bóng đá truoctran, nghĩa là chức năng gọi lại của người dùng nhận được các sự soi kèo bóng đá truoctran từ libpq. Chữ ký của thủ tục sự soi kèo bóng đá truoctran phải là

19136_19202

TheEVTIDTham số cho biếtPGEVTSự soi kèo bóng đá truoctran đã xảy ra. TheevtinfoCon trỏ phải được chuyển đến loại cấu trúc phù hợp để có thêm thông tin về sự soi kèo bóng đá truoctran này. TheVượt quatham số là con trỏ được cung cấp choPQRegisterEventProc19590_19714

Một quy trình sự soi kèo bóng đá truoctran cụ thể chỉ có thể được đăng ký một lần trong bất kỳPGConn. Điều này là do địa chỉ của thủ tục được sử dụng làm khóa tra cứu để xác định dữ liệu thể hiện được liên kết.

Đăng ký Quy trình gọi lại sự soi kèo bóng đá truoctran với libpq.

21068_21187

Một quy trình sự soi kèo bóng đá truoctran phải được đăng ký một lần trên mỗiPGConn21280_21505

TheProcĐối số sẽ được gọi khi một sự soi kèo bóng đá truoctran libpq được bắn. Địa chỉ bộ nhớ của nó cũng được sử dụng để tra cứuInstancedata. ThetênĐối số được sử dụng để chỉ quy trình sự soi kèo bóng đá truoctran trong các thông báo lỗi. Giá trị này không thể lànull21834_21897PGConn21929_21979Vượt quaCon trỏ được truyền đếnProcBất cứ khi nào xảy ra sự soi kèo bóng đá truoctran. Đối số này có thể lànull.

Đặt kết nốiConn'sInstancedatacho thủ tụcProcđếnData. Điều này trả về soi kèo bóng đá truoctran phải cho thành công và soi kèo bóng đá truoctran cho thất bại. (Thất bại chỉ có thể xảy ra nếuProcchưa được đăng ký đúng trongConn.)

22679_22747

Trả về kết nốiConn'sInstancedatađược liên kết với thủ tụcProchoặcnullNếu soi kèo bóng đá truoctran có.

void *pqinstancedata (const pgconn *Conn, pgEventProc Proc);

Đặt kết quảInstancedatachoProcđếnData. Điều này trả về soi kèo bóng đá truoctran phải cho thành công và soi kèo bóng đá truoctran cho thất bại. (Thất bại chỉ có thể xảy ra nếuProcchưa được đăng ký đúng trong kết quả.)

23651_23726

Trả về kết quảInstancedatađược liên kết vớiProchoặcnullNếu soi kèo bóng đá truoctran có.

24061_24129