/* * Copyright (c) 2014 Cisco Systems, Inc. and others. All rights reserved. * * This program and the accompanying materials are made available under the * terms of the Eclipse Public License v1.0 which accompanies this distribution, * and is available at http://www.eclipse.org/legal/epl-v10.html */ package org.opendaylight.controller.cluster.common.actor; import akka.actor.ActorRef; import akka.persistence.AbstractPersistentActor; import edu.umd.cs.findbugs.annotations.SuppressFBWarnings; import org.eclipse.jdt.annotation.NonNull; import org.slf4j.Logger; import org.slf4j.LoggerFactory; // FIXME: override getContext(), getSelf() and others to be final to get rid of // SpotBugs MC_OVERRIDABLE_METHOD_CALL_IN_CONSTRUCTOR violation public abstract class AbstractUntypedPersistentActor extends AbstractPersistentActor implements ExecuteInSelfActor { // The member name should be lower case but it's referenced in many subclasses. Suppressing the CS warning for now. @SuppressWarnings("checkstyle:MemberName") @SuppressFBWarnings("SLF4J_LOGGER_SHOULD_BE_PRIVATE") protected final Logger LOG = LoggerFactory.getLogger(getClass()); @SuppressFBWarnings(value = "MC_OVERRIDABLE_METHOD_CALL_IN_CONSTRUCTOR", justification = "Akka class design") protected AbstractUntypedPersistentActor() { LOG.trace("Actor created {}", getSelf()); getContext().system().actorSelection("user/termination-monitor").tell(new Monitor(getSelf()), getSelf()); } @Override public final void executeInSelf(@NonNull final Runnable runnable) { final ExecuteInSelfMessage message = new ExecuteInSelfMessage(runnable); LOG.trace("Scheduling execution of {}", message); self().tell(message, ActorRef.noSender()); } @Override public final Receive createReceive() { return receiveBuilder() .match(ExecuteInSelfMessage.class, ExecuteInSelfMessage::run) .matchAny(this::handleCommand) .build(); } @Override public final Receive createReceiveRecover() { return receiveBuilder().matchAny(this::handleRecover).build(); } protected abstract void handleRecover(Object message) throws Exception; protected abstract void handleCommand(Object message) throws Exception; protected void ignoreMessage(final Object message) { LOG.debug("Unhandled message {} ", message); } protected void unknownMessage(final Object message) { LOG.debug("Received unhandled message {}", message); unhandled(message); } }