[Hibernate-devel] JCS integration

2002-07-25 Thread Gavin_King/Cirrus%CIRRUS
Christian Meunier got me started with some code to integrate Apache
Tubine's JCS today. I ended up rewriting much of the Cache package and
making some big improvements. Anyway, you may now specify a JCS cache in
the mapping file using

  

or

  

You must then configure the cache in the resource /cache.ccf

I will deprecate the old homegrown cache soon.

JCS supports things like in-memory LRU caching, disk-caching, distributed
caching, etc but be careful of using a distributed cache with usage
="read-write". That probably wont work.

All in CVS



---
This sf.net email is sponsored by: Jabber - The world's fastest growing 
real-time communications platform! Don't just IM. Build it in! 
http://www.jabber.com/osdn/xim
___
Hibernate-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/hibernate-devel



Re: [Hibernate-devel] Documentation in DocBook

2002-07-25 Thread Gavin_King/Cirrus%CIRRUS

>>- Move chapters and sections around for a more consistent read

>Done. I hope this is an improvement.

I need more time to think some of the reordering through  the
previous order was designed to get people started as quick as
possible ... topics went from "basic" to "advanced". The new
ordering is much more by subject which makes it more readable
for most users but perhaps harder for brand new users just
getting started. Anyway, I will put some thought into this and
perhaps suggest some further changes.

>I still have some ideas left and
>like to rewrite some chapters (especially the transaction and
>association handling, which seems most confusing for hibernate
>beginners, including myself).

Yeah, spot on.

collections:
Many users seem to have trouble the first time they map an
association. But only ever that first time. That definately
points to problems in the doco.

transactions:
Just recently I've noticed lots of people with problems arising
from forgetting to flush the session when not using the
Transaction API. Also people are uncomfortable calling
Transaction.commit(), Transaction.rollback() when using
container managed transactions. It needs to be clearer that
this doesn't actually call UserTransaction.commit(),
UserTransaction.rollback().

>>- Convert graphics to vector and make a small styleguide for this

>Done. We are using OpenOffice Draw, because it's the only cross
>platform vector drawing tool. Try it, it's not that bad if you know
>how to use it.

cool. unfortunately I'm having trouble checking this stuff out of CVS.
Are you sure you checked in all the binary files with -kb?

>>- Prepare stylesheets for HTML version

>Modified stylesheets. Sorry, I didn't use the hibernate css (blue
>background), because the images are not transparent and I don't have
>time to fix this. It doesn't lock that bad either and could be easily
>changed later.

Its beautiful. The only problem with presentation at the moment is I
think subsection headings are too large. I might be able to fix this
just by fiddling the css. I'll have a look later.

>>- Write makefiles and documentation for automatic output generation

>Still pending because I haven't decided for make or Ant.

I would very much prefer Ant if its at all possible. I've finally
started using the ant build script to generate javadoc, etc, So
it would be really nice to integrate this stuff with the existing
stuff. My dream is to eventually be able to do a whole release
with just a single Ant task but I'm not there yet ;)

>>- Checkin to CVS

>Done, with a lot of cursing about CVS over ssh. I cannot use any
>graphical client with Unix... any solution for this problem?

In my experience the graphical clients are really not worth
the effort. I just use the cmd-line client under win2k, even
though I _could_ use winCVS.

>So, if everyone agrees that the new documentation can replace the old
>"Programming Guide", the following steps would be neccessary:

yes, I would like to do this stuff for 1.0.2 if possible, since I want
to document the new 1.0.2 features in docbook. Could you tell me
exactly how up to date the docbook text is compared to the aft text? I
did make a couple of minor changes this week and I might need to copy
them over.

>Thats it. Hm, the "Toolset Guide" could be integrated as a separate
>chapter?

yep. And we should probably move the documentation of Dialects
somewhere else, since they are no longer used only by the schema
generator, as was originally the case.

>The website itself could do with little reorg, too. I think the
>whole Q&A and feature list is really one big block itself.

The website could do with many improvements actually.

Thanks for all this Christian, its awesome.



---
This sf.net email is sponsored by: Jabber - The world's fastest growing 
real-time communications platform! Don't just IM. Build it in! 
http://www.jabber.com/osdn/xim
___
Hibernate-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/hibernate-devel



RE: [Hibernate-devel] JCS integration

2002-07-25 Thread Urberg, John
Is a JCS cache serializable?  If so, how much more would it take to pass the
whole session over the wire?

Thanks,
John

