Greg,

Here is a start to a gradle-ized version of River done 3 years ago 
http://svn.apache.org/viewvc/river/jtsk/skunk/modules/, could easily beused to 
create examples as well.

And here is the maven-ized version: 
http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/modularize/

HTH

Dennis

> On Jan 8, 2015, at 521PM, Greg Trasuk <tras...@stratuscom.com> wrote:
> 
> 
> Hi Dennis:
> 
> I’m slightly allergic to hard-and-fast conventions.  For example, the service 
> browser example really doesn’t fit those conventions.  Also, I’m reticent to 
> suggest repackaging the infrastructure services (reggie, outrigger, mahalo, 
> etc) at this time (meaning that I personally have no plans to do it). Having 
> said that, I’m basically with you.  Matter of fact if you have a look at the 
> River-Container examples over at 
> https://github.com/trasukg/river-container-examples you’ll see that’s pretty 
> much the same style.  The minor difference is that I’ve used ‘hello-impl’ 
> rather than ‘hello-service’, and there’s also a ‘hello-module’ that is the 
> packaged artifact for the container.
> 
> I believe the critical thing is to make sure that the client api is separate, 
> so that the client doesn’t accidentally know anything about the 
> implementation.  All else is implementation details, though I agree that we 
> should provide a good example.
> 
> As far as Maven/Gradle, it happens that I know Maven and not Gradle.  All I 
> am trying to do is provide some easier example than just diving into the JTSK 
> source.  If someone were to contribute a Gradle-based example, that’s 
> all-the-better for user choice.  But I don’t think we should go around 
> telling people what build tool to use.
> 
> Cheers,
> 
> Greg Trasuk
> 
> 
> On Jan 8, 2015, at 4:05 PM, Dennis Reedy <dennis.re...@gmail.com> wrote:
> 
>> Hi Greg,
>> 
>> I'd like to suggest that River follow the conventions that align with whats 
>> recommended over in Rio (http://www.rio-project.org/conventions.html). This 
>> has been pretty successful using both Maven and Gradle (at this time I would 
>> go with Gradle btw).
>> 
>> HTH
>> 
>> Regards
>> 
>> Dennis
>> 
>>> On Jan 5, 2015, at 1016PM, Greg Trasuk <tras...@stratuscom.com> wrote:
>>> 
>>> 
>>> I started working on making new demos and “getting started” stuff back 
>>> before the holidays.  Here’s my thinking…
>>> 
>>> As Patricia alludes to, it really shouldn’t be necessary to build the River 
>>> distribution in order to try out some samples and get started.  After all, 
>>> the artifacts are published on Maven Central, so they can simply be 
>>> referenced in a Maven build (or Gradle, Ivy, Etc).
>>> 
>>> Towards that end, I started building a new Mavenized ‘examples’ project, 
>>> which can be checked-out from 
>>> https://svn.apache.org/repos/asf/river/river-examples/river-examples/trunk.
>>> 
>>> In that project, there are currently modules for the service browser jars 
>>> and a ‘home’ folder for the compiled and packaged examples. (might be best 
>>> to download it and do a ‘mvn install site’).  There’s also documentation 
>>> for the examples under the main project (look at  
>>> <project-home>/target/site/index.html - this should be familiar to Maven 
>>> users).  The documentation currently includes how to build and run the 
>>> service browser (although I think right now it’s incomplete on how the 
>>> configuration works - haven’t looked at it since Dec 15).
>>> 
>>> Right now, the project has a dependency on the new ‘river-rt-tools’ modules 
>>> that I talked about back in December as well.  So in order to run the 
>>> examples, you currently need to checkout 
>>> 'https://svn.apache.org/repos/asf/river/river-rt-tools/trunk' and do a ‘mvn 
>>> install’ on it, which will install the runtime tool artifacts (start.jar) 
>>> in your local Maven cache.  In the end, those artifacts would also be 
>>> released and published on Maven Central, so you eventually wouldn’t need to 
>>> build the runtime tools separately.
>>> 
>>> My plan is to add modules to the river-examples project for a 
>>> 'hello-service’ and ‘hello-client’, as well as a config for the 
>>> infrastructure services (Reggie, etc).  So eventually, the “getting 
>>> started” instructions become “have a look at ‘river-examples’”, and we’d 
>>> remove the (very confusing, if you ask me) ‘examples’ folder from the JTSK 
>>> distribution.  As a bonus, we can isolate new users from the convoluted 
>>> build system in River.
>>> 
>>> If this seems like a reasonable path forward for our “getting started” 
>>> experience, perhaps you’d like to work on bringing over some of the 
>>> examples from the JTSK to the ‘river-examples’ project. That’s probably 
>>> also a good way to re-familiarize yourself with Jini.  I probably won’t 
>>> have any cycles to work on it seriously for the next couple weeks, but 
>>> could cheerfully make suggestions.
>>> 
>>> You should be able to check-out these two Maven project in the IDE of your 
>>> choice.  I was using NetBeans, but AFAIK, Eclipse should be able to use the 
>>> Maven build directly.  I just haven’t tried it.
>>> 
>>> Cheers,
>>> 
>>> Greg Trasuk.
>>> 
>>> On Jan 5, 2015, at 6:07 PM, Patricia Shanahan <p...@acm.org> wrote:
>>> 
>>>> I have completed buying a new home, moving into it, and selling the old 
>>>> one, followed by Christmas in England and recovery from the cold I caught 
>>>> there. That means I'm ready to get much more active in River.
>>>> 
>>>> Last year, we got some feedback suggesting that better support for new 
>>>> users might remove a barrier to community building. My main agenda is 
>>>> community building, so I want to work on that. I am going to be a very 
>>>> naive potential user, so stand by for basic questions.
>>>> 
>>>> I began by downloading the binary version, since in this mode I am not 
>>>> interested in being a River developer. However, when I looked at the 
>>>> "Getting Started" page, 
>>>> river.apache.org/user-guide-basic-river-services.html, it says:
>>>> 
>>>> "The instructions assume that you're building from source as checked out 
>>>> from the SVN trunk. Currently this is necessary because the code snippets 
>>>> below use methods and classes which, at time of writing, haven't made it 
>>>> into the latest binary release yet. Having said that, the code you will 
>>>> need in the binary release isn't to far removed from what you'll see 
>>>> below, so you can progress with the binary release if you want to and are 
>>>> happy odifying the code."
>>>> 
>>>> According to the page info, the "time of writing" was no later than 
>>>> November 23, 2013. Do I still need to do a River build before I can run 
>>>> the example? If so, why and what can I do to fix that?
>>>> 
>>>> I have no idea whether or not I would be happy "odifying" code - maybe 
>>>> "modifying"?
>>>> 
>>>> What is the best procedure for editing the "Getting Started" page? I want 
>>>> to make sure that any changes I make really are improvements, so I would 
>>>> like PMC review as I go along.
>>>> 
>>>> Patricia
>>>> 
>>>> 
>>> 
>> 
> 

Reply via email to