Java Doc for ScarabRequestTool.java in  » Issue-Tracking » scarab-0.21 » org » tigris » scarab » tools » 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 » Issue Tracking » scarab 0.21 » org.tigris.scarab.tools 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   org.tigris.scarab.tools.ScarabRequestTool

ScarabRequestTool
public class ScarabRequestTool implements ApplicationTool,Recyclable(Code)
This class is used by the Scarab API

Inner Class :public class IssueListIterator implements Iterator

Field Summary
 MapattributeTypes
    
 intinitialIssueListColumnsSize
    
 ListissueListColumns
    

Constructor Summary
public  ScarabRequestTool()
    

Method Summary
public  StringconvertPath(String path)
     Convert paths with slashes to commas.
public static  MITListItemconvertToMITListItem(RModuleIssueType rmit)
     Create a MITListItem from an RModuleIssueType instance.
public  voiddispose()
     Disposes the object after use.
public  StringformatDate(String value)
     Format a date from internal timestamp value to the user's locale format.
public  intgetAdjustedPageNum()
     Checks for a query parameter "oldResultsPerPage" and compares it to the current "resultsPerPage" parameter.
public  ObjectgetAlert()
     Retrieves any Alert! message which has been set.
public  ObjectgetAlertMessage()
     Get any alert message usually set in the action.
public  ListgetAllIssueTemplates(IssueType issueType)
     Returns all issue templates that are global, Plus those that are personal and created by logged-in user.
public  ListgetAllQueries()
     Returns all queries that are global, Plus those that are personal and created by logged-in user.
public  ListgetAllValidIssueListAttributes()
    
public  AttachmentgetAttachment()
     A Attachment object for use within the Scarab API.
public  AttributegetAttribute()
    
public  AttributegetAttribute(Integer pk)
     A Attribute object for use within the Scarab API.
public  AttributeGroupgetAttributeGroup()
     A AttributeGroup object for use within the Scarab API.
public  AttributeGroupgetAttributeGroup(String key)
     Get a AttributeGroup object.
public  AttributeOptiongetAttributeOption()
     A Attribute object for use within the Scarab API.
public  AttributeOptiongetAttributeOption(Integer pk)
     A Attribute object for use within the Scarab API.
public  AttributeOptiongetAttributeOption(String key)
    
public  ListgetAttributeSearchResults()
     Return results of attribute search.
public  StringgetAttributeType(int key)
     Retrieves an attribute type from request scope.
public  CalendargetCalendar()
     This is used to get the format for a date in the Locale sent by the browser.
public  IntakegetConditionalIntake(String parameter)
    
public  ObjectgetConfirmMessage()
     Get any confirmation message usually set in the action.
public  IssueTypegetCurrentIssueType()
     Gets the IssueType associated with the information passed around in the query string.
public  ModulegetCurrentModule()
     Gets the Module associated with the information passed around in the query string.
public  IteratorWithSizegetCurrentSearchResults()
     Performs search on current query (which is stored in user session).
public  intgetCurrentSearchResultsSize()
     Gets the number of results for the current query.
public  StringgetCurrentTemplate()
    
public  ScarabUsergetCurrentUser()
     retrieves the user from the current request.
public  DateFormatgetDateFormat()
     This is used to get the format for a date in the Locale sent by the browser.
public  DependgetDepend()
     A Depend object for use within the Scarab API.
public  StringgetEditLink(String link, Query query)
     Generates link to the Query Detail page.
public  StringgetExecuteLink(String link, Query query)
     Generates link to Issue List page, re-running stored query.
public  ListgetFrequencies()
     Get all frequencies.
public  ListgetGlobalQueries()
     Returns all queries that are global.
public  ListgetGlobalQueries(Module module)
    
public  ListgetGlobalTemplates(IssueType issueType)
     Returns templates that are personal and created by logged-in user.
public  ListgetGlobalUserSearch()
     When a user searches for other users (in the ManageUserSearch.vm template for example), the result of this search is stored into the temporary data for that user.
public  StringgetGlobalUserSearchParam(String name)
     Return the parameter used for the user-search (like in the ManageUserSearch.vm template for example) returned by the getGlobalUserSearch() method.
public  ObjectgetInfoMessage()
     Get any informational message usually set in the action.
public  IssuegetIssue()
     Get an Issue object from unique id given either as an intake field or a request parameter keyed with "id".
public  IssuegetIssue(String id)
     Takes unique id and returns issue.
public  IssuegetIssueByPk(String key)
     The id may only be the issue's primary key.
