How to Design and Architect a Java/Java EE web application? [closed]

Answer 1

There are several things you'll need for architecture design documents. Not an easy task but props on taking the opportunity. Since this is such a large question, hopefully these links can get you started and you can refine questions after getting your feet wet.

Methodology

The methodology you use will affect what tasks you take on first. Waterfall is a popular but outdated methodology. A newer methodology is Agile that has several faces. My favorite is Scrum Agile for developing software of any size.

Diagrams

Diagrams are one of the most powerful ways to represent the system as a whole and as individual components. The type of diagrams you create depend on the system. There are usually a Structure Diagrams, Behavior Diagrams, Interaction Diagrams and tons of others. These diagrams show the pieces of the system as a whole, each components physical layout and/or logical layout, communication flow, procedure flow, etc..

Documentation

Documentation is just like it sounds, documents and documents that have Project Descriptions, Scope, User Cases, Sequence Diagrams, and any other document that describes the project or pieces of the project.

Answer 2

Peruse the Agile Modeling site which pushes for "just enough" modeling. They have some great guidelines including a full "agile modeling process" from requirements gathering to design/development.

http://www.agilemodeling.com/

http://www.agilemodeling.com/essays/amdd.htm

http://www.agilemodeling.com/essays/agileArchitecture.htm

http://www.agilemodeling.com/essays/agileAnalysis.htm

http://www.agilemodeling.com/essays/agileDesign.htm

As for tools, I love Visual Paradigm. It's relatively inexpensive (compared to other tools). There are a variety of free modeling tools (google is your friend), but none compare to Visual Paradigm, and for bit that it costs, it's well worth it. If my employer didn't pony up the cash for it, I would buy it myself... :)

Answer 3

There's a good blog post by @tom on reflectoring.io I recently read which may help you. It helped me!

A Checklist for setting up a Java-based Software Architecture

Here are the list of high level topics discussed,

• Architecture Style
• Back-End Concerns
• Frontend Concerns
• Operations Concerns
• Development Concerns

Thanks

Answer 4

I have edited a new book on Spring, Hibernate and Data Modeling which will answer your query on the design aspect of a Java EE web application. Typically a Java EE Web application has 5 tiers - client, presentation, business service, data access and resource(entity). The book focuses on how to design and develop each of these tiers by taking examples of all relationships of data modeling using Spring and Hibernate. As a download an entire web application is given where you would find information on managing each relationship of data modeling scenario.

Let's look at a simple standalone entity. In order to manage the entity, methods like create, read, update, delete and find all records have to be designed. So if we go bottom up, the entity creation forms the first step. Next we look at the Repository which has methods described above. Further up comes the business service tier and then the REST Spring controller which is JSON-based. The remaining task involves coding the JSP page and JQuery AJAX calls to the REST Controller.

You can find more information on the book here

Answer 5

Take a look at Robert Martin's (aka Uncle Bob) Clean Architecture. Here's a quick overview. Using this approach, you'll be able to defer details like Spring or Hibernate to a later time and focus more on the business logic. Or even migrate from Spring to Java EE without touching your business and application logic. You'll also get a testable application that complies with the SOLID principles, without too much additional effort.

I've just created an application this way and I must say I'm very happy with it. I could easily port it to a desktop or mobile application, or swap out the storage module. Details depending on policy goes a long way. It also promotes thinking in an API kind of way and, when applied correctly, making your modules very reusable.

Martin goes as far as saying details like frameworks are annoying and not part of your architecture. I do think they belong to architecture, but just at a different level. Often times you do want to include frameworks at an early stage to be able to produce a thin slice of a working application to demo to your users. Or when you know your frameworks in advance and there is no discussion about them, like in my case. But you could regard it as separate software architectures, when combined together create your application architecture.

Answer 6

I can add my 2 cents from my own experiences (although its more of a compilation of development best practises, you might find it useful to keep them in mind while designing your application):

• There is no one-size-fits-all design
• Try to keep application as light weight as possible.
• Use Maven/Gradle to manage dependencies
  • Don't rely excessively on IDE. Make sure your project builds without IDE (If you are using maven/gradle, It will :) Try to open you project with IDEA, Netbeans and Eclipse.
• For the technologies mentioned above, appfuse makes a good starting point.
• Design your database/entities first
• Use libraries sensibly and judiciously. Do NOT overuse them.
• Dont forget to write JUnit/TestNG (at least for service layer)
• Test application on all major browsers (not just your favorite one :)
• Determine how many total users and how many concurrent users your web app will have.
  
  • Then decide whether you need caching or not.
  • you will use app server clustering or not.
• Select the application server based on its capabilities and more importantly 'your needs'
  • Tomcat / Jetty are absolutely fine for most of the cases
• Avoid using any app-server specific api
• Use JPA interfaces/annotations even if using hibernate as JPA implementation
• Be extra cautious while mapping relationships in entities. Decide which properties and relationships will load lazily and which will load eagerly
• Keep application security in mind while designing the app. Spring security is excellent choice.
• Never abuse HttpSession. Dont store too much in it.
• Keep entities Serializable. Enforce developers to use toString(), hashCode() and equals()
• Dont Forget to use version controlling from Day 1
• Dont just assume that spring/hibernate/spring-mvc will be best choice for you. create small proof of concepts with atleast 3 to 4 options.
• Try to automate integration/build/deploy with CI tools like Jenkins
• Check and Tune SQL generated by Hibernate (time to time)
• Do not let business logic creep into view layer. Hate jsp scriptlets? Consider Velocity/Freemarker. JSP is not the only option.
• externalize the environment specific configuration by using Spring's PropertyPlaceholderConfigurator.
• If possible, try to integrate with existing User Authentication mechanism (Like LDAP/ OpenID) rather than writing your own. This will save you from reinventing the wheel and your users from remembering yet another set of username and password.