AmbySoft Inc. Java Coding Standards,
by Scott W. Ambler

Java coding standards v17.01a. Last updated on July 10th & 18th, 1997.


This page is a (revisited) mirror page

last modified
(mm/dd/yy hh:mm:ss GMT+1)
published
(with the agreement of the original author Scott W. Ambler)
by marc.meurrens@acm.org (http://homepages.ulb.ac.be/~meurrens)

URL of the original document
http://WWW.AmbySoft.com/javaCodingStandards.html
by Scott W. Ambler (ambler@hookup.net)

URL of our page(s) on "Java OO Design & Coding Standards"
(where this document is referred as detailled below):
http://www.ulb.ac.be/esp/ip-Links/Java/joodcs/index.html
[back]

AmbySoft Inc. Java Coding Standards
is a revisited mirror (published with the agreement of the original author Scott W. Ambler) of http://WWW.AmbySoft.com/javaCodingStandards.html by Scott W. Ambler (ambler@hookup.net)
Includes 2 PDF files where the author seriously documents his proposal. You'll find here a structured sum of ideas and proposals gathered from miscellaneous authors.

Pre-prepared links (to this document)

A list of approx. 356 "pre-prepared" links to this page is available at URL http://www.ulb.ac.be/esp/ip-Links/Java/joodcs/ambler-LinksTo.html. ( updated August 6, 1997)
These links are (or will be) used in other pages related to "OO design and Coding Standards".

AmbySoft Inc. Java Coding Standards
by Scott W. Ambler

A table of content of this MIRROR page is available here.

Whenever I start working with a new language one of the first things that I try to do is determine what coding standards and guidelines for that language exist. When I first started working with Java in the Autumn of 1995 I couldn't find any. When I went looking again a year later I found some, listed later in this web page, but they weren't sufficient for my needs. The information that I found was fairly good, for the most part, but some of it was contradictory and none of it was complete. Furthermore, some of the papers were not based on sound software engineering principles, but were instead oriented towards banging out code very quickly. Because I believe in writing code that is easy to understand, to maintain, and to enhance I decided that I needed to put together a standards and guidelines document for Java coding. I also decided to share it with you, so here it is in its entirety for you to download.

javaCodingStandards.pdf 
or a local mirror:
Ambler-javaCodingStandards.pdf 
195k Java coding standards v17.01a. Last uploaded on July 10th, 1997.
javaCodingStandardsSummary.pdf
or a local mirror:
Ambler-javaCodingStandardsSummary.pdf
46k Summary of the Java coding standards above, perfect for quick remider lists or pinning to your wall.

Download Acrobat Reader Download Acrobat Reader

I hope that you find these documents useful, and I also hope that you help me to improve them by providing me with feedback. If you have any other guidelines and standards that your organization uses, let me know about them. If you disagree with anything that I've included in these standards, think about it first because I don't like getting flamed, but then email me with your opinions because I want to hear them. If something isn't well explained or you don't quite understand it, let me know so I can improve these standards. I'd really like to get some feedback on my proposed tags for javadoc and I'd also like to talk to some people who have any guidelines or standards for concurrent programming. I've been working on some, but haven't included them in this version, because I need to work with them and test them further on real-world applications. Don't worry, anyone who provides me with useful information will be acknowledged in the document. Let's work together so that we can all benefit.

Other Coding Standards and Guidelines (Referred to in the AmbySoft standards):

http://www-cad.eecs.berkeley.edu/~wbaker/coding-standards/
Coding Standards Repository
Some Coding Standards and Language Style Commentaries
(mirrored here)

http://g.oswego.edu/dl/html/javaCodingStd.html
Doug Lea's Draft Java Coding Standards
(mirrored here)

http://v2ma09.gsfc.nasa.gov/coding_standards.html
Nasa Draft Coding Standard for Java
Coding Standards for C, C++, and Java
(mirrored here)

http://reality.sgi.com/sandvik/JavaGuidelines.html
Java Style Guidelines
(mirrored here)

http://dubhe.cc.nps.navy.mil/~java/course/styleguide.html
U.S. Navy Java Style Guidelines
(mirrored here)

 

http://WWW.AmbySoft.com/index.html
ambler@hookup.net
White Papers
The Object Primer
Building Object Applications That Work


Last Updated: July 18th, 1997
URL: http://WWW.AmbySoft.com/javaCodingStandards.html
Copyright © 1997 AmbySoft Inc.

Brussels, last modified:
mirror of July 18, 1997 by Scott W. Ambler (ambler@hookup.net)
published by marc.meurrens@acm.org (http://homepages.ulb.ac.be/~meurrens)
original URL: http://WWW.AmbySoft.com/javaCodingStandards.html
current URL: http://www.ulb.ac.be/esp/ip-Links/Java/joodcs/Ambler.html
internet programming Links: http://www.ulb.ac.be/esp/ip-Links (ip-Links)
Université Libre de Bruxelles: http://www.ulb.ac.be (ULB)
La Cambre - Architecture: http://www.lacambre-archi.be
Belgian JAVA User Group: http://www.bejug.org (BeJUG)
 
Use this form to send your feedback and/or submit a link
(please, replace sample texts by appropriate data before submitting!)
From
your e_mail :
your URL :
To ambler@hookup.net ; meurrens@ulb.ac.be ; sja@bejug.org
Subject
Link
Comment
 
Conventions used in these pages:
html file, text file or java or CPP source located on our site
download area (on our site) or file to be downloaded (use the right button of your mouse)
document on a belgian academic or scientific site
document (on another site) or link to be fixed or link we didn't visit/evaluate; documents indicated with their full URL will be displayed in their own "top" window.
ftp download or file to be downloaded (use the right button of your mouse)
indicates a "mailto" link.
and indicate links added or updated within the last month.
Click on the separator to reach a higher level in the page or site hierarchy.
 

joodcs home e_mail feedback ULB ESP ip-Links La Cambre BeJUG proposal