SelectorBox (Apache Turbine 4.0-M2 API)

java.lang.Object
- org.apache.turbine.util.template.SelectorBox

public class SelectorBox
extends Object

This class is for generating a SelectorBox. It is good when used with WM because you can stuff it into the context and then just call it to generate the HTML. It can be used in other cases as well, but WM is the best case for it right now.

For example code showing the usage for this module, please see the toString() method below to see how it would be refered to from WM.

 // get the roles for a user
 RoleSet userRoles = new DefaultAccessControl().getRoles(loginid, null);
 if ( userRoles != null )
 {
     context.put("hasRoleSet", Boolean.TRUE);

     // get an array of the users roles
     Role[] usersRoles = userRoles.getRolesArray();
     // get an array of all the roles in the system
     Role[] allRoles = ((RoleSet)RolePeer.retrieveSet()).getRolesArray();

     Object[] names = new Object[allRoles.length];
     Object[] values = new Object[allRoles.length];
     for ( int i=0;i<allRoles.length; i++ )
     {
         names[i] = Integer.valueOf(allRoles[i].getPrimaryKey()).toString();
         values[i] = allRoles[i].getName();
     }

     SelectorBox sb = new SelectorBox("roleSetBox", names, values);
     sb.buildBooleans(usersRoles, allRoles);
     context.put("roleSetBox", sb);
 }
 else
 {
     context.put("hasRoleSet", Boolean.FALSE);
 }

Version:: $Id: SelectorBox.java 1706239 2015-10-01 13:18:35Z tv $
Author:: Jon S. Stevens

Constructor Summary

Constructors
Constructor and Description
`SelectorBox(String name, Object[] names, Object[] values)` Generic constructor, builds a select box with a default size of 1 and no selected items.
`SelectorBox(String name, Object[] names, Object[] values, boolean[] selected)` Generic constructor builds a select box.
`SelectorBox(String name, Object[] names, Object[] values, int size)` Generic constructor builds a select box.
`SelectorBox(String name, Object[] names, Object[] values, int size, boolean[] selected)` Primary constructor for everything.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`buildBooleans(Object[] selectedSet, Object[] entireSet)` Pass in an array of selected items and the entire set of items and it will determine which items in the selected set are also in the entireset and then build a boolean[] up that is the same size as the entireSet with markings to tell whether or not the items are marked or not.
`void`	`reset()` Resets the internal state of the SelectorBox.
`SelectorBox`	`setMultiple(boolean val)` This allows you to set the multiple attribute to the select element.
`SelectorBox`	`setName(String name)` This allows one to set the name= attribute to the select element.
`SelectorBox`	`setOnChange(String script)` This allows one to set an onChange attribute on the select tag
`SelectorBox`	`setSelected(boolean[] bools)` This allows one to set the array of selected booleans.
`SelectorBox`	`setSelected(Object name)` This will set all elements as unselected, except for the element(s) with the given name.
`SelectorBox`	`setSize(int size)` This allows one to set the size of the select element.
`String`	`toString()` This builds out the select box at a certain size.
`String`	`toString(int size)` This builds out the select box at a certain size.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - SelectorBox
```
public SelectorBox(String name,
           Object[] names,
           Object[] values)
```
    Generic constructor, builds a select box with a default size of 1 and no selected items.
    
    Parameters:
    name - A String with the name for the select box.
    names - An Object[] with the names.
    values - An Object[] with the values.
  - SelectorBox
```
public SelectorBox(String name,
           Object[] names,
           Object[] values,
           int size)
```
    Generic constructor builds a select box.
    
    Parameters:
    name - A String with the name for the select box.
    names - An Object[] with the names.
    values - An Object[] with the values.
    size - An int specifying the size.
  - SelectorBox
```
public SelectorBox(String name,
           Object[] names,
           Object[] values,
           boolean[] selected)
```
    Generic constructor builds a select box.
    
    Parameters:
    name - A String with the name for the select box.
    names - An Object[] with the names.
    values - An Object[] with the values.
    selected - A boolean[] with the selected items.
  - SelectorBox
```
public SelectorBox(String name,
           Object[] names,
           Object[] values,
           int size,
           boolean[] selected)
```
    Primary constructor for everything.
    
    Parameters:
    name - A String with the name for the select box.
    names - An Object[] with the names.
    values - An Object[] with the values.
    size - An int specifying the size.
    selected - A boolean[] with the selected items.
- Method Detail
  - buildBooleans
```
public void buildBooleans(Object[] selectedSet,
                 Object[] entireSet)
```
    Pass in an array of selected items and the entire set of items and it will determine which items in the selected set are also in the entireset and then build a boolean[] up that is the same size as the entireSet with markings to tell whether or not the items are marked or not. It uses toString().equalsIgnoreCase() on the Object in the Object[] to determine if the items are equal.
    
    Parameters:
    selectedSet - An Object[].
    entireSet - An Object[].
  - toString
```
public String toString(int size)
```
    This builds out the select box at a certain size. To use this element in WM, you simply build this object in your java code, put it into the context and then call $selectBox.toString(5).
    
    Parameters:
    size - An int with the size.
    
    Returns:
    A String with the HTML code.
  - reset
```
public void reset()
```
    Resets the internal state of the SelectorBox.
  - toString
```
public String toString()
```
    This builds out the select box at a certain size. To use this element in WM, you simply build this object in your java code, put it into the context and then call $selectBox and it will build it with the default size of 1.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    A String with the HTML code.
  - setMultiple
```
public SelectorBox setMultiple(boolean val)
```
    This allows you to set the multiple attribute to the select element. Example usage from within WM is like this:
    $selectBox.setMultiple(true).toString(4)
    
    Parameters:
    val - True if multiple selection should be allowed.
    
    Returns:
    A SelectorBox (self).
  - setName
```
public SelectorBox setName(String name)
```
    This allows one to set the name= attribute to the select element.
    
    Parameters:
    name - A String with the name.
    
    Returns:
    A SelectorBox (self).
  - setSize
```
public SelectorBox setSize(int size)
```
    This allows one to set the size of the select element.
    
    Parameters:
    size - An int with the size.
    
    Returns:
    A SelectorBox (self).
  - setOnChange
```
public SelectorBox setOnChange(String script)
```
    This allows one to set an onChange attribute on the select tag
    
    Parameters:
    script - A string with the script to put in onChange
    
    Returns:
    A SelectorBox (self).
  - setSelected
```
public SelectorBox setSelected(boolean[] bools)
```
    This allows one to set the array of selected booleans.
    
    Parameters:
    bools - an array of booleans
    
    Returns:
    A SelectorBox (self).
  - setSelected
```
public SelectorBox setSelected(Object name)
```
    This will set all elements as unselected, except for the element(s) with the given name.
    
    Parameters:
    name - The name to appear as selected.
    
    Returns:
    A SelectorBox (self).

Class SelectorBox

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

SelectorBox

SelectorBox

SelectorBox

SelectorBox

Method Detail

buildBooleans

toString

reset

toString

setMultiple

setName

setSize

setOnChange

setSelected

setSelected