From jbosscache-commits at lists.jboss.org Tue Aug 25 21:29:39 2009 Content-Type: multipart/mixed; boundary="===============3576005573589711464==" MIME-Version: 1.0 From: jbosscache-commits at lists.jboss.org To: jbosscache-commits at lists.jboss.org Subject: [jbosscache-commits] JBoss Cache SVN: r8203 - enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US. Date: Tue, 25 Aug 2009 21:29:39 -0400 Message-ID: <200908260129.n7Q1Tdj7005503@svn01.web.mwc.hst.phx2.redhat.com> --===============3576005573589711464== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: irooskov(a)redhat.com Date: 2009-08-25 21:29:39 -0400 (Tue, 25 Aug 2009) New Revision: 8203 Removed: enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/master.xml Modified: enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/Author_Group= .xml enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/Book_Info.xml enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/deployment.x= ml enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/eviction_pol= icies.xml enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/introduction= .xml enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/replication.= xml enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/transactions= .xml Log: updated book for build Modified: enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/Autho= r_Group.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/Author_Grou= p.xml 2009-08-26 00:45:20 UTC (rev 8202) +++ enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/Author_Grou= p.xml 2009-08-26 01:29:39 UTC (rev 8203) @@ -3,6 +3,28 @@ ]> = - Manik Surtani, Galder Zamarre=C3=B1o = + + Manik + Surtani + manik AT jboss DOT org + + + + Brian + Stansberry + brian DOT stansberry AT jboss DOT com + + + + Galder + Zamarre=C3=B1o + galder DOT zamarreno AT jboss DOT com + + + + Mircea + Markus + mircea DOT markus AT jboss DOT com + = Modified: enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/Book_= Info.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/Book_Info.x= ml 2009-08-26 00:45:20 UTC (rev 8202) +++ enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/Book_Info.x= ml 2009-08-26 01:29:39 UTC (rev 8203) @@ -2,7 +2,7 @@ = - JBoss Cache Tutorial + JBoss Cache User Guide for Use with JBoss Enterprise Application Platform 5.0 2.0 1 @@ -10,7 +10,7 @@ 5.0 - This book is a TreeCache and JBossCache Tutorial. + This book is the User Guide for Cache of the JBoss Enterprise Applicati= on Platform. N/A Modified: enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/deplo= yment.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/deployment.= xml 2009-08-26 00:45:20 UTC (rev 8202) +++ enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/deployment.= xml 2009-08-26 01:29:39 UTC (rev 8203) @@ -9,9 +9,9 @@ Configuration instance or an XML file, as discussed in the - User API + and - Configuration + chapters. = @@ -32,7 +32,7 @@ If, after deploying your cache you wish to expose a management in= terface to it in JMX, see the - section on Program= atic Registration in JMX. + .
@@ -142,10 +142,10 @@ bean element represents an object and is used to create a Configuration - and its constituent part= s + and its The DefaultCacheFactory bean constructs the ca= che, = conceptually doing the same thing as is shown in the = - User API chapter. + chapter. An interesting thing to note in the above example is the use of t= he @@ -338,7 +338,7 @@ ]]> = - As discussed in the Programatic Registration + As discussed in the section, CacheJmxWrapper can do the work= of building, creating and starting the Cache if it is provided with a = Configuration. With the microcontainer, this is the preferred approach, as it saves= the boilerplate XML @@ -406,7 +406,7 @@ . Management tools can then access those MBeans to examine the s= tatistics. See the section in the - JMX Reference chapt= er + pertaining to the statistics that are made available via JMX.
@@ -415,14 +415,14 @@ Receiving JMX Notifications JBoss Cache users can register a listener to receive cache eve= nts described earlier in the - User API + chapter. Users can alternatively utilize the cache's managemen= t information infrastructure to receive these events via JMX notifications. Cache events are accessible as n= otifications by registering a NotificationListener for the Cache= JmxWrapper. = - See the section in the JMX Reference chapter + See the section in the pertaining to JMX notifications for a list of notifications th= at can be received through the CacheJmxWrapper. Modified: enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/evict= ion_policies.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/eviction_po= licies.xml 2009-08-26 00:45:20 UTC (rev 8202) +++ enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/eviction_po= licies.xml 2009-08-26 01:29:39 UTC (rev 8203) @@ -4,7 +4,7 @@ Eviction controls JBoss Cache's memory management by restricting how= many nodes are allowed to be stored in memory, and for how long. Memory constraints on servers mean caches = cannot grow indefinitely, so eviction - needs to occur to prevent out of memory errors. Eviction is most oft= en used alongside cache loaders. + needs to occur to prevent out of memory errors. Eviction is most oft= en used alongside . =
@@ -91,7 +91,7 @@ Eviction Regions The concept of regions and the Region class= were - visited earlier = when talking about marshalling. Regions are also + when talking about m= arshalling. Regions are also used to define the eviction behavior for nodes within that reg= ion. In addition to using a region-specific configuration, you can also configure default, cache-wide evic= tion behavior for nodes that do not fall into predefined regions or if you do not wish to define specific re= gions. It is important to note that when @@ -220,7 +220,7 @@ org.jboss.cache.config.EvictionConfig bean, which is passed into Configuration.setEvictionConfig(). See the - chapter on Configuration + for more on building a Configuration programatically. Modified: enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/intro= duction.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/introductio= n.xml 2009-08-26 00:45:20 UTC (rev 8202) +++ enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/introductio= n.xml 2009-08-26 01:29:39 UTC (rev 8203) @@ -138,7 +138,7 @@ The JBoss Cache MVCC implementation only supports READ_COMMITT= ED and REPEATABLE_READ isolation levels, corresponding - to their database equivalents. See the section on transactions and concurrency for details on MVCC. + to their database equivalents. See the section on for details on MVCC.
Deleted: enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/master= .xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/master.xml = 2009-08-26 00:45:20 UTC (rev 8202) +++ enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/master.xml = 2009-08-26 01:29:39 UTC (rev 8203) @@ -1,114 +0,0 @@ - - - - - - - - - - - - - - - - ]> - - - JBoss Cache Users' Guide - A clustered, transactional cache - - - Release 3.1.0 Cascabel - April 2009 - - - - Manik - Surtani - manik AT jboss DOT org - - - - Brian - Stansberry - brian DOT stansberry AT jboss DOT com - - - - Galder - Zamarre=C3=B1o - galder DOT zamarreno AT jboss DOT com - - - - Mircea - Markus - mircea DOT markus AT jboss DOT com - - - - - 2004 - 2005 - 2006 - 2007 - 2008 - 2009 - JBoss, a division of Red Hat Inc., and all authors as nam= ed. - - - - - - - - &preface; - - - Introduction to JBoss Cache - - - This section covers what developers would need to quickly star= t using JBoss Cache in their projects. It - covers an overview of the concepts and API, configuration and = deployment information. - - - &introduction; - &basic_api; - &configuration; - &batching; - &deployment; - &compatibility; - - - - JBoss Cache Architecture - - - This section digs deeper into the JBoss Cache architecture, an= d is meant for developers wishing to use the more - advanced cache features,extend or enhance the cache, write plu= gins, or are just looking for detailed knowledge - of how things work under the hood. - - - &architecture; - &replication; - &cache_loaders; - &eviction_policies; - &transactions; - - - - JBoss Cache Configuration References - - - This section contains technical references for easy looking up. - - - - &configuration_reference; - &jmx_reference; - - \ No newline at end of file Modified: enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/repli= cation.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/replication= .xml 2009-08-26 00:45:20 UTC (rev 8202) +++ enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/replication= .xml 2009-08-26 01:29:39 UTC (rev 8203) @@ -358,7 +358,7 @@
Configuration = - See the c= onfiguration reference section for details on configuring buddy repl= ication. + See the for details on configuring buddy replication.
@@ -371,7 +371,7 @@ every time data is changed in a cache other caches in the cluster= receive a message informing them that their data is now stale and should = be evicted from memory. Invalidation, when used with a shared cache = loader - (see chapter on cache loaders) would cause remote caches to refer to the + (see chapter on ) would cause r= emote caches to refer to the shared cache loader to retrieve modified data. The benefit of thi= s is twofold: network traffic is minimized as invalidation messages ar= e very small compared to replicating updated data, and also that other c= aches in Modified: enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/trans= actions.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/transaction= s.xml 2009-08-26 00:45:20 UTC (rev 8202) +++ enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_User_Guide/en-US/transaction= s.xml 2009-08-26 01:29:39 UTC (rev 8203) @@ -54,7 +54,7 @@ Writer threads, on the other hand, need to acquire a lock b= efore any writing can commence. Currently, we use lock striping to improve the memory performance of t= he cache, and the size of the shared lock pool can be tuned using the concurrencyLevel = attribute of the locking - element. See the configuration reference + element. See the for details. After acquiring an exclusive lock on an Fqn, = the writer thread then wraps the state to be modified in a container as well, just like with reader thre= ads, and then copies this state for writing. When copying, a reference to the original version is still = maintained in the container (for rollbacks). @@ -69,7 +69,7 @@ If a writer is unable to acquire the write lock after some = time, a TimeoutException is thrown. This lock acquisition timeout defaults to 10000 mi= llis and can be configured using the lockAcquisitionTimeout attribute of the = locking element. See the = - configura= tion reference for details. + for de= tails.
Isolation Levels @@ -107,7 +107,7 @@ be an issue (for example, if the state written has no re= lationship to the state originally read) and should be allowed. If your application does not care ab= out write skews, you can allow them to happen by setting the writeSkewCheck configu= ration attribute to false. - See the configuration reference for details. + See the for details. Note that write skews cannot happen when using READ_COMM= ITTED since threads always work off committed @@ -147,7 +147,7 @@ Pessimistic and Optimistic Locking Schemes From JBoss Cache 3.x onwards, pessimistic and optimistic locki= ng schemes are deprecated in favor of - MVCC. It is = recommended that existing applications + . It is recommend= ed that existing applications move off these legacy locking schemes as support for them will= eventually be dropped altogether in future releases. @@ -227,7 +227,7 @@ = When the transaction commits, we initiate either a one- two-ph= ase commit - protocol. See replicated caches = and transactions for details. + protocol. See for details. =
--===============3576005573589711464==--