JavaDoc Question

I am very new to java, and i just finished learning about packages, and now i am learning about the javadoc tool and i am trying to test it out but for some reason it is not working for me. Here is what i have do so far i created a package:
Package name is "chp7"
C:\JavaProgs\chp7
and a file called TestOne.java
and i compiled it and ran it and it works fine, but now i am trying to run the javadoc tool agains it and it keeps giving me these errors:
C:\JavaProgs>javadoc -d C:\JavaProgs\chp7 chp7
Loading source files for package chp7...
javadoc: warning - No source files for package chp7
Constructing Javadoc information...
javadoc: warning - No source files for package chp7
Standard Doclet version 1.4.1
Generating C:\JavaProgs\chp7\constant-values.html...
javadoc: No public or protected classes found to document.
1 error
2 warnings
Can someone please tell me what i am doing wrong, any help would be very much appreciated.

http://www.internation.co.uk/java/zine/97_02/How_to_use_javadoc.html
Just gave that link to someone else.
Regards,
Viru.

Similar Messages

Code completion and Javadoc question in JDeveloper

Hey guys,
I think this is a very n00b question, but I cannot for the life of me figure this one out. I was wondering when the code completion window shows up to assist me in selecting the correct method, I was wondering if there was a way for it do display the Javadoc for that method as well in the same window. That way I dont have to keep going to the browser to refer the JDK 5 API on the web.
Thanks.
Surya

Not in the same window, but pressing ctrl+D while standing on an object will pop up the quick javadoc.

Javadoc Question - Please Help

How do you include comments for private members of a class,so that all private members are documented in your Javadoc output?
I know there is a command you can use on the command prompt :
javadoc -private MyClass.java
But I am using Netbeans IDE 5.5.1 and was wondering if there is a setting i can change to do this?

There might very well be such a setting, and the NB mailing lists or Nabble forums are where the question should be asked, since you are unable to use Java's command capabilities, and this is not a NB support forum.

Javadoc question about top-level specification

Quoting
http://java.sun.com/j2se/javadoc/writingapispecs/index.html#top-level
Top-Level Specification
The top-level specification is composed of those specifications that apply to the entire set of packages. It can include assumptions that underlie the other specifications, such as all objects are presumed to be thread-safe unless otherwise specified.
In addition to the class specific requirements, there are overall Java platform API documentation requirements with respect to handling unchecked exceptions (exceptions that derive from java.lang.RuntimeException). It would be helpful to develop some blanket statements that describe the general situations when a Java application should be prepared to encounter one or more RuntimeExceptions.
My question is how do you get an HTML file included in the Javadocs so they show at the top level where the packages are listed?
Thanks
Bill

Yes, that would seem to be apply, but I had some questions.
1. This seems to suggest that overview.html will be added to the package-summary generated for each class. That is not what I want.
2. I could not make it work. Here is the command I am using to build the javadocs.
javadoc -d docs -author -overview overview.html -doctitle "CkEntry / CkViewer Application and APIs" -sourcepath d:\workspace\ckviewer\src cprs.as400 cprs.ckentry cprs.ckviewer cprs.pc5250 cprs.roi cprs.util neva vistech.imageviewer vistech.jai.render vistech.util 1>jdocs_out1.txt 2>jdocs_out2.txtjavadoc has a problem with overview.html. This is the single line in jdocs_out2.txt:
javadoc: Error while reading file overview.htmlNot very informative. Overview.html is in the folder identified by -sourcepath
Thanks for looking at this. I appreciate the help.

Javadocs question

im trying to creat a javadoc for my classes
some classes work fine, but others result in this error message:
Generating javadocs/gunsprite\constant-values.html...
javadoc: No public or protected classes found to document.
1 error
Tool completed with exit code 1
can anyone help with this gunsprite is a public class as far as i can see.
also is there a way to combine several classes into 1 document at the moment im having to put each class in its own html directory.

