org.dvb.tvanytime.metadata.ip
Class BCGDiscovery

java.lang.Object
  extended by org.dvb.tvanytime.metadata.ip.BCGDiscovery

public abstract class BCGDiscovery
extends java.lang.Object

Class providing access to Broadband Content Guides whose location is signalled by IP-based Service Discovery & Selection information.


Constructor Summary
BCGDiscovery()
          This constructor is provided for implementations and should not be used by GEM applications.
 
Method Summary
static Database[] getAvailableDatabases(CRID crid)
          Get an array of Databases that can provide metadata for the specified CRID Authority.
static Database[] getAvailableDatabases(javax.tv.locator.Locator locator)
          Get an array of Databases that can provide metadata for the specified service.
static Database[] getAvailableDatabases(java.lang.String serviceProviderDomainName)
          Get an array of Databases that can provide metadata for the specified service provider.
static Database[] getAvailableDatabasesByProvider(java.lang.String BCGProviderName)
          Get an array of Databases from the specified BCG provider.
static Database getDatabase()
          Get an instance of a Broadband Content Guide where the platform chooses the host.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

BCGDiscovery

public BCGDiscovery()
This constructor is provided for implementations and should not be used by GEM applications.

Method Detail

getAvailableDatabases

public static Database[] getAvailableDatabases(CRID crid)
                                        throws DatabaseException
Get an array of Databases that can provide metadata for the specified CRID Authority.

Parameters:
crid - the authority field from the supplied CRID is used to decide which metadata servers to return. The CRID authority should be matched against Metadata Pointer Descriptors in Resolution Provider Notification Tables delivered by IP-based Service Discovery & Selection information or in a DVB service.
Returns:
an array of type Database. Each object in the returned array will be an instance of either MulticastDatabase, HTTPDatabase or IPDatabase.
Throws:
DatabaseException - if no metadata services can be found for the specified scope

getAvailableDatabases

public static Database[] getAvailableDatabases(java.lang.String serviceProviderDomainName)
                                        throws DatabaseException
Get an array of Databases that can provide metadata for the specified service provider.

Parameters:
serviceProviderDomainName - a String representing the domain name of a service provider. This should be matched against the TargetProvider fields in Broadband Content Guide Discovery Records delivered by IP-based Service Discovery & Selection information.
Returns:
an array of type Database. Each object in the returned array will be an instance of either MulticastDatabase, HTTPDatabase or IPDatabase.
Throws:
DatabaseException - if no metadata services can be found for the specified scope

getAvailableDatabasesByProvider

public static Database[] getAvailableDatabasesByProvider(java.lang.String BCGProviderName)
                                                  throws DatabaseException
Get an array of Databases from the specified BCG provider.

Parameters:
BCGProviderName - a String representing the domain name of the BCG provider. This should be matched against the BCGProviderName in Broadband Content Guide Discovery Records delivered by IP-based Service Discovery & Selection information.
Returns:
an array of type Database. Each object in the returned array will be an instance of either MulticastDatabase, HTTPDatabase or IPDatabase.
Throws:
DatabaseException - if no metadata services can be found for the specified scope

getAvailableDatabases

public static Database[] getAvailableDatabases(javax.tv.locator.Locator locator)
                                        throws DatabaseException
Get an array of Databases that can provide metadata for the specified service.

Parameters:
locator - a locator representing a service. This should be matched against entries in IP-based Service Discovery & Selection information to find Broadband Content Guides identified by ServiceDescriptionLocation and ServicesDescriptionLocation fields.
Returns:
an array of type Database. Each object in the returned array will be an instance of either MulticastDatabase, HTTPDatabase or IPDatabase.
Throws:
DatabaseException - if no metadata services can be found for the specified scope

getDatabase

public static Database getDatabase()
                            throws DatabaseException
Get an instance of a Broadband Content Guide where the platform chooses the host.

Returns:
a Database
Throws:
DatabaseException - if a metadata service cannot be found