URLSessionConfiguration

Overview 概要

An URLSessionConfiguration object defines the behavior and policies to use when uploading and downloading data using an URLSession object. When uploading or downloading data, creating a configuration object is always the first step you must take. You use this object to configure the timeout values, caching policies, connection requirements, and other types of information that you intend to use with your URLSession object. URLSessionConfigurationオブジェクトは、URLSessionオブジェクトを使ってデータをアップロードおよびダウンロードするときに使う挙動と方針を定義します。データをアップロードまたはダウンロードする時、構成設定オブジェクトを作成することは、常にあなたが取らなければならない最初の一歩です。あなたはこのオブジェクトを使うことで、タイムアウト値、キャッシュ方針、接続要件、そしてあなたのURLSessionオブジェクトで使うことをあなたが意図する他の種類の情報を構成設定します。

It is important to configure your URLSessionConfiguration object appropriately before using it to initialize a session object. Session objects make a copy of the configuration settings you provide and use those settings to configure the session. Once configured, the session object ignores any changes you make to the URLSessionConfiguration object. If you need to modify your transfer policies, you must update the session configuration object and use it to create a new URLSession object. 重要なことは、あなたのURLSessionConfigurationオブジェクトを、それを使ってセッションオブジェクトを初期化する前に、適切に構成設定することです。セッションオブジェクトは、あなたが提供する構成設定の設定それらのコピーを作ります、そしてそれらの設定を使ってセッションを構成設定します。一旦構成設定されたならば、セッションオブジェクトは、あなたがURLSessionConfigurationオブジェクトにするあらゆる変更を無視します。あなたがあなたの転送方針を修正する必要があるならば、あなたはセッション構成設定オブジェクトを更新して、それを使って新しいURLSessionオブジェクトを作成しなければなりません。

For more information about using configuration objects to create sessions, see URLSession. セッションを作成するために構成設定オブジェクトを使うことについてのさらなる情報として、URLSessionを見てください。

Types of Session Configurations セッション構成設定の型

The behavior and capabilities of a URL session are largely determined by the kind of configuration used to create the session. あるURLセッションの挙動と能力は、セッションを作成するために使われる構成設定の種類によって大部分は決定されます。

The singleton shared session (which has no configuration object) is for basic requests. It’s not as customizable as sessions that you create, but it serves as a good starting point if you have very limited requirements. You access this session by calling the shared class method. See that method’s discussion for more information about its limitations. シングルトン共有セッション（それは構成設定オブジェクトを持ちません）は、基本的なリクエストに対するものです。それはあなたが作成するセッションと同じようにカスタマイズ可能ではありません、しかしそれは良い出発点として利用できます、もしあなたが非常に制限された要件を持つならば。あなたはこのセッションに、共有クラスメソッドを呼び出すことによってアクセスします。そのメソッドのもつ議論をそれの限界についてのさらなる情報として見てください。

Default sessions behave much like the shared session (unless you customize them further), but let you obtain data incrementally using a delegate. You can create a default session configuration by calling the default method on the URLSessionConfiguration class. 省略時のセッションは、ほとんど共有セッションのように振るまいます、しかしあなたにデータを漸増的に委任先を使って入手させます。あなたは、省略時のセッション構成設定を、省略時のメソッドをURLSessionConfigurationクラス上で呼び出すことによって作成できます。

Ephemeral sessions are similar to default sessions, but they don’t write caches, cookies, or credentials to disk. You can create an ephemeral session configuration by calling the ephemeral method on the URLSessionConfiguration class. 短命セッションは、省略時のセッションに似ています、しかしそれらはキャッシュ、クッキー、または資格情報をディスクに書き出しません。あなたは、短命セッション構成設定を、短命メソッドをURLSessionConfigurationクラス上で呼び出すことによって作成できます。

Background sessions let you perform uploads and downloads of content in the background while your app isn’t running. You can create a background session configuration by calling the backgroundSessionConfiguration(_:) method on the URLSessionConfiguration class. バックグラウンドセッションは、あなたに内容のアップロードとダウンロードをあなたのアプリが動作していない間にバックグラウンドで実行させます。あなたは、バックグラウンドセッション構成設定を、backgroundSessionConfiguration(_:) メソッドをURLSessionConfigurationクラス上で呼び出すことによって作成できます。