public  IssuegetIssueIncludingDeleted(String id)
     Returns an issue given its ID, even if it's been deleted or moved.
public  ListgetIssueListAttributes(boolean validOnly, boolean commonOnly)
    
public  IssueListIteratorgetIssueListIterator(IteratorWithSize iterator, int listOffset, int size)
    
public  intgetIssuePosInList()
     Returns the issue's position (1-based) in current issue list.
public  IssuegetIssueTemplate()
     An Enter issue template.
public  IssuegetIssueTemplate(String templateId)
     An Enter issue template.
public  IssueTemplateInfogetIssueTemplateInfo()
     A IssueTemplateInfo object for use within the Scarab API.
public  IssueTypegetIssueType(String key)
     Get a specific issue type by key value.
public  IssueTypegetIssueType()
     Get an issue type object.
public  ListgetIssues()
     Get a list of Issue objects.
public  ListgetIssues(List issueIds)
     Get a list of Issue objects from a list of issue IDs.
public  ObjectgetLastEnteredIssueTypeOrTemplate()
    
public  MITListgetMITList(List issues)
    
public  ModulegetModule()
     Get an Module object.
public  ModulegetModule(String key)
     Get a specific module by key value.
public  intgetNbrPages()
     Return the number of paginated pages.
public  AttributeValuegetNewAttributeValue(Attribute attribute, Issue issue)
    
public  IssueSearchgetNewSearch()
     Get a new IssueSearch object.
public  StringgetNextEntryTemplate(IssueType issueType)
     Looks at the current RModuleIssueType and if it is null, returns the users home page.
public  StringgetNextIssue()
     Returns next issue id in list.
public  intgetNextPage()
     Return the next page in the paginated list.
public  ScarabPaginatedListgetPaginatedGlobalUsersList(int pageNum, int resultsPerPage, String searchField, String searchCriteria, String sortColumn, String sortPolarity)
    
public  IteratorWithSizegetPaginatedIterator(IteratorWithSize fullList, int pgNbr, int nbrItmsPerPage)
     Return a subset of the passed-in list.
public  ListgetPaginatedList(List fullList, int pgNbr, int nbrItmsPerPage)
     Return a subset of the passed-in list.
public  ParentChildAttributeOptiongetParentChildAttributeOption()
     Gets an instance of a ParentChildAttributeOption from this tool.
public  IssueSearchgetPopulatedSearch(String query)
     Get an IssueSearch object based on a query string.
public  IssueSearchgetPopulatedSearch()
     Get an IssueSearch object based on current query string.
public  StringgetPrevIssue()
     Returns previous issue id in list.
public  intgetPrevPage()
     Return the previous page in the paginated list.
public  ListgetPrivateQueries()
     Returns queries that are personal and created by logged-in user.
public  ListgetPrivateTemplates(IssueType issueType)
     Returns templates that are personal and created by logged-in user.
public  QuerygetQuery()
     A Query object for use within the Scarab API.
public  RModuleAttributegetRModuleAttribute()
     Get an RModuleAttribute object.
public  RModuleIssueTypegetRModuleIssueType(Integer moduleId, Integer issueTypeId)
    
public  ListgetRModuleUserAttributes()
     First attempts to get the RModuleUserAttributes from the user.
public  ROptionOptiongetROptionOption()
     Gets an instance of a ROptionOption from this tool.
public  ReportBridgegetReport()
    
public  IssuegetReportingIssue()
     The issue that is currently being entered.
public  ListgetScopes()
     Get all scopes.
public  ObjectgetSessionAttribute(String key)
     retrieve an attribute value from the current HttpSession.
public  ListgetSortedAttributeOptions()
    
public  ListgetSortedAttributeOptionsForRMIT(RModuleIssueType rmit)
     Returned all attribute options allowed for every attribute assigned to this RModuleIssueType.
public  TransitiongetTransition(Integer pk)
    
public  ListgetTransitionMatrix(IssueType issueType, Attribute attribute)
     Returns the list of transitions allowed for the current user in the current module/issueType/attribute combination as a displayable matrix organized in rows and columns. The returned list contains the matrix rows. Each row contains a set of OptionValues and OptionConnectors. An OptionConnector is a hint for a graphical representation and can be one of:
  • SINGLE or "---"
  • FIRST or "-+-"
  • INTERMEDIATE or " |-"
  • LAST or " +-"
  • PASSTHROUGH or " | "
A matrix-The may contain null pointers if there is neither an OptionValue nor an OptionConnector associated to the cell.
public  ListgetTransitions(IssueType issueType, Attribute attribute)
    
public  ScarabUsergetUser()
     A User object for use within the Scarab API.
public  ScarabUsergetUser(Object id)
     Return a specific User by ID from within the system.
public  ListgetUserAllQueries()
     Returns all queries that are global.
public  ListgetUserAttributes(List issues, boolean activeOnly)
     Gets a list of Attributes or the user type that are in common between the issues in the given list.
public  ScarabUsergetUserByUserName(String username)
     Return a specific User by username.
public  ScarabPaginatedListgetUserFilteredSearchResults(MITList mitList, int pageNum, int resultsPerPage, String sortColumn, String sortPolarity, boolean includeCommitters)
     Full featured, paginated, sorted version for returning results of a user search.
public  ListgetUserQueries()
     Returns queries that are personal and created by logged-in user.
public  ScarabPaginatedListgetUserSearchResults(MITList mitList, int pageNum, int resultsPerPage, String sortColumn, String sortPolarity, boolean includeCommitters)
     Full featured, paginated, sorted method for returning the results of user search.
public  ListgetValidIssueListAttributes()
    
public  booleanhasItemsToApprove()
    
public  booleanhasPermission(String permission)
     Determine if the user currently interacting with the scarab application has a permission within the user's currently selected module.
Parameters:
  permission - a String permission value, which shouldbe a constant in this interface.
public  booleanhasPermission(String permission, Module module)
     Determine if the user currently interacting with the scarab application has a permission within a module.
public  booleanhasSessionAttribute(String key)
     Check whether the current session has an attribute of given key.
public  voidinit(Object data)
    
public  booleanisAnonymousLoginAllowed()
     Returns if the system is configurated to allow anonymous login.
public  booleanisDisposed()
     Checks whether the object is disposed.
public  IntakeparseQuery(String query)
     Parses query into intake values.
public  voidrecycle()
     Recycles the object by removing its disposed flag.
public  voidrefresh()
    
public  StringreportTimer(String mesg)
     Useful when performance tuning.
public  voidresetAssociatedUsers()
    
public  voidresetSelectedUsers()
    
public  voidsetAlert(Object message)
     Sets the Alert! message for this request.
public  voidsetAlertMessage(Object v)
     Set alert message.
public  voidsetAlertMessage(Localizable localizable)
     Set alert message using Localizable localizable.
public  voidsetAttachment(Attachment attachment)
    
public  voidsetAttribute(Attribute attribute)
     A Attribute object for use within the Scarab API.
public  voidsetAttributeOption(AttributeOption option)
     A Attribute object for use within the Scarab API.
public  voidsetAttributeType(int key, String type)
     Stores in the request scope a type.
public  voidsetConfirmMessage(Object v)
     Set confirmation message.
public  voidsetConfirmMessage(Localizable localizable)
     Set confirm message using Localizable localizable.
public  voidsetCurrentIssueType(IssueType type)
    
public  voidsetCurrentModule(Module me)
    
public  voidsetDepend(Depend depend)
     A Depend object for use within the Scarab API.
public  voidsetGlobalUserSearch(List users)
     Store the search result of other users for later use.
public  voidsetGlobalUserSearchParam(String name, String value)
     Set the parameters used to retrieved the users in the List given to the setGlobalUserSearch(List) method.
public  voidsetInfoMessage(Object v)
     Set informational message.
public  voidsetInfoMessage(Localizable localizable)
     Set alert message using Localizable localizable.
public  voidsetIssue(Issue issue)
     A Issue object for use within the Scarab API.
public  voidsetIssueTemplateInfo(IssueTemplateInfo templateInfo)
     A IssueTemplateInfo object for use within the Scarab API.
public  voidsetIssueType(IssueType issuetype)
     A IssueType object for use within the Scarab API.
public  voidsetModule(Module module)
     A Module object for use within the Scarab API.
public  voidsetParentChildAttributeOption(ParentChildAttributeOption roo)
    
public  voidsetQuery(Query query)
     A Query object for use within the Scarab API.
public  voidsetROptionOption(ROptionOption roo)
    
public  voidsetReport(ReportBridge report)
    
public  voidsetReportingIssue(Issue issue)
    
public  booleansetSessionAttribute(String key, Object value)
     Place an attribute value into the current HttpSession.
public  voidsetUser(ScarabUser user)
     A User object for use within the Scarab API, generally not the user who is logged in.
public  ListsortAttributes(List attList)
     Sort attributes on name or description.
public  ListsortUsers(List userList)
     Sort users on name or email.
public  voidstartTimer()
     Should be called near the beginning of a template or wherever timing should start.

