Java Doc for ListWidget.java in  » Web-Framework » aranea-mvc-1.1.1 » org » araneaframework » uilib » list » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Java Source Code / Java Documentation
1. 6.0 JDK Core
2. 6.0 JDK Modules
3. 6.0 JDK Modules com.sun
4. 6.0 JDK Modules com.sun.java
5. 6.0 JDK Modules sun
6. 6.0 JDK Platform
7. Ajax
8. Apache Harmony Java SE
9. Aspect oriented
10. Authentication Authorization
11. Blogger System
12. Build
13. Byte Code
14. Cache
15. Chart
16. Chat
17. Code Analyzer
18. Collaboration
19. Content Management System
20. Database Client
21. Database DBMS
22. Database JDBC Connection Pool
23. Database ORM
24. Development
25. EJB Server geronimo
26. EJB Server GlassFish
27. EJB Server JBoss 4.2.1
28. EJB Server resin 3.1.5
29. ERP CRM Financial
30. ESB
31. Forum
32. GIS
33. Graphic Library
34. Groupware
35. HTML Parser
36. IDE
37. IDE Eclipse
38. IDE Netbeans
39. Installer
40. Internationalization Localization
41. Inversion of Control
42. Issue Tracking
43. J2EE
44. JBoss
45. JMS
46. JMX
47. Library
48. Mail Clients
49. Net
50. Parser
51. PDF
52. Portal
53. Profiler
54. Project Management
55. Report
56. RSS RDF
57. Rule Engine
58. Science
59. Scripting
60. Search Engine
61. Security
62. Sevlet Container
63. Source Control
64. Swing Library
65. Template Engine
66. Test Coverage
67. Testing
68. UML
69. Web Crawler
70. Web Framework
71. Web Mail
72. Web Server
73. Web Services
74. Web Services apache cxf 2.0.1
75. Web Services AXIS2
76. Wiki Engine
77. Workflow Engines
78. XML
79. XML UI
Java
Java Tutorial
Java Open Source
Jar File Download
Java Articles
Java Products
Java by API
Photoshop Tutorials
Maya Tutorials
Flash Tutorials
3ds-Max Tutorials
Illustrator Tutorials
GIMP Tutorials
C# / C Sharp
C# / CSharp Tutorial
C# / CSharp Open Source
ASP.Net
ASP.NET Tutorial
JavaScript DHTML
JavaScript Tutorial
JavaScript Reference
HTML / CSS
HTML CSS Reference
C / ANSI-C
C Tutorial
C++
C++ Tutorial
Ruby
PHP
Python
Python Tutorial
Python Open Source
SQL Server / T-SQL
SQL Server / T-SQL Tutorial
Oracle PL / SQL
Oracle PL/SQL Tutorial
PostgreSQL
SQL / MySQL
MySQL Tutorial
VB.Net
VB.Net Tutorial
Flash / Flex / ActionScript
VBA / Excel / Access / Word
XML
XML Tutorial
Microsoft Office PowerPoint 2007 Tutorial
Microsoft Office Excel 2007 Tutorial
Microsoft Office Word 2007 Tutorial
Java Source Code / Java Documentation » Web Framework » aranea mvc 1.1.1 » org.araneaframework.uilib.list 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


org.araneaframework.core.BaseApplicationWidget
   org.araneaframework.uilib.core.BaseUIWidget
      org.araneaframework.uilib.list.ListWidget

All known Subclasses:   org.araneaframework.uilib.list.EditableListWidget,  org.araneaframework.uilib.list.BeanListWidget,
ListWidget
public class ListWidget extends BaseUIWidget implements ListContext(Code)
This class is the base widget for lists. It interacts with the user and uses the data from org.araneaframework.uilib.list.dataprovider.ListDataProvider to make a user view into the list. It uses helper classes to do ordering, filtering and sequencing (breaking the list into pages).

Note that ListWidget must be initialized before it can be configured.
author:
   Jevgeni Kabanov (ekabanov at araneaframework dot org)
author:
   Rein Raudjärv


