QNetworkProxyFactory Class

メンバ関数のドキュメント

QNetworkProxyFactory::QNetworkProxyFactory()

QNetworkProxyFactory オブジェクトを作成します。

QNetworkProxyFactory は抽象クラスなので、QNetworkProxyFactory 型のオブジェクトを直接作成することはできません。

[virtual noexcept] QNetworkProxyFactory::~QNetworkProxyFactory()

QNetworkProxyFactory オブジェクトを破棄する。

[static] QList<QNetworkProxy> QNetworkProxyFactory::proxyForQuery(const QNetworkProxyQuery &query)

この関数はクエリリクエストquery を受け取り、ソケットやリクエストのタイプの詳細を調べ、使用するプロキシサーバーを示すQNetworkProxy オブジェクトのリストを優先度の高い順に返す。

[pure virtual] QList<QNetworkProxy> QNetworkProxyFactory::queryProxy(const QNetworkProxyQuery &query = QNetworkProxyQuery())

この関数はクエリリクエストquery を受け取り、ソケットのタイプやリクエストの詳細を調べ、使用するプロキシサーバを優先度の高い順に示すQNetworkProxy オブジェクトのリストを返す。

このクラスを再実装する場合は、少なくとも1つの要素を返すように注意してください。

よりよいプロキシの代替を決定できない場合は、QNetworkProxy::DefaultProxy を使用します。これは、プロキシを問い合わせるコードに、より上位の代替を使用するように指示します。例えば、このファクトリーがQNetworkAccessManager オブジェクトに設定されている場合、DefaultProxy はアプリケーションレベルのプロキシ設定を問い合わせるように指示します。

このファクトリーがアプリケーションプロキシファクトリーとして設定されている場合、DefaultProxy と NoProxy は同じ意味になります。

[static] void QNetworkProxyFactory::setApplicationProxyFactory(QNetworkProxyFactory *factory)

アプリケーション全体のプロキシファクトリーをfactory に設定します。この関数はそのオブジェクトの所有権を持ち、必要に応じて削除する。

アプリケーション全体のプロキシは、他のすべてのプロキシ選択要求がQNetworkProxy::DefaultProxy を返したときの最後の手段として使用されます。例えば、QTcpSocket オブジェクトは QTcpSocket::setProxy でプロキシを設定できますが、何も設定されていない場合、この関数で設定されたプロキシ・ファクトリ・クラスが照会されます。

この関数でプロキシファクトリを設定した場合、QNetworkProxy::setApplicationProxy で設定されたアプリケーションレベルのプロキシはすべてオーバーライドされ、usesSystemConfiguration() はfalse を返します。

QNetworkProxy::setApplicationProxy()、QAbstractSocket::proxy()、QAbstractSocket::setProxy()も参照 。

[static] void QNetworkProxyFactory::setUseSystemConfiguration(bool enable)

プラットフォーム固有のプロキシ設定を有効にする。詳細はsystemProxyForQuery()を参照のこと。

enable をtrue に設定してこの関数を呼び出すと、すでに設定されているプロキシやQNetworkProxyFactory はすべてリセットされる。

[static] QList<QNetworkProxy> QNetworkProxyFactory::systemProxyForQuery(const QNetworkProxyQuery &query = QNetworkProxyQuery())

この関数はクエリリクエストquery を受け取り、ソケットのタイプやリクエストの詳細を調べ、使用するプロキシサーバーを優先順位の高い順に示すQNetworkProxy オブジェクトのリストを返す。

この関数はプラットフォーム固有のプロキシ設定を決定するために使用できる。もしそのようなライブラリがあれば、この関数はオペレーティングシステムが提供する ライブラリを使用して、指定された接続のプロキシを決定する。存在しない場合、この関数はQNetworkProxy::NoProxy 型のQNetworkProxy を返します。

Windowsでは、この関数はWinHTTP DLL関数を使用する。その名前にもかかわらず、Microsoftは、HTTPだけでなく、ネットワーク接続を必要とするすべてのアプリケーションにこの関数を使用することを推奨しています。これは、proxycfg.exeツールでレジストリに設定されたプロキシ設定を尊重する。これらの設定が見つからない場合、この関数はInternet Explorerの設定を取得し、それを使用しようとする。

macOSでは、この関数はAppleのCFNetworkフレームワークを使用してプロキシ設定を取得します。プロトコルタグ "ftp"、"http"、"https "を含むクエリに対して、それぞれFTP、HTTP、HTTPSプロキシ設定を適用する。その設定でSOCKSプロキシが有効になっている場合、この関数はすべてのクエリにSOCKSサーバーを使用する。SOCKSが有効でない場合、すべてのTcpSocketおよびUrlRequestクエリにHTTPSプロキシを使用します。

libproxy サポートが設定されているシステムでは、この関数は libproxy に依存してプロキシ設定を取得します。libproxyの設定によっては、デスクトップ設定や環境変数などに委譲されます。

その他のシステムでは、この関数は "http_proxy "環境変数からプロキシ設定を取得します。この変数は、以下のスキームのいずれかを使用したURLでなければならない：「http"、"socks5"、"socks5h "のいずれかでなければならない。

制限事項

これらは、この関数の現在のバージョンにおける制限事項です。Qt の将来のバージョンでは、ここに挙げた制限事項の一部が解除される可能性があります。

• Windows プラットフォームでは、ユーザーのシステム構成によっては、この関数の実行に数秒かかる場合があります。

[static] bool QNetworkProxyFactory::usesSystemConfiguration()

プラットフォーム固有のプロキシ設定が有効かどうかを返します。