You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@cxf.apache.org by Benson Margulies <bi...@basistech.com> on 2007/07/19 15:16:52 UTC

Contribution of wsdl2js tool

Dear CXF team,

 

Basis Technology would like to contribute our wsdl2js tool to CXF under
the usual ASF license.

 

The tool consists of Java source code that uses the same WSDL library
that CXF already uses and generates Javascript code that targets some
JavaScript utility functions that work in Firefox and IE (and probably
others).

 

What is the mechanics of this process? I could tar up the whole business
and append it to a JIRA. You could consider accepting me as a committer.
You could ask me to post it for review some other way.

 

--benson

 


Re: Contribution of wsdl2js tool

Posted by Daniel Kulp <dk...@apache.org>.
(I'm CCing one of our mentors to make sure I get this right)


Yes.   This would be considered a software grant.   There is another form 
that needs to be filled out for that.

See:
http://www.apache.org/licenses/#grants

We'll need to bring this up on the IPMC list as well to make sure they 
are OK with it.   


Dan


On Thursday 19 July 2007 11:28, Dan Diephouse wrote:
> Hi Benson,
>
> Such contributions are definitely welcome!
>
> I believe there are a few major things that need to happen. You would
> need to package the code under an ASL license and send along Corporate
> CLA [1]. The CXF community would also need to vote on the contribution
> and possible committers. There may also be some incubator related
> things we need to do. I'll do some digging and will report back with
> more info.
>
> Also, it might be good to redirect this discussion to the dev list.
>
> Cheers,
> - Dan
>
> 1. http://www.apache.org/licenses/#clas
>
> On 7/19/07, Benson Margulies <bi...@basistech.com> wrote:
> > Dear CXF team,
> >
> >
> >
> > Basis Technology would like to contribute our wsdl2js tool to CXF
> > under the usual ASF license.
> >
> >
> >
> > The tool consists of Java source code that uses the same WSDL
> > library that CXF already uses and generates Javascript code that
> > targets some JavaScript utility functions that work in Firefox and
> > IE (and probably others).
> >
> >
> >
> > What is the mechanics of this process? I could tar up the whole
> > business and append it to a JIRA. You could consider accepting me as
> > a committer. You could ask me to post it for review some other way.
> >
> >
> >
> > --benson

-- 
J. Daniel Kulp
Principal Engineer
IONA
P: 781-902-8727    C: 508-380-7194
daniel.kulp@iona.com
http://www.dankulp.com/blog

Re: Contribution of wsdl2js tool

Posted by Dan Diephouse <da...@envoisolutions.com>.
Forgot one thing - I think tarring it up and attaching it to a JIRA issue
would be fine. Then we can start a discussion about the code and how the
community feels about accepting it :-) I'm definitely interested and am keen
to see what you've done.

Cheers,
- Dan

On 7/19/07, Dan Diephouse <da...@envoisolutions.com> wrote:
>
> Hi Benson,
>
> Such contributions are definitely welcome!
>
> I believe there are a few major things that need to happen. You would need
> to package the code under an ASL license and send along Corporate CLA [1].
> The CXF community would also need to vote on the contribution and possible
> committers. There may also be some incubator related things we need to do.
> I'll do some digging and will report back with more info.
>
> Also, it might be good to redirect this discussion to the dev list.
>
> Cheers,
> - Dan
>
> 1. http://www.apache.org/licenses/#clas
>
> On 7/19/07, Benson Margulies <bi...@basistech.com> wrote:
> >
> > Dear CXF team,
> >
> >
> >
> > Basis Technology would like to contribute our wsdl2js tool to CXF under
> > the usual ASF license.
> >
> >
> >
> > The tool consists of Java source code that uses the same WSDL library
> > that CXF already uses and generates Javascript code that targets some
> > JavaScript utility functions that work in Firefox and IE (and probably
> > others).
> >
> >
> >
> > What is the mechanics of this process? I could tar up the whole business
> > and append it to a JIRA. You could consider accepting me as a committer.
> >
> > You could ask me to post it for review some other way.
> >
> >
> >
> > --benson
> >
> >
> >
> >
>
>
> --
> Dan Diephouse
> Envoi Solutions
> http://envoisolutions.com | http://netzooid.com/blog