Inner Class :protected class NextPageEventHandler extends StandardEventListener
Inner Class :protected class PreviousPageEventHandler extends StandardEventListener
Inner Class :protected class NextBlockEventHandler extends StandardEventListener
Inner Class :protected class PreviousBlockEventHandler extends StandardEventListener
Inner Class :protected class FirstPageEventHandler extends StandardEventListener
Inner Class :protected class LastPageEventHandler extends StandardEventListener
Inner Class :protected class JumpToPageEventHandler extends StandardEventListener
Inner Class :protected class ShowAllEventHandler extends StandardEventListener
Inner Class :protected class ShowSliceEventHandler extends StandardEventListener
Inner Class :protected class OrderEventHandler extends StandardEventListener
Inner Class :protected class FilterEventHandler implements OnClickEventListener
Inner Class :protected class FilterClearEventHandler implements OnClickEventListener
Inner Class :protected class DataProviderDataUpdateListener implements ListDataProvider.DataUpdateListener
Inner Class :public class ViewModel extends BaseApplicationWidget.ViewModel

Field Summary
final public static  StringFILTER_BUTTON_ID
    
final public static  StringFILTER_FORM_NAME
     The filter form id.
final public static  StringFILTER_RESET_BUTTON_ID
    
final public static  StringORDER_FORM_NAME
     The multi-ordering form name.
protected  ListDataProviderdataProvider
    
protected  FilterHelperfilterHelper
    
protected  FormWidgetform
    
protected  ListitemRange
    
protected  ListStructurelistStructure
    
final protected static  Loglog
    
protected  OrderInfoorderInfo
    
protected  MaprequestIdToRow
    
protected  SequenceHelpersequenceHelper
    
protected  TypeHelpertypeHelper
    

Constructor Summary
public  ListWidget()
     Creates a new ListWidget instance.

Method Summary
public  FieldFilterHelperaddField(String id, String label)
     Adds a list field.
public  FieldFilterHelperaddField(String id, String label, boolean orderable)
     Adds a list field.
Parameters:
  id - list field Id.
Parameters:
  label - list field label.
Parameters:
  orderable - whether this list field should be orderable or not.
public  FieldFilterHelperaddField(String id, String label, Class type)
     Adds a list field.
public  FieldFilterHelperaddField(String id, String label, Class type, boolean orderable)
     Adds a list field.
Parameters:
  id - list field Id.
Parameters:
  label - list field label.
Parameters:
  type - list field type.
Parameters:
  orderable - whether this list field should be orderable or not.
public  voidaddFilter(FieldOrder order)
     Adds a list field order.
public  voidaddFilter(ListFilter filter)
     Adds a list filter.
public  voidaddInitEvent(Event event)
    
protected  booleancheckChanged()
    
protected  voidclearFilter()
     Handles filter clearing.
public  voidclearFilters()
     Removes all list filters.
protected static  voidclearForm(FormWidget compositeFormElement)
    
public  voidclearOrders()
     Removes all list orders.
protected  FilterHelpercreateFilterHelper()
    
protected  ListStructurecreateListStructure()
    
protected  SequenceHelpercreateSequenceHelper()
    
protected  TypeHelpercreateTypeHelper()
    
protected  voiddestroy()
     Destoys the list and contained data provider and filter form.
protected  voidfilter()
     Handles filtering.
protected  voidfireChange()
    
public  longgetCurrentPageFirstItemIndex()
     Gets first item to be displayed on the current page.
public  longgetCurrentPageLastItemIndex()
     Gets last item to be displayed on the current page.
public  ListDataProvidergetDataProvider()
     Returns the ListDataProvider used to fill the list with data.
public  ListFieldgetField(String id)
     Returns ListField .
Parameters:
  id - ListFieldidentifier.
public  ComparatorgetFieldComparator(String fieldId)
     Returns Comparator for the specified field.
public  StringgetFieldLabel(String columnId)
     Returns label of ListField .
Parameters:
  columnId - ListField identifier.
public  ClassgetFieldType(String fieldId)
     Returns type of list field.
public  ListgetFields()
     Returns ListField s.
public  FilterHelpergetFilterHelper()
     Returns the FilterHelper used to help with adding filters.
public  FieldFilterHelpergetFilterHelper(String fieldId)
     Returns the FieldFilterHelper used to help with adding filters for specified field.
public  MapgetFilterInfo()
     Returns the filter information from filter form.
public  FormWidgetgetForm()
     Returns the filter form.
