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@paneris.org>
42 * http://paneris.org/~williamc
43 * Obrechtstraat 114, 2517VX Den Haag, The Netherlands
44 */
45
46 package org.melati.poem.prepro;
47
48 import java.util.Vector;
49 import java.io.Writer;
50 import java.io.IOException;
51
52 /**
53 * A definition of an <tt>LongPoemType</tt> from the DSD.
54 *
55 * Its member variables are populated from the DSD or defaults.
56 * Its methods are used to generate the java code.
57 */
58 public class LongFieldDef extends AtomFieldDef {
59
60 /**
61 * Constructor.
62 *
63 * @param lineNo the line number in the DSD file
64 * @param table the {@link TableDef} that this <code>Field</code> is part of
65 * @param name the name of this field
66 * @param displayOrder where to place this field in a list
67 * @param qualifiers all the qualifiers of this field
68 * @throws IllegalityException if a semantic inconsistency is detected
69 */
70 public LongFieldDef(int lineNo, TableDef table, String name, int displayOrder,
71 Vector<FieldQualifier> qualifiers) throws IllegalityException {
72 super(lineNo, table, name, "Long", displayOrder, qualifiers);
73 table.addImport("org.melati.poem.LongPoemType",
74 "table");
75 }
76
77 /**
78 * @param w The base persistent java file.
79 * @throws IOException
80 * if something goes wrong with the file system
81 */
82 public void generateBaseMethods(Writer w) throws IOException {
83 super.generateBaseMethods(w);
84 w.write(
85 "\n /**\n"
86 + " * Sets the <code>"
87 + capitalisedName
88 + "</code> value, with checking, for this \n"
89 + " * <code>"
90 + table.nameFromDsd
91 + "</code> <code>Persistent</code>.\n"
92 + ((description != null) ? " * Field description: \n"
93 + DSD.javadocFormat(2, 3, description)
94 + " * \n"
95 : "")
96 + " * \n"
97 + " * Generated by "
98 + this.getClass().getName()
99 + "#generateBaseMethods \n"
100 + " * @param cooked a validated <code>int</code>\n"
101 + " * @throws AccessPoemException \n"
102 + " * if the current <code>AccessToken</code> \n"
103 + " * does not confer write access rights\n"
104 + " * @throws ValidationPoemException \n"
105 + " * if the value is not valid\n"
106 + " */\n");
107 w.write(
108 "\n" +
109 " public final void set" + capitalisedName + "(long cooked)\n" +
110 " throws AccessPoemException, ValidationPoemException {\n" +
111 " set" + capitalisedName + "(new Long(cooked));\n" +
112 " }\n");
113 }
114 }