org.zoolu.sdp
Class MediaDescriptor

java.lang.Object
  |
  +--org.zoolu.sdp.MediaDescriptor

public class MediaDescriptor

extends java.lang.Object

Class MediaDescriptor handles SDP media descpriptions.

A MediaDescriptor can be part of a SessionDescriptor, and contains details that apply onto to a single media stream.

A single SessionDescriptor may convey zero or more MediaDescriptors.

In the current implementation, the MediaDescriptor consists of the m (media) and c (connection information) fields, followed by zero or more a (attribute) fields. The m field is mandatory for a MediaDescriptor.

Constructor Summary

MediaDescriptor(MediaDescriptor md)
Creates a new MediaDescriptor.

MediaDescriptor(MediaField media, ConnectionField connection)
Creates a new MediaDescriptor with m media and c connection.

MediaDescriptor(MediaField media, ConnectionField connection, AttributeField attribute)
Creates a new MediaDescriptor with m media, c connection, and a attribute.

MediaDescriptor(MediaField media, ConnectionField connection, java.util.Vector attributes)
Creates a new MediaDescriptor with m=media and c=connection, with attributes 'a' equals to attributes (Vector of AttributeField).

MediaDescriptor(java.lang.String media, java.lang.String connection, java.lang.String attribute)
Creates a new MediaDescriptor with m media, c connection, and a attribute.

Method Summary

MediaDescriptor	addAttribute(AttributeField attribute) Adds a new attribute
AttributeField	getAttribute(java.lang.String a_name) Gets a particular attribute
java.util.Vector	getAttributes() Gets a Vector of attribute values.
java.util.Vector	getAttributes(java.lang.String a_name) Gets a Vector of attribute values of a particular attribute name.
ConnectionField	getConnection() Gets connection information.
MediaField	getMedia() Gets media.
boolean	hasAttribute(java.lang.String a_name) Whether it has a particular attribute
java.lang.String	toString() Gets a String rapresentation of the MediaDescriptor.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

MediaDescriptor

public MediaDescriptor(MediaDescriptor md)

Creates a new MediaDescriptor.

Parameters:

md - the cloned MediaDescriptor

MediaDescriptor

public MediaDescriptor(MediaField media,
                       ConnectionField connection)

Creates a new MediaDescriptor with m media and c connection. No attribute is set by default.

Parameters:

media - the MediaField

connection - the ConnectionField, or null if no ConnectionField is present in the MediaDescriptor

MediaDescriptor

public MediaDescriptor(MediaField media,
                       ConnectionField connection,
                       AttributeField attribute)

Creates a new MediaDescriptor with m media, c connection, and a attribute.

Parameters:

media - the MediaField

connection - the ConnectionField, or null if no ConnectionField is present in the MediaDescriptor

attribute - the first AttributeField

MediaDescriptor

public MediaDescriptor(MediaField media,
                       ConnectionField connection,
                       java.util.Vector attributes)

Creates a new MediaDescriptor with m=media and c=connection, with attributes 'a' equals to attributes (Vector of AttributeField).

Parameters:

media - the MediaField

connection - the ConnectionField, or null if no ConnectionField is present in the MediaDescriptor

attributes - the Vector of AttributeField

MediaDescriptor

public MediaDescriptor(java.lang.String media,
                       java.lang.String connection,
                       java.lang.String attribute)

Creates a new MediaDescriptor with m media, c connection, and a attribute.

Parameters:

media - the media field vaule

connection - the connection field vaule, or null if no connection field is present in the MediaDescriptor

attribute - the first media attribute alue

Method Detail

getMedia

public MediaField getMedia()

Gets media.

Returns:

the MediaField

getConnection

public ConnectionField getConnection()

Gets connection information.

Returns:

the ConnectionField

getAttributes

public java.util.Vector getAttributes()

Gets a Vector of attribute values.

Returns:

a Vector of AttributeField

addAttribute

public MediaDescriptor addAttribute(AttributeField attribute)

Adds a new attribute

Parameters:

attribute - the new AttributeField

Returns:

this MediaDescriptor

hasAttribute

public boolean hasAttribute(java.lang.String a_name)

Whether it has a particular attribute

Parameters:

a_name - the attribute name

Returns:

true if found, otherwise returns null

getAttribute

public AttributeField getAttribute(java.lang.String a_name)

Gets a particular attribute

Parameters:

a_name - the attribute name

Returns:

the AttributeField, or null if not found

getAttributes

public java.util.Vector getAttributes(java.lang.String a_name)

Gets a Vector of attribute values of a particular attribute name.

Parameters:

a_name - the attribute name

Returns:

a Vector of AttributeFields

toString

public java.lang.String toString()

Gets a String rapresentation of the MediaDescriptor.

Overrides:

toString in class java.lang.Object

Returns:

the string representation