javax.sdp
クラス SdpFactory

java.lang.Object
  javax.sdp.SdpFactory

public class SdpFactory

extends java.lang.Object

SdpFactoryによりアプリケーションがSDPメッセージをコード化およびデコードすることが可能になります。 SdpFactoryを使って、プログラムでSessionDescriptionオブジェクトを作成することができます。 またSdpFactoryを使ってStringに基づいてSessionDescriptionを作成することもできます。 SDPの記述についてはIETF RFC2327を参照してください。

バージョン:

1.0

メソッドの概要

Attribute	createAttribute(java.lang.String name, java.lang.String value) 指定された値をもつAttributeオブジェクトを戻します。
BandWidth	createBandwidth(java.lang.String modifier, int value) 指定された値をもつBandwidthオブジェクトを戻します。
Connection	createConnection(java.lang.String addr) 指定されたアドレスを持つConnectionオブジェクトを戻します。
Connection	createConnection(java.lang.String addr, int ttl, int numAddrs) 指定されたプロパティをもち、ネットワークタイプが"IN"でアドレスタイプが "IP4"のConnectionオブジェクトを戻します。
Connection	createConnection(java.lang.String netType, java.lang.String addrType, java.lang.String addr) 指定されたプロパティをもち、TTLがなく、アドレス(1)のデフォルト番号を もつConnectionオブジェクトを戻します。
Connection	createConnection(java.lang.String netType, java.lang.String addrType, java.lang.String addr, int ttl, int numAddrs) 指定されたプロパティをもつConnectionオブジェクトを戻します。
EMail	createEMail(java.lang.String value) 指定された値をもつEMailオブジェクトを戻します。
Info	createInfo(java.lang.String value) 指定された値をもつInfoオブジェクトを戻します。
Key	createKey(java.lang.String method, java.lang.String key) 指定された値をもつKeyオブジェクトを戻します。
Media	createMedia(java.lang.String media, int port, int numPorts, java.lang.String transport, java.util.Vector staticRtpAvpTypes) 指定されたプロパティをもつMediaオブジェクトを戻します。
MediaDescription	createMediaDescription(java.lang.String media, int port, int numPorts, java.lang.String transport, int[] staticRtpAvpTypes) 指定されたプロパティをもつMediaDesciptionオブジェクトを戻します。
MediaDescription	createMediaDescription(java.lang.String media, int port, int numPorts, java.lang.String transport, java.lang.String[] formats) 指定されたプロパティをもつMediaDesciptionオブジェクトを戻します。
Origin	createOrigin(java.lang.String userName, long sessionId, long sessionVersion, java.lang.String networkType, java.lang.String addrType, java.lang.String address) 指定されたプロパティをもつOriginオブジェクトを戻します。
Origin	createOrigin(java.lang.String userName, java.lang.String address) 指定されたプロパティをもつOriginオブジェクトを戻します。
Phone	createPhone(java.lang.String value) 指定された値をもつPhoneオブジェクトを戻します。
RepeatTime	createRepeatTime(int repeatInterval, int activeDuration, int[] offsets) 指定された間隔、期間、時間オフセットをもつRepeatTimeオブジェクトを戻します。
SessionDescription	createSessionDescription() 新しい空のSessionDescriptionを作成します。
SessionDescription	createSessionDescription(SessionDescription otherSessionDescription) 新しいSessionDescription、別のSessionDescriptioのディープコピーを作成します。
SessionDescription	createSessionDescription(java.lang.String s) 文字列パラメータ内に含まれる情報を読み込んだSessionDescriptionを作成します。
SessionName	createSessionName(java.lang.String name) 指定された名前をもつSessionNameオブジェクトを戻します。
Time	createTime() 制限のないTime指定を戻します。
Time	createTime(java.util.Date start, java.util.Date stop) 指定された開始および停止時間のTime指定を戻します。
TimeDescription	createTimeDescription() 制限のない TimeDescription を戻します。
TimeDescription	createTimeDescription(java.util.Date start, java.util.Date stop) 指定されたプロパティを持つ TimeDescription オブジェクトを戻します。
TimeDescription	createTimeDescription(Time t) 指定されたプロパティを持つ TimeDescription オブジェクトを戻します。
TimeZoneAdjustment	createTimeZoneAdjustment(java.util.Date d, int offset) タイムゾーン調整レコードを作成します。
URI	createURI(java.net.URL value) 指定された値を持つURIオブジェクトを戻します。
Version	createVersion(int value) 指定された値をもつVersionオブジェクトを戻します。
java.lang.String	formatMulticastAddress(java.lang.String addr, int ttl, int numAddrs) マルチコネクションアドレスに対して算出されたフォームを含むStringを戻します。
static java.util.Date	getDateFromNtp(long ntpTime) 指定されたNTP日付値に対するDateオブジェクトを戻します。
static SdpFactory	getInstance() SdpFactoryのインスタンスを獲得します。
static long	getNtpTime(java.util.Date d) 指定されたJavaDateに対するNTP値を含むlongを戻します。

