er.extensions.batching

Class ERXDirectActionBatchNavigationBar

java.lang.Object

com.webobjects.appserver.WOElement

com.webobjects.appserver.WOComponent

er.extensions.components.ERXComponent

er.extensions.components.ERXNonSynchronizingComponent

er.extensions.components.ERXStatelessComponent

er.extensions.batching.ERXDirectActionBatchNavigationBar

All Implemented Interfaces:

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

public class ERXDirectActionBatchNavigationBar
extends ERXStatelessComponent

BatchNavigationBar that uses a direct action and a "batch" URL parameter to switch to a specific batch. You have to do the batching yourself and get the information from the request though. Tip for this: ERXEOControlUtilities.objectsInRange is a really big help doing that!

See Also:

Serialized Form

Author:

cug - Sep 20, 2007

Bindings

Name	Description
actionName	(String) - the name of the directAction to call
actionClass	(String) - the name of the class for the directAction call
additionalUrlParameters	(NSDictionary) - parameters that get added to navigation URLs
batchsize	(Integer) - the size of the batches
currentBatchIndex	(Integer) - the index of the current page
numberOfObjects	(Integer) - the number of objects to batch
containerCssClass	(String) - the css class to use for the surrounding div container
backString	(String) - the string to use for the "back" link (HTML enabled); default = « back
forwardString	(String) - the string to use for the "forward" link (HTML enabled); default = back »
showPageNumbers	(Boolean) - whether or not to show the page numbers (you might want to show only the back and forward links); default = true
showPageString	(Boolean) - whether or not to show the "Page:" string to the left of the nav (will be made more flexible); default = false
showBatchNavigationForSinglePage	(Boolean) - whether or not to show the the batch navigation if we have only a single page; default = true

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
NSDictionary	dictInRepetition The one used in the repetition

Fields inherited from class er.extensions.components.ERXComponent

_dynamicBindings

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
ERXDirectActionBatchNavigationBar(WOContext context) Standard constructor

Method Summary

Modifier and Type	Method and Description
String	actionClass() Returns the name of the direct action class, if empty the default class is used (DirectAction)
String	actionName() Returns the name of the direct action to call
NSDictionary<String,Object>	additionalUrlParameters() The parameters to add to each link
String	backString() the string for the "back" link
NSArray<NSDictionary<String,Object>>	batchNumbers() Returns "batchNumber" objects which are dictionaries with key-value-pairs for the String to display.
Integer	batchSize() The current batch size
String	containerCssClass() The css class to use for the surrounding div
Integer	currentBatchIndex() The current batch index
String	forwardString() The string for the forward link
boolean	hasMoreThanOneBatch() Returns whether we have more than one batch and should show the navigation at all
boolean	isFirstBatch() Returns true if the currently displayed batch is the first one (for hiding the arrows on the left)
boolean	isLastBatch() Returns true if the currently displayed batch is the last one (for hiding the arrows on the right)
boolean	isSelected() Returns whether the currently generated item from the repetition is the selected one
Integer	lastBatch() Returns the number of the last page
ERXLocalizer	localizer() Convenience method to get the localizer.
Integer	nextBatch() Returns the number for the next batch
Integer	numberOfObjects() The total number of objects for which we create the batches
Integer	previousBatch() Returns the number for the previous batch
void	reset() Reset the instance variables
void	setActionClass(String className) Sets the name of the actionClass to use for the direct action call
void	setActionName(String name) Sets the name of the direct action to call
void	setAdditionalUrlParameters(NSDictionary<String,Object> dict) Set the parameters to add to each link
void	setBackString(String s) Set the string for the "back" link
void	setBatchSize(Integer size) Set the size of the batches to create the pager
void	setContainerCssClass(String cssClass) Set the class name for the surrounding div
void	setCurrentBatchIndex(Integer index) Set the current batch index
void	setForwardString(String s) Set the string for the "forward" link
void	setNumberOfObjects(Integer n) Set total number of objects for which we create the batches
void	setShowBatchNavigationForSinglePage(Boolean flag) Set the binding value for showBatchNavigationForSinglePage
void	setShowPageNumbers(Boolean flag) Set whether to show the page numbers
void	setShowPageString(Boolean flag) Set whether to show the string "Page:"
Boolean	showBatchNavigationForSinglePage() Return the value for the showBatchNavigationForSinglePage binding
boolean	showNavigationBar() Should we show the batch navigation bar? Checks the binding "showBatchNavigationForSinglePage"
Boolean	showPageNumbers() Returns whether to show the page numbers
Boolean	showPageString() Returns whether or not to show the string for "Page:"

