| java.lang.Object
 com.opensymphony.webwork.components.Component
com.opensymphony.webwork.components.URL
| URL | | public class URL extends Component (Code) | |
This tag is used to create a URL.
You can use the "param" tag inside the body to provide
additional request parameters.
NOTE:
When includeParams is 'all' or 'get', the parameter defined in param tag will take
precedence and will not be overriden if they exists in the parameter submitted. For
example, in Example 3 below, if there is a id parameter in the url where the page this
tag is included like http://://editUser.action?id=3333&name=John
the generated url will be http://:/context>/editUser.action?id=22&name=John
cause the parameter defined in the param tag will take precedence.
- action (String) - (value or action choose either one, if both exist value takes precedence) action's name (alias)
-
- value (String) - (value or action choose either one, if both exist value takes precedence) the url itself
- scheme (String) - http scheme (http, https) default to the scheme this request is in
- namespace - action's namespace
- method (String) - action's method, default to execute()
- encode (Boolean) - url encode the generated url. Default is true
- includeParams (String) - The includeParams attribute may have the value 'none', 'get' or 'all'. Default is 'get'.
none - include no parameters in the URL
get - include only GET parameters in the URL (default)
all - include both GET and POST parameters in the URL
- includeContext (Boolean) - determine wheather to include the web app context path. Default is true.
Examples
<-- Example 1 -->
<ww:url value="editGadget.action">
<ww:param name="id" value="%{selected}" />
</ww:url>
<-- Example 2 -->
<ww:url action="editGadget">
<ww:param name="id" value="%{selected}" />
</ww:url>
<-- Example 3-->
<ww:url includeParams="get" >
<:param name="id" value="%{'22'}" />
</ww:url>
author:
Rickard Öberg (rickard@dreambean.com)
author:
Patrick Lightbody
author:
Ian Roughley
author:
Rene Gielen
author:
Rainer Hermanns
author:
tm_jee
version:
$Revision: 2930 $
since:
2.2
See Also: Param |
| NONE | | final public static String NONE(Code) | | The includeParams attribute may have the value 'none', 'get' or 'all'.
It is used when the url tag is used with or without a value attribute.
Its value is looked up on the ValueStack
If no includeParams is specified then 'get' is used.
none - include no parameters in the URL
get - include only GET parameters in the URL (default)
all - include both GET and POST parameters in the URL
|
| encode | | protected boolean encode(Code) | | |
| escapeAmp | | protected boolean escapeAmp(Code) | | |
| includeContext | | protected boolean includeContext(Code) | | |
| mergeRequestParameters | | protected void mergeRequestParameters(String value, Map parameters, Map contextParameters)(Code) | | Merge request parameters into current parameters. If a parameter is
already present, than the request parameter in the current request and value atrribute
will not override its value.
The priority is as follows:-
- parameter from the current request (least priority)
- parameter form the value attribute (more priority)
- parameter from the param tag (most priority)
Parameters:
value - the value attribute (url to be generated by this component)
Parameters:
parameters - component parameters
Parameters:
contextParameters - request parameters |
| setAction | | public void setAction(String action)(Code) | | The action generate url for, if not using value
|
| setAnchor | | public void setAnchor(String anchor)(Code) | | The anchor for this URL
|
| setEncode | | public void setEncode(boolean encode)(Code) | | whether to encode parameters
|
| setEscapeAmp | | public void setEscapeAmp(boolean escapeAmp)(Code) | | Whether to escape ampersand (&) to (&) or not, default to true.
|
| setIncludeContext | | public void setIncludeContext(boolean includeContext)(Code) | | whether actual context should be included in url
|
| setIncludeParams | | public void setIncludeParams(String includeParams)(Code) | | The includeParams attribute may have the value 'none', 'get' or 'all'.
|
| setMethod | | public void setMethod(String method)(Code) | | The method of action to use
|
| setNamespace | | public void setNamespace(String namespace)(Code) | | The namespace to use
|
| setPortletMode | | public void setPortletMode(String portletMode)(Code) | | The resulting portlet mode
|
| setPortletUrlType | | public void setPortletUrlType(String portletUrlType)(Code) | | Specifies if this should be a portlet render or action url
|
| setScheme | | public void setScheme(String scheme)(Code) | | Set scheme attribute
|
| setValue | | public void setValue(String value)(Code) | | The target value to use, if not using action
|
| setWindowState | | public void setWindowState(String windowState)(Code) | | The resulting portlet window state
|
| Methods inherited from com.opensymphony.webwork.components.Component | public void addAllParameters(Map params)(Code)(Java Doc)
public void addParameter(String key, Object value)(Code)(Java Doc)
public boolean altSyntax()(Code)(Java Doc)
public void copyParams(Map params)(Code)(Java Doc)
protected String determineActionURL(String action, String namespace, String method, HttpServletRequest req, HttpServletResponse res, Map parameters, String scheme, boolean includeContext, boolean encodeResult, boolean escapeXml)(Code)(Java Doc)
protected String determineNamespace(String namespace, OgnlValueStack stack, HttpServletRequest req)(Code)(Java Doc)
public boolean end(Writer writer, String body)(Code)(Java Doc)
protected boolean end(Writer writer, String body, boolean popComponentStack)(Code)(Java Doc)
protected WebWorkException fieldError(String field, String errorMsg, Exception e)(Code)(Java Doc)
protected Component findAncestor(Class clazz)(Code)(Java Doc)
protected String findString(String expr)(Code)(Java Doc)
protected String findString(String expr, String field, String errorMsg)(Code)(Java Doc)
protected Object findValue(String expr)(Code)(Java Doc)
protected Object findValue(String expr, String field, String errorMsg)(Code)(Java Doc)
protected Object findValue(String expr, Class toType)(Code)(Java Doc)
public Stack getComponentStack()(Code)(Java Doc)
public String getId()(Code)(Java Doc)
public Map getParameters()(Code)(Java Doc)
public OgnlValueStack getStack()(Code)(Java Doc)
protected void popComponentStack()(Code)(Java Doc)
public void setId(String id)(Code)(Java Doc)
public boolean start(Writer writer)(Code)(Java Doc)
protected String toString(Throwable t)(Code)(Java Doc)
public boolean usesBody()(Code)(Java Doc)
|
|
|