| PostgreSQL: soi kèo bóng đá truoctran liệu: | |||
|---|---|---|---|
| prev | UP | Chương 31.libpq- C Thư viện | Tiếp theo |
libpqHệ thống sự kèo bóng đá việt nam được thiết kế để thông báo cho Trình xử lý sự kèo bóng đá việt nam đã đăng ký về thú vịlibpqCác sự kèo bóng đá việt nam, chẳng hạn như sự sáng tạo hoặc phá hủyPGConnvàpgresultĐối tượng. Trường hợp sử dụng chính là điều này cho phép các ứng dụng liên kết dữ liệu của riêng họ vớiPGConnhoặcpgresultvà đảm bảo rằng dữ liệu đó được giải phóng vào một thời điểm thích hợp.
Mỗi trình xử lý sự kèo bóng đá việt nam đã đăng ký được liên kết với hai phần dữ liệu, được biết đếnlibpqchỉ dưới dạng mờvoid *Con trỏ. Có mộtVượt quaCon trỏ được cung cấp bởi ứng dụng khi trình xử lý sự kèo bóng đá việt nam được đăng ký vớiPGConn. Con trỏ qua kèo bóng đá việt nam bao giờ thay đổi cho cuộc sống củaPGConnvà tất cảpgresultS được tạo từ nó; Vì vậy, nếu được sử dụng, nó phải trỏ đến dữ liệu tồn tại lâu.dữ liệu thể hiệnCon trỏ, bắt đầunullTrong mỗiPGConnvàpgresult. Con trỏ này có thể được thao tác bằng cách sử dụngpqinstancedata, pqsetInstanceata, pqresultinstancedatavàPQSetResultInstanceatachức năng. Lưu ý rằng kèo bóng đá việt nam giống như con trỏ qua, dữ liệu thể hiện củaPGConnkèo bóng đá việt nam được kế thừa tự động bởipgresults được tạo từ nó.libpqKhông biết những con trỏ dữ liệu và thông tin nào chỉ ra (nếu có) và sẽ không bao giờ cố gắng giải phóng chúng - đó là trách nhiệm của trình xử lý sự kèo bóng đá việt nam.
enumPGEVENTIDĐặt tên cho các loại sự kèo bóng đá việt nam được xử lý bởi hệ thống sự kèo bóng đá việt nam. Tất cả các giá trị của nó có tên bắt đầu bằngPGEVT. Đối với mỗi loại sự kèo bóng đá việt nam, có một cấu trúc thông tin sự kèo bóng đá việt nam tương ứng mang các tham số được truyền cho trình xử lý sự kèo bóng đá việt nam.
Sự kèo bóng đá việt nam đăng ký xảy ra khipqregistereventProcđược gọi. Đó là thời điểm lý tưởng để khởi tạo bất kỳInstancedataMột thủ tục sự kèo bóng đá việt nam có thể cần. Chỉ có một sự kèo bóng đá việt nam đăng ký sẽ được sa thải trên mỗi người xử lý sự kèo bóng đá việt nam cho mỗi kết nối.
Cấu trúc typedef
Khi APGEVT_REGISTERSự kèo bóng đá việt nam đượ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 kèo bóng đá việt namPGEVT_ConnDestroySự kèo bóng đá việt nam sẽ được gửi.
Sự kèo bóng đá việt nam đặt lại kết nối được bắn khi hoàn thànhpqresethoặcpqresetpoll. Trong cả hai trường hợp, sự kèo bóng đá việt nam chỉ được bắn nếu thiết lập lại thành công.PGConnđược đặt vàoConnection_Badstatus vàpqresetpollsẽ trả vềPGRES_POLLING_FAILED.
Cấu trúc typedef
Khi APGEVT_CONNRESETSự kèo bóng đá việt nam đượ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ự kèo bóng đá việt nam vẫn không thay đổi. Sự kèo bóng đá việt nam 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ự kèo bóng đá việt nam không xử lýPGEVT_CONNRESET, nó vẫn sẽ nhận đượcPGEVT_ConnDestroySự kèo bóng đá việt nam khi kết nối được đóng.
Sự kèo bóng đá việt nam phá hủy kết nối được bắn để đáp ứng vớipqfinish. Trách nhiệm của thủ tục sự kèo bóng đá việt nam là làm sạch dữ liệu sự kèo bóng đá việt nam của mình vì LibPQ không có khả năng quản lý bộ nhớ này.
Cấu trúc typedef
Khi APGEVT_ConnDestroySự kèo bóng đá việt nam được nhận,evtinfoCon trỏ nên được đúc đến ApgEventConnDestroy *. Sự kèo bóng đá việt nam 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ự kèo bóng đá việt nam 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ự kèo bóng đá việt nam không nên hủy bỏ quá trình làm sạch bộ nhớ không mong muốn.
Sự kèo bóng đá việt nam 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ự kèo bóng đá việt nam này sẽ chỉ được bắn sau khi kết quả đã được tạo thành công.
Cấu trúc typedef
Khi APGEVT_RESULTCREATESự kèo bóng đá việt nam đượ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ự kèo bóng đá việt nam không thành công, kết quả sẽ được xóa và sự thất bại sẽ được lan truyền.PQClearĐố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 kèo bóng đá việt namPGEVT_RESULTDESTROYSự kèo bóng đá việt nam sẽ được gửi.
Sự kèo bóng đá việt nam bản sao kết quả được bắn để phản hồiPQCopyresult. Sự kèo bóng đá việt nam này sẽ chỉ được bắn sau khi bản sao hoàn tất.PGEVT_RESULTCREATEhoặcPGEVT_RESULTCOPYSự kèo bóng đá việt nam cho kết quả nguồn sẽ nhận đượcPGEVT_RESULTCOPYSự kèo bóng đá việt nam.
Cấu trúc typedef
Khi APGEVT_RESULTCOPYSự kèo bóng đá việt nam đượ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ự kèo bóng đá việt nam 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ự kèo bóng đá việt nam 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 kèo bóng đá việt namPGEVT_RESULTDESTROYSự kèo bóng đá việt nam sẽ được gửi cho kết quả đích.
Sự kèo bóng đá việt nam phá hủy kết quả được bắn để đáp ứng vớiPQClear. Trách nhiệm của thủ tục sự kèo bóng đá việt nam là làm sạch dữ liệu sự kèo bóng đá việt nam của mình vì LibPQ không có khả năng quản lý bộ nhớ này.
Cấu trúc typedef
Khi APGEVT_RESULTDESTROYSự kèo bóng đá việt nam được nhận,evtinfoCon trỏ nên được đúc đến APGEVENTRESULTDESTROY *. Sự kèo bóng đá việt nam 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ự kèo bóng đá việt nam 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ự kèo bóng đá việt nam 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ự kèo bóng đá việt nam, nghĩa là chức năng gọi lại của người dùng nhận được các sự kèo bóng đá việt nam từ libpq. Chữ ký của thủ tục sự kèo bóng đá việt nam phải là
19136_19202
TheEVTIDTham số cho biếtPGEVTSự kèo bóng đá việt nam đã 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ự kèo bóng đá việt nam này. TheVượt quatham số là con trỏ được cung cấp choPQRegisterEventProcKhi thủ tục sự kèo bóng đá việt nam được đăng ký. Hàm sẽ trả về một giá trị khác không nếu nó thành công và không nếu nó thất bại.
Một quy trình sự kèo bóng đá việt nam 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.
| THẬN TRỌNG |
|
Trên Windows, các chức năng có thể có hai địa chỉ khác nhau: một địa chỉ có thể nhìn thấy từ bên ngoài DLL và một địa chỉ khác có thể nhìn thấy từ bên trong DLL. Người ta nên cẩn thận rằng chỉ có một trong số các địa chỉ này được sử dụng vớilibpqCác chức năng gây ra sự kèo bóng đá việt nam, sự nhầm lẫn khác sẽ dẫn đến. Quy tắc đơn giản nhất để viết mã sẽ hoạt động là đảm bảo rằng các quy trình sự kèo bóng đá việt nam được khai báotĩnh. Nếu địa chỉ của thủ tục phải có sẵn bên ngoài tệp nguồn của riêng mình, hãy hiển thị một hàm riêng để trả về địa chỉ. |
pqregistereventProcĐăng ký Quy trình gọi lại sự kèo bóng đá việt nam với libpq.
21068_21187
Một quy trình sự kèo bóng đá việt nam phải được đăng ký một lần trên mỗiPGConnBạn muốn nhận các sự kèo bóng đá việt nam về. Không có giới hạn, ngoài bộ nhớ, về số lượng các quy trình sự kèo bóng đá việt nam có thể được đăng ký với kết nối.
TheProcĐối số sẽ được gọi khi một sự kèo bóng đá việt nam 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ự kèo bóng đá việt nam trong các thông báo lỗi. Giá trị này không thể lànullhoặc chuỗi độ dài bằng kèo bóng đá việt nam. Chuỗi tên được sao chép vàoPGConn, Vì vậy, những gì được thông qua kèo bóng đá việt nam cần phải tồn tại lâu dài. TheVượt quaCon trỏ được truyền đếnProcBất cứ khi nào xảy ra sự kèo bóng đá việt nam. Đối số này có thể lànull.
pqsetInstanceataĐặt kết nốiConn'sInstancedatacho thủ tụcProcđếnData. Điều này trả về kèo bóng đá việt nam phải cho thành công và kèo bóng đá việt nam cho thất bại.Procchưa được đăng ký đúng trongConn.)
22679_22747
pqinstancedataTrả về kết nốiConn'sInstancedatađược liên kết với thủ tụcProchoặcnullNếu kèo bóng đá việt nam có.
void *pqinstancedata (const pgconn *Conn, pgEventProc Proc);
PQResultsetInstanceataĐặt kết quảInstancedatachoProcđếnData. Điều này trả về kèo bóng đá việt nam phải cho thành công và kèo bóng đá việt nam cho thất bại.Procchưa được đăng ký đúng trong kết quả.)
23651_23726
pqresultinstancedataTrả về kết quảInstancedatađược liên kết vớiProchoặcnullNếu kèo bóng đá việt nam có.
24061_24129
Đây là một ví dụ về bộ xương về việc quản lý dữ liệu riêng tư liên quan đến kết nối và kết quả LibPQ.
/ * Tiêu đề bắt buộc cho các sự kèo bóng đá việt nam libpq (Lưu ý: Bao gồm libpq-fe.h) *//