er.ajax

Class AjaxGridNavBar

java.lang.Object

com.webobjects.appserver.WOElement

com.webobjects.appserver.WOComponent

er.ajax.AjaxGridNavBar

All Implemented Interfaces:

WOActionResults, NSKeyValueCoding, NSKeyValueCoding.ErrorHandling, NSKeyValueCodingAdditions, NSValidation, Serializable, Cloneable

public abstract class AjaxGridNavBar
extends WOComponent

Abstract super class for a navigation bar that can be used with AjaxGrid. Use of this is not mandatory, it is provided as a convenience.

Example Usage

This class has a symbiotic relationship with AjaxGrid. When this nav bar changes the data (e.g. batch size, batch displayed) it updates the grid's container not its own container. It needs to have the grid tell it to update after the grid has refreshed. This allows the AjaxGrid to make any needed changes to the display group before the contents of the nav bar are updated.

  Grid: AjaxGrid {
      configurationData = configData;
      displayGroup = displayGroup;
      afterUpdate = "ajaxGridExampleNavBarUpdate();";
  }
 
  NavBar: AjaxGridExampleNavBar {
     containerID = "ajaxGridExampleNavBar";
     displayGroup = displayGroup;
     configurationData = configData;
  }
 

Example Sub-class

   <div class="ajaxGridNavBar">
    <webobject name="NavUpdater">
        <table><tr>
          <td style="text-align:left;"><webobject name="PrevBatch"><<</webobject>  
          Page <b><span id="currentBatch"><webobject name="CurrentBatchIndex"/></span></b> of <b><webobject name="BatchCount"/></b>  
          <webobject name="NextBatch">>></webobject>
        </td>
        <td style="text-align:center;">
           Number of lines per page: <webobject name="BatchSizes"/><webobject name="UpdateBatchSize"/>
        </td>
        <td style="text-align:right;">
          Displaying <b><webobject name="FirstIndex"/></b> to <b><webobject name="LastIndex"/></b> of <b><webobject name="TotalCount"/></b> entries.
        </td></tr></table>
        <webobject name="BatchSlider"/>
    </webobject name="NavUpdater">
  </div>
 

  NavUpdater: AjaxUpdateContainer {
     id = containerID;
  }
 
  BatchCount: WOString {
      value = displayGroup.batchCount;
  }
 
  BatchSlider: AjaxSlider {
     orientation = "horizontal";
     value = currentBatchIndex;
     minimum = 1;
     maximum = displayGroup.batchCount;
     onChangeServer = updateGridContainer;
     onSlide = "function(v) { $('currentBatch').innerHTML = Math.round(v) }";
     onChange = "function(v) { $('currentBatch').innerHTML = Math.round(v) }";
  }
  
  CurrentBatchIndex : WOString {
     value = displayGroup.currentBatchIndex;
  }
 
  PrevBatch : AjaxUpdateLink {
     action = previousBatch;
     updateContainerID = gridContainerID;
  }
 
  NextBatch : AjaxUpdateLink {
     action = nextBatch;
     updateContainerID = gridContainerID;
  }
 
  BatchSizes: WOPopUpButton {
     list      = batchSizes;
     item      = batchSize;
     selection = currentBatchSize;
     onChange  = updateBatchSizeOnChange;
  }
 
  FirstIndex: WOString {
    value = displayGroup.indexOfFirstDisplayedObject;
  }
 
  LastIndex: WOString {
     value = displayGroup.indexOfLastDisplayedObject;
  }
 
  TotalCount: WOString {
     value = displayGroup.allObjects.count;
  }
 
  UpdateBatchSize: AjaxUpdateLink {
    action = batchSizeUpdated;
    functionName = updateBatchSizeName;
    updateContainerID = gridContainerID;
 }
 

See Also:

Serialized Form

Author:

Chuck Hill

Bindings

Name	Description
displayGroup	the same WODisplayGroup passed to AjaxGrid
configurationData	the same NSMutableDictionary passed to AjaxGrid
containerID	unique ID for the AjaxUpdateContainer in this component.

Nested Class Summary

Nested classes/interfaces inherited from class com.webobjects.appserver.WOComponent

WOComponent._EventLoggingEnabler, WOComponent.Event

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

NSKeyValueCodingAdditions.DefaultImplementation, NSKeyValueCodingAdditions.Utility

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCoding

NSKeyValueCoding._BooleanFieldBinding, NSKeyValueCoding._BooleanMethodBinding, NSKeyValueCoding._FieldBinding, NSKeyValueCoding._ForwardingBinding, NSKeyValueCoding._KeyBinding, NSKeyValueCoding._KeyBindingCreation, NSKeyValueCoding._MethodBinding, NSKeyValueCoding._NumberFieldBinding, NSKeyValueCoding._NumberMethodBinding, NSKeyValueCoding._ReflectionKeyBindingCreation, NSKeyValueCoding.ErrorHandling, NSKeyValueCoding.MapImplementation, NSKeyValueCoding.Null<T>, NSKeyValueCoding.UnknownKeyException, NSKeyValueCoding.ValueAccessor

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSValidation

NSValidation._MethodBinding, NSValidation._ValidationBinding, NSValidation.DefaultImplementation, NSValidation.Utility, NSValidation.ValidationException

Field Summary

Fields

Modifier and Type	Field and Description
static String	CONFIGURATION_DATA_BINDING
static String	CONTAINER_ID_BINDING
static String	DISPLAY_GROUP_BINDING