import java.awt.*;
import java.applet.*;
import java.awt.event.*;
class GunSprite extends BitmapSprite
implements Moveable,Intersect {
protected GunManager gm;          // pointer to manager class
public GunSprite(Image i, Applet a,GunManager gm) {
    super(i,a);
    this.gm = gm;
// the following methods implement Moveable:
public void setPosition(int x,int y) {
    locx = x;
    locy = y;
public void setVelocity(int x,int y) {
public void updatePosition() {
// the following methods implement Intersect:
// compare bounding boxes
public boolean intersect(int x1,int y1,int x2,int y2) {
    return visible && (x2 >= locx) && (locx+width >= x1)
      && (y2 >= locy) && (locy+height >= y1);
// tell manager to display the hit
public void hit() {
    gm.handleHit();           // notify manager of hit
}that was the code
also how do i do all my classes at the same time i looked in the javadoc command list but cant find it.

Posting here as noone on the javadoc forum...

I would like to generate the javadoc for some packages only, I tried to put a list of packages in the packagenames parameter, but I have got the following message:
.... build.xml:85: No source files and no packages have been specified.
Here is my build script sample:
<target name="javadoc" depends="setup-classpath">
<javadoc
packagenames="com.etil.sudetp.eap com.etil.sudetp.eap.message"
source="${basedir}/src"
sourcepath="${basedir}/src"
destdir="${basedir}/doc"
use="true"
author="false"
version="true"
</target>
Thanks for your help.

nasch_ is right plus your usage of the source attribute is not correct.
Please see the answers to your post in the Javadoc forum.
You really should be a little bit more patient. Just because the Javadoc forum is rather low traffic, it does not mean that the chances for (good) answers increase when posting in a less appropriate, high-traffic forum ... and this is actually an ANT question and not a Javadoc question, so the best place to ask this would have been the ANT mailing list.

J2ee & javadoc (few questions)

Hi everyone,
I'm new to JavaDoc utility and I need some help from you. I wrote j2ee application which contains ejbs, servlets & other helper classes. Now I want to run the JavaDoc. I have few problems:
1. When running the javaDoc utility I can't browse my classes by package. like the API of Sun:
http://java.sun.com/j2se/1.4.2/docs/api/
it is only possible to view all classes.
2. when I run the javaDoc utility on the project root dir (recursive), I get documatation for Stub class (of the ejbs) & etc. Since there are too much ejbs, is there a way to remove these class from the output result?
Thank you very much for your help...

Use the -link option to link to other javadoc documentation:
http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/javadoc.html#link
You can exclude packages using -exclude:
http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/javadoc.html#exclude
If you want to just exclude particular classes, then you'll probably have to explicitly include all the classes you do want.

Javadoc taglets question.

Compared to, say, the javadoc webpages
which are the code dictionary for the SE JDK,
There isn't earnly as many active links
to methods,fields, and custructors elsewhere
in the javadoc.
There doesn't seem to be a way to hyperlink
the autoinformation generated, such
as the default inherited fields
in the case of a supclass.
Is there a way, when using the javadoc tool,
to code for all this?

If for example, you examine some
javadoc we can both see,
such as this internet web page,
the String class:
[http://life.csu.edu.au/java-doc/api/java/lang/String.html|http://life.csu.edu.au/java-doc/api/java/lang/String.html]
There is a link for java.lang.object.
In the method summary area, certain return types also
exist as links to the appropriate class pages.
It is also usually the case that past this,
there is a list of inherited fields and methods.
These are also links, to their appropriate pages.
I have gone through the javadoc tutorial,
and don't see anything that I can put,
in terms of javadoc .java source code taglets,
to produce these results in
"javadoc -private MyCode.java".
Does anyone have any ideas on this?

2 questions around javadoc...

(1)
Somewhere I've seen HTML-Doku created by a tool like javadoc,
but additionally the Doku provided for every variable and method of the source code line numbers as links. So there was an opportunity to jump from Doku into code by such links. But I've forgotten what is the name of the tool. Does anybody know such a tool?
(2)
Is there any possibility under javadoc 1.3.x to create HTML-doku for particular *.java files whereby I'd like to provide my makeDoc.bat no file names but source root directory name along with '*' like ../prj/java/src/*.java?
Any idea would be great appreciated!
kind regards

I have seen source code with links, but cannot remember
where. I looked on our Javadoc FAQ list and doclet.com, but nothing obvious pops up.
A google.com search finds "HTML-Doku", but I did not
dig into them.
-Doug Kramer
Javadoc team

A rather long post of me talking gibberish and asking LOTS of questions.

================================================== ================================================== ===
Before reading this MASSIVE post, please read the bottom at the stupid amount of P.P.S.'s as they probably have a lot of information that I forgot to put in the middle or something.
================================================== ================================================== ===
Hi, I'm some guy on the internet and I am 15 years old. For the sake of this post and the answers I hope to have, please ignore my age and understand my maturity and I hope that you can understand why I would like to learn this language so much. I seem to have major issues with learning this language and online tutorials and stacks of books do not seem to do the trick. Please do not reply saying "this is not for you, try something else" because although I do not know much in Java in terms of making good applications, I have learned quite a few things and I am able to make simple things with the console such as making a calculator where the user has to type in what operator they want to use and then they are asked to enter two numbers in which they are timed/added/divided etc. together and it gives the answer. Considering this I really want to continue learning this language because I find it fun to learn and fun to program in, yet I am having serious stress issues because I can't understand simple things and I just forget some of them and I then find it difficult to make simple applications. For example, I am trying to make a simple snake game where you have to find all the apples and eat them and then your body grows larger etc. but I just can't think of how I would do it. I know a few simple application type things and maybe how to put them to use, but I just don't know how to use them in this situation and how to start off making games like these.
Just to tell you a little bit about my background of programming, I have known about programming since I was about 11, I made a virus in Visual Basic believe it or not. It would disguise itself as Mozilla Firefox and would slowly delete random files that were opened or edited in the last month starting from the last used files in said month. It would delete a set amount of files every time you booted up and it was pretty nasty. It was obviously quite easy to get rid of it and it probably had many bugs, but it was a nasty virus nonetheless. Anyway, that lasted around 2 months and I never really picked up on programming until around 13 at which point I learned a bit of Java up until the System.out.println part, so not very far at all and I barely understood anything. Then I kinda picked it up at 14 last summer (2012) and learned almost as much I know now over the summer holidays and then kind of left it until after Christmas because I couldn't really get past a certain 'barrier' so I got bored and gave up. Until now. After Christmas I got back into it and starting learning a few more things, understood functions a little more and downloaded a bunch of source code from lots of different websites. I've now been extremely stressed out for the past 2 weeks going crazy because I can't fit anything else into my head because I just forget it or just don't understand it. So I am now in a complete frenzy not doing homework, being a douche to my friends and just not being very social or doing stupid things.
Unfortunately this is going to be a rather long post as you can probably already tell and there will be a 20 Q's kind of 'game' below where I ask things that I desperately need to know and maybe things that I want to know but don't necessarily need to know.
If you can, I would greatly appreciate it if you could answer all of the first 14 questions in one post instead of 1 or 2. Also, please do not post anything unnecessary or nasty as I am a new poster here and I just want to get started in Java and I have my own reasons for starting at such a young age and my intentions are rather personal. So please treat this matter with maturity and I hope someone can really help me.
I am sorry for any misspellings or grammatical errors, I am fully English, I am just rubbish at spelling.
THE QUESTIONS!!!
1) What is SUPER used for, when should I use it and why should I use it?
2) When making a new class and you type PUBLIC [insert class name here](){} what does this do and why does it need to be the same name as the class it is in?
3) Why do you need to make new classes inside already made classes sometimes?
4) What is the use of NEW and why do you need to use it when you are creating something like a JFrame, where for example you would use it in your main function and have NEW [insert name of function with JFrame inside]();, why can't you just do [insert name of function with JFrame inside]();?
5) What is actionPerformed, where is it used and why should I use it?
6) When using a function, what is achieved when you call another class and make another variable inside said function? Eg, public [insert class name here]([insert other class name here][insert new variable name here]){}
7) What 'type' is an ENUM? Is it an int? String? Double? So if I were to make ENUM [insert name of enum here] {A, B, C, D, E, F, G}; So what would happen if I were to say PUBLIC [insert name of enum here] B = 5; what would that mean? Would that assign it as an integer?
8) When should I use enums, what is the point in them?
9) What does [inset object here].ORDINAL mean? What is it used for and when should I use it?
10) Although I understand that the RETURN statement is used to end a function and return it with a value if there is one specified, but when it returns it with that value that you may have specified, what happens to that value, how do I retrieve it and how do I use it? When will I know when to use RETURN?
11) Briefly explain how to use KeyEvent, getKeyCode and just anything else to do with accepting user input and how I would use it.
12) When using the KeyAdapter, why do you need to make a new class inside an already made class? What does this achieve? Why can you not extend it on the current class you are using instead of making a new class? This links back to the 3rd question.
13) What is the difference between ++object and object++? Does it really matter which way I use them? Why should I use them differently and how will it affect my code if I use them differently?
14) What's the difference between an IF statement and a BOOLEAN statement? They are both booleans and if used correctly can be used to do the exact same thing with just one or two lines of codes difference. Which one should I pick over the other and why? Which one is better to use for what kind of things?
================================================== ================================================== ===
POINTLESS QUESTIONS THAT I JUST FEEL LIKE ASKING THAT DON'T NEED TO BE ANSWERED AND DON'T HAVE MUCH TO DO WITH THE CODE ITSELF
================================================== ================================================== ===
15) What is the best way to get into the mindset of 'a programmer'? What is the best way to understand the ways in which you would build an application and learning the step by step processes so you know what you have to do next and how to do it.
16) I seem to always be worried that it takes programmers 5 minutes to program a very simple game, like Tetris because I've seen videos and just other places where it makes it look like it takes them a very small amount of time to make something that might take me months to learn. Is this how it works? Or can it take hours to program 5 classes for a very simple game? If so, why does it, if said programmer hypothetically understands the language well enough to make said program? Surely they would know what to do and how to make it so it would not take long at all?
17) How often are IF and ELSE statements used in common programs? I feel when I am making a program I am always using them too much and I just stop programming from there because I feel that I am using too much of something so maybe it isn't the right way to do it or maybe there is a better way to do it.
18) What would be the best way to learn programming for someone who finds it difficult to teach himself said topic yet has no efficient way to have someone teach him? I feel I am somewhat intelligent enough to learn a programming language, I have gotten this far, so I feel I should just keep going. Besides, despite the difficulties I have and the ridiculous amount of stress I get from not being able to learn on my own, I find it very entertaining to program things, read over other peoples code and slowly learn the world of programming. I feel that I see myself as a programmer in the future and I just really hope that I can learn this language quickly before I am too old to have time to learn this as a hobbie as I do now.
19) I am someone who hopes to become a games developer as I thoroughly enjoy playing games as much as I do finding out how they work. What would be the right way about learning how to make games? Should I stick with Java or should I go to C++? I've only stuck with Java because I have more experience with it and I feel that I should learn an easy language and get used to OOP and other things before I go off making complex programs with a difficult language. I know how to print something to the console in C++ and that's about it.
20) I have no way of having an education on programming in my school at the moment and all courses that have programming in them aren't very good - you make a simple application for coursework and you do a computer physics exam at the end of the year, not too helpful for me. Also, I don't have many friends that are diversed in any language of programming and the ones I do have, coincidentally, absolutely none of them are any good at making games or painting anything in graphics or anything to do with frames and windows. They're all about the console and making mods for games instead of making full on programs with a window and what not so it's difficult to get any of them to teach me anything. I've looked at college courses and none of them are for my age and what I am wanting, or they are just too damn expensive. I have also looked at online courses, one-to-one tutoring etc. but they are either way too expensive or they aren't very good in terms of being in a country half way across the world or maybe they have bad ratings. Anyway, what I'm trying to ask, despite all the negative put backs and all the issues that seem to follow me whenever I try to learn this damn language, what would be the best way to teach myself this language or any other language, or where are the best places to have someone teach me for free/cheap prices? I just essentially want to make something basic like a video game like Tetris or something so I at least have some knowledge of making a video game so I can maybe learn other things much easier.
P.S. I am in top sets for all my classes at school, so any intelligence issues aren't a part of this. I guess you could maybe call it laziness, but I just prefer to say that I am too used to people teaching me things and doing things for me rather than teaching and doing things myself. So if I were stuck on an island alone I really would not know what to do at all because I would mainly rely on other people.
P.P.S. Just for anyone's curiosity, I use Eclipse as my IDE on a Windows 7 Ultimate OS.
P.P.P.S. I am British.
P.P.P.P.S. I have read through about 4 books about Java, but on most of them I just get really bored and stop reading them half way through because they either don't explain what I want to know or they really suck at explaining what I want to know.
P.P.P.P.S If you are going to post a good tutorial, please post one that I have most likely NOT been on. PLEASE. I have gone through MANY tutorials which all of them don't do me any favours. Please post one that you think that I might not have seen and actually tells me what EACH line of code does and WHY it does it and WHY I might use it and WHERE I might use it. Etc.
P.P.P.P.P.S If this is a TL;DR kind of post, then I am awfully sorry to have bored you, please go onto another post, but thank you very much for taking the time to actually LOOK and CLICK on my post. However if you do not have any intention of helping my dilemma, please leave as although I am asking for A LOT for FREE, I really don't need pointless posts that really do not solve my problem. Thanks.
P.P.P.P.P.P.S (Last P.P.S I swear! I just keep forgetting things.) If you have any questions to ask or I might not have asked something properly, feel free to ask as I will probably be refreshing this page non-stop for the next 2 weeks. Thanks ^^
For all the people out there who are THAT awesome to post here answers to these questions, I really salute to you and I would VERY gladly give you money for your time and effort, if I had the funds to give you what it's worth. ;-)
Edited by: 983242 on 21-Jan-2013 16:26

