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 111517 - Standard API for JAX-WS 2.1 libraries
Summary: Standard API for JAX-WS 2.1 libraries
Status: RESOLVED FIXED
Alias: None
Product: webservices
Classification: Unclassified
Component: JAX-WS (show other bugs)
Version: 6.x
Hardware: All All
: P3 blocker (vote)
Assignee: apireviews
URL:
Keywords: API_REVIEW_FAST
Depends on:
Blocks:
 
Reported: 2007-07-31 17:03 UTC by Milan Kuchtiak
Modified: 2008-03-25 10:36 UTC (History)
3 users (show)

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments
NetBeans Architecture Answers Document (51.54 KB, text/html)
2007-08-01 12:35 UTC, Milan Kuchtiak
Details
Zipped websvc/jaxws21api module (15.70 KB, application/octet-stream)
2007-08-01 12:36 UTC, Milan Kuchtiak
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Milan Kuchtiak 2007-07-31 17:03:55 UTC
There are reasonable requirements to use JAX-WS technology for various Netbeans plugins that want to call/integrate web
services.
Example : 
A plugin developer wants to create a "Search Plugin" based on existing web service
(http://www.esynps.com/WebServices/SearchWS.asmx).

To achieve this, Netbeans can be used to generate JAX-WS java artifacts to call this service.
To build a Netbeans Plugin, the dependency on JAX-WS APIs needs to be set up in order to make the plugin work.

Currently the JAX-WS APIs exists in the form of FRIEND API that is not good.

Suggestion is to devide the current (Friend) JAX-WS 2.1 module into 2 APIs (Standard and Friend). 

The standard API module will "wrap" the following API jars that represent, in fact, the JAX-WS 2.1 API :

jaxws-api.jar (JAX-WS 2.1 API)
jaxb-api.jar (JAXB 2.1 API required by JAX-WS 2.1)
jsr173_api.jar (JSR 173 : Streaming API for XML, required by JAXB 2.1)
jsr181-api.jar (JSR 181 : Web Service annotations)
jsr250-api.jar (JSR250 : Common annotation for java platform)
saaj-api.jar (SOAP with Attachments API - low level API for creating/processing SOAP requests/responses)

The Friend API will wrap the implementation jars (currently included in JAX-WS 2.1 module) that are still needed by
various Netbeans modules.
Comment 1 Milan Kuchtiak 2007-08-01 12:35:09 UTC
Created attachment 45986 [details]
NetBeans Architecture Answers Document
Comment 2 Milan Kuchtiak 2007-08-01 12:36:29 UTC
Created attachment 45987 [details]
Zipped websvc/jaxws21api module
Comment 3 Milan Kuchtiak 2007-08-13 18:52:26 UTC
If there are no objections I plan to implement the changes this week.
I'll also take into account Petr Suchomel's changes to jaxws21 library last week.
Comment 4 Milan Kuchtiak 2007-08-15 13:04:13 UTC
Implemented.

org.netbeans.modules.websvc.jaxws20 module (in fact it was jaxws21) replaced by 2 modules :

org.netbeans.modules.websvc.jaxws21api (standard API module containing JAX-WS 2.1 API jars)
org.netbeans.modules.websvc.jaxws21 (friend module containing JAX-WS 2.1 non API jars)

Changes :

Removed :
   websvc/jaxws20/external/jaxws21-license.txt
   websvc/jaxws20/external/jaxws21.zip
   websvc/jaxws20/nbproject/.cvsignore
   websvc/jaxws20/nbproject/project.properties
   websvc/jaxws20/nbproject/project.xml
   websvc/jaxws20/src/org/netbeans/modules/websvc/jaxws20/Bundle.properties
   websvc/jaxws20/src/org/netbeans/modules/websvc/jaxws20/layer.xml
   websvc/jaxws20/src/org/netbeans/modules/websvc/jaxws20/jaxb20.xml
   websvc/jaxws20/src/org/netbeans/modules/websvc/jaxws20/jaxws20.xml
   websvc/jaxws20/.cvsignore
   websvc/jaxws20/build.xml
   websvc/jaxws20/manifest.mf

Added:
   websvc/jaxws21/jaxws21api/src/org/netbeans/modules/websvc/jaxws21api/Bundle.properties
   websvc/jaxws21/jaxws21api/manifest.mf
   websvc/jaxws21/jaxws21api/build.xml
   websvc/jaxws21/jaxws21api/.cvsignore
   websvc/jaxws21/jaxws21api/arch.xml
   websvc/jaxws21/jaxws21api/nbproject/project.properties
   websvc/jaxws21/jaxws21api/nbproject/.cvsignore
   websvc/jaxws21/jaxws21api/nbproject/project.xml

   websvc/jaxws21/manifest.mf
   websvc/jaxws21/build.xml
   websvc/jaxws21/.cvsignore
   websvc/jaxws21/external/jaxws21-license.txt
   websvc/jaxws21/external/jaxws21.zip
   websvc/jaxws21/src/org/netbeans/modules/websvc/jaxws21/Bundle.properties
   websvc/jaxws21/src/org/netbeans/modules/websvc/jaxws21/layer.xml
   websvc/jaxws21/src/org/netbeans/modules/websvc/jaxws21/jaxb21.xml
   websvc/jaxws21/src/org/netbeans/modules/websvc/jaxws21/jaxws21.xml
   websvc/jaxws21/nbproject/project.properties
   websvc/jaxws21/nbproject/project.xml
   websvc/jaxws21/nbproject/.cvsignore

Modified :
http://websvc.netbeans.org/source/browse/websvc/core/src/org/netbeans/modules/websvc/core/jaxws/projects/J2SEProjectJAXWSClientSupport.java?r1=1.1&r2=1.2
http://websvc.netbeans.org/source/browse/websvc/core/src/org/netbeans/modules/websvc/core/dev/wizard/JaxWsServiceCreator.java?r1=1.10&r2=1.11

http://websvc.netbeans.org/source/browse/websvc/design/nbproject/project.xml?r1=1.21&r2=1.22
http://websvc.netbeans.org/source/browse/websvc/editorhints/nbproject/project.xml?r1=1.3&r2=1.4
http://websvc.netbeans.org/source/browse/websvc/jaxwsmodel/nbproject/project.xml?r1=1.15&r2=1.16
http://websvc.netbeans.org/source/browse/websvc/jaxwsmodel/src/org/netbeans/modules/websvc/jaxwsmodel/resources/jaxws-j2se.xsl?r1=1.3&r2=1.4

http://identity.netbeans.org/source/browse/identity/profileapi/nbproject/project.xml?r1=1.4&r2=1.5
http://mobility.netbeans.org/source/browse/mobility/deployment/deviceanywhere/nbproject/project.xml?r1=1.6&r2=1.7
http://enterprise.netbeans.org/source/browse/enterprise/compapp/projectjbi/nbproject/project.xml?r1=1.16&r2=1.18
Comment 5 Jaroslav Tulach 2007-08-21 08:37:13 UTC
Y01 Please publish the javadoc on http://bits.netbeans.org/dev/javadoc/, here is howto: 
http://openide.netbeans.org/tutorial/api.html

Y02 arch.xml is malformed (for example &lt;api should be <api) - fix it so it validates and try to run "ant javadoc" 
on the project

Y03 btw. is the jaxws21 javadoc available online, where?

I lowered the priority as except the malformed arch.xml this is not big issue.

Comment 6 Milan Kuchtiak 2007-08-21 14:25:45 UTC
Fixed Y02, Y03.
Added links to documentation, arch.xml made valid.

However, the javadoc cannot be generated as module doesn't contain any java sources.

Diff:
http://websvc.netbeans.org/source/browse/websvc/jaxws21/jaxws21api/arch.xml?r1=1.2&r2=1.3
Comment 7 Milan Kuchtiak 2007-10-05 15:52:14 UTC
Reassigning to APISUPPORT component.
The javadoc cannot be created as the module has no sources.
Comment 8 Jesse Glick 2007-10-05 18:00:26 UTC
It's up to you to supply a 'javadoc' target override if you have unusual needs.
Comment 9 Milan Kuchtiak 2008-03-25 10:36:18 UTC
As we don't provide any sources javadoc for this module isn't required.