SocketUtils (Spring Framework API)

java.lang.ObjectSE
- org.springframework.util.SocketUtils

使用すべきではありません。
Spring Framework 5.3.16 の時点で、6.0 で削除される予定です。詳細については、class-level Javadoc を参照してください。
```
@DeprecatedSE
public class SocketUtils
extends ObjectSE
```
ネットワークソケットを操作するためのシンプルなユーティリティメソッド — たとえば、localhost で使用可能なポートを検索する場合。
このクラス内で、TCP ポートは ServerSocketSE のポートを参照します。一方、UDP ポートは DatagramSocketSE のポートを指します。
SocketUtils は Spring Framework 4.0 で導入されました。これは主に、使用可能なランダムポートで外部サーバーを起動する統合テストの作成を支援するためです。ただし、これらのユーティリティは、特定のポートのその後の可用性について保証するものではないため、信頼性がありません。SocketUtils を使用してサーバーで使用可能なローカルポートを見つける代わりに、サーバーが選択した、またはオペレーティングシステムによって割り当てられたランダムなポートでサーバーを起動する機能に依存することをお勧めします。そのサーバーと対話するには、サーバーが現在使用しているポートを照会する必要があります。
導入:
4.0
作成者:
Sam Brannen, Ben Hale, Arjen Poutsma, Gunnar Hillert, Gary Russell

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static int`	`PORT_RANGE_MAX` 使用すべきではありません。使用可能なソケットポートを見つけるときに使用されるポート範囲のデフォルトの最大値。
`static int`	`PORT_RANGE_MIN` 使用すべきではありません。使用可能なソケットポートを見つけるときに使用されるポート範囲のデフォルトの最小値。

コンストラクターの概要

コンストラクター
コンストラクターと説明
`SocketUtils()` 使用すべきではありません。 `SocketUtils` は静的ユーティリティメソッドのみで構成されていますが、このコンストラクターは意図的に `public` です。

メソッドのサマリー

すべてのメソッド静的メソッド具象メソッド非推奨のメソッド
修飾子と型	メソッドと説明
`static int`	`findAvailableTcpPort()` 使用すべきではありません。範囲 [ 1024、65535 ] からランダムに選択された使用可能な TCP ポートを見つけます。
`static int`	`findAvailableTcpPort(int minPort)` 使用すべきではありません。範囲 [`minPort`、65535 ] からランダムに選択された使用可能な TCP ポートを見つけます。
`static int`	`findAvailableTcpPort(int minPort, int maxPort)` 使用すべきではありません。範囲 [`minPort`、`maxPort`] からランダムに選択された使用可能な TCP ポートを見つけます。
`static SortedSetSE<IntegerSE>`	`findAvailableTcpPorts(int numRequested)` 使用すべきではありません。範囲 [ 1024、65535 ] からランダムに選択された、使用可能な TCP ポートのリクエストされた数を見つけます。
`static SortedSetSE<IntegerSE>`	`findAvailableTcpPorts(int numRequested, int minPort, int maxPort)` 使用すべきではありません。範囲 [`minPort`、`maxPort`] からランダムに選択された、使用可能な TCP ポートのリクエストされた数を見つけます。
`static int`	`findAvailableUdpPort()` 使用すべきではありません。範囲 [ 1024、65535 ] からランダムに選択された使用可能な UDP ポートを見つけます。
`static int`	`findAvailableUdpPort(int minPort)` 使用すべきではありません。範囲 [`minPort`、65535 ] からランダムに選択された使用可能な UDP ポートを見つけます。
`static int`	`findAvailableUdpPort(int minPort, int maxPort)` 使用すべきではありません。範囲 [`minPort`、`maxPort`] からランダムに選択された使用可能な UDP ポートを見つけます。
`static SortedSetSE<IntegerSE>`	`findAvailableUdpPorts(int numRequested)` 使用すべきではありません。使用可能な UDP ポートのリクエストされた数を見つけます。それぞれは、[ 1024、65535 ] の範囲からランダムに選択されます。
`static SortedSetSE<IntegerSE>`	`findAvailableUdpPorts(int numRequested, int minPort, int maxPort)` 使用すべきではありません。範囲 [`minPort`、`maxPort`] からランダムに選択された、使用可能な UDP ポートのリクエストされた数を見つけます。

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- フィールドの詳細
  - PORT_RANGE_MIN
```
public static final int PORT_RANGE_MIN
```
    使用すべきではありません。
    使用可能なソケットポートを見つけるときに使用されるポート範囲のデフォルトの最小値。
    関連事項:
    定数フィールド値
  - PORT_RANGE_MAX
```
public static final int PORT_RANGE_MAX
```
    使用すべきではありません。
    使用可能なソケットポートを見つけるときに使用されるポート範囲のデフォルトの最大値。
    関連事項:
    定数フィールド値
- コンストラクターの詳細
  - SocketUtils
```
public SocketUtils()
```
    使用すべきではありません。
    SocketUtils は静的ユーティリティメソッドのみで構成されていますが、このコンストラクターは意図的に public です。
    Rationale
    このクラスの静的メソッドは、Spring 式言語（SpEL）と次の構文を使用して、XML 構成ファイル内から呼び出すことができます。
```
<bean id="bean1" ... p:port="#{T(org.springframework.util.SocketUtils).findAvailableTcpPort(12000)}" />
```
    このコンストラクターが private の場合、使用箇所ごとに完全修飾クラス名を SpEL の T() 関数に指定する必要があります。このコンストラクターが public であるという事実により、次の例に示すように、SpEL を使用してボイラープレート構成を減らすことができます。
```
<bean id="socketUtils" class="org.springframework.util.SocketUtils" />
 <bean id="bean1" ... p:port="#{socketUtils.findAvailableTcpPort(12000)}" />
 <bean id="bean2" ... p:port="#{socketUtils.findAvailableTcpPort(30000)}" />