クラス java.lang.Object から継承したメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

getInstance

public static SdpFactory getInstance()

SdpFactoryのインスタンスを獲得します。 この静的メソッドは、ファクトリインスタンスを戻します。 一度アプリケーションがSdpFactoryの参照を獲得すると、 ファクトリを使って、parserインスタンスを設定および獲得でき、 またSDPオブジェクトを作成することができます。

戻り値:

ファクトリインスタンス

createSessionDescription

public SessionDescription createSessionDescription()
                                            throws SdpException

新しい空のSessionDescriptionを作成します。 セッションは以下のように設定されます。: v=0 o=this.createOrigin ("user", InetAddress.getLocalHost().toString()); s=- t=0 0

戻り値:

新しい空のSessionDescription

例外:

SdpException - SdpException, - SessionDescriptionの作成に問題がある場合。

createSessionDescription

public SessionDescription createSessionDescription(SessionDescription otherSessionDescription)
                                            throws SdpException

新しいSessionDescription、別のSessionDescriptioのディープコピーを作成します。

パラメータ:

otherSessionDescription - - コピーするSessionDescription

戻り値:

新しいSessionDescription、別のSessionDescriptioそのままのディープコピー

例外:

SdpException - - SessionDescriptionの作成に問題がある場合。

createSessionDescription

public SessionDescription createSessionDescription(java.lang.String s)
                                            throws SdpParseException

文字列パラメータ内に含まれる情報を読み込んだSessionDescriptionを作成します。 注意：未知のフィールドタイプがエクセプションの原因となってはなりません。

パラメータ:

s - - 解析されるsdpメッセージ

戻り値:

データを読み込んだSessionDescriptionオブジェクト

例外:

SdpParseException - SdpParseException - Stringの解析に問題がある場合

createBandwidth

public BandWidth createBandwidth(java.lang.String modifier,
                                 int value)

指定された値をもつBandwidthオブジェクトを戻します。

パラメータ:

modifier - - bandwidthタイプ

value - キロビット／秒で測った帯域幅値

戻り値:

bandwidth

createAttribute

public Attribute createAttribute(java.lang.String name,
                                 java.lang.String value)

指定された値をもつAttributeオブジェクトを戻します。

パラメータ:

name - 属性の名前

value - 属性の値

戻り値:

属性

createInfo

public Info createInfo(java.lang.String value)

指定された値をもつInfoオブジェクトを戻します。

パラメータ:

value - 記述を含む文字列

戻り値:

Info

createPhone

public Phone createPhone(java.lang.String value)

指定された値をもつPhoneオブジェクトを戻します。

パラメータ:

value - 記述を含む文字列

戻り値:

Phone

createEMail

public EMail createEMail(java.lang.String value)

指定された値をもつEMailオブジェクトを戻します。

パラメータ:

value - 記述を含む文字列

戻り値:

EMail

createURI

public URI createURI(java.net.URL value)
              throws SdpException

指定された値を持つURIオブジェクトを戻します。

パラメータ:

value - 記述を含むURL

戻り値:

URI

例外:

SdpException

createSessionName

public SessionName createSessionName(java.lang.String name)

指定された名前をもつSessionNameオブジェクトを戻します。

パラメータ:

name - セッションの名前を含む文字列

戻り値:

SessionName

createKey

public Key createKey(java.lang.String method,
                     java.lang.String key)

指定された値をもつKeyオブジェクトを戻します。

パラメータ:

method - メソッドタイプを含む文字列

key - 設定するキー

戻り値:

Key

createVersion

public Version createVersion(int value)

指定された値をもつVersionオブジェクトを戻します。

パラメータ:

value - バージョン番号

戻り値:

Version

createMedia