Before reading this MASSIVE postI didn't read it. I went straight to the questions. The rest of it was a complete waste of your time. Nobody cares whether you are 15, are stressed, get bored, etc. You should spend more time learning and less time emoting, and typing.
I am rubbish at spelling.So fix that. If you stay in this business you will have to spell properly or get nowhere. Compilers won't accept mis-spellings: why should anybody else? Get over it. In a few years you will have to write a resume. If I get it and it is misspelt it goes in the bin.
1) What is SUPER used for, when should I use it and why should I use it?It is used for two purposes that are described in the Java Language Specification. If you can't read language specifications you will have to learn, or get nowhere. You can't learn languages in forums.
2) When making a new class and you type PUBLIC [insert class name here](){} what does this do and why does it need to be the same name as the class it is in?That's two questions. 'public' is used for a purpose that is described in [etc as above]. The class name needs to agree with the file name because that is a rule of Java. Period. There's a reason for the rule but you should be able to discover it for yourself eventually, and it doesn't actually matter what the reason is at this stage in your development.
3) Why do you need to make new classes inside already made classes sometimes?Why not?
4) What is the use of NEW and why do you need to use it when you are creating something like a JFrame, where for example you would use it in your main function and have NEW [insert name of function with JFrame inside]();, why can't you just do [insert name of function with JFrame inside]();?Meaningless. You have to use the language the way it was designed. Same applies to most if not all your questions.
5) What is actionPerformed, where is it used and why should I use it?See the Javadoc.
6) When using a function, what is achieved when you call another class and make another variable inside said function? Eg, public [insert class name here]([insert other class name here][insert new variable name here]){}I cannot make head or tail of this question. You could try making it intelligible.
7) What 'type' is an ENUM?It is of type Enum.
Is it an int? String? Double?No, no, and no.
So if I were to make ENUM [insert name of enum here] {A, B, C, D, E, F, G}; So what would happen if I were to say PUBLIC [insert name of enum here] B = 5; what would that mean? Would that assign it as an integer?I'm getting sick of this [insert name here] business. Try making your questions legible and intelligible. And again, an enum is not an int.
8) When should I use enums, what is the point in them?When you want them. Not a real question.
9) What does [inset object here].ORDINAL mean?Nothing. There is no such construct in Java. There might be an occasional class with a public variable named ORDINAL, in which case it means whatever the guy who wrote it meant. If you're lucky he documented it. If not, not.
10) Although I understand that the RETURN statement is used to end a function and return it with a value if there is one specified, but when it returns it with that value that you may have specified, what happens to that value, how do I retrieve it and how do I use it?You store it in a variable, or pass it to another function, or use it as a value in a statement, for sample as an if or while condition.
When will I know when to use RETURN?Err, when you want to return a value?
11) Briefly explain how to use KeyEvent, getKeyCode and just anything else to do with accepting user input and how I would use it. In a forum? You're kidding. Read the Javadoc. That's what I did.
12) When using the KeyAdapter, why do you need to make a new class inside an already made class?You don't.
13) What is the difference between ++object and object++?This is all described in the Java Language Specification [etc as above] and indeed most of this stuff is also in the Java Tutorial as well. Read them.
Does it really matter which way I use them?Of course, otherwise they wouldn't both exist. Language designers are not morons.
Why should I use them differently and how will it affect my code if I use them differently?That's just the same question all over again.
14) What's the difference between an IF statement and a BOOLEAN statement?The difference is that there is no such thing as a boolean statement.
POINTLESS QUESTIONSThanks for stating that.
THAT I JUST FEEL LIKE ASKINGBad luck. I don't feel like answering pointless questions. Ever.

