Code Coverage for tapestry release 4.0.3

Clover coverage report - Code Coverage for tapestry release 4.0.3

Coverage timestamp: Fri May 5 2006 21:17:42 CDT

FRAMES NO FRAMES

file stats:	LOC:	162		Methods:	3
	NCLOC:	89		Classes:	1

Source file

Conditionals

Statements

Methods

TOTAL

Rollover.java

1		// Copyright 2004, 2005 The Apache Software Foundation
2		//
3		// Licensed under the Apache License, Version 2.0 (the "License");
4		// you may not use this file except in compliance with the License.
5		// You may obtain a copy of the License at
6		//
7		// http://www.apache.org/licenses/LICENSE-2.0
8		//
9		// Unless required by applicable law or agreed to in writing, software
10		// distributed under the License is distributed on an "AS IS" BASIS,
11		// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12		// See the License for the specific language governing permissions and
13		// limitations under the License.
14
15		package org.apache.tapestry.html;
16
17		import java.util.HashMap;
18		import java.util.Map;
19
20		import org.apache.hivemind.ApplicationRuntimeException;
21		import org.apache.tapestry.AbstractComponent;
22		import org.apache.tapestry.IAsset;
23		import org.apache.tapestry.IMarkupWriter;
24		import org.apache.tapestry.IRequestCycle;
25		import org.apache.tapestry.IScript;
26		import org.apache.tapestry.PageRenderSupport;
27		import org.apache.tapestry.Tapestry;
28		import org.apache.tapestry.TapestryUtils;
29		import org.apache.tapestry.components.ILinkComponent;
30		import org.apache.tapestry.components.LinkEventType;
31
32		/**
33		* Combines a link component (such as {@link org.apache.tapestry.link.DirectLink}) with an
34		* <img> and JavaScript code to create a rollover effect that works with both Netscape
35		* Navigator and Internet Explorer. [ <a
36		* href="../../../../../ComponentReference/Rollover.html">Component Reference </a>]
37		*
38		* @author Howard Lewis Ship
39		*/
40
41		public abstract class Rollover extends AbstractComponent
42		{
43		/**
44		* Converts an {@link IAsset}binding into a usable URL. Returns null if the binding does not
45		* exist or the binding's value is null.
46		*/
47
48	0	protected String getAssetURL(IAsset asset)
49		{
50	0	if (asset == null)
51	0	return null;
52
53	0	return asset.buildURL();
54		}
55
56	0	protected void renderComponent(IMarkupWriter writer, IRequestCycle cycle)
57		{
58		// No body, so we skip it all if not rewinding (assumes no side effects on
59		// accessors).
60
61	0	if (cycle.isRewinding())
62	0	return;
63
64	0	String imageURL = null;
65	0	String mouseOverURL = null;
66	0	String mouseOutURL = null;
67	0	boolean dynamic = false;
68	0	String imageId = null;
69
70	0	PageRenderSupport pageRenderSupport = TapestryUtils.getPageRenderSupport(cycle, this);
71
72	0	ILinkComponent serviceLink = (ILinkComponent) cycle
73		.getAttribute(Tapestry.LINK_COMPONENT_ATTRIBUTE_NAME);
74
75	0	if (serviceLink == null)
76	0	throw new ApplicationRuntimeException(Tapestry
77		.getMessage("Rollover.must-be-contained-by-link"), this, null, null);
78
79	0	boolean linkDisabled = serviceLink.isDisabled();
80
81	0	if (linkDisabled)
82		{
83	0	imageURL = getAssetURL(getDisabled());
84
85	0	if (imageURL == null)
86	0	imageURL = getAssetURL(getImage());
87		}
88		else
89		{
90	0	imageURL = getAssetURL(getImage());
91	0	mouseOverURL = getAssetURL(getMouseOver());
92	0	mouseOutURL = getAssetURL(getMouseOut());
93
94	0	dynamic = (mouseOverURL != null) \|\| (mouseOutURL != null);
95		}
96
97	0	if (imageURL == null)
98	0	throw Tapestry.createRequiredParameterException(this, "image");
99
100	0	writer.beginEmpty("img");
101
102	0	writer.attribute("src", imageURL);
103
104	0	if (dynamic)
105		{
106	0	if (mouseOverURL == null)
107	0	mouseOverURL = imageURL;
108
109	0	if (mouseOutURL == null)
110	0	mouseOutURL = imageURL;
111
112	0	imageId = writeScript(cycle, pageRenderSupport, serviceLink, mouseOverURL, mouseOutURL);
113
114	0	writer.attribute("id", imageId);
115		}
116
117	0	renderInformalParameters(writer, cycle);
118
119	0	writer.closeTag();
120
121		}
122
123		// Injected
124
125		public abstract IScript getScript();
126
127	0	private String writeScript(IRequestCycle cycle, PageRenderSupport pageRenderSupport,
128		ILinkComponent link, String mouseOverImageURL, String mouseOutImageURL)
129		{
130	0	String imageId = pageRenderSupport.getUniqueString(getId());
131	0	String preloadedMouseOverImageURL = pageRenderSupport
132		.getPreloadedImageReference(mouseOverImageURL);
133	0	String preloadedMouseOutImageURL = pageRenderSupport
134		.getPreloadedImageReference(mouseOutImageURL);
135
136	0	Map symbols = new HashMap();
137
138	0	symbols.put("imageId", imageId);
139	0	symbols.put("mouseOverImageURL", preloadedMouseOverImageURL);
140	0	symbols.put("mouseOutImageURL", preloadedMouseOutImageURL);
141
142	0	getScript().execute(cycle, pageRenderSupport, symbols);
143
144		// Add attributes to the link to control mouse over/out.
145		// Because the script is written before the <body> tag,
146		// there won't be any timing issues (such as cause
147		// bug #113893).
148
149	0	link.addEventHandler(LinkEventType.MOUSE_OVER, (String) symbols.get("onMouseOverName"));
150	0	link.addEventHandler(LinkEventType.MOUSE_OUT, (String) symbols.get("onMouseOutName"));
151
152	0	return imageId;
153		}
154
155		public abstract IAsset getMouseOut();
156
157		public abstract IAsset getDisabled();
158
159		public abstract IAsset getMouseOver();
160
161		public abstract IAsset getImage();
162		}