View Javadoc
1   /*
2    * $Source$
3    * $Revision$
4    *
5    * Copyright (C) 2000 William Chesters
6    *
7    * Part of Melati (http://melati.org), a framework for the rapid
8    * development of clean, maintainable web applications.
9    *
10   * Melati is free software; Permission is granted to copy, distribute
11   * and/or modify this software under the terms either:
12   *
13   * a) the GNU General Public License as published by the Free Software
14   *    Foundation; either version 2 of the License, or (at your option)
15   *    any later version,
16   *
17   *    or
18   *
19   * b) any version of the Melati Software License, as published
20   *    at http://melati.org
21   *
22   * You should have received a copy of the GNU General Public License and
23   * the Melati Software License along with this program;
24   * if not, write to the Free Software Foundation, Inc.,
25   * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA to obtain the
26   * GNU General Public License and visit http://melati.org to obtain the
27   * Melati Software License.
28   *
29   * Feel free to contact the Developers of Melati (http://melati.org),
30   * if you would like to work out a different arrangement than the options
31   * outlined here.  It is our intention to allow Melati to be used by as
32   * wide an audience as possible.
33   *
34   * This program is distributed in the hope that it will be useful,
35   * but WITHOUT ANY WARRANTY; without even the implied warranty of
36   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
37   * GNU General Public License for more details.
38   *
39   * Contact details for copyright holder:
40   *
41   *     William Chesters <williamc At paneris.org>
42   *     http://paneris.org/~williamc
43   *     Obrechtstraat 114, 2517VX Den Haag, The Netherlands
44   */
45  
46  package org.melati.template;
47  
48  import org.melati.util.MelatiRuntimeException;
49  
50  /**
51   * Thrown when a {@link TempletAdaptor} cannot find a required form field 
52   * in a templet.
53   */
54  public class MissingFieldException extends MelatiRuntimeException {
55  
56  
57    private static final long serialVersionUID = -4695114906098564625L;
58  
59    TempletAdaptor adaptor;
60    String name;
61    String fullName;
62    
63    /**
64     * Constructor.
65     * @param adaptor the TempletAdaptor
66     * @param name name of compound field
67     * @param fullName name of sub-field
68     */
69    public MissingFieldException(TempletAdaptor adaptor,
70                                 String name, String fullName) {
71      this.adaptor = adaptor;
72      this.name = name;
73      this.fullName = fullName;
74    }
75  
76    /**
77     * {@inheritDoc}
78     * @see org.melati.util.MelatiRuntimeException#getMessage()
79     */
80    public String getMessage() {
81      return
82          "The templet adaptor `" + adaptor + "' was looking for a form field " +
83          "`" + fullName + "' as part of a compound field `" + name + "', " +
84          "but it was not present. " +
85          "Maybe a bug in the adaptor, or more likely in an associated templet.";
86    }
87  }