public  ListgetItemRange()
     Returns the current item range.
public  longgetItemsOnPage()
     Returns how many items will be displayed on one page.
public  ListStructuregetListStructure()
     Returns the ListStructure used to describe the list.
public  LocalegetLocale()
     Returns the Locale used by memory-based filters and orders.
public  OrderInfogetOrderInfo()
     Returns the order info.
public  ObjectgetRowFromRequestId(String requestId)
     Returns row object according to the request identifier.
Parameters:
  requestId - request identifier.
public  SequenceHelpergetSequenceHelper()
     Returns the SequenceHelper used to output pages.
public  TypeHelpergetTypeHelper()
     Returns the TypeHelper used to help with field types.
public  ObjectgetViewModel()
     Returns ViewModel - list widget view model.
protected  voidinit()
     Initilizes the list, initializing contained filter form and the ListDataProvider and getting the initial item range.
protected  voidinitDataProvider()
    
protected  voidinitFilterForm()
    
protected  voidinitSequenceHelper()
    
public  booleanisIgnoreCase()
     Returns whether new filters and orders are case insensitive.
public  booleanisOrderableByDefault()
     Returns true if all fields are added orderable by default.
protected  voidmakeRequestIdToRowMapping()
     Creates mapping between rows and request ids.
protected  voidorder(String fieldName)
     Handles single column ordering.
protected  voidpropagateListDataProviderWithOrderInfo(OrderInfo orderInfo)
    
public  voidrefresh()
     Forces the list data provider to refresh the data.
public  voidrefreshCurrentItemRange()
     Refreshes the current item range, reloading the shown items.
public  voidresetSequence()
     Resets the sequence, starting at first page with all defaults.
protected  voidrunInitEvents()
    
public  voidsetCurrentPage(long currentPage)
     Sets the page which will be displayed.
public  voidsetDataProvider(ListDataProvider dataProvider)
     Sets the ListDataProvider used to fill the list with data.
public  voidsetFilterButtonLabel(String label)
     Sets the filter button label.
public  voidsetFilterHelper(FilterHelper filterHelper)
     Sets the FilterHelper used to help with adding filters.
public  voidsetFilterInfo(Map filterInfo)
     Sets the filter information to list data provider and filter form.
public  voidsetFilterResetButtonLabel(String label)
     Sets the filter reset button label.
public  voidsetForm(FormWidget form)
     Saves the filter form.
public  voidsetInitialOrder(String fieldId, boolean ascending)
     Sets the initial order of the list.
public  voidsetItemsOnPage(long itemsOnPage)
     Sets how many items will be displayed on one page.
public  voidsetListStructure(ListStructure listStructure)
     Saves the ListStructure used to fill the list with data.
public  voidsetOrderInfo(OrderInfo orderInfo)
     Sets the order information to list data provider and list widget.
public  voidsetOrderableByDefault(boolean orderableByDefault)
     Sets whether all fields are added orderable by default.
public  voidsetTypeHelper(TypeHelper typeHelper)
     Sets the TypeHelper used to help with field types.
public  voidshowDefaultPages()
     Collapses the list, showing only the current page.
public  voidshowFullPages()
     Expands the list showing all items.

Field Detail
FILTER_BUTTON_ID
final public static String FILTER_BUTTON_ID(Code)
The filter button id



FILTER_FORM_NAME
final public static String FILTER_FORM_NAME(Code)
The filter form id.



FILTER_RESET_BUTTON_ID
final public static String FILTER_RESET_BUTTON_ID(Code)
The rest filter button id



ORDER_FORM_NAME
final public static String ORDER_FORM_NAME(Code)
The multi-ordering form name.



dataProvider
protected ListDataProvider dataProvider(Code)



filterHelper
protected FilterHelper filterHelper(Code)



form
protected FormWidget form(Code)



itemRange
protected List itemRange(Code)



listStructure
protected ListStructure listStructure(Code)



log
final protected static Log log(Code)



orderInfo
protected OrderInfo orderInfo(Code)



requestIdToRow
protected Map requestIdToRow(Code)



sequenceHelper
protected SequenceHelper sequenceHelper(Code)



typeHelper
protected TypeHelper typeHelper(Code)