Methods inherited from class er.extensions.components.ERXStatelessComponent

isStateless

Methods inherited from class er.extensions.components.ERXNonSynchronizingComponent

appendToResponse, invokeAction, resetCachedBindingsInStatefulComponent, synchronizesVariablesWithBindings, takeValuesFromRequest

Methods inherited from class er.extensions.components.ERXComponent

_awakeInContext, _checkAccess, _frameworkName, _includeCSSResources, _includeJavascriptResources, additionalCSSFiles, additionalJavascriptFiles, arrayValueForBinding, arrayValueForBinding, booleanValueForBinding, booleanValueForBinding, booleanValueForBinding, browser, checkAccess, clickToOpenEnabled, componentName, defaultCSSPath, defaultJavascriptPath, dynamicBindings, floatValueForBinding, intValueForBinding, isPageAccessAllowed, objectValueForBinding, objectValueForBinding, pageWithName, postAppendToResponse, preAppendToResponse, primaryCSSFile, primaryJavascriptFile, shouldCheckAccess, stringValueForBinding, stringValueForBinding, useDefaultComponentCSS, useDefaultComponentJavascript

Methods inherited from class com.webobjects.appserver.WOComponent

__valueForBinding, _associationWithName, _childTemplate, _cleanUpStatelessComponent, _componentDefinition, _componentUnroll, _isPage, _setContext, _setIsPage, _setParent, _setSubcomponent, _sleepInContext, _subcomponentForElementWithID, _templateNameForClass, _unroll, application, awake, baseURL, bindingKeys, canAccessFieldsDirectly, canGetValueForBinding, canSetValueForBinding, clone, context, debugString, descriptionForResponse, ensureAwakeInContext, frameworkName, generateResponse, handleQueryWithUnboundKey, handleTakeValueForUnboundKey, hasBinding, hasSession, isCachingEnabled, isEventLoggingEnabled, logString, name, pageWithName, parent, path, pathURL, performParentAction, pullValuesFromParent, pushValuesToParent, session, set_componentUnroll, set_unroll, setCachingEnabled, setValueForBinding, setVariableValueForName, sleep, takeValueForKey, takeValueForKeyPath, 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

dictInRepetition

public NSDictionary dictInRepetition

The one used in the repetition

Constructor Detail

ERXDirectActionBatchNavigationBar

public ERXDirectActionBatchNavigationBar(WOContext context)

Standard constructor

Parameters:

context - the current context

Method Detail

reset

public void reset()

Reset the instance variables

Overrides:

reset in class ERXStatelessComponent

batchNumbers

public NSArray<NSDictionary<String,Object>> batchNumbers()

Returns "batchNumber" objects which are dictionaries with key-value-pairs for the String to display.

Author:

cug - Sep 20, 2007

hasMoreThanOneBatch

public boolean hasMoreThanOneBatch()

Returns whether we have more than one batch and should show the navigation at all

Author:

cug - Nov 20, 2007

showNavigationBar

public boolean showNavigationBar()

Should we show the batch navigation bar? Checks the binding "showBatchNavigationForSinglePage"

Returns:

true if "showBatchNavigationForSinglePage" is true or there is more than one page

Author:

cug - Nov 20, 2007

isSelected

public boolean isSelected()

Returns whether the currently generated item from the repetition is the selected one

Returns:

true for the selected batch (page)

previousBatch

public Integer previousBatch()

Returns the number for the previous batch

Returns:

the previous batch number

nextBatch

public Integer nextBatch()

Returns the number for the next batch

Returns:

the number for the next batch

lastBatch

public Integer lastBatch()

Returns the number of the last page

Returns:

the number of the last page

isLastBatch

public boolean isLastBatch()

Returns true if the currently displayed batch is the last one (for hiding the arrows on the right)

Returns:

true for the last batch

isFirstBatch

public boolean isFirstBatch()

Returns true if the currently displayed batch is the first one (for hiding the arrows on the left)

Returns:

true for the first batch

localizer

public ERXLocalizer localizer()

Convenience method to get the localizer.

Overrides:

localizer in class ERXComponent

Returns:

the current localizer

カレント・ローカライザー

actionName

public String actionName()

Returns the name of the direct action to call

Returns:

a direct action name

setActionName

public void setActionName(String name)

Sets the name of the direct action to call

Parameters:

name - - a direct action name

actionClass

public String actionClass()

Returns the name of the direct action class, if empty the default class is used (DirectAction)

Returns:

a name for a subclass of WODirectAction

setActionClass

public void setActionClass(String className)

Sets the name of the actionClass to use for the direct action call

Parameters:

className - - name for the directAction class

batchSize

public Integer batchSize()

The current batch size

Returns:

the batch size

setBatchSize

public void setBatchSize(Integer size)

Set the size of the batches to create the pager

Parameters:

size - number of items per batch

numberOfObjects

public Integer numberOfObjects()

The total number of objects for which we create the batches

Returns:

total number of objects

setNumberOfObjects

public void setNumberOfObjects(Integer n)

Set total number of objects for which we create the batches

Parameters:

n -

currentBatchIndex

public Integer currentBatchIndex()

The current batch index

Returns:

the current batch index

setCurrentBatchIndex

public void setCurrentBatchIndex(Integer index)

Set the current batch index

Parameters:

index - - the index to set

additionalUrlParameters

public NSDictionary<String,Object> additionalUrlParameters()

The parameters to add to each link

Returns:

dict of parameters

setAdditionalUrlParameters

public void setAdditionalUrlParameters(NSDictionary<String,Object> dict)

Set the parameters to add to each link

Parameters:

dict - parameters

containerCssClass

public String containerCssClass()

The css class to use for the surrounding div

Returns:

css class name

setContainerCssClass

public void setContainerCssClass(String cssClass)

Set the class name for the surrounding div

Parameters:

cssClass - CSS class for container element

showPageString

public Boolean showPageString()

Returns whether or not to show the string for "Page:"

Returns:

the value for the binding

setShowPageString

public void setShowPageString(Boolean flag)

Set whether to show the string "Page:"

Parameters:

flag -

forwardString

public String forwardString()

The string for the forward link

setForwardString

public void setForwardString(String s)

Set the string for the "forward" link

Parameters:

s -

backString

public String backString()

the string for the "back" link

setBackString

public void setBackString(String s)

Set the string for the "back" link

Parameters:

s -

showPageNumbers

public Boolean showPageNumbers()

Returns whether to show the page numbers

Returns:

true for showing the numbers, defaults to true

setShowPageNumbers

public void setShowPageNumbers(Boolean flag)

Set whether to show the page numbers

Parameters:

flag -

showBatchNavigationForSinglePage

public Boolean showBatchNavigationForSinglePage()

Return the value for the showBatchNavigationForSinglePage binding

Returns:

value for the showBatchNavigationForSinglePage binding

Author:

cug - Nov 20, 2007

setShowBatchNavigationForSinglePage

public void setShowBatchNavigationForSinglePage(Boolean flag)

Set the binding value for showBatchNavigationForSinglePage

Parameters:

flag -

Author:

cug - Nov 20, 2007