-- 
Dan Diephouse
Envoi Solutions
http://envoisolutions.com | http://netzooid.com/blog

RE: Contribution of wsdl2js tool

Posted by Benson Margulies <bi...@basistech.com>.
James,

Your analysis of the current architecture is correct.

The way we use this today is this: from a web page, you include the two
generated JavaScript files plus some utilities which I'll post soon.

To talk to the service, the user's code has to create one or more
objects and set their properties, and then start the interaction with
the server. The user supplies functions to be called on a successful
response or an error.

If we generate the code dynamically, as per your and Dan's suggestion,
we'll emit all of that code all at once.

I would offer a caveat: when developing an application of this, the
programmer needs to stare at the generated JavaScript to see what the
protocol is. And a single web application might be talking to more than
one service, so defining the common utilities over-and-over might not be
entirely desirable. Just as you can either use the ?wsdl URL to obtain
WSDL, or you can run java2wsdl, I'd recommend supporting both a
command-line javascript emitter and also the fully dynamic scheme. This
would also have the effect of retaining some usefulness for people who
want to talk to a non-CXF service. 

> -----Original Message-----
> From: James Mao [mailto:james.mao@iona.com]
> Sent: Thursday, July 19, 2007 11:54 PM
> To: cxf-dev@incubator.apache.org
> Subject: Re: Contribution of wsdl2js tool
> 
> Hi Benson,
> 
> Excellent job, Just go through the code, really great.
> 
> So, to be more specific, the wsdl2js is about turn the wsdl1.1 wsdl
> (through wsdl4j) to a js soap client which can be embed in the
browser,
> right?
> or at least that's the current status.
> 
> One question, how you deploy those generated artifacts?
> 
> As Dan metioned, is it possible to use url like this
> http://localhost/fooService?js to get the artifacts,
> I saw normally you will generate two js files, one for the types,
> another for the protocol
> If that's what we will do, then the code will go into the CXF runtime,
> we don't need the wsdl2js command line tools any more
> (Or we still need the command line tools, because people maybe use
other
> service framework, and just want the cxf command line tools to
generate
> js artifacts)
> 
> Here is just a FYI,
> 
> In CXF wsdlto framework, we will first turn the wsdl file to wsdl
> definition (through wsdl4j) , then we will customize the wsdl
defintion
> in case of jaxws (jaxws binding files etc.)
> and then we turn the wsdl definition to cxf service model (which will
> support both the wsdl1.1 and wsdl2.0)
> The service model will be further processed by a chain of processors,
> and turn into the CXF java model (in case of wsdl2java),
> The generated java model will then give to bunch of generators, which
> will generate the final artifacts (velocity template based)
> 
> 
> So, in case of wsdl2js, i think what we need to do is just port the js
> model you have, reuse the Translator you have and turn it to a
> processor, and then write some generators and templates,
> 
> I'm thinking of adding a new tools frontend plugin (hope not) or just
> some processors/generators for the tools jaxws frontend?
> 
> Regards,
> James
> 
> 
> 
> > Hi Benson,
> >
> > Thanks for taking the initial steps with this contribution (and for
your
> > other unit test contributions so far).
> >
> > I've taken an initial look through the code and wanted to relay some
> > thoughts. First, I like the way you've done this. Its simple - I was
> > trying
> > to do something way more complicated back in the day and I think
this
> > way is
> > probably much better :-). I have yet to try it out on any actual
> services
> > though ;-)
> >
> > My next thought is that if we're going to accept this contribution,
we
> > would
> > need to get it inside our build. We can help give you guidance on
this.
> > Basically we just need to get it Mavenized, in the standard
directory
> > layout, set up with the appropriate Apache license headers,
conforming
> to
> > our Checkstyle/PMD rules, etc.
> >
> > Lastly, I think it'd be really cool if we hooked this into CXF such
that
> > someone could call http://localhost/fooService?js and get out a
> > javascript
> > client. CXF has a QueryHandler interface which we can implement to
do
> > this.
> > That is how ?wsdl is supported as well.
> >
> > Cheers,
> > - Dan
> >
> > On 7/19/07, Benson Margulies <bi...@basistech.com> wrote:
> >>
> >> OK, time to join the dev list. Will do.
> >>
> >> > -----Original Message-----
> >> > From: Dan Diephouse [mailto:dan@envoisolutions.com]
> >> > Sent: Thursday, July 19, 2007 11:29 AM
> >> > To: cxf-user@incubator.apache.org
> >> > Subject: Re: Contribution of wsdl2js tool
> >> >
> >> > Hi Benson,
> >> >
> >> > Such contributions are definitely welcome!
> >> >
> >> > I believe there are a few major things that need to happen. You
would
> >> need
> >> > to package the code under an ASL license and send along Corporate
CLA
> >> [1].
> >> > The CXF community would also need to vote on the contribution and
> >> possible
> >> > committers. There may also be some incubator related things we
need
> to
> >> do.
> >> > I'll do some digging and will report back with more info.
> >> >
> >> > Also, it might be good to redirect this discussion to the dev
list.
> >> >
> >> > Cheers,
> >> > - Dan
> >> >
> >> > 1. http://www.apache.org/licenses/#clas
> >> >
> >> > On 7/19/07, Benson Margulies <bi...@basistech.com> wrote:
> >> > >
> >> > > Dear CXF team,
> >> > >
> >> > >
> >> > >
> >> > > Basis Technology would like to contribute our wsdl2js tool to
CXF
> >> under
> >> > > the usual ASF license.
> >> > >
> >> > >
> >> > >
> >> > > The tool consists of Java source code that uses the same WSDL
> >> library
> >> > > that CXF already uses and generates Javascript code that
targets
> >> some
> >> > > JavaScript utility functions that work in Firefox and IE (and
> >> probably
> >> > > others).
> >> > >
> >> > >
> >> > >
> >> > > What is the mechanics of this process? I could tar up the whole
> >> business
> >> > > and append it to a JIRA. You could consider accepting me as a
> >> committer.
> >> > > You could ask me to post it for review some other way.
> >> > >
> >> > >
> >> > >
> >> > > --benson
> >> > >
> >> > >
> >> > >
> >> > >
> >> >
> >> >
> >> > --
> >> > Dan Diephouse
> >> > Envoi Solutions
> >> > http://envoisolutions.com | http://netzooid.com/blog
> >>
> >
> >
> >

