|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.velocity.tools.struts.MessageResourcesTool org.apache.velocity.tools.struts.ActionMessagesTool
@DefaultKey(value="messages") @ValidScope(value="request") public class ActionMessagesTool
This tool deals with Struts action messages. A few important aspects about action messages are:
property
that describes the category of
message. This allows the view designer to place action messages precisely where they are
wanted. Several methods of this tool provide a parameter
property
that allows to select a specific category of messages to operate
on. Without the property
parameter, methods operate on all action messages.See the Struts User's Guide, section Building View Components for more information on this topic.
Template example(s): #if( $messages.exist() ) #foreach( $e in $messages.all ) $e <br> #end #end Toolbox configuration: <tools> <toolbox scope="request"> <tool class="org.apache.velocity.tools.struts.ActionMessagesTool"/> </toolbox> </tools>
This tool should only be used in the request scope.
Field Summary | |
---|---|
protected org.apache.struts.action.ActionMessages |
actionMsgs
A reference to the queued action messages. |
Fields inherited from class org.apache.velocity.tools.struts.MessageResourcesTool |
---|
application, LOG, request |
Constructor Summary | |
---|---|
ActionMessagesTool()
|
Method Summary | |
---|---|
boolean |
exist()
Returns true if there are action messages queued,
otherwise false . |
boolean |
exist(java.lang.String property)
Returns true if there are action messages queued for the specified category of messages, otherwise false . |
java.util.List |
get(java.lang.String property)
Returns the set of localized action messages as an java.util.List of strings for all actionMsgs
queued of the specified category or null
if no messages are queued for the specified category. |
java.util.List |
get(java.lang.String property,
java.lang.String bundle)
Returns the set of localized action messages as a java.util.List of strings for all action messages
queued of the specified category or null
if no action messages are queued for the specified category. |
protected org.apache.struts.action.ActionMessages |
getActionMessages()
|
java.util.List |
getAll()
Returns the set of localized action messages as an java.util.List of strings for all actionMsgs
queued or null if no messages are queued. |
java.util.List |
getAll(java.lang.String bundle)
Returns a List of all queued action messages using the specified message resource bundle. |
java.util.List |
getGlobal()
This a convenience method and the equivalent of $messages.get($messages.globalName) . |
java.lang.String |
getGlobalName()
Returns the default "GLOBAL" category name that can be used for messages that are not associated with a particular property. |
int |
getSize()
Returns the number of action messages queued. |
int |
getSize(java.lang.String property)
Returns the number of action messages queued for a particular property. |
Methods inherited from class org.apache.velocity.tools.struts.MessageResourcesTool |
---|
configure, getLocale, getResources, init |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected org.apache.struts.action.ActionMessages actionMsgs
Constructor Detail |
---|
public ActionMessagesTool()
Method Detail |
---|
protected org.apache.struts.action.ActionMessages getActionMessages()
public boolean exist()
Returns true
if there are action messages queued,
otherwise false
.
public boolean exist(java.lang.String property)
Returns true if there are action messages queued for the specified
category of messages, otherwise false
.
property
- the category of messages to check forpublic int getSize()
public int getSize(java.lang.String property)
property
- the category of messages to check forpublic java.util.List getGlobal()
This a convenience method and the equivalent of
$messages.get($messages.globalName)
.
Returns the set of localized action messages as an
list of strings for all action messages queued of the
global category or null
if no messages
are queued for the specified category. If the message
resources don't contain an action message for a
particular message key, the key itself is used.
public java.util.List getAll()
java.util.List
of strings for all actionMsgs
queued or null
if no messages are queued.
If the message resources don't contain a message for a
particular key, the key itself is used as the message.
public java.util.List getAll(java.lang.String bundle)
bundle
- the message resource bundle to usegetAll()
public java.util.List get(java.lang.String property)
java.util.List
of strings for all actionMsgs
queued of the specified category or null
if no messages are queued for the specified category. If the
message resources don't contain a message for a particular
key, the key itself is used as the message.
property
- the category of actionMsgs to operate onpublic java.util.List get(java.lang.String property, java.lang.String bundle)
java.util.List
of strings for all action messages
queued of the specified category or null
if no action messages are queued for the specified category. If the
message resources don't contain an action message for a particular
action key, the key itself is used as action message.
property
- the category of actionMsgs to operate onbundle
- the message resource bundle to usepublic java.lang.String getGlobalName()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |