You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@river.apache.org by Peter Firmstone <ji...@zeus.net.au> on 2010/09/03 03:46:25 UTC

Re: River Confluence

I think Dan's raised some very valid points, can we all have another 
look & comment?

Dan Rollo wrote:
> Dumb questions alert:
>
> Could we add a link pointing to the documentation that talks about the 
> "minimum" jars are needed on the classpath to do lookup and register a 
> service?
>
> I must admit confusion about which jars are needed from River itself 
> (and I can not blame it on the old vs new packaging).;)
>
> The User Service naming guidelines recently proposed include an "api" 
> jar. Is it true that River itself does NOT provide an "api" jar for 
> all the included services? (Or are all the included service api's 
> bundled into one platform.jar....?)
>
> I think I understand the recommendation for user created services 
> regarding packaging/jar naming and content, but if River itself 
> follows different packaging, could we add a link to the details? (Or 
> should it be changed to follow the "user" convention?)
>
> This also spirals quickly into FAQ's like:
> Do I EVER need to add any River supplied jar into JRE ext? (I hope the 
> current answer is no).
>
> Should *-dl.jar EVER be on my compile classpath. (I think the answer 
> is NO, but in some cases, I couldn't seem to find an 'api' class in a 
> standalone River jar...).
>
> I've been half expecting the discussed regarding maven pom.xml's would 
> clarify some of this (eg: such pom's would make it clear that x.jar 
> required y.jar...). If nothing else, clarifying some of the above 
> questions might also help in filling out the pom's (at least for 
> publishing, if not building River jars).
>
> If all the above is in an RTFM link, please point me there with all 
> due shame. ;) Still might be worth some FAQ's with links though...
>
> Thanks!
> Dan
>
>
> On 08/26/2010 08:32 AM, Peter Firmstone wrote:
>> All this is very positive & good to see,
>>
>> Peter.
>>
>> Sim IJskes - QCG wrote:
>>> On 08/26/2010 01:55 PM, Sim IJskes - QCG wrote:
>>>> On 08/26/2010 01:50 PM, Tom Hobbs wrote:
>>>>> When I've got a bit more content together I'll put it in 
>>>>> confluence and
>>>>> start adding to it.
>>>>>
>>>>> It's unlikely to be talking about SocketFactories and so on, though.
>>>>> It's
>>>>> literally, assuming no knowledge, "How do I write a 'hello world'
>>>>> service,
>>>>> start it and use it" tutorial.
>>>>
>>>> We could model it like:
>>>>
>>>> http://hc.apache.org/httpclient-3.x/tutorial.html
>>>>
>>>> And include a section 'SocketFactories', or 'Endpoints'.
>>>>
>>>> Gr. Sim
>>>
>>> I meant, the 'User Guide' part of that site.
>>>
>>> http://hc.apache.org/httpclient-3.x/userguide.html
>>>
>>> Gr. Sim
>>>
>>>
>>
>
>