Field Detail
attributeTypes
Map attributeTypes(Code)



initialIssueListColumnsSize
int initialIssueListColumnsSize(Code)
keep track if the columns were reduced to avoid db limits



issueListColumns
List issueListColumns(Code)
cache list so that we always return the same object for all invocations within a single request




Constructor Detail
ScarabRequestTool
public ScarabRequestTool()(Code)
Constructor does initialization stuff




Method Detail
convertPath
public String convertPath(String path) throws Exception(Code)
Convert paths with slashes to commas.



convertToMITListItem
public static MITListItem convertToMITListItem(RModuleIssueType rmit) throws TorqueException(Code)
Create a MITListItem from an RModuleIssueType instance.
Parameters:
  rmits -
throws:
  TorqueException -



dispose
public void dispose()(Code)
Disposes the object after use. The method is called when the object is returned to its pool. The dispose method must call its super.



formatDate
public String formatDate(String value)(Code)
Format a date from internal timestamp value to the user's locale format.
Parameters:
  value -



getAdjustedPageNum
public int getAdjustedPageNum()(Code)
Checks for a query parameter "oldResultsPerPage" and compares it to the current "resultsPerPage" parameter. If they are different, it returns 1 to avoid returning a value larger than the maximum number of pages; otherwise it returns the value of the query parameter "pageNum". Preferable optimization would be to adjust the page number to keep a set of the old displayed items on the new page.



getAlert
public Object getAlert()(Code)
Retrieves any Alert! message which has been set. The alert message.



getAlertMessage
public Object getAlertMessage()(Code)
Get any alert message usually set in the action. value of alertMessage.



getAllIssueTemplates
public List getAllIssueTemplates(IssueType issueType) throws Exception(Code)
Returns all issue templates that are global, Plus those that are personal and created by logged-in user.



getAllQueries
public List getAllQueries() throws Exception(Code)
Returns all queries that are global, Plus those that are personal and created by logged-in user.



getAllValidIssueListAttributes
public List getAllValidIssueListAttributes()(Code)



getAttachment
public Attachment getAttachment() throws Exception(Code)
A Attachment object for use within the Scarab API.



getAttribute
public Attribute getAttribute() throws Exception(Code)
An org.tigris.scarab.om.Attribute object(possibly "blank", but never null).



getAttribute
public Attribute getAttribute(Integer pk) throws Exception(Code)
A Attribute object for use within the Scarab API.



getAttributeGroup
public AttributeGroup getAttributeGroup() throws Exception(Code)
A AttributeGroup object for use within the Scarab API.



getAttributeGroup
public AttributeGroup getAttributeGroup(String key)(Code)
Get a AttributeGroup object.



getAttributeOption
public AttributeOption getAttributeOption() throws Exception(Code)
A Attribute object for use within the Scarab API.



getAttributeOption
public AttributeOption getAttributeOption(Integer pk) throws Exception(Code)
A Attribute object for use within the Scarab API.



getAttributeOption
public AttributeOption getAttributeOption(String key) throws Exception(Code)



getAttributeSearchResults
public List getAttributeSearchResults() throws Exception(Code)
Return results of attribute search.



getAttributeType
public String getAttributeType(int key)(Code)
Retrieves an attribute type from request scope. USed in IssueList.vm
Parameters:
  key -



getCalendar
public Calendar getCalendar()(Code)
This is used to get the format for a date in the Locale sent by the browser.



getConditionalIntake
public Intake getConditionalIntake(String parameter) throws Exception(Code)



getConfirmMessage
public Object getConfirmMessage()(Code)
Get any confirmation message usually set in the action. value of confirmMessage.



getCurrentIssueType
public IssueType getCurrentIssueType() throws Exception(Code)
Gets the IssueType associated with the information passed around in the query string.



getCurrentModule
public Module getCurrentModule()(Code)
Gets the Module associated with the information passed around in the query string. Returns null if the Module could not be found.



getCurrentSearchResults
public IteratorWithSize getCurrentSearchResults()(Code)
Performs search on current query (which is stored in user session).



getCurrentSearchResultsSize
public int getCurrentSearchResultsSize()(Code)
Gets the number of results for the current query. Looks first at the URL, then re-queries if size information is missing.



getCurrentTemplate
public String getCurrentTemplate()(Code)
Returns name of current template



getCurrentUser
public ScarabUser getCurrentUser()(Code)
retrieves the user from the current request. If the current request has no explicit user in it's data section, retrieve the current user from the current session.



getDateFormat
public DateFormat getDateFormat()(Code)
This is used to get the format for a date in the Locale sent by the browser.



getDepend
public Depend getDepend() throws Exception(Code)
A Depend object for use within the Scarab API.



getEditLink
public String getEditLink(String link, Query query)(Code)
Generates link to the Query Detail page.



getExecuteLink
public String getExecuteLink(String link, Query query)(Code)
Generates link to Issue List page, re-running stored query.



getFrequencies
public List getFrequencies() throws Exception(Code)
Get all frequencies.



getGlobalQueries
public List getGlobalQueries() throws Exception(Code)
Returns all queries that are global.



getGlobalQueries
public List getGlobalQueries(Module module) throws Exception(Code)
Returns all queries global for the module



getGlobalTemplates
public List getGlobalTemplates(IssueType issueType) throws Exception(Code)
Returns templates that are personal and created by logged-in user.



getGlobalUserSearch
public List getGlobalUserSearch()(Code)
When a user searches for other users (in the ManageUserSearch.vm template for example), the result of this search is stored into the temporary data for that user. This previous result can be retrieved by this method. FIXME: shouldn't this be stored into the cache instead of the temporary data of the user? The list of users of the last user-search.



getGlobalUserSearchParam
public String getGlobalUserSearchParam(String name)(Code)
Return the parameter used for the user-search (like in the ManageUserSearch.vm template for example) returned by the getGlobalUserSearch() method. These parameters are stored into the temporary data of the current user. FIXME: use the cache instead?
Parameters:
  name - The name of the parameter The value of the parameter used in the search for users.



getInfoMessage
public Object getInfoMessage()(Code)
Get any informational message usually set in the action. value of infoMessage.



getIssue
public Issue getIssue() throws Exception(Code)
Get an Issue object from unique id given either as an intake field or a request parameter keyed with "id". a Issue value



getIssue
public Issue getIssue(String id)(Code)
Takes unique id and returns issue.
Parameters:
  id -



getIssueByPk
public Issue getIssueByPk(String key)(Code)
The id may only be the issue's primary key.
Parameters:
  key - a String value a Issue value



getIssueIncludingDeleted
public Issue getIssueIncludingDeleted(String id)(Code)
Returns an issue given its ID, even if it's been deleted or moved.
Parameters:
  id -



getIssueListAttributes
public List getIssueListAttributes(boolean validOnly, boolean commonOnly)(Code)



getIssueListIterator
public IssueListIterator getIssueListIterator(IteratorWithSize iterator, int listOffset, int size)(Code)



getIssuePosInList
public int getIssuePosInList() throws Exception, ScarabException(Code)
Returns the issue's position (1-based) in current issue list.



getIssueTemplate
public Issue getIssueTemplate() throws Exception(Code)
An Enter issue template.



getIssueTemplate
public Issue getIssueTemplate(String templateId) throws Exception(Code)
An Enter issue template.



getIssueTemplateInfo
public IssueTemplateInfo getIssueTemplateInfo() throws Exception(Code)
A IssueTemplateInfo object for use within the Scarab API.



getIssueType
public IssueType getIssueType(String key)(Code)
Get a specific issue type by key value. Returns null if the Issue Type could not be found
Parameters:
  key - a String value a IssueType value



getIssueType
public IssueType getIssueType() throws Exception(Code)
Get an issue type object.



getIssues
public List getIssues() throws Exception(Code)
Get a list of Issue objects. a Issue value



getIssues
public List getIssues(List issueIds) throws Exception(Code)
Get a list of Issue objects from a list of issue IDs. The list can contain Strings or Integers, but all IDs must be of the same type (String or Integer).
Parameters:
  issueIds - a List value a List value
exception:
  Exception - if an error occurs



getLastEnteredIssueTypeOrTemplate
public Object getLastEnteredIssueTypeOrTemplate() throws Exception(Code)
an IssueType which may represent a template



getMITList
public MITList getMITList(List issues) throws Exception(Code)



getModule
public Module getModule() throws Exception(Code)
Get an Module object. a Module value



getModule
public Module getModule(String key)(Code)
Get a specific module by key value. Returns null if the Module could not be found
Parameters:
  key - a String value a Module value



getNbrPages
public int getNbrPages()(Code)
Return the number of paginated pages.



getNewAttributeValue
public AttributeValue getNewAttributeValue(Attribute attribute, Issue issue) throws Exception(Code)
Gets a new instance of AttributeValue



getNewSearch
public IssueSearch getNewSearch() throws Exception, MaxConcurrentSearchException(Code)
Get a new IssueSearch object. a Issue value