Re: Contribution of wsdl2js tool

Posted by James Mao <ja...@iona.com>.
Hi Benson,

Excellent job, Just go through the code, really great.

So, to be more specific, the wsdl2js is about turn the wsdl1.1 wsdl 
(through wsdl4j) to a js soap client which can be embed in the browser, 
right?
or at least that's the current status.

One question, how you deploy those generated artifacts?

As Dan metioned, is it possible to use url like this 
http://localhost/fooService?js to get the artifacts,
I saw normally you will generate two js files, one for the types, 
another for the protocol
If that's what we will do, then the code will go into the CXF runtime, 
we don't need the wsdl2js command line tools any more
(Or we still need the command line tools, because people maybe use other 
service framework, and just want the cxf command line tools to generate 
js artifacts)

Here is just a FYI,

In CXF wsdlto framework, we will first turn the wsdl file to wsdl 
definition (through wsdl4j) , then we will customize the wsdl defintion 
in case of jaxws (jaxws binding files etc.)
and then we turn the wsdl definition to cxf service model (which will 
support both the wsdl1.1 and wsdl2.0)
The service model will be further processed by a chain of processors, 
and turn into the CXF java model (in case of wsdl2java),
The generated java model will then give to bunch of generators, which 
will generate the final artifacts (velocity template based)


So, in case of wsdl2js, i think what we need to do is just port the js 
model you have, reuse the Translator you have and turn it to a 
processor, and then write some generators and templates,

I'm thinking of adding a new tools frontend plugin (hope not) or just 
some processors/generators for the tools jaxws frontend?

Regards,
James



