JBoss Cache SVN: r5495 - core/trunk.
by jbosscache-commits@lists.jboss.org
Author: bstansberry(a)jboss.com
Date: 2008-04-02 16:02:31 -0400 (Wed, 02 Apr 2008)
New Revision: 5495
Modified:
core/trunk/pom.xml
Log:
Update the JBossAS profile dependencies
Modified: core/trunk/pom.xml
===================================================================
--- core/trunk/pom.xml 2008-04-02 10:31:43 UTC (rev 5494)
+++ core/trunk/pom.xml 2008-04-02 20:02:31 UTC (rev 5495)
@@ -359,7 +359,7 @@
<activeByDefault>false</activeByDefault>
</activation>
<properties>
- <jbosscache-core-version>2.1.0-SNAPSHOT-JBossAS</jbosscache-core-version>
+ <jbosscache-core-version>2.2.0-SNAPSHOT-JBossAS</jbosscache-core-version>
</properties>
<dependencies>
<dependency>
@@ -375,7 +375,7 @@
<dependency>
<groupId>org.jboss</groupId>
<artifactId>jboss-common-core</artifactId>
- <version>2.2.3.GA</version>
+ <version>2.2.4.GA</version>
</dependency>
<dependency>
<groupId>commons-logging</groupId>
@@ -385,7 +385,7 @@
<dependency>
<groupId>org.jboss.transaction</groupId>
<artifactId>jboss-jta</artifactId>
- <version>4.3.0.BETA2</version>
+ <version>4.3.0.GA</version>
<scope>test</scope>
</dependency>
</dependencies>
16 years, 3 months
JBoss Cache SVN: r5494 - core/branches/2.1.X/src/main/java/org/jboss/cache/interceptors.
by jbosscache-commits@lists.jboss.org
Author: manik.surtani(a)jboss.com
Date: 2008-04-02 06:31:43 -0400 (Wed, 02 Apr 2008)
New Revision: 5494
Modified:
core/branches/2.1.X/src/main/java/org/jboss/cache/interceptors/OptimisticInterceptor.java
Log:
JBCACHE-1309 - we should be getting READ locks when adding nodes to a workspace, not WRITE locks.
Modified: core/branches/2.1.X/src/main/java/org/jboss/cache/interceptors/OptimisticInterceptor.java
===================================================================
--- core/branches/2.1.X/src/main/java/org/jboss/cache/interceptors/OptimisticInterceptor.java 2008-04-02 10:30:14 UTC (rev 5493)
+++ core/branches/2.1.X/src/main/java/org/jboss/cache/interceptors/OptimisticInterceptor.java 2008-04-02 10:31:43 UTC (rev 5494)
@@ -109,7 +109,7 @@
boolean locked = false;
try
{
- locked = node.getLock().acquireWriteLock(gtx, timeout);
+ locked = node.getLock().acquireReadLock(gtx, timeout);
}
catch (InterruptedException e)
{
16 years, 3 months
JBoss Cache SVN: r5493 - core/trunk/src/main/java/org/jboss/cache/interceptors.
by jbosscache-commits@lists.jboss.org
Author: manik.surtani(a)jboss.com
Date: 2008-04-02 06:30:14 -0400 (Wed, 02 Apr 2008)
New Revision: 5493
Modified:
core/trunk/src/main/java/org/jboss/cache/interceptors/OptimisticInterceptor.java
Log:
JBCACHE-1309 - we should be getting READ locks when adding nodes to a workspace, not WRITE locks.
Modified: core/trunk/src/main/java/org/jboss/cache/interceptors/OptimisticInterceptor.java
===================================================================
--- core/trunk/src/main/java/org/jboss/cache/interceptors/OptimisticInterceptor.java 2008-04-02 10:20:24 UTC (rev 5492)
+++ core/trunk/src/main/java/org/jboss/cache/interceptors/OptimisticInterceptor.java 2008-04-02 10:30:14 UTC (rev 5493)
@@ -109,7 +109,7 @@
boolean locked = false;
try
{
- locked = node.getLock().acquireWriteLock(gtx, timeout);
+ locked = node.getLock().acquireReadLock(gtx, timeout);
}
catch (InterruptedException e)
{
16 years, 3 months
JBoss Cache SVN: r5492 - core/branches/2.1.X.
by jbosscache-commits@lists.jboss.org
Author: manik.surtani(a)jboss.com
Date: 2008-04-02 06:20:24 -0400 (Wed, 02 Apr 2008)
New Revision: 5492
Modified:
core/branches/2.1.X/README-Maven.txt
Log:
Documented integration as a valid test group
Modified: core/branches/2.1.X/README-Maven.txt
===================================================================
--- core/branches/2.1.X/README-Maven.txt 2008-04-02 10:19:08 UTC (rev 5491)
+++ core/branches/2.1.X/README-Maven.txt 2008-04-02 10:20:24 UTC (rev 5492)
@@ -116,6 +116,7 @@
* jgroups - Tests which need to send data on a JGroups Channel
* transaction - Tests which use a transaction manager
* profiling - Tests used for manual profiling, not meant for automated test runs
+* integration - Integration tests emulating usage patterns for specific products such as JBoss AS Clustering and Hibernate clustering
It should be noted that every test (except those not intended to be run by Hudson) should at least be in the functional
group, since this is the default test group that is executed by maven, and the one that is required to prepare a release.
16 years, 3 months
JBoss Cache SVN: r5491 - core/trunk.
by jbosscache-commits@lists.jboss.org
Author: manik.surtani(a)jboss.com
Date: 2008-04-02 06:19:08 -0400 (Wed, 02 Apr 2008)
New Revision: 5491
Modified:
core/trunk/README-Maven.txt
Log:
Documented "integration" as a test group
Modified: core/trunk/README-Maven.txt
===================================================================
--- core/trunk/README-Maven.txt 2008-04-02 08:29:46 UTC (rev 5490)
+++ core/trunk/README-Maven.txt 2008-04-02 10:19:08 UTC (rev 5491)
@@ -116,6 +116,7 @@
* jgroups - Tests which need to send data on a JGroups Channel
* transaction - Tests which use a transaction manager
* profiling - Tests used for manual profiling, not meant for automated test runs
+* integration - Integration tests emulating usage patterns for specific products such as JBoss AS Clustering and Hibernate clustering
It should be noted that every test (except those not intended to be run by Hudson) should at least be in the functional
group, since this is the default test group that is executed by maven, and the one that is required to prepare a release.
16 years, 3 months
JBoss Cache SVN: r5490 - core/trunk/src/test/java/org/jboss/cache/marshall.
by jbosscache-commits@lists.jboss.org
Author: manik.surtani(a)jboss.com
Date: 2008-04-02 04:29:46 -0400 (Wed, 02 Apr 2008)
New Revision: 5490
Modified:
core/trunk/src/test/java/org/jboss/cache/marshall/VersionAwareMarshallerTest.java
Log:
Updated to deal with new versioning headers
Modified: core/trunk/src/test/java/org/jboss/cache/marshall/VersionAwareMarshallerTest.java
===================================================================
--- core/trunk/src/test/java/org/jboss/cache/marshall/VersionAwareMarshallerTest.java 2008-04-02 01:32:05 UTC (rev 5489)
+++ core/trunk/src/test/java/org/jboss/cache/marshall/VersionAwareMarshallerTest.java 2008-04-02 08:29:46 UTC (rev 5490)
@@ -40,9 +40,12 @@
public void testMarshallerSelection()
{
- VersionAwareMarshaller marshaller = createVAMandRestartCache("2.1.0.GA");
+ VersionAwareMarshaller marshaller = createVAMandRestartCache("2.2.0.GA");
assertEquals(CacheMarshaller210.class, marshaller.defaultMarshaller.getClass());
+ marshaller = createVAMandRestartCache("2.1.0.GA");
+ assertEquals(CacheMarshaller210.class, marshaller.defaultMarshaller.getClass());
+
marshaller = createVAMandRestartCache("2.0.0.GA");
assertEquals(CacheMarshaller200.class, marshaller.defaultMarshaller.getClass());
@@ -75,6 +78,16 @@
byte[] bytes = marshaller.objectToByteBuffer("Hello");
ObjectStreamPool pool = (ObjectStreamPool) TestingUtil.extractField(marshaller, "pool");
ObjectInputStream in = pool.getInputStream(bytes);
+ assertEquals("Version header short should be '22'", 22, in.readShort());
+ }
+
+ public void testVersionHeader210() throws Exception
+ {
+ VersionAwareMarshaller marshaller = createVAMandRestartCache("2.1.0.GA");
+
+ byte[] bytes = marshaller.objectToByteBuffer("Hello");
+ ObjectStreamPool pool = (ObjectStreamPool) TestingUtil.extractField(marshaller, "pool");
+ ObjectInputStream in = pool.getInputStream(bytes);
assertEquals("Version header short should be '21'", 21, in.readShort());
}
@@ -87,5 +100,4 @@
ObjectInputStream in = pool.getInputStream(bytes);
assertEquals("Version header short should be '20'", 20, in.readShort());
}
-
}
16 years, 3 months
JBoss Cache SVN: r5489 - core/trunk/src/test/java/org/jboss/cache.
by jbosscache-commits@lists.jboss.org
Author: bstansberry(a)jboss.com
Date: 2008-04-01 21:32:05 -0400 (Tue, 01 Apr 2008)
New Revision: 5489
Added:
core/trunk/src/test/java/org/jboss/cache/integration/
Log:
Port Hibernate integration tests from branch 2.1.X
Copied: core/trunk/src/test/java/org/jboss/cache/integration (from rev 5488, core/branches/2.1.X/src/test/java/org/jboss/cache/integration)
16 years, 3 months
JBoss Cache SVN: r5488 - in core/branches/2.1.X/src/test/java/org/jboss/cache: integration and 1 other directories.
by jbosscache-commits@lists.jboss.org
Author: bstansberry(a)jboss.com
Date: 2008-04-01 16:42:48 -0400 (Tue, 01 Apr 2008)
New Revision: 5488
Added:
core/branches/2.1.X/src/test/java/org/jboss/cache/integration/
core/branches/2.1.X/src/test/java/org/jboss/cache/integration/hibernate/
core/branches/2.1.X/src/test/java/org/jboss/cache/integration/hibernate/HibernateIntegrationTestUtil.java
core/branches/2.1.X/src/test/java/org/jboss/cache/integration/hibernate/UpdateTimestampsCachingTest.java
Log:
Add test of Hibernate's invalidate-timestamp-in-afterCompletion() usage
Added: core/branches/2.1.X/src/test/java/org/jboss/cache/integration/hibernate/HibernateIntegrationTestUtil.java
===================================================================
--- core/branches/2.1.X/src/test/java/org/jboss/cache/integration/hibernate/HibernateIntegrationTestUtil.java (rev 0)
+++ core/branches/2.1.X/src/test/java/org/jboss/cache/integration/hibernate/HibernateIntegrationTestUtil.java 2008-04-01 20:42:48 UTC (rev 5488)
@@ -0,0 +1,46 @@
+/*
+ * JBoss, Home of Professional Open Source.
+ * Copyright 2008, Red Hat Middleware LLC, and individual contributors
+ * as indicated by the @author tags. See the copyright.txt file in the
+ * distribution for a full listing of individual contributors.
+ *
+ * This is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation; either version 2.1 of
+ * the License, or (at your option) any later version.
+ *
+ * This software is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this software; if not, write to the Free
+ * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+ * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+ */
+
+package org.jboss.cache.integration.hibernate;
+
+import org.jboss.cache.Fqn;
+
+/**
+ * Utilities related to the Hibernate integration tests.
+ *
+ * @author Brian Stansberry
+ */
+public class HibernateIntegrationTestUtil
+{
+ public static final Fqn<String> TS_BASE_FQN = Fqn.fromString("/TS");
+ public static final Fqn<String> REGION_PREFIX_FQN = Fqn.fromString("/test");
+ public static final Fqn<String> TS_FQN = new Fqn<String>(TS_BASE_FQN, new Fqn<String>(REGION_PREFIX_FQN, Fqn.fromString("/org/hibernate/cache/UpdateTimestampsCache")));
+ public static final String ITEM = "item";
+
+ /**
+ * Prevent instantiation.
+ */
+ private HibernateIntegrationTestUtil()
+ {
+ // no-op
+ }
+}
Added: core/branches/2.1.X/src/test/java/org/jboss/cache/integration/hibernate/UpdateTimestampsCachingTest.java
===================================================================
--- core/branches/2.1.X/src/test/java/org/jboss/cache/integration/hibernate/UpdateTimestampsCachingTest.java (rev 0)
+++ core/branches/2.1.X/src/test/java/org/jboss/cache/integration/hibernate/UpdateTimestampsCachingTest.java 2008-04-01 20:42:48 UTC (rev 5488)
@@ -0,0 +1,146 @@
+package org.jboss.cache.integration.hibernate;
+
+import java.util.HashSet;
+import java.util.Set;
+
+import static org.testng.AssertJUnit.assertEquals;
+import static org.jboss.cache.integration.hibernate.HibernateIntegrationTestUtil.*;
+
+import javax.transaction.Synchronization;
+import javax.transaction.Transaction;
+import javax.transaction.TransactionManager;
+
+import org.apache.commons.logging.Log;
+import org.apache.commons.logging.LogFactory;
+import org.jboss.cache.Cache;
+import org.jboss.cache.CacheFactory;
+import org.jboss.cache.DefaultCacheFactory;
+import org.jboss.cache.Fqn;
+import org.jboss.cache.config.Configuration;
+import org.testng.annotations.AfterMethod;
+import org.testng.annotations.BeforeMethod;
+import org.testng.annotations.Test;
+
+/**
+ * Tests that mimic the Hibernate Second Level Cache UpdateTimestamps
+ * use case.
+ * <p>
+ * FIXME: Make this much more closely duplicate the real Hibernate usage;
+ * use a CacheManager with configs consistent with Hibernate, etc.
+ * </p>
+ *
+ * @author Brian Stansberry
+ */
+@Test(groups = "integration")
+public class UpdateTimestampsCachingTest
+{
+ private static final Log log = LogFactory.getLog(UpdateTimestampsCachingTest.class);
+
+ private static final Fqn<String> ENTITY_TYPE_FQN = Fqn.fromString("/com/foo/MyEntity");
+
+ private Set<Cache<String, Object>> caches;
+
+ @BeforeMethod(alwaysRun = true)
+ public void setUp() throws Exception
+ {
+ caches = new HashSet<Cache<String, Object>>();
+ }
+
+ @AfterMethod(alwaysRun = true)
+ public void tearDown()
+ {
+ for (Cache<String, Object> cache : caches)
+ cache.stop();
+ }
+
+ private Cache<String, Object> createCache(boolean optimistic)
+ {
+ CacheFactory<String, Object> cf = new DefaultCacheFactory<String, Object>();
+ Cache<String, Object> cache = cf.createCache("META-INF/conf-test/local-tx-service.xml", false);
+ cache.getConfiguration().setNodeLockingScheme(optimistic ? Configuration.NodeLockingScheme.OPTIMISTIC : Configuration.NodeLockingScheme.PESSIMISTIC);
+ cache.start();
+ caches.add(cache);
+ return cache;
+ }
+
+ public void testTimestampUpdateInAfterCompletionPessimistic() throws Exception
+ {
+ timestampUpdateInAfterCompletionTest(false);
+ }
+
+ public void testTimestampUpdateInAfterCompletionOptimistic() throws Exception
+ {
+ timestampUpdateInAfterCompletionTest(true);
+ }
+
+ /**
+ * FIXME Make this use a cluster, not just a single cache
+ *
+ * @param optimistic
+ * @throws Exception
+ */
+ private void timestampUpdateInAfterCompletionTest(boolean optimistic) throws Exception
+ {
+ Cache<String, Object> cache = createCache(optimistic);
+ TransactionManager tm = cache.getConfiguration().getRuntimeConfig().getTransactionManager();
+
+ tm.begin();
+ Transaction tx = tm.getTransaction();
+ UpdateTimestampsSynchronization sync = new UpdateTimestampsSynchronization(ENTITY_TYPE_FQN, cache, tm);
+ tx.registerSynchronization(sync);
+
+ Fqn<String> fqn = new Fqn<String>(REGION_PREFIX_FQN, ENTITY_TYPE_FQN);
+ fqn = new Fqn<String>(fqn, "1");
+ cache.put(fqn, ITEM, "value");
+
+ tm.commit();
+
+ fqn = new Fqn<String>(HibernateIntegrationTestUtil.TS_FQN, ENTITY_TYPE_FQN);
+ assertEquals(sync.getTimestamp(), cache.get(fqn, ITEM));
+ }
+
+ private class UpdateTimestampsSynchronization implements Synchronization
+ {
+ private final Cache<String, Object> cache;
+ private final Fqn<String> entityType;
+ private final TransactionManager tm;
+ private Long timestamp;
+
+ UpdateTimestampsSynchronization(Fqn<String> entityType, Cache<String, Object> cache, TransactionManager tm)
+ {
+ this.entityType = entityType;
+ this.cache = cache;
+ this.tm = tm;
+ }
+
+ public Long getTimestamp()
+ {
+ return timestamp;
+ }
+
+ public void beforeCompletion()
+ {
+ // no-op
+ }
+
+ public void afterCompletion(int status)
+ {
+ Fqn<String> fqn = new Fqn<String>(TS_FQN, entityType);
+ try
+ {
+ timestamp = new Long(System.currentTimeMillis());
+
+ Transaction tx = tm.suspend();
+ cache.getInvocationContext().getOptionOverrides().setForceAsynchronous(true);
+ cache.put(fqn, ITEM, timestamp);
+ tm.resume(tx);
+ log.info("Updated timestamp " + entityType);
+ }
+ catch (Exception e)
+ {
+ log.error("Problem updating timestamp " + entityType, e);
+ throw new RuntimeException(e);
+ }
+ }
+ }
+}
16 years, 3 months
JBoss Cache SVN: r5487 - core/trunk/src/main/docbook/userguide/en/modules.
by jbosscache-commits@lists.jboss.org
Author: manik.surtani(a)jboss.com
Date: 2008-04-01 09:31:38 -0400 (Tue, 01 Apr 2008)
New Revision: 5487
Modified:
core/trunk/src/main/docbook/userguide/en/modules/cache_loaders.xml
Log:
Corrected some Amazon S3 stuff
Modified: core/trunk/src/main/docbook/userguide/en/modules/cache_loaders.xml
===================================================================
--- core/trunk/src/main/docbook/userguide/en/modules/cache_loaders.xml 2008-04-01 13:24:15 UTC (rev 5486)
+++ core/trunk/src/main/docbook/userguide/en/modules/cache_loaders.xml 2008-04-01 13:31:38 UTC (rev 5487)
@@ -902,60 +902,73 @@
<section id="cl.s3">
<title>S3CacheLoader</title>
- <para>The <literal>S3CacheLoader</literal> uses the
- <ulink url="http://aws.amazon.com/">Amazon S3</ulink> (Simple Storage Solution)
- for storing cache data.
+ <para>The
+ <literal>S3CacheLoader</literal>
+ uses the
+ <ulink url="http://aws.amazon.com/">Amazon S3</ulink>
+ (Simple Storage Solution)
+ for storing cache data.
Since Amazon S3 is remote network storage and has fairly high latency,
- it is really best for caches that store large pieces of data, such as media
- or files.
+ it is really best for caches that store large pieces of data, such as media
+ or files.
But consider this cache loader over the JDBC or
- file system based cache loaders if you want remotely managed, highly reliable
- storage. Or, use it for applications running on Amazon's Elastic Compute Cloud.
+ file system based cache loaders if you want remotely managed, highly reliable
+ storage. Or, use it for applications running on Amazon's EC2 (Elastic Compute Cloud).
</para>
- <para>
- If you're planning to use Amazon S3 for storage, consider using it with JBoss Cache.
- JBoss Cache itself provides in-memory caching for your data to minimize the amount of
- remote access calls, thus reducing the latency and cost of fetching your Amazon S3 data.
- With cache replication, you are also able to load data from your local cluster
- without having to remotely access it every time.
+ <para>
+ If you're planning to use Amazon S3 for storage, consider using it with JBoss Cache.
+ JBoss Cache itself provides in-memory caching for your data to minimize the amount of
+ remote access calls, thus reducing the latency and cost of fetching your Amazon S3 data.
+ With cache replication, you are also able to load data from your local cluster
+ without having to remotely access it every time.
</para>
<para>
- Note that Amazon S3 does not support transactions. If transactions
- are used in your application then there is some possibility of state
- inconsistency when using this cache loader. However, writes are atomic, in
- that if a write fails nothing is considered written and data is never
- corrupted.
+ Note that Amazon S3 does not support transactions. If transactions
+ are used in your application then there is some possibility of state
+ inconsistency when using this cache loader. However, writes are atomic, in
+ that if a write fails nothing is considered written and data is never
+ corrupted.
</para>
<para>
- Data is stored in keys based on the FQN of the Node and Node data is
- serialized as a java.util.Map using the <literal>CacheSPI.getMarshaller()</literal>
- instance.
- Read the JavaDoc on how data is structured and stored.
+ Data is stored in keys based on the Fqn of the Node and Node data is
+ serialized as a java.util.Map using the
+ <literal>CacheSPI.getMarshaller()</literal>
+ instance.
+ Read the javadoc on how data is structured and stored.
Be aware this means data is not readily accessible over HTTP to
- non-JBossCache clients. Your feedback and help would be appreciated
+ non-JBoss Cache clients. Your feedback and help would be appreciated
to extend this cache loader for that purpose.
</para>
<para>
- With this cache loader, single-key operations such as
- <literal>Node.remove(Object)</literal> and <literal>Node.put(Object,
- Object)</literal> are the slowest as data is stored in a single Map instance.
- Use bulk operations such as <literal>Node.replaceAll(Map)</literal>
- and <literal>Node.clearData()</literal> for more efficiency.
- Try the <literal>cache.s3.optimize</literal> option as well.
+ With this cache loader, single-key operations such as
+ <literal>Node.remove(Object)</literal>
+ and
+ <literal>Node.put(Object,
+ Object)
+ </literal>
+ are the slowest as data is stored in a single Map instance.
+ Use bulk operations such as
+ <literal>Node.replaceAll(Map)</literal>
+ and
+ <literal>Node.clearData()</literal>
+ for more efficiency.
+ Try the
+ <literal>cache.s3.optimize</literal>
+ option as well.
</para>
-
+
<section>
<title>Amazon S3 Library</title>
- <para>The S3 cache loader is provided with the default
- distribution but requires a library to access the service
- at runtime. This runtime library may be obtained through the JBoss Maven
- Repository. Include the following sections in your pom.xml file:
- </para>
- <programlisting><![CDATA[
+ <para>The S3 cache loader is provided with the default
+ distribution but requires a library to access the service
+ at runtime. This runtime library may be obtained through the Sourceforge Maven
+ Repository. Include the following sections in your pom.xml file:
+ </para>
+ <programlisting><![CDATA[
<repository>
<id>e-xml.sourceforge.net</id>
<url>http://e-xml.sourceforge.net/maven2/repository</url>
@@ -967,95 +980,114 @@
<version>1.0.0.0</version>
</dependency>
]]>
- </programlisting>
- If you do not use Maven, you can still download the
- amazon-s3 library through the repository URL.
+ </programlisting>
+ If you do not use Maven, you can still download the
+ amazon-s3 library through the repository URL.
</section>
<section>
<title>Configuration</title>
- <para>At a minimum, you must configure your Amazon S3 access key and
- secret access key. The other configuration keys are listed in general
- order of utility.
- </para>
+ <para>At a minimum, you must configure your Amazon S3 access key and
+ secret access key. The other configuration keys are listed in general
+ order of utility.
+ </para>
- <para>
- <itemizedlist>
- <listitem>
- <literal>cache.s3.accessKeyId</literal> -
- Amazon S3 Access Key, available from your account profile.
- </listitem>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <literal>cache.s3.accessKeyId</literal>
+ -
+ Amazon S3 Access Key, available from your account profile.
+ </listitem>
- <listitem>
- <literal>cache.s3.secretAccessKey</literal> -
- Amazon S3 Secret Access Key, available from your account profile.
- As this is a password, be careful not to distribute it or include
- this secret key in built software.
- </listitem>
+ <listitem>
+ <literal>cache.s3.secretAccessKey</literal>
+ -
+ Amazon S3 Secret Access Key, available from your account profile.
+ As this is a password, be careful not to distribute it or include
+ this secret key in built software.
+ </listitem>
- <listitem>
- <literal>cache.s3.secure</literal> -
- The default is <literal>false</literal>:
- Traffic is sent unencrypted over the public Internet.
- Set to <literal>true</literal> to use HTTPS.
- Note that unencrypted is obviously faster.
- </listitem>
+ <listitem>
+ <literal>cache.s3.secure</literal>
+ -
+ The default is<literal>false</literal>:
+ Traffic is sent unencrypted over the public Internet.
+ Set to
+ <literal>true</literal>
+ to use HTTPS.
+ Note that unencrypted is obviously faster.
+ </listitem>
- <listitem>
- <literal>cache.s3.bucket</literal> -
- Name of the bucket to store data.
- For different caches using the same access key, use a different bucket name.
- Read the S3 documentation on the definition of a bucket.
- The default is <literal>jboss-cache</literal>.
- </listitem>
+ <listitem>
+ <literal>cache.s3.bucket</literal>
+ -
+ Name of the bucket to store data.
+ For different caches using the same access key, use a different bucket name.
+ Read the S3 documentation on the definition of a bucket.
+ The default is<literal>jboss-cache</literal>.
+ </listitem>
- <listitem>
- <literal>cache.s3.callingFormat</literal> -
- One of <literal>PATH</literal>, <literal>SUBDOMAIN</literal>, or
- <literal>VANITY</literal>.
- Read the S3 documentation on the use of calling domains.
- The default is <literal>SUBDOMAIN</literal>.
- </listitem>
+ <listitem>
+ <literal>cache.s3.callingFormat</literal>
+ -
+ One of<literal>PATH</literal>,<literal>SUBDOMAIN</literal>, or
+ <literal>VANITY</literal>.
+ Read the S3 documentation on the use of calling domains.
+ The default is<literal>SUBDOMAIN</literal>.
+ </listitem>
- <listitem>
- <literal>cache.s3.optimize</literal> -
- The default is <literal>false</literal>.
- If true, <literal>put(Map)</literal> operations
- replace the data stored at an FQN rather than attempt
- to fetch and merge. (This option is fairly experimental
- at the moment.)
- </listitem>
+ <listitem>
+ <literal>cache.s3.optimize</literal>
+ -
+ The default is<literal>false</literal>.
+ If true,
+ <literal>put(Map)</literal>
+ operations
+ replace the data stored at an Fqn rather than attempt
+ to fetch and merge. (This option is fairly experimental
+ at the moment.)
+ </listitem>
- <listitem>
- <literal>cache.s3.parentCache</literal> -
- The default is <literal>true</literal>.
- Set this value to <literal>false</literal> if you are using multiple caches
- sharing the same S3 bucket, that remove parent nodes of nodes being created
- in other caches. (This is not a common use case.)
- <para>
- JBoss Cache stores nodes in a tree format and automatically
- creates intermediate parent nodes as necessary.
- The S3 cache loader must also create these parent nodes as well
- to allow for operations such as <literal>getChildrenNames</literal> to work
- properly. Checking if all parent nodes exists for every <literal>put</literal>
- operation is fairly expensive, so by default the cache loader caches
- the existance of these parent nodes.
- </para>
- </listitem>
+ <listitem>
+ <literal>cache.s3.parentCache</literal>
+ -
+ The default is<literal>true</literal>.
+ Set this value to
+ <literal>false</literal>
+ if you are using multiple caches
+ sharing the same S3 bucket, that remove parent nodes of nodes being created
+ in other caches. (This is not a common use case.)
+ <para>
+ JBoss Cache stores nodes in a tree format and automatically
+ creates intermediate parent nodes as necessary.
+ The S3 cache loader must also create these parent nodes as well
+ to allow for operations such as
+ <literal>getChildrenNames</literal>
+ to work
+ properly. Checking if all parent nodes exists for every
+ <literal>put</literal>
+ operation is fairly expensive, so by default the cache loader caches
+ the existence of these parent nodes.
+ </para>
+ </listitem>
- <listitem>
- <literal>cache.s3.location</literal> -
- This choses a primary storage location for your data
- to reduce loading and storage latency closest to you.
- Set to <literal>EU</literal> to store data locale to Europe.
- The default is <literal>null</literal>, or to store in the United States.
- </listitem>
- </itemizedlist>
- </para>
- </section>
-
+ <listitem>
+ <literal>cache.s3.location</literal>
+ -
+ This choses a primary storage location for your data
+ to reduce loading and storage latency closest to you.
+ Set to
+ <literal>EU</literal>
+ to store data locale to Europe.
+ The default is<literal>null</literal>, to store in the United States.
+ </listitem>
+ </itemizedlist>
+ </para>
+ </section>
+
</section>
-
+
<section id="cl.tcp">
<title>TcpDelegatingCacheLoader</title>
16 years, 3 months
JBoss Cache SVN: r5486 - in core/trunk/src/main: docbook/tutorial/en and 2 other directories.
by jbosscache-commits@lists.jboss.org
Author: manik.surtani(a)jboss.com
Date: 2008-04-01 09:24:15 -0400 (Tue, 01 Apr 2008)
New Revision: 5486
Modified:
core/trunk/src/main/docbook/faq/en/master.xml
core/trunk/src/main/docbook/tutorial/en/master.xml
core/trunk/src/main/docbook/userguide/en/master.xml
core/trunk/src/main/java/org/jboss/cache/Version.java
Log:
Updated versioning info
Modified: core/trunk/src/main/docbook/faq/en/master.xml
===================================================================
--- core/trunk/src/main/docbook/faq/en/master.xml 2008-04-01 13:21:16 UTC (rev 5485)
+++ core/trunk/src/main/docbook/faq/en/master.xml 2008-04-01 13:24:15 UTC (rev 5486)
@@ -6,8 +6,8 @@
<bookinfo>
<title>Frequently Asked Questions about JBoss Cache</title>
<!-- Release version and date -->
- <releaseinfo>Release 2.1.0 Alegrias</releaseinfo>
- <pubdate>March 2008</pubdate>
+ <releaseinfo>Release 2.2.0 Poblano</releaseinfo>
+ <pubdate>May 2008</pubdate>
<author>
<firstname>Manik</firstname>
Modified: core/trunk/src/main/docbook/tutorial/en/master.xml
===================================================================
--- core/trunk/src/main/docbook/tutorial/en/master.xml 2008-04-01 13:21:16 UTC (rev 5485)
+++ core/trunk/src/main/docbook/tutorial/en/master.xml 2008-04-01 13:24:15 UTC (rev 5486)
@@ -3,8 +3,8 @@
<articleinfo>
<title>JBoss Cache Core Edition Tutorial</title>
<!-- Release version and date -->
- <releaseinfo>Release 2.1.0 Alegrias</releaseinfo>
- <pubdate>March 2008</pubdate>
+ <releaseinfo>Release 2.2.0 Poblano</releaseinfo>
+ <pubdate>May 2008</pubdate>
<author>
<firstname>Manik</firstname>
Modified: core/trunk/src/main/docbook/userguide/en/master.xml
===================================================================
--- core/trunk/src/main/docbook/userguide/en/master.xml 2008-04-01 13:21:16 UTC (rev 5485)
+++ core/trunk/src/main/docbook/userguide/en/master.xml 2008-04-01 13:24:15 UTC (rev 5486)
@@ -21,8 +21,8 @@
<subtitle>A clustered, transactional cache</subtitle>
<!-- Release version and date -->
- <releaseinfo>Release 2.1.0 Alegrias</releaseinfo>
- <pubdate>March 2008</pubdate>
+ <releaseinfo>Release 2.2.0 Poblano</releaseinfo>
+ <pubdate>May 2008</pubdate>
<!-- Authors/contributors -->
<author>
Modified: core/trunk/src/main/java/org/jboss/cache/Version.java
===================================================================
--- core/trunk/src/main/java/org/jboss/cache/Version.java 2008-04-01 13:21:16 UTC (rev 5485)
+++ core/trunk/src/main/java/org/jboss/cache/Version.java 2008-04-01 13:24:15 UTC (rev 5486)
@@ -11,10 +11,10 @@
@Immutable
public class Version
{
- public static final String version = "2.1.0-SNAPSHOT";
- public static final String codename = "Alegrias";
+ public static final String version = "2.2.0-SNAPSHOT";
+ public static final String codename = "Poblano";
//public static final String cvs = "$Id: Version.java 4592 2007-10-10 16:44:36Z manik.surtani(a)jboss.com $";
- static final byte[] version_id = {'0', '2', '1', '0', 'S'};
+ static final byte[] version_id = {'0', '2', '2', '0', 'S'};
private static final int MAJOR_SHIFT = 11;
private static final int MINOR_SHIFT = 6;
16 years, 3 months