Constructor Detail
ListWidget
public ListWidget()(Code)
Creates a new ListWidget instance.




Method Detail
addField
public FieldFilterHelper addField(String id, String label)(Code)
Adds a list field.

The added field is orderable if ListWidget.isOrderableByDefault() returns true.
Parameters:
  id - list field Id.
Parameters:
  label - list field label.




addField
public FieldFilterHelper addField(String id, String label, boolean orderable)(Code)
Adds a list field.
Parameters:
  id - list field Id.
Parameters:
  label - list field label.
Parameters:
  orderable - whether this list field should be orderable or not.



addField
public FieldFilterHelper addField(String id, String label, Class type)(Code)
Adds a list field.

The added field is orderable if ListWidget.isOrderableByDefault() returns true.
Parameters:
  id - list field Id.
Parameters:
  label - list field label.
Parameters:
  type - list field type.




addField
public FieldFilterHelper addField(String id, String label, Class type, boolean orderable)(Code)
Adds a list field.
Parameters:
  id - list field Id.
Parameters:
  label - list field label.
Parameters:
  type - list field type.
Parameters:
  orderable - whether this list field should be orderable or not.



addFilter
public void addFilter(FieldOrder order)(Code)
Adds a list field order.
Parameters:
  order - list field order.



addFilter
public void addFilter(ListFilter filter)(Code)
Adds a list filter.
Parameters:
  filter - list filter.



addInitEvent
public void addInitEvent(Event event)(Code)



checkChanged
protected boolean checkChanged()(Code)

since:
   1.1



clearFilter
protected void clearFilter()(Code)
Handles filter clearing.



clearFilters
public void clearFilters()(Code)
Removes all list filters.



clearForm
protected static void clearForm(FormWidget compositeFormElement)(Code)



clearOrders
public void clearOrders()(Code)
Removes all list orders.



createFilterHelper
protected FilterHelper createFilterHelper()(Code)



createListStructure
protected ListStructure createListStructure()(Code)



createSequenceHelper
protected SequenceHelper createSequenceHelper()(Code)



createTypeHelper
protected TypeHelper createTypeHelper()(Code)



destroy
protected void destroy() throws Exception(Code)
Destoys the list and contained data provider and filter form.
throws:
  Exception -



filter
protected void filter() throws Exception(Code)
Handles filtering.



fireChange
protected void fireChange()(Code)

since:
   1.1



getCurrentPageFirstItemIndex
public long getCurrentPageFirstItemIndex()(Code)
Gets first item to be displayed on the current page. index of the first element from the list to be displayed.



getCurrentPageLastItemIndex
public long getCurrentPageLastItemIndex()(Code)
Gets last item to be displayed on the current page. index of the last element from the list to be displayed.



getDataProvider
public ListDataProvider getDataProvider()(Code)
Returns the ListDataProvider used to fill the list with data. the ListDataProviderused to fill the list with data.



getField
public ListField getField(String id)(Code)
Returns ListField .
Parameters:
  id - ListFieldidentifier. ListField.



getFieldComparator
public Comparator getFieldComparator(String fieldId)(Code)
Returns Comparator for the specified field.



getFieldLabel
public String getFieldLabel(String columnId)(Code)
Returns label of ListField .
Parameters:
  columnId - ListField identifier. label of ListField.



getFieldType
public Class getFieldType(String fieldId)(Code)
Returns type of list field. Returns null if no such field or type for this field is available.
Parameters:
  fieldId - field identifier. field type



getFields
public List getFields()(Code)
Returns ListField s. ListFields.



getFilterHelper
public FilterHelper getFilterHelper()(Code)
Returns the FilterHelper used to help with adding filters. the FilterHelper used to help with adding filters.



getFilterHelper
public FieldFilterHelper getFilterHelper(String fieldId)(Code)
Returns the FieldFilterHelper used to help with adding filters for specified field. the FieldFilterHelper used to help with adding filtersfor specified field.



getFilterInfo
public Map getFilterInfo()(Code)
Returns the filter information from filter form. Map containing filter information.



getForm
public FormWidget getForm()(Code)
Returns the filter form. the filter form.



getItemRange
public List getItemRange()(Code)
Returns the current item range. the current item range.



getItemsOnPage
public long getItemsOnPage()(Code)
Returns how many items will be displayed on one page. how many items will be displayed on one page.



getListStructure
public ListStructure getListStructure()(Code)
Returns the ListStructure used to describe the list. the ListStructureused to describe the list.



getLocale
public Locale getLocale()(Code)
Returns the Locale used by memory-based filters and orders.



getOrderInfo
public OrderInfo getOrderInfo()(Code)
Returns the order info. the order info.



getRowFromRequestId
public Object getRowFromRequestId(String requestId)(Code)
Returns row object according to the request identifier.
Parameters:
  requestId - request identifier. list row object.



getSequenceHelper
public SequenceHelper getSequenceHelper()(Code)
Returns the SequenceHelper used to output pages. the SequenceHelperused to output pages.



getTypeHelper
public TypeHelper getTypeHelper()(Code)
Returns the TypeHelper used to help with field types. the TypeHelper used to help with field types.



getViewModel
public Object getViewModel()(Code)
Returns ViewModel - list widget view model. ViewModel- list widget view model.



init
protected void init() throws Exception(Code)
Initilizes the list, initializing contained filter form and the ListDataProvider and getting the initial item range.



initDataProvider
protected void initDataProvider() throws Exception(Code)



initFilterForm
protected void initFilterForm() throws Exception(Code)



initSequenceHelper
protected void initSequenceHelper()(Code)



isIgnoreCase
public boolean isIgnoreCase()(Code)
Returns whether new filters and orders are case insensitive.



isOrderableByDefault
public boolean isOrderableByDefault()(Code)
Returns true if all fields are added orderable by default. true if all fields are added orderable by default.



makeRequestIdToRowMapping
protected void makeRequestIdToRowMapping()(Code)
Creates mapping between rows and request ids.
since:
   1.1



order
protected void order(String fieldName) throws Exception(Code)
Handles single column ordering.



propagateListDataProviderWithOrderInfo
protected void propagateListDataProviderWithOrderInfo(OrderInfo orderInfo)(Code)



refresh
public void refresh()(Code)
Forces the list data provider to refresh the data.



refreshCurrentItemRange
public void refreshCurrentItemRange()(Code)
Refreshes the current item range, reloading the shown items.



resetSequence
public void resetSequence()(Code)
Resets the sequence, starting at first page with all defaults.



runInitEvents
protected void runInitEvents()(Code)



setCurrentPage
public void setCurrentPage(long currentPage)(Code)
Sets the page which will be displayed. Page index is 0-based.
Parameters:
  currentPage - index of the page.



setDataProvider
public void setDataProvider(ListDataProvider dataProvider)(Code)
Sets the ListDataProvider used to fill the list with data.
Parameters:
  dataProvider - the ListDataProviderused to fill the list with data.



setFilterButtonLabel
public void setFilterButtonLabel(String label)(Code)
Sets the filter button label.
Parameters:
  label - custom label Id.



setFilterHelper
public void setFilterHelper(FilterHelper filterHelper)(Code)
Sets the FilterHelper used to help with adding filters.
Parameters:
  filterHelper - FilterHelper used to help with adding filters.



setFilterInfo
public void setFilterInfo(Map filterInfo)(Code)
Sets the filter information to list data provider and filter form.
Parameters:
  filterInfo - Map containing filter information.



setFilterResetButtonLabel
public void setFilterResetButtonLabel(String label)(Code)
Sets the filter reset button label.
Parameters:
  label - custom label Id.



setForm
public void setForm(FormWidget form)(Code)
Saves the filter form.



setInitialOrder
public void setInitialOrder(String fieldId, boolean ascending)(Code)
Sets the initial order of the list.
Parameters:
  fieldId - the name of the column to order by.
Parameters:
  ascending - whether ordering should be ascending.



setItemsOnPage
public void setItemsOnPage(long itemsOnPage)(Code)
Sets how many items will be displayed on one page.
Parameters:
  itemsOnPage - how many items will be displayed on one page.



setListStructure
public void setListStructure(ListStructure listStructure)(Code)
Saves the ListStructure used to fill the list with data.



setOrderInfo
public void setOrderInfo(OrderInfo orderInfo)(Code)
Sets the order information to list data provider and list widget.
Parameters:
  orderInfo - OrderInfo containing order information.



