head	1.9;
access;
symbols
	TIGRIS_0_9_2_4:1.2
	TIGRIS_0_9_2_3:1.2
	HELM_PEER_PORT_BRANCH:1.8.0.2
	TURBINE_PEER:1.8
	TIGRIS_0_9_2_1:1.8
	TIGRIS_0_9_2:1.2.0.2;
locks; strict;
comment	@# @;


1.9
date	2001.02.21.03.23.56;	author edk;	state dead;
branches;
next	1.8;

1.8
date	2001.01.26.18.29.00;	author edk;	state Exp;
branches
	1.8.2.1;
next	1.7;

1.7
date	2001.01.26.05.24.05;	author edk;	state dead;
branches;
next	1.6;

1.6
date	2001.01.25.04.43.25;	author stack;	state Exp;
branches;
next	1.5;

1.5
date	2001.01.24.22.24.36;	author leonardr;	state Exp;
branches;
next	1.4;

1.4
date	2001.01.24.20.42.46;	author dlr;	state Exp;
branches;
next	1.3;

1.3
date	2001.01.23.19.55.03;	author leonardr;	state Exp;
branches;
next	1.2;

1.2
date	2001.01.17.01.01.39;	author leonardr;	state Exp;
branches;
next	1.1;

1.1
date	2001.01.16.19.36.48;	author leonardr;	state Exp;
branches;
next	;

1.8.2.1
date	2001.01.28.01.02.17;	author dlr;	state dead;
branches;
next	;


desc
@@


1.9
log
@delete stuff from the head which is obsolete in the branch (more changes
are still needed for a clean compile)
@
text
@/* ================================================================
 * Copyright (c) 2000 CollabNet.  All rights reserved.
 * 
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are
 * met:
 * 
 * 1. Redistributions of source code must retain the above copyright
 * notice, this list of conditions and the following disclaimer.
 * 
 * 2. Redistributions in binary form must reproduce the above copyright
 * notice, this list of conditions and the following disclaimer in the
 * documentation and/or other materials provided with the distribution.
 * 
 * 3. The end-user documentation included with the redistribution, if
 * any, must include the following acknowlegement: "This product includes
 * software developed by CollabNet (http://www.collab.net/)."
 * Alternately, this acknowlegement may appear in the software itself, if
 * and wherever such third-party acknowlegements normally appear.
 * 
 * 4. The hosted project names must not be used to endorse or promote
 * products derived from this software without prior written
 * permission. For written permission, please contact info@@collab.net.
 * 
 * 5. Products derived from this software may not use the "Tigris" name
 * nor may "Tigris" appear in their names without prior written
 * permission of CollabNet.
 * 
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL COLLABNET OR ITS CONTRIBUTORS BE LIABLE FOR ANY
 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
 * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * ====================================================================
 * 
 * This software consists of voluntary contributions made by many
 * individuals on behalf of CollabNet.
 */
package org.tigris.helm.database;

import java.util.*;
import java.sql.*;

import org.apache.turbine.services.db.TurbineDB;
import org.apache.turbine.util.db.pool.DBConnection;

import org.webmacro.util.*;
import org.webmacro.servlet.*;

import com.workingdogs.village.*;

import org.joist.database.*;
import org.joist.util.*;

import org.tigris.helm.DoesNotExist;

/**
 * Manages the skin-style-element-value join table. 
 *
 * @@author <a href="mailto:leonardr@@collab.net">Leonard Richardson</a>
 * @@version $Id: StyleElementManager.java,v 1.8 2001/01/26 18:29:00 edk Exp $
 *
 * Copyright (c) 2001 CollabNet, Inc.  
 */

public class StyleElementManager extends TableManager
{
    /**
     * The name of the database table that this <code>TableManager</code> 
     * manages.
     */
    public static String TABLE_NAME = "HELM_STYLEELEMENT";

    /**
     * The ID of the style element this entry is describing.
     */
    public static String ELEMENT_ID = "ELEMENT_ID";

    /**
     * Associated HTML tag (eg. "td", "font").
     */
    public static String ASSOCIATED_HTML_TAG = "ASSOCIATED_HTML_TAG";

    /**
     * Name used in HTML code to associate a value with this style.
     */
    public static String HTML_NAME = "HTML_NAME";

    /**
     * Name used in CSS to associate a value with this style.
     */
    public static String CSS_NAME = "CSS_NAME";

    /**
     * Human-readable description of this element.
     */
    public static String DESCRIPTION = "DESCRIPTION";

    /**
     * The logger instance for all instances of this class.
     */
    private static Log log = new Log("stElMgr", "StyleElementManager");

    /**
     * Whether we want debugging information.
     */
    private static boolean debug = true;

    /**
     * Creates a new instance.
     *
     * @@param dataMgr The manager of this instance.
     */
    public StyleElementManager(DataManager dataMgr)
    {
        super(dataMgr);
    }

    /**
     * Get a style element by ID.
     *
     * @@param	connection    A JDBC database connection
     * @@param   id            ID of the style to retrieve
     * @@return	 a Record
     * @@exception	SQLException
     * @@exception	DataSetException
     */
    public Record getStyleElement(Connection connection, String id)
        throws SQLException, DataSetException, DoesNotExist
    {        
        Criterion c = new Criterion(ELEMENT_ID, id);
        DataSet elements = getElements(connection, c);
        if (elements.size() <= 0)
        {
            throw new DoesNotExist("Element with ID " + id);
        }
        return elements.getRecord(0);
    }

    /**
     * Get style elements matching a given Criterion object.
     *
     * @@param	connection    A JDBC database connection
     * @@param	criterion     A Criterion specifying which styles to get.
     * @@return	 a DataSet
     * @@exception	SQLException
     * @@exception	DataSetException
     */
    public DataSet getElements(Connection connection, Criterion criterion)
        throws SQLException, DataSetException
    {
        try
        {
            return runSelect(TABLE_NAME, criterion);
        }
        catch (Exception e)
        {
            log.exception(e);
            throw new SQLException("unable to getElements: " + e.getMessage());
        }
    }
}
@


1.8
log
@readding all the files as part of the process of returning to the way
things were as of tuesday
@
text
@d68 1
a68 1
 * @@version $Id: StyleElementManager.java,v 1.3 2001/01/23 19:55:03 leonardr Exp $
@


1.8.2.1
log
@Porting to the Turbine Peer system.  -dlr and leonardr
@
text
@d68 1
a68 1
 * @@version $Id: StyleElementManager.java,v 1.8 2001/01/26 18:29:00 edk Exp $
@


1.7
log
@revert this stuff to its state as of 2001/01/24 12:42:00 GMT -- with
the following exceptions, which have some different modifications so
they'll work with changes which have happened in joist:

ProjectNewsEdit.java
SkinManager.java
SkinStyleElementValueManager.java
StyleElementManager.java
StyleManager.java

it compiles.  i dunno if it works, though.
@
text
@d68 1
a68 1
 * @@version $Id: StyleElementManager.java,v 1.6 2001/01/25 04:43:25 stack Exp $
d123 1
a123 1
        super(dataMgr, new KeyDef().addAttrib(ELEMENT_ID));
d132 2
a133 2
     *
     * @@exception DBException
d136 1
a136 1
        throws DoesNotExist, DBException
a137 1
        Record record = null;
a139 1
        
d144 1
a144 11

        try
        {
            record = elements.getRecord(0);
        }
        catch( DataSetException dse )
        {
            throw new DBException( dse );
        }

        return record;
d153 2
a154 2
     *
     * @@exception DBException
d157 1
a157 1
        throws DBException
a158 2
        DataSet dataSet = null;

d161 1
a161 1
            dataSet = runSelect(TABLE_NAME, criterion);
d163 1
a163 2

        catch( Exception e )
d165 2
a166 1
            throw new DBException( e );
a167 2

        return dataSet;
@


1.6
log
@Converting to DBException
@
text
@d68 1
a68 1
 * @@version $Id: StyleElementManager.java,v 1.5 2001/01/24 22:24:36 leonardr Exp $
@


1.5
log
@Moved TableManagers to new keydef constructor and keydef-less runSelect.
@
text
@d68 1
a68 1
 * @@version $Id: StyleElementManager.java,v 1.4 2001/01/24 20:42:46 dlr Exp $
d138 1
d141 1
d146 11
a156 1
        return elements.getRecord(0);
d171 13
a183 1
        return runSelect(TABLE_NAME, criterion);
@


1.4
log
@Making use of DBException.
@
text
@d68 1
a68 1
 * @@version $Id: StyleElementManager.java,v 1.3 2001/01/23 19:55:03 leonardr Exp $
d123 1
a123 1
        super(dataMgr);
d159 1
a159 1
        return runSelect(connection, TABLE_NAME, criterion);
@


1.3
log
@Skin patch enabling skin data to be used directly in templates.
@
text
@d68 1
a68 1
 * @@version $Id: StyleElementManager.java,v 1.2 2001/01/17 01:01:39 leonardr Exp $
d132 2
a133 2
     * @@exception	SQLException
     * @@exception	DataSetException
d136 1
a136 1
        throws SQLException, DataSetException, DoesNotExist
d153 2
a154 2
     * @@exception	SQLException
     * @@exception	DataSetException
d157 1
a157 1
        throws SQLException, DataSetException
@


1.2
log
@Another big batch of skin changes.
@
text
@d68 1
a68 1
 * @@version $Id: StyleElementManager.java,v 1.1 2001/01/16 19:36:48 leonardr Exp $
d85 5
@


1.1
log
@More code written for skins and styles.
@
text
@d65 1
a65 1
 * Manages the skin-style-element-value join table.
d68 1
a68 1
 * @@version $Id: StyleElementManager.java,v 1.1 2001/01/16 02:33:02 leonardr Exp $
d79 1
a79 1
    public static String TABLE_NAME = "HELM_SKIN_STYLE_ELEMENT_VALUE";
d82 1
a82 1
     * The ID of the skin this entry is describing.
d84 1
a84 1
    public static String SKIN_ID = "SKIN_ID";
d87 1
a87 1
     * The ID of the style of the skin this entry is describing.
d89 1
a89 1
    public static String STYLE_ID = "STYLE_ID";
d92 1
a92 1
     * Human-readable element of this entry.
d94 1
a94 1
    public static String ELEMENT = "ELEMENT";
d97 1
a97 1
     * Human-readable value of this entry's element.
d99 1
a99 1
    public static String VALUE = "VALUE";
d119 1
a119 1
    }    
d122 1
a122 1
     * Get a particular style by skin ID and style ID.
d125 1
a125 2
     * @@param   skin          Name of the style to retrieve.
     * @@param   style         Name of the style to retrieve.
d130 2
a131 3
    public DataSet getElementsForSkinStyle(Connection connection, String skinID,
                                          String styleID)
        throws SQLException, DataSetException
d133 1
a133 2
        Criterion c = new Criterion(SKIN_ID, skinID);
        c.and(new Criterion(STYLE_ID, styleID));
d135 5
a139 1
        return elements;
@

