bradleyross.j2ee.servlets

Class PulldownList

java.lang.Object

bradleyross.j2ee.servlets.PulldownList

public abstract class PulldownList
extends Object

Generate the code for a pull-down list to be placed in a web page.

Author:

Bradley Ross

Field Summary

Fields

Modifier and Type	Field and Description
protected DatabaseProperties	data Object containing database connection properties.

Constructor Summary

Constructors

Constructor and Description
PulldownList()

Method Summary

Modifier and Type	Method and Description
protected ResultSet	buildResultSet() Creates result set that is used to generate select tag.
protected abstract ResultSet	buildResultSet(String selector) Creates result set that is used to generate select tag.
protected String	getText(ResultSet rs, String selector) Determine text value for the option
protected String	getValue(ResultSet rs, String selector) Determine the value for option
protected String	initialOption() Used to generate initial option in select tag.
String	multipleRequest(String name) Generate the HTML code for a SELECT tag that allows multiple values to be selected.
String	multipleRequest(String name, String[] values) Generate the HTML code for a SELECT tag that allows multiple values to be selected.
String	multipleRequest(String name, String[] values, String selector, String attributes) Generate the HTML code for a SELECT tag that allows multiple values to be selected.
String	singleRequest(String name) Generate the HTML code for a SELECT tag that allows a single value to be selected.
String	singleRequest(String name, String value) Generate the HTML code for a SELECT tag that allows a single value to be selected.
String	singleRequest(String name, String value, String selector, String attributes) Generate the HTML code for a SELECT tag that allows a single value to be selected.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

data

protected DatabaseProperties data

Object containing database connection properties.

The value should be set by the constructor.

Constructor Detail

PulldownList

public PulldownList()

Method Detail

buildResultSet

protected abstract ResultSet buildResultSet(String selector)

Creates result set that is used to generate select tag.

Parameters:

selector - Option value that can be used to control generation of tag

Returns:

Result set

initialOption

protected String initialOption()

Used to generate initial option in select tag.

Returns:

HTML code for initial option tag

singleRequest

public String singleRequest(String name,
                            String value,
                            String selector,
                            String attributes)
                     throws SQLException

Generate the HTML code for a SELECT tag that allows a single value to be selected.

Parameters:

name - Name attribute for SELECT tag

value - Existing value for selector

selector - Option to be used in creating HTML code

attributes - Code for additional attributes for SELECT tag

Returns:

HTML code

Throws:

SQLException - if database error

multipleRequest

public String multipleRequest(String name,
                              String[] values,
                              String selector,
                              String attributes)
                       throws SQLException

Generate the HTML code for a SELECT tag that allows multiple values to be selected.

Parameters:

name - Name attribute for SELECT tag

values - Existing values for items in tag

selector - Option to be used in creating HTML code

attributes - Additional attributes for SELECT tag

Returns:

HTML code

Throws:

SQLException - if database problems

getValue

protected String getValue(ResultSet rs,
                          String selector)
                   throws SQLException

Determine the value for option

Parameters:

rs - Result set containing information for menu

selector - Optional selector for controlling HTML generation

Returns:

Text for value

Throws:

SQLException - if database problems

getText

protected String getText(ResultSet rs,
                         String selector)
                  throws SQLException

Determine text value for the option

Parameters:

rs - Result set containing information

selector - Optional selector for controlling HTML generation

Returns:

Text for caption

Throws:

SQLException - if database problems

buildResultSet

protected ResultSet buildResultSet()
                            throws SQLException

Creates result set that is used to generate select tag.

Returns:

Result set

Throws:

SQLException - if database problems

singleRequest

public String singleRequest(String name)
                     throws SQLException

Generate the HTML code for a SELECT tag that allows a single value to be selected.

Parameters:

name - Name attribute for SELECT tag

Returns:

HTML code

Throws:

SQLException - if database errors

singleRequest

public String singleRequest(String name,
                            String value)
                     throws SQLException

Generate the HTML code for a SELECT tag that allows a single value to be selected.

Parameters:

name - Name attribute for SELECT tag

value - Existing value for selector

Returns:

HTML code

Throws:

SQLException - if database errors

multipleRequest

public String multipleRequest(String name)
                       throws SQLException

Generate the HTML code for a SELECT tag that allows multiple values to be selected.

Parameters:

name - Name attribute for SELECT tag

Returns:

HTML code

Throws:

SQLException - if database problems

multipleRequest

public String multipleRequest(String name,
                              String[] values)
                       throws SQLException

Generate the HTML code for a SELECT tag that allows multiple values to be selected.

Parameters:

name - Name attribute for SELECT tag

values - Existing values for items in tag

Returns:

HTML code

Throws:

SQLException - if database problems