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 178665 - Javadoc for Java Persistence does not appear after moving the IDE
Summary: Javadoc for Java Persistence does not appear after moving the IDE
Status: RESOLVED FIXED
Alias: None
Product: serverplugins
Classification: Unclassified
Component: GlassFish (show other bugs)
Version: 6.x
Hardware: All All
: P3 normal (vote)
Assignee: Vince Kraemer
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2009-12-15 07:43 UTC by Petr Jiricka
Modified: 2010-04-07 04:41 UTC (History)
4 users (show)

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Petr Jiricka 2009-12-15 07:43:05 UTC
1. Create a new web project
2. Create a JPA Entity in this project

=> When invoking code completion on the JPA API classes in this entity, Javadoc does not show up.
Comment 1 Petr Jiricka 2009-12-15 07:56:00 UTC
When I investigated more, i realized that the EclipseLink-GlassFish-v3 library was pointing to a Javadoc file from an old NB build, which no longer exists on my disk. When I updated this link, things started working. It looks like possibly the declaration in ~userdir/build.properties was not updated when I switched to a new build (property libs.EclipseLink-GlassFish-v3.javadoc).

Still should be investigated.
Comment 2 Sergey Petrov 2009-12-15 07:58:57 UTC
I just tried to create web project on gf3, add new entity (with pu creation),
I see javadoc for EntityManager, @GeneratedValue, @Id, @Entity etc.
EclipseLink-GlassFish-v3 library isn't added to the project in this case.
Comment 3 Sergey Petrov 2009-12-15 08:05:44 UTC
I'm using 6.8 release installation for verification.
Do you have wrong reference in 6.8 user dir?
Comment 4 Sergey Petrov 2009-12-15 08:08:20 UTC
and in build.properties I have
{nb installation folder}/enterprise6/docs/javaee6-doc-api.zip
Comment 5 Sergey Petrov 2009-12-15 08:09:02 UTC
for libs.EclipseLink-GlassFish-v3.javadoc
Comment 6 Petr Jiricka 2009-12-16 05:41:21 UTC
Ok, now I know what are the exact steps to reproduce:
1. Install NetBeans and start it with a fresh user dir
2. Create a web project
3. Create an entity class, notice that Javadoc for e.g. javax.persistence.Entity appears correctly.
4. Shut down NetBeans
5. Rename the directory containing the NetBeans installation
6. Start up NetBeans from the new location, with the same userdir
7. Javadoc for javax.persistence.Entity is not found.

When you open ~userdir/build.properties, notice that most references to the IDE installation have been updated automatically to the new location, except a few:

libs.EclipseLink-GlassFish-v3.javadoc
libs.Java-EE-GlassFish-v3.javadoc
libs.restlib_gfv3ee6.javadoc

So this is why the Javadoc does not appear. Looks like there will be the same problem for REST - cc'ing Milan.
Comment 7 Sergey Petrov 2009-12-17 01:51:10 UTC
I see EclipseLink-Glassfishv3 is maintained in glassfish.javaeev module.
Vince is it yours? push back if in your opinion I should look.
Comment 8 Sergey Petrov 2009-12-17 02:10:02 UTC
may be eclipselink-gf library addition should be dropped as we have eclipselink bundled with base ide.
Comment 9 Sergey Petrov 2009-12-17 02:58:00 UTC
looks like web project on gf use this javadoc, when j2se project with eclipselink provider use libs.eclipselink.javadoc from bundled eclipselink library and I have no javadoc for @Entity in web project ans have one in j2se project at the same time.
Comment 10 Sergey Petrov 2009-12-17 03:47:24 UTC
tried to comment
//ensureEclipseLinkSupport(glassfishRoot);
in
JavaEEServerModuleFactory

and I don't have libs.EclipseLink-GlassFish-v3.* properties any more but still have valid javadoc as ee6 javadoc is widely used in ejb/web modules, but as EclipseLink-GlassFish-v3 isn't my implementation it's good to know if anybody know about any possible side effects.

one good side effect I know there will be only one eclipselink library in Add Library list, but I have only 4 libraries in this list in recent code, may be something was changed in trunk.
Comment 11 fommil 2009-12-21 06:45:24 UTC
*** Bug 178898 has been marked as a duplicate of this bug. ***
Comment 12 fommil 2009-12-21 06:50:01 UTC
I just marked another bug as a dupe of this, but I'm starting to think it's not the same.

My "build.properties" is pointing to the correct Netbeans 6.8 javadocs files for J2EE.
Comment 13 fommil 2009-12-24 06:53:45 UTC
I just unmarked issue 178898 as being a dupe - there are similarities, but they are different. The root cause might be similar. Please take the time to read my latest comments on that issue.
Comment 14 Vince Kraemer 2010-04-05 23:45:12 UTC
http://hg.netbeans.org/web-main/rev/2c9ea32c631d
Comment 15 Quality Engineering 2010-04-07 04:41:50 UTC
Integrated into 'main-golden', will be available in build *201004070201* on http://bits.netbeans.org/dev/nightly/ (upload may still be in progress)
Changeset: http://hg.netbeans.org/main/rev/2c9ea32c631d
User: Vince Kraemer <vkraemer@netbeans.org>
Log: #178665: missing javadoc when install moved