Package org.apache.turbine.services.pull.tools

Klasse TemplateLink

java.lang.Object
org.apache.turbine.services.pull.tools.TemplateLink
Alle implementierten Schnittstellen:
ApplicationTool
Bekannte direkte Unterklassen:
MappedTemplateLink
public class TemplateLink extends Object implements ApplicationTool
This is a pull to to be used in Templates to convert links in Templates into the correct references. The pull service might insert this tool into the Context. in templates. Here's an example of its Velocity use:

$link.setPage("index.vm").addPathInfo("hello","world") This would return: http://foo.com/Turbine/template/index.vm/hello/world

This is an application pull tool for the template system. You should not use it in a normal application!

Version:
$Id$
Autor:
Dave Bryson, Jon S. Stevens, Henning P. Schmiedehausen, Quinton McCombs, Peter Courcoux

  • Felddetails

  • Konstruktordetails

    • TemplateLink

      public TemplateLink()
      Default constructor

      The init method must be called before use.

  • Methodendetails

    • init

      public void init(Object data)
      This will initialize a TemplateLink object that was constructed with the default constructor (ApplicationTool method).
      Angegeben von:
      init in Schnittstelle ApplicationTool
      Parameter:
      data - assumed to be a PipelineData object

    • refresh

      public void refresh()
      Refresh method - does nothing
      Angegeben von:
      refresh in Schnittstelle ApplicationTool

    • setEncodeURLOff

      public TemplateLink setEncodeURLOff()
      This will turn off the execution of res.encodeURL() by making res == null. This is a hack for cases where you don't want to see the session information
      Gibt zurück:
      A TemplateLink (self).

    • setPage

      public TemplateLink setPage(String template)
      Sets the template variable used by the Template Service.
      Parameter:
      template - A String with the template name.
      Gibt zurück:
      A TemplateLink.

    • getPage

      public String getPage()
      Gets the template variable used by the Template Service. It is only available after setPage() has been called.
      Gibt zurück:
      The template name.

    • setAction

      public TemplateLink setAction(String action)
      Sets the action= value for this URL. By default it adds the information to the path_info instead of the query data.
      Parameter:
      action - A String with the action value.
      Gibt zurück:
      A TemplateLink (self).

    • setActionEvent

      public TemplateLink setActionEvent(String action, String event)
      Sets the action= and eventSubmit= values for this URL. By default it adds the information to the path_info instead of the query data.
      Parameter:
      action - A String with the action value.
      event - A string with the event name.
      Gibt zurück:
      A TemplateLink (self).

    • setScreen

      public TemplateLink setScreen(String screen)
      Sets the screen= value for this URL. By default it adds the information to the path_info instead of the query data.
      Parameter:
      screen - A String with the screen value.
      Gibt zurück:
      A TemplateLink (self).

    • setReference

      public TemplateLink setReference(String reference)
      Sets a reference anchor (#ref).
      Parameter:
      reference - A String containing the reference.
      Gibt zurück:
      A TemplateLink (self).

    • getReference

      public String getReference()
      Returns the current reference anchor.
      Gibt zurück:
      A String containing the reference.

    • addPathInfo

      public TemplateLink addPathInfo(org.apache.fulcrum.parser.ParameterParser pp)
      Adds a name=value pair for every entry in a ParameterParser object to the path_info string.
      Parameter:
      pp - A ParameterParser.
      Gibt zurück:
      A TemplateLink (self).

    • addPathInfo

      public TemplateLink addPathInfo(String name, Object value)
      Adds a name=value pair to the path_info string.
      Parameter:
      name - A String with the name to add.
      value - An Object with the value to add.
      Gibt zurück:
      A TemplateLink (self).

    • addPathInfo

      public TemplateLink addPathInfo(String name, String value)
      Adds a name=value pair to the path_info string.
      Parameter:
      name - A String with the name to add.
      value - A String with the value to add.
      Gibt zurück:
      A TemplateLink (self).

    • addPathInfo

      public TemplateLink addPathInfo(String name, double value)
      Adds a name=value pair to the path_info string.
      Parameter:
      name - A String with the name to add.
      value - A double with the value to add.
      Gibt zurück:
      A TemplateLink (self).

    • addPathInfo

      public TemplateLink addPathInfo(String name, int value)
      Adds a name=value pair to the path_info string.
      Parameter:
      name - A String with the name to add.
      value - An int with the value to add.
      Gibt zurück:
      A TemplateLink (self).

    • addPathInfo

      public TemplateLink addPathInfo(String name, long value)
      Adds a name=value pair to the path_info string.
      Parameter:
      name - A String with the name to add.
      value - A long with the value to add.
      Gibt zurück:
      A TemplateLink (self).

    • addQueryData

      public TemplateLink addQueryData(String name, Object value)
      Adds a name=value pair to the query string.
      Parameter:
      name - A String with the name to add.
      value - An Object with the value to add.
      Gibt zurück:
      A TemplateLink (self).

    • addQueryData

      public TemplateLink addQueryData(String name, String value)
      Adds a name=value pair to the query string.
      Parameter:
      name - A String with the name to add.
      value - A String with the value to add.
      Gibt zurück:
      A TemplateLink (self).

    • addQueryData

      public TemplateLink addQueryData(String name, double value)
      Adds a name=value pair to the query string.
      Parameter:
      name - A String with the name to add.
      value - A double with the value to add.
      Gibt zurück:
      A TemplateLink (self).

    • addQueryData

      public TemplateLink addQueryData(String name, int value)
      Adds a name=value pair to the query string.
      Parameter:
      name - A String with the name to add.
      value - An int with the value to add.
      Gibt zurück:
      A TemplateLink (self).

    • addQueryData

      public TemplateLink addQueryData(String name, long value)
      Adds a name=value pair to the query string.
      Parameter:
      name - A String with the name to add.
      value - A long with the value to add.
      Gibt zurück:
      A TemplateLink (self).

    • addQueryData

      public TemplateLink addQueryData(org.apache.fulcrum.parser.ParameterParser pp)
      Adds a name=value pair for every entry in a ParameterParser object to the query string.
      Parameter:
      pp - A ParameterParser.
      Gibt zurück:
      A TemplateLink (self).

    • removePathInfo

      public TemplateLink removePathInfo()
      Removes all the path info elements.
      Gibt zurück:
      A TemplateLink (self).

    • removePathInfo

      public TemplateLink removePathInfo(String name)
      Removes a name=value pair from the path info.
      Parameter:
      name - A String with the name to be removed.
      Gibt zurück:
      A TemplateLink (self).

    • removeQueryData

      public TemplateLink removeQueryData()
      Removes all the query string elements.
      Gibt zurück:
      A TemplateLink (self).

    • removeQueryData

      public TemplateLink removeQueryData(String name)
      Removes a name=value pair from the query string.
      Parameter:
      name - A String with the name to be removed.
      Gibt zurück:
      A TemplateLink (self).

    • getAbsoluteLink

      public String getAbsoluteLink()
      Builds the URL with all of the data URL-encoded as well as encoded using HttpServletResponse.encodeUrl(). The resulting URL is absolute; it starts with http/https... 
       TemplateURI tui = new TemplateURI (data, "UserScreen");
 tui.addPathInfo("user","jon");
 tui.getAbsoluteLink();
      The above call to absoluteLink() would return the String:

      http://www.server.com/servlets/Turbine/screen/UserScreen/user/jon

      After rendering the URI, it clears the pathInfo and QueryString portions of the TemplateURI. So you can use the $link reference multiple times on a page and start over with a fresh object every time.

      Gibt zurück:
      A String with the built URL.

    • getRelativeLink

      public String getRelativeLink()
      Builds the URL with all of the data URL-encoded as well as encoded using HttpServletResponse.encodeUrl(). The resulting URL is relative to the webserver root. 
       TemplateURI tui = new TemplateURI (data, "UserScreen");
 tui.addPathInfo("user","jon");
 tui.getRelativeLink();
      The above call to relativeLink() would return the String:

      /servlets/Turbine/screen/UserScreen/user/jon

      After rendering the URI, it clears the pathInfo and QueryString portions of the TemplateURI. So you can use the $link reference multiple times on a page and start over with a fresh object every time.

      Gibt zurück:
      A String with the built URL.

    • getLink

      public String getLink()
      Returns the URI. After rendering the URI, it clears the pathInfo and QueryString portions of the TemplateURI.
      Gibt zurück:
      A String with the URI in the form http://foo.com/Turbine/template/index.wm/hello/world

    • getURI

      public String getURI()
      Returns the relative URI leaving the source intact. Use this if you need the path_info and query data multiple times. This is equivalent to $link.Link or just $link, but does not reset the path_info and query data.
      Gibt zurück:
      A String with the URI in the form http://foo.com/Turbine/template/index.wm/hello/world

    • getAbsoluteURI

      public String getAbsoluteURI()
      Returns the absolute URI leaving the source intact. Use this if you need the path_info and query data multiple times. This is equivalent to $link.AbsoluteLink but does not reset the path_info and query data.
      Gibt zurück:
      A String with the URI in the form http://foo.com/Turbine/template/index.wm/hello/world

    • getRelativeURI

      public String getRelativeURI()
      Returns the relative URI leaving the source intact. Use this if you need the path_info and query data multiple times. This is equivalent to $link.RelativeLink but does not reset the path_info and query data.
      Gibt zurück:
      A String with the URI in the form http://foo.com/Turbine/template/index.wm/hello/world

    • toString

      public String toString()
      Same as getLink().
      Setzt außer Kraft:
      toString in Klasse Object
      Gibt zurück:
      A String with the URI represented by this object.