setOrderableByDefault
public void setOrderableByDefault(boolean orderableByDefault)(Code)
Sets whether all fields are added orderable by default.
Parameters:
  orderableByDefault - whether all fields are added orderable bydefault.



setTypeHelper
public void setTypeHelper(TypeHelper typeHelper)(Code)
Sets the TypeHelper used to help with field types.
Parameters:
  typeHelper - TypeHelper used to help with field types.



showDefaultPages
public void showDefaultPages()(Code)
Collapses the list, showing only the current page.



showFullPages
public void showFullPages()(Code)
Expands the list showing all items.



Fields inherited from org.araneaframework.uilib.core.BaseUIWidget
protected String viewSelector(Code)(Java Doc)

Methods inherited from org.araneaframework.uilib.core.BaseUIWidget
public Component.Interface _getComponent()(Code)(Java Doc)
protected BeanFactory getBeanFactory()(Code)(Java Doc)
protected ConfigurationContext getConfiguration()(Code)(Java Doc)
protected FlowContext getFlowCtx()(Code)(Java Doc)
protected LocalizationContext getL10nCtx()(Code)(Java Doc)
protected MessageContext getMessageCtx()(Code)(Java Doc)
protected MountContext getMountCtx()(Code)(Java Doc)
protected OverlayContext getOverlayCtx()(Code)(Java Doc)
protected boolean isRunningInOverlay()(Code)(Java Doc)
protected void render(OutputData output) throws Exception(Code)(Java Doc)
protected String resolveJspName(JspContext jspCtx, String viewSelector)(Code)(Java Doc)
protected void setViewSelector(String viewSelector)(Code)(Java Doc)
protected String t(String key)(Code)(Java Doc)

Methods inherited from org.araneaframework.core.BaseApplicationWidget
public Composite.Interface _getComposite()(Code)(Java Doc)
public Viewable.Interface _getViewable()(Code)(Java Doc)
protected void action(Path path, InputData input, OutputData output) throws Exception(Code)(Java Doc)
public void addActionListener(Object actionId, ActionListener listener)(Code)(Java Doc)
public void addEventListener(Object eventId, EventListener listener)(Code)(Java Doc)
public void addWidget(Object key, Widget child, Environment env)(Code)(Java Doc)
public void addWidget(Object key, Widget child)(Code)(Java Doc)
public void clearActionListeners(Object actionId)(Code)(Java Doc)
public void clearEventlisteners(Object eventId)(Code)(Java Doc)
public void clearGlobalEventListener()(Code)(Java Doc)
public void disableWidget(Object key)(Code)(Java Doc)
public void enableWidget(Object key)(Code)(Java Doc)
protected void event(Path path, InputData input) throws Exception(Code)(Java Doc)
protected Object getActionId(InputData input)(Code)(Java Doc)
final public Environment getChildEnvironment()(Code)(Java Doc)
protected Environment getChildWidgetEnvironment() throws Exception(Code)(Java Doc)
public Map getChildren()(Code)(Java Doc)
public Environment getEnvironment()(Code)(Java Doc)
protected String getEventId(InputData input)(Code)(Java Doc)
public Object getViewModel() throws Exception(Code)(Java Doc)
public Widget getWidget(Object key)(Code)(Java Doc)
protected void handleAction(InputData input, OutputData output) throws Exception(Code)(Java Doc)
protected void handleEvent(InputData input) throws Exception(Code)(Java Doc)
protected void handleUpdate(InputData input) throws Exception(Code)(Java Doc)
protected void propagate(Message message) throws Exception(Code)(Java Doc)
public void putViewData(String key, Object customDataItem)(Code)(Java Doc)
public void putViewDataOnce(String key, Object customDataItem)(Code)(Java Doc)
public void removeActionListener(ActionListener listener)(Code)(Java Doc)
public void removeEventListener(EventListener listener)(Code)(Java Doc)
public void removeViewData(String key)(Code)(Java Doc)
public void removeWidget(Object key)(Code)(Java Doc)
protected void render(OutputData output) throws Exception(Code)(Java Doc)
public void setGlobalEventListener(EventListener eventListener)(Code)(Java Doc)
protected void update(InputData input) throws Exception(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.