public Media createMedia(java.lang.String media,
                         int port,
                         int numPorts,
                         java.lang.String transport,
                         java.util.Vector staticRtpAvpTypes)
                  throws SdpException

指定されたプロパティをもつMediaオブジェクトを戻します。

パラメータ:

media - メディアタイプ　例）オーディオ

port - メディアを受け取るポート番号

numPorts - このメディアストリームに使用されるポート数

transport - 伝送タイプ　例）RTP／AVP

staticRtpAvpTypes - 設定するvector

戻り値:

Media

例外:

SdpException

createOrigin

public Origin createOrigin(java.lang.String userName,
                           java.lang.String address)
                    throws SdpException

指定されたプロパティをもつOriginオブジェクトを戻します。

パラメータ:

userName - ユーザ名

address - IP4コード化アドレス

戻り値:

Origin

例外:

SdpException - パラメータがnullの場合

createOrigin

public Origin createOrigin(java.lang.String userName,
                           long sessionId,
                           long sessionVersion,
                           java.lang.String networkType,
                           java.lang.String addrType,
                           java.lang.String address)
                    throws SdpException

指定されたプロパティをもつOriginオブジェクトを戻します。

パラメータ:

userName - 文字列を作成したユーザを含む文字列

sessionId - セッション識別子を含むlong

sessionVersion - セッションバージョンを含むlong

networkType - Originに対する文字列ネットワークタイプ（通常はIN）

addrType - 文字列アドレスタイプ（通常はIP4）

address - 文字列IPアドレス　通常はホストのアドレス

戻り値:

指定されたプロパティをもつOriginオブジェクト

例外:

SdpException - パラメータがnullの場合

createMediaDescription

public MediaDescription createMediaDescription(java.lang.String media,
                                               int port,
                                               int numPorts,
                                               java.lang.String transport,
                                               int[] staticRtpAvpTypes)
                                        throws java.lang.IllegalArgumentException,
                                               SdpException

指定されたプロパティをもつMediaDesciptionオブジェクトを戻します。 戻されたオブジェクトは、メディアフォーマットのVectorで Media.getMediaFormats(boolean)に応答します。

パラメータ:

media - media -

port - メディアを受け取るポート番号

numPorts - このメディアストリームに使用されるポート数

transport - 伝送タイプ　例）RTP／AVP

staticRtpAvpTypes - 戻されたMediaDescriptionによって指定されるべき 静的なRTP／AVPメディアペイロードタイプのリスト

戻り値:

MediaDescription

例外:

java.lang.IllegalArgumentException - 無効なRTP/AVPペイロードタイプの場合

SdpException

createMediaDescription

public MediaDescription createMediaDescription(java.lang.String media,
                                               int port,
                                               int numPorts,
                                               java.lang.String transport,
                                               java.lang.String[] formats)

指定されたプロパティをもつMediaDesciptionオブジェクトを戻します。 戻されたオブジェクトは、'formats 引数によって指定された StringオブジェクトのVectorで Media.getMediaFormats(boolean)に応答します。

パラメータ:

media - メディアタイプ　例）オーディオ

port - メディアを受け取るポート番号

numPorts - このメディアストリームに使用されるポート数

transport - 伝送タイプ　例）RTP／AVP

formats - 戻されたMediaDescriptionによって指定されるべきフォーマットのリスト

戻り値:

MediaDescription

createTimeDescription

public TimeDescription createTimeDescription(Time t)
                                      throws SdpException

指定されたプロパティを持つ TimeDescription オブジェクトを戻します。

パラメータ:

t - 時間記述が適用されるTime。指定されたプロパティを持つ TimeDescription オブジェクトを戻します。

戻り値:

TimeDescription

例外:

SdpException

createTimeDescription

public TimeDescription createTimeDescription()
                                      throws SdpException

制限のない TimeDescription を戻します。 (i.e. "t=0 0");

戻り値:

制限のない TimeDescription（すなわち"t=0 0"）

例外:

SdpException

createTimeDescription

public TimeDescription createTimeDescription(java.util.Date start,
                                             java.util.Date stop)
                                      throws SdpException

指定されたプロパティを持つ TimeDescription オブジェクトを戻します。

パラメータ:

start - start time.

stop - stop time.

戻り値:

TimeDescription

例外:

SdpException - パラメータがnullの場合

formatMulticastAddress

