How do you structure a java program?

Question

For quite awhile I have been trying to make a simple "game" in Java that is really just an applet with a square and a grid. What I want it to do in the end is the user clicks and the square will move to where the user clicked rounded to the nearest grid square.

The problem is I am a self taught beginner and I am having a hard time figuring out how to actually structure the program, some examples:

• should I have a separate class listening for mouse clicks?
• When I receive a click should I send it to some other object that represents the box and let it decide what it wants to do or just call some function that makes the box move?

I really want to learn all this "when to use what" stuff for myself so any links or general advice is appreciated.

Answer 1

One main principle of good software development is the Single Responsibility Priciple. It states that a function or class should only have one responsibility.

This way your classes and objects shouldn't become too big and unmanageable.

Answer 2

I think one of the most important concepts to master when developing software is the concept or Orthogonality. It's not the simplest definition, but in essence it means that one component (such as reading mouse clicks) shouldn't be directly tied to an unrelated component (moving a square on the screen).

In your case, the code reading mouse clicks should be separate from the code that actually moves the box. Whether you implement this as inner/anonymous classes or not is up to you. But if you follow the Orthogonality principle, it will be easy to change at a later date should you change your mind.

Answer 3

Step 1 - find the demo applets supplied by Sun. http://java.sun.com/applets/jdk/

Step 2 - read those demo applets. At least three. Preferably all of them.

One you've read several applets, you should see a little more clearly how to organize programs. You can then ask questions with a lot more focus pointing to specific applet examples and your specific programming problem.

Answer 4

What you're really asking is how to develop a game, which is notably different from a typical Java application. However, I'll give you a few ideas to at least point you in the right direction.

• Take advantage of the fact that Java is an object-oriented language. That is, objects should each have their own responsibility.

• Separate your game into three key layers: the application layer, the game logic layer, and the presentation layer.

  • The application layer should contain all of your helpers and generic subsystems, things like random number generators, text parsers, file access modules, mesh loaders, etc.
  • The game logic layer should implement all of the rules of your game, and be responsible for maintaining canonical state. Basically, when you press the "W" on the keyboard to move forward, the game logic layer should receive MOVE_FORWARD_REQUEST from the UI.
  • The presentation layer should be responsible for two things: getting input, and rendering your world. When it gets input, like the "W" key, it should map that to an action, and send that to the game logic layer to be processed. Then, it should render the world based on whatever the game logic told it to do.

Game development is obviously an entire realm with many books dedicated to it. One of my favorites is Game Coding Complete, which does focus on C/C++, but should give you a good idea about how you ought to structure your game.

Good luck!

Answer 5

Yeah, I'm a beginner programmer myself. Yeah, segregating functionality across multiple classes is a good way to reduce complexity and increase cohesion of individual classes.

Increasing cohesion good because by having more complex data structure your algorithms become less complex and your code is less dependent on each other.

For instance in your case it might be a good idea to separate the classes in accordance to MVC (Model View Controler).

• You have a Model which represents the way your game data is structured.
• You have a Viewer which present your Model in what ever form you please.
• Have a Controller which picks up changes in the Model (via Listeners) and then updates the Viewer

Now you can change your Model and add extra functionality requiring only small changes in the way the Viewer works.

There are many Patterns out there but there isn't a hard rule when to use one over the other. There are some cases in which you can use several and there are cases in which will require you to chose one design pattern over the other.

Answer 6

Every beginning Java programmer should start with the Sun Tutorials. They are quite good.

Another good source, especially among free sources, is Bruce Eckel's "Thinking in Java", available from http://www.mindview.net/Books/TIJ/.

But the latter is a little dated compared to the former. That is why I recommend both.

Answer 7

... the user clicks and the square will move to where the user clicked rounded,
to the nearest grid square.

Here is an example of doing this in a scaled view.