001/*
002 * HA-JDBC: High-Availability JDBC
003 * Copyright (c) 2004-2008 Paul Ferraro
004 * 
005 * This library is free software; you can redistribute it and/or modify it 
006 * under the terms of the GNU Lesser General Public License as published by the 
007 * Free Software Foundation; either version 2.1 of the License, or (at your 
008 * option) any later version.
009 * 
010 * This library is distributed in the hope that it will be useful, but WITHOUT
011 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 
012 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License 
013 * for more details.
014 * 
015 * You should have received a copy of the GNU Lesser General Public License
016 * along with this library; if not, write to the Free Software Foundation, 
017 * Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
018 * 
019 * Contact: ferraro@users.sourceforge.net
020 */
021package net.sf.hajdbc.sql;
022
023import javax.naming.Reference;
024import javax.naming.StringRefAddr;
025import javax.naming.spi.ObjectFactory;
026
027/**
028 * @author Paul Ferraro
029 * @param <D> 
030 */
031public abstract class CommonDataSourceReference<D> extends Reference
032{
033        private static final long serialVersionUID = 1408239702660701511L;
034        
035        protected static final String CLUSTER = "cluster"; //$NON-NLS-1$
036        protected static final String CONFIG = "config"; //$NON-NLS-1$
037        
038        /**
039         * Constructs a reference for a DataSource implementation.
040         * @param targetClass the target class of the DataSource.
041         * @param factoryClass the ObjectFactory class for creating a DataSource
042         * @param cluster a cluster identifier
043         * @param config the uri of the configuration file
044         */
045        protected CommonDataSourceReference(Class<D> targetClass, Class<? extends ObjectFactory> factoryClass, String cluster, String config)
046        {
047                super(targetClass.getName(), factoryClass.getName(), null);
048                
049                if (cluster == null)
050                {
051                        throw new IllegalArgumentException();
052                }
053                
054                this.add(new StringRefAddr(CLUSTER, cluster));
055                
056                if (config != null)
057                {
058                        this.add(new StringRefAddr(CONFIG, config));
059                }
060        }
061}