Correction of Errors in Maven 2 Readme.txt generated at project root
--------------------------------------------------------------------

         Key: ANDROMDAPP-23
         URL: http://jira.andromda.org/browse/ANDROMDAPP-23
     Project: AndroMDApp Project Generator
        Type: Improvement

    Versions: 3.2-RC1    
    Reporter: Pierre Colot
 Assigned to: Chad Brandon 



andromdapp:generate create readme.txt with incorrect information in case of 
maven2 usage.

Erroneous Maven 1.x pom.xml project descriptor reference : 
http://maven.apache.org/reference/project-descriptor.html to be replaced by 
http://maven.apache.org/ref/current/maven-model/maven.html

Erroneous Project properties configuration : project.properties is not used by 
default but could be used thru maven2 specific pom.xml configuration deprecated 
by new profiled properties mechanism

Erroneous Project properties configuration : mda.properties is not used by 
default but could be used thru maven2 specific pom.xml configuration deprecated 
by new profiled properties mechanism

Erroneous undeploy command for ear deployed application
Incorrect maven2 repository location : *NIX wrong maven repository location : 
.maven -> .m2


To correct it :

--- 
R:\PCOLOT\andromda-src-3.2-SNAPSHOT-20060514\andromdapp\projects\j2ee\maven2\src\main\resources\templates\j2ee\maven2\readme.txt.vsl
        Wed Jun 28 13:45:49 2006
+++ 
R:\PCOLOT\ref-andromda-src-3.2-SNAPSHOT-20060514\andromda-src-3.2-SNAPSHOT\andromdapp\projects\j2ee\maven2\src\main\resources\templates\j2ee\maven2\readme.txt.vsl
  Fri Feb 10 16:03:18 2006
@@ -27,29 +27,25 @@
          |-- pom.xml
          |        contains information about this project, you may add more 
information
          |        as long as you do not violate the Maven POM schema, see
-         |        http://maven.apache.org/ref/current/maven-model/maven.html
-         |
-         |        contains common properties organized by profil to configure 
the project
+         |        http://maven.apache.org/reference/project-descriptor.html
+         |-- project.properties
+         |        common properties that might be changed to configure the 
project
          |
          +-- /mda
+         |     |
          |     |    The MDA module is the heart of this project, this is where
          |     |    AndroMDA is configured to generate the files needed to
          |     |    assemble the application
          |     |
          |     +-- pom.xml
          |     |        contains the AndroMDA dependencies (cartridges, 
translation-libraries, etc)
-         |     |
-         |     |        contains specific AndroMDA properties, can be 
configured here,
+         |     +-- mda.properties
+         |     |        specific AndroMDA properties, can be configured here,
          |     |        such as toggling the validation errors on/off
-         |     |
          |     +-- /src
-         |     |     |  additional sources such as merge-mappings can be
-         |     |     |  placed here, check out the /main/uml directory, it 
contains
-         |     |     |  the UML model from which AndroMDA will generate code
-         |     |     |
-         |     |     +-- /cartridges/
-         |     |             Merging source location for cartridges 
customisation
-         |     |
+         |     |        additional sources such as merge-mappings can be
+         |     |        placed here, check out the /main/uml directory, it 
contains
+         |     |        the UML model from which AndroMDA will generate code
          |     +-- /src/main/config/andromda.xml
          |              configures AndroMDA and its components, most
          |              importantly the cartridges which are listed in
@@ -57,29 +53,28 @@
          |              'default' namespace
          |     
          +-- /common
+         |     |
          |     |    The COMMON module collects those resources and classes
          |     |    that are shared between the other modules.
          |     |
          |     +-- pom.xml
          |     |        lists common dependencies
-         |     |
          |     +-- /target
          |              shared resources and java classes are generated here,
          |              such as value objects and exceptions
          |
 #if ($ejb || $ejb3)
          +-- /core
+         |     |
          |     |    The CORE module collects those resources and classes
          |     |    that use the EJB framework
          |     |
          |     +-- pom.xml
          |     |        lists EJB[3.0] dependencies
-         |     |
          |     +-- /src/main/java
          |     |        EJB[3.0] classes that need manual implementation are
          |     |        generated here, they will not be overwritten upon
          |     |        regeneration
-         |     |
          |     +-- /target
          |              the EJB[3.0] classes here will be overwriten each time
          |              AndroMDA generates new code using the EJB[3.0] 
cartridge
@@ -87,18 +82,17 @@
 #end
 #if ($hibernate)
          +-- /core
+         |     |
          |     |    The CORE module collects those resources and classes
          |     |    that use the Hibernate framework
          |     |
          |     +-- pom.xml
          |     |        lists Hibernate dependencies
-         |     |
          |     +-- /src/main/java
          |     |        Hibernate classes that need manual implementation are
          |     |        generated here, they will not be overwritten upon
          |     |        regeneration; these are the entities containing
          |     |        business methods
-         |     |
          |     +-- /target
          |              the Hibernate resources and classes here will be
          |              overwriten each time AndroMDA generates new code
@@ -110,19 +104,18 @@
 #end
 #if ($spring)
          +-- /core
