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 Guidefor Use with JBoss Enterprise Application Platform 5.0
2.01
@@ -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==--