On Dec 4, 2008, at 11:02 AM, Aristedes Maniatis wrote:
On Dec 4, 2008, at 10:20 AM, Aristedes Maniatis wrote:
1. I've never known what "dotemplates" means. Could we rename that
to something more obvious like "entity templates"
"Data Object Templates" :-) Anyways, the name is misleading. I
don't mind if we rename it to something else. "cgen-templates", or
something like that.
Great. I still like "entity templates" but anything is better than
what I thought for years was "dot templates".
We also have "data map templates" now, so "entity" is too narrow.
2. Is v1_2 confusing since it doesn't match the Cayenne versioning
and there isn't any sense of how 1.2 relates to 3.0M5.
Since we likely won't be upgrading templates for each and every
release, the a mismatch between the templates version and Cayenne
version is sort of natural (not that I like it)... The only place
where it is exposed to the user is the "version" attribute of cgen,
where it is marked as deprecated:
http://cayenne.apache.org/doc/cgen.html
Yes... but.... inside the XML map is already a version number, in a
current map it is "3.0".
Believe it or not, this one doesn't necessarily correspond to Cayenne
version either. It is only changed if a release introduces new mapping
elements or changes the old ones. So there is a chance that Cayenne
3.1 will use 3.0 mapping.
So we aren't being very consistent. Plus the XML schema will itself
be versioned.
Correct. We won't be using mapping version once we migrate to a
schema. But there is still a chance that schema version won't be equal
Cayenne version.
We are exposing it to the user simply by putting it in a folder
called 1.2.
99% of users don't know it... It is in the src folder for reference
only. The important thing is that it is also in cayenne-server.jar,
thus enabling cgen and CM to work without any extra paths.
3. Can we get rid of the deprecated templates outside the 1.2
folder which really shouldn't be offered for use. If people are
already using old templates, then let's support them, but let's
not encourage their use.
If we support the deprecated template, we have to include it in the
distro somewhere.
Not necessarily. We can support something without encouraging its
use for new projects. If people are already using the old template,
then they don't need to download the files. If they aren't using the
template, then we'd rather they didn't know about it.
This would break the encapsulation of the templates (see above -
default templates are assumed to be hidden from the user inside
cayenne-server.jar).
Andrus
