How Files Are Organized

The truth is, it's entirely up to you. You have basically two options for organizing your files:

If you're not interested in letting Eclipse organize your files for you, you may feel free to skip the rest of this page, and also skip setting up a workspace. When you read setting up a project, skip to the second half. If you'd like your files auto-managed, read on.

Workspaces and Projects

Eclipse uses two basic abstractions to manage your code:

In short, your workspace is going to contain a lot of projects. It will be the folder that holds all your projects. And that's mostly all it is: a folder on your hard drive.

Workspace and Project Organization

Whenever you make a project inside of Eclipse, Eclipse will auto-magically create a new folder in your workspace with the same name. Inside of that folder it will create two folders: bin, and src (source). The bin folder can be ignored. This is nothing more than the folder in which Eclipse stores the .class files generated by compiling your code (which it does automatically; see compiling). The source folder is where all of your Java files will be saved.

a project and its corresponding folders

The project's layout in the Navigator view
The project's layout in the Package view
The project's layout in actual files and directories

So in the end, there's no voodoo going on under the hood. It's very simple. Your workspace is the containing directory for your projects, which are in turn directories named after the corresponding projects.

Pros and Cons