> Hi Benson,
>
> Thanks for taking the initial steps with this contribution (and for your
> other unit test contributions so far).
>
> I've taken an initial look through the code and wanted to relay some
> thoughts. First, I like the way you've done this. Its simple - I was 
> trying
> to do something way more complicated back in the day and I think this 
> way is
> probably much better :-). I have yet to try it out on any actual services
> though ;-)
>
> My next thought is that if we're going to accept this contribution, we 
> would
> need to get it inside our build. We can help give you guidance on this.
> Basically we just need to get it Mavenized, in the standard directory
> layout, set up with the appropriate Apache license headers, conforming to
> our Checkstyle/PMD rules, etc.
>
> Lastly, I think it'd be really cool if we hooked this into CXF such that
> someone could call http://localhost/fooService?js and get out a 
> javascript
> client. CXF has a QueryHandler interface which we can implement to do 
> this.
> That is how ?wsdl is supported as well.
>
> Cheers,
> - Dan
>
> On 7/19/07, Benson Margulies <bi...@basistech.com> wrote:
>>
>> OK, time to join the dev list. Will do.
>>
>> > -----Original Message-----
>> > From: Dan Diephouse [mailto:dan@envoisolutions.com]
>> > Sent: Thursday, July 19, 2007 11:29 AM
>> > To: cxf-user@incubator.apache.org
>> > Subject: Re: Contribution of wsdl2js tool
>> >
>> > Hi Benson,
>> >
>> > Such contributions are definitely welcome!
>> >
>> > I believe there are a few major things that need to happen. You would
>> need
>> > to package the code under an ASL license and send along Corporate CLA
>> [1].
>> > The CXF community would also need to vote on the contribution and
>> possible
>> > committers. There may also be some incubator related things we need to
>> do.
>> > I'll do some digging and will report back with more info.
>> >
>> > Also, it might be good to redirect this discussion to the dev list.
>> >
>> > Cheers,
>> > - Dan
>> >
>> > 1. http://www.apache.org/licenses/#clas
>> >
>> > On 7/19/07, Benson Margulies <bi...@basistech.com> wrote:
>> > >
>> > > Dear CXF team,
>> > >
>> > >
>> > >
>> > > Basis Technology would like to contribute our wsdl2js tool to CXF
>> under
>> > > the usual ASF license.
>> > >
>> > >
>> > >
>> > > The tool consists of Java source code that uses the same WSDL
>> library
>> > > that CXF already uses and generates Javascript code that targets
>> some
>> > > JavaScript utility functions that work in Firefox and IE (and
>> probably
>> > > others).
>> > >
>> > >
>> > >
>> > > What is the mechanics of this process? I could tar up the whole
>> business
>> > > and append it to a JIRA. You could consider accepting me as a
>> committer.
>> > > You could ask me to post it for review some other way.
>> > >
>> > >
>> > >
>> > > --benson
>> > >
>> > >
>> > >
>> > >
>> >
>> >
>> > --
>> > Dan Diephouse
>> > Envoi Solutions
>> > http://envoisolutions.com | http://netzooid.com/blog
>>
>
>
>

RE: Contribution of wsdl2js tool

Posted by Benson Margulies <bi...@basistech.com>.
Dan,

That all sounds fine. If you tell me where you want it in your tree, I
can set up a pom, fix up all the checkstyle issues, etc.

I intentionally didn't put the Apache headers in place until I get the
CLA submitted, I don't want anyone to yell at me for pretending to make
a contribution without the legal backup.

I should warn you that we haven't tested it on anything like a
comprehensive supply of WSDL files. An entirely selfish reason to
contribute it is to see if anyone else will pitch in.

Also, if we make it possible to pull the resulting js out of a URL, we
should probably include the supporting javascript (which I didn't bother
to attach to the initial review version).

--benson


