31.1. Điều khiển tỷ lệ kèo bóng đá cơ sở dữ liệu Chức năng

Tạo tỷ lệ kèo bóng đá mới với máy chủ cơ sở dữ liệu.

13392_13485

Hàm này mở tỷ lệ kèo bóng đá cơ sở dữ liệu mới bằng cách sử dụng tham số được lấy từ hainull-tỷ lệ kèo bóng đá thúc mảng. Đầu tiên,Từ khóa, được định nghĩa là một mảng chuỗi, Mỗi người là một từ khóa. Thứ hai,Giá trị, đưa ra giá trị cho mỗi từ khóa. Không giống nhưPQSetDbLoginbên dưới, tập hợp tham số có thể được mở rộng mà không cần thay đổi Chữ ký chức tỷ lệ kèo bóng đá, vì vậy sử dụng chức tỷ lệ kèo bóng đá này (hoặc Các chất tương tự không chặnPQConnectStartParamsvàPQConnectPoll) được ưu tiên cho mới Lập trình ứng dụng.

khiexpand_dbnamelà không khác, ThedbnameGiá trị từ khóa là được phép được công nhận làConninfoChuỗi. Xem bên dưới cho chi tiết.

14526_14734nullphần tử củaTừ khóamảng.

Các từ khóa tham số hiện được công nhận là:

Nếu bất kỳ tham số nào không được xác định, thì tương ứng Biến môi trường (xemPhần 31.13) được kiểm tra. Nếu Biến môi trường cũng không được đặt, sau đó được chỉ định mặc định tích hợp được sử dụng.

nếuexpand_dbnamelà khác không Vàdbnamechứa=dấu, nó được lấy dưới dạngConninfoChuỗi theo cách tương tự như Nếu nó đã được truyền choPQConnectDB(xem bên dưới). Trước đây Các từ khóa được xử lý sẽ bị ghi đè bởi các từ khóa trongConninfochuỗi.

Nói chung, các từ khóa được xử lý từ đầu Các mảng theo thứ tự chỉ mục. Hiệu quả của điều này là Khi các từ khóa được lặp lại, giá trị được xử lý cuối cùng là giữ lại. Do đó, thông qua vị trí cẩn thận củadbnameTừ khóa, có thể Để xác định những gì có thể bị ghi đè bởi mộtConninfoChuỗi và những gì có thể không.

Tạo tỷ lệ kèo bóng đá mới với máy chủ cơ sở dữ liệu.

PGConn *PQConnectDB (const char *Conninfo);

Hàm này mở tỷ lệ kèo bóng đá cơ sở dữ liệu mới bằng cách sử dụng tham số được lấy từ chuỗiConninfo.

Chuỗi truyền có thể trống để sử dụng tất cả các mặc định tham số hoặc nó có thể chứa một hoặc nhiều tham số Cài đặt được phân tách bằng khoảng trắng. Mỗi cài đặt tham số là Trong biểu mẫutừ khóa = value. Không gian xung quanh dấu hiệu bằng nhau là tùy chọn. Để viết một Giá trị trống hoặc giá trị chứa khoảng trống, bao quanh nó với Báo giá đơn, ví dụ:Từ khóa = 'a giá trị'. Báo giá đơn và dấu gạch chéo ngược trong giá trị Phải được thoát ra bằng một dấu gạch chéo ngược, tức là,\ 'và\.

Các từ khóa tham số hiện được nhận ra là Giống như trên.

Tạo tỷ lệ kèo bóng đá mới với máy chủ cơ sở dữ liệu.

PGCONN *PQSetDbLogin (const char *
                     const char *pgport,
                     const char *pgoptions,
                     const char *pgtty,
                     const char *dbname,
                     const char *đăng nhập,
                     const char *pwd);

Đây là tiền thân củaPQConnectDBVới một bộ cố định tham số. Nó có cùng chức tỷ lệ kèo bóng đá ngoại trừ Thiếu tham số sẽ luôn luôn có các giá trị mặc định. Viếtnullhoặc một chuỗi trống cho bất kỳ một trong các tham số cố định là mặc định.