Questions on InitialContext and replica-aware stub caching

Hi All,
We have a cluster and deployed with some stateless ejb session beans. Currently we only cached the InitialContext object in the client code, and I have several questions:
1. in the current case, if we call lookup() to get a replica-aware stub, which server will return the stub object, the same server we get the InitialContext, or it will load balanced to other servers every time we call the lookup method?
2. should we just cache the stub? is it thread safe? if it is, how does the stub handle concurrent requests from the client threads? in parallels or in sequence?
One more question, when we call new InitialContext(), it will take a long time before it can return a timeout exception if the servers are not reachable, how can we set a timeout for this case?

809364 wrote:
You can set the timeout value programatically by using the
weblogic.jndi.Environment.setRequestTimeout()
Refer: http://docs.oracle.com/cd/E12839_01/apirefs.1111/e13941/weblogic/jndi/Environment.html
or
set the REQUEST_TIMEOUT in the weblogic.jndi.WLContext
Refer: http://docs.oracle.com/cd/E11035_01/wls100/javadocs/weblogic/jndi/WLContext.html
Hi, I tried setting the parameters before, but it only works for stub lookup and ejb call timeout, not for the creation of InitialContext. And any idea for my 2nd question?

Newb setup question re: 500 cannot compile error

HTTP Status 500 -
type Exception report
message
description The server encountered an internal error () that prevented it from fulfilling this request.
exception
org.apache.jasper.JasperException: Unable to compile class for JSP
An error occurred at line: -1 in the jsp file: null
Generated servlet error:
[javac] Compiling 1 source file
This is on the default index.jsp page that installs with Apache Tomcat/4.1.18... at http://localhost:8080/index.jsp which maps to C:\Program Files\Apache Group\Tomcat 4.1\webapps\ROOT\index.jsp
by now I have way too many java sdks installed...
C:\Program Files\Java\j2re1.4.1_01
C:\Program Files\Java\j2re1.4.0_03
C:\j2sdk1.4.0_03
C:\j2sdkee1.4
The first one I tried got me the same error I am getting now.. and since I have tried different versions changing JAVA_HOME
Right now..
JAVA_HOME = C:\j2sdkee1.4
CATALINA_HOME = C:\Program Files\Apache Group\Tomcat 4.1
I have no idea what's going on here not having much experience in settting up web servers or java SDKs. But in order to learn the stuff I have planned to I need teh following to get up and running on Win2K.. any help is greatly appreciated.
Java JDK 1.4.
Tomcat servlet\JSP engine 4.0.1.
MySQL database 3.23.46
If I stick a standard html page in the tomcat root it will show just fine.. so I suspect the whole Java thing is buggin for some reason.
Here's the full text of the returned error followed by the text of the index.jsp file
HTTP Status 500 -
type Exception report
message
description The server encountered an internal error () that prevented it from fulfilling this request.
exception
org.apache.jasper.JasperException: Unable to compile class for JSP
An error occurred at line: -1 in the jsp file: null
Generated servlet error:
[javac] Compiling 1 source file
     at org.apache.jasper.compiler.DefaultErrorHandler.javacError(DefaultErrorHandler.java:130)
     at org.apache.jasper.compiler.ErrorDispatcher.javacError(ErrorDispatcher.java:293)
     at org.apache.jasper.compiler.Compiler.generateClass(Compiler.java:340)
     at org.apache.jasper.compiler.Compiler.compile(Compiler.java:352)
     at org.apache.jasper.JspCompilationContext.compile(JspCompilationContext.java:474)
     at org.apache.jasper.servlet.JspServletWrapper.service(JspServletWrapper.java:184)
     at org.apache.jasper.servlet.JspServlet.serviceJspFile(JspServlet.java:295)
     at org.apache.jasper.servlet.JspServlet.service(JspServlet.java:241)
     at javax.servlet.http.HttpServlet.service(HttpServlet.java:853)
     at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:247)
     at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:193)
     at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:260)
     at org.apache.catalina.core.StandardPipeline$StandardPipelineValveContext.invokeNext(StandardPipeline.java:643)
     at org.apache.catalina.core.StandardPipeline.invoke(StandardPipeline.java:480)
     at org.apache.catalina.core.ContainerBase.invoke(ContainerBase.java:995)
     at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:191)
     at org.apache.catalina.core.StandardPipeline$StandardPipelineValveContext.invokeNext(StandardPipeline.java:643)
     at org.apache.catalina.core.StandardPipeline.invoke(StandardPipeline.java:480)
     at org.apache.catalina.core.ContainerBase.invoke(ContainerBase.java:995)
     at org.apache.catalina.core.StandardContext.invoke(StandardContext.java:2415)
     at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:180)
     at org.apache.catalina.core.StandardPipeline$StandardPipelineValveContext.invokeNext(StandardPipeline.java:643)
     at org.apache.catalina.valves.ErrorDispatcherValve.invoke(ErrorDispatcherValve.java:170)
     at org.apache.catalina.core.StandardPipeline$StandardPipelineValveContext.invokeNext(StandardPipeline.java:641)
     at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:172)
     at org.apache.catalina.core.StandardPipeline$StandardPipelineValveContext.invokeNext(StandardPipeline.java:641)
     at org.apache.catalina.core.StandardPipeline.invoke(StandardPipeline.java:480)
     at org.apache.catalina.core.ContainerBase.invoke(ContainerBase.java:995)
     at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:174)
     at org.apache.catalina.core.StandardPipeline$StandardPipelineValveContext.invokeNext(StandardPipeline.java:643)
     at org.apache.catalina.core.StandardPipeline.invoke(StandardPipeline.java:480)
     at org.apache.catalina.core.ContainerBase.invoke(ContainerBase.java:995)
     at org.apache.coyote.tomcat4.CoyoteAdapter.service(CoyoteAdapter.java:223)
     at org.apache.coyote.http11.Http11Processor.process(Http11Processor.java:432)
     at org.apache.coyote.http11.Http11Protocol$Http11ConnectionHandler.processConnection(Http11Protocol.java:386)
     at org.apache.tomcat.util.net.TcpWorkerThread.runIt(PoolTcpEndpoint.java:534)
     at org.apache.tomcat.util.threads.ThreadPool$ControlRunnable.run(ThreadPool.java:530)
     at java.lang.Thread.run(Unknown Source)