+         |     |
          |     |    The CORE module collects those resources and classes
          |     |    that use the Spring framework, optionally making
          |     |    use of Hibernate and/or EJB under the hood.
          |     |
          |     +-- pom.xml
          |     |        lists Spring dependencies
-         |     |
          |     +-- /src/main/java
          |     |        Spring classes that need manual implementation are
          |     |        generated here, they will not be overwritten upon
          |     |        regeneration; this includes the service, DAO and
          |     |        entity implementations
-         |     |
          |     +-- /target
          |              the Spring resources and classes here will be
          |              overwriten each time AndroMDA generates new code
@@ -136,22 +129,22 @@
 #end
 #if ($workflow)
          +-- /workflow
+         |     |
          |     |    The Workflow module collects those resources and classes
          |     |    that are needed to support the workflow engine
          |     |
          |     +-- pom.xml
          |     |        lists Workflow dependencies
-         |     |
          |     +-- /src/main/sar
          |     |        files used to configure the workflow engine connection,
          |     |        please note that these files contain properties
          |     |        that will be dynamically replaced during the build
-         |     |
          |     +-- /target
          |     
 #end
 #if ($web)
          +-- /web
+         |     |
 #if ($ear)
          |     |    The WEB module collects those resources and classes
          |     |    that make up the presentation layer.
@@ -163,14 +156,12 @@
          |     |
          |     +-- pom.xml
          |     |        lists WebApp dependencies
-         |     |
          |     +-- /src/main/java
          |     |        controller implementations and editable resource 
bundles
          |     |        will be generated here,
          |     |        you might consider putting your own JSPs here to
          |     |        be copied over the generated ones when bundling the
          |     |        .war file
-         |     |
          |     +-- /target
 #if ($ear)
 #if ($struts)
@@ -186,30 +177,29 @@
 #end
 #if ($webservice)
          +-- /webservice
+         |     |
          |     |    The WEBSERVICE module collects those resources and
          |     |    classes that use the AXIS framework
          |     |
          |     +-- pom.xml
          |     |        lists any dependencies for webservices
-         |     |
          |     +-- /target
          |              generated files are emitted here
          |
 #end
 #if ($ear)
          +-- /app
+               |
                |    The APP module collects those resources and classes
                |    that are required to actually build the .ear bundle
                |
                +-- pom.xml
                |        lists dependencies to be bundles into the
                |        root of the .ear
-               |
                +-- /src
                |        any custom resources that should be deployed
                |        together with the application
                |        (eg. server deployment descriptors)
-               |
                +-- /target
                         a deployable application is bundled here
 #end
@@ -236,7 +226,6 @@
         %> mvn clean
         
             cleans all generated files from each target directory
-            If you clean from /samples, you need to rebuild your 
examples'pom.xml by starting the rebuild from the example mda sub-directory  
             
         %> mvn install -Ddeploy
 
@@ -249,13 +238,9 @@
             any value for this property will build the application for the 
local configuration
             (more info at 
http://maven.apache.org/guides/introduction/introduction-to-profiles.html)
 
-#if ($ear)
-        %> mvn -f app/pom.xml andromdapp:undeploy -o
-#else
         %> mvn -f web/pom.xml andromdapp:undeploy -o
-#end
 
-            undeploys the $applicationType from your application server
+            undeploys the $applicationType from your app server
 
         %> mvn -N andromdapp:build -Dmodules=core (or mvn -f core/pom.xml)
 
@@ -273,12 +258,17 @@
             only build the web module
 
 #end
+        %> mvn nuke
+
+            cleans out all /target directories and removes all Java classes 
with names
+            ending with 'Impl' from the source directories (from the common, 
core and
+            web modules); this goal asks for confirmation, but be careful 
calling it
+            anyway as you will lose your manually edited files
 
         %>  mvn -f core/pom.xml andromdapp:schema -Dtasks=create
 
             generates the DDL create code and subsequently tells the database
-            to create the schema'tables for the entities. The Data Base and 
Schema
-            have to previously exists
+            to create the schema for the entities
 
         %> mvn -f core/pom.xml andromdapp:schema -Dtasks=drop
 
@@ -306,8 +296,6 @@
             to significantly speedup the generation process although it will 
require
             you to use another console while it is running
 
-            you must define the server element within your AndroMDA 
configuration
-
         %> mvn -N andromdapp:build -Dmodules=mda:[andromda:stop-server] (or 
mvn -f mda/pom.xml andromda:stop-server)
 
             stops the AndroMDA server
@@ -344,8 +332,7 @@
 
 
     Please note that you may use the '-o' flag at any time to avoid
-    having Maven repeatedingly downloading any SNAPSHOT dependencies.
-    With this setting downloads are only daily checked. 
+    having Maven downloading any SNAPSHOT dependencies.
 
     Each module will install its artifact into the local Maven repository,
     this might be a directory looking like this:
@@ -354,7 +341,7 @@
         C:\Documents and Settings\\${author}\.m2\repository\\${applicationId}\
 
         (*nix)
-        /home/${author}/.m2/repository/${applicationId}/
+        /home/${author}/.maven/repository/${applicationId}/
 
     For questions or feature requests please use our forum:
     http://forum.andromda.org/



-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://jira.andromda.org/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642

Reply via email to