Nếudbnamechứa=dấu, nó được lấy dưới dạngConninfoChuỗi theo cách tương tự như Nếu nó đã được truyền choPQConnectDBvà các tham số còn lại sau đó được áp dụng như trên.

Tạo tỷ lệ kèo bóng đá mới với máy chủ cơ sở dữ liệu.

PGConn *PQSetDB (char *pghost,
                char *pgport,
                char *pgoptions,
                char *pgtty,
                char *dbname);

Đây là một macro gọiPQSetDbLoginvới các con trỏ null choĐăng nhậpvàPWDtham số. Nó được cung cấp cho Khả tỷ lệ kèo bóng đá tương thích ngược với các chương trình rất cũ.

Tạo tỷ lệ kèo bóng đá với máy chủ cơ sở dữ liệu trong A trong A cách không chặn.

39620_39819

Ba chức năng này được sử dụng để mở tỷ lệ kèo bóng đá với A máy chủ cơ sở dữ liệu sao cho chủ đề của ứng dụng của bạn về Thực thi không bị chặn trên I/O từ xa trong khi làm như vậy. Các Điểm của phương pháp này là sự chờ đợi cho I/O Hoàn thành có thể xảy ra trong vòng lặp chính của ứng dụng, thay vào đó hơn xuống bên trongPQConnectDBParamshoặcPQConnectDB, và vì vậy ứng dụng có thể Quản lý hoạt động này song song với các hoạt động khác các hoạt động.

vớiPQConnectStartParams,, tỷ lệ kèo bóng đá cơ sở dữ liệu được thực hiện bằng cách sử dụng các tham số được thực hiện từTừ khóavàgiá trịmảng và được kiểm soát bởiexpand_dbname, như được mô tả ở trên choPQConnectDBParams.

với40822_40838, The tỷ lệ kèo bóng đá cơ sở dữ liệu được thực hiện bằng các tham số được lấy từ chuỗiConninfonhư mô tả Trên choPQConnectDB.

khôngPQConnectStartParamscũng khôngPQConnectStartcũng khôngPQConnectPollsẽ chặn, miễn là a Số lượng hạn chế được đáp ứng:

• Thehostaddrvàhost41440_41620PQConnectDBParamsở trên Để biết chi tiết.

• Nếu bạn gọiPQTRACE,, đảm bảo rằng đối tượng luồng mà bạn theo dõi sẽ không khối.

• Bạn đảm bảo rằng ổ cắm phù hợp trạng thái trước khi gọiPQConnectPoll, như mô tả dưới.

Lưu ý: Sử dụngPQConnectStartParamstương tự nhưPQConnectStarthiển thị dưới.

Để bắt đầu yêu cầu tỷ lệ kèo bóng đá không chặn, hãy gọiConn = PQConnectStart ("Connection_info_String"). Nếu nhưConnlà null, sau đólibpqđã không thể phân bổ mớiPGConnCấu trúc. Nếu không, một hợp lệPGConnCon trỏ được trả về (mặc dù chưa đại diện cho một hợp lệ tỷ lệ kèo bóng đá với cơ sở dữ liệu). Khi trở về từPQConnectStart, gọistatus = pqstatus (Conn). Nếu nhưtrạng tháibằngConnection_Bad, PQConnectStartđã thất bại.