Apache Tomcat/4.1.18
<!doctype html public "-//w3c//dtd html 4.0 transitional//en" "http://www.w3.org/TR/REC-html40/strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title><%= application.getServerInfo() %></title>
<style type="text/css">

</style>
</head>
<body>

<table width="100%">
<tr>
<td align="left" width="130"><img src="tomcat.gif" height="92" width="130" border="0" alt="The Mighty Tomcat - MEOW!"></td>
<td align="left" valign="top">
<table>
<tr><td align="left" valign="top"><b><%= application.getServerInfo() %></b></td></tr>
</table>
</td>
<td align="right"><img src="jakarta-banner.gif" height="48" width="505" border="0" alt="The Jakarta Project"></td>
</tr>
</table>
<br>
<table>
<tr>

<td valign="top">
<table width="100%" border="1" cellspacing="0" cellpadding="3" bordercolor="#000000">
<tr>
<td bgcolor="#D2A41C" bordercolor="#000000" align="left" nowrap>
<font face="Verdana" size="+1"><i>Administration</i>      </font>
</td>
</tr>
<tr>
<td bgcolor="#FFDC75" bordercolor="#000000" nowrap>
Tomcat Administration<br>
Tomcat Manager<br>
</td>
</tr>
</table>
<br>
<table width="100%" border="1" cellspacing="0" cellpadding="3" bordercolor="#000000">
<tr>
<td bgcolor="#D2A41C" bordercolor="#000000" align="left" nowrap>
<font face="Verdana" size="+1"><i>Documentation</i>      </font>
</td>
</tr>
<tr>
<td bgcolor="#FFDC75" bordercolor="#000000" nowrap>
Tomcat Documentation<br>
</td>
</tr>
</table>
<br>
<table width="100%" border="1" cellspacing="0" cellpadding="3" bordercolor="#000000">
<tr>
<td bgcolor="#D2A41C" bordercolor="#000000" align="left" nowrap>
<font face="Verdana" size="+1"><i>Tomcat Online</i>      </font>
</td>
</tr>
<tr>
<td bgcolor="#FFDC75" bordercolor="#000000" nowrap>
Home Page<br>
Bug Database<br>
Users Mailing List<br>
Developers Mailing List<br>
IRC<br>
</td>
</tr>
</table>
<br>
<table width="100%" border="1" cellspacing="0" cellpadding="3" bordercolor="#000000">
<tr>
<td bgcolor="#D2A41C" bordercolor="#000000" align="left" nowrap>
<font face="Verdana" size="+1"><i>Examples</i>      </font>
</td>
</tr>
<tr>
<td bgcolor="#FFDC75" bordercolor="#000000" nowrap>
JSP Examples<br>
Servlet Examples<br>
WebDAV capabilities<br>
</td>
</tr>
</table>
<br>
<table width="100%" border="1" cellspacing="0" cellpadding="3" bordercolor="#000000">
<tr>
<td bgcolor="#D2A41C" bordercolor="#000000" align="left" nowrap>
<font face="Verdana" size="+1"><i>Miscellaneous</i>      </font>
</td>
</tr>
<tr>
<td bgcolor="#FFDC75" bordercolor="#000000" nowrap>
Sun's Java Server Pages Site<br>
Sun's Servlet Site<br>
</td>
</tr>
</table>
</td>
<td>     </td>

<td align="left" valign="top">
<p><center><b>If you're seeing this page via a web browser, it means you've setup Tomcat successfully. Congratulations!</b></center></p>
<p>As you may have guessed by now, this is the default Tomcat home page. It can be found on the local filesystem at:
<blockquote>
<p class="code">$CATALINA_HOME/webapps/ROOT/index.html</p>
</blockquote>
</p>
<p>where "$CATALINA_HOME" is the root of the Tomcat installation directory. If you're seeing this page, and you don't think you should be, then either you're either a user who has arrived at new installation of Tomcat, or you're an administrator who hasn't got his/her setup quite right. Providing the latter is the case, please refer to the Tomcat Documentation for more detailed setup and administration information than is found in the INSTALL file.</p>
<p><b>NOTE: For security reasons, using the administration webapp
is restricted to users with role "admin". The manager webapp
is restricted to users with role "manager".</b>
Users are defined in <code>$CATALINA_HOME/conf/tomcat-users.xml</code>.</p>
<p>Included with this release are a host of sample Servlets and JSPs (with associated source code), extensive documentation (including the Servlet 2.3 and JSP 1.2 API JavaDoc), and an introductory guide to developing web applications.</p>
<p>Tomcat mailing lists are available at the Jakarta project web site:</p>
<ul>
<li><b>[email protected]</b> for general questions related to configuring and using Tomcat</li>
<li><b>[email protected]</b> for developers working on Tomcat</li>
</ul>
<p>Thanks for using Tomcat!</p>
<p align="right"><font size=-1><img src="tomcat-power.gif" width="77" height="80"></font><br>
<font size=-1>Copyright © 1999-2002 Apache Software Foundation</font><br>
<font size=-1>All Rights Reserved</font> <br>
</p>
<p align="right"> </p>
</td>
</tr>
</table>
</body>
</html>

I ended up uninstalling every java this and that.. and tomcat.
Then installing only the j2sdk1.4.0_03 SDK.
Then set up JAVA_HOME for all users and modified the path with full path to the bin (c:\j2sdk1.4.0_03\bin)
Lastly I reinstalled tomcat and, voila, everything was working.
It can be quite maddening when you THINK you did everything by the boook and something doesn't work. When you replied and confirmed that I was on the right track.. uninstalling and trying yet again became les frustrating an option.
Thanks.
BTW- I needed this env to do the projects in what sems to be a very interesting book.. "macromedia Flash MC application design and development" by Jessica Speigel .. published by New Riders.
Her flash help website is at www.were-here.com.. the projects in the book are for flash-based multiplayer games and multi-user formums and such.

Question about the links that include parameters...

Hello,
I use this:
<a href="inserer_devis.jsp?firstparameter=<%= rs.getString(1)%>&secondparameter=<%= rs.getString(2)%>">to have a link that gives parameters to the other JSP.
My question is:
On the other JSP, when I use request.getParameter("firstparameter"), what is the thing that I get: is it a string, a char, ...??
And how can I convert it to a float or an int?
I have problems with integer.parseint() and float.parsefloat(), it tells me "NumberFormatException: null". The compiler thinks that my parameter is not a good int (or float).
Thank you.
Romain.</a>

Request.getParameter always returns a String (see the javadocs).
To convert a String to an int use Integer.parseInt(StringToParse);
To convert a String to a Float usse Float.parseFloat(StringToParse);
just see the javadocs for more information

Can anyone share with me how you write Javadoc?

Can anyone share with me how their companies write Javadoc?
Are your developers solely responsible for it? Do your technical writers own it or review it? How do you make sure it's good?
Right now, my software developers are mostly responsible for writing all the API info and it's of poor quality and really lacking details. I don't mean spelling/grammar-type problems. My developers just don't seem to "get" what information to include, no matter how many guidelines or checklists I give them.
A very simple example is:
* Gets the status
public java.lang.Integer getStatus() {...}With no indication of what status values may be returned and what the values might mean.
How do you ensure that what you write is actually useful? Please help!
I'm aware of the method Sun recommends, but I want to know what others do.
Thank you

