JBoss Cache SVN: r8127 - core/trunk/src/main/java/org/jboss/cache/jmx.
by jbosscache-commits@lists.jboss.org
Author: mircea.markus
Date: 2009-07-03 06:18:00 -0400 (Fri, 03 Jul 2009)
New Revision: 8127
Modified:
core/trunk/src/main/java/org/jboss/cache/jmx/CacheJmxWrapper.java
core/trunk/src/main/java/org/jboss/cache/jmx/CacheJmxWrapperMBean.java
Log:
made this class not deprecated, and commented it usage
Modified: core/trunk/src/main/java/org/jboss/cache/jmx/CacheJmxWrapper.java
===================================================================
--- core/trunk/src/main/java/org/jboss/cache/jmx/CacheJmxWrapper.java 2009-07-01 11:37:29 UTC (rev 8126)
+++ core/trunk/src/main/java/org/jboss/cache/jmx/CacheJmxWrapper.java 2009-07-03 10:18:00 UTC (rev 8127)
@@ -60,9 +60,9 @@
* @author <a href="brian.stansberry(a)jboss.com">Brian Stansberry</a>
* @author <a href="mailto:galder.zamarreno@jboss.com">Galder Zamarreno</a>
* @version $Revision$
- * @deprecated use {@link org.jboss.cache.jmx.JmxRegistrationManager}. This class will not be supported from 3.0 on.
+ * For all purposes use {@link org.jboss.cache.jmx.JmxRegistrationManager}. Use this class only when you want to obtain
+ * a reference to a Cache object through JMX.
*/
-@Deprecated
public class CacheJmxWrapper<K, V>
extends NotificationBroadcasterSupport
implements CacheJmxWrapperMBean<K, V>, MBeanRegistration, CacheNotificationBroadcaster
Modified: core/trunk/src/main/java/org/jboss/cache/jmx/CacheJmxWrapperMBean.java
===================================================================
--- core/trunk/src/main/java/org/jboss/cache/jmx/CacheJmxWrapperMBean.java 2009-07-01 11:37:29 UTC (rev 8126)
+++ core/trunk/src/main/java/org/jboss/cache/jmx/CacheJmxWrapperMBean.java 2009-07-03 10:18:00 UTC (rev 8127)
@@ -40,9 +40,9 @@
* <li> Cache information methods (numNodes, numAttributes, lockInfo, printDetails) which print as Strings or as formatted HTML (for web based JMX consoles)</li>
*
* @since 2.0.0
- * @deprecated use {@link org.jboss.cache.jmx.JmxRegistrationManager}
+ * For all purposes use {@link org.jboss.cache.jmx.JmxRegistrationManager}. Use this class only when you want to obtain
+ * a reference to a Cache object through JMX.
*/
-@Deprecated
public interface CacheJmxWrapperMBean<K, V> extends LegacyConfiguration
{
/**
15 years, 2 months
JBoss Cache SVN: r8126 - enterprise-docs/tags/JBoss_EAP_4_3/Cache_Tree_Cache_Guide/de-DE.
by jbosscache-commits@lists.jboss.org
Author: jdimanos(a)jboss.com
Date: 2009-07-01 07:37:29 -0400 (Wed, 01 Jul 2009)
New Revision: 8126
Modified:
enterprise-docs/tags/JBoss_EAP_4_3/Cache_Tree_Cache_Guide/de-DE/Treecache_marshaller.po
Log:
update
Modified: enterprise-docs/tags/JBoss_EAP_4_3/Cache_Tree_Cache_Guide/de-DE/Treecache_marshaller.po
===================================================================
--- enterprise-docs/tags/JBoss_EAP_4_3/Cache_Tree_Cache_Guide/de-DE/Treecache_marshaller.po 2009-07-01 02:57:12 UTC (rev 8125)
+++ enterprise-docs/tags/JBoss_EAP_4_3/Cache_Tree_Cache_Guide/de-DE/Treecache_marshaller.po 2009-07-01 11:37:29 UTC (rev 8126)
@@ -8,7 +8,7 @@
"Project-Id-Version: Treecache_marshaller\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
"POT-Creation-Date: 2008-09-21 04:44+0000\n"
-"PO-Revision-Date: 2009-07-01 12:56+1000\n"
+"PO-Revision-Date: 2009-07-01 21:25+1000\n"
"Last-Translator: \n"
"Language-Team: <en(a)li.org>\n"
"MIME-Version: 1.0\n"
@@ -54,6 +54,18 @@
"code to register a classloader that should be used to handle replication for "
"a portion of the tree."
msgstr ""
+"Zusätzlich zur Verbesserung bei Performance und Effizienz gegenüber "
+"standardmäßiger Java-Serialisierung führt der "
+"<literal>TreeCacheMarshaller</literal> auch eine andere Funktion durch. "
+"Um ein zu ihm von einem Remote Cache repliziertes Objekt zu deserialisieren "
+"muss eine Cache-Instanz Zugriff auf den Klassenlader haben, der die Klasse des "
+"Objekts definiert. Dies ist einfach, wenn der eigene Klassenlader des Cache auf "
+"die benötigten Klassen zugreifen kann, aber in Situationen, in denen JBoss Cache "
+"als ein verschiedene Klassenlader verwendende Clients unterstützender Dienst "
+"eingesetzt wird kann der <literal>TreeCacheMarshaller</literal> so konfiguriert "
+"werden, dass er verschiedene Klassenlader auf einer per-Region Basis verwendet "
+"indem Applikationscode gestattet wird einen Klassenlader zu registrieren, der zur "
+"Handhabung der Replikation eines Teils des Baums verwendet werden soll."
#. Tag: title
#: Treecache_marshaller.xml:13
15 years, 2 months
JBoss Cache SVN: r8125 - enterprise-docs/tags/JBoss_EAP_4_3/Cache_Tree_Cache_Guide/de-DE.
by jbosscache-commits@lists.jboss.org
Author: jdimanos(a)jboss.com
Date: 2009-06-30 22:57:12 -0400 (Tue, 30 Jun 2009)
New Revision: 8125
Modified:
enterprise-docs/tags/JBoss_EAP_4_3/Cache_Tree_Cache_Guide/de-DE/Treecache_marshaller.po
Log:
update
Modified: enterprise-docs/tags/JBoss_EAP_4_3/Cache_Tree_Cache_Guide/de-DE/Treecache_marshaller.po
===================================================================
--- enterprise-docs/tags/JBoss_EAP_4_3/Cache_Tree_Cache_Guide/de-DE/Treecache_marshaller.po 2009-06-30 10:44:46 UTC (rev 8124)
+++ enterprise-docs/tags/JBoss_EAP_4_3/Cache_Tree_Cache_Guide/de-DE/Treecache_marshaller.po 2009-07-01 02:57:12 UTC (rev 8125)
@@ -8,7 +8,7 @@
"Project-Id-Version: Treecache_marshaller\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
"POT-Creation-Date: 2008-09-21 04:44+0000\n"
-"PO-Revision-Date: 2009-06-30 20:44+1000\n"
+"PO-Revision-Date: 2009-07-01 12:56+1000\n"
"Last-Translator: \n"
"Language-Team: <en(a)li.org>\n"
"MIME-Version: 1.0\n"
@@ -237,6 +237,14 @@
"be thrown if an attempt is made to register classloader <literal>Y</literal> "
"for FQN <literal>/a/b</literal>."
msgstr ""
+"Beachten Sie, dass es rechtswidrig ist, einen Klassenlader für einen FQN zu "
+"registrieren, der Nachkomme eines FQN ist, für den bereits ein Klassenlader "
+"registriert ist. "
+"Ist zum Beispiel Klassenlader <literal>X</literal> für FQN "
+"<literal>/a</literal> registriert, so wird eine "
+"<literal>RegionNameConflictException</literal> "
+"bei dem Versuch <literal>Y</literal> für FQN <literal>/a/b</literal> zu "
+"registrieren gemeldet."
#. Tag: para
#: Treecache_marshaller.xml:31
@@ -272,6 +280,13 @@
"required classloaders before a cache is started. For example, consider the "
"following scenario:"
msgstr ""
+"Die einfache, oben erläuterte API ist hilfreich, aber in SItuationen in denen "
+"Anwendungen mit verschiedenen Klassenladern sich ein Cache teilen, "
+"unterscheidet sich der Lebenszyklus dieser Anwendungen in der Regel "
+"von dem des Cache. "
+"Die Folge hiervon ist, dass es schwierig oder unmöglich ist alle erforderlichen "
+"Klasslader zu registrieren, ehe ein Cache gestartet wird. Stellen Sie sich zum "
+"Beispiel folgendes Szenario vor:"
#. Tag: para
#: Treecache_marshaller.xml:43
@@ -323,6 +338,10 @@
"started, the initial transfer of state from A to B would have failed as "
"well, as B would not be able to unmarshal the transferred objects."
msgstr ""
+"Desweiteren würde - falls Server A Objekte hinzugefügt wurden ehe Server B "
+"gestartet wurde - der erstmalige Statustransfer von A nach B ebenfalls "
+"fehlschlagen, da B nicht in der Lage wäre, ein Unmarshalling der übertragenen "
+"Objekte durchzuführen."
#. Tag: para
#: Treecache_marshaller.xml:64
@@ -334,6 +353,11 @@
"classloader has been registered, the portion of the tree can be \"activated"
"\". Activation causes the following events to occur:"
msgstr ""
+"Um dieses Problem zu lösen kann bei Verwendung Region-basierten \"Marshallings\" "
+"eine Cache-Instanz konfiguriert werden, die Replikationsereignisse für einen "
+"Teil des Baums ignoriert. Dieser Teil des Baums wird als \"inaktiv\" angesehen. "
+"Nachdem der benötigte Klassenlader registriert wurde, kann der Teil des Baums "
+"\"aktiviert\" werden. Bei der Aktivierung kommt es zu folgenden Ereignissen:"
#. Tag: para
#: Treecache_marshaller.xml:69
@@ -363,6 +387,9 @@
"exposes the following API related to activating and inactivating portions of "
"the cache:"
msgstr ""
+"Zusätzlich zum oben erläuterten, einfachen und auf das Marshalling bezogenen API "
+"legt TreeCache folgendes, auf die Aktivierung und Deaktivierung von Teilen des Cache "
+"bezogenes API offen:"
#. Tag: programlisting
#: Treecache_marshaller.xml:78
@@ -510,6 +537,12 @@
"property should be set as part of normal cache configuration, typically in "
"the cache's XML configuration file:"
msgstr ""
+"Die Property <literal>InactiveOnStartup</literal> steuert, ob das gesamte Cache "
+"als inaktiv angesehen werden soll, wenn das Cache startet. In den meisten "
+"Anwendungsfällen in denen Region-Aktivierung benötigt wird, würde diese "
+"\"Property\" auf \"true\" eingestellt. Diese Property sollte als Teil der normalen "
+"Cache-Konfiguration eingestellt werden, in der Regel in der "
+"XML-Konfigurationsdatei des Cache:"
#. Tag: programlisting
#: Treecache_marshaller.xml:82
@@ -546,6 +579,18 @@
"cannot provide state. So, each node in the cluster is queried until one "
"provides state."
msgstr ""
+"Wird <literal>activateRegion()</literal> aufgerufen, so wird jeder Node im "
+"Cluster abgefragt, um zu sehen, ob ein aktiver Status für diesen Teil des Baums "
+"vorhanden ist. Ist dies der Fall, so wird der aktuelle Status wiedergegeben, "
+"der dann in den Baum integriert wird. Wurde der Status von einem Node übertragen, "
+"so werden keine weiteren Nodes nach dem Status befragt. "
+"Dieser Vorgang unterscheidet sich wesentlich vom erstmaligen Statustransfer, "
+"der beim Start-up erfolgt, wenn eine <literal>FetchInMemoryState</literal>-Property "
+"auf \"true\" gesetzt wird. Während des erstmaligen Statustransfers wird nur das älteste "
+"Mitglied des Clusters nach dem Status befragt. Diese Vorgehensweise ist für "
+"Region-Aktivierung nicht ausreichend, da es möglich ist dass beim ältesten Mitglied "
+"des Clusters die Region deaktiviert ist und es daher den Status nicht liefern kann. "
+"Daher wird jeder Node im Cluster abgefragt, bis einer den Status bereitstellt. "
#. Tag: para
#: Treecache_marshaller.xml:89
@@ -575,6 +620,16 @@
"<literal>activateRegion()</literal> will throw an exception if it discovers "
"data in a region that is being activated."
msgstr ""
+"Es ist wichtig zu verstehen, dass wenn eine Region des Baums als "
+"inaktiv gekennzeichnet ist, dies nur bedeutet, dass Replikations-Traffic "
+"von anderen Cluster-Nodes, der sich auf diesen Teil des Baums bezieht "
+"ignoriert wird. Technisch ist es nach wie vor möglich, dass Objekte im "
+"inaktiven Teil des Baums lokal (über einen <literal>put</literal>-Aufruf) "
+"platziert werden, und jede solche lokale Aktivität wird an anderen Nodes "
+"repliziert. TreeCache verhindert diese Art von lokaler Aktivität an einer "
+"inaktiven Region nicht, aber wie oben erwähnt meldet "
+"<literal>activateRegion()</literal> eine Ausnahme, wenn bei einer zu "
+"aktivierenden Region Daten aufgefunden werden."
#. Tag: title
#: Treecache_marshaller.xml:96
@@ -593,6 +648,12 @@
"be a web application, which when started will register its classloader with "
"the TreeCache and activate its own region of the cache."
msgstr ""
+"Als Beispiel für die Verwendung von Region-Aktivierung und Deaktivierung "
+"stellen wir uns ein Szenario vor, bei dem eine TreeCache-Instanz als geteilter "
+"MBean-Dienst deployt wird, indem eine <literal>-service.xml</literal> im JBoss "
+"<literal>/deploy</literal>-Verzeichnis deployt wird. Einer der Nutzer dieses "
+"Cache könnte eine Webanwendung sein, die beim Start ihren Klassenlader "
+"beim TreeCache registriert und ihre eigene Region des Cache aktiviert."
#. Tag: para
#: Treecache_marshaller.xml:100
15 years, 2 months