You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-user@axis.apache.org by "Lee, Ken" <Ke...@platts.com> on 2004/05/13 16:49:22 UTC
Wanted: Idiot's guide to axis
Web services are difficult...
The wiki at
http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages is
helpful, but there isn't enough detail, or I just am not experienced
enough with XML to understand.
Does anyone any a recommended step-by-step approach to learning how to
write _GREAT_ Web services?
For example, what are the appropriate places to use Web services?
I have seen a lot of messages about sending attachments up to the
server, but that is not how I thought a Web service would be used. I
was thinking about an example: I send a invoice number to a getInvoice()
web service that returns a PDF file. Is this appropriate for a Web
service. It is providing a valued service after all. But then, how in
the world would you program this? Heck, I'd love to see a mocked up
example that returns any pdf file in a directory just to see it work.
Would the client need axis? Could this be accessed with a URL -
something like
http://somehost/axis/services/InvoiceWS?getInvoice&invoiceno=12345
Would the PDF then render in the browser?
I would like to see a book (Idiot's guide or something) that had real
examples (working examples):
RPC - Send two numbers, get the result back (easy)
RPC - Send text, get a pdf back of the text as an attachment (hard)
Wrapped seems so close to RPC, that I would include an example of these
with the modified .wsdd file. Maybe I am wrong, but that is the only
difference I could find.
Message services - What a can of worms this has been. I have worked for
weeks to get something working (unfortunately, lots of unanswered posts
- how do you ask questions that get answered?). This is an area that I
have seen very few working examples. The echoMessage Web service really
didn't help me. I would love to see a simple example using third type
of Message style using documents.
I found the book "Professional XML Development with Apache Tools" by
Leung to be helpful and also complicated. Are there other good books
out there that are current. I keep waiting for the Apache Axis book
from O'Reilly to get published. It has a publish date of last March,
but I haven't seen it available yet.
If I ever get to understand this stuff, I wouldn't mind writing a guide
myself - sure, I volunteer, but first I need to learn it!
Thanks for listening,
Ken Lee
Re: Wanted: Idiot's guide to axis
Posted by Davanum Srinivas <da...@gmail.com>.
It's peer review...you'll can drop a note to axis-dev as well when you
want one of the developers to review.
thanks,
dims
----- Original Message -----
From: Hainer Neil <ha...@bah.com>
Date: Thu, 13 May 2004 11:22:38 -0400
Subject: Re: Wanted: Idiot's guide to axis
To: axis-user@ws.apache.org
Just looked at the NewbieTrails. So are you looking for volunteers to work
on the following:
Requested Trails
* UsingCommandLineTools?
* GettingStartedWithAttachments?
* BestPracticeForCreatingServices?
If so, is there are certain approach to supplying the requested information?
Anotherwords, if I submit something is there any type of editing process
- specifically to ensure everything is technically correct?
Neil
Andrew Premdas wrote:
Ken,
Couldn't agree more, see Best Practices thread in this list. I'm starting a
newbie trails guide on the axis wiki. Perhaps you would like to read and
contribute.
All best
Andrew
http://nagoya.apache.org/wiki/apachewiki.cgi?NewbieTrails
-----Original Message-----
From: Lee, Ken [mailto:Ken_Lee@platts.com]
Sent: 13 May 2004 15:49
To: axis-user@ws.apache.org
Subject: Wanted: Idiot's guide to axis
Web services are difficult...
The wiki at
http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages is
helpful, but there isn't enough detail, or I just am not experienced
enough with XML to understand.
Does anyone any a recommended step-by-step approach to learning how to
write _GREAT_ Web services?
For example, what are the appropriate places to use Web services?
I have seen a lot of messages about sending attachments up to the
server, but that is not how I thought a Web service would be used. I
was thinking about an example: I send a invoice number to a getInvoice()
web service that returns a PDF file. Is this appropriate for a Web
service. It is providing a valued service after all. But then, how in
the world would you program this? Heck, I'd love to see a mocked up
example that returns any pdf file in a directory just to see it work.
Would the client need axis? Could this be accessed with a URL -
something like
http://somehost/axis/services/InvoiceWS?getInvoice&invoiceno=12345
Would the PDF then render in the browser?
I would like to see a book (Idiot's guide or something) that had real
examples (working examples):
RPC - Send two numbers, get the result back (easy)
RPC - Send text, get a pdf back of the text as an attachment (hard)
Wrapped seems so close to RPC, that I would include an example of these
with the modified .wsdd file. Maybe I am wrong, but that is the only
difference I could find.
Message services - What a can of worms this has been. I have worked for
weeks to get something working (unfortunately, lots of unanswered posts
- how do you ask questions that get answered?). This is an area that I
have seen very few working examples. The echoMessage Web service really
didn't help me. I would love to see a simple example using third type
of Message style using documents.
I found the book "Professional XML Development with Apache Tools" by
Leung to be helpful and also complicated. Are there other good books
out there that are current. I keep waiting for the Apache Axis book
from O'Reilly to get published. It has a publish date of last March,
but I haven't seen it available yet.
If I ever get to understand this stuff, I wouldn't mind writing a guide
myself - sure, I volunteer, but first I need to learn it!
Thanks for listening,
Ken Lee
RE: Wanted: Idiot's guide to axis
Posted by Andrew Premdas <An...@man.ac.uk>.
Just announced these pages.
Wiki is a community thing basically will have to rely on other users to
review stuff and collaborate. Most pages should start of as a kind of
conversation between people perhaps with a main contributor and then get
refined and refactored into a final version. We just have to do the best we
can and if we make mistakes rely on others to correct them. If you want to
contribute something just go ahead and write stuff.
I will try and read all things here, but my contributions are most likely to
be about clarity, structure and how well items teach rather than Axis
technical stuff,
Your input would be most appreciated I'm sure
Andrew
-----Original Message-----
From: Hainer Neil [mailto:hainer_neil@bah.com]
Sent: 13 May 2004 16:23
To: axis-user@ws.apache.org
Subject: Re: Wanted: Idiot's guide to axis
Just looked at the NewbieTrails. So are you looking for volunteers to
work on the following:
Requested Trails
* UsingCommandLineTools?
* GettingStartedWithAttachments?
* BestPracticeForCreatingServices?
If so, is there are certain approach to supplying the requested information?
Anotherwords, if I submit something is there any type of editing process -
specifically to ensure everything is technically correct?
Neil
Andrew Premdas wrote:
Ken,
Couldn't agree more, see Best Practices thread in this list. I'm starting a
newbie trails guide on the axis wiki. Perhaps you would like to read and
contribute.
All best
Andrew
http://nagoya.apache.org/wiki/apachewiki.cgi?NewbieTrails
-----Original Message-----
From: Lee, Ken [mailto:Ken_Lee@platts.com]
Sent: 13 May 2004 15:49
To: axis-user@ws.apache.org
Subject: Wanted: Idiot's guide to axis
Web services are difficult...
The wiki at
http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages is
helpful, but there isn't enough detail, or I just am not experienced
enough with XML to understand.
Does anyone any a recommended step-by-step approach to learning how to
write _GREAT_ Web services?
For example, what are the appropriate places to use Web services?
I have seen a lot of messages about sending attachments up to the
server, but that is not how I thought a Web service would be used. I
was thinking about an example: I send a invoice number to a getInvoice()
web service that returns a PDF file. Is this appropriate for a Web
service. It is providing a valued service after all. But then, how in
the world would you program this? Heck, I'd love to see a mocked up
example that returns any pdf file in a directory just to see it work.
Would the client need axis? Could this be accessed with a URL -
something like
http://somehost/axis/services/InvoiceWS?getInvoice&invoiceno=12345
Would the PDF then render in the browser?
I would like to see a book (Idiot's guide or something) that had real
examples (working examples):
RPC - Send two numbers, get the result back (easy)
RPC - Send text, get a pdf back of the text as an attachment (hard)
Wrapped seems so close to RPC, that I would include an example of these
with the modified .wsdd file. Maybe I am wrong, but that is the only
difference I could find.
Message services - What a can of worms this has been. I have worked for
weeks to get something working (unfortunately, lots of unanswered posts
- how do you ask questions that get answered?). This is an area that I
have seen very few working examples. The echoMessage Web service really
didn't help me. I would love to see a simple example using third type
of Message style using documents.
I found the book "Professional XML Development with Apache Tools" by
Leung to be helpful and also complicated. Are there other good books
out there that are current. I keep waiting for the Apache Axis book
from O'Reilly to get published. It has a publish date of last March,
but I haven't seen it available yet.
If I ever get to understand this stuff, I wouldn't mind writing a guide
myself - sure, I volunteer, but first I need to learn it!
Thanks for listening,
Ken Lee
Re: Wanted: Idiot's guide to axis
Posted by Hainer Neil <ha...@bah.com>.
Just looked at the NewbieTrails. So are you looking for volunteers to
work on the following:
Requested Trails
* UsingCommandLineTools? <http://nagoya.apache.org/wiki/apachewiki.cgi?action=edit&id=UsingCommandLineTools>
* GettingStartedWithAttachments? <http://nagoya.apache.org/wiki/apachewiki.cgi?action=edit&id=GettingStartedWithAttachments>
* BestPracticeForCreatingServices? <http://nagoya.apache.org/wiki/apachewiki.cgi?action=edit&id=BestPracticeForCreatingServices>
If so, is there are certain approach to supplying the requested
information? Anotherwords, if I submit something is there any type of
editing process - specifically to ensure everything is technically correct?
Neil
Andrew Premdas wrote:
>Ken,
>
>Couldn't agree more, see Best Practices thread in this list. I'm starting a
>newbie trails guide on the axis wiki. Perhaps you would like to read and
>contribute.
>
>All best
>
>Andrew
>
>http://nagoya.apache.org/wiki/apachewiki.cgi?NewbieTrails
>
>
>-----Original Message-----
>From: Lee, Ken [mailto:Ken_Lee@platts.com]
>Sent: 13 May 2004 15:49
>To: axis-user@ws.apache.org
>Subject: Wanted: Idiot's guide to axis
>
>
>Web services are difficult...
>
>The wiki at
>http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages is
>helpful, but there isn't enough detail, or I just am not experienced
>enough with XML to understand.
>
>Does anyone any a recommended step-by-step approach to learning how to
>write _GREAT_ Web services?
>
>For example, what are the appropriate places to use Web services?
>
>I have seen a lot of messages about sending attachments up to the
>server, but that is not how I thought a Web service would be used. I
>was thinking about an example: I send a invoice number to a getInvoice()
>web service that returns a PDF file. Is this appropriate for a Web
>service. It is providing a valued service after all. But then, how in
>the world would you program this? Heck, I'd love to see a mocked up
>example that returns any pdf file in a directory just to see it work.
>Would the client need axis? Could this be accessed with a URL -
>something like
>http://somehost/axis/services/InvoiceWS?getInvoice&invoiceno=12345
>Would the PDF then render in the browser?
>
>I would like to see a book (Idiot's guide or something) that had real
>examples (working examples):
>
>RPC - Send two numbers, get the result back (easy)
>RPC - Send text, get a pdf back of the text as an attachment (hard)
>Wrapped seems so close to RPC, that I would include an example of these
>with the modified .wsdd file. Maybe I am wrong, but that is the only
>difference I could find.
>
>Message services - What a can of worms this has been. I have worked for
>weeks to get something working (unfortunately, lots of unanswered posts
>- how do you ask questions that get answered?). This is an area that I
>have seen very few working examples. The echoMessage Web service really
>didn't help me. I would love to see a simple example using third type
>of Message style using documents.
>
>I found the book "Professional XML Development with Apache Tools" by
>Leung to be helpful and also complicated. Are there other good books
>out there that are current. I keep waiting for the Apache Axis book
>from O'Reilly to get published. It has a publish date of last March,
>but I haven't seen it available yet.
>
>
>If I ever get to understand this stuff, I wouldn't mind writing a guide
>myself - sure, I volunteer, but first I need to learn it!
>
>Thanks for listening,
>
>Ken Lee
>
>
>
RE: Wanted: Idiot's guide to axis
Posted by Andrew Premdas <An...@man.ac.uk>.
doh, put page in wrong place, you have to be careful with the wiki as its
currently for all apache projects.
moved to
http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages/NewbieTrails
-----Original Message-----
From: Andrew Premdas [mailto:Andrew.Premdas@man.ac.uk]
Sent: 13 May 2004 16:10
To: axis-user@ws.apache.org
Subject: RE: Wanted: Idiot's guide to axis
Ken,
Couldn't agree more, see Best Practices thread in this list. I'm starting a
newbie trails guide on the axis wiki. Perhaps you would like to read and
contribute.
All best
Andrew
http://nagoya.apache.org/wiki/apachewiki.cgi?NewbieTrails
-----Original Message-----
From: Lee, Ken [mailto:Ken_Lee@platts.com]
Sent: 13 May 2004 15:49
To: axis-user@ws.apache.org
Subject: Wanted: Idiot's guide to axis
Web services are difficult...
The wiki at
http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages is
helpful, but there isn't enough detail, or I just am not experienced
enough with XML to understand.
Does anyone any a recommended step-by-step approach to learning how to
write _GREAT_ Web services?
For example, what are the appropriate places to use Web services?
I have seen a lot of messages about sending attachments up to the
server, but that is not how I thought a Web service would be used. I
was thinking about an example: I send a invoice number to a getInvoice()
web service that returns a PDF file. Is this appropriate for a Web
service. It is providing a valued service after all. But then, how in
the world would you program this? Heck, I'd love to see a mocked up
example that returns any pdf file in a directory just to see it work.
Would the client need axis? Could this be accessed with a URL -
something like
http://somehost/axis/services/InvoiceWS?getInvoice&invoiceno=12345
Would the PDF then render in the browser?
I would like to see a book (Idiot's guide or something) that had real
examples (working examples):
RPC - Send two numbers, get the result back (easy)
RPC - Send text, get a pdf back of the text as an attachment (hard)
Wrapped seems so close to RPC, that I would include an example of these
with the modified .wsdd file. Maybe I am wrong, but that is the only
difference I could find.
Message services - What a can of worms this has been. I have worked for
weeks to get something working (unfortunately, lots of unanswered posts
- how do you ask questions that get answered?). This is an area that I
have seen very few working examples. The echoMessage Web service really
didn't help me. I would love to see a simple example using third type
of Message style using documents.
I found the book "Professional XML Development with Apache Tools" by
Leung to be helpful and also complicated. Are there other good books
out there that are current. I keep waiting for the Apache Axis book
from O'Reilly to get published. It has a publish date of last March,
but I haven't seen it available yet.
If I ever get to understand this stuff, I wouldn't mind writing a guide
myself - sure, I volunteer, but first I need to learn it!
Thanks for listening,
Ken Lee
Announce: newbie trails (guides for new users to axis)
Posted by Andrew Premdas <An...@man.ac.uk>.
see
http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages/NewbieTrails
Following on from discussions in thread Best Practices I've set up a page or
two on the wiki to start addressing this and other documentation issues for
new users.
For those of you who know all about Axis,
1. please review the advice given here and comment if you have some time
2. please contribute help and explanations
For new users
1. if you have particular topic which you think needs a better explanation
then add it
2. if you have an explanation please add it
For everyone
1. if you can contribute paths that will provide clearer explanations of
how to do things with Axis then please do
Ultimate aim is to provide resources that are useful in themselves and can
help improve the tutorial quality of the main documentation.
All best
Andrew
Andrew Premdas
Student Systems Developer
Manchester University
RE: Wanted: Idiot's guide to axis
Posted by Andrew Premdas <An...@man.ac.uk>.
Ken,
Couldn't agree more, see Best Practices thread in this list. I'm starting a
newbie trails guide on the axis wiki. Perhaps you would like to read and
contribute.
All best
Andrew
http://nagoya.apache.org/wiki/apachewiki.cgi?NewbieTrails
-----Original Message-----
From: Lee, Ken [mailto:Ken_Lee@platts.com]
Sent: 13 May 2004 15:49
To: axis-user@ws.apache.org
Subject: Wanted: Idiot's guide to axis
Web services are difficult...
The wiki at
http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages is
helpful, but there isn't enough detail, or I just am not experienced
enough with XML to understand.
Does anyone any a recommended step-by-step approach to learning how to
write _GREAT_ Web services?
For example, what are the appropriate places to use Web services?
I have seen a lot of messages about sending attachments up to the
server, but that is not how I thought a Web service would be used. I
was thinking about an example: I send a invoice number to a getInvoice()
web service that returns a PDF file. Is this appropriate for a Web
service. It is providing a valued service after all. But then, how in
the world would you program this? Heck, I'd love to see a mocked up
example that returns any pdf file in a directory just to see it work.
Would the client need axis? Could this be accessed with a URL -
something like
http://somehost/axis/services/InvoiceWS?getInvoice&invoiceno=12345
Would the PDF then render in the browser?
I would like to see a book (Idiot's guide or something) that had real
examples (working examples):
RPC - Send two numbers, get the result back (easy)
RPC - Send text, get a pdf back of the text as an attachment (hard)
Wrapped seems so close to RPC, that I would include an example of these
with the modified .wsdd file. Maybe I am wrong, but that is the only
difference I could find.
Message services - What a can of worms this has been. I have worked for
weeks to get something working (unfortunately, lots of unanswered posts
- how do you ask questions that get answered?). This is an area that I
have seen very few working examples. The echoMessage Web service really
didn't help me. I would love to see a simple example using third type
of Message style using documents.
I found the book "Professional XML Development with Apache Tools" by
Leung to be helpful and also complicated. Are there other good books
out there that are current. I keep waiting for the Apache Axis book
from O'Reilly to get published. It has a publish date of last March,
but I haven't seen it available yet.
If I ever get to understand this stuff, I wouldn't mind writing a guide
myself - sure, I volunteer, but first I need to learn it!
Thanks for listening,
Ken Lee