Presentation: Code Organization Guidelines for Large Code Bases

Posted by Floyd Marinescu on Jun 21, 2007

Sections

Process & Practices,

Development,

Operations & Infrastructure

Topics

Java ,

Debugging ,

Delivering Quality ,

Build systems

Tags

Structure101 ,

Spring

Structuring a large code base maintained by multiple teams working in parallel can be a real challenge. If you are not disciplined about code structure overtime you will end up with a tangled, unmaintainable mess that cannot adapt to change and risks ossifying into legacy. In this session Juergen will pull from his experiences working on large projects (including his role as chief architect of the Spring Framework) to provide general guidelines on:
- Packaging and package interdependencies
- Layering and module decomposition
- Evolving a large code base

Watch  Code Organization Guidelines for Large Codebases (1hour 28 min)

Juergen's conclusions:

  - The evolution of a large code base is a tricky challenge...in particular if backwards compatibility is an issue and architectural quality remains a goal!
 - Central issue: package interdependencies
     - Avoid circular references between packages, at (nearly) any cost!
 - Consider the use of tools for ongoing validation of your architecture
    - e.g. JDepend, SonarJ

Much of the presentation was spent explaining how to minimize dependencies between modules (especially cyclic dependencies) and how Juergen manages Spring's codebase to tight standards of quality.  Juergen also demonstrates how he uses JDepend and SonarJ on Spring's codebase, and near the end for fun does a package dependency comparison between Spring and Hibernate.

Update: The slides can be downloaded here.

1. Back to top

   Are the slides available?

   by Oliver Henlich

   Hi.
   Had a quick surf and could not seem to find the slides to download.
   Anyone know if they are available anywhere?
   Cheers
   Oliver

   Reply

2. Back to top

   Slides please?

   by Angeline Tan

   I would like to add a request for the link to the slides?
   
   Thanks!
   Angie

   Reply

3. Back to top

   Can I download the slides?

   by Lam Nguyen

   I'd like to download the slides. Is it possible? Thanks.
   
   Regards,
   Lam

   Reply

4. Back to top

   Are the slides available for download?

   by Luiz Almeida

   I would like to get the slides. Is it possible?

   Reply

5. Back to top

   Re: Are the slides available?

   by Andrea Del Bene

   I think that Juergen should publish his slides on SpringOne site soon or later.
   I mean, SpringOne speakers, Interface21 guys in particular, use to do so.
   
   My two cents.
   Andrea "Italian Spring lover :-)"

   Reply

6. Back to top

   Good summary of this presentation

   by Floyd Marinescu

   Mike blogged a great summary of this presentation here.

   Reply

7. Back to top

   Slide available now

   by Andrea Del Bene

   Slide are now available from SpringOne site wiki.
   Login is required.
   
   Cheers

   Reply

8. Back to top

   Here are the slides

   by Floyd Marinescu

   You can download the slides here.

   Reply

9. Back to top

   Large Code Bases in the .NET sphere

   by Patrick Smacchia

   In the .NET sphere we are also facing the same kind of problem. I wrote and article about that, that describes similar answers:
   
   Control component dependencies to gain clear architecture
   www.theserverside.net/tt/articles/showarticle.t...

   Reply

• Older >