nếuPQConnectStartThành công, giai đoạn tiếp theo là thăm dò ý kiếnlibpq43319_43387PQSocket (Conn)Để có được bộ mô tả của ổ cắm bên dưới tỷ lệ kèo bóng đá cơ sở dữ liệu. Vòng lặp Do đó: nếuPQConnectPoll (Conn)Đã trả lại lần cuốipgres_polling_reading, đợi cho đến khi ổ cắm đã sẵn sàng để đọc (như được chỉ ra bởiselect (), poll ()hoặc chức tỷ lệ kèo bóng đá hệ thống tương tự). Sau đó gọiPQConnectPoll (Conn)Một lần nữa. Ngược lại, nếuPQConnectPoll (Conn)Trả về lần cuốiPGRES_POLLING_WRITY, đợi cho đến khi ổ cắm đã sẵn sàng để viết, sau đó gọiPQConnectPoll (Conn)Một lần nữa. Nếu bạn có chưa gọi44267_44282,, tức là, ngay sau cuộc gọi đếnPQConnectStart, hoạt động như thể nó kéo dài đã trả về44438_44461. Tiếp tục vòng lặp này cho đến khiPQConnectPoll (Conn)returnpgres_polling_failed, chỉ ra Quy trình tỷ lệ kèo bóng đá đã thất bại hoặcpgres_polling_ok, Cho biết tỷ lệ kèo bóng đá đã được thực hiện thành công.

Bất cứ lúc nào trong quá trình tỷ lệ kèo bóng đá, trạng thái của tỷ lệ kèo bóng đá có thể được kiểm tra bằng cách gọipqstatus. Nếu điều này choConnection_Bad, thì quy trình tỷ lệ kèo bóng đá đã thất bại; Nếu nó choConnection_ok, thì tỷ lệ kèo bóng đá là sẵn sàng. Cả hai trạng thái này đều có thể phát hiện như nhau từ Giá trị trả về củaPQConnectPoll, được mô tả ở trên. Khác Các quốc gia cũng có thể xảy ra trong (và chỉ trong) Quy trình tỷ lệ kèo bóng đá không đồng bộ. Những điều này chỉ ra giai đoạn hiện tại của thủ tục tỷ lệ kèo bóng đá và có thể là hữu ích để cung cấp phản hồi cho người dùng làm ví dụ. Những cái này Trạng thái là:

47304_47626

Switch (pqstatus (Conn))

        Case Connection_started:
            Phản hồi = "tỷ lệ kèo bóng đá ...";
            phá vỡ;

        Case Connection_Made:
            Phản hồi = "tỷ lệ kèo bóng đá với máy chủ ...";
            phá vỡ;
.
.
.
        mặc định:
            Phản hồi = "tỷ lệ kèo bóng đá ...";

TheConnect_Timeouttỷ lệ kèo bóng đá tham số bị bỏ qua khi sử dụngPQConnectPoll; nó là ứng dụng trách nhiệm quyết định xem một lượng quá mức của Thời gian đã trôi qua. Nếu không thì,PQConnectStarttheo sau làPQConnectPollVòng lặp tương đương vớiPQConnectDB.

Lưu ý rằng nếuPQConnectStartTrả về một người không phải là null con trỏ, bạn phải gọipqfinishKhi bạn kết thúc với nó, để xử lý cấu trúc và bất kỳ liên kết nào Khối bộ nhớ. Điều này phải được thực hiện ngay cả khi tỷ lệ kèo bóng đá cố gắng thất bại hoặc bị bỏ rơi.

Trả về các tùy chọn tỷ lệ kèo bóng đá mặc định.

49063_49841

Trả về một mảng tùy chọn tỷ lệ kèo bóng đá. Điều này có thể được sử dụng để Xác định tất cả có thểPQConnectDB49995_50095PQConninFooptionCấu trúc, tỷ lệ kèo bóng đá thúc bằng một mục có nullTừ khóaCon trỏ. Con trỏ null là trả lại nếu bộ nhớ không thể được phân bổ. Lưu ý rằng Giá trị mặc định hiện tại (50393_50398Trường) sẽ phụ thuộc vào các biến môi trường và các biến khác bối cảnh. Người gọi phải coi dữ liệu tùy chọn tỷ lệ kèo bóng đá là chỉ đọc.

Sau khi xử lý mảng tùy chọn, hãy giải phóng nó bằng cách truyền nó đếnPQConnInfofree. Nếu điều này không được thực hiện, một lượng nhỏ bộ nhớ bị rò rỉ cho mỗi Gọi đếnPQConnDefaults.

