1 /*
2 * $Source: /usr/cvsroot/melati/maven-dsd-plugin/src/main/java/org/melati/poem/prepro/LongFieldDef.java,v $
3 * $Revision: 1.9 $
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 table the {@link TableDef} that this <code>Field</code> is
64 * 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 *
69 * @throws IllegalityException if a semantic inconsistency is detected
70 */
71 public LongFieldDef(int lineNo, TableDef table, String name, int displayOrder,
72 Vector<FieldQualifier> qualifiers) throws IllegalityException {
73 super(lineNo, table, name, "Long", displayOrder, qualifiers);
74 table.addImport("org.melati.poem.LongPoemType",
75 "table");
76 }
77
78 /**
79 * @param w The base persistent java file.
80 * @throws IOException
81 * if something goes wrong with the file system
82 */
83 public void generateBaseMethods(Writer w) throws IOException {
84 super.generateBaseMethods(w);
85 w.write(
86 "\n /**\n"
87 + " * Sets the <code>"
88 + capitalisedName
89 + "</code> value, with checking, for this \n"
90 + " * <code>"
91 + table.nameFromDsd
92 + "</code> <code>Persistent</code>.\n"
93 + ((description != null) ? " * Field description: \n"
94 + DSD.javadocFormat(2, 3, description)
95 + " * \n"
96 : "")
97 + " * \n"
98 + " * Generated by "
99 + this.getClass().getName()
100 + "#generateBaseMethods \n"
101 + " * @param cooked a validated <code>int</code>\n"
102 + " * @throws AccessPoemException \n"
103 + " * if the current <code>AccessToken</code> \n"
104 + " * does not confer write access rights\n"
105 + " * @throws ValidationPoemException \n"
106 + " * if the value is not valid\n"
107 + " */\n");
108 w.write(
109 "\n" +
110 " public final void set" + capitalisedName + "(long cooked)\n" +
111 " throws AccessPoemException, ValidationPoemException {\n" +
112 " set" + capitalisedName + "(new Long(cooked));\n" +
113 " }\n");
114 }
115 }