Creating dynamic links

There are two ways to create dynamic links that should appear in a column. The first method is a "struts-like" approach which works well if the link you want to create is based on just a single property of the object being displayed (like a primary key value). The second approach makes use of decorators as described on the previous example. A decorator should be used when the dynamic link being created relies on multiple pieces of information, relies on the index of the object in the list, relies on some other data around it, or you want to change the text that is linked (ie you want it to say "edit", instead of showing the primary key of the object). Below I show how to use both examples.

Struts-like approach

The column tag provides 5 struts-like attributes that can be set to create a dynamic linke ( href, paramID, paramName, paramProperty, paramScope ). See the display:column documentation, and the struts documentation for a complete description of their usage, but basically:

href
the base URL used to construct the dynamic link
paramId
the name of the parameter that gets added to the URL specified above
paramName
name of the bean that contains the data we want to tack on the the URL (typically null, indicating the current object in the List)
paramProperty
property to call on the object specified above to return the value that gets tacked onto the URL.
paramScope
specific scope where the databean lives, typically null

Of these params, you typically would not use paramName and paramScope. Leaving each as null indicates that you want to use the object corresponding to the current row being processed.

ID Email Status
27582 Lorem-voluptua@kasd.com REBUM
9603 diam-nonumy@et.com SED
56736 dolore-sed@eos.com AT
11772 kasd-et@clita.com LABORE
17137 eirmod-elitr@sed.com ERAT
25732 ut-est@et.com AT
28698 sed-et@sea.com VERO
68519 diam-sanctus@et.com ACCUSAM
39256 Lorem-labore@gubergren.com DOLORES
66683 erat-ut@eos.com ELITR

Using a decorator

The previous example page introduced the decorator to format dates, money, etc... It can also be used to create dynamic links on the fly so that you can either click on a particular column value and "drill down" for more information, or you can create a column of text labels which are hyperlinks that perform some action on the object in that row.

These dynamic links can be created based on some primary key of the object, or they can make use of the object List index.

Below is a table that has two columns that have hyperlinks created on the fly, the first makes use of the object's "ID" field to show additional details about that object, while the second makes use of the object's row index value to do basically the same thing.

Here you can see the details of the getLink1() and getLink2() methods in the sample TableDecorator

	public String getLink1()
	{
		ListObject lObject= (ListObject)getCurrentRowObject();
		int lIndex= getListIndex();
		return "<a href=\"details.jsp?index=" + lIndex + "\">" + lObject.getId() + "</a>";
	}


	public String getLink2()
	{
		ListObject lObject= (ListObject)getCurrentRowObject();
		int lId= lObject.getId();

		return "<a href=\"details.jsp?id=" + lId
			+ "&action=view\">View</a> | "
			+ "<a href=\"details.jsp?id=" + lId
			+ "&action=edit\">Edit</a> | "
			+ "<a href=\"details.jsp?id=" + lId
			+ "&action=delete\">Delete</a>";
	}
ID Email Actions
27582 Lorem-voluptua@kasd.com View | Edit | Delete
9603 diam-nonumy@et.com View | Edit | Delete
56736 dolore-sed@eos.com View | Edit | Delete
11772 kasd-et@clita.com View | Edit | Delete
17137 eirmod-elitr@sed.com View | Edit | Delete
25732 ut-est@et.com View | Edit | Delete
28698 sed-et@sea.com View | Edit | Delete
68519 diam-sanctus@et.com View | Edit | Delete
39256 Lorem-labore@gubergren.com View | Edit | Delete
66683 erat-ut@eos.com View | Edit | Delete