ConnectorHelper.java

/*
 * This file is part of the OpenSCADA project
 * Copyright (C) 2006-2010 TH4 SYSTEMS GmbH (http://th4-systems.com)
 *
 * OpenSCADA is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License version 3
 * only, as published by the Free Software Foundation.
 *
 * OpenSCADA is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License version 3 for more details
 * (a copy is included in the LICENSE file that accompanied this code).
 *
 * You should have received a copy of the GNU Lesser General Public License
 * version 3 along with OpenSCADA. If not, see
 * <http://opensource.org/licenses/lgpl-3.0.html> for a copy of the LGPLv3 License.
 */

package org.openscada.da.client.connector;

import org.eclipse.core.runtime.IConfigurationElement;
import org.eclipse.core.runtime.Platform;
import org.openscada.core.ConnectionInformation;
import org.openscada.core.client.Connection;

/**
 * This helper class aids in finding and creating a new connection or driver adapter 
 * @author Jens Reimann
 *
 */
public class ConnectorHelper
{

    public static DriverAdapter findDriverAdapter ( final ConnectionInformation connectionInformation )
    {
        final DriverAdapterInformation dai = findDriverAdapterInformation ( connectionInformation );
        if ( dai == null )
        {
            return null;
        }
        return dai.createDriverAdapter ();
    }

    public static DriverAdapterInformation findDriverAdapterInformation ( final ConnectionInformation connectionInformation )
    {
        final IConfigurationElement[] elements = Platform.getExtensionRegistry ().getConfigurationElementsFor ( "org.openscada.da.client.connector" );

        for ( final IConfigurationElement element : elements )
        {
            final String name = element.getName ();
            if ( !"driverAdapter".equals ( name ) )
            {
                continue;
            }
            final String interfaceString = element.getAttribute ( "interface" );
            final String typeString = element.getAttribute ( "type" );

            if ( connectionInformation.getInterface ().equals ( interfaceString ) )
            {
                if ( connectionInformation.getDriver ().equals ( typeString ) )
                {
                    return new DriverAdapterInformation ( element );
                }
            }

        }
        return null;
    }

    public static Connection createConnection ( final ConnectionInformation connectionInformation )
    {
        final DriverAdapter adapter = findDriverAdapter ( connectionInformation );
        if ( adapter == null )
        {
            return null;
        }
        return adapter.createConnection ( connectionInformation );
    }
}