Fields inherited from class com.webobjects.appserver.WOComponent

_Extension, _IsEventLoggingEnabled, _keyAssociations

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding.ErrorHandling

_CLASS

Fields inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

_CLASS, _KeyPathSeparatorChar, KeyPathSeparator

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding

NullValue

Fields inherited from interface com.webobjects.foundation.NSValidation

_CLASS

Constructor Summary

Constructors

Constructor and Description
AjaxGridNavBar(WOContext context)

Method Summary

Modifier and Type	Method and Description
abstract NSArray	batchSizes()
void	batchSizeUpdated() Ajax action method for updates to batch size.
NSMutableDictionary	configurationData()
String	containerID()
int	currentBatchIndex()
String	currentBatchSize()
WODisplayGroup	displayGroup()
String	gridContainerID()
boolean	isStateless()
void	nextBatch() Ajax action method to select the next batch.
void	previousBatch() Ajax action method to select the previous batch.
void	setCurrentBatchIndex(Number newValue) Intended to be bound to Ajax slider or selection of batch to display.
String	tableID()
String	updateBatchSizeName()
String	updateBatchSizeOnChange()
String	updateGridContainer() Returns JavaScript to update the AjaxUpdateContainer identified by gridContainerID().

Methods inherited from class com.webobjects.appserver.WOComponent

__valueForBinding, _associationWithName, _awakeInContext, _childTemplate, _cleanUpStatelessComponent, _componentDefinition, _componentUnroll, _isPage, _setContext, _setIsPage, _setParent, _setSubcomponent, _sleepInContext, _subcomponentForElementWithID, _templateNameForClass, _unroll, appendToResponse, application, awake, baseURL, bindingKeys, canAccessFieldsDirectly, canGetValueForBinding, canSetValueForBinding, clone, context, debugString, descriptionForResponse, ensureAwakeInContext, frameworkName, generateResponse, handleQueryWithUnboundKey, handleTakeValueForUnboundKey, hasBinding, hasSession, invokeAction, isCachingEnabled, isEventLoggingEnabled, logString, name, pageWithName, parent, path, pathURL, performParentAction, pullValuesFromParent, pushValuesToParent, reset, session, set_componentUnroll, set_unroll, setCachingEnabled, setValueForBinding, setVariableValueForName, sleep, synchronizesVariablesWithBindings, takeValueForKey, takeValueForKeyPath, takeValuesFromRequest, template, templateWithHTMLString, templateWithHTMLString, templateWithHTMLString, templateWithName, toString, unableToSetNullForKey, validateTakeValueForKeyPath, validateValueForKey, validationFailedWithException, valueForBinding, valueForBooleanBinding, valueForIntegerBinding, valueForKey, valueForKeyPath, valueForNSArrayBindings, valueForNSDictionaryBindings, valueForNumberBinding, valueForStringBinding, variableValueForName, variableWithName

Methods inherited from class java.lang.Object

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

Field Detail

CONTAINER_ID_BINDING

public static final String CONTAINER_ID_BINDING

See Also:

Constant Field Values

DISPLAY_GROUP_BINDING

public static final String DISPLAY_GROUP_BINDING

See Also:

Constant Field Values

CONFIGURATION_DATA_BINDING

public static final String CONFIGURATION_DATA_BINDING

See Also:

Constant Field Values

Constructor Detail

AjaxGridNavBar

public AjaxGridNavBar(WOContext context)

Method Detail

isStateless

public boolean isStateless()

Overrides:

isStateless in class WOComponent

nextBatch

public void nextBatch()

Ajax action method to select the next batch.

previousBatch

public void previousBatch()

Ajax action method to select the previous batch.

setCurrentBatchIndex

public void setCurrentBatchIndex(Number newValue)

Intended to be bound to Ajax slider or selection of batch to display.

Parameters:

newValue - new batch number from AjaxSlider

currentBatchIndex

public int currentBatchIndex()

Returns:

value for AjaxSlider

updateGridContainer

public String updateGridContainer()

Returns JavaScript to update the AjaxUpdateContainer identified by gridContainerID(). This is intended for use as onChangeServer binding for a AjaxSlider.

Returns:

JavaScript calls to update the Ajax grid

updateBatchSizeOnChange

public String updateBatchSizeOnChange()

Returns:

JavaScript for option control to pass selected batch size when changed

updateBatchSizeName

public String updateBatchSizeName()

Returns:

unique name for the AjaxUpdateContainer wrapping this AjaxGridNavBar

batchSizeUpdated

public void batchSizeUpdated()

Ajax action method for updates to batch size. Grabs batch size from request and updates configuration.

batchSizes

public abstract NSArray batchSizes()

Returns:

the list of batch sizes to show in the popup

currentBatchSize

public String currentBatchSize()

Returns:

displayGroup().numberOfObjectsPerBatch() as a String for the option input

gridContainerID

public String gridContainerID()

Returns:

UPDATE_CONTAINER_ID from configurationData(), the update container ID from the AjaxGrid

tableID

public String tableID()

Returns:

TABLE_ID from configurationData(), the table ID from the AjaxGrid

displayGroup

public WODisplayGroup displayGroup()

Returns:

value bound to displayGroup

configurationData

public NSMutableDictionary configurationData()

Returns:

value bound to configurationData

containerID

public String containerID()

Returns:

value bound to containerID