[ 
https://issues.apache.org/jira/browse/WW-3993?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13969384#comment-13969384
 ] 

Antonio Sánchez commented on WW-3993:
-------------------------------------

IMHO:

1. If REST is the best approach, the fact remains unnoticed in documentation 
pages. Introductory documentation is intended for newbie developers, like my 
case, and newbie developers need technical instruction as well as a guidance 
for best practices. If I had to begin a new project I would follow old CRUD 
approach, being unaware that REST is a more recommended technique. 

2. Yes, there are some CRUD examples in documentation, many of them are 
external and long articles that won't be read by almost any developer. This is 
confusing and overwhelming. There should be only one CRUD page, as concise as 
possible, and continuing the Getting Started guides. 

3. There are different approaches for CRUD, which is the recommended one? . For 
instance, we've seeing here that (@InputConfig + defaultStack) may replace 
paramsPrepareParams (if this is not exactly correct, please let me know). I 
like this approach, as 'input prepare' is only called when required, avoiding 
method proliferation (prepareInput, prepareSave, prepareGeneral... ). 

4. Remember this project at its current state:

https://github.com/juntando-lineas/pro-crud-struts2

is the exact CRUD continuation of the Getting Started series. 

5. The original 'Struts 2 CRUD Example' is: 

http://struts.apache.org/release/2.3.x/docs/crud-demo-i.html

linked from 

http://struts.apache.org/release/2.3.x/docs/tutorials.html

as 'CRUD made easy'. 

BTW, link to war file is broken and the tutorial itself is obsolete. This 
project aims to update it to make it work with current Struts2. And BTW, there 
some examples in Getting Started that fail to work (I don't remember which one 
at this moment).

6. I'm willing to help with these examples related tasks, just let me know, but 
remember I am a newbie who is interested in learning Struts2. 

7. Also, in general, from my newcomer standpoint, I miss documentation for best 
practices, how to organize a new project, etc... I mean, information for 
professional development with Struts2. Probably this missing is intentional but 
I believe that it would be great to have this kind of documentation in Struts2 
site.

Sorry for the long comment.



> How to implement simple CRUD application
> ----------------------------------------
>
>                 Key: WW-3993
>                 URL: https://issues.apache.org/jira/browse/WW-3993
>             Project: Struts 2
>          Issue Type: Sub-task
>          Components: Example Applications
>            Reporter: Lukasz Lenart
>            Priority: Minor
>             Fix For: 2.3.18
>
>         Attachments: crud-with-maven.7z, crud-with-maven.7z
>
>
> Rewrite to Maven based project and with the latest Struts version
> https://cwiki.apache.org/confluence/display/WW/CRUD+Demo+I



--
This message was sent by Atlassian JIRA
(v6.2#6252)

Reply via email to