View source

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
79144 dolor-et@magna.com REBUM
5678 no-magna@magna.com NONUMY
65 takimata-erat@magna.com ET
92971 rebum-Lorem@diam.com EST
26410 diam-clita@et.com AMET
43741 et-rebum@voluptua.com NONUMY
10689 no-takimata@Stet.com EA
18446 rebum-voluptua@gubergren.com GUBERGREN
40009 dolor-sadipscing@accusam.com UT
86536 dolores-et@diam.com UT

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
79144 dolor-et@magna.com View | Edit | Delete
5678 no-magna@magna.com View | Edit | Delete
65 takimata-erat@magna.com View | Edit | Delete
92971 rebum-Lorem@diam.com View | Edit | Delete
26410 diam-clita@et.com View | Edit | Delete
43741 et-rebum@voluptua.com View | Edit | Delete
10689 no-takimata@Stet.com View | Edit | Delete
18446 rebum-voluptua@gubergren.com View | Edit | Delete
40009 dolor-sadipscing@accusam.com View | Edit | Delete
86536 dolores-et@diam.com View | Edit | Delete