getNextEntryTemplate
public String getNextEntryTemplate(IssueType issueType)(Code)
Looks at the current RModuleIssueType and if it is null, returns the users home page. If it is not null, and is dedupe, returns Wizard1...else Wizard3.



getNextIssue
public String getNextIssue() throws Exception, ScarabException(Code)
Returns next issue id in list.



getNextPage
public int getNextPage()(Code)
Return the next page in the paginated list.



getPaginatedGlobalUsersList
public ScarabPaginatedList getPaginatedGlobalUsersList(int pageNum, int resultsPerPage, String searchField, String searchCriteria, String sortColumn, String sortPolarity) throws Exception(Code)



getPaginatedIterator
public IteratorWithSize getPaginatedIterator(IteratorWithSize fullList, int pgNbr, int nbrItmsPerPage)(Code)
Return a subset of the passed-in list.
Parameters:
  nbrItmsPerPage - negative value returns full list



getPaginatedList
public List getPaginatedList(List fullList, int pgNbr, int nbrItmsPerPage)(Code)
Return a subset of the passed-in list.
Parameters:
  nbrItmsPerPage - negative value returns full list



getParentChildAttributeOption
public ParentChildAttributeOption getParentChildAttributeOption()(Code)
Gets an instance of a ParentChildAttributeOption from this tool. if it is null it will return a new instance of an empty ParentChildAttributeOption and set it within this tool.



getPopulatedSearch
public IssueSearch getPopulatedSearch(String query) throws Exception(Code)
Get an IssueSearch object based on a query string. a Issue value



getPopulatedSearch
public IssueSearch getPopulatedSearch() throws Exception(Code)
Get an IssueSearch object based on current query string. a Issue value



getPrevIssue
public String getPrevIssue() throws Exception, ScarabException(Code)
Returns previous issue id in list.



getPrevPage
public int getPrevPage()(Code)
Return the previous page in the paginated list.



getPrivateQueries
public List getPrivateQueries() throws Exception(Code)
Returns queries that are personal and created by logged-in user.



getPrivateTemplates
public List getPrivateTemplates(IssueType issueType) throws Exception(Code)
Returns templates that are personal and created by logged-in user.



getQuery
public Query getQuery() throws Exception(Code)
A Query object for use within the Scarab API.



getRModuleAttribute
public RModuleAttribute getRModuleAttribute() throws Exception(Code)
Get an RModuleAttribute object. a Module value



getRModuleIssueType
public RModuleIssueType getRModuleIssueType(Integer moduleId, Integer issueTypeId) throws Exception(Code)



getRModuleUserAttributes
public List getRModuleUserAttributes()(Code)
First attempts to get the RModuleUserAttributes from the user. If it is empty, then it will try to get the defaults from the module. If anything fails, it will return an empty list.



getROptionOption
public ROptionOption getROptionOption()(Code)
Gets an instance of a ROptionOption from this tool. if it is null it will return a new instance of an empty ROptionOption and set it within this tool.



getReport
public ReportBridge getReport() throws Exception(Code)
a report helper class



getReportingIssue
public Issue getReportingIssue() throws Exception(Code)
The issue that is currently being entered. an Issue value



getScopes
public List getScopes() throws Exception(Code)
Get all scopes.



getSessionAttribute
public Object getSessionAttribute(String key) throws ScarabException(Code)
retrieve an attribute value from the current HttpSession. Throws a ScarabException, if no HttpSession is available. Returns empty String ("") if the Attribute is not available;
Parameters:
  key -
throws:
  ScarabException -



getSortedAttributeOptions
public List getSortedAttributeOptions() throws TorqueException(Code)



getSortedAttributeOptionsForRMIT
public List getSortedAttributeOptionsForRMIT(RModuleIssueType rmit) throws Exception(Code)
Returned all attribute options allowed for every attribute assigned to this RModuleIssueType.
Parameters:
  rmit - List with all the attribute options of every attribute.
throws:
  Exception -



getTransition
public Transition getTransition(Integer pk)(Code)



getTransitionMatrix
public List getTransitionMatrix(IssueType issueType, Attribute attribute) throws ScarabException(Code)
Returns the list of transitions allowed for the current user in the current module/issueType/attribute combination as a displayable matrix organized in rows and columns. The returned list contains the matrix rows. Each row contains a set of OptionValues and OptionConnectors. An OptionConnector is a hint for a graphical representation and can be one of:
  • SINGLE or "---"
  • FIRST or "-+-"
  • INTERMEDIATE or " |-"
  • LAST or " +-"
  • PASSTHROUGH or " | "