Hi,
Well, concerning the question what a good API documentation should be. Just imagine, you are a programmer and you want to use that API. You need to know how it works. There can be only three ways to find it:
(1) The API documentation
(2) Probing experiments. Even a good documentation may not describe everything. Sometimes, the only way to understand certain things you particularly need may be guessing something, writing a code basing on it and see how it works. Then, guessing something again, more precisely now, and so on. Even a very good documented API (for instance, javax.swing) may require that sort of approach to be able to use it eventually.
(3) At last, when source codes are available, one may look at them and try to understand precisely, what a particular method actually does.
I think the better the API documentation the less one may need to endeavor those two last steps. There is actually a limit about it. Without any proper explanation at all, one may never be able to use a particular API, neither after probing it nor after looking at source codes (that is not to say the sources may be simple unavailable at all).
Concerning how to write the API documentation, that's mostly the question of managing your team. I think, basically, the original source of the ultimate information about everything implemented in the projects are those very programmers (developers) and, probably, some software architects. But those guys normally are not especially eager to write any documentation (especially developers). That your example just demonstrates it. It seems, your programmers just wrote that "Gets the status" for you to make them leave in rest after that. In addition, the programmers normally have such a sort of work and activity that does not match particularly well with the writing literature and doing their main job simultaneously. You should not enforce them to do that!
To write a good documentation, you will need to engage a technical writer. That's normally a guy with some programming background. However, writing some literature is actually what he does the best. (Sometimes, such people do something else about written word beyond the technical writing.) The job of that guy would be to write the documentation. This will take from him (or her) two basic things:
(1) The ability to understand the whole software system (that's where his programming background will be needed!);
(2) To communicate with the programmers who have developed the stuff and to obtain from them all the necessary information they know. That may require some personal (verbal) communication with them, because asking them to write everything again will only result in the same "Gets the status" explanations. However, to be successful in this, the technical writer needs to have some explicit management approval behind him. Otherwise, some of the guys will avoid speaking to him at all (saying they lack the time). So, the management should assign them the necessary priority for such communications.
Particularly big projects may even need to have the whole team of technical writers.
Anyway, writing docs is a hard work. But it is extremely important! The good documentation may both increase your sales and eliminate lots of expense on further support of your customers.
Regards,
Leonid Rudy
http://www.docflex.com

"Show Javadoc" not working in NetBeans 6.7 // JDK 1.6 on Mac OS 10.5

Hi,
I searched many sites (including forums.sun.com: see e.g. http://forums.sun.com/thread.jspa?threadID=753501)
-- still I cannot find a solution that would work for me.
Here is a full description - hopefully somebody has solved it on Mac and will help me...
1) To reproduce, I select anything (say String) in NetBeans, ^-click and select "Show Javadoc": the result is a tiny gray message "*Cannot perform Show Javadoc here*".
2) I have a Mac and Netbeans 6.7.1, installed java 1.6, it (seems to me) came without docs:
@ /System/Library/Frameworks/JavaVM.framework/Versions> ls -alrt
total 56
drwxr-xr-x   3 root wheel   102 Jan 20 2009 1.3.1
drwxr-xr-x   8 root wheel   272 May 21 02:34 1.4.2
drwxr-xr-x   8 root wheel   272 May 21 02:34 1.5.0
drwxr-xr-x   9 root wheel   306 Nov 17 10:45 1.6.0
lrwxr-xr-x   1 root wheel     5 Nov 18 13:14 1.3 -> 1.3.1
lrwxr-xr-x   1 root wheel     5 Nov 18 13:15 1.4 -> 1.4.2
lrwxr-xr-x   1 root wheel     5 Nov 18 13:15 1.5 -> 1.5.0
lrwxr-xr-x   1 root wheel     5 Nov 18 13:15 1.6 -> 1.6.0
lrwxr-xr-x   1 root wheel     1 Nov 18 13:15 Current -> A
drwxr-xr-x   9 root wheel   306 Nov 18 13:15 A
drwxr-xr-x 12 root wheel   408 Nov 18 13:15 ..
lrwxr-xr-x   1 root wheel     3 Nov 18 13:30 CurrentJDK -> 1.6
drwxr-xr-x 14 root wheel   476 Nov 18 13:30 .
@/System/Library/Frameworks/JavaVM.framework/Versions> find . -name docs.\*
./1.4.2/Home/docs.jar
./1.5.0/Home/docs.jar 3) I added
/System/Library/Frameworks/JavaVM.framework/Versions/1.5/Home/docs.jar
to "Platform Manager" / JDK 1.6 / javadoc -- in vain, nothing's changed.
According to all major search engines, this problem seems to exist for years and is experienced by many.
It is really frustrating.
Please help!

scphan,
thanks a lot for your reply! It is helpful! (although not "solved" - alas).
The thing still doesn't work: maybe I missed some magic trick?
If you bear with me, here is what I did:
a) downloaded jdk-6u10-docs.zip
(from "Java SE Development Kit Documentation 6"
-->
https://cds.sun.com/is-bin/INTERSHOP.enfinity/WFS/CDS-CDS_Developer-Site/en_US/-/USD/ViewFilteredProducts-SingleVariationTypeFilter)
-- it was unzipped automatically by my Safari downloader, creating the "docs" directory);
b) then I pointed the Netnbeans to this dir (it says "Add ZIP/Folder", so to my understanding the "dir" should work, only faster), --
-- still "Show Javadoc" results in "Cannot perform"... (:-.
Anything I did terribly wrong?
Note that I stared at the http://java.sun.com/javase/downloads/index.jsp for a while before finding the "documentation" link.
Noticeable also that the page starts with "What Java Do I Need?" but doesn't answer that question.
Why does Sun make it so freaking hard for the beginners?..
Does it make sence to ship something without documentation?..
Why doesn't Apple distribution include it for 1.6 although it does for 1.5 and 1.4?..
Why do creators of Java not care that Java actually works out of the box, -- including (and that I think makes my question a Java question) in one of the two most popular Java IDEs?
(The last few sentences are mostly for flounder).

JavaDoc Question

Similar Messages

Maybe you are looking for