javauis/mmapi_qt/baseline/javasrc/com/nokia/microedition/media/protocol/ProtocolFactory.java
/*
* Copyright (c) 2005 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:
*
*/
package com.nokia.microedition.media.protocol;
import com.nokia.microedition.media.InternalPlayer;
import com.nokia.microedition.media.Locator;
import javax.microedition.media.MediaException;
/**
* Factory for creating the Protocols
*/
public class ProtocolFactory
{
private Protocol iConnectorProtocol = null;
public static final String PROTOCOL_CLASS_NAME = ".Protocol";
public static final String PROTOCOL_BASE_PACKAGE =
"com.nokia.microedition.media.protocol.";
/**
* Constructor
*/
public ProtocolFactory()
{
iConnectorProtocol = new ConnectorProtocol();
}
/**
* Factory method for creating player from locator
* Tries to load assosiated <code>Protocol</code> first, if this fails
* then we try to create player by using <code>Connector</code>
* @param aLocator Media locator
* @return Player according to locator or null if cannot create
*/
public InternalPlayer createPlayer(Locator aLocator)
throws java.io.IOException,
MediaException,
java.lang.SecurityException
{
InternalPlayer player = null;
try
{
Class protocolClass =
Class.forName(PROTOCOL_BASE_PACKAGE +
aLocator.getProtocol() + PROTOCOL_CLASS_NAME);
Protocol protocol = (Protocol)protocolClass.newInstance();
player = protocol.createPlayer(aLocator);
}
catch (InstantiationException ie)
{
throw new MediaException("Instantiation failed: " + ie);
}
catch (IllegalAccessException iae)
{
throw new MediaException("Illegal access: " + iae);
}
catch (ClassNotFoundException cnfe)
{
// we did not find specified Protocol, trying to create player
// with connector
player = iConnectorProtocol.createPlayer(aLocator);
}
return player;
}
}