Chương 28.libpq- C soi kèo bóng đá truoctran

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

PGConn *PQConnectDB (const char *Conninfo);

Hàm này mở soi kèo bóng đá truoctran cơ sở dữ liệu mới bằng cách sử dụng các tham số được lấy từ chuỗiConninfo. Không giống nhưPQSetDbLoginbên dưới, bộ tham số có thể được mở rộng mà không thay đổi chữ ký chức năng, Vì vậy, sử soi kèo bóng đá truoctran chức năng này (hoặc các chất tương tự không chặn của nóPQConnectStartvàPQConnectPoll17116_17175

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 soi kèo bóng đá truoctran 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ố đang ở dạngtừ khóa = value. Không gian xung quanh dấu hiệu bằng nhau là tùy chọn. Để viết soi kèo bóng đá truoctran giá trị trống hoặc giá trị chứa khoảng trống, bao quanh nó với các trích dẫn đơn, ví dụ:Từ khóa = 'A Value'. Trích dẫn đơn và dấu gạch chéo ngược trong Giá trị phải được thoát bằng soi kèo bóng đá truoctran dấu gạch chéo ngược, tức là,\ 'và\.

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ì Biến môi trường tương ứng (xemPhần 28.11) được kiểm tra. Nếu biến môi trường cũng không được đặt, sau đó Các mặc định tích hợp được chỉ định được sử soi kèo bóng đá truoctran.

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

PGConn *pqsetdblogin (const char *pghost,
                     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 soi kèo bóng đá truoctran bộ cố định tham số. Nó có cùng chức năng ngoại trừ Thiếu tham số sẽ luôn luôn có các giá trị mặc định. Viếtnull28430_28532

Tạo soi kèo bóng đá truoctran 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à soi kèo bóng đá truoctran macro gọiPQSetDbLoginvới các con trỏ null choĐăng nhậpvàPWDtham số. Nó được cung cấp cho Khả năng tương thích ngược với các chương trình rất cũ.

Tạo a soi kèo bóng đá truoctran với máy chủ cơ sở dữ liệu trong một số chặn thái độ.

PGConn *PQConnectStart (const char *Conninfo);

29724_29782

Hai chức năng này được sử dụng để mở soi kèo bóng đá truoctran 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. Đ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 trongPQConnectDB, và vì vậy ứng soi kèo bóng đá truoctran 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.

soi kèo bóng đá truoctran cơ sở dữ liệu được tạo bằng các tham số được lấy từ chuỗiConninfo,, được truyền cho30487_30503. Chuỗi này ở cùng định dạng như được mô tả ở trên choPQConnectDB.

KhôngPQConnectStartcũng khôngPQConnectPollWill khối, miễn là soi kèo bóng đá truoctran số hạn chế được đáp ứng:

• ThehostaddrvàhostTham số được sử dụng một cách thích hợp để đảm bảo tên và tên đảo ngược đó Truy vấn không được thực hiện. Xem tài soi kèo bóng đá truoctran của những điều này tham số dướiPQConnectDBở 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 chặn.

• 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.

Để bắt đầu yêu cầu soi kèo bóng đá truoctran 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, soi kèo bóng đá truoctran hợp lệPGConnCon trỏ được trả về (mặc dù chưa đại diện cho một hợp lệ soi kèo bóng đá truoctran 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ếnlibpqđể nó có thể tiến hành Trình tự soi kèo bóng đá truoctran. Sử dụngPQSocket (Conn)Để có được bộ mô tả của ổ cắm bên dưới soi kèo bóng đá truoctran cơ sở dữ liệu. Vòng lặp Do đó: nếuPQConnectPoll (Conn)Trả về 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 hàm hệ thống tương tự). Sau đó gọiPQConnectPoll (Conn)soi kèo bóng đá truoctran lần nữa. Ngược lại, nếu nhưPQConnectPoll (Conn)Cuối cùng đã trả vềPGRES_POLLING_WRITY,, Chờ cho đến khi ổ cắm sẵn sàng để viết, sau đó gọiPQConnectPoll (Conn)soi kèo bóng đá truoctran lần nữa. Nếu bạn chưa gọiPQConnectPoll, tức là, ngay sau khi Gọi đếnPQConnectStart,, hành xử như thể nó đã trả về lần cuốiPGRES_POLLING_WRITY. Tiếp tục vòng lặp này cho đến khiPQConnectPoll (Conn)returnPGRES_POLLING_FAILED,, Cho biết quy trình soi kèo bóng đá truoctran đã thất bại hoặcpgres_polling_ok, chỉ ra soi kèo bóng đá truoctran đã được thực hiện thành công.

34267_34365pqstatus. Nếu điều này choConnection_Bad, sau đó là soi kèo bóng đá truoctran thủ tục đã thất bại; Nếu nó choConnection_ok, thì soi kèo bóng đá truoctran 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ủaPQConnectPoll34772_35077

Lưu ý rằng, mặc dù các hằng số này sẽ vẫn còn ( để duy trì khả năng tương thích), soi kèo bóng đá truoctran ứng dụng nên Không bao giờ dựa vào những điều này xảy ra theo soi kèo bóng đá truoctran thứ tự cụ thể, hoặc Tất cả, hoặc về tình trạng luôn là soi kèo bóng đá truoctran trong số đó giá trị được ghi lại. soi kèo bóng đá truoctran ứng dụng có thể làm soi kèo bóng đá truoctran cái gì đó như cái này:

Switch (pqstatus (Conn))

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

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

TheConnect_TimeoutTham số soi kèo bóng đá truoctran bị bỏ qua khi sử dụngPQConnectPoll; nó là ứng dụng trách nhiệm quyết định xem soi kèo bóng đá truoctran 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 là tương đương vớiPQConnectDB.

Lưu ý rằng nếuPQConnectStartTrả về soi kèo bóng đá truoctran người không 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 soi kèo bóng đá truoctran cố gắng thất bại hoặc bị bỏ rơi.

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

PQConnInFooption *PQConnDefaults (void);

Cấu trúc typedef

    từ khóa *từ khóa;   / * Từ khóa của tùy chọn */
    char *envvar;    / * Tên biến môi trường dự phòng */
    char *biên soạn;  / * Dự phòng được biên dịch trong giá trị mặc định */
    char *val;       / * Giá trị hiện tại của tùy chọn hoặc null */
    Nhãn char *;     / * Nhãn cho trường trong hộp thoại Connect */
    char *vua;  /* Ký tự để hiển thị cho trường này
                          Trong một hộp thoại soi kèo bóng đá truoctran. Giá trị là:
                          "" Hiển thị giá trị đã nhập như là
                          "*" Trường mật khẩu - ẩn giá trị
                          Tùy chọn gỡ lỗi "D" - không hiển thị theo mặc định */
    int phân tán;  / * Kích thước trường trong các ký tự cho hộp thoại */
 PQConnInFooption;

Trả về mảng tùy chọn soi kèo bóng đá truoctran. Điều này có thể được sử dụng Để xác định tất cả có thểPQConnectDBTùy chọn và dòng điện của chúng giá trị mặc định. Giá trị trả về chỉ vào soi kèo bóng đá truoctran mảngPQConninFooptionCấu trúc, soi kèo bóng đá truoctran 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 (ValTrườ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 xử lý dữ liệu tùy chọn soi kèo bóng đá truoctran như chỉ đọc.

Sau khi xử lý mảng tùy chọn, hãy giải phóng nó bằng cách vượt qua nó đếnPQConninFofree. Nếu như Điều này không được thực hiện, soi kèo bóng đá truoctran lượng nhỏ bộ nhớ bị rò rỉ cho Mỗi cuộc gọi đếnPQConnDefaults.

Đóng soi kèo bóng đá truoctran 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 soi kèo bóng đá truoctran máy chủ không cố (như được chỉ ra bởipqstatus), Ứng soi kèo bóng đá truoctran nên gọipqfinishĐể giải phóng bộ nhớ được sử soi kèo bóng đá truoctran bởiPGConnĐối tượng. ThePGConnCon trỏ không được sử soi kèo bóng đá truoctran lại sau đópqfinishđã được gọi điện.

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

40895_40926

Hàm này sẽ đóng soi kèo bóng đá truoctran với máy chủ và cố gắng thiết lập lại một soi kèo bóng đá truoctran 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. Điều này có thể hữu ích cho việc khôi phục lỗi nếu hoạt động soi kèo bóng đá truoctran 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);

41664_41720

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

Để bắt đầu đặt lại soi kèo bóng đá truoctran, hãy gọipqresetstart. Nếu nó trở lại 0, Đặt 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ử soi kèo bóng đá truoctranpqresetpollTrong chính xác theo cách mà bạn sẽ tạo soi kèo bóng đá truoctran bằng cách sử dụngPQConnectPoll.