X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?p=controller.git;a=blobdiff_plain;f=opendaylight%2Fmd-sal%2Fsal-distributed-datastore%2Fsrc%2Fmain%2Fjava%2Forg%2Fopendaylight%2Fcontroller%2Fcluster%2Fdatastore%2FShardTransaction.java;h=365960713dc84754258b364765d0c0f0b794d83b;hp=b316b9df04966d82faf19ffc0743994dc684ec4a;hb=8fe43e73969a8f189b76dd021c9e84146473a596;hpb=9d50e2ca76cf1a5eb0636d4a5a704b49ec4a8a25 diff --git a/opendaylight/md-sal/sal-distributed-datastore/src/main/java/org/opendaylight/controller/cluster/datastore/ShardTransaction.java b/opendaylight/md-sal/sal-distributed-datastore/src/main/java/org/opendaylight/controller/cluster/datastore/ShardTransaction.java index b316b9df04..af25df13d2 100644 --- a/opendaylight/md-sal/sal-distributed-datastore/src/main/java/org/opendaylight/controller/cluster/datastore/ShardTransaction.java +++ b/opendaylight/md-sal/sal-distributed-datastore/src/main/java/org/opendaylight/controller/cluster/datastore/ShardTransaction.java @@ -9,138 +9,192 @@ package org.opendaylight.controller.cluster.datastore; import akka.actor.ActorRef; +import akka.actor.PoisonPill; import akka.actor.Props; -import akka.actor.UntypedActor; -import akka.event.Logging; -import akka.event.LoggingAdapter; +import akka.actor.ReceiveTimeout; import akka.japi.Creator; import com.google.common.base.Optional; -import com.google.common.util.concurrent.ListenableFuture; +import com.google.common.util.concurrent.CheckedFuture; +import org.opendaylight.controller.cluster.common.actor.AbstractUntypedActorWithMetering; +import org.opendaylight.controller.cluster.datastore.exceptions.UnknownMessageException; +import org.opendaylight.controller.cluster.datastore.jmx.mbeans.shard.ShardStats; import org.opendaylight.controller.cluster.datastore.messages.CloseTransaction; import org.opendaylight.controller.cluster.datastore.messages.CloseTransactionReply; -import org.opendaylight.controller.cluster.datastore.messages.DeleteData; -import org.opendaylight.controller.cluster.datastore.messages.DeleteDataReply; -import org.opendaylight.controller.cluster.datastore.messages.MergeData; -import org.opendaylight.controller.cluster.datastore.messages.MergeDataReply; +import org.opendaylight.controller.cluster.datastore.messages.DataExists; +import org.opendaylight.controller.cluster.datastore.messages.DataExistsReply; import org.opendaylight.controller.cluster.datastore.messages.ReadData; import org.opendaylight.controller.cluster.datastore.messages.ReadDataReply; -import org.opendaylight.controller.cluster.datastore.messages.ReadyTransaction; -import org.opendaylight.controller.cluster.datastore.messages.ReadyTransactionReply; -import org.opendaylight.controller.cluster.datastore.messages.WriteData; -import org.opendaylight.controller.cluster.datastore.messages.WriteDataReply; +import org.opendaylight.controller.md.sal.common.api.data.ReadFailedException; +import org.opendaylight.controller.sal.core.spi.data.DOMStoreReadTransaction; import org.opendaylight.controller.sal.core.spi.data.DOMStoreReadWriteTransaction; -import org.opendaylight.controller.sal.core.spi.data.DOMStoreThreePhaseCommitCohort; -import org.opendaylight.yangtools.yang.data.api.InstanceIdentifier; +import org.opendaylight.controller.sal.core.spi.data.DOMStoreTransaction; +import org.opendaylight.controller.sal.core.spi.data.DOMStoreWriteTransaction; +import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier; import org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode; - -import java.util.concurrent.ExecutionException; +import org.opendaylight.yangtools.yang.model.api.SchemaContext; /** * The ShardTransaction Actor represents a remote transaction - * + *

* The ShardTransaction Actor delegates all actions to DOMDataReadWriteTransaction - * - * Even though the DOMStore and the DOMStoreTransactionChain implement multiple types of transactions - * the ShardTransaction Actor only works with read-write transactions. This is just to keep the logic simple. At this - * time there are no known advantages for creating a read-only or write-only transaction which may change over time - * at which point we can optimize things in the distributed store as well. - * - * Handles Messages - * ---------------- - * {@link org.opendaylight.controller.cluster.datastore.messages.ReadData} - * {@link org.opendaylight.controller.cluster.datastore.messages.WriteData} - * {@link org.opendaylight.controller.cluster.datastore.messages.MergeData} - * {@link org.opendaylight.controller.cluster.datastore.messages.DeleteData} - * {@link org.opendaylight.controller.cluster.datastore.messages.ReadyTransaction} - * {@link org.opendaylight.controller.cluster.datastore.messages.CloseTransaction} + *

+ *

+ * Handles Messages
+ * ----------------
+ *

  • {@link org.opendaylight.controller.cluster.datastore.messages.ReadData} + *
  • {@link org.opendaylight.controller.cluster.datastore.messages.WriteData} + *
  • {@link org.opendaylight.controller.cluster.datastore.messages.MergeData} + *
  • {@link org.opendaylight.controller.cluster.datastore.messages.DeleteData} + *
  • {@link org.opendaylight.controller.cluster.datastore.messages.ReadyTransaction} + *
  • {@link org.opendaylight.controller.cluster.datastore.messages.CloseTransaction} + *

    */ -public class ShardTransaction extends UntypedActor { - - private final DOMStoreReadWriteTransaction transaction; - - private final LoggingAdapter log = Logging.getLogger(getContext().system(), this); - - public ShardTransaction(DOMStoreReadWriteTransaction transaction) { - this.transaction = transaction; - } - - - public static Props props(final DOMStoreReadWriteTransaction transaction){ - return Props.create(new Creator(){ - - @Override - public ShardTransaction create() throws Exception { - return new ShardTransaction(transaction); - } - }); - } - - @Override - public void onReceive(Object message) throws Exception { - if(message instanceof ReadData){ - readData((ReadData) message); - } else if(message instanceof WriteData){ - writeData((WriteData) message); - } else if(message instanceof MergeData){ - mergeData((MergeData) message); - } else if(message instanceof DeleteData){ - deleteData((DeleteData) message); - } else if(message instanceof ReadyTransaction){ - readyTransaction((ReadyTransaction) message); - } else if(message instanceof CloseTransaction){ - closeTransaction((CloseTransaction) message); +public abstract class ShardTransaction extends AbstractUntypedActorWithMetering { + + protected static final boolean SERIALIZED_REPLY = true; + + private final ActorRef shardActor; + private final SchemaContext schemaContext; + private final ShardStats shardStats; + private final String transactionID; + private final short clientTxVersion; + + protected ShardTransaction(ActorRef shardActor, SchemaContext schemaContext, + ShardStats shardStats, String transactionID, short clientTxVersion) { + super("shard-tx"); //actor name override used for metering. This does not change the "real" actor name + this.shardActor = shardActor; + this.schemaContext = schemaContext; + this.shardStats = shardStats; + this.transactionID = transactionID; + this.clientTxVersion = clientTxVersion; } - } - private void readData(ReadData message) { - final ActorRef sender = getSender(); - final ActorRef self = getSelf(); - final InstanceIdentifier path = message.getPath(); - final ListenableFuture>> future = transaction.read(path); + public static Props props(DOMStoreTransaction transaction, ActorRef shardActor, + SchemaContext schemaContext,DatastoreContext datastoreContext, ShardStats shardStats, + String transactionID, short txnClientVersion) { + return Props.create(new ShardTransactionCreator(transaction, shardActor, schemaContext, + datastoreContext, shardStats, transactionID, txnClientVersion)); + } - future.addListener(new Runnable() { - @Override - public void run() { - try { - Optional> optional = future.get(); - if(optional.isPresent()){ - sender.tell(new ReadDataReply(optional.get()), self); - } else { - //TODO : Need to decide what to do here - } - } catch (InterruptedException | ExecutionException e) { - log.error(e, "An exception happened when reading data from path : " + path.toString()); + protected abstract DOMStoreTransaction getDOMStoreTransaction(); + + protected ActorRef getShardActor() { + return shardActor; + } + + protected String getTransactionID() { + return transactionID; + } + + protected SchemaContext getSchemaContext() { + return schemaContext; + } + + protected short getClientTxVersion() { + return clientTxVersion; + } + + @Override + public void handleReceive(Object message) throws Exception { + if (message.getClass().equals(CloseTransaction.SERIALIZABLE_CLASS)) { + closeTransaction(true); + } else if (message instanceof ReceiveTimeout) { + if(LOG.isDebugEnabled()) { + LOG.debug("Got ReceiveTimeout for inactivity - closing Tx"); + } + closeTransaction(false); + } else { + throw new UnknownMessageException(message); } + } - } - }, getContext().dispatcher()); - } + protected boolean returnCloseTransactionReply() { + return true; + } + private void closeTransaction(boolean sendReply) { + getDOMStoreTransaction().close(); - private void writeData(WriteData message){ - transaction.write(message.getPath(), message.getData()); - getSender().tell(new WriteDataReply(), getSelf()); - } + if(sendReply && returnCloseTransactionReply()) { + getSender().tell(CloseTransactionReply.INSTANCE.toSerializable(), getSelf()); + } + + getSelf().tell(PoisonPill.getInstance(), getSelf()); + } + + protected void readData(DOMStoreReadTransaction transaction, ReadData message, + final boolean returnSerialized) { + + final YangInstanceIdentifier path = message.getPath(); + try { + final CheckedFuture>, ReadFailedException> future = transaction.read(path); + Optional> optional = future.checkedGet(); + ReadDataReply readDataReply = new ReadDataReply(optional.orNull()); + + sender().tell((returnSerialized ? readDataReply.toSerializable(clientTxVersion): readDataReply), self()); + + } catch (Exception e) { + LOG.debug(String.format("Unexpected error reading path %s", path), e); + shardStats.incrementFailedReadTransactionsCount(); + sender().tell(new akka.actor.Status.Failure(e), self()); + } + } - private void mergeData(MergeData message){ - transaction.merge(message.getPath(), message.getData()); - getSender().tell(new MergeDataReply(), getSelf()); - } + protected void dataExists(DOMStoreReadTransaction transaction, DataExists message, + final boolean returnSerialized) { + final YangInstanceIdentifier path = message.getPath(); - private void deleteData(DeleteData message){ - transaction.delete(message.getPath()); - getSender().tell(new DeleteDataReply(), getSelf()); - } + try { + Boolean exists = transaction.exists(path).checkedGet(); + DataExistsReply dataExistsReply = new DataExistsReply(exists); + getSender().tell(returnSerialized ? dataExistsReply.toSerializable() : + dataExistsReply, getSelf()); + } catch (ReadFailedException e) { + getSender().tell(new akka.actor.Status.Failure(e),getSelf()); + } - private void readyTransaction(ReadyTransaction message){ - DOMStoreThreePhaseCommitCohort cohort = transaction.ready(); - ActorRef cohortActor = getContext().actorOf(ThreePhaseCommitCohort.props(cohort)); - getSender().tell(new ReadyTransactionReply(cohortActor.path()), getSelf()); + } - } + private static class ShardTransactionCreator implements Creator { + + private static final long serialVersionUID = 1L; + + final DOMStoreTransaction transaction; + final ActorRef shardActor; + final SchemaContext schemaContext; + final DatastoreContext datastoreContext; + final ShardStats shardStats; + final String transactionID; + final short txnClientVersion; + + ShardTransactionCreator(DOMStoreTransaction transaction, ActorRef shardActor, + SchemaContext schemaContext, DatastoreContext datastoreContext, + ShardStats shardStats, String transactionID, short txnClientVersion) { + this.transaction = transaction; + this.shardActor = shardActor; + this.shardStats = shardStats; + this.schemaContext = schemaContext; + this.datastoreContext = datastoreContext; + this.transactionID = transactionID; + this.txnClientVersion = txnClientVersion; + } - private void closeTransaction(CloseTransaction message){ - transaction.close(); - getSender().tell(new CloseTransactionReply(), getSelf()); - } + @Override + public ShardTransaction create() throws Exception { + ShardTransaction tx; + if(transaction instanceof DOMStoreReadWriteTransaction) { + tx = new ShardReadWriteTransaction((DOMStoreReadWriteTransaction)transaction, + shardActor, schemaContext, shardStats, transactionID, txnClientVersion); + } else if(transaction instanceof DOMStoreReadTransaction) { + tx = new ShardReadTransaction((DOMStoreReadTransaction)transaction, shardActor, + schemaContext, shardStats, transactionID, txnClientVersion); + } else { + tx = new ShardWriteTransaction((DOMStoreWriteTransaction)transaction, + shardActor, schemaContext, shardStats, transactionID, txnClientVersion); + } + + tx.getContext().setReceiveTimeout(datastoreContext.getShardTransactionIdleTimeout()); + return tx; + } + } }