• Post Reply Bookmark Topic Watch Topic
  • New Topic
programming forums Java Mobile Certification Databases Caching Books Engineering Micro Controllers OS Languages Paradigms IDEs Build Tools Frameworks Application Servers Open Source This Site Careers Other Pie Elite all forums
this forum made possible by our volunteer staff, including ...
Marshals:
  • Campbell Ritchie
  • Jeanne Boyarsky
  • Ron McLeod
  • Paul Clapham
  • Liutauras Vilda
Sheriffs:
  • paul wheaton
  • Rob Spoor
  • Devaka Cooray
Saloon Keepers:
  • Stephan van Hulst
  • Tim Holloway
  • Carey Brown
  • Frits Walraven
  • Tim Moores
Bartenders:
  • Mikalai Zaikin

Pls Help ( javadoc comment for DataAccessFactory)

 
Ranch Hand
Posts: 100
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Hi Mark
javadoc comment for DataAccessFactory
----------------------------------------
My design is somewhat similar to your design where i have a FBNDataAccessFactory which has getDataAccess(dns,port) and getDataAccess(locladb) method for getting data access in local or network mode.
Now the problem is how to put javadoc comment for the class becoz being a connection factory it is returning a connection to remote data server and in local mode it is returning a connection to database and not server.
Problem is of connection to data server or local database
Amit
[ June 25, 2002: Message edited by: Amit Kr Kumar ]
[ June 25, 2002: Message edited by: Amit Kr Kumar ]
[ June 25, 2002: Message edited by: Mark Spritzler ]
 
ranger
Posts: 17347
11
Mac IntelliJ IDE Spring
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Here's my javadoc for the class portion of my Factory

Then each method has it's own.
Here's my javadoc for Remote mode method

Here's my local method javadoc


Hope that helps. And don't copy it word for word.
Mark
 
Ranch Hand
Posts: 2937
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator


* @param String host - the server host URL.


Mark,
I see that you are using the
@param <Type> <param> - <description>
format instead of
@param <param> <description>
In one of the recent posts here, someone pinted out that this is wrong. You don't need a dash either, -- it will be generated. Any reasons that you've used your javadoc format?
Eugene.
 
Ranch Hand
Posts: 82
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
I elected to use the latter appraoch

@param <param> <description>

. It confused me which format to use, considering the original files seem to use both. I just picked one and stayed consistent with it throughout.
Both ways seemed to work fine for when I generated the javadocs, and didn't think either way would have a big impact on my score.
Mike
 
Mark Spritzler
ranger
Posts: 17347
11
Mac IntelliJ IDE Spring
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Actually I thought I had just copied and pasted from their code and used the same standard.
Also if you don't include the type then the type didn't show up in the Javadoc, and if you look in the Java Api Javadocs they all have type in the html pages.
I got 20/20 on docs, so my guess is either way will work fine.
Mark
 
John Smith
Ranch Hand
Posts: 2937
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Mar wrote:


.. and if you look in the Java Api Javadocs they all have type in the html pages.


Actually, Java Api Javadocs don't have type. Here is a typical example from JDK 1.3.1:
The following SUN source in String.java (notice that there are no types or dashes:

Eugene.
 
Mark Spritzler
ranger
Posts: 17347
11
Mac IntelliJ IDE Spring
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
You just posted a constructor, they don't have return values. If you look at an actual method that returns a value you will see it.
Let's also say that without it, I never got the return values to show up in my Javadocs. But when I put it in there it did show.
Mark
 
Mark Spritzler
ranger
Posts: 17347
11
Mac IntelliJ IDE Spring
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
And this is taken directly from the DataInfo class that Sun provides

As far as the dash, I don't think those are necessary.
Mark
 
With a little knowledge, a cast iron skillet is non-stick and lasts a lifetime.
reply
    Bookmark Topic Watch Topic
  • New Topic