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:	158		Methods:	11
	NCLOC:	78		Classes:	1

Source file

Conditionals

Statements

Methods

TOTAL

AbstractBinding.java

96.6%

81.8%

92.5%

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.binding;
16
17		import org.apache.hivemind.Location;
18		import org.apache.hivemind.util.Defense;
19		import org.apache.tapestry.BindingException;
20		import org.apache.tapestry.IBinding;
21		import org.apache.tapestry.coerce.ValueConverter;
22
23		/**
24		* Base class for {@link IBinding}implementations.
25		*
26		* @author Howard Lewis Ship
27		*/
28
29		public abstract class AbstractBinding implements IBinding
30		{
31		/** @since 4.0 */
32
33		private final String _description;
34
35		/** @since 4.0 */
36
37		private final ValueConverter _valueConverter;
38
39		/** @since 3.0 */
40
41		private final Location _location;
42
43		/** @since 3.0 */
44
45	5043	protected AbstractBinding(String description, ValueConverter valueConverter, Location location)
46		{
47	5043	Defense.notNull(description, "description");
48	5043	Defense.notNull(valueConverter, "valueConverter");
49
50	5043	_description = description;
51	5043	_valueConverter = valueConverter;
52	5043	_location = location;
53		}
54
55	60	public Location getLocation()
56		{
57	60	return _location;
58		}
59
60		/**
61		* Overridden in subclasses that are not invariant.
62		*
63		* @throws ReadOnlyBindingException
64		* always.
65		*/
66
67	3	public void setObject(Object value)
68		{
69	3	throw createReadOnlyBindingException(this);
70		}
71
72		/**
73		* Default implementation: returns true.
74		*
75		* @since 2.0.3
76		*/
77
78	1926	public boolean isInvariant()
79		{
80	1926	return true;
81		}
82
83	7386	public Object getObject(Class type)
84		{
85	7386	Defense.notNull(type, "type");
86
87	7386	Object raw = getObject();
88
89	7383	try
90		{
91	7383	return _valueConverter.coerceValue(raw, type);
92		}
93		catch (Exception ex)
94		{
95	3	String message = BindingMessages.convertObjectError(this, ex);
96
97	3	throw new BindingException(message, getComponent(), _location, this, ex);
98		}
99		}
100
101		/**
102		* Returns the component to which this binding is connected; this is currently only used when
103		* building certain exceptions. This implementation returns null.
104		*
105		* @since 4.0
106		*/
107
108	6	public Object getComponent()
109		{
110	6	return null;
111		}
112
113		/** @since 3.0 */
114
115	6	protected BindingException createReadOnlyBindingException(IBinding binding)
116		{
117	6	return new BindingException(BindingMessages.readOnlyBinding(binding), binding);
118		}
119
120		/** @since 4.0 */
121
122	24	public String getDescription()
123		{
124	24	return _description;
125		}
126
127		/** @since 4.0 */
128	0	public ValueConverter getValueConverter()
129		{
130	0	return _valueConverter;
131		}
132
133	3	public String toString()
134		{
135	3	StringBuffer buffer = new StringBuffer();
136	3	buffer.append(getClass().getName());
137	3	buffer.append("@");
138	3	buffer.append(Integer.toHexString(hashCode()));
139	3	buffer.append("[");
140	3	buffer.append(_description);
141
142	3	extendDescription(buffer);
143
144	3	buffer.append(", location=");
145	3	buffer.append(_location);
146	3	buffer.append("]");
147
148	3	return buffer.toString();
149		}
150
151		/**
152		* Does nothing, subclasses may override to add additional information.
153		*/
154	0	protected void extendDescription(StringBuffer buffer)
155		{
156
157		}
158		}