You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tuscany.apache.org by Robbie Minshall <my...@gmail.com> on 2006/08/08 20:15:23 UTC
SDO Samples
Hi.
I made an update ( updated overview for javadoc ) for the SDO Samples.
There are still a few toDo's here that I am going to work on when I find
some time tomorrow ( namely a better xpath sample ) but things are getting
there. Could a commiter ( or anyone else interested) have a look at these
and provide me with some feedback on what they would like improved or
adjusted prior to commiting these.
I uploaded a zip of the project at :
http://wiki.apache.org/ws-data/attachments/Tuscany(2f)TuscanyJava/attachments/SDO%20Samples%202006%2008%2008<tu...@ws.apache.org>
thanks very much,
Robbie
--
* * * Charlie * * *
Check out some pics of little Charlie at
http://www.flickr.com/photos/83388211@N00/sets/
* * * Addresss * * *
1914 Overland Drive
Chapel Hill
NC 27517
* * * Number * * *
919-225-1553
Re: SDO Samples
Posted by Robbie Minshall <my...@gmail.com>.
Thanks for the feedback. I made the changes that you suggested.
There are two topics worthy of further discussion.
1. ( previously brought up) Having an initial println in SDO samples that
would provide a link for users to see the source code if running from an IDE
such as Eclipse.
+ nice to provide this easy link w/o the need for break points
- IDE specific, if runinng in command line env may be somewhat ugly
- user can setup break points in order to follow the code
- {my view} --> convienance factor outweighs negatives.
2. Instructions for dependancies. The javadoc for each of the samples
includes a list of jar files to be included on classpath in order to run the
samples. The versioning of these jar files create a bit of a maintanence
nightmare. Would like to provide an easy means for getting these
dependancies for intro level developers.
Currently I have changed one sample s.t it says :
*Usage:*
This sample can easily be run from within Eclipse as a Java Application if
tuscany or the sample-sdo project is imported into Eclipse as an existing
project.
If executing as a standalone application please do the following:
- Include the following jar files on your classpath :
- SDO API and Tuscany Implementation
- sdo-api-{version}.jar - SDO API
- tuscany-sdo-impl-{version}.jar - Tuscany SDO
implementation
- EMF dependencies.
- emf-common-{version}.jar - some common framework utility
and base classes
- emf-ecore-{version}.jar - the EMF core runtime
implementation classes (the Ecore metamodel)
- emf-ecore-change-{version}.jar - the EMF change recorder
and framework
- emf-ecore-xmi-{version}.jar - EMF's default XML (and
XMI) serializer and loader
- xsd-{version}.jar - the XML Schema model
These jar files can be obtained from directly from Tuscany and
EMF projects or from SDO Execution Dependancies
<http://wiki.apache.org/ws-data/attachments/Tuscany%282f%29TuscanyJava%282f%29SDO_Java_Overview/attachments/SDO%20Execution%20Dependencies>
- Execute:
java org.apache.tuscany.samples.sdo.ExecuteSamples
If people like this then I will make the change throughout the samples, if
people have a better suggestion then I can easily do that.
Thanks,
Robbie John.
On 8/9/06, kelvin goodson <ke...@gmail.com> wrote:
>
>
> Robbie and I discussed on the 'phone my comments so far on the samples in
> the attached spreadsheet. I'm pasting the contents below for generality
> too. (I'm hoping that these will paste back into the bookmarks view of your
> eclipse environment Robbie.)
>
> A couple of points that we thought might be worth picking out are
>
> 1) how best in general to ensure that the user has a good experience with
> regards to class path and resource finding issues when first running these
> samples. Currently Robbies top level program has source code comments on
> how to ensure the class path is right, but its not only jars that need to
> be on the class path, but resources such as the xml and xsd files. I had
> to fix up my environment before I could get it running. I guess we should
> be catering for the lowest common denominator here, and assuming only a
> shell/command window + a jvm. Any thoughts on packaging of these samples
> would be welcome?
>
> 2) Robbie's sample has a top level manager which will step by step execute
> all the samples. Many editors and SDKs will interpret strings of a certain
> format as links into the code (e.g. when an exception prints to the
> console you can often click on a line in the exception and jump to the text
> in the code). I suggested printing such a link from the main() methods of
> each sample program, to allow the user when stepping through the sequence of
> programs to jump to the code of the sample they are running, e.g.
>
> private static void defineCompanyTypes() throws Exception {
> System.out.println("Defining Types using XSD");
> System.out.println("
> org.apache.tuscany.samples.sdo.otherSources.CreateCompany.defineCompanyTypes(
> CreateCompany.java:60)");
> .....
>
> any comments?
>
> Description Resource Path Location SAMPLES: fragile, requires careful
> set up, does this work on the command line
> CreateDataObjectFromXsdAndXmlFiles.java
> sample-sdo/src/main/java/org/apache/tuscany/samples/sdo/specCodeSnippets line
> 67 SAMPLES ;-) ExecuteSamples.java
> samples-20060808/src/main/java/org/apache/tuscany/samples/sdo line 52 SAMPLES:
> are these relative links fragile, is there any robust way to ensure these
> work across environments SdoSampleConstants.java
> samples-20060808/src/main/java/org/apache/tuscany/samples/sdo line 30 SAMPLES:
> including ... ExecuteSamples.java
> samples-20060808/src/main/java/org/apache/tuscany/samples/sdo line 61 SAMPLES:
> maintenance issue -- point to web doc for instructions?
> ExecuteSamples.java
> samples-20060808/src/main/java/org/apache/tuscany/samples/sdo line 35 SAMPLES:
> sp (is pp in snipets uk english?) + others ExecuteSamples.java
> samples-20060808/src/main/java/org/apache/tuscany/samples/sdo line 59
> SAMPLES: i don't understand your comment. Is there a bug?
> CreateCompany.java
> samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
> 161 SAMPLES: seems odd for a sample to have main at the bottom
> CreateCompany.java
> samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
> 98 SAMPLES: would be nice to have some confirmation that the file was
> saved at the location PurchaseOrderCmdLine.java
> samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
> 63 SAMPLES: * @see COMPANY_GENERATED_XML ??? CreateCompany.java
> samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
> 42 SAMPLES: <CR> causes exception, null input or other error input
> should be == "1" (with bad input message?) PurchaseOrderCmdLine.java
> samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
> 120 SAMPLES: should the @link do something here? CreatePurchaseOrder.java
> samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
> 52 SAMPLES: sp CreateCompany.java
> samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
> 40 SAMPLES: SP PurchaseOrderCmdLine.java
> samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
> 324 SAMPLES: SP ReadPurchaseOrder.java
> samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
> 50 SAMPLES: suggest including interpretable link CreateCompany.java
> samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
> 60 SAMPLES: what is the source of this sample? can we ref it?
> CreateCompany.java
> samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
> 18 SAMPLES: I think rjm is filling out this test case --- check
> AccessDataObjectUsingValidXPath.java
> samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/specCodeSnippets line
> 62
>
>
>
> On 08/08/06, Robbie Minshall < mykiwi@gmail.com> wrote:
>
> > Hi.
>
> I made an update ( updated overview for javadoc ) for the SDO Samples.
> There are still a few toDo's here that I am going to work on when I find
> some time tomorrow ( namely a better xpath sample ) but things are getting
>
> there. Could a commiter ( or anyone else interested) have a look at
> these
> and provide me with some feedback on what they would like improved or
> adjusted prior to commiting these.
>
> I uploaded a zip of the project at :
> http://wiki.apache.org/ws-data/attachments/Tuscany(2f)TuscanyJava/attachments/SDO%20Samples%202006%2008%2008
>
> <http://wiki.apache.org/ws-data/attachments/Tuscany%282f%29TuscanyJava/attachments/SDO%20Samples%202006%2008%2008>
> <tu...@ws.apache.org>
>
>
> thanks very much,
> Robbie
>
>
>
> --
> * * * Charlie * * *
> Check out some pics of little Charlie at
> http://www.flickr.com/photos/83388211@N00/sets/
>
> * * * Addresss * * *
> 1914 Overland Drive
> Chapel Hill
> NC 27517
>
> * * * Number * * *
> 919-225-1553
>
>
>
>
> --
> Best Regards
> Kelvin Goodson
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: tuscany-dev-unsubscribe@ws.apache.org
> For additional commands, e-mail: tuscany-dev-help@ws.apache.org
>
>
>
--
* * * Charlie * * *
Check out some pics of little Charlie at
http://www.flickr.com/photos/83388211@N00/sets/
* * * Addresss * * *
1914 Overland Drive
Chapel Hill
NC 27517
* * * Number * * *
919-225-1553
Re: SDO Samples
Posted by kelvin goodson <ke...@gmail.com>.
Robbie and I discussed on the 'phone my comments so far on the samples in
the attached spreadsheet. I'm pasting the contents below for generality
too. (I'm hoping that these will paste back into the bookmarks view of your
eclipse environment Robbie.)
A couple of points that we thought might be worth picking out are
1) how best in general to ensure that the user has a good experience with
regards to class path and resource finding issues when first running these
samples. Currently Robbies top level program has source code comments on
how to ensure the class path is right, but its not only jars that need to
be on the class path, but resources such as the xml and xsd files. I had
to fix up my environment before I could get it running. I guess we should
be catering for the lowest common denominator here, and assuming only a
shell/command window + a jvm. Any thoughts on packaging of these samples
would be welcome?
2) Robbie's sample has a top level manager which will step by step execute
all the samples. Many editors and SDKs will interpret strings of a certain
format as links into the code (e.g. when an exception prints to the console
you can often click on a line in the exception and jump to the text in the
code). I suggested printing such a link from the main() methods of each
sample program, to allow the user when stepping through the sequence of
programs to jump to the code of the sample they are running, e.g.
private static void defineCompanyTypes() throws Exception {
System.out.println("Defining Types using XSD");
System.out.println("
org.apache.tuscany.samples.sdo.otherSources.CreateCompany.defineCompanyTypes
(CreateCompany.java:60)");
.....
any comments?
Description Resource Path Location SAMPLES: fragile, requires careful
set up, does this work on the command line
CreateDataObjectFromXsdAndXmlFiles.java
sample-sdo/src/main/java/org/apache/tuscany/samples/sdo/specCodeSnippets line
67 SAMPLES ;-) ExecuteSamples.java
samples-20060808/src/main/java/org/apache/tuscany/samples/sdo line 52 SAMPLES:
are these relative links fragile, is there any robust way to ensure these
work across environments SdoSampleConstants.java
samples-20060808/src/main/java/org/apache/tuscany/samples/sdo line 30 SAMPLES:
including ... ExecuteSamples.java
samples-20060808/src/main/java/org/apache/tuscany/samples/sdo line 61 SAMPLES:
maintenance issue -- point to web doc for instructions? ExecuteSamples.java
samples-20060808/src/main/java/org/apache/tuscany/samples/sdo line 35 SAMPLES:
sp (is pp in snipets uk english?) + others ExecuteSamples.java
samples-20060808/src/main/java/org/apache/tuscany/samples/sdo line 59
SAMPLES: i don't understand your comment. Is there a bug?
CreateCompany.java
samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
161 SAMPLES: seems odd for a sample to have main at the bottom
CreateCompany.java
samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
98 SAMPLES: would be nice to have some confirmation that the file was
saved at the location PurchaseOrderCmdLine.java
samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
63 SAMPLES: * @see COMPANY_GENERATED_XML ??? CreateCompany.java
samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
42 SAMPLES: <CR> causes exception, null input or other error input should
be == "1" (with bad input message?) PurchaseOrderCmdLine.java
samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
120 SAMPLES: should the @link do something here? CreatePurchaseOrder.java
samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
52 SAMPLES: sp CreateCompany.java
samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
40 SAMPLES: SP PurchaseOrderCmdLine.java
samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
324 SAMPLES: SP ReadPurchaseOrder.java
samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
50 SAMPLES: suggest including interpretable link CreateCompany.java
samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
60 SAMPLES: what is the source of this sample? can we ref it?
CreateCompany.java
samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/otherSources line
18 SAMPLES: I think rjm is filling out this test case --- check
AccessDataObjectUsingValidXPath.java
samples-20060808/src/main/java/org/apache/tuscany/samples/sdo/specCodeSnippets
line
62
On 08/08/06, Robbie Minshall <my...@gmail.com> wrote:
>
> Hi.
>
> I made an update ( updated overview for javadoc ) for the SDO Samples.
> There are still a few toDo's here that I am going to work on when I find
> some time tomorrow ( namely a better xpath sample ) but things are getting
>
> there. Could a commiter ( or anyone else interested) have a look at
> these
> and provide me with some feedback on what they would like improved or
> adjusted prior to commiting these.
>
> I uploaded a zip of the project at :
> http://wiki.apache.org/ws-data/attachments/Tuscany(2f)TuscanyJava/attachments/SDO%20Samples%202006%2008%2008
>
> <http://wiki.apache.org/ws-data/attachments/Tuscany%282f%29TuscanyJava/attachments/SDO%20Samples%202006%2008%2008>
> <tu...@ws.apache.org>
>
> thanks very much,
> Robbie
>
>
>
> --
> * * * Charlie * * *
> Check out some pics of little Charlie at
> http://www.flickr.com/photos/83388211@N00/sets/
>
> * * * Addresss * * *
> 1914 Overland Drive
> Chapel Hill
> NC 27517
>
> * * * Number * * *
> 919-225-1553
>
>
--
Best Regards
Kelvin Goodson
Re: SDO Samples
Posted by Robbie Minshall <my...@gmail.com>.
Yes sounds good. Thanks for the catch,
Robbie
On 8/9/06, haleh mahbod <hm...@gmail.com> wrote:
>
> Hi Robbie,
>
> Can you please change the link for the SDO spec to point to
> www.osoa.orginstead of what is there in the readme?
>
> Thanks,
> Haleh
>
>
> On 8/8/06, Robbie Minshall <my...@gmail.com> wrote:
> >
> > Hi.
> >
> > I made an update ( updated overview for javadoc ) for the SDO Samples.
> > There are still a few toDo's here that I am going to work on when I find
> > some time tomorrow ( namely a better xpath sample ) but things are
> getting
> > there. Could a commiter ( or anyone else interested) have a look at
> > these
> > and provide me with some feedback on what they would like improved or
> > adjusted prior to commiting these.
> >
> > I uploaded a zip of the project at :
> >
> >
> http://wiki.apache.org/ws-data/attachments/Tuscany(2f)TuscanyJava/attachments/SDO%20Samples%202006%2008%2008
> > <tu...@ws.apache.org>
> >
> > thanks very much,
> > Robbie
> >
> >
> >
> > --
> > * * * Charlie * * *
> > Check out some pics of little Charlie at
> > http://www.flickr.com/photos/83388211@N00/sets/
> >
> > * * * Addresss * * *
> > 1914 Overland Drive
> > Chapel Hill
> > NC 27517
> >
> > * * * Number * * *
> > 919-225-1553
> >
> >
>
>
--
* * * Charlie * * *
Check out some pics of little Charlie at
http://www.flickr.com/photos/83388211@N00/sets/
* * * Addresss * * *
1914 Overland Drive
Chapel Hill
NC 27517
* * * Number * * *
919-225-1553
Re: SDO Samples
Posted by haleh mahbod <hm...@gmail.com>.
Hi Robbie,
Can you please change the link for the SDO spec to point to
www.osoa.orginstead of what is there in the readme?
Thanks,
Haleh
On 8/8/06, Robbie Minshall <my...@gmail.com> wrote:
>
> Hi.
>
> I made an update ( updated overview for javadoc ) for the SDO Samples.
> There are still a few toDo's here that I am going to work on when I find
> some time tomorrow ( namely a better xpath sample ) but things are getting
> there. Could a commiter ( or anyone else interested) have a look at
> these
> and provide me with some feedback on what they would like improved or
> adjusted prior to commiting these.
>
> I uploaded a zip of the project at :
>
> http://wiki.apache.org/ws-data/attachments/Tuscany(2f)TuscanyJava/attachments/SDO%20Samples%202006%2008%2008
> <tu...@ws.apache.org>
>
> thanks very much,
> Robbie
>
>
>
> --
> * * * Charlie * * *
> Check out some pics of little Charlie at
> http://www.flickr.com/photos/83388211@N00/sets/
>
> * * * Addresss * * *
> 1914 Overland Drive
> Chapel Hill
> NC 27517
>
> * * * Number * * *
> 919-225-1553
>
>