|
Unofficial "CLDC 1.1 + MIDP 2.0" API Reference. (日本語版) |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
public interface UDPDatagramConnection
このインタフェースは既知のローカル・エンド・ポイント・アドレスとのデータグラム接続を定義します。
データグラム・プロトコルはトランザクション指向であり、配信保証や経路上で複製された情報の単一化などは一切行われません。
データがストリームとして信頼できる転送を必要とするアプリケーションは SocketConnection
を使用すべきです。
スキームが"datagram://"
の URL 接続文字列を Connector
クラスの open
系メソッドで開くと UDPDatagramConnection
オブジェクトを取得できます。
URL 接続文字列がホストとポート・フィールドの両方を省略した文字列の場合、システムは利用可能なポートを割り当てます。
このインタフェースに存在するアクセサ・メソッドを呼び出すことでローカル・アドレスとローカル・ポートを取得することができます。
また、送付先アドレスを割り当てるために使用する Datagram.setAddress(String)
メソッドに渡すデータグラム URL 接続文字列も、ここで説明する構文が有効です(例えば"datagram://host:port"
)。
URI は以下で指定する BNF 構文規則に従わなければなりません。
URI がこの構文規則に合致しない場合は IllegalArgumentException
を throw します。
<データグラム接続文字列> | ::= "datagram://" | "datagram://" <ホストとポート> |
<ホストとポート> | ::= <ホスト> ":" <ポート> |
<ホスト> | ::= ホスト名またはIPアドレス(インバウンド(内部向け)の接続ではホストは省略します) |
<ポート> | ::= 数字によるポート番号(システムが割り当てるポート番号を使用する場合は省略します) |
メソッドの概要 | |
---|---|
String |
getLocalAddress()
データグラム接続と結び付けられているローカル・アドレスを返します。 |
int |
getLocalPort()
データグラム接続と結び付けられているローカル・ポートを返します。 |
インタフェース javax.microedition.io.DatagramConnection から継承されたメソッド |
---|
getMaximumLength, getNominalLength, newDatagram, newDatagram, newDatagram, newDatagram, receive, send |
インタフェース javax.microedition.io.Connection から継承されたメソッド |
---|
close |
メソッドの詳細 |
---|
String getLocalAddress() throws IOException
データグラム接続と結び付けられているローカル・アドレスを返します。
外部のシステムからこのソケット接続の終了まで接続に使用することができるホスト・アドレス(IP アドレス)です。 IP アドレスはダイナミックに割り当てられる可能性があるため、リモート・アプリケーションは IP アドレスの再割り当てに対しての対策を持っている必要があります。
ローカルのホスト名を利用可能であるなら、System
クラスの getProperty
メソッドでシステム・プロパティ"microedition.hostname"
を読み出すことで取得できます。
IOException
- 接続がクローズしている場合に throw します。SocketConnection
int getLocalPort() throws IOException
データグラム接続と結び付けられているローカル・ポートを返します。
IOException
- 接続がクローズしている場合に throw します。SocketConnection
|
Unofficial "CLDC 1.1 + MIDP 2.0" API Reference. (日本語版) |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
公式仕様書原文の著作権表記等(※): Mobile Information Device Profile Specification ("Specification") Version: 2.0 Status: FCS Release: November 5, 2002 Copyright 2002 Sun Microsystems, Inc. and Motorola, Inc. All rights reserved. | ※ただしこの API リファレンスは英語仕様を一語一句正確に翻訳したものではなく、一度私が英語の仕様原文を読んだ上で元の意味と構造をなるべく保つように書き起こしたものです。このため一部は完全に異なる説明となっています。また CLDC 1.1 部分は同仕様の範囲外であるため、まったく参考とはしていません。 ※仕様書のライセンス上、問題は無いと考えておりますが、万が一問題があるとお考えの関係者の方がいらっしゃいましたらメールにて連絡をいただけると幸いに存じます(第一言語に日本語、第二言語に英語を希望しますが、返信は基本的に日本語で行います)。 |