class-level Javadoc
を参照してください。@DeprecatedSE public class SocketUtils extends ObjectSE
localhost
で使用可能なポートを検索する場合。 このクラス内で、TCP ポートは ServerSocket
SE のポートを参照します。一方、UDP ポートは DatagramSocket
SE のポートを指します。
SocketUtils
は Spring Framework 4.0 で導入されました。これは主に、使用可能なランダムポートで外部サーバーを起動する統合テストの作成を支援するためです。ただし、これらのユーティリティは、特定のポートのその後の可用性について保証するものではないため、信頼性がありません。SocketUtils
を使用してサーバーで使用可能なローカルポートを見つける代わりに、サーバーが選択した、またはオペレーティングシステムによって割り当てられたランダムなポートでサーバーを起動する機能に依存することをお勧めします。そのサーバーと対話するには、サーバーが現在使用しているポートを照会する必要があります。
修飾子と型 | フィールドと説明 |
---|---|
static int | PORT_RANGE_MAX 使用すべきではありません。 使用可能なソケットポートを見つけるときに使用されるポート範囲のデフォルトの最大値。 |
static int | PORT_RANGE_MIN 使用すべきではありません。 使用可能なソケットポートを見つけるときに使用されるポート範囲のデフォルトの最小値。 |
コンストラクターと説明 |
---|
SocketUtils() 使用すべきではありません。 SocketUtils は静的ユーティリティメソッドのみで構成されていますが、このコンストラクターは意図的に public です。 |
修飾子と型 | メソッドと説明 |
---|---|
static int | findAvailableTcpPort() 使用すべきではありません。 |
static int | findAvailableTcpPort(int minPort) 使用すべきではありません。 範囲 [ minPort 、65535 ] からランダムに選択された使用可能な TCP ポートを見つけます。 |
static int | findAvailableTcpPort(int minPort, int maxPort) 使用すべきではありません。 範囲 [ minPort 、maxPort ] からランダムに選択された使用可能な TCP ポートを見つけます。 |
static SortedSetSE<IntegerSE> | findAvailableTcpPorts(int numRequested) 使用すべきではありません。 |
static SortedSetSE<IntegerSE> | findAvailableTcpPorts(int numRequested, int minPort, int maxPort) 使用すべきではありません。 範囲 [ minPort 、maxPort ] からランダムに選択された、使用可能な TCP ポートのリクエストされた数を見つけます。 |
static int | findAvailableUdpPort() 使用すべきではありません。 |
static int | findAvailableUdpPort(int minPort) 使用すべきではありません。 範囲 [ minPort 、65535 ] からランダムに選択された使用可能な UDP ポートを見つけます。 |
static int | findAvailableUdpPort(int minPort, int maxPort) 使用すべきではありません。 範囲 [ minPort 、maxPort ] からランダムに選択された使用可能な UDP ポートを見つけます。 |
static SortedSetSE<IntegerSE> | findAvailableUdpPorts(int numRequested) 使用すべきではありません。 |
static SortedSetSE<IntegerSE> | findAvailableUdpPorts(int numRequested, int minPort, int maxPort) 使用すべきではありません。 範囲 [ minPort 、maxPort ] からランダムに選択された、使用可能な UDP ポートのリクエストされた数を見つけます。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
public static final int PORT_RANGE_MIN
public static final int PORT_RANGE_MAX
public SocketUtils()
SocketUtils
は静的ユーティリティメソッドのみで構成されていますが、このコンストラクターは意図的に public
です。このクラスの静的メソッドは、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)}" />
public static int findAvailableTcpPort()
IllegalStateExceptionSE
- 使用可能なポートが見つからなかった場合 public static int findAvailableTcpPort(int minPort)
minPort
、65535 ] からランダムに選択された使用可能な TCP ポートを見つけます。minPort
- 最小ポート番号 IllegalStateExceptionSE
- 使用可能なポートが見つからなかった場合 public static int findAvailableTcpPort(int minPort, int maxPort)
minPort
、maxPort
] からランダムに選択された使用可能な TCP ポートを見つけます。minPort
- 最小ポート番号 maxPort
- 最大ポート番号 IllegalStateExceptionSE
- 使用可能なポートが見つからなかった場合 public static SortedSetSE<IntegerSE> findAvailableTcpPorts(int numRequested)
numRequested
- 検索できるポートの数 IllegalStateExceptionSE
- リクエストされた数の使用可能なポートが見つからなかった場合 public static SortedSetSE<IntegerSE> findAvailableTcpPorts(int numRequested, int minPort, int maxPort)
minPort
、maxPort
] からランダムに選択された、使用可能な TCP ポートのリクエストされた数を見つけます。numRequested
- 検索できるポートの数 minPort
- 最小ポート番号 maxPort
- 最大ポート番号 IllegalStateExceptionSE
- リクエストされた数の使用可能なポートが見つからなかった場合 public static int findAvailableUdpPort()
IllegalStateExceptionSE
- 使用可能なポートが見つからなかった場合 public static int findAvailableUdpPort(int minPort)
minPort
、65535 ] からランダムに選択された使用可能な UDP ポートを見つけます。minPort
- 最小ポート番号 IllegalStateExceptionSE
- 使用可能なポートが見つからなかった場合 public static int findAvailableUdpPort(int minPort, int maxPort)
minPort
、maxPort
] からランダムに選択された使用可能な UDP ポートを見つけます。minPort
- 最小ポート番号 maxPort
- 最大ポート番号 IllegalStateExceptionSE
- 使用可能なポートが見つからなかった場合 public static SortedSetSE<IntegerSE> findAvailableUdpPorts(int numRequested)
numRequested
- 検索できるポートの数 IllegalStateExceptionSE
- リクエストされた数の使用可能なポートが見つからなかった場合 public static SortedSetSE<IntegerSE> findAvailableUdpPorts(int numRequested, int minPort, int maxPort)
minPort
、maxPort
] からランダムに選択された、使用可能な UDP ポートのリクエストされた数を見つけます。numRequested
- 検索できるポートの数 minPort
- 最小ポート番号 maxPort
- 最大ポート番号 IllegalStateExceptionSE
- リクエストされた数の使用可能なポートが見つからなかった場合