public java.lang.String formatMulticastAddress(java.lang.String addr,
                                               int ttl,
                                               int numAddrs)

マルチコネクションアドレスに対して算出されたフォームを含むStringを戻します。

パラメータ:

addr - コネクションアドレス

ttl - マルチキャストアドレスに対する有効期間（TTL)

numAddrs - コネクションが使用するアドレス数

戻り値:

マルチコネクションアドレスに対して算出されたフォームを含むString

createConnection

public Connection createConnection(java.lang.String netType,
                                   java.lang.String addrType,
                                   java.lang.String addr,
                                   int ttl,
                                   int numAddrs)
                            throws SdpException

指定されたプロパティをもつConnectionオブジェクトを戻します。

パラメータ:

netType - ネットワークタイプ　例）インターネットには"IN"

addrType - アドレスタイプ　例）IPv4タイプアドレスには"IP4"

addr - コネクションアドレス

ttl - マルチキャストアドレスに対する有効期間（TTL)

numAddrs - コネクションが使用するアドレス数

戻り値:

Connection

例外:

SdpException

createConnection

public Connection createConnection(java.lang.String netType,
                                   java.lang.String addrType,
                                   java.lang.String addr)
                            throws SdpException

指定されたプロパティをもち、TTLがなく、アドレス(1)のデフォルト番号を もつConnectionオブジェクトを戻します。

パラメータ:

netType - ネットワークタイプ　例）インターネットには"IN"

addrType - アドレスタイプ　例）IPv4タイプアドレスには"IP4"

addr - コネクションアドレス

戻り値:

Connection

例外:

SdpException - パラメータがnullの場合

createConnection

public Connection createConnection(java.lang.String addr,
                                   int ttl,
                                   int numAddrs)
                            throws SdpException

指定されたプロパティをもち、ネットワークタイプが"IN"でアドレスタイプが "IP4"のConnectionオブジェクトを戻します。

パラメータ:

addr - コネクションアドレス

ttl - マルチキャストアドレスに対する有効期間（TTL)

numAddrs - コネクションが使用するアドレス数

戻り値:

Connection

例外:

SdpException

createConnection

public Connection createConnection(java.lang.String addr)
                            throws SdpException

指定されたアドレスを持つConnectionオブジェクトを戻します。 これは、createConnectionに等しい("IN", "IP4", addr)。

パラメータ:

addr - コネクションアドレス

戻り値:

Connection

例外:

SdpException - パラメータがnullの場合

createTime

public Time createTime(java.util.Date start,
                       java.util.Date stop)
                throws SdpException

指定された開始および停止時間のTime指定を戻します。

パラメータ:

start - 開始時間

stop - 停止時間

戻り値:

指定された開始および停止時間のTime指定

例外:

SdpException - パラメータがnullの場合

createTime

public Time createTime()
                throws SdpException

制限のないTime指定を戻します。（すなわちt=0 0)

戻り値:

制限のないTime指定を戻します。（すなわちt=0 0)

例外:

SdpException

createRepeatTime

public RepeatTime createRepeatTime(int repeatInterval,
                                   int activeDuration,
                                   int[] offsets)

指定された間隔、期間、時間オフセットをもつRepeatTimeオブジェクトを戻します。

パラメータ:

repeatInterval - リピート間隔（秒数）

activeDuration - アクティブ期間（秒数）

offsets - 戻されたRepeaTimeが関連づけられるTimeオブジェクトの開始時間 を基準とするオフセットのリスト

戻り値:

RepeatTime

createTimeZoneAdjustment

public TimeZoneAdjustment createTimeZoneAdjustment(java.util.Date d,
                                                   int offset)

タイムゾーン調整レコードを作成します。

パラメータ:

d - 調整が行われるDate

offset - このオブジェクトが関連付けられているSessionDescriptionの 開始時間を基準とする調整（秒数）

戻り値:

TimeZoneAdjustment

getDateFromNtp

public static java.util.Date getDateFromNtp(long ntpTime)

指定されたNTP日付値に対するDateオブジェクトを戻します。

パラメータ:

ntpTime - 設定するlong

戻り値:

指定されたNTP日付値に対するDateオブジェクト

getNtpTime

public static long getNtpTime(java.util.Date d)
                       throws SdpParseException

指定されたJavaDateに対するNTP値を含むlongを戻します。

パラメータ:

d - Date to set

戻り値:

long

例外:

SdpParseException