commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From commons-...@jakarta.apache.org
Subject [Jakarta Commons Wiki] Updated: Betwixt/XDocletIntegration
Date Tue, 22 Jun 2004 11:02:19 GMT
   Date: 2004-06-22T04:02:19
   Editor: 213.139.147.194 <>
   Wiki: Jakarta Commons Wiki
   Page: Betwixt/XDocletIntegration
   URL: http://wiki.apache.org/jakarta-commons/Betwixt/XDocletIntegration

   no comment

Change Log:

------------------------------------------------------------------------------
@@ -1,12 +1,37 @@
 = XDoclet Integration =
 
-The XDoclet family ([http://xdoclet.sourceforge.net/xdoclet/index.html XDoclet] and XDoclet2)
are generation engines used for attribute oriented programming. They process meta data (in
the form of javadocs tags).
+The XDoclet family ([http://xdoclet.sourceforge.net/xdoclet/index.html XDoclet] and [http://xdoclet.codehaus.org
XDoclet2]) are generation engines used for attribute oriented programming. They process meta
data (in the form of javadocs tags).
 
 The interest for Betwixt is that java doc tags are a very nice way to mark up mappings. 
 
 ----
 
 = Design Ideas =
+
+As XDoclet developer I would suggest to go for new xdoclet-2 plugin, due to easiness of development
+and possibility of test coverage. Plugin development for xdoclet-2 is  simplier than for
old
+xdoclet 1.2.x
+
+To develop a plugin you will need to chekout [ http://www.sourceforge.net/projects/xdoclet-plugins/
xdoclet-plugins]
+from sourceforge. This is a maven reactor project, and you can easily add new subdirectory
and use other 
+plugins as templates. I would suggest to use  some of jelly-based plugins as base ( for example
plugin-hibernate )
+as betwixt plugin vill be producing xml documents.
+
+XDoclet-2 plugins shall compile without any problem ( assumed you got ejb-2.1.jar in your
maven repository). 
+After you are done, I'm happy to take your changes and commit them to plugins repository.

+put 'em into [http://jira.codehaus.org/secure/BrowseProject.jspa?id=10231 JIRA]
+
+----
+
+= Developing plugin & tags =
+
+Some quick suggestions to plugin development process.
+ * Base package shall be  form org.xdoclet.plugin.betwixt
+ * Interfaces decalring tags shall go into: org.xdoclet.plugin.betwixt.qtags
+ * those interfaces shall be marked up by @qtags.something tags  to be really validatable
+ * do not forget to write tests. support classes are provided, and you can see their usage
+ * in other modules
+
 
 ----
  Up to [:Betwixt]

---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Mime
View raw message