logging and documentation

[Yupp Cook]

Hi all ranchers!

I have 2 questions. First concerning logging:

(1) Is logging required even though not explicitly mentioned in the instructions? If so, logging on server AND client side is necessary?

(2) My instructions:
You must provide basic user documentation...This documentation must be in one of these three formats:

* HTML
* Plain text (not a wordprocessor format)
* Within the application as a help system.

All the gui examples presented here have the user documentation within the application as a help system. Would it be bad style to just add a plain text file realizing the 2cnd possible choice. So the gui would remain without any file menu.

Thanks for your opinions.
Y.

[Brian Kelly]

2) Kasper, the guy that got 100% (400/400), had a txt file, so I don't think that would be a problem.

As for 1), I don't know. There are NO requirements for logging so I'm not doing it. After reading Kasper's (very good) description, I'm just doing the "musts" and nothing more...but then I'm only going to send my assignment in next week...

[Jason Moors]

As Brian has stated logging isn't a requirement of the project, however I would recommend using logging and have found it very useful for debugging/testing the application, especially in the Data class for locking etc.

I don't think you will lose any marks for adding logging as long as it doesn't impact the readablity of the code.

Regards
Jason

[Yupp Cook]

Hi thanks for your response.
I decided to use logging.

Problem now it doesn't only log to a file but also the console.
I ve no idea how to turn console logging off. I tried to remove all Hanlders but there aren't any.

Any idea? This is a code fragment:

private static Logger logger = null;

static {
logger = Logger.getLogger("suncertify.Logger");
Handler handler;
try {
handler = new FileHandler(Constants.LOG_FILE, true);
}
catch(IOException ioe) {
System.out.println("File logging not initialized.");
System.exit(0);
}

handler.setFormatter(new SimpleFormatter());
logger.addHandler(handler);
logger.setLevel(Level.ALL );
}

[Jason Moors]

This easiest way is to modify your logging.properties instead of code, which you should find under your JAVA_HOME/jre/lib directory.

handlers= java.util.logging.ConsoleHandler

to

handlers= java.util.logging.FileHandler

Regards
Jason

[Yupp Cook]

I found it myself.

logger.setUseParentHandlers(false);

turns Console logging off.

Thank you anyway.