Trả về các tùy chọn tỷ lệ kèo bóng đá phân tích cú pháp từ được cung cấp chuỗi tỷ lệ kèo bóng đá.

51108_51183

Phân tích chuỗi tỷ lệ kèo bóng đá và trả về kết quả tùy chọn như một mảng; hoặc trả lạinullNếu có vấn đề với Chuỗi tỷ lệ kèo bóng đá. Điều này có thể được sử dụng để xác địnhPQConnectDBTùy chọn trong Cung cấp chuỗi tỷ lệ kèo bóng đá. Giá trị trả về chỉ ra một mảngPQConninFooptionCấu trúc, tỷ lệ kèo bóng đá thúc bằng một mục có nullTừ khóaCon trỏ.

Lưu ý rằng chỉ các tùy chọn được chỉ định rõ ràng trong Chuỗi sẽ có các giá trị được đặt trong mảng tỷ lệ kèo bóng đá quả; KHÔNG Mặc định được chèn.

nếuerrmsgkhông phảiNULL, sau đó*errmsgđược đặt thànhnull52068_52101malloc'D chuỗi lỗi giải thích vấn đề. (Nó cũng có thể cho*errmsgđược đặt thànhnullngay cả khinullđược trả về; Điều này cho thấy một bộ nhớ ngoài tình huống.)

52429_52500PQConnInfofree52542_52622PQConnInfopars. Ngược lại, Nếu xảy ra lỗi vàerrmsgIS khôngnull, Hãy chắc chắn giải phóng lỗi Chuỗi sử dụngPQFREEMEM.

Đóng tỷ lệ kèo bóng đá với máy chủ. Cũng giải phóng bộ nhớ Được sử dụng bởiPGConnĐối tượng.

void pqfinish (pgconn *Conn);

Lưu ý rằng ngay cả khi tỷ lệ kèo bóng đá máy chủ không cố (như được chỉ ra bởiPQSTATUS), Ứng dụng nên gọipqfinishĐể giải phóng bộ nhớ được sử dụng bởiPGConnĐối tượng. ThePGConnCon trỏ không được sử dụng lại sau đópqfinishđã được gọi điện.

Đặt lại kênh truyền thông cho máy chủ.

void pqreset (pgconn *Conn);

Chức năng này sẽ đóng tỷ lệ kèo bóng đá với máy chủ và cố gắng thiết lập lại một tỷ lệ kèo bóng đá mới với cùng một Máy chủ, sử dụng tất cả các tham số giống nhau được sử dụng trước đây. Cái này có thể hữu ích cho việc khôi phục lỗi nếu tỷ lệ kèo bóng đá làm việc bị mất.

Đặt lại kênh truyền thông cho máy chủ, trong A cách không chặn.

int pqresetstart (pgconn *Conn);

PostgrespollingStatusType PQResetPoll (PGConn *Conn);

Các chức năng này sẽ đóng tỷ lệ kèo bóng đá với máy chủ và cố gắng thiết lập lại một tỷ lệ kèo bóng đá mới với cùng một Máy chủ, sử dụng tất cả các tham số giống nhau được sử dụng trước đây. Cái này có thể hữu ích cho việc khôi phục lỗi nếu tỷ lệ kèo bóng đá làm việc là mất. Chúng khác vớipqreset(ở trên) trong đó họ hành động trong một cách không chặn. Các chức tỷ lệ kèo bóng đá này bị giống nhau Hạn chế làPQConnectStartParams, PQConnectStartvàPQConnectPoll.

Để bắt đầu đặt lại tỷ lệ kèo bóng đá, gọiPQResetStart. Nếu nó trả về 0, thiết lập lại đã thất bại. Nếu nó trả về 1, hãy bỏ phiếu đặt lại bằng cách sử dụngpqresetpollTrong chính xác theo cách mà bạn sẽ tạo tỷ lệ kèo bóng đá bằng cách sử dụngPQConnectPoll.