-Original Message-
From: Gavin_King/[EMAIL PROTECTED]
[mailto:Gavin_King/[EMAIL PROTECTED]
Sent: Thursday, July 25, 2002 10:09 AM
To: [EMAIL PROTECTED]
Cc: [EMAIL PROTECTED]
Subject: [Hibernate-devel] JCS integration


Christian Meunier got me started with some code to integrate Apache
Tubine's JCS today. I ended up rewriting much of the Cache package and
making some big improvements. Anyway, you may now specify a JCS cache in
the mapping file using

  

or

  

You must then configure the cache in the resource /cache.ccf

I will deprecate the old homegrown cache soon.

JCS supports things like in-memory LRU caching, disk-caching, distributed
caching, etc but be careful of using a distributed cache with usage
="read-write". That probably wont work.

All in CVS



---
This sf.net email is sponsored by: Jabber - The world's fastest growing 
real-time communications platform! Don't just IM. Build it in! 
http://www.jabber.com/osdn/xim
___
Hibernate-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/hibernate-devel


---
This sf.net email is sponsored by: Jabber - The world's fastest growing 
real-time communications platform! Don't just IM. Build it in! 
http://www.jabber.com/osdn/xim
___
Hibernate-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/hibernate-devel



[Hibernate-devel] Re: JCS integration

2002-07-25 Thread Christian Meunier
You rock ;)

There is something that could be considered as a future upgrade.
Atm each persistent class will have its own region cache, it might be
usefull to be able to put more than one persistent class in a region cache.

We could specify the following in the cache interface:

public void setClass(String  regionName) throws CacheException;

then if the user use the optional argument 'region' in the :



then in the RootClass.java, if we find the region attribute, call :

jcs.setClass( regionName);

instead of

jcs.setClass( getPersistentClass() );


- Original Message -
From: 
To: <[EMAIL PROTECTED]>
Cc: <[EMAIL PROTECTED]>
Sent: Thursday, July 25, 2002 5:09 PM
Subject: JCS integration


> Christian Meunier got me started with some code to integrate Apache
> Tubine's JCS today. I ended up rewriting much of the Cache package and
> making some big improvements. Anyway, you may now specify a JCS cache in
> the mapping file using
>
>   
>
> or
>
>   
>
> You must then configure the cache in the resource /cache.ccf
>
> I will deprecate the old homegrown cache soon.
>
> JCS supports things like in-memory LRU caching, disk-caching, distributed
> caching, etc but be careful of using a distributed cache with usage
> ="read-write". That probably wont work.
>
> All in CVS
>
>




---
This sf.net email is sponsored by: Jabber - The world's fastest growing 
real-time communications platform! Don't just IM. Build it in! 
http://www.jabber.com/osdn/xim
___
Hibernate-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/hibernate-devel



Re: [Hibernate-devel] Documentation in DocBook

2002-07-25 Thread Gavin_King/Cirrus%CIRRUS


>> 3. I think the persistent-classes and basic-or-mapping sections should
come
>> before the session-configuration section. Otherwise the order seems
good.

>Hm. My first approach would be to read the "how to get it up and
>running; aka configuration" and after that I will look into how to do
>basic things. That was my approach when getting in contact with
>hibernate and I jumped alot around the documentation to get a basic
>"configuration, load, manipulate, store"-cycle going. I think it's
>better that way (further down my todo-list is a rewrite and cleanup of the
>configuration section).

Okay, I hadn't realized that you were planning a quickstart guide. That
changes things But could we temporarily move those sections earlier,
then move them back to where they are now when the quickstart guide is
complete? I just liked having the stuff about persistent classes right
slap bang upfront so everyone sees how they don't have to do anything
special.

more in a sec




---
This sf.net email is sponsored by: Jabber - The world's fastest growing 
real-time communications platform! Don't just IM. Build it in! 
http://www.jabber.com/osdn/xim
___
Hibernate-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/hibernate-devel



Re: [Hibernate-devel] Documentation in DocBook

2002-07-25 Thread Christian Bauer
On 25 Jul (11:53), Gavin_King/[EMAIL PROTECTED] wrote:

> I need more time to think some of the reordering through  the
> previous order was designed to get people started as quick as
> possible ... topics went from "basic" to "advanced". The new
> ordering is much more by subject which makes it more readable
> for most users but perhaps harder for brand new users just
> getting started. Anyway, I will put some thought into this and
> perhaps suggest some further changes.

My initial intention was to provide a complete reference documentation
for all features. One of the next steps would be to provide "Quickstart"
documentation for different scenarios. But I don't think this should be
_in_ the reference documentation.

> cool. unfortunately I'm having trouble checking this stuff out of CVS.
> Are you sure you checked in all the binary files with -kb?

Gah, used -ko, my fault. I think this can be fixed with a cvs admin -kb
command?

> I would very much prefer Ant if its at all possible. I've finally
> started using the ant build script to generate javadoc, etc, So
> it would be really nice to integrate this stuff with the existing
> stuff. My dream is to eventually be able to do a whole release
> with just a single Ant task but I'm not there yet ;)

OK, I will try Ant.

> yes, I would like to do this stuff for 1.0.2 if possible, since I want
> to document the new 1.0.2 features in docbook. Could you tell me
> exactly how up to date the docbook text is compared to the aft text? I
> did make a couple of minor changes this week and I might need to copy
> them over.

You will need to add your changes, the converted version is more than a
week old.

P.S. I'm subscribed to the devloper list, no need to Cc. :)

-- 
Christian Bauer
[EMAIL PROTECTED]


---
This sf.net email is sponsored by: Jabber - The world's fastest growing 
real-time communications platform! Don't just IM. Build it in! 
http://www.jabber.com/osdn/xim
___
Hibernate-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/hibernate-devel