## Convenience HTTP client API Convenience HTTP client API — HTTPクライアントとして動作するためのAPI。 |

## Functions

SoupCutClient * | soupcut_client_new ()
void | soupcut_client_set_base ()
guint | soupcut_client_send_message ()
guint | soupcut_client_get ()
guint | soupcut_client_get_n_messages ()
SoupMessage * | soupcut_client_get_latest_message ()
GMainContext * | soupcut_client_get_async_context ()

## プロパティ

gboolean | async | Read / Write

## オブジェクト階層

    GObject
        ╰── SoupCutClient

## 説明

SoupCutClientオブジェクトはHTTPクライアントとして動作します。SoupCutClientは複数のリクエストやレスポンスを管理することができます。また、SoupCutClientに関連するアサーションのAPIも提供しています。

## Functions

### soupcut_client_new ()

    SoupCutClient *
    soupcut_client_new (void);

新たにSoupCutClientオブジェクトを生成して返します。

#### Returns

SoupCutClientオブジェクト。

Since: 1.0.8

### soupcut_client_set_base ()

    void
    soupcut_client_set_base (SoupCutClient *client,
                             const gchar *uri);

`client`のベースURIを`uri`に設定します。

#### Parameters

client | SoupCutClientオブジェクト。 |
uri | ベースURIの文字列。 |

Since: 1.0.8

### soupcut_client_send_message ()

    guint
    soupcut_client_send_message (SoupCutClient *client,
                                 SoupMessage *message);

`client`を使って`message`を送信します。`client`は過去に送信した全てのSoupMessageの情報を保持しています。

#### Parameters

client | SoupCutClientオブジェクト。 |
message | SoupMessageオブジェクト。 |

#### Returns

レスポンスのステータスコード。

Since: 1.0.8

### soupcut_client_get ()

    guint
    soupcut_client_get (SoupCutClient *client,
                        const gchar *uri,
                        const gchar *first_query_name,
                        ...);

`uri`とクエリパラメータで指定されたURIにGETリクエストを送信します。もしも`client`のベースURIが`soupcut_client_set_base()`によって設定されていた場合は、URIはベースURIと`uri`を組み合わせたものとなります。そうでない場合は、`uri`は絶対URIである必要があります。

#### Parameters

client | SoupCutClientオブジェクト。 |
uri | URI文字列。 |
first_query_name | ひとつめのクエリパラメータの名前 |
... | `first_query_name`から始まる、クエリパラメータの名前と値のペア。最後に`NULL`を指定しなければいけません。 |

#### Returns

レスポンスのステータスコード。

Since: 1.0.8

### soupcut_client_get_n_messages ()

    guint
    soupcut_client_get_n_messages (SoupCutClient *client);

`client`が送信した#SoupMessageの数。

#### Parameters

client | SoupCutClientオブジェクト。 |

#### Returns

SoupMessageの数。

Since: 1.0.8

### soupcut_client_get_latest_message ()

    SoupMessage *
    soupcut_client_get_latest_message (SoupCutClient *client);

`client`が最後に送信したSoupMessageオブジェクト。

#### Parameters

client | SoupCutClientオブジェクト。 |

#### Returns

最後に送信されたSoupMessageオブジェクト。

Since: 1.0.8

### soupcut_client_get_async_context ()

    GMainContext *
    soupcut_client_get_async_context (SoupCutClient *client);

`client`の非同期コンテキスト。

#### Parameters

client | SoupCutClientオブジェクト。 |

#### Returns

`client`のGMainContext。`NULL`が返る可能性があります。

Since: 1.0.8

## プロパティ詳細

### `"async"`プロパティ

    “async”                    gboolean

セッションが非同期の場合は真。

Owner: SoupCutClient

Flags: Read / Write

デフォルト値: FALSE

## 参考

HTTPクライアント・サーバ用の検証