A matrix-The may contain null pointers if there is neither an OptionValue nor an OptionConnector associated to the cell. This can be seen best in an example (V* denotes OptionValues):

 [V1][---][V2][-+-][V3][-+-][V4]
 [  ][   ][  ][ | ][  ][ |-][V5]
 [  ][   ][  ][ | ][  ][ +-][V6]
 [  ][   ][  ][ +-][V7][   ][  ]
 

If you remove the [] brackets, you should get the idea immediately:

 V1---V2-+-V3-+-V4
 |    |-V5
 |    +-V6
 +-V7     
 


throws:
  TorqueException -



getTransitions
public List getTransitions(IssueType issueType, Attribute attribute) throws ScarabException(Code)
Returns the list of transitions allowed for the current user in the current module/issueType/attribute combination
throws:
  TorqueException -



getUser
public ScarabUser getUser()(Code)
A User object for use within the Scarab API. This is the result of whatever was set with setUser() (generally not the user who is logged in). It can return null if setUser() has not been previously called. If you would like to get the currently logged in User, retrieve that from the data.getUser() method. A user used during this request.



getUser
public ScarabUser getUser(Object id) throws Exception(Code)
Return a specific User by ID from within the system. You can pass in either a Integer or something that will resolve to a String object as id.toString() is called on everything that isn't a Integer.



getUserAllQueries
public List getUserAllQueries() throws Exception(Code)
Returns all queries that are global.



getUserAttributes
public List getUserAttributes(List issues, boolean activeOnly) throws Exception(Code)
Gets a list of Attributes or the user type that are in common between the issues in the given list.
Parameters:
  issues - a List value a List value
exception:
  Exception - if an error occurs



getUserByUserName
public ScarabUser getUserByUserName(String username) throws Exception(Code)
Return a specific User by username.



getUserFilteredSearchResults
public ScarabPaginatedList getUserFilteredSearchResults(MITList mitList, int pageNum, int resultsPerPage, String sortColumn, String sortPolarity, boolean includeCommitters) throws Exception(Code)
Full featured, paginated, sorted version for returning results of a user search.



getUserQueries
public List getUserQueries() throws Exception(Code)
Returns queries that are personal and created by logged-in user.



getUserSearchResults
public ScarabPaginatedList getUserSearchResults(MITList mitList, int pageNum, int resultsPerPage, String sortColumn, String sortPolarity, boolean includeCommitters) throws Exception(Code)
Full featured, paginated, sorted method for returning the results of user search. Returns all users (no search criteria).



getValidIssueListAttributes
public List getValidIssueListAttributes()(Code)



hasItemsToApprove
public boolean hasItemsToApprove()(Code)



hasPermission
public boolean hasPermission(String permission)(Code)
Determine if the user currently interacting with the scarab application has a permission within the user's currently selected module.
Parameters:
  permission - a String permission value, which shouldbe a constant in this interface. true if the permission exists for the user within thecurrent module, false otherwise



hasPermission
public boolean hasPermission(String permission, Module module)(Code)
Determine if the user currently interacting with the scarab application has a permission within a module.
Parameters:
  permission - a String permission value, which shouldbe a constant in this interface.
Parameters:
  module - a Module value true if the permission exists for the user within thegiven module, false otherwise



hasSessionAttribute
public boolean hasSessionAttribute(String key) throws ScarabException(Code)
Check whether the current session has an attribute of given key. If there is no active session available, throw a scarabException. returns true, if attribute exists, otherwise returns false.



init
public void init(Object data)(Code)
This method expects to get a RunData object



isAnonymousLoginAllowed
public boolean isAnonymousLoginAllowed()(Code)
Returns if the system is configurated to allow anonymous login.



isDisposed
public boolean isDisposed()(Code)
Checks whether the object is disposed. true, if the object is disposed.



parseQuery
public Intake parseQuery(String query) throws Exception(Code)
Parses query into intake values.



recycle
public void recycle()(Code)
Recycles the object by removing its disposed flag.



refresh
public void refresh()(Code)
nulls out the issue and user objects



reportTimer
public String reportTimer(String mesg)(Code)
Useful when performance tuning. Usage is to call

 $scarabR.startTimer()
 ...
 $scarabR.reportTimer("foo")
 ...
 $scarabR.reportTimer("bar")
 or
 $scarabG.log($scarabR.reportTimer("bar"))
 
The labels are useful when output is directed to a log file, it can be "", if the output is written as part of the response.