```
- メソッドの詳細
  - findAvailableTcpPort
```
public static int findAvailableTcpPort()
```
    使用すべきではありません。
    範囲 [ 1024、65535 ] からランダムに選択された使用可能な TCP ポートを見つけます。
    戻り値:
    使用可能な TCP ポート番号
    例外:
    IllegalStateExceptionSE - 使用可能なポートが見つからなかった場合
  - findAvailableTcpPort
```
public static int findAvailableTcpPort(int minPort)
```
    使用すべきではありません。
    範囲 [minPort、65535 ] からランダムに選択された使用可能な TCP ポートを見つけます。
    パラメーター:
    minPort - 最小ポート番号
    戻り値:
    使用可能な TCP ポート番号
    例外:
    IllegalStateExceptionSE - 使用可能なポートが見つからなかった場合
  - findAvailableTcpPort
```
public static int findAvailableTcpPort(int minPort,
                                       int maxPort)
```
    使用すべきではありません。
    範囲 [minPort、maxPort] からランダムに選択された使用可能な TCP ポートを見つけます。
    パラメーター:
    minPort - 最小ポート番号
    maxPort - 最大ポート番号
    戻り値:
    使用可能な TCP ポート番号
    例外:
    IllegalStateExceptionSE - 使用可能なポートが見つからなかった場合
  - findAvailableTcpPorts
```
public static SortedSetSE<IntegerSE> findAvailableTcpPorts(int numRequested)
```
    使用すべきではありません。
    範囲 [ 1024、65535 ] からランダムに選択された、使用可能な TCP ポートのリクエストされた数を見つけます。
    パラメーター:
    numRequested - 検索できるポートの数
    戻り値:
    使用可能な TCP ポート番号のソートされたセット
    例外:
    IllegalStateExceptionSE - リクエストされた数の使用可能なポートが見つからなかった場合
  - findAvailableTcpPorts
```
public static SortedSetSE<IntegerSE> findAvailableTcpPorts(int numRequested,
                                                       int minPort,
                                                       int maxPort)
```
    使用すべきではありません。
    範囲 [minPort、maxPort] からランダムに選択された、使用可能な TCP ポートのリクエストされた数を見つけます。
    パラメーター:
    numRequested - 検索できるポートの数
    minPort - 最小ポート番号
    maxPort - 最大ポート番号
    戻り値:
    使用可能な TCP ポート番号のソートされたセット
    例外:
    IllegalStateExceptionSE - リクエストされた数の使用可能なポートが見つからなかった場合
  - findAvailableUdpPort
```
public static int findAvailableUdpPort()
```
    使用すべきではありません。
    範囲 [ 1024、65535 ] からランダムに選択された使用可能な UDP ポートを見つけます。
    戻り値:
    利用可能な UDP ポート番号
    例外:
    IllegalStateExceptionSE - 使用可能なポートが見つからなかった場合
  - findAvailableUdpPort
```
public static int findAvailableUdpPort(int minPort)
```
    使用すべきではありません。
    範囲 [minPort、65535 ] からランダムに選択された使用可能な UDP ポートを見つけます。
    パラメーター:
    minPort - 最小ポート番号
    戻り値:
    利用可能な UDP ポート番号
    例外:
    IllegalStateExceptionSE - 使用可能なポートが見つからなかった場合
  - findAvailableUdpPort
```
public static int findAvailableUdpPort(int minPort,
                                       int maxPort)
```
    使用すべきではありません。
    範囲 [minPort、maxPort] からランダムに選択された使用可能な UDP ポートを見つけます。
    パラメーター:
    minPort - 最小ポート番号
    maxPort - 最大ポート番号
    戻り値:
    利用可能な UDP ポート番号
    例外:
    IllegalStateExceptionSE - 使用可能なポートが見つからなかった場合
  - findAvailableUdpPorts
```
public static SortedSetSE<IntegerSE> findAvailableUdpPorts(int numRequested)
```
    使用すべきではありません。
    使用可能な UDP ポートのリクエストされた数を見つけます。それぞれは、[ 1024、65535 ] の範囲からランダムに選択されます。
    パラメーター:
    numRequested - 検索できるポートの数
    戻り値:
    使用可能な UDP ポート番号のソートされたセット
    例外:
    IllegalStateExceptionSE - リクエストされた数の使用可能なポートが見つからなかった場合
  - findAvailableUdpPorts
```
public static SortedSetSE<IntegerSE> findAvailableUdpPorts(int numRequested,
                                                       int minPort,
                                                       int maxPort)
```
    使用すべきではありません。
    範囲 [minPort、maxPort] からランダムに選択された、使用可能な UDP ポートのリクエストされた数を見つけます。
    パラメーター:
    numRequested - 検索できるポートの数
    minPort - 最小ポート番号
    maxPort - 最大ポート番号
    戻り値:
    使用可能な UDP ポート番号のソートされたセット
    例外:
    IllegalStateExceptionSE - リクエストされた数の使用可能なポートが見つからなかった場合

クラス SocketUtils

フィールドのサマリー

コンストラクターの概要

メソッドのサマリー

クラス java.lang.ObjectSE から継承されたメソッド

フィールドの詳細

PORT_RANGE_MIN

PORT_RANGE_MAX

コンストラクターの詳細

SocketUtils

Rationale

メソッドの詳細

findAvailableTcpPort

findAvailableTcpPort

findAvailableTcpPort

findAvailableTcpPorts

findAvailableTcpPorts

findAvailableUdpPort

findAvailableUdpPort

findAvailableUdpPort

findAvailableUdpPorts

findAvailableUdpPorts