> -----Original Message-----
> From: Dan Diephouse [mailto:dan@envoisolutions.com]
> Sent: Thursday, July 19, 2007 3:58 PM
> To: cxf-dev@incubator.apache.org
> Subject: Re: Contribution of wsdl2js tool
> 
> Hi Benson,
> 
> Thanks for taking the initial steps with this contribution (and for
your
> other unit test contributions so far).
> 
> I've taken an initial look through the code and wanted to relay some
> thoughts. First, I like the way you've done this. Its simple - I was
> trying
> to do something way more complicated back in the day and I think this
way
> is
> probably much better :-). I have yet to try it out on any actual
services
> though ;-)
> 
> My next thought is that if we're going to accept this contribution, we
> would
> need to get it inside our build. We can help give you guidance on
this.
> Basically we just need to get it Mavenized, in the standard directory
> layout, set up with the appropriate Apache license headers, conforming
to
> our Checkstyle/PMD rules, etc.
> 
> Lastly, I think it'd be really cool if we hooked this into CXF such
that
> someone could call http://localhost/fooService?js and get out a
javascript
> client. CXF has a QueryHandler interface which we can implement to do
this.
> That is how ?wsdl is supported as well.
> 
> Cheers,
> - Dan
> 
> On 7/19/07, Benson Margulies <bi...@basistech.com> wrote:
> >
> > OK, time to join the dev list. Will do.
> >
> > > -----Original Message-----
> > > From: Dan Diephouse [mailto:dan@envoisolutions.com]
> > > Sent: Thursday, July 19, 2007 11:29 AM
> > > To: cxf-user@incubator.apache.org
> > > Subject: Re: Contribution of wsdl2js tool
> > >
> > > Hi Benson,
> > >
> > > Such contributions are definitely welcome!
> > >
> > > I believe there are a few major things that need to happen. You
would
> > need
> > > to package the code under an ASL license and send along Corporate
CLA
> > [1].
> > > The CXF community would also need to vote on the contribution and
> > possible
> > > committers. There may also be some incubator related things we
need to
> > do.
> > > I'll do some digging and will report back with more info.
> > >
> > > Also, it might be good to redirect this discussion to the dev
list.
> > >
> > > Cheers,
> > > - Dan
> > >
> > > 1. http://www.apache.org/licenses/#clas
> > >
> > > On 7/19/07, Benson Margulies <bi...@basistech.com> wrote:
> > > >
> > > > Dear CXF team,
> > > >
> > > >
> > > >
> > > > Basis Technology would like to contribute our wsdl2js tool to
CXF
> > under
> > > > the usual ASF license.
> > > >
> > > >
> > > >
> > > > The tool consists of Java source code that uses the same WSDL
> > library
> > > > that CXF already uses and generates Javascript code that targets
> > some
> > > > JavaScript utility functions that work in Firefox and IE (and
> > probably
> > > > others).
> > > >
> > > >
> > > >
> > > > What is the mechanics of this process? I could tar up the whole
> > business
> > > > and append it to a JIRA. You could consider accepting me as a
> > committer.
> > > > You could ask me to post it for review some other way.
> > > >
> > > >
> > > >
> > > > --benson
> > > >
> > > >
> > > >
> > > >
> > >
> > >
> > > --
> > > Dan Diephouse
> > > Envoi Solutions
> > > http://envoisolutions.com | http://netzooid.com/blog
> >
> 
> 
> 
> --
> Dan Diephouse
> Envoi Solutions
> http://envoisolutions.com | http://netzooid.com/blog

Re: Contribution of wsdl2js tool

Posted by Dan Diephouse <da...@envoisolutions.com>.
Hi Benson,

Thanks for taking the initial steps with this contribution (and for your
other unit test contributions so far).

I've taken an initial look through the code and wanted to relay some
thoughts. First, I like the way you've done this. Its simple - I was trying
to do something way more complicated back in the day and I think this way is
probably much better :-). I have yet to try it out on any actual services
though ;-)

My next thought is that if we're going to accept this contribution, we would
need to get it inside our build. We can help give you guidance on this.
Basically we just need to get it Mavenized, in the standard directory
layout, set up with the appropriate Apache license headers, conforming to
our Checkstyle/PMD rules, etc.

Lastly, I think it'd be really cool if we hooked this into CXF such that
someone could call http://localhost/fooService?js and get out a javascript
client. CXF has a QueryHandler interface which we can implement to do this.
That is how ?wsdl is supported as well.

Cheers,
- Dan

