Skip to main content

If you don't have an IBM ID and password, register here.

By clicking Submit, you agree to the developerWorks terms of use.

The first time you sign into developerWorks, a profile is created for you. This profile includes the first name, last name, and display name you identified when you registered with developerWorks. Select information in your developerWorks profile is displayed to the public, but you may edit the information at any time. Your first name, last name (unless you choose to hide them), and display name will accompany the content that you post.

All information submitted is secure.

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerworks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

By clicking Submit, you agree to the developerWorks terms of use.

All information submitted is secure.

Organizing your EJB project environment

How to establish the right tools, standards, and guidelines for your project

Scott W. Ambler, Prectice Leader, Agile Development, Rational Methods Group, IBM, Software Group
Scott W. Ambler is a Practice Leader for Agile Development within the IBM Methods group. He develops process materials, speaks at conferences, and works with IBM clients worldwide to help improve their software processes. Scott is author of several books, listed on his Web site at www.ambysoft.com. Scott is also a recognized Ratonal Thought Leader, whose homepage may be viewed here.

Summary:  Without a solid foundation, your Enterprise JavaBeans (EJB) project is sure to flounder. Scott W. Ambler explains why you should define your environment in the early stages of development, and offers tips for doing so.

Date:  01 Jul 2001
Level:  Introductory

Comments:  

Early in your project, typically part of your environment workflow efforts if you are following either the Rational Unified Process (RUP) or the Enterprise Unified Process (EUP), you need to define your project team's technical environment. This encompasses selecting and then installing the appropriate standards, guidelines, and development tools that your project team will use.

To be successful at this effort you must consider the following:

  1. Recognize that tools, standards, and guidelines are always getting better. Any tool you choose today will likely be superceded tomorrow by one of its competitors. Does that mean you should switch tools? Likely not, because the cost of purchasing it, installing it, and retraining the whole team on it will likely outweigh the benefits of its new features. Besides, your tool vendor will soon release a new version of its own to keep up with the competition, and the last thing that you want to do is yo-yo back and forth between development environments: Do that and you'll never get around to your real work -- the development of EJB software. Changing tools, particularly in the middle of a project, can be a risky and expensive process. If you find that a tool does not live up to your expectations, then you should consider dropping it or upgrading if a new version exists. But if the tool works well, then stick with it. The same thing can be said of standards and guidelines.
  2. Set up your project environment as early in the project as possible. Your project environment lays the foundation for how your development team will work together, so you need to lay the foundation as early as you can. Teams that leave tool selection to the last minute find that they do not have enough time to train everyone in their effective use. Leaving the choice of standards and guidelines until late in the project results in inconsistent work, strife within the team, failed reviews, and sometimes even significant rework.
  3. Product reviews are useful, but not the final say. When you do a quick search online you can find a wide variety of independent product reviews -- particularly in magazines such as JavaPro, Java Report, and Software Development (see Resources) -- that give you a pretty good idea what each tool can do. Reviews help you to narrow your scope, but you'll still need to evaluate the tools within your own environment to make the final selection. You should also consider hiring a consultant to help you define a project environment and to ensure that you make the most appropriate choices for your situation. Furthermore, newsgroups for the specific tools, or portal sites such as The Server Side (see Resources) provide very good insight into what actually works.
  4. Your project environment must reflect your methodology/process. When your project environment and software process are inconsistent, your team will quickly discover that it needs to expend significant effort to stay on schedule (due to the need to work around challenges created by its insufficient project environment). For example, if you're taking an iterative and incremental approach to development, you need testing tools that strongly support regression testing. Otherwise you'll be handcrafting your own regression test suites. Also, if you've chosen to take a use case-driven approach, then you obviously need tools that support development of use cases.
  5. Choose your project environment based on requirements. If you don't know what you're shopping for then why are you shopping? For example, before you can choose your testing tool(s), you need to first identify the types of testing you intend to perform.
  6. Don't evaluate every single option in each category. There are hundreds of development tools available to Java developers, but you will only use a handful of them on your project. Narrow your scope to a few candidates, obtain review copies, put them through their paces, choose your environment, and move forward. Remember the KISS principle: Keep It Simple, Stupid!
  7. Adopt a tool only if you will benefit from it. Purchasing a tool that costs $3,000 per developer seat is a good deal if everyone is using it to its full potential. However, it's an incredibly bad deal if your developers are only using a small portion of its capabilities that could have been obtained from a simpler and less expensive tool. Also, remember that you can find a wide range of free tools online with a bit of searching.
  8. Expect to train. You can't put a tool, or a standards document, or a software process on someone's desk and expect them to be proficient with it that very day. For more on this, see last week's tip on EJB training. (Also note that next week's tip will address further training issues).
  9. Adopt existing standards, guidelines, and tools. Although it is often tempting to try to write your own development guidelines, or build your own tools, or integrate several tools on your own, you should only do so if you can do it with very little effort. Otherwise, you are better off adopting a pretty good, although not perfect, project environment and getting on with your real job of developing software.