resetAssociatedUsers
public void resetAssociatedUsers() throws Exception(Code)



resetSelectedUsers
public void resetSelectedUsers() throws Exception(Code)



setAlert
public void setAlert(Object message)(Code)
Sets the Alert! message for this request.
Parameters:
  message - The alert message to set.



setAlertMessage
public void setAlertMessage(Object v)(Code)
Set alert message.
Parameters:
  v - Value to assign to alertMessage.



setAlertMessage
public void setAlertMessage(Localizable localizable)(Code)
Set alert message using Localizable localizable.
Parameters:
  v - Value to assign to alertMessage.



setAttachment
public void setAttachment(Attachment attachment)(Code)
A Attachment object for use within the Scarab API



setAttribute
public void setAttribute(Attribute attribute)(Code)
A Attribute object for use within the Scarab API.



setAttributeOption
public void setAttributeOption(AttributeOption option)(Code)
A Attribute object for use within the Scarab API.



setAttributeType
public void setAttributeType(int key, String type)(Code)
Stores in the request scope a type. Used in IssueList.vm
Parameters:
  key -
Parameters:
  type -



setConfirmMessage
public void setConfirmMessage(Object v)(Code)
Set confirmation message.
Parameters:
  v - Value to assign to confirmMessage.



setConfirmMessage
public void setConfirmMessage(Localizable localizable)(Code)
Set confirm message using Localizable localizable.
Parameters:
  v - Value to assign to alertMessage.



setCurrentIssueType
public void setCurrentIssueType(IssueType type)(Code)



setCurrentModule
public void setCurrentModule(Module me)(Code)
Sets the current Module



setDepend
public void setDepend(Depend depend)(Code)
A Depend object for use within the Scarab API.



setGlobalUserSearch
public void setGlobalUserSearch(List users)(Code)
Store the search result of other users for later use. The result is stored into the temporary data of the current user. FIXME: use the cache instead?
Parameters:
  users - The list of users that is a result of a query.



setGlobalUserSearchParam
public void setGlobalUserSearchParam(String name, String value)(Code)
Set the parameters used to retrieved the users in the List given to the setGlobalUserSearch(List) method. These parameters can be retrieved by the getGlobalUserSearchParam(String) for later use. FIXME: use the cache instead?
Parameters:
  name - The name of the parameter
Parameters:
  value - The value of the parameter



setInfoMessage
public void setInfoMessage(Object v)(Code)
Set informational message.
Parameters:
  v - Value to assign to infoMessage.



setInfoMessage
public void setInfoMessage(Localizable localizable)(Code)
Set alert message using Localizable localizable.
Parameters:
  v - Value to assign to alertMessage.



setIssue
public void setIssue(Issue issue)(Code)
A Issue object for use within the Scarab API.



setIssueTemplateInfo
public void setIssueTemplateInfo(IssueTemplateInfo templateInfo)(Code)
A IssueTemplateInfo object for use within the Scarab API.



setIssueType
public void setIssueType(IssueType issuetype)(Code)
A IssueType object for use within the Scarab API.



setModule
public void setModule(Module module)(Code)
A Module object for use within the Scarab API.



setParentChildAttributeOption
public void setParentChildAttributeOption(ParentChildAttributeOption roo)(Code)
Sets an instance of a ParentChildAttributeOption



setQuery
public void setQuery(Query query)(Code)
A Query object for use within the Scarab API.



setROptionOption
public void setROptionOption(ROptionOption roo)(Code)
Sets an instance of a ROptionOption



setReport
public void setReport(ReportBridge report)(Code)



setReportingIssue
public void setReportingIssue(Issue issue)(Code)



setSessionAttribute
public boolean setSessionAttribute(String key, Object value) throws ScarabException(Code)
Place an attribute value into the current HttpSession. Throws a ScarabException, if no HttpSession is available.
Parameters:
  key -
Parameters:
  value -
throws:
  ScarabException -



setUser
public void setUser(ScarabUser user)(Code)
A User object for use within the Scarab API, generally not the user who is logged in.



sortAttributes
public List sortAttributes(List attList) throws Exception(Code)
Sort attributes on name or description.



sortUsers
public List sortUsers(List userList) throws Exception(Code)
Sort users on name or email.



startTimer
public void startTimer()(Code)
Should be called near the beginning of a template or wherever timing should start.



Methods inherited from java.lang.Object
native protected Object clone() throws CloneNotSupportedException(Code)(Java Doc)
public boolean equals(Object obj)(Code)(Java Doc)
protected void finalize() throws Throwable(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(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.