On 7/19/07, Benson Margulies <bi...@basistech.com> wrote:
>
> OK, time to join the dev list. Will do.
>
> > -----Original Message-----
> > From: Dan Diephouse [mailto:dan@envoisolutions.com]
> > Sent: Thursday, July 19, 2007 11:29 AM
> > To: cxf-user@incubator.apache.org
> > Subject: Re: Contribution of wsdl2js tool
> >
> > Hi Benson,
> >
> > Such contributions are definitely welcome!
> >
> > I believe there are a few major things that need to happen. You would
> need
> > to package the code under an ASL license and send along Corporate CLA
> [1].
> > The CXF community would also need to vote on the contribution and
> possible
> > committers. There may also be some incubator related things we need to
> do.
> > I'll do some digging and will report back with more info.
> >
> > Also, it might be good to redirect this discussion to the dev list.
> >
> > Cheers,
> > - Dan
> >
> > 1. http://www.apache.org/licenses/#clas
> >
> > On 7/19/07, Benson Margulies <bi...@basistech.com> wrote:
> > >
> > > Dear CXF team,
> > >
> > >
> > >
> > > Basis Technology would like to contribute our wsdl2js tool to CXF
> under
> > > the usual ASF license.
> > >
> > >
> > >
> > > The tool consists of Java source code that uses the same WSDL
> library
> > > that CXF already uses and generates Javascript code that targets
> some
> > > JavaScript utility functions that work in Firefox and IE (and
> probably
> > > others).
> > >
> > >
> > >
> > > What is the mechanics of this process? I could tar up the whole
> business
> > > and append it to a JIRA. You could consider accepting me as a
> committer.
> > > You could ask me to post it for review some other way.
> > >
> > >
> > >
> > > --benson
> > >
> > >
> > >
> > >
> >
> >
> > --
> > Dan Diephouse
> > Envoi Solutions
> > http://envoisolutions.com | http://netzooid.com/blog
>



-- 
Dan Diephouse
Envoi Solutions
http://envoisolutions.com | http://netzooid.com/blog

RE: Contribution of wsdl2js tool

Posted by Benson Margulies <bi...@basistech.com>.
OK, time to join the dev list. Will do.

> -----Original Message-----
> From: Dan Diephouse [mailto:dan@envoisolutions.com]
> Sent: Thursday, July 19, 2007 11:29 AM
> To: cxf-user@incubator.apache.org
> Subject: Re: Contribution of wsdl2js tool
> 
> Hi Benson,
> 
> Such contributions are definitely welcome!
> 
> I believe there are a few major things that need to happen. You would
need
> to package the code under an ASL license and send along Corporate CLA
[1].
> The CXF community would also need to vote on the contribution and
possible
> committers. There may also be some incubator related things we need to
do.
> I'll do some digging and will report back with more info.
> 
> Also, it might be good to redirect this discussion to the dev list.
> 
> Cheers,
> - Dan
> 
> 1. http://www.apache.org/licenses/#clas
> 
> On 7/19/07, Benson Margulies <bi...@basistech.com> wrote:
> >
> > Dear CXF team,
> >
> >
> >
> > Basis Technology would like to contribute our wsdl2js tool to CXF
under
> > the usual ASF license.
> >
> >
> >
> > The tool consists of Java source code that uses the same WSDL
library
> > that CXF already uses and generates Javascript code that targets
some
> > JavaScript utility functions that work in Firefox and IE (and
probably
> > others).
> >
> >
> >
> > What is the mechanics of this process? I could tar up the whole
business
> > and append it to a JIRA. You could consider accepting me as a
committer.
> > You could ask me to post it for review some other way.
> >
> >
> >
> > --benson
> >
> >
> >
> >
> 
> 
> --
> Dan Diephouse
> Envoi Solutions
> http://envoisolutions.com | http://netzooid.com/blog

Re: Contribution of wsdl2js tool

Posted by Dan Diephouse <da...@envoisolutions.com>.
Hi Benson,

Such contributions are definitely welcome!

I believe there are a few major things that need to happen. You would need
to package the code under an ASL license and send along Corporate CLA [1].
The CXF community would also need to vote on the contribution and possible
committers. There may also be some incubator related things we need to do.
I'll do some digging and will report back with more info.

Also, it might be good to redirect this discussion to the dev list.

Cheers,
- Dan

1. http://www.apache.org/licenses/#clas

On 7/19/07, Benson Margulies <bi...@basistech.com> wrote:
>
> Dear CXF team,
>
>
>
> Basis Technology would like to contribute our wsdl2js tool to CXF under
> the usual ASF license.
>
>
>
> The tool consists of Java source code that uses the same WSDL library
> that CXF already uses and generates Javascript code that targets some
> JavaScript utility functions that work in Firefox and IE (and probably
> others).
>
>
>
> What is the mechanics of this process? I could tar up the whole business
> and append it to a JIRA. You could consider accepting me as a committer.
> You could ask me to post it for review some other way.
>
>
>
> --benson
>
>
>
>


-- 
Dan Diephouse
Envoi Solutions
http://envoisolutions.com | http://netzooid.com/blog