This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 148156 - javadoc for EE not found
Summary: javadoc for EE not found
Status: RESOLVED WORKSFORME
Alias: None
Product: serverplugins
Classification: Unclassified
Component: Sun Appserver 9 (show other bugs)
Version: 6.x
Hardware: PC Windows Vista
: P3 blocker (vote)
Assignee: Vince Kraemer
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-09-24 07:34 UTC by kris_1
Modified: 2008-10-01 21:03 UTC (History)
1 user (show)

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments
screenshot (16.59 KB, image/png)
2008-09-26 16:58 UTC, pslechta
Details
Server configuration (38.64 KB, image/jpeg)
2008-10-01 05:52 UTC, kris_1
Details
JavaDoc not found (118.59 KB, image/jpeg)
2008-10-01 06:02 UTC, kris_1
Details

Note You need to log in before you can comment on or make changes to this bug.
Description kris_1 2008-09-24 07:34:41 UTC
I have sun appserver installed in C:\Java\EE\. 
In tools/servers/javadoc there is item, but the IDE shows that javadoc not found.
By default in tools/servers/javadoc was C:\Java\NetBeans 6.1\enterprise5\docs\javaee5-doc-api.zip
When I changed that item on C:\Java\EE\docs, on C:\Java\EE\docs\api, but nothing good happend.
The javadoc not found appear when I try to find documentation on EE class.
Comment 1 Jan Pokorsky 2008-09-24 11:58:52 UTC
The library or platform with attached javadoc has to be on classpath of some open project first. Other possible problem
could be in broken JavadocForBinaryQueryImplementation that translates classes to javadoc resources. Reassigning to j2ee
for evaluation.
Comment 2 kris_1 2008-09-24 18:27:08 UTC
Unfortunately, but I don't understand what I can do to solve the problem.

1. Where is classpath of a project? I don't find it in the project property. But I have GlassFish V2 in libraries of 
project in projects tab. And I don't find the opportunity to add server other way than add it when EE project is being 
created.
2. How can I reassign j2ee for evaluation?

I mean that javadoc is configured in tools/servers not in libraries or platform.

P.S. Sorry for my english.
Comment 3 pslechta 2008-09-26 16:55:52 UTC
Product Version: NetBeans IDE Dev (Build 080926)
Java: 1.6.0; Java HotSpot(TM) Client VM 1.6.0-b105
System: Windows XP version 5.1 running on x86; Cp1252; en_US (nb)

It works for me. In your case, the path for javadoc should be C:\Java\EE\docs.

I suppose you have Web or J2EE project with selected server (let's say Glassfish V2). Then go to menu Tools > Servers >
select Glassfish V2 instance. Click Javadoc tab and enter the path. Then in java files that are under your project the
proper javadoc should be presented when you invoke code completion.

Please see attached screenshot. Please try the latest NB 6.5 build. Let me know if it still does not work for you with
the latest NB 6.5 build...
Comment 4 pslechta 2008-09-26 16:58:20 UTC
Created attachment 70684 [details]
screenshot
Comment 5 kris_1 2008-09-26 23:35:23 UTC
I have already configured server's javadoc for EE as you said.

In my first post I said that I tried to use different methods. I tried using Library to solve the problem (I had the 
message that index-files or index-all.html not found). But the result was the same "javadoc not found". The javadoc 
for SE works properly.

I tried to solve the problem by installing v6.5, but result was the same. When I tried to include javadoc in Library I 
got the error. I posted it (http://statistics.netbeans.org/analytics/detail.do?id=114518).

The javadoc I use is taken from the sun's server. It was downloaded with AppServer and separately.
Comment 6 Vince Kraemer 2008-09-30 20:35:28 UTC
I installed nb 6.5 (200809231435). This included GF V2 UR 2... which I also installed.

I created the WebJpa sample project and opened the CreatePersonServlet.java file.

I went to the line 83 and appended 'em.' 

The completion list populated and then the javadoc for EntityManager.close() appeared...

Please re-open this issue with detailed steps that describe how to reproduce the problem, if you are still running into it.
Comment 7 kris_1 2008-09-30 21:31:38 UTC
I still have the problem with javadoc for EE.

Install NetBeans v6.5 (200808111757) (install file is netbeans-6.5beta-javase-windows.exe)
Download (WebApplication, JavaEE, XML and Schema, GlassFish, JAX_RPC Web Services, Web Services)
Setup GlassFish server in Tool/Servers (javadoc is initialized properly)
Create project by File/New project/Java EE/Enterprise Application
Create message driven bean
Try to give javadoc for MessageListener and get the answer that the javadoc not found
Comment 8 Vince Kraemer 2008-09-30 23:58:11 UTC
how are you attempting to get "javadoc for MessageListener".....

I was able to get the javadoc multiple ways....

Note: I did run into a javadoc not found situation when I looked that the completion list for "this." inside my Message
Bean.  I was looking for the javadoc of onMessage(Message)...  since the method implementation inside the Bean did not
have javadoc, the message was actually correct.

Tested with 200809301401... using the steps you outlined.

Please reopen with detailed step-by-step instructions on how to reproduce the issue with a recent development build of
NB 6.5... (the beta is ancient).

Comment 9 kris_1 2008-10-01 05:52:47 UTC
Created attachment 70943 [details]
Server configuration
Comment 10 kris_1 2008-10-01 06:02:22 UTC
Created attachment 70944 [details]
JavaDoc not found
Comment 11 kris_1 2008-10-01 06:06:42 UTC
1. I take NetBean from http://dlc.sun.com.edgesuite.net/netbeans/6.5/beta/, try to install all updates and don't know 
where the recent version is located.

2. I thought it was very simple to configure javadoc. I have done it for libraries and for java platforms and don't 
have the problem.
But for EE javadoc I do. It dosn't work properly.

3. I attache two screenshots and think it dosn't need comments.

4. Maybe you only need to load javadoc from http://java.sun.com/javaee/downloads/index.jsp(ref is API documentation 
(Javadocs)) and try to use it?

5. What does it meen detailed step-by-step instructions? As I said in 2nd item I thought it was very simple to 
configure javadoc. 

Configure javadoc for server.
Create new enterprise application.
Create message driven bean.
Press Ctrl-Space on MessageListener.
JavaDoc not found is result.
Comment 12 Vince Kraemer 2008-10-01 17:04:20 UTC
1. the latest builds are located at http://bits.netbeans.org/download/trunk/nightly/latest/

2. Please explain how you 'configure javadoc'?  In the latest builds of 6.5 the javadoc for Java EE is preconfigured, so
your actions may be be part of the root cause of the situation.

3. where did you get the server that you installed in C:\Java\EE?  The GF bits don't have the Java EE 5 api javadoc
included...

4. I will try that.

5. It it hard to figure out which items you select and dialogs you open and values that you have entered based on
generic instructions.

It appears that you have taken a working configuration and broken it... since the javadoc is preconfigured and multiple
folks have reported that they have not been able to 
Comment 13 Vince Kraemer 2008-10-01 17:28:25 UTC
I just used the JavaEE SDK download and register the server as GF v2.

I changed the javadoc config of the server from the api zip file that ships with NB to the <install-root>/docs/api
directory and am able to see the javadoc for MessageListener, when I use a recent NB 6.5 build.

Please reopen this issue if you can replicate the problem with a recent build of NB 6.5.

Please include detailed step, so someone reading them can replicate your actions unambiguously when they attempt to
evaluate the issue.
Comment 14 kris_1 2008-10-01 21:03:21 UTC
The problem was solved.
I installed the latest version NetBeans 6.5 and got java doc for EE.
Thank for your time.