Note: This tip was excerpted from the forthcoming Mastering Enterprise JavaBeans, Second Edition to be published in autumn 2001.


Resources

About the author

Scott W. Ambler is a Practice Leader for Agile Development within the IBM Methods group. He develops process materials, speaks at conferences, and works with IBM clients worldwide to help improve their software processes. Scott is author of several books, listed on his Web site at www.ambysoft.com. Scott is also a recognized Ratonal Thought Leader, whose homepage may be viewed here.

Report abuse help

Report abuse

Thank you. This entry has been flagged for moderator attention.


Report abuse help

Report abuse

Report abuse submission failed. Please try again later.


developerWorks: Sign in

If you don't have an IBM ID and password, register here.


Forgot your IBM ID?


Forgot your password?
Change your password


By clicking Submit, you agree to the developerWorks terms of use.

 


The first time you sign into developerWorks, a profile is created for you. This profile includes the first name, last name, and display name you identified when you registered with developerWorks. Select information in your developerWorks profile is displayed to the public, but you may edit the information at any time. Your first name, last name (unless you choose to hide them), and display name will accompany the content that you post.

Choose your display name

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

(Must be between 3 – 31 characters.)


By clicking Submit, you agree to the developerWorks terms of use.

 


Rate this article

Comments

Help: Update or add to My dW interests

What's this?

This little timesaver lets you update your My developerWorks profile with just one click! The general subject of this content (AIX and UNIX, Information Management, Lotus, Rational, Tivoli, WebSphere, Java, Linux, Open source, SOA and Web services, Web development, or XML) will be added to the interests section of your profile, if it's not there already. You only need to be logged in to My developerWorks.

And what's the point of adding your interests to your profile? That's how you find other users with the same interests as yours, and see what they're reading and contributing to the community. Your interests also help us recommend relevant developerWorks content to you.

View your My developerWorks profile

Return from help

Help: Remove from My dW interests

What's this?

Removing this interest does not alter your profile, but rather removes this piece of content from a list of all content for which you've indicated interest. In a future enhancement to My developerWorks, you'll be able to see a record of that content.

View your My developerWorks profile

Return from help

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=SOA and web services
ArticleID=86960
ArticleTitle=Organizing your EJB project environment
publish-date=07012001
author1-email=scott_ambler@ca.ibm.com
author1-email-cc=

Tags

Help
Use the search field to find all types of content in My developerWorks with that tag.

Use the slider bar to see more or fewer tags.

For articles in technology zones (such as Java technology, Linux, Open source, XML), Popular tags shows the top tags for all technology zones. For articles in product zones (such as Info Mgmt, Rational, WebSphere), Popular tags shows the top tags for just that product zone.

For articles in technology zones (such as Java technology, Linux, Open source, XML), My tags shows your tags for all technology zones. For articles in product zones (such as Info Mgmt, Rational, WebSphere), My tags shows your tags for just that product zone.

Use the search field to find all types of content in My developerWorks with that tag. Popular tags shows the top tags for this particular content zone (for example, Java technology, Linux, WebSphere). My tags shows your tags for this particular content zone (for example, Java technology, Linux, WebSphere).