Bug 779274 (SOA-1663) - jUDDI v3 sample code referenced in user guide, not included in ER4 build
Summary: jUDDI v3 sample code referenced in user guide, not included in ER4 build
Keywords:
Status: CLOSED WONTFIX
Alias: SOA-1663
Product: JBoss Enterprise SOA Platform 5
Classification: JBoss
Component: Documentation, Distribution, jUDDI - within SOA
Version: 5.0.0 ER4
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: ---
: FUTURE
Assignee: Kurt Stam
QA Contact:
URL: http://jira.jboss.org/jira/browse/SOA...
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2009-12-03 03:04 UTC by Len DiMaggio
Modified: 2011-04-08 20:00 UTC (History)
0 users

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2011-04-08 20:00:29 UTC
Type: Bug


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Bugzilla 779266 0 high CLOSED jUDDI v3 user guide 2021-02-22 00:41:40 UTC
Red Hat Issue Tracker SOA-1663 0 None None None Never

Internal Links: 779266

Description Len DiMaggio 2009-12-03 03:04:12 UTC
Affects: Release Notes
Date of First Response: 2009-12-16 13:36:55
project_key: SOA

In ER4, the client (for example, the juddi-client-3.0.0.jar file) is packaged in jboss-soa-p.5.0.0/jboss-as/server/production/deploy/uddi-console.war - the sample code, however is not. If we are supporting and documenting the use of the client, then we should ship all the documented code/files and not require SOA-P 5.0 customers to have to download the jUDDI project. In the new SOA-P jUDDI v3 guide, this section refers to the examples:

=============

7.7. Sample Code
Sample code demonstrating how to use the UDDI Client can be found in the uddi-client module
on the jUDDI v3 project. 

Another place to look for sample code is the docs/examples/helloword directory. A final
alternative is to use annotations.

Comment 1 Kurt Stam 2009-12-16 18:36:55 UTC
Happy to work on this but I maybe more an ESB task since they integrate jUDDI? Could we simply add links to the maven artifacts, rather then shipping it?

Comment 2 Kevin Conner 2009-12-17 15:20:10 UTC
We have no interest in the juddi documentation, examples nor uddi-console, definitely not an ESB task.

Comment 3 Dana Mison 2010-01-06 00:48:08 UTC
For the SOA jUDDI docs we have decided to link to the project example code.

A disclaimer is going to be added to the text in the doc specifying that although the use-cases described by the code are supported, the example code itself is not & has not been QE'd or tested.  

Are you aware of any issues that could complicate this, Kurt?

Comment 4 Dana Mison 2010-01-21 04:09:08 UTC
quick question: I can't find juddi-client-3.0.0.jar

The closest I can find is jboss-soa-p.5.0.0/jboss-as/server/production/deployers/esb.deployer/lib/juddi-client-3.0.0.aop.jar

I suspect that this is not the jar I'm looking for.

Comment 5 Kurt Stam 2010-01-21 05:44:35 UTC
It actually is the jar you are looking for + some aop fixed, which we are currently trying to roll in, so that we don't need the aop stuff anymore.

Comment 6 Kevin Conner 2010-01-21 06:57:14 UTC
Kurt is correct, the aop version allows ESB to workaround some issues in that version of juddi.

The intent is to remove as many, if not all, of these workarounds with the upcoming 3.0.1 release of juddi at which point this should be called juddi-client-3.0.1.jar.

If we still need the aop version then we will also have to add the aop jars/configuration to the documentation. 

Comment 7 Len DiMaggio 2010-01-22 01:27:58 UTC
Link: Added: This issue related SOA-1657


Comment 8 Anne-Louise Tangring 2010-01-22 17:57:57 UTC
Affects: Added: [Release Notes]


Comment 9 Dana Mison 2010-01-27 00:57:31 UTC
OK, I'll update the docs to indicate that JAR file

Also: what is the best URL (for this version of jUDDI) to direct people to for the sample code?

Comment 10 Dana Mison 2010-01-31 23:22:07 UTC
Is this URL ok for the example code? 
http://svn.apache.org/repos/asf/webservices/juddi/tags/juddi-3.0.0/juddiv3-samples/ 

Comment 11 Kurt Stam 2010-02-01 14:27:28 UTC
http://svn.apache.org/repos/asf/webservices/juddi/tags/juddi-3.0.1/docs/examples/
http://svn.apache.org/repos/asf/webservices/juddi/tags/juddi-3.0.1/juddiv3-samples/

I think we may want to consider adding the relevant code as an appendix. One of the things I will do this week is set up a jboss soa-p instance with the latest code to make sure it all works.

--Kurt

Comment 12 Dana Mison 2010-02-02 05:56:17 UTC
re: including code as an appendix

I've thought about that, for it to be worthwhile you need to include the code for the complete complete project & all the details of directory structure, maven pom etc. ie. everything that someone would need to build it.

It's generally better to include snippets of relevant code & then direct users to where the complete projects are available.

Could the jUDDI samples could be zipped up for separate download on ws.apache.org/juddi ?

Comment 13 Anne-Louise Tangring 2010-12-02 16:04:48 UTC
PM team decided this is a nice to have for SOA 5.1.0. Not a blocker. 

Comment 14 Laura Bailey 2010-12-17 00:41:29 UTC
Writer: Added: Darrin


Comment 15 Laura Bailey 2010-12-17 00:48:00 UTC
Release Notes Docs Status: Added: Not Yet Documented



Note You